browser-debugger-cli 0.3.0 → 0.5.1

package/dist/utils/session.js

@@ -0,0 +1,498 @@
+import { spawnSync } from 'child_process';
+import * as fs from 'fs';
+import * as os from 'os';
+import * as path from 'path';
+import { AtomicFileWriter } from './atomicFile.js';
+/**
+ * Session file paths relative to ~/.bdg/
+ * Centralized definition for all session-related files.
+ */
+const SESSION_FILES = {
+    PID: 'session.pid',
+    OUTPUT: 'session.json',
+    LOCK: 'session.lock',
+    METADATA: 'session.meta.json',
+    CHROME_PID: 'chrome.pid',
+    PREVIEW: 'session.preview.json',
+    FULL: 'session.full.json',
+};
+/**
+ * Get the session directory path (~/.bdg)
+ */
+export function getSessionDir() {
+    return path.join(os.homedir(), '.bdg');
+}
+/**
+ * Get the path to a session file by type.
+ *
+ * @param fileType - The type of session file
+ * @returns Full path to the session file
+ */
+export function getSessionFilePath(fileType) {
+    return path.join(getSessionDir(), SESSION_FILES[fileType]);
+}
+/**
+ * Ensure the session directory exists
+ */
+export function ensureSessionDir() {
+    const dir = getSessionDir();
+    if (!fs.existsSync(dir)) {
+        fs.mkdirSync(dir, { recursive: true });
+    }
+}
+/**
+ * Get the path to the PID file
+ */
+export function getPidFilePath() {
+    return getSessionFilePath('PID');
+}
+/**
+ * Get the path to the output JSON file
+ */
+export function getOutputFilePath() {
+    return getSessionFilePath('OUTPUT');
+}
+/**
+ * Get the path to the session lock file
+ */
+export function getLockFilePath() {
+    return getSessionFilePath('LOCK');
+}
+/**
+ * Get the path to the session metadata file
+ */
+export function getMetadataFilePath() {
+    return getSessionFilePath('METADATA');
+}
+/**
+ * Get the path to the persistent Chrome PID cache file.
+ * This file survives session cleanup so aggressive cleanup can still find Chrome.
+ */
+export function getChromePidCachePath() {
+    return getSessionFilePath('CHROME_PID');
+}
+/**
+ * Write the current process PID to the session file atomically
+ *
+ * @param pid - Process ID to write
+ */
+export function writePid(pid) {
+    ensureSessionDir();
+    const pidPath = getPidFilePath();
+    AtomicFileWriter.writeSync(pidPath, pid.toString());
+}
+/**
+ * Read the PID from the session file
+ *
+ * @returns The PID if file exists and is valid, null otherwise
+ */
+export function readPid() {
+    const pidPath = getPidFilePath();
+    if (!fs.existsSync(pidPath)) {
+        return null;
+    }
+    try {
+        const pidStr = fs.readFileSync(pidPath, 'utf-8').trim();
+        const pid = parseInt(pidStr, 10);
+        if (isNaN(pid)) {
+            return null;
+        }
+        return pid;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Check if a process with the given PID is alive
+ *
+ * @param pid - Process ID to check
+ * @returns True if process is running, false otherwise
+ */
+export function isProcessAlive(pid) {
+    try {
+        // Sending signal 0 checks if process exists without actually sending a signal
+        process.kill(pid, 0);
+        return true;
+    }
+    catch {
+        // ESRCH error means process doesn't exist
+        return false;
+    }
+}
+/**
+ * Remove the PID file
+ */
+export function cleanupPidFile() {
+    const pidPath = getPidFilePath();
+    if (fs.existsSync(pidPath)) {
+        try {
+            fs.unlinkSync(pidPath);
+        }
+        catch {
+            // Ignore errors during cleanup
+        }
+    }
+}
+/**
+ * Write session output to the JSON file
+ *
+ * @param output - The BdgOutput data to write
+ * @param compact - If true, use compact JSON format (no indentation)
+ */
+export function writeSessionOutput(output, compact = false) {
+    ensureSessionDir();
+    const outputPath = getOutputFilePath();
+    const jsonString = compact ? JSON.stringify(output) : JSON.stringify(output, null, 2);
+    AtomicFileWriter.writeSync(outputPath, jsonString);
+}
+/**
+ * Acquire session lock atomically.
+ *
+ * Uses exclusive file creation (wx flag) to ensure only one session can run.
+ *
+ * @returns True if lock was acquired, false if another session is running
+ */
+export function acquireSessionLock() {
+    ensureSessionDir();
+    const lockPath = getLockFilePath();
+    try {
+        // 'wx' flag creates file exclusively - fails if exists
+        fs.writeFileSync(lockPath, process.pid.toString(), { flag: 'wx' });
+        return true;
+    }
+    catch (error) {
+        if (error instanceof Error && 'code' in error && error.code === 'EEXIST') {
+            // Lock file exists - check if process is still alive
+            try {
+                const lockPidStr = fs.readFileSync(lockPath, 'utf-8').trim();
+                const lockPid = parseInt(lockPidStr, 10);
+                if (!isNaN(lockPid) && isProcessAlive(lockPid)) {
+                    // Lock is held by active process
+                    return false;
+                }
+                else {
+                    // Stale lock file - remove it and try again
+                    fs.unlinkSync(lockPath);
+                    return acquireSessionLock();
+                }
+            }
+            catch {
+                // Can't read lock file - assume it's stale
+                try {
+                    fs.unlinkSync(lockPath);
+                    return acquireSessionLock();
+                }
+                catch {
+                    return false;
+                }
+            }
+        }
+        return false;
+    }
+}
+/**
+ * Release session lock.
+ *
+ * Removes the lock file to allow other sessions to start.
+ */
+export function releaseSessionLock() {
+    const lockPath = getLockFilePath();
+    try {
+        if (fs.existsSync(lockPath)) {
+            fs.unlinkSync(lockPath);
+        }
+    }
+    catch {
+        // Ignore errors during cleanup
+    }
+}
+/**
+ * Write session metadata.
+ *
+ * @param metadata - Session metadata to write
+ */
+export function writeSessionMetadata(metadata) {
+    ensureSessionDir();
+    const metaPath = getMetadataFilePath();
+    AtomicFileWriter.writeSync(metaPath, JSON.stringify(metadata, null, 2));
+}
+/**
+ * Read session metadata.
+ *
+ * @returns Session metadata if file exists and is valid, null otherwise
+ */
+export function readSessionMetadata() {
+    const metaPath = getMetadataFilePath();
+    if (!fs.existsSync(metaPath)) {
+        return null;
+    }
+    try {
+        const content = fs.readFileSync(metaPath, 'utf-8');
+        return JSON.parse(content);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Write Chrome PID to persistent cache.
+ * This survives session cleanup so aggressive cleanup can find Chrome later.
+ *
+ * @param chromePid - Chrome process ID to cache
+ */
+export function writeChromePid(chromePid) {
+    ensureSessionDir();
+    const cachePath = getChromePidCachePath();
+    AtomicFileWriter.writeSync(cachePath, chromePid.toString());
+}
+/**
+ * Read Chrome PID from persistent cache.
+ *
+ * @returns Chrome PID if cached and process is alive, null otherwise
+ */
+export function readChromePid() {
+    const cachePath = getChromePidCachePath();
+    if (!fs.existsSync(cachePath)) {
+        return null;
+    }
+    try {
+        const pidStr = fs.readFileSync(cachePath, 'utf-8').trim();
+        const pid = parseInt(pidStr, 10);
+        if (isNaN(pid)) {
+            return null;
+        }
+        // Only return the PID if the process is still alive
+        // This prevents trying to kill stale PIDs
+        if (!isProcessAlive(pid)) {
+            // Clean up stale cache
+            try {
+                fs.unlinkSync(cachePath);
+            }
+            catch {
+                // Ignore cleanup errors
+            }
+            return null;
+        }
+        return pid;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Remove Chrome PID from persistent cache.
+ */
+export function clearChromePid() {
+    const cachePath = getChromePidCachePath();
+    try {
+        if (fs.existsSync(cachePath)) {
+            fs.unlinkSync(cachePath);
+        }
+    }
+    catch {
+        // Ignore errors during cleanup
+    }
+}
+/**
+ * Kill a Chrome process using cross-platform approach.
+ *
+ * Windows: Uses `taskkill /pid <pid> /T /F` to kill process tree
+ * Unix/macOS: Uses `process.kill(-pid, signal)` to kill process group
+ *
+ * @param pid - Chrome process ID to kill
+ * @param signal - Signal to send (Unix only, default 'SIGTERM'). Ignored on Windows.
+ * @throws Error if kill operation fails
+ */
+export function killChromeProcess(pid, signal = 'SIGTERM') {
+    const isWindows = process.platform === 'win32';
+    if (isWindows) {
+        // Windows: Use taskkill to kill process tree
+        // /T = kill process tree, /F = force kill
+        const result = spawnSync(`taskkill /pid ${pid} /T /F`, {
+            shell: true,
+            encoding: 'utf-8',
+        });
+        // Check for spawn errors (command not found, etc.)
+        if (result.error) {
+            throw result.error;
+        }
+        // Check exit status - taskkill returns non-zero on failure
+        // Common exit codes:
+        // - 0: Success
+        // - 128: Process not found
+        // - 1: Access denied or other error
+        if (result.status !== 0) {
+            const errorMsg = (result.stderr ?? result.stdout).trim() || 'Unknown error';
+            throw new Error(`taskkill failed (exit code ${result.status}): ${errorMsg}`);
+        }
+        // Log stderr for debugging (taskkill sometimes writes to stderr even on success)
+        if (result.stderr?.trim()) {
+            console.error(`taskkill stderr: ${result.stderr.trim()}`);
+        }
+    }
+    else {
+        // Unix/macOS: Kill process group (negative PID)
+        // This kills Chrome and all child processes
+        process.kill(-pid, signal);
+    }
+}
+/**
+ * Get the path to the partial output file (lightweight preview, metadata only)
+ */
+export function getPartialFilePath() {
+    return getSessionFilePath('PREVIEW');
+}
+/**
+ * Get the path to the full output file (complete data with bodies)
+ */
+export function getFullFilePath() {
+    return getSessionFilePath('FULL');
+}
+/**
+ * Write partial session output for live preview (async version).
+ *
+ * Uses atomic write (tmp file + rename) to prevent corruption.
+ * Non-blocking version for periodic writes during collection.
+ *
+ * @param output - The partial BdgOutput data to write
+ * @param compact - If true, use compact JSON format (no indentation)
+ * @returns Promise that resolves when write completes
+ */
+export async function writePartialOutputAsync(output, compact = false) {
+    const startTime = Date.now();
+    ensureSessionDir();
+    const partialPath = getPartialFilePath();
+    // JSON.stringify is synchronous and blocks event loop - measure it separately
+    const stringifyStart = Date.now();
+    const jsonString = compact ? JSON.stringify(output) : JSON.stringify(output, null, 2);
+    const stringifyDuration = Date.now() - stringifyStart;
+    // Calculate size savings when using compact mode
+    const sizeKB = (jsonString.length / 1024).toFixed(1);
+    if (compact) {
+        // Estimate pretty-printed size (rough heuristic: 30% larger due to indentation)
+        const estimatedPrettyKB = ((jsonString.length * 1.3) / 1024).toFixed(1);
+        const savedKB = (parseFloat(estimatedPrettyKB) - parseFloat(sizeKB)).toFixed(1);
+        console.error(`[PERF] Preview JSON.stringify: ${stringifyDuration}ms (${sizeKB}KB compact, saved ~${savedKB}KB)`);
+    }
+    else {
+        console.error(`[PERF] Preview JSON.stringify: ${stringifyDuration}ms (${sizeKB}KB)`);
+    }
+    // Write atomically
+    const ioStart = Date.now();
+    await AtomicFileWriter.writeAsync(partialPath, jsonString);
+    const ioDuration = Date.now() - ioStart;
+    const totalDuration = Date.now() - startTime;
+    console.error(`[PERF] Preview write: ${totalDuration}ms (stringify: ${stringifyDuration}ms, I/O: ${ioDuration}ms)`);
+}
+/**
+ * Write full session output for details view (async version).
+ *
+ * Uses atomic write (tmp file + rename) to prevent corruption.
+ * Non-blocking version for periodic writes during collection.
+ *
+ * @param output - The full BdgOutput data to write
+ * @param compact - If true, use compact JSON format (no indentation)
+ * @returns Promise that resolves when write completes
+ */
+export async function writeFullOutputAsync(output, compact = false) {
+    const startTime = Date.now();
+    ensureSessionDir();
+    const fullPath = getFullFilePath();
+    // JSON.stringify is synchronous and blocks event loop - measure it separately
+    const stringifyStart = Date.now();
+    const jsonString = compact ? JSON.stringify(output) : JSON.stringify(output, null, 2);
+    const stringifyDuration = Date.now() - stringifyStart;
+    // Calculate size savings when using compact mode
+    const sizeMB = (jsonString.length / 1024 / 1024).toFixed(1);
+    if (compact) {
+        // Estimate pretty-printed size (rough heuristic: 30% larger due to indentation)
+        const estimatedPrettyMB = ((jsonString.length * 1.3) / 1024 / 1024).toFixed(1);
+        const savedMB = (parseFloat(estimatedPrettyMB) - parseFloat(sizeMB)).toFixed(1);
+        console.error(`[PERF] Full JSON.stringify: ${stringifyDuration}ms (${sizeMB}MB compact, saved ~${savedMB}MB)`);
+    }
+    else {
+        console.error(`[PERF] Full JSON.stringify: ${stringifyDuration}ms (${sizeMB}MB)`);
+    }
+    // Write atomically
+    const ioStart = Date.now();
+    await AtomicFileWriter.writeAsync(fullPath, jsonString);
+    const ioDuration = Date.now() - ioStart;
+    const totalDuration = Date.now() - startTime;
+    console.error(`[PERF] Full write: ${totalDuration}ms (stringify: ${stringifyDuration}ms, I/O: ${ioDuration}ms)`);
+}
+/**
+ * Read partial session output for live preview (lightweight metadata).
+ *
+ * @returns The partial BdgOutput data if file exists and is valid, null otherwise
+ */
+export function readPartialOutput() {
+    const partialPath = getPartialFilePath();
+    if (!fs.existsSync(partialPath)) {
+        return null;
+    }
+    try {
+        const content = fs.readFileSync(partialPath, 'utf-8');
+        return JSON.parse(content);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Read full session output for details view (complete data with bodies).
+ *
+ * @returns The full BdgOutput data if file exists and is valid, null otherwise
+ */
+export function readFullOutput() {
+    const fullPath = getFullFilePath();
+    if (!fs.existsSync(fullPath)) {
+        return null;
+    }
+    try {
+        const content = fs.readFileSync(fullPath, 'utf-8');
+        return JSON.parse(content);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Cleanup all session files.
+ *
+ * Removes PID, lock, metadata, preview, full, and output files.
+ */
+export function cleanupSession() {
+    cleanupPidFile();
+    releaseSessionLock();
+    const metaPath = getMetadataFilePath();
+    if (fs.existsSync(metaPath)) {
+        try {
+            fs.unlinkSync(metaPath);
+        }
+        catch {
+            // Ignore errors
+        }
+    }
+    // Clean up preview file (lightweight)
+    const partialPath = getPartialFilePath();
+    if (fs.existsSync(partialPath)) {
+        try {
+            fs.unlinkSync(partialPath);
+        }
+        catch {
+            // Ignore errors
+        }
+    }
+    // Clean up full file (complete data)
+    const fullPath = getFullFilePath();
+    if (fs.existsSync(fullPath)) {
+        try {
+            fs.unlinkSync(fullPath);
+        }
+        catch {
+            // Ignore errors
+        }
+    }
+}
+//# sourceMappingURL=session.js.map

package/dist/utils/session.js.map

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

package/dist/utils/url.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"url.d.ts","sourceRoot":"","sources":["../../src/utils/url.ts"],"names":[],"mappings":"AAAA;;GAEG;AAwCH;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAMhD;AAMD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG;IACxC,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAgDA;AAMD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,GAAG,GAAG,IAAI,CAYtD;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAGrD;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAG7D"}
+{"version":3,"file":"url.d.ts","sourceRoot":"","sources":["../../src/utils/url.ts"],"names":[],"mappings":"AAAA;;GAEG;AAwCH;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAMhD;AAMD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG;IACxC,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CA4DA;AAMD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,GAAG,GAAG,IAAI,CAYtD;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAGrD;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAG7D"}

package/dist/utils/url.js

@@ -106,6 +106,16 @@ export function validateUrl(url) {
             suggestion: 'URLs cannot contain spaces',
         };
     }
+    // Check for invalid characters in hostname/protocol (before normalization)
+    // This prevents malformed URLs like "ht!tp://example" from being normalized to "http://ht!tp://example"
+    const beforePath = url.split('/')[0] ?? '';
+    if (/[!@#$%^&*()=+[\]{}\\|;'",<>?]/.test(beforePath)) {
+        return {
+            valid: false,
+            error: `Invalid URL format: '${url}' (contains invalid characters)`,
+            suggestion: 'URLs cannot contain special characters like !, @, #, etc. in hostname or protocol',
+        };
+    }
     const normalized = normalizeUrl(url);
     try {
         const parsed = new URL(normalized);

package/dist/utils/url.js.map

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

package/dist/utils/validation.d.ts

@@ -0,0 +1,12 @@
+import type { CollectorType } from '../types.js';
+/**
+ * Validate that a collector type is valid
+ * @throws Error if collector type is invalid
+ */
+export declare function validateCollectorType(type: string): asserts type is CollectorType;
+/**
+ * Validate an array of collector types
+ * @throws Error if any collector type is invalid
+ */
+export declare function validateCollectorTypes(types: string[]): asserts types is CollectorType[];
+//# sourceMappingURL=validation.d.ts.map

package/dist/utils/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/utils/validation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAI7C;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,IAAI,aAAa,CAMjF;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,KAAK,IAAI,aAAa,EAAE,CAIxF"}

package/dist/utils/validation.js

@@ -0,0 +1,20 @@
+const VALID_COLLECTORS = ['dom', 'network', 'console'];
+/**
+ * Validate that a collector type is valid
+ * @throws Error if collector type is invalid
+ */
+export function validateCollectorType(type) {
+    if (!VALID_COLLECTORS.includes(type)) {
+        throw new Error(`Invalid collector type: "${type}". Valid types are: ${VALID_COLLECTORS.join(', ')}`);
+    }
+}
+/**
+ * Validate an array of collector types
+ * @throws Error if any collector type is invalid
+ */
+export function validateCollectorTypes(types) {
+    for (const type of types) {
+        validateCollectorType(type);
+    }
+}
+//# sourceMappingURL=validation.js.map

package/dist/utils/validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.js","sourceRoot":"","sources":["../../src/utils/validation.ts"],"names":[],"mappings":"AAEA,MAAM,gBAAgB,GAAoB,CAAC,KAAK,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;AAExE;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CAAC,IAAY;IAChD,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,IAAqB,CAAC,EAAE,CAAC;QACtD,MAAM,IAAI,KAAK,CACb,4BAA4B,IAAI,uBAAuB,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACrF,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,sBAAsB,CAAC,KAAe;IACpD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,qBAAqB,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC;AACH,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "browser-debugger-cli",
-  "version": "0.3.0",
+  "version": "0.5.1",
   "description": "DevTools telemetry in your terminal. For humans and agents. Direct WebSocket to Chrome's debugging port.",
   "type": "module",
   "bin": {
@@ -29,6 +29,7 @@
     "check:enhanced": "npm run format:check && npm run type-check && npm run lint && npm run validate:module-type && npm run validate:ts-version",
     "test": "tsx --test src/**/__tests__/*.test.ts src/**/__tests__/*.contract.test.ts src/__tests__/integration/*.test.ts",
     "test:watch": "tsx --test --watch src/**/__tests__/*.test.ts src/**/__tests__/*.contract.test.ts src/__tests__/integration/*.test.ts",
+    "test:smoke": "tsx --test --test-concurrency=1 src/__tests__/smoke/*.test.ts",
     "prepublishOnly": "npm run build",
     "prepare": "husky"
   },

package/dist/cli/commands/__tests__/cdp.contract.test.d.ts

@@ -1,24 +0,0 @@
-/**
- * CDP Command Contract Tests
- *
- * Tests the public API behavior of raw CDP command execution WITHOUT testing implementation details.
- * Follows the testing philosophy: "Test the contract, not the implementation"
- *
- * Contract Coverage:
- * 1. callCDP() IPC client function (src/ipc/client.ts:298)
- * 2. bdg cdp CLI command (src/cli/commands/cdp.ts)
- * 3. cdp_call IPC command routing (daemon/worker)
- * 4. End-to-end flow: CLI → IPC client → daemon → worker → CDP → response
- *
- * What we test:
- * ✅ Behavior: CDP method execution → result returned
- * ✅ Invariants: "CDP calls reach the browser", "Results propagate back correctly"
- * ✅ Edge cases: Invalid methods, missing params, CDP errors, timeout
- *
- * What we DON'T test:
- * ❌ How sendCommand() works internally
- * ❌ How the daemon routes messages
- * ❌ How the worker parses requests
- */
-export {};
-//# sourceMappingURL=cdp.contract.test.d.ts.map

package/dist/cli/commands/__tests__/cdp.contract.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"cdp.contract.test.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/__tests__/cdp.contract.test.ts"],"names":[],"mappings":"AACA;;;;;;;;;;;;;;;;;;;;;GAqBG"}