# AWESOME Logs - Quick Reference 🎨

## At a Glance

Your TestDriver SDK now has **beautiful, emoji-rich logs** with great DX!

### What You'll See

```
[2.34s] 🔍 Found "submit button" · 📍 (682, 189) · ⏱️ 167ms · ⚡ cached
[2.51s] 👆 Click "submit button"
[2.67s] 👉 Hover "menu item"
[2.89s] ⌨️ Type → hello world
[3.12s] ✅ Assert "page title correct" · ✓ PASSED · ⏱️ 45ms
```

## Quick Emoji Guide

| Emoji | Meaning |
|-------|---------|
| 🔍 | Finding element |
| 👆 | Click |
| 👉 | Hover |
| ⌨️ | Type |
| 📜 | Scroll |
| ✅ | Success/Passed |
| ❌ | Error/Failed |
| ⚡ | Cache hit |
| 💤 | Cache miss |
| 📍 | Coordinates |
| ⏱️ | Duration |
| 🔌 | Connect/Disconnect |
| 📸 | Screenshot |

## Performance Colors

Duration times are color-coded:

- **🟢 < 100ms** - Fast
- **🟡 100-500ms** - Acceptable  
- **🔴 > 500ms** - Slow

## Enable/Disable

```javascript
// Enabled by default
const client = new TestDriver(apiKey, {
  logging: true
});

// Disable if needed
client.setLogging(false);
```

## Debug Mode

For detailed cache information:

```bash
VERBOSE=true node your-test.js
```

You'll see:
- Cache strategy (image/text)
- Similarity scores
- Pixel diff percentages
- Cache age

## Examples

Try these:

```bash
# Simple example
TD_API_KEY=your_key node examples/sdk-simple-example.js

# Full demo
TD_API_KEY=your_key node examples/sdk-awesome-logs-demo.js

# Cache demo with debug info
TD_API_KEY=your_key VERBOSE=true node examples/sdk-cache-thresholds.js
```

## Custom Formatting

```javascript
const { formatter } = require('testdriverai/sdk-log-formatter');

console.log(formatter.formatHeader('My Test', '🧪'));
console.log(formatter.formatAction('click', 'button'));
console.log(formatter.formatProgress(3, 10, 'Processing'));
```

## Full Documentation

See [SDK_AWESOME_LOGS.md](./SDK_AWESOME_LOGS.md) for complete documentation.

---

**Enjoy your AWESOME logs! 🎨✨**
