browser-debugger-cli 0.0.1-alpha.0 → 0.1.0-alpha.1

package/dist/__testutils__/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/__testutils__/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AACtF,OAAO,EAAE,YAAY,EAAoB,MAAM,gBAAgB,CAAC;AAChE,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAC1F,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACxF,OAAO,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/__testutils__/testClock.d.ts

@@ -0,0 +1,28 @@
+/**
+ * testClock - Clock helper wrapper with async/await-friendly API
+ *
+ * Wraps FakeClock to provide ergonomic async helpers for test code.
+ * Use this in tests instead of raw FakeClock for better DX.
+ */
+import { FakeClock } from './FakeClock.js';
+export interface ClockHelper {
+    clock: FakeClock;
+    tick: (ms: number) => void;
+    flush: () => void;
+    tickAndFlush: (ms: number) => Promise<void>;
+    restore: () => void;
+}
+/**
+ * Create a fake clock for deterministic timer control
+ *
+ * Usage:
+ * ```typescript
+ * const { clock, tickAndFlush } = useFakeClock();
+ *
+ * const promise = cdp.send('Target.getTargets'); // Starts 30s timeout
+ * await tickAndFlush(30000); // Advances timer + drains all microtasks
+ * await assert.rejects(promise, /timeout/);
+ * ```
+ */
+export declare function useFakeClock(): ClockHelper;
+//# sourceMappingURL=testClock.d.ts.map

package/dist/__testutils__/testClock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"testClock.d.ts","sourceRoot":"","sources":["../../src/__testutils__/testClock.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,SAAS,CAAC;IACjB,IAAI,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IAC3B,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,YAAY,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5C,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,YAAY,IAAI,WAAW,CAuE1C"}

package/dist/__testutils__/testClock.js

@@ -0,0 +1,81 @@
+/**
+ * testClock - Clock helper wrapper with async/await-friendly API
+ *
+ * Wraps FakeClock to provide ergonomic async helpers for test code.
+ * Use this in tests instead of raw FakeClock for better DX.
+ */
+import { FakeClock } from './FakeClock.js';
+/**
+ * Create a fake clock for deterministic timer control
+ *
+ * Usage:
+ * ```typescript
+ * const { clock, tickAndFlush } = useFakeClock();
+ *
+ * const promise = cdp.send('Target.getTargets'); // Starts 30s timeout
+ * await tickAndFlush(30000); // Advances timer + drains all microtasks
+ * await assert.rejects(promise, /timeout/);
+ * ```
+ */
+export function useFakeClock() {
+    const clock = new FakeClock();
+    // Store original timer functions
+    const originalSetTimeout = global.setTimeout;
+    const originalClearTimeout = global.clearTimeout;
+    const originalSetInterval = global.setInterval;
+    const originalClearInterval = global.clearInterval;
+    const originalQueueMicrotask = global.queueMicrotask;
+    // Replace global timers with fake clock
+    global.setTimeout = ((callback, delay) => {
+        return clock.setTimeout(callback, delay);
+    });
+    global.clearTimeout = ((id) => {
+        return clock.clearTimer(id);
+    });
+    global.setInterval = ((callback, interval) => {
+        return clock.setInterval(callback, interval);
+    });
+    global.clearInterval = ((id) => {
+        return clock.clearTimer(id);
+    });
+    global.queueMicrotask = (callback) => {
+        clock.queueMicrotask(callback);
+    };
+    return {
+        clock,
+        /**
+         * Advance time and execute timers (macrotasks only)
+         * Does NOT drain microtasks
+         */
+        tick(ms) {
+            clock.tick(ms);
+        },
+        /**
+         * Drain microtask queue completely
+         * Loops until queue is empty (handles cascading microtasks)
+         */
+        flush() {
+            clock.flush();
+        },
+        /**
+         * Advance time AND drain all microtasks
+         * Use this for timeout tests where rejections propagate via microtasks
+         */
+        async tickAndFlush(ms) {
+            await clock.tickAsync(ms);
+        },
+        /**
+         * Restore original timer functions
+         * IMPORTANT: Call this in afterEach() to avoid polluting other tests
+         */
+        restore() {
+            global.setTimeout = originalSetTimeout;
+            global.clearTimeout = originalClearTimeout;
+            global.setInterval = originalSetInterval;
+            global.clearInterval = originalClearInterval;
+            global.queueMicrotask = originalQueueMicrotask;
+            clock.reset();
+        },
+    };
+}
+//# sourceMappingURL=testClock.js.map

package/dist/__testutils__/testClock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"testClock.js","sourceRoot":"","sources":["../../src/__testutils__/testClock.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAU3C;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,YAAY;IAC1B,MAAM,KAAK,GAAG,IAAI,SAAS,EAAE,CAAC;IAE9B,iCAAiC;IACjC,MAAM,kBAAkB,GAAG,MAAM,CAAC,UAAU,CAAC;IAC7C,MAAM,oBAAoB,GAAG,MAAM,CAAC,YAAY,CAAC;IACjD,MAAM,mBAAmB,GAAG,MAAM,CAAC,WAAW,CAAC;IAC/C,MAAM,qBAAqB,GAAG,MAAM,CAAC,aAAa,CAAC;IACnD,MAAM,sBAAsB,GAAG,MAAM,CAAC,cAAc,CAAC;IAErD,wCAAwC;IACxC,MAAM,CAAC,UAAU,GAAG,CAAC,CAAC,QAAoB,EAAE,KAAa,EAAE,EAAE;QAC3D,OAAO,KAAK,CAAC,UAAU,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IAC3C,CAAC,CAAsB,CAAC;IAExB,MAAM,CAAC,YAAY,GAAG,CAAC,CAAC,EAAkB,EAAE,EAAE;QAC5C,OAAO,KAAK,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;IAC9B,CAAC,CAAwB,CAAC;IAE1B,MAAM,CAAC,WAAW,GAAG,CAAC,CAAC,QAAoB,EAAE,QAAgB,EAAE,EAAE;QAC/D,OAAO,KAAK,CAAC,WAAW,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAC/C,CAAC,CAAuB,CAAC;IAEzB,MAAM,CAAC,aAAa,GAAG,CAAC,CAAC,EAAkB,EAAE,EAAE;QAC7C,OAAO,KAAK,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;IAC9B,CAAC,CAAyB,CAAC;IAE3B,MAAM,CAAC,cAAc,GAAG,CAAC,QAAoB,EAAE,EAAE;QAC/C,KAAK,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC;IACjC,CAAC,CAAC;IAEF,OAAO;QACL,KAAK;QAEL;;;WAGG;QACH,IAAI,CAAC,EAAU;YACb,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACjB,CAAC;QAED;;;WAGG;QACH,KAAK;YACH,KAAK,CAAC,KAAK,EAAE,CAAC;QAChB,CAAC;QAED;;;WAGG;QACH,KAAK,CAAC,YAAY,CAAC,EAAU;YAC3B,MAAM,KAAK,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;QAC5B,CAAC;QAED;;;WAGG;QACH,OAAO;YACL,MAAM,CAAC,UAAU,GAAG,kBAAkB,CAAC;YACvC,MAAM,CAAC,YAAY,GAAG,oBAAoB,CAAC;YAC3C,MAAM,CAAC,WAAW,GAAG,mBAAmB,CAAC;YACzC,MAAM,CAAC,aAAa,GAAG,qBAAqB,CAAC;YAC7C,MAAM,CAAC,cAAc,GAAG,sBAAsB,CAAC;YAC/C,KAAK,CAAC,KAAK,EAAE,CAAC;QAChB,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/__testutils__/testFixtures.d.ts

@@ -0,0 +1,15 @@
+/**
+ * testFixtures - Factory functions for test data
+ *
+ * Provides convenient factories for creating test objects with sensible defaults.
+ */
+import type { CDPMessage } from '@/types.js';
+/**
+ * Create a mock CDP message with optional overrides
+ */
+export declare function createMockCDPMessage(overrides?: Partial<CDPMessage>): CDPMessage;
+/**
+ * Create a WebSocket URL for testing
+ */
+export declare function createMockWebSocketUrl(port?: number): string;
+//# sourceMappingURL=testFixtures.d.ts.map

package/dist/__testutils__/testFixtures.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"testFixtures.d.ts","sourceRoot":"","sources":["../../src/__testutils__/testFixtures.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,GAAG,UAAU,CAOhF;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,SAAO,GAAG,MAAM,CAE1D"}

package/dist/__testutils__/testFixtures.js

@@ -0,0 +1,23 @@
+/**
+ * testFixtures - Factory functions for test data
+ *
+ * Provides convenient factories for creating test objects with sensible defaults.
+ */
+/**
+ * Create a mock CDP message with optional overrides
+ */
+export function createMockCDPMessage(overrides) {
+    return {
+        id: 1,
+        method: 'Target.getTargets',
+        params: {},
+        ...overrides,
+    };
+}
+/**
+ * Create a WebSocket URL for testing
+ */
+export function createMockWebSocketUrl(port = 9222) {
+    return `ws://localhost:${port}/devtools/browser`;
+}
+//# sourceMappingURL=testFixtures.js.map

package/dist/__testutils__/testFixtures.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"testFixtures.js","sourceRoot":"","sources":["../../src/__testutils__/testFixtures.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAAC,SAA+B;IAClE,OAAO;QACL,EAAE,EAAE,CAAC;QACL,MAAM,EAAE,mBAAmB;QAC3B,MAAM,EAAE,EAAE;QACV,GAAG,SAAS;KACb,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,sBAAsB,CAAC,IAAI,GAAG,IAAI;IAChD,OAAO,kBAAkB,IAAI,mBAAmB,CAAC;AACnD,CAAC"}

package/dist/__testutils__/testProcess.d.ts

@@ -0,0 +1,46 @@
+/**
+ * testProcess - Helpers for stubbing process-related operations in tests
+ *
+ * Provides utilities to mock process.kill for testing process alive checks
+ * without actually sending signals.
+ *
+ * ⚠️ CRITICAL: Always call restoreProcessAlive() in afterEach() to prevent
+ * cross-suite pollution.
+ *
+ * Usage:
+ * ```typescript
+ * describe('my test', () => {
+ *   afterEach(() => {
+ *     restoreProcessAlive(); // REQUIRED
+ *   });
+ *
+ *   it('should check if process is alive', () => {
+ *     mockProcessAlive([1234, 5678]);
+ *     // Now process.kill(1234, 0) returns true
+ *     // And process.kill(9999, 0) returns false
+ *   });
+ * });
+ * ```
+ */
+/**
+ * Mock process.kill to simulate alive/dead processes
+ *
+ * When signal is 0 (alive check), returns true if PID is in alivePids array,
+ * or throws ESRCH error if PID is dead.
+ * For other signals, delegates to original process.kill.
+ *
+ * @param alivePids - Array of PIDs that should be considered "alive"
+ */
+export declare function mockProcessAlive(alivePids: number[]): void;
+/**
+ * Restore original process.kill implementation
+ *
+ * ⚠️ CRITICAL: Always call this in afterEach() to prevent test pollution
+ */
+export declare function restoreProcessAlive(): void;
+/**
+ * Check if process.kill is currently mocked
+ * (Useful for debugging test cleanup issues)
+ */
+export declare function isProcessMocked(): boolean;
+//# sourceMappingURL=testProcess.d.ts.map

package/dist/__testutils__/testProcess.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"testProcess.d.ts","sourceRoot":"","sources":["../../src/__testutils__/testProcess.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAIH;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,IAAI,CAwB1D;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,IAAI,IAAI,CAK1C;AAED;;;GAGG;AACH,wBAAgB,eAAe,IAAI,OAAO,CAEzC"}

package/dist/__testutils__/testProcess.js

@@ -0,0 +1,77 @@
+/**
+ * testProcess - Helpers for stubbing process-related operations in tests
+ *
+ * Provides utilities to mock process.kill for testing process alive checks
+ * without actually sending signals.
+ *
+ * ⚠️ CRITICAL: Always call restoreProcessAlive() in afterEach() to prevent
+ * cross-suite pollution.
+ *
+ * Usage:
+ * ```typescript
+ * describe('my test', () => {
+ *   afterEach(() => {
+ *     restoreProcessAlive(); // REQUIRED
+ *   });
+ *
+ *   it('should check if process is alive', () => {
+ *     mockProcessAlive([1234, 5678]);
+ *     // Now process.kill(1234, 0) returns true
+ *     // And process.kill(9999, 0) returns false
+ *   });
+ * });
+ * ```
+ */
+let originalKill = null;
+/**
+ * Mock process.kill to simulate alive/dead processes
+ *
+ * When signal is 0 (alive check), returns true if PID is in alivePids array,
+ * or throws ESRCH error if PID is dead.
+ * For other signals, delegates to original process.kill.
+ *
+ * @param alivePids - Array of PIDs that should be considered "alive"
+ */
+export function mockProcessAlive(alivePids) {
+    // Capture original process.kill if not already saved (bind to avoid unbound-method)
+    originalKill ??= process.kill.bind(process);
+    const alivePidSet = new Set(alivePids);
+    process.kill = ((pid, signal) => {
+        // Signal 0 is used to check if process exists (doesn't actually send signal)
+        if (signal === 0 || signal === undefined) {
+            if (alivePidSet.has(pid)) {
+                // Process is alive - return true
+                return true;
+            }
+            else {
+                // Process is dead - throw ESRCH error (like real process.kill)
+                const err = new Error(`kill ESRCH`);
+                err.code = 'ESRCH';
+                err.errno = -3;
+                err.syscall = 'kill';
+                throw err;
+            }
+        }
+        // For other signals, delegate to original implementation
+        return originalKill(pid, signal);
+    });
+}
+/**
+ * Restore original process.kill implementation
+ *
+ * ⚠️ CRITICAL: Always call this in afterEach() to prevent test pollution
+ */
+export function restoreProcessAlive() {
+    if (originalKill !== null) {
+        process.kill = originalKill;
+        originalKill = null;
+    }
+}
+/**
+ * Check if process.kill is currently mocked
+ * (Useful for debugging test cleanup issues)
+ */
+export function isProcessMocked() {
+    return originalKill !== null;
+}
+//# sourceMappingURL=testProcess.js.map

package/dist/__testutils__/testProcess.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"testProcess.js","sourceRoot":"","sources":["../../src/__testutils__/testProcess.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,IAAI,YAAY,GAA+B,IAAI,CAAC;AAEpD;;;;;;;;GAQG;AACH,MAAM,UAAU,gBAAgB,CAAC,SAAmB;IAClD,oFAAoF;IACpF,YAAY,KAAK,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAE5C,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,SAAS,CAAC,CAAC;IAEvC,OAAO,CAAC,IAAI,GAAG,CAAC,CAAC,GAAW,EAAE,MAAgC,EAAE,EAAE;QAChE,6EAA6E;QAC7E,IAAI,MAAM,KAAK,CAAC,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzC,IAAI,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;gBACzB,iCAAiC;gBACjC,OAAO,IAAI,CAAC;YACd,CAAC;iBAAM,CAAC;gBACN,+DAA+D;gBAC/D,MAAM,GAAG,GAAG,IAAI,KAAK,CAAC,YAAY,CAA0B,CAAC;gBAC7D,GAAG,CAAC,IAAI,GAAG,OAAO,CAAC;gBACnB,GAAG,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;gBACf,GAAG,CAAC,OAAO,GAAG,MAAM,CAAC;gBACrB,MAAM,GAAG,CAAC;YACZ,CAAC;QACH,CAAC;QACD,yDAAyD;QACzD,OAAQ,YAAoC,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IAC5D,CAAC,CAAwB,CAAC;AAC5B,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,mBAAmB;IACjC,IAAI,YAAY,KAAK,IAAI,EAAE,CAAC;QAC1B,OAAO,CAAC,IAAI,GAAG,YAAY,CAAC;QAC5B,YAAY,GAAG,IAAI,CAAC;IACtB,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe;IAC7B,OAAO,YAAY,KAAK,IAAI,CAAC;AAC/B,CAAC"}

package/dist/cli/collectors/dom.d.ts

@@ -0,0 +1,8 @@
+import type { Command } from 'commander';
+/**
+ * Register DOM collector commands
+ *
+ * @param program - Commander.js Command instance
+ */
+export declare function registerDomCommands(program: Command): void;
+//# sourceMappingURL=dom.d.ts.map

package/dist/cli/collectors/dom.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dom.d.ts","sourceRoot":"","sources":["../../../src/cli/collectors/dom.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAsZzC;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAmD1D"}

package/dist/cli/collectors/dom.js

@@ -0,0 +1,361 @@
+import { OutputBuilder } from '../handlers/OutputBuilder.js';
+import { queryDOM, highlightDOM, getDOM } from '../../ipc/client.js';
+import { getErrorMessage } from '../../utils/errors.js';
+import { EXIT_CODES } from '../../utils/exitCodes.js';
+import { getNodeIdByIndex } from './helpers/domCache.js';
+import { parseSelectorOrIndex } from './helpers/selectorParser.js';
+/**
+ * Handle bdg dom query \<selector|index\> command
+ * @param selector - CSS selector to query
+ * @param options - Command options
+ */
+async function handleDomQuery(selector, options) {
+    try {
+        // Send query request via IPC to daemon/worker
+        const response = await queryDOM(selector);
+        if (response.status === 'error') {
+            throw new Error(response.error ?? 'Unknown error');
+        }
+        if (!response.data) {
+            throw new Error('No data in response');
+        }
+        const { count, nodes } = response.data;
+        if (count === 0) {
+            if (options.json) {
+                console.log(JSON.stringify({
+                    selector,
+                    count: 0,
+                    nodes: [],
+                }, null, 2));
+            }
+            else {
+                console.log(`No elements found matching "${selector}"`);
+            }
+            process.exit(EXIT_CODES.SUCCESS);
+        }
+        // Output results
+        if (options.json) {
+            console.log(JSON.stringify(response.data, null, 2));
+        }
+        else {
+            console.log(`Found ${count} element${count === 1 ? '' : 's'} matching "${selector}":`);
+            for (const node of nodes) {
+                const classInfo = node.classes && node.classes.length > 0 ? ` class="${node.classes.join(' ')}"` : '';
+                console.log(`  [${node.index}] <${node.tag}${classInfo}> ${node.preview}`);
+            }
+        }
+        process.exit(EXIT_CODES.SUCCESS);
+    }
+    catch (error) {
+        const errorMsg = getErrorMessage(error);
+        if (options.json) {
+            console.log(JSON.stringify(OutputBuilder.buildJsonError(errorMsg), null, 2));
+        }
+        else {
+            console.error(`Error: ${errorMsg}`);
+        }
+        process.exit(EXIT_CODES.UNHANDLED_EXCEPTION);
+    }
+}
+/**
+ * Handle bdg dom highlight \<selector|index\> command
+ * @param selectorOrIndex - CSS selector or index from last query
+ * @param options - Command options
+ */
+async function handleDomHighlight(selectorOrIndex, options) {
+    try {
+        // Build IPC request options
+        const ipcOptions = {
+            ...(options.color !== undefined && { color: options.color }),
+            ...(options.opacity !== undefined && { opacity: options.opacity }),
+            ...(options.first !== undefined && { first: options.first }),
+            ...(options.nth !== undefined && { nth: options.nth }),
+        };
+        // Handle direct nodeId (advanced users)
+        if (options.nodeId !== undefined) {
+            ipcOptions.nodeId = options.nodeId;
+        }
+        else {
+            const parsed = parseSelectorOrIndex(selectorOrIndex);
+            if (parsed.type === 'index') {
+                // Look up nodeId from cache
+                const nodeId = getNodeIdByIndex(parsed.value);
+                if (!nodeId) {
+                    throw new Error(`No cached element at index ${parsed.value}. Run 'bdg dom query <selector>' first.`);
+                }
+                ipcOptions.index = parsed.value;
+            }
+            else {
+                // Query by selector
+                ipcOptions.selector = parsed.value;
+            }
+        }
+        // Send highlight request via IPC to daemon/worker
+        const response = await highlightDOM(ipcOptions);
+        if (response.status === 'error') {
+            throw new Error(response.error ?? 'Unknown error');
+        }
+        if (!response.data) {
+            throw new Error('No data in response');
+        }
+        // Output result
+        if (options.json) {
+            console.log(JSON.stringify(response.data, null, 2));
+        }
+        else {
+            console.log(`✓ Highlighted ${response.data.highlighted} element${response.data.highlighted === 1 ? '' : 's'}`);
+        }
+        process.exit(EXIT_CODES.SUCCESS);
+    }
+    catch (error) {
+        const errorMsg = getErrorMessage(error);
+        if (options.json) {
+            console.log(JSON.stringify(OutputBuilder.buildJsonError(errorMsg), null, 2));
+        }
+        else {
+            console.error(`Error: ${errorMsg}`);
+        }
+        process.exit(EXIT_CODES.UNHANDLED_EXCEPTION);
+    }
+}
+/**
+ * Handle bdg dom get \<selector|index\> command
+ * @param selectorOrIndex - CSS selector or index from last query
+ * @param options - Command options
+ */
+async function handleDomGet(selectorOrIndex, options) {
+    try {
+        // Build IPC request options
+        const ipcOptions = {
+            ...(options.all !== undefined && { all: options.all }),
+            ...(options.nth !== undefined && { nth: options.nth }),
+        };
+        // Handle direct nodeId (advanced users)
+        if (options.nodeId !== undefined) {
+            ipcOptions.nodeId = options.nodeId;
+        }
+        else {
+            const parsed = parseSelectorOrIndex(selectorOrIndex);
+            if (parsed.type === 'index') {
+                // Look up nodeId from cache
+                const nodeId = getNodeIdByIndex(parsed.value);
+                if (!nodeId) {
+                    throw new Error(`No cached element at index ${parsed.value}. Run 'bdg dom query <selector>' first.`);
+                }
+                ipcOptions.index = parsed.value;
+            }
+            else {
+                // Query by selector
+                ipcOptions.selector = parsed.value;
+            }
+        }
+        // Send get request via IPC to daemon/worker
+        const response = await getDOM(ipcOptions);
+        if (response.status === 'error') {
+            throw new Error(response.error ?? 'Unknown error');
+        }
+        if (!response.data) {
+            throw new Error('No data in response');
+        }
+        const { nodes } = response.data;
+        // Output results
+        if (options.json) {
+            console.log(JSON.stringify(nodes.length === 1 ? nodes[0] : nodes, null, 2));
+        }
+        else {
+            if (nodes.length === 1) {
+                const firstNode = nodes[0];
+                if (firstNode) {
+                    console.log(firstNode.outerHTML);
+                }
+            }
+            else {
+                for (let i = 0; i < nodes.length; i++) {
+                    const node = nodes[i];
+                    if (node) {
+                        console.log(`[${i + 1}] ${node.outerHTML}`);
+                    }
+                }
+            }
+        }
+        process.exit(EXIT_CODES.SUCCESS);
+    }
+    catch (error) {
+        const errorMsg = getErrorMessage(error);
+        if (options.json) {
+            console.log(JSON.stringify(OutputBuilder.buildJsonError(errorMsg), null, 2));
+        }
+        else {
+            console.error(`Error: ${errorMsg}`);
+        }
+        process.exit(EXIT_CODES.UNHANDLED_EXCEPTION);
+    }
+}
+/**
+ * Handle bdg dom eval \<script\> command
+ * @param script - JavaScript expression to evaluate
+ * @param options - Command options
+ */
+async function handleDomEval(script, options) {
+    try {
+        // Import the query command handler
+        const { readPid } = await import('../../session/pid.js');
+        const { isProcessAlive } = await import('../../session/process.js');
+        const { readSessionMetadata } = await import('../../session/metadata.js');
+        const { CDPConnection } = await import('../../connection/cdp.js');
+        // Check if session is running
+        const pid = readPid();
+        if (!pid || !isProcessAlive(pid)) {
+            const errorMsg = 'No active session running';
+            if (options.json) {
+                console.log(JSON.stringify(OutputBuilder.buildJsonError(errorMsg, {
+                    suggestion: 'Start a session with: bdg <url>',
+                }), null, 2));
+            }
+            else {
+                console.error(`Error: ${errorMsg}`);
+                console.error('Start a session with: bdg <url>');
+            }
+            process.exit(EXIT_CODES.RESOURCE_NOT_FOUND);
+        }
+        // Read session metadata to get the target ID
+        const metadata = readSessionMetadata();
+        if (!metadata?.targetId || !metadata.webSocketDebuggerUrl) {
+            const errorMsg = 'No target information in session metadata';
+            if (options.json) {
+                console.log(JSON.stringify(OutputBuilder.buildJsonError(errorMsg, {
+                    note: 'Session may have been started with an older version',
+                }), null, 2));
+            }
+            else {
+                console.error(`Error: ${errorMsg}`);
+                console.error('Session may have been started with an older version');
+            }
+            process.exit(EXIT_CODES.SESSION_FILE_ERROR);
+        }
+        // Verify the target still exists
+        const port = parseInt(options.port ?? '9222', 10);
+        const response = await fetch(`http://127.0.0.1:${port}/json/list`);
+        const targetsData = await response.json();
+        if (!Array.isArray(targetsData)) {
+            const errorMsg = 'Invalid response from CDP';
+            if (options.json) {
+                console.log(JSON.stringify(OutputBuilder.buildJsonError(errorMsg), null, 2));
+            }
+            else {
+                console.error(`Error: ${errorMsg}`);
+            }
+            process.exit(EXIT_CODES.CDP_CONNECTION_FAILURE);
+        }
+        const target = targetsData.find((t) => t.id === metadata.targetId);
+        if (!target) {
+            const errorMsg = 'Session target not found (tab may have been closed)';
+            if (options.json) {
+                console.log(JSON.stringify(OutputBuilder.buildJsonError(errorMsg, {
+                    suggestion: 'Start a new session with: bdg <url>',
+                }), null, 2));
+            }
+            else {
+                console.error(`Error: ${errorMsg}`);
+                console.error('Start a new session with: bdg <url>');
+            }
+            process.exit(EXIT_CODES.RESOURCE_NOT_FOUND);
+        }
+        // Create temporary CDP connection using stored webSocketDebuggerUrl
+        const cdp = new CDPConnection();
+        await cdp.connect(metadata.webSocketDebuggerUrl);
+        // Execute JavaScript
+        const result = (await cdp.send('Runtime.evaluate', {
+            expression: script,
+            returnByValue: true,
+            awaitPromise: true,
+        }));
+        cdp.close();
+        // Output result
+        if (result.exceptionDetails) {
+            const errorMsg = result.exceptionDetails.exception?.description ?? 'Unknown error executing script';
+            if (options.json) {
+                console.log(JSON.stringify(OutputBuilder.buildJsonError(errorMsg), null, 2));
+            }
+            else {
+                console.error('Error executing script:');
+                console.error(errorMsg);
+            }
+            process.exit(EXIT_CODES.UNHANDLED_EXCEPTION);
+        }
+        // Output result (wrapped if --json, raw otherwise)
+        if (options.json) {
+            console.log(JSON.stringify(OutputBuilder.buildJsonSuccess({
+                result: result.result?.value,
+            }), null, 2));
+        }
+        else {
+            console.log(JSON.stringify(result.result?.value, null, 2));
+        }
+        process.exit(EXIT_CODES.SUCCESS);
+    }
+    catch (error) {
+        const errorMsg = getErrorMessage(error);
+        if (options.json) {
+            console.log(JSON.stringify(OutputBuilder.buildJsonError(errorMsg), null, 2));
+        }
+        else {
+            console.error(`Error: ${errorMsg}`);
+        }
+        process.exit(EXIT_CODES.UNHANDLED_EXCEPTION);
+    }
+}
+/**
+ * Register DOM collector commands
+ *
+ * @param program - Commander.js Command instance
+ */
+export function registerDomCommands(program) {
+    const dom = program.command('dom').description('DOM inspection and manipulation');
+    // bdg dom query <selector>
+    dom
+        .command('query')
+        .description('Find elements by CSS selector')
+        .argument('<selector>', 'CSS selector (e.g., ".error", "#app", "button")')
+        .option('-j, --json', 'Output as JSON')
+        .action(async (selector, options) => {
+        await handleDomQuery(selector, options);
+    });
+    // bdg dom eval <script>
+    dom
+        .command('eval')
+        .description('Evaluate JavaScript expression in the page context')
+        .argument('<script>', 'JavaScript to execute (e.g., "document.title", "window.location.href")')
+        .option('-p, --port <number>', 'Chrome debugging port (default: 9222)')
+        .option('-j, --json', 'Wrap result in version/success format')
+        .action(async (script, options) => {
+        await handleDomEval(script, options);
+    });
+    // bdg dom highlight <selector|index>
+    dom
+        .command('highlight')
+        .description('Highlight elements in browser')
+        .argument('<selector|index>', 'CSS selector or index from last query')
+        .option('--first', 'Target first match only')
+        .option('--nth <n>', 'Target nth match', parseInt)
+        .option('--node-id <id>', 'Use nodeId directly (advanced)', parseInt)
+        .option('--color <color>', 'Highlight color (red, blue, green, yellow, orange, purple)')
+        .option('--opacity <value>', 'Highlight opacity (0.0 - 1.0)', parseFloat)
+        .option('-j, --json', 'Output as JSON')
+        .action(async (selectorOrIndex, options) => {
+        await handleDomHighlight(selectorOrIndex, options);
+    });
+    // bdg dom get <selector|index>
+    dom
+        .command('get')
+        .description('Get full HTML and attributes for elements')
+        .argument('<selector|index>', 'CSS selector or index from last query')
+        .option('--all', 'Target all matches')
+        .option('--nth <n>', 'Target nth match', parseInt)
+        .option('--node-id <id>', 'Use nodeId directly (advanced)', parseInt)
+        .option('-j, --json', 'Output as JSON')
+        .action(async (selectorOrIndex, options) => {
+        await handleDomGet(selectorOrIndex, options);
+    });
+}
+//# sourceMappingURL=dom.js.map