browser-debugger-cli 0.1.0-alpha.1 → 0.2.0

package/dist/commands/domErrorHandler.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Handle command errors with consistent formatting
+ *
+ * Outputs error message in JSON or human-readable format and exits with error code.
+ * This function never returns - it always calls process.exit().
+ *
+ * @param error - Error object or message
+ * @param json - Whether to output JSON format
+ * @param exitCode - Exit code to use (defaults to UNHANDLED_EXCEPTION)
+ * @throws never This function always exits the process
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await someOperation();
+ * } catch (error) {
+ *   handleCommandError(error, options.json);
+ * }
+ * ```
+ */
+export declare function handleCommandError(error: unknown, json: boolean, exitCode?: number): never;
+/**
+ * Handle command errors with additional context
+ *
+ * Similar to handleCommandError but allows adding suggestion or note metadata
+ * to JSON error output for better user guidance.
+ *
+ * @param error - Error object or message
+ * @param json - Whether to output JSON format
+ * @param metadata - Additional context (suggestion, note, etc.)
+ * @param exitCode - Exit code to use (defaults to UNHANDLED_EXCEPTION)
+ * @throws never This function always exits the process
+ *
+ * @example
+ * ```typescript
+ * handleCommandErrorWithContext(
+ *   'Session not found',
+ *   options.json,
+ *   { suggestion: 'Start a session with: bdg <url>' },
+ *   EXIT_CODES.RESOURCE_NOT_FOUND
+ * );
+ * ```
+ */
+export declare function handleCommandErrorWithContext(error: unknown, json: boolean, metadata: Record<string, string>, exitCode?: number): never;
+//# sourceMappingURL=domErrorHandler.d.ts.map

package/dist/commands/domErrorHandler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"domErrorHandler.d.ts","sourceRoot":"","sources":["../../src/commands/domErrorHandler.ts"],"names":[],"mappings":"AAKA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,OAAO,EACd,IAAI,EAAE,OAAO,EACb,QAAQ,GAAE,MAAuC,GAChD,KAAK,CAQP;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,6BAA6B,CAC3C,KAAK,EAAE,OAAO,EACd,IAAI,EAAE,OAAO,EACb,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAChC,QAAQ,GAAE,MAAuC,GAChD,KAAK,CAYP"}

package/dist/commands/domErrorHandler.js

@@ -0,0 +1,71 @@
+import { OutputBuilder } from '../commands/shared/OutputBuilder.js';
+import { genericError } from '../ui/messages/errors.js';
+import { getErrorMessage } from '../utils/errors.js';
+import { EXIT_CODES } from '../utils/exitCodes.js';
+/**
+ * Handle command errors with consistent formatting
+ *
+ * Outputs error message in JSON or human-readable format and exits with error code.
+ * This function never returns - it always calls process.exit().
+ *
+ * @param error - Error object or message
+ * @param json - Whether to output JSON format
+ * @param exitCode - Exit code to use (defaults to UNHANDLED_EXCEPTION)
+ * @throws never This function always exits the process
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await someOperation();
+ * } catch (error) {
+ *   handleCommandError(error, options.json);
+ * }
+ * ```
+ */
+export function handleCommandError(error, json, exitCode = EXIT_CODES.UNHANDLED_EXCEPTION) {
+    const errorMsg = getErrorMessage(error);
+    if (json) {
+        console.log(JSON.stringify(OutputBuilder.buildJsonError(errorMsg), null, 2));
+    }
+    else {
+        console.error(genericError(errorMsg));
+    }
+    process.exit(exitCode);
+}
+/**
+ * Handle command errors with additional context
+ *
+ * Similar to handleCommandError but allows adding suggestion or note metadata
+ * to JSON error output for better user guidance.
+ *
+ * @param error - Error object or message
+ * @param json - Whether to output JSON format
+ * @param metadata - Additional context (suggestion, note, etc.)
+ * @param exitCode - Exit code to use (defaults to UNHANDLED_EXCEPTION)
+ * @throws never This function always exits the process
+ *
+ * @example
+ * ```typescript
+ * handleCommandErrorWithContext(
+ *   'Session not found',
+ *   options.json,
+ *   { suggestion: 'Start a session with: bdg <url>' },
+ *   EXIT_CODES.RESOURCE_NOT_FOUND
+ * );
+ * ```
+ */
+export function handleCommandErrorWithContext(error, json, metadata, exitCode = EXIT_CODES.UNHANDLED_EXCEPTION) {
+    const errorMsg = getErrorMessage(error);
+    if (json) {
+        console.log(JSON.stringify(OutputBuilder.buildJsonError(errorMsg, metadata), null, 2));
+    }
+    else {
+        console.error(genericError(errorMsg));
+        // Output metadata as additional help text
+        for (const value of Object.values(metadata)) {
+            console.error(`${value}`);
+        }
+    }
+    process.exit(exitCode);
+}
+//# sourceMappingURL=domErrorHandler.js.map

package/dist/commands/domErrorHandler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"domErrorHandler.js","sourceRoot":"","sources":["../../src/commands/domErrorHandler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,oCAAoC,CAAC;AACnE,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAElD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,kBAAkB,CAChC,KAAc,EACd,IAAa,EACb,WAAmB,UAAU,CAAC,mBAAmB;IAEjD,MAAM,QAAQ,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC;IACxC,IAAI,IAAI,EAAE,CAAC;QACT,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC,cAAc,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IAC/E,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,KAAK,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC,CAAC;IACxC,CAAC;IACD,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;AACzB,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,UAAU,6BAA6B,CAC3C,KAAc,EACd,IAAa,EACb,QAAgC,EAChC,WAAmB,UAAU,CAAC,mBAAmB;IAEjD,MAAM,QAAQ,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC;IACxC,IAAI,IAAI,EAAE,CAAC;QACT,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC,cAAc,CAAC,QAAQ,EAAE,QAAQ,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IACzF,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,KAAK,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC,CAAC;QACtC,0CAA0C;QAC1C,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC5C,OAAO,CAAC,KAAK,CAAC,GAAG,KAAK,EAAE,CAAC,CAAC;QAC5B,CAAC;IACH,CAAC;IACD,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;AACzB,CAAC"}

package/dist/commands/domEvalHelpers.d.ts

@@ -0,0 +1,52 @@
+import type { CDPConnection } from '../connection/cdp.js';
+import { type SessionMetadata } from '../session/metadata.js';
+/**
+ * CDP Runtime.evaluate result
+ */
+interface RuntimeEvaluateResult {
+    exceptionDetails?: {
+        exception?: {
+            description?: string;
+        };
+    };
+    result?: {
+        value?: unknown;
+    };
+}
+/**
+ * Validate that an active session is running
+ *
+ * @param json - Whether to output JSON format
+ * @returns PID of running session
+ * @throws never Exits process if no active session found
+ */
+export declare function validateActiveSession(json: boolean): number;
+/**
+ * Get session metadata with validation
+ *
+ * @param json - Whether to output JSON format
+ * @returns Session metadata including targetId and webSocketDebuggerUrl
+ * @throws never Exits process if metadata is invalid or missing required fields
+ */
+export declare function getValidatedSessionMetadata(json: boolean): SessionMetadata;
+/**
+ * Verify that the CDP target still exists
+ *
+ * @param metadata - Session metadata containing targetId
+ * @param port - CDP port number
+ * @param json - Whether to output JSON format
+ * @throws Error When CDP response is invalid
+ * @throws never Exits process if target not found
+ */
+export declare function verifyTargetExists(metadata: SessionMetadata, port: number, json: boolean): Promise<void>;
+/**
+ * Execute JavaScript in browser context via CDP
+ *
+ * @param cdp - CDP connection instance
+ * @param script - JavaScript expression to execute
+ * @returns Execution result
+ * @throws Error When script execution throws exception
+ */
+export declare function executeScript(cdp: CDPConnection, script: string): Promise<RuntimeEvaluateResult>;
+export {};
+//# sourceMappingURL=domEvalHelpers.d.ts.map

package/dist/commands/domEvalHelpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"domEvalHelpers.d.ts","sourceRoot":"","sources":["../../src/commands/domEvalHelpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAuB,KAAK,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAclF;;GAEG;AACH,UAAU,qBAAqB;IAC7B,gBAAgB,CAAC,EAAE;QACjB,SAAS,CAAC,EAAE;YACV,WAAW,CAAC,EAAE,MAAM,CAAC;SACtB,CAAC;KACH,CAAC;IACF,MAAM,CAAC,EAAE;QACP,KAAK,CAAC,EAAE,OAAO,CAAC;KACjB,CAAC;CACH;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAW3D;AAED;;;;;;GAMG;AACH,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,OAAO,GAAG,eAAe,CAc1E;AAED;;;;;;;;GAQG;AACH,wBAAsB,kBAAkB,CACtC,QAAQ,EAAE,eAAe,EACzB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,OAAO,GACZ,OAAO,CAAC,IAAI,CAAC,CAkBf;AAED;;;;;;;GAOG;AACH,wBAAsB,aAAa,CACjC,GAAG,EAAE,aAAa,EAClB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,qBAAqB,CAAC,CAehC"}

package/dist/commands/domEvalHelpers.js

@@ -0,0 +1,76 @@
+import { readSessionMetadata } from '../session/metadata.js';
+import { readPid } from '../session/pid.js';
+import { isProcessAlive } from '../session/process.js';
+import { EXIT_CODES } from '../utils/exitCodes.js';
+import { handleCommandErrorWithContext } from './domErrorHandler.js';
+/**
+ * Validate that an active session is running
+ *
+ * @param json - Whether to output JSON format
+ * @returns PID of running session
+ * @throws never Exits process if no active session found
+ */
+export function validateActiveSession(json) {
+    const pid = readPid();
+    if (!pid || !isProcessAlive(pid)) {
+        handleCommandErrorWithContext('No active session running', json, { suggestion: 'Start a session with: bdg <url>' }, EXIT_CODES.RESOURCE_NOT_FOUND);
+    }
+    return pid;
+}
+/**
+ * Get session metadata with validation
+ *
+ * @param json - Whether to output JSON format
+ * @returns Session metadata including targetId and webSocketDebuggerUrl
+ * @throws never Exits process if metadata is invalid or missing required fields
+ */
+export function getValidatedSessionMetadata(json) {
+    const metadata = readSessionMetadata();
+    if (!metadata?.targetId || !metadata.webSocketDebuggerUrl) {
+        handleCommandErrorWithContext('No target information in session metadata', json, { note: 'Session may have been started with an older version' }, EXIT_CODES.SESSION_FILE_ERROR);
+    }
+    // TypeScript doesn't know handleCommandErrorWithContext never returns
+    return metadata;
+}
+/**
+ * Verify that the CDP target still exists
+ *
+ * @param metadata - Session metadata containing targetId
+ * @param port - CDP port number
+ * @param json - Whether to output JSON format
+ * @throws Error When CDP response is invalid
+ * @throws never Exits process if target not found
+ */
+export async function verifyTargetExists(metadata, port, json) {
+    const response = await fetch(`http://127.0.0.1:${port}/json/list`);
+    const targetsData = await response.json();
+    if (!Array.isArray(targetsData)) {
+        throw new Error('Invalid response from CDP');
+    }
+    const target = targetsData.find((t) => t.id === metadata.targetId);
+    if (!target) {
+        handleCommandErrorWithContext('Session target not found (tab may have been closed)', json, { suggestion: 'Start a new session with: bdg <url>' }, EXIT_CODES.RESOURCE_NOT_FOUND);
+    }
+}
+/**
+ * Execute JavaScript in browser context via CDP
+ *
+ * @param cdp - CDP connection instance
+ * @param script - JavaScript expression to execute
+ * @returns Execution result
+ * @throws Error When script execution throws exception
+ */
+export async function executeScript(cdp, script) {
+    const result = (await cdp.send('Runtime.evaluate', {
+        expression: script,
+        returnByValue: true,
+        awaitPromise: true,
+    }));
+    // Check for execution exceptions
+    if (result.exceptionDetails) {
+        const errorMsg = result.exceptionDetails.exception?.description ?? 'Unknown error executing script';
+        throw new Error(errorMsg);
+    }
+    return result;
+}
+//# sourceMappingURL=domEvalHelpers.js.map

package/dist/commands/domEvalHelpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"domEvalHelpers.js","sourceRoot":"","sources":["../../src/commands/domEvalHelpers.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAwB,MAAM,uBAAuB,CAAC;AAClF,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAElD,OAAO,EAAE,6BAA6B,EAAE,MAAM,sBAAsB,CAAC;AAuBrE;;;;;;GAMG;AACH,MAAM,UAAU,qBAAqB,CAAC,IAAa;IACjD,MAAM,GAAG,GAAG,OAAO,EAAE,CAAC;IACtB,IAAI,CAAC,GAAG,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,EAAE,CAAC;QACjC,6BAA6B,CAC3B,2BAA2B,EAC3B,IAAI,EACJ,EAAE,UAAU,EAAE,iCAAiC,EAAE,EACjD,UAAU,CAAC,kBAAkB,CAC9B,CAAC;IACJ,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,2BAA2B,CAAC,IAAa;IACvD,MAAM,QAAQ,GAAG,mBAAmB,EAAE,CAAC;IAEvC,IAAI,CAAC,QAAQ,EAAE,QAAQ,IAAI,CAAC,QAAQ,CAAC,oBAAoB,EAAE,CAAC;QAC1D,6BAA6B,CAC3B,2CAA2C,EAC3C,IAAI,EACJ,EAAE,IAAI,EAAE,qDAAqD,EAAE,EAC/D,UAAU,CAAC,kBAAkB,CAC9B,CAAC;IACJ,CAAC;IAED,sEAAsE;IACtE,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,QAAyB,EACzB,IAAY,EACZ,IAAa;IAEb,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,oBAAoB,IAAI,YAAY,CAAC,CAAC;IACnE,MAAM,WAAW,GAAY,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;IAEnD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,CAAC;QAChC,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC;IAC/C,CAAC;IAED,MAAM,MAAM,GAAI,WAA2B,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAEpF,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,6BAA6B,CAC3B,qDAAqD,EACrD,IAAI,EACJ,EAAE,UAAU,EAAE,qCAAqC,EAAE,EACrD,UAAU,CAAC,kBAAkB,CAC9B,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,GAAkB,EAClB,MAAc;IAEd,MAAM,MAAM,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,kBAAkB,EAAE;QACjD,UAAU,EAAE,MAAM;QAClB,aAAa,EAAE,IAAI;QACnB,YAAY,EAAE,IAAI;KACnB,CAAC,CAA0B,CAAC;IAE7B,iCAAiC;IACjC,IAAI,MAAM,CAAC,gBAAgB,EAAE,CAAC;QAC5B,MAAM,QAAQ,GACZ,MAAM,CAAC,gBAAgB,CAAC,SAAS,EAAE,WAAW,IAAI,gCAAgC,CAAC;QACrF,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,CAAC;IAC5B,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/commands/domOptionsBuilder.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Base interface for IPC options that accept selector, index, or nodeId
+ */
+export interface SelectorBasedOptions {
+    selector?: string;
+    index?: number;
+    nodeId?: number;
+}
+/**
+ * Build IPC request options from selector/index argument
+ *
+ * Handles three input methods:
+ * 1. Direct nodeId (advanced users) - sets nodeId field
+ * 2. Index from previous query - looks up nodeId from cache, sets index field
+ * 3. CSS selector - sets selector field
+ *
+ * @param selectorOrIndex - CSS selector string or numeric index
+ * @param nodeId - Optional direct nodeId (overrides selectorOrIndex)
+ * @returns Options object with selector, index, or nodeId set
+ * @throws Error When index is used but no cached element found at that index
+ *
+ * @example
+ * ```typescript
+ * // Direct nodeId (advanced)
+ * buildSelectorOptions('.error', 123)  // → { nodeId: 123 }
+ *
+ * // Index from cache
+ * buildSelectorOptions('2', undefined) // → { index: 2 } (if cache has index 2)
+ *
+ * // CSS selector
+ * buildSelectorOptions('.error', undefined) // → { selector: '.error' }
+ * ```
+ */
+export declare function buildSelectorOptions<T extends SelectorBasedOptions>(selectorOrIndex: string, nodeId: number | undefined): T;
+//# sourceMappingURL=domOptionsBuilder.d.ts.map

package/dist/commands/domOptionsBuilder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"domOptionsBuilder.d.ts","sourceRoot":"","sources":["../../src/commands/domOptionsBuilder.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,SAAS,oBAAoB,EACjE,eAAe,EAAE,MAAM,EACvB,MAAM,EAAE,MAAM,GAAG,SAAS,GACzB,CAAC,CA2BH"}

package/dist/commands/domOptionsBuilder.js

@@ -0,0 +1,51 @@
+import { getNodeIdByIndex } from '../session/queryCache.js';
+import { parseSelectorOrIndex } from './domSelectorParser.js';
+/**
+ * Build IPC request options from selector/index argument
+ *
+ * Handles three input methods:
+ * 1. Direct nodeId (advanced users) - sets nodeId field
+ * 2. Index from previous query - looks up nodeId from cache, sets index field
+ * 3. CSS selector - sets selector field
+ *
+ * @param selectorOrIndex - CSS selector string or numeric index
+ * @param nodeId - Optional direct nodeId (overrides selectorOrIndex)
+ * @returns Options object with selector, index, or nodeId set
+ * @throws Error When index is used but no cached element found at that index
+ *
+ * @example
+ * ```typescript
+ * // Direct nodeId (advanced)
+ * buildSelectorOptions('.error', 123)  // → { nodeId: 123 }
+ *
+ * // Index from cache
+ * buildSelectorOptions('2', undefined) // → { index: 2 } (if cache has index 2)
+ *
+ * // CSS selector
+ * buildSelectorOptions('.error', undefined) // → { selector: '.error' }
+ * ```
+ */
+export function buildSelectorOptions(selectorOrIndex, nodeId) {
+    const options = {};
+    // Direct nodeId takes precedence (advanced users)
+    if (nodeId !== undefined) {
+        options.nodeId = nodeId;
+        return options;
+    }
+    // Parse as selector or index
+    const parsed = parseSelectorOrIndex(selectorOrIndex);
+    if (parsed.type === 'index') {
+        // Look up nodeId from cache
+        const cachedNodeId = getNodeIdByIndex(parsed.value);
+        if (!cachedNodeId) {
+            throw new Error(`No cached element at index ${parsed.value}. Run 'bdg dom query <selector>' first.`);
+        }
+        options.index = parsed.value;
+    }
+    else {
+        // Use selector directly
+        options.selector = parsed.value;
+    }
+    return options;
+}
+//# sourceMappingURL=domOptionsBuilder.js.map

package/dist/commands/domOptionsBuilder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"domOptionsBuilder.js","sourceRoot":"","sources":["../../src/commands/domOptionsBuilder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAE3D,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAW9D;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,UAAU,oBAAoB,CAClC,eAAuB,EACvB,MAA0B;IAE1B,MAAM,OAAO,GAAG,EAAO,CAAC;IAExB,kDAAkD;IAClD,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,OAAO,CAAC,MAAM,GAAG,MAAM,CAAC;QACxB,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,6BAA6B;IAC7B,MAAM,MAAM,GAAG,oBAAoB,CAAC,eAAe,CAAC,CAAC;IAErD,IAAI,MAAM,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;QAC5B,4BAA4B;QAC5B,MAAM,YAAY,GAAG,gBAAgB,CAAC,MAAM,CAAC,KAAe,CAAC,CAAC;QAC9D,IAAI,CAAC,YAAY,EAAE,CAAC;YAClB,MAAM,IAAI,KAAK,CACb,8BAA8B,MAAM,CAAC,KAAK,yCAAyC,CACpF,CAAC;QACJ,CAAC;QACD,OAAO,CAAC,KAAK,GAAG,MAAM,CAAC,KAAe,CAAC;IACzC,CAAC;SAAM,CAAC;QACN,wBAAwB;QACxB,OAAO,CAAC,QAAQ,GAAG,MAAM,CAAC,KAAe,CAAC;IAC5C,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/commands/domSelectorParser.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Result of parsing a selector or index argument
+ */
+export interface ParsedSelector {
+    type: 'selector' | 'index';
+    value: string | number;
+}
+/**
+ * Parse argument as either CSS selector or index
+ *
+ * @param arg - Argument to parse (e.g., ".error" or "1")
+ * @returns Parsed result indicating type and value
+ *
+ * @example
+ * parseSelectorOrIndex(".error") // \{ type: 'selector', value: '.error' \}
+ * parseSelectorOrIndex("1")      // \{ type: 'index', value: 1 \}
+ * parseSelectorOrIndex("42")     // \{ type: 'index', value: 42 \}
+ */
+export declare function parseSelectorOrIndex(arg: string): ParsedSelector;
+//# sourceMappingURL=domSelectorParser.d.ts.map

package/dist/commands/domSelectorParser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"domSelectorParser.d.ts","sourceRoot":"","sources":["../../src/commands/domSelectorParser.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC;IAC3B,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;CACxB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,cAAc,CAQhE"}

package/dist/commands/domSelectorParser.js

@@ -0,0 +1,20 @@
+/**
+ * Parse argument as either CSS selector or index
+ *
+ * @param arg - Argument to parse (e.g., ".error" or "1")
+ * @returns Parsed result indicating type and value
+ *
+ * @example
+ * parseSelectorOrIndex(".error") // \{ type: 'selector', value: '.error' \}
+ * parseSelectorOrIndex("1")      // \{ type: 'index', value: 1 \}
+ * parseSelectorOrIndex("42")     // \{ type: 'index', value: 42 \}
+ */
+export function parseSelectorOrIndex(arg) {
+    // If arg is a positive integer, treat as index
+    if (/^\d+$/.test(arg)) {
+        return { type: 'index', value: parseInt(arg, 10) };
+    }
+    // Otherwise treat as CSS selector
+    return { type: 'selector', value: arg };
+}
+//# sourceMappingURL=domSelectorParser.js.map

package/dist/commands/domSelectorParser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"domSelectorParser.js","sourceRoot":"","sources":["../../src/commands/domSelectorParser.ts"],"names":[],"mappings":"AAQA;;;;;;;;;;GAUG;AACH,MAAM,UAAU,oBAAoB,CAAC,GAAW;IAC9C,+CAA+C;IAC/C,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QACtB,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE,CAAC;IACrD,CAAC;IAED,kCAAkC;IAClC,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC;AAC1C,CAAC"}

package/dist/commands/network.d.ts

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

package/dist/commands/network.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"network.d.ts","sourceRoot":"","sources":["../../src/commands/network.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAkBzC;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAuC9D"}

package/dist/commands/network.js

@@ -0,0 +1,43 @@
+import { runCommand } from '../commands/shared/CommandRunner.js';
+import { jsonOption } from '../commands/shared/commonOptions.js';
+import { callCDP } from '../ipc/client.js';
+import { validateIPCResponse } from '../ipc/responseValidator.js';
+import { formatCookies } from '../ui/formatters/index.js';
+/**
+ * Register network commands.
+ *
+ * @param program - Commander.js Command instance to register commands on
+ */
+export function registerNetworkCommands(program) {
+    const networkCmd = program.command('network').description('Inspect network state and resources');
+    // bdg network getCookies
+    networkCmd
+        .command('getCookies')
+        .description('List cookies from the current page')
+        .option('--url <url>', 'Filter cookies by URL')
+        .addOption(jsonOption)
+        .action(async (options) => {
+        await runCommand(async (opts) => {
+            // Build CDP method parameters
+            const params = {};
+            if (opts.url) {
+                params['urls'] = [opts.url];
+            }
+            // Call CDP Network.getCookies
+            const response = await callCDP('Network.getCookies', params);
+            // Validate IPC response (throws on error)
+            validateIPCResponse(response);
+            // Extract cookies from CDP response
+            const cookies = response.data?.result?.cookies ?? [];
+            return {
+                success: true,
+                data: cookies,
+            };
+        }, options, 
+        // Human-readable formatter (returns formatted string)
+        (cookies) => {
+            console.log(formatCookies(cookies));
+        });
+    });
+}
+//# sourceMappingURL=network.js.map

package/dist/commands/network.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"network.js","sourceRoot":"","sources":["../../src/commands/network.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,UAAU,EAAE,MAAM,oCAAoC,CAAC;AAChE,OAAO,EAAE,UAAU,EAAE,MAAM,oCAAoC,CAAC;AAChE,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAC1C,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAEjE,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAUzD;;;;GAIG;AACH,MAAM,UAAU,uBAAuB,CAAC,OAAgB;IACtD,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,WAAW,CAAC,qCAAqC,CAAC,CAAC;IAEjG,yBAAyB;IACzB,UAAU;SACP,OAAO,CAAC,YAAY,CAAC;SACrB,WAAW,CAAC,oCAAoC,CAAC;SACjD,MAAM,CAAC,aAAa,EAAE,uBAAuB,CAAC;SAC9C,SAAS,CAAC,UAAU,CAAC;SACrB,MAAM,CAAC,KAAK,EAAE,OAA0B,EAAE,EAAE;QAC3C,MAAM,UAAU,CACd,KAAK,EAAE,IAAI,EAAE,EAAE;YACb,8BAA8B;YAC9B,MAAM,MAAM,GAA4B,EAAE,CAAC;YAC3C,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC;gBACb,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAC9B,CAAC;YAED,8BAA8B;YAC9B,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,oBAAoB,EAAE,MAAM,CAAC,CAAC;YAE7D,0CAA0C;YAC1C,mBAAmB,CAAC,QAAQ,CAAC,CAAC;YAE9B,oCAAoC;YACpC,MAAM,OAAO,GAAI,QAAQ,CAAC,IAAI,EAAE,MAAiC,EAAE,OAAO,IAAI,EAAE,CAAC;YAEjF,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,IAAI,EAAE,OAAO;aACd,CAAC;QACJ,CAAC,EACD,OAAO;QACP,sDAAsD;QACtD,CAAC,OAAiB,EAAE,EAAE;YACpB,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC;QACtC,CAAC,CACF,CAAC;IACJ,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/commands/peek.d.ts

@@ -0,0 +1,8 @@
+import type { Command } from 'commander';
+/**
+ * Register peek command.
+ *
+ * @param program - Commander.js Command instance to register commands on
+ */
+export declare function registerPeekCommand(program: Command): void;
+//# sourceMappingURL=peek.d.ts.map

package/dist/commands/peek.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"peek.d.ts","sourceRoot":"","sources":["../../src/commands/peek.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA+BzC;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAoG1D"}

package/dist/commands/peek.js

@@ -0,0 +1,114 @@
+import { OutputBuilder } from '../commands/shared/OutputBuilder.js';
+import { jsonOption } from '../commands/shared/commonOptions.js';
+import { getPeek } from '../ipc/client.js';
+import { validateIPCResponse } from '../ipc/responseValidator.js';
+import { formatPreview } from '../ui/formatters/preview.js';
+import { invalidLastArgumentError } from '../ui/messages/commands.js';
+import { daemonNotRunningError, noPreviewDataError } from '../ui/messages/errors.js';
+import { EXIT_CODES } from '../utils/exitCodes.js';
+/**
+ * Handle errors in a consistent way for both follow and one-time modes.
+ *
+ * @param error - Error message
+ * @param options - Preview options
+ * @param exitCode - Exit code to use if not in follow mode
+ */
+function handlePreviewError(error, options, exitCode) {
+    if (options.json) {
+        console.log(JSON.stringify(OutputBuilder.buildJsonError(error), null, 2));
+    }
+    else {
+        console.error(noPreviewDataError());
+    }
+    if (!options.follow) {
+        process.exit(exitCode);
+    }
+}
+/**
+ * Register peek command.
+ *
+ * @param program - Commander.js Command instance to register commands on
+ */
+export function registerPeekCommand(program) {
+    program
+        .command('peek')
+        .description('Preview collected data without stopping the session')
+        .addOption(jsonOption)
+        .option('-v, --verbose', 'Use verbose output with full URLs and formatting')
+        .option('-n, --network', 'Show only network requests')
+        .option('-c, --console', 'Show only console messages')
+        .option('-f, --follow', 'Watch for updates (like tail -f)')
+        .option('--last <count>', 'Show last N items', '10')
+        .action(async (options) => {
+        // Validate --last parameter
+        const lastN = parseInt(options.last ?? '10', 10);
+        if (isNaN(lastN) || lastN < 1 || lastN > 1000) {
+            console.error(invalidLastArgumentError(options.last));
+            process.exit(EXIT_CODES.INVALID_ARGUMENTS);
+        }
+        options.last = lastN.toString();
+        const showPreview = async () => {
+            try {
+                // Fetch preview data via IPC from daemon
+                const response = await getPeek();
+                // Validate IPC response (will throw on error)
+                try {
+                    validateIPCResponse(response);
+                }
+                catch {
+                    handlePreviewError(response.error ?? 'Unknown error', options, EXIT_CODES.RESOURCE_NOT_FOUND);
+                    return;
+                }
+                // Extract preview data from response
+                const output = response.data?.preview;
+                if (!output) {
+                    handlePreviewError('No preview data in response', options, EXIT_CODES.RESOURCE_NOT_FOUND);
+                    return;
+                }
+                // Clear screen before rendering to prevent stacked outputs in follow mode
+                if (options.follow) {
+                    console.clear();
+                }
+                // Add current view timestamp for follow mode to show refresh time
+                const previewOptions = options.follow
+                    ? { ...options, viewedAt: new Date() }
+                    : options;
+                console.log(formatPreview(output, previewOptions));
+            }
+            catch {
+                // Handle IPC connection errors (daemon not running, etc.)
+                // Note: validateIPCResponse errors are caught above
+                if (options.json) {
+                    console.log(JSON.stringify(OutputBuilder.buildJsonError('Daemon not running', {
+                        suggestion: 'Start it with: bdg <url>',
+                    }), null, 2));
+                }
+                else {
+                    console.error(daemonNotRunningError());
+                }
+                if (!options.follow) {
+                    process.exit(EXIT_CODES.RESOURCE_NOT_FOUND);
+                }
+            }
+        };
+        if (options.follow) {
+            // Follow mode: update every second
+            console.error('Following live preview (Ctrl+C to stop)...\n');
+            await showPreview();
+            const followInterval = setInterval(() => {
+                void showPreview();
+            }, 1000);
+            // Handle Ctrl+C gracefully
+            process.on('SIGINT', () => {
+                clearInterval(followInterval);
+                console.error('\nStopped following preview');
+                process.exit(EXIT_CODES.SUCCESS);
+            });
+        }
+        else {
+            // One-time preview
+            await showPreview();
+        }
+    });
+}
+//# sourceMappingURL=peek.js.map

package/dist/commands/peek.js.map

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