browser-debugger-cli 0.2.0 → 0.5.1

package/README.md

@@ -5,7 +5,23 @@
 [![Security](https://github.com/szymdzum/browser-debugger-cli/actions/workflows/security.yml/badge.svg)](https://github.com/szymdzum/browser-debugger-cli/actions/workflows/security.yml)
 [![npm downloads](https://img.shields.io/npm/dt/browser-debugger-cli?color=blue)](https://www.npmjs.com/package/browser-debugger-cli)
 
-DevTools telemetry in your terminal. For humans and agents. Direct WebSocket to Chrome's debugging port. Stream DOM, network, and console data straight to stdout. Pipe it, grep it, feed it to agents for full context debugging.
+Chrome DevTools Protocol in your terminal. Run any CDP command, pipe the output, build browser automation with tools you already know. Design to be agent friendly
+
+## Why This Exists
+Puppeteer is great but heavy. CDP is powerful but raw. This tool sits in between: direct protocol access with session management and a few helpful wrappers. No abstractions hiding what's actually happening.
+Built for debugging web apps and scripting browser automation without spinning up a full testing framework.
+
+## Current State
+
+**Raw [CDP](https://chromedevtools.github.io/devtools-protocol/) access is complete.** All 300+ protocol methods work now. This makes it immediately useful for AI agents and developers comfortable with CDP.
+
+**Human-friendly wrappers are in progress.** Commands like `bdg dom query` and `bdg peek` are being added for common operations. For now, most automation work happens through `bdg cdp` and Unix pipes.
+
+## Demo
+
+[![asciicast](https://asciinema.org/a/RE6Iup9sB1iSWBK0wgUUn3bBl.svg)](https://asciinema.org/a/RE6Iup9sB1iSWBK0wgUUn3bBl)
+
+*Watch bdg scrape GitHub trending pages and extract repository data in real-time using DOM queries and CDP.*
 
 ## Installation
 
@@ -13,178 +29,173 @@ DevTools telemetry in your terminal. For humans and agents. Direct WebSocket to
 npm install -g browser-debugger-cli@alpha
 ```
 
+**Platform Support:**
+- ✅ macOS and Linux (native support)
+- ✅ Windows via WSL (Windows Subsystem for Linux)
+- ❌ PowerShell and Git Bash on Windows (not yet supported)
+
+The CLI uses Unix domain sockets for inter-process communication. Windows users should run bdg inside WSL for full compatibility.
+
 ## Quick Start
 
 ```bash
-# Start session (opens example.com in Chrome)
+# Start a session
 bdg example.com
 
-# Daemon starts in background, Chrome opens
-# Session is active - you can now run commands
-
-# Check session status
-bdg status
-# Status: Active
-# Worker PID: 12345
-# Chrome PID: 67890
-# Target: http://example.com
-
-# Execute raw CDP commands
+# Run any CDP command
 bdg cdp Runtime.evaluate --params '{"expression":"document.title","returnByValue":true}'
-# { "result": { "type": "string", "value": "Example Domain" } }
-
 bdg cdp Network.getCookies
-# { "cookies": [...] }
 
-# Stop session
+# Check what's running
+bdg status
+
+# Done
 bdg stop
 ```
 
-## How It Works
+## What You Can Do
+
+### Run Any CDP Command
+
+All 300+ methods from [Chrome DevTools Protocol](https://chromedevtools.github.io/devtools-protocol/) work out of the box:
+
+```bash
+# Get cookies and filter with jq
+bdg cdp Network.getCookies | jq '.cookies[] | select(.httpOnly)'
+
+# Execute JavaScript in the page
+bdg cdp Runtime.evaluate --params '{"expression":"document.querySelectorAll(\"a\").length","returnByValue":true}'
+
+# Monitor memory usage
+bdg cdp Performance.getMetrics | jq '.metrics[] | select(.name == "JSHeapUsedSize")'
+
+# Capture a screenshot
+bdg cdp Page.captureScreenshot | jq -r '.data' | base64 -d > screenshot.png
+```
 
-`bdg` is built on a **layered architecture** — raw CDP access with human-friendly wrappers on top.
+The daemon keeps a WebSocket open to Chrome, so commands run immediately against the live session.
 
-### Layer 1: Raw CDP Access ✅
+### Pipe Everything
 
-Direct access to **60+ domains, 300+ methods** from [Chrome DevTools Protocol](https://chromedevtools.github.io/devtools-protocol/):
+Output is JSON by default. Use it with `jq`, `grep`, `awk` - whatever works:
 
 ```bash
-# Execute any CDP method
-bdg cdp Network.getCookies
-bdg cdp Runtime.evaluate --params '{"expression":"document.title","returnByValue":true}'
-bdg cdp Performance.getMetrics
+# Find all failed network requests
+bdg peek --network --json | jq '.data.network[] | select(.status >= 400)'
 
-# Pipe to jq for filtering
-bdg cdp Network.getCookies | jq '.cookies[] | select(.name == "session")'
+# Extract every link on the page
+bdg cdp Runtime.evaluate --params '{
+  "expression": "Array.from(document.querySelectorAll(\"a\")).map(a => ({text: a.textContent.trim(), href: a.href}))",
+  "returnByValue": true
+}' | jq '.result.value'
+
+# Count console errors
+bdg peek --console --json | jq '[.data.console[] | select(.level == "error")] | length'
 ```
 
-**Why raw CDP first?**
-- ✅ Zero abstraction overhead — direct WebSocket to Chrome
-- ✅ Full protocol power — all CDP methods work immediately
-- ✅ Future-proof — new CDP features work without code changes
-- ✅ Agent-friendly — structured input/output, composable with Unix tools
+### For AI Agents
+
+Claude skill included at `.claude/skills/bdg/` with working automation patterns:
 
-### Layer 2: Human-Friendly Wrappers 🚧
+- Common CDP workflows (scraping, polling, navigation)
+- Exit codes and error handling
+- Troubleshooting reference
 
-Building ergonomic commands on top of raw CDP for common workflows:
+The `--help --json` flag outputs the complete CLI schema for programmatic discovery:
 
 ```bash
-# Session management
-bdg status          # Check active session
-bdg stop            # Stop session gracefully
-bdg cleanup         # Clean up stale sessions
-
-# Data inspection
-bdg peek            # Quick preview of collected data
-bdg peek --follow   # Live updates every second
-bdg details         # Full details for specific items
-bdg dom query       # Query DOM elements
-bdg dom eval        # Execute JavaScript in browser context
-bdg dom highlight   # Highlight elements visually
-bdg dom get         # Get full HTML for elements
+bdg --help --json | jq '.command.subcommands[].name'
+bdg --help --json | jq '.exitCodes'
 ```
 
-**Progressive disclosure**: Start with raw CDP power, add convenience wrappers for common patterns.
+Agents can figure out what commands exist and how to use them without hardcoded knowledge.
 
-**Why CLI over protocol servers?**
-- **Token efficiency**: CDP is in the model's training data (~3k tokens for patterns vs. 5-10k for MCP server definitions)
-- **Composability**: Unix pipes with `jq`, `grep`, `awk` — tools models already know
-- **Transparent errors**: See exactly what failed, no protocol layers hiding issues
-- **Real-time evolution**: Update patterns anytime, no server redeployment
+### Debug Live Apps
 
-## Available Commands
+Point at localhost, monitor what's happening:
 
-### Raw CDP Access
+```bash
+bdg localhost:3000 --headless
+bdg tail --console          # Stream console output
+bdg tail --network          # Watch requests in real-time
+```
+
+Helpful for catching issues during development without opening DevTools.
+
+### Automate Browser Tasks
 
-Full Chrome DevTools Protocol access via `bdg cdp` command – **any CDP method works**:
+Poll for elements, click buttons, extract data:
 
 ```bash
-# Get all cookies (raw CDP)
-bdg cdp Network.getCookies
-# {
-#   "cookies": [
-#     {
-#       "name": "session_id",
-#       "value": "1234567890abcdef",
-#       "domain": "example.com",
-#       "httpOnly": true,
-#       "secure": true,
-#       "sameSite": "Strict"
-#     }
-#   ]
-# }
-
-# Evaluate JavaScript
-bdg cdp Runtime.evaluate --params '{"expression":"document.title","returnByValue":true}'
-# {
-#   "result": {
-#     "type": "string",
-#     "value": "Example Domain"
-#   }
-# }
-
-# Get browser version
-bdg cdp Browser.getVersion
-# {
-#   "protocolVersion": "1.3",
-#   "product": "Chrome/142.0.7444.60",
-#   "jsVersion": "14.2.231.14"
-# }
-
-# Pipe to jq for filtering
-bdg cdp Network.getCookies | jq '.cookies[] | select(.name == "session_id") | .value'
-# "1234567890abcdef"
+# Wait for an element to appear
+while ! bdg cdp Runtime.evaluate --params '{"expression":"document.querySelector(\"#target\") !== null","returnByValue":true}' | jq -e '.result.value'; do
+  sleep 0.5
+done
+
+# Click it
+bdg cdp Runtime.evaluate --params '{"expression":"document.querySelector(\"#target\").click()"}'
+
+# Get the result
+bdg cdp Runtime.evaluate --params '{"expression":"document.querySelector(\".result\").textContent","returnByValue":true}'
 ```
 
-**60+ domains, 300+ methods** from the [Chrome DevTools Protocol](https://chromedevtools.github.io/devtools-protocol/) are available.
+Check `.claude/skills/bdg/WORKFLOWS.md` for more complete examples (GitHub scraper, form automation, etc).
+
+## Session Management
 
-### Session Management
+Sessions persist until you stop them. Chrome stays open, data keeps collecting:
 
 ```bash
-# Start session
-bdg example.com             # Opens Chrome with daemon in background
+bdg example.com          # Opens Chrome, starts daemon
+bdg status               # Check what's running
+bdg status --verbose     # Show Chrome process details
+bdg stop                 # Kill everything
+bdg cleanup              # Remove stale files
+```
 
-# Check if session is active
-bdg status                  # Show session info
-bdg status --verbose        # Include Chrome diagnostics
+## Helper Commands
 
-# Stop session
-bdg stop                    # Gracefully stop daemon and close Chrome
+A few convenience wrappers for common operations. Most work still happens through `bdg cdp`:
 
-# Clean up stale sessions
-bdg cleanup                 # Remove stale session files
-bdg cleanup --force         # Force cleanup even if session appears active
+```bash
+# Query DOM
+bdg dom query "button.primary"      # Find elements
+bdg dom get "button.primary"        # Get HTML
+bdg dom eval "document.title"       # Run JavaScript
+bdg dom highlight ".navbar"         # Visual debugging
+
+# Inspect collected data
+bdg peek                 # Quick snapshot
+bdg peek --network       # Just network data
+bdg tail                 # Stream like tail -f
 ```
 
-## Technical Overview
+## Page Readiness
 
-`bdg` runs a daemon that maintains a WebSocket connection to Chrome's debugging port.
-When you run commands like `bdg network` or `bdg console`, they communicate with the
-daemon via IPC, which forwards [Chrome DevTools
-Protocol](https://chromedevtools.github.io/devtools-protocol/) commands and streams
-responses back.
+By default, `bdg` waits for pages to fully load using three signals:
 
-**Architecture:**
-- **Daemon** – Background process managing Chrome connection lifecycle
-- **IPC** – Unix sockets for CLI ↔ daemon communication
-- **WebSocket** – Direct connection to Chrome's `--remote-debugging-port`
-- **CDP** – Native Chrome DevTools Protocol for all browser inspection
+1. Browser's `window.onload` fires
+2. Network goes quiet (200ms without new requests)
+3. DOM stops changing (300ms without mutations)
 
-**Benefits:**
-- Sessions persist across commands (Chrome stays open)
-- Live queries without stopping collection
-- No intermediate files data flows from Chrome to stdout
-- Real CDP with full protocol access
+Catches server-rendered HTML, client hydration, and lazy-loaded content. Works with Next.js, React, Vue, whatever. Times out after 5 seconds if something hangs.
 
-## Contributing
+Skip it with `--no-wait` if you want immediate connection.
 
-Contributions welcome! But honestly, I'd just be happy if you give it a try.
+## Architecture
+
+Three processes:
+
+- **CLI** talks to daemon via Unix socket
+- **Daemon** manages Chrome and routes commands
+- **Worker** holds the WebSocket to CDP
+
+Chrome stays running between commands. No startup cost for each operation.
+
+## Contributing
 
-Let me know how you use it
-([discussions](https://github.com/szymdzum/browser-debugger-cli/discussions)), let me
-know what's broken
-([issues](https://github.com/szymdzum/browser-debugger-cli/issues/new)).
+If you use this and something breaks, [open an issue](https://github.com/szymdzum/browser-debugger-cli/issues/new). If you have ideas, start a [discussion](https://github.com/szymdzum/browser-debugger-cli/discussions). PRs welcome.
 
 ## License
 
-MIT – see [LICENSE](LICENSE) for details.
+MIT

package/dist/__tests__/fixtures/schema-v0.2.1.golden.json

@@ -0,0 +1,47 @@
+{
+  "version": "0.2.1",
+  "success": true,
+  "timestamp": "2025-11-06T20:00:00.000Z",
+  "duration": 4500,
+  "target": {
+    "url": "https://example.com/",
+    "title": "Example Domain"
+  },
+  "data": {
+    "network": [
+      {
+        "requestId": "1000.1",
+        "url": "https://example.com/",
+        "method": "GET",
+        "timestamp": 1730923200000,
+        "status": 200,
+        "mimeType": "text/html",
+        "requestHeaders": {
+          "User-Agent": "Chrome/120.0.0.0"
+        },
+        "responseHeaders": {
+          "Content-Type": "text/html; charset=UTF-8"
+        },
+        "responseBody": "<!DOCTYPE html><html>...</html>"
+      }
+    ],
+    "console": [
+      {
+        "type": "log",
+        "text": "Page loaded",
+        "timestamp": 1730923201000,
+        "args": [
+          {
+            "type": "string",
+            "value": "Page loaded"
+          }
+        ]
+      }
+    ],
+    "dom": {
+      "url": "https://example.com/",
+      "title": "Example Domain",
+      "outerHTML": "<!DOCTYPE html><html><head><title>Example Domain</title></head><body><h1>Example Domain</h1></body></html>"
+    }
+  }
+}

package/dist/__tests__/schema.contract.test.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Schema contract tests
+ *
+ * These tests lock the JSON schema shape to prevent breaking changes.
+ * Golden files define the expected structure that consumers depend on.
+ *
+ * Test philosophy:
+ * - Ensure all required fields are present with correct types
+ * - Detect unexpected fields (potential breaking changes)
+ * - Validate nested structure matches interface definitions
+ * - Test both success and error output formats
+ *
+ * When tests fail:
+ * 1. If adding optional fields → Update golden file, bump minor version
+ * 2. If changing existing fields → This is a BREAKING CHANGE, requires major version bump
+ * 3. If removing fields → This is a BREAKING CHANGE, requires major version bump
+ */
+export {};
+//# sourceMappingURL=schema.contract.test.d.ts.map

package/dist/__tests__/schema.contract.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.contract.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/schema.contract.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG"}

package/dist/__tests__/schema.contract.test.js

@@ -0,0 +1,236 @@
+/**
+ * Schema contract tests
+ *
+ * These tests lock the JSON schema shape to prevent breaking changes.
+ * Golden files define the expected structure that consumers depend on.
+ *
+ * Test philosophy:
+ * - Ensure all required fields are present with correct types
+ * - Detect unexpected fields (potential breaking changes)
+ * - Validate nested structure matches interface definitions
+ * - Test both success and error output formats
+ *
+ * When tests fail:
+ * 1. If adding optional fields → Update golden file, bump minor version
+ * 2. If changing existing fields → This is a BREAKING CHANGE, requires major version bump
+ * 3. If removing fields → This is a BREAKING CHANGE, requires major version bump
+ */
+import assert from 'node:assert/strict';
+import fs from 'node:fs';
+import path from 'node:path';
+import { describe, it } from 'node:test';
+import { fileURLToPath } from 'node:url';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+/**
+ * Load golden file from fixtures directory
+ */
+function loadGoldenFile(filename) {
+    const goldenPath = path.join(__dirname, 'fixtures', filename);
+    const content = fs.readFileSync(goldenPath, 'utf-8');
+    return JSON.parse(content);
+}
+describe('BdgOutput schema contract', () => {
+    describe('v0.2.1 schema', () => {
+        let golden;
+        it('should load golden file successfully', () => {
+            golden = loadGoldenFile('schema-v0.2.1.golden.json');
+            assert.ok(golden, 'Golden file should load');
+        });
+        it('should have all required top-level fields', () => {
+            golden = loadGoldenFile('schema-v0.2.1.golden.json');
+            // Required fields
+            assert.equal(typeof golden.version, 'string', 'version must be string');
+            assert.equal(typeof golden.success, 'boolean', 'success must be boolean');
+            assert.equal(typeof golden.timestamp, 'string', 'timestamp must be string');
+            assert.equal(typeof golden.duration, 'number', 'duration must be number');
+            assert.ok(golden.target, 'target must be present');
+            assert.ok(golden.data, 'data must be present');
+            // Validate ISO8601 timestamp format
+            assert.ok(/^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}\.\d{3}Z$/.test(golden.timestamp), 'timestamp must be ISO8601 format');
+        });
+        it('should have target structure with url and title', () => {
+            golden = loadGoldenFile('schema-v0.2.1.golden.json');
+            assert.equal(typeof golden.target.url, 'string', 'target.url must be string');
+            assert.equal(typeof golden.target.title, 'string', 'target.title must be string');
+            // Should not have extra fields
+            const targetKeys = Object.keys(golden.target);
+            assert.deepEqual(targetKeys.sort(), ['title', 'url'].sort(), 'target should only have url and title');
+        });
+        it('should have data object with optional telemetry arrays', () => {
+            golden = loadGoldenFile('schema-v0.2.1.golden.json');
+            assert.equal(typeof golden.data, 'object', 'data must be object');
+            // Validate network array if present
+            if (golden.data.network !== undefined) {
+                assert.ok(Array.isArray(golden.data.network), 'data.network must be array');
+            }
+            // Validate console array if present
+            if (golden.data.console !== undefined) {
+                assert.ok(Array.isArray(golden.data.console), 'data.console must be array');
+            }
+            // Validate dom object if present
+            if (golden.data.dom !== undefined) {
+                assert.equal(typeof golden.data.dom, 'object', 'data.dom must be object');
+            }
+            // Should only have known telemetry types
+            const dataKeys = Object.keys(golden.data);
+            const allowedKeys = ['network', 'console', 'dom'];
+            for (const key of dataKeys) {
+                assert.ok(allowedKeys.includes(key), `data.${key} is not a known telemetry type. Allowed: ${allowedKeys.join(', ')}`);
+            }
+        });
+        it('should validate NetworkRequest structure', () => {
+            golden = loadGoldenFile('schema-v0.2.1.golden.json');
+            if (!golden.data.network || golden.data.network.length === 0) {
+                assert.fail('Golden file must have at least one network request for validation');
+            }
+            const request = golden.data.network[0];
+            // Required fields
+            assert.equal(typeof request.requestId, 'string', 'requestId must be string');
+            assert.equal(typeof request.url, 'string', 'url must be string');
+            assert.equal(typeof request.method, 'string', 'method must be string');
+            assert.equal(typeof request.timestamp, 'number', 'timestamp must be number');
+            // Optional fields with type validation
+            if (request.status !== undefined) {
+                assert.equal(typeof request.status, 'number', 'status must be number if present');
+            }
+            if (request.mimeType !== undefined) {
+                assert.equal(typeof request.mimeType, 'string', 'mimeType must be string if present');
+            }
+            if (request.requestHeaders !== undefined) {
+                assert.equal(typeof request.requestHeaders, 'object', 'requestHeaders must be object if present');
+            }
+            if (request.responseHeaders !== undefined) {
+                assert.equal(typeof request.responseHeaders, 'object', 'responseHeaders must be object if present');
+            }
+            if (request.requestBody !== undefined) {
+                assert.equal(typeof request.requestBody, 'string', 'requestBody must be string if present');
+            }
+            if (request.responseBody !== undefined) {
+                assert.equal(typeof request.responseBody, 'string', 'responseBody must be string if present');
+            }
+            // Validate no unexpected fields
+            const allowedKeys = [
+                'requestId',
+                'url',
+                'method',
+                'timestamp',
+                'status',
+                'mimeType',
+                'requestHeaders',
+                'responseHeaders',
+                'requestBody',
+                'responseBody',
+            ];
+            const requestKeys = Object.keys(request);
+            for (const key of requestKeys) {
+                assert.ok(allowedKeys.includes(key), `NetworkRequest.${key} is not in schema. Allowed: ${allowedKeys.join(', ')}`);
+            }
+        });
+        it('should validate ConsoleMessage structure', () => {
+            golden = loadGoldenFile('schema-v0.2.1.golden.json');
+            if (!golden.data.console || golden.data.console.length === 0) {
+                assert.fail('Golden file must have at least one console message for validation');
+            }
+            const message = golden.data.console[0];
+            // Required fields
+            assert.equal(typeof message.type, 'string', 'type must be string');
+            assert.equal(typeof message.text, 'string', 'text must be string');
+            assert.equal(typeof message.timestamp, 'number', 'timestamp must be number');
+            // Optional fields
+            if (message.args !== undefined) {
+                assert.ok(Array.isArray(message.args), 'args must be array if present');
+            }
+            // Validate no unexpected fields
+            const allowedKeys = ['type', 'text', 'timestamp', 'args'];
+            const messageKeys = Object.keys(message);
+            for (const key of messageKeys) {
+                assert.ok(allowedKeys.includes(key), `ConsoleMessage.${key} is not in schema. Allowed: ${allowedKeys.join(', ')}`);
+            }
+        });
+        it('should validate DOMData structure', () => {
+            golden = loadGoldenFile('schema-v0.2.1.golden.json');
+            if (!golden.data.dom) {
+                assert.fail('Golden file must have dom data for validation');
+            }
+            const dom = golden.data.dom;
+            // Required fields
+            assert.equal(typeof dom.url, 'string', 'url must be string');
+            assert.equal(typeof dom.title, 'string', 'title must be string');
+            assert.equal(typeof dom.outerHTML, 'string', 'outerHTML must be string');
+            // Validate no unexpected fields
+            const allowedKeys = ['url', 'title', 'outerHTML'];
+            const domKeys = Object.keys(dom);
+            for (const key of domKeys) {
+                assert.ok(allowedKeys.includes(key), `DOMData.${key} is not in schema. Allowed: ${allowedKeys.join(', ')}`);
+            }
+        });
+        it('should validate optional error field', () => {
+            golden = loadGoldenFile('schema-v0.2.1.golden.json');
+            // Error field is optional
+            if (golden.error !== undefined) {
+                assert.equal(typeof golden.error, 'string', 'error must be string if present');
+            }
+        });
+        it('should validate optional partial field', () => {
+            golden = loadGoldenFile('schema-v0.2.1.golden.json');
+            // Partial field is optional
+            if (golden.partial !== undefined) {
+                assert.equal(typeof golden.partial, 'boolean', 'partial must be boolean if present');
+            }
+        });
+        it('should detect unexpected top-level fields', () => {
+            golden = loadGoldenFile('schema-v0.2.1.golden.json');
+            const allowedTopLevelKeys = [
+                'version',
+                'success',
+                'timestamp',
+                'duration',
+                'target',
+                'data',
+                'error',
+                'partial',
+            ];
+            const actualKeys = Object.keys(golden);
+            for (const key of actualKeys) {
+                assert.ok(allowedTopLevelKeys.includes(key), `Unexpected top-level field: ${key}. This may be a breaking change.`);
+            }
+        });
+    });
+    describe('Error output format', () => {
+        it('should have success=false and error field on failure', () => {
+            const errorOutput = {
+                version: '0.2.1',
+                success: false,
+                timestamp: new Date().toISOString(),
+                duration: 1000,
+                target: { url: '', title: '' },
+                data: {},
+                error: 'Connection failed',
+            };
+            assert.equal(errorOutput.success, false, 'success must be false on error');
+            assert.equal(typeof errorOutput.error, 'string', 'error must be string');
+            assert.ok(errorOutput.error !== undefined, 'error must be defined');
+            assert.ok(errorOutput.error.length > 0, 'error message must not be empty');
+        });
+    });
+    describe('Partial output format', () => {
+        it('should have partial=true for live previews', () => {
+            const previewOutput = {
+                version: '0.2.1',
+                success: true,
+                timestamp: new Date().toISOString(),
+                duration: 1000,
+                target: { url: 'https://example.com', title: 'Example' },
+                data: {
+                    network: [],
+                    console: [],
+                },
+                partial: true,
+            };
+            assert.equal(previewOutput.partial, true, 'partial must be true for live previews');
+            assert.equal(previewOutput.success, true, 'success can be true with partial=true');
+        });
+    });
+});
+//# sourceMappingURL=schema.contract.test.js.map

package/dist/__tests__/schema.contract.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.contract.test.js","sourceRoot":"","sources":["../../src/__tests__/schema.contract.test.ts"],"names":[],"mappings":"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"}