browser-debugger-cli 0.1.0 → 0.3.0

package/dist/commands/details.js

@@ -0,0 +1,68 @@
+import { runCommand } from '../commands/shared/CommandRunner.js';
+import { jsonOption } from '../commands/shared/commonOptions.js';
+import { getDetails } from '../ipc/client.js';
+import { validateIPCResponse } from '../ipc/responseValidator.js';
+import { formatNetworkDetails, formatConsoleDetails } from '../ui/formatters/details.js';
+import { EXIT_CODES } from '../utils/exitCodes.js';
+/**
+ * Format details for human-readable output.
+ * Dispatches to the appropriate formatter based on type.
+ *
+ * @param data - Details result containing item and type
+ */
+function formatDetails(data) {
+    if (data.type === 'network') {
+        return formatNetworkDetails(data.item);
+    }
+    else {
+        return formatConsoleDetails(data.item);
+    }
+}
+/**
+ * Register details command.
+ *
+ * @param program - Commander.js Command instance to register commands on
+ */
+export function registerDetailsCommand(program) {
+    program
+        .command('details')
+        .description('Get detailed information for a specific request or console message')
+        .argument('<type>', 'Type of item: "network" or "console"')
+        .argument('<id>', 'Request ID (for network) or index (for console)')
+        .addOption(jsonOption)
+        .action(async (type, id, options) => {
+        // Store arguments in options for handler (type assertion safe due to validation below)
+        options.type = type;
+        options.id = id;
+        await runCommand(async (opts) => {
+            // Validate type argument
+            if (opts.type !== 'network' && opts.type !== 'console') {
+                return {
+                    success: false,
+                    error: `Unknown type: ${String(opts.type)}. Valid types: network, console`,
+                    exitCode: EXIT_CODES.INVALID_ARGUMENTS,
+                };
+            }
+            // Fetch details via IPC from daemon/worker
+            const response = await getDetails(opts.type, opts.id);
+            // Validate IPC response (throws on error)
+            validateIPCResponse(response);
+            // Check for data in response
+            if (!response.data?.item) {
+                return {
+                    success: false,
+                    error: 'No data in response',
+                    exitCode: EXIT_CODES.RESOURCE_NOT_FOUND,
+                };
+            }
+            return {
+                success: true,
+                data: {
+                    item: response.data.item,
+                    type: opts.type,
+                },
+            };
+        }, options, formatDetails);
+    });
+}
+//# sourceMappingURL=details.js.map

package/dist/commands/details.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"details.js","sourceRoot":"","sources":["../../src/commands/details.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,UAAU,EAAE,MAAM,oCAAoC,CAAC;AAChE,OAAO,EAAE,UAAU,EAAE,MAAM,oCAAoC,CAAC;AAChE,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAEjE,OAAO,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AACxF,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAsBlD;;;;;GAKG;AACH,SAAS,aAAa,CAAC,IAAmB;IACxC,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAC5B,OAAO,oBAAoB,CAAC,IAAI,CAAC,IAAsB,CAAC,CAAC;IAC3D,CAAC;SAAM,CAAC;QACN,OAAO,oBAAoB,CAAC,IAAI,CAAC,IAAsB,CAAC,CAAC;IAC3D,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,sBAAsB,CAAC,OAAgB;IACrD,OAAO;SACJ,OAAO,CAAC,SAAS,CAAC;SAClB,WAAW,CAAC,oEAAoE,CAAC;SACjF,QAAQ,CAAC,QAAQ,EAAE,sCAAsC,CAAC;SAC1D,QAAQ,CAAC,MAAM,EAAE,iDAAiD,CAAC;SACnE,SAAS,CAAC,UAAU,CAAC;SACrB,MAAM,CAAC,KAAK,EAAE,IAAY,EAAE,EAAU,EAAE,OAAuB,EAAE,EAAE;QAClE,uFAAuF;QACvF,OAAO,CAAC,IAAI,GAAG,IAA6B,CAAC;QAC7C,OAAO,CAAC,EAAE,GAAG,EAAE,CAAC;QAEhB,MAAM,UAAU,CACd,KAAK,EAAE,IAAI,EAAE,EAAE;YACb,yBAAyB;YACzB,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;gBACvD,OAAO;oBACL,OAAO,EAAE,KAAK;oBACd,KAAK,EAAE,iBAAiB,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,iCAAiC;oBAC1E,QAAQ,EAAE,UAAU,CAAC,iBAAiB;iBACvC,CAAC;YACJ,CAAC;YAED,2CAA2C;YAC3C,MAAM,QAAQ,GAAG,MAAM,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC;YAEtD,0CAA0C;YAC1C,mBAAmB,CAAC,QAAQ,CAAC,CAAC;YAE9B,6BAA6B;YAC7B,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC;gBACzB,OAAO;oBACL,OAAO,EAAE,KAAK;oBACd,KAAK,EAAE,qBAAqB;oBAC5B,QAAQ,EAAE,UAAU,CAAC,kBAAkB;iBACxC,CAAC;YACJ,CAAC;YAED,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,IAAI,EAAE;oBACJ,IAAI,EAAE,QAAQ,CAAC,IAAI,CAAC,IAAkD;oBACtE,IAAI,EAAE,IAAI,CAAC,IAAI;iBAChB;aACF,CAAC;QACJ,CAAC,EACD,OAAO,EACP,aAAa,CACd,CAAC;IACJ,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/commands/dom.d.ts

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

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

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

package/dist/commands/dom.js

@@ -0,0 +1,249 @@
+import { runCommand } from '../commands/shared/CommandRunner.js';
+import { queryDOM, highlightDOM, getDOM, captureScreenshot } from '../ipc/client.js';
+import { formatDomQuery, formatDomHighlight, formatDomGet, formatDomEval, formatDomScreenshot, } from '../ui/formatters/dom.js';
+import { filterDefined } from '../utils/objects.js';
+import { buildSelectorOptions } from './domOptionsBuilder.js';
+/**
+ * Handle bdg dom query <selector> command
+ *
+ * Queries the DOM using a CSS selector and displays matching elements.
+ * Results are cached for 5 minutes to enable index-based references in other commands.
+ *
+ * @param selector - CSS selector to query (e.g., ".error", "#app", "button")
+ * @param options - Command options
+ */
+async function handleDomQuery(selector, options) {
+    await runCommand(async () => {
+        const response = await queryDOM(selector);
+        if (response.status === 'error') {
+            return {
+                success: false,
+                error: response.error ?? 'Unknown error',
+            };
+        }
+        if (!response.data) {
+            return {
+                success: false,
+                error: 'No data in response',
+            };
+        }
+        return {
+            success: true,
+            data: response.data,
+        };
+    }, options, formatDomQuery);
+}
+/**
+ * Handle bdg dom highlight command
+ *
+ * Highlights elements in the browser with visual overlay. Accepts CSS selector,
+ * cached index from previous query, or direct nodeId.
+ *
+ * @param selectorOrIndex - CSS selector (e.g., ".error") or index from cached query (e.g., "2")
+ * @param options - Command options including color, opacity, targeting flags, and nodeId
+ */
+async function handleDomHighlight(selectorOrIndex, options) {
+    await runCommand(async () => {
+        // Build base IPC request options (color, opacity, targeting)
+        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 }),
+        };
+        // Add selector/index/nodeId using shared helper
+        const selectorOptions = buildSelectorOptions(selectorOrIndex, options.nodeId);
+        Object.assign(ipcOptions, selectorOptions);
+        const response = await highlightDOM(ipcOptions);
+        if (response.status === 'error') {
+            return {
+                success: false,
+                error: response.error ?? 'Unknown error',
+            };
+        }
+        if (!response.data) {
+            return {
+                success: false,
+                error: 'No data in response',
+            };
+        }
+        return {
+            success: true,
+            data: response.data,
+        };
+    }, options, formatDomHighlight);
+}
+/**
+ * Handle bdg dom get command
+ *
+ * Retrieves full HTML and attributes for DOM elements. Accepts CSS selector,
+ * cached index from previous query, or direct nodeId.
+ *
+ * @param selectorOrIndex - CSS selector (e.g., ".error") or index from cached query (e.g., "2")
+ * @param options - Command options including --all, --nth, and nodeId
+ */
+async function handleDomGet(selectorOrIndex, options) {
+    await runCommand(async () => {
+        // Build base IPC request options (targeting flags)
+        const ipcOptions = {
+            ...(options.all !== undefined && { all: options.all }),
+            ...(options.nth !== undefined && { nth: options.nth }),
+        };
+        // Add selector/index/nodeId using shared helper
+        const selectorOptions = buildSelectorOptions(selectorOrIndex, options.nodeId);
+        Object.assign(ipcOptions, selectorOptions);
+        const response = await getDOM(ipcOptions);
+        if (response.status === 'error') {
+            return {
+                success: false,
+                error: response.error ?? 'Unknown error',
+            };
+        }
+        if (!response.data) {
+            return {
+                success: false,
+                error: 'No data in response',
+            };
+        }
+        return {
+            success: true,
+            data: response.data,
+        };
+    }, options, formatDomGet);
+}
+/**
+ * Handle bdg dom screenshot <path> command
+ *
+ * Captures a screenshot of the current page and saves it to disk.
+ * Supports PNG and JPEG formats with customizable quality and viewport options.
+ *
+ * @param path - Output file path (absolute or relative)
+ * @param options - Screenshot options (format, quality, fullPage)
+ */
+async function handleDomScreenshot(path, options) {
+    await runCommand(async () => {
+        const screenshotOptions = filterDefined({
+            format: options.format,
+            quality: options.quality,
+            fullPage: options.fullPage,
+        });
+        const response = await captureScreenshot(path, screenshotOptions);
+        if (response.status === 'error') {
+            return {
+                success: false,
+                error: response.error ?? 'Unknown error',
+            };
+        }
+        if (!response.data) {
+            return {
+                success: false,
+                error: 'No data in response',
+            };
+        }
+        return {
+            success: true,
+            data: response.data,
+        };
+    }, options, formatDomScreenshot);
+}
+/**
+ * Handle bdg dom eval <script> command
+ *
+ * Evaluates arbitrary JavaScript in the browser context and returns the result.
+ * Requires an active session. Uses CDP Runtime.evaluate with async support.
+ * Note: This command uses direct CDP connection (not IPC) so it follows a different pattern.
+ *
+ * @param script - JavaScript expression to evaluate (e.g., "document.title", "window.location.href")
+ * @param options - Command options including port and json formatting
+ */
+async function handleDomEval(script, options) {
+    await runCommand(async () => {
+        // Lazy load CDP connection (only needed for eval command)
+        const { CDPConnection } = await import('../connection/cdp.js');
+        const { validateActiveSession, getValidatedSessionMetadata, verifyTargetExists, executeScript, } = await import('./domEvalHelpers.js');
+        // Validate session is running
+        validateActiveSession();
+        // Get and validate session metadata
+        const metadata = getValidatedSessionMetadata();
+        // Verify target still exists
+        const port = parseInt(options.port ?? '9222', 10);
+        await verifyTargetExists(metadata, port);
+        // Create temporary CDP connection and execute script
+        const cdp = new CDPConnection();
+        // getValidatedSessionMetadata ensures webSocketDebuggerUrl is defined
+        // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
+        await cdp.connect(metadata.webSocketDebuggerUrl);
+        const result = await executeScript(cdp, script);
+        cdp.close();
+        return {
+            success: true,
+            data: { result: result.result?.value },
+        };
+    }, options, formatDomEval);
+}
+/**
+ * Register DOM telemetry 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);
+    });
+    // bdg dom screenshot <path>
+    dom
+        .command('screenshot')
+        .description('Capture page screenshot')
+        .argument('<path>', 'Output file path (e.g., "./screenshot.png")')
+        .option('--format <format>', 'Image format: png or jpeg (default: png)')
+        .option('--quality <number>', 'JPEG quality 0-100 (default: 90)', parseInt)
+        .option('--no-full-page', 'Capture viewport only (default: full page)')
+        .option('-j, --json', 'Output as JSON')
+        .action(async (path, options) => {
+        await handleDomScreenshot(path, options);
+    });
+}
+//# sourceMappingURL=dom.js.map

package/dist/commands/dom.js.map

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

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,48 @@
+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
+ *
+ * @returns PID of running session
+ * @throws Error When no active session is found
+ */
+export declare function validateActiveSession(): number;
+/**
+ * Get session metadata with validation
+ *
+ * @returns Session metadata including targetId and webSocketDebuggerUrl
+ * @throws Error When metadata is invalid or missing required fields
+ */
+export declare function getValidatedSessionMetadata(): SessionMetadata;
+/**
+ * Verify that the CDP target still exists
+ *
+ * @param metadata - Session metadata containing targetId
+ * @param port - CDP port number
+ * @throws Error When CDP response is invalid or target not found
+ */
+export declare function verifyTargetExists(metadata: SessionMetadata, port: number): 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;;;;;GAKG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,CAU9C;AAED;;;;;GAKG;AACH,wBAAgB,2BAA2B,IAAI,eAAe,CAY7D;AAED;;;;;;GAMG;AACH,wBAAsB,kBAAkB,CAAC,QAAQ,EAAE,eAAe,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAiB/F;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,72 @@
+import { readSessionMetadata } from '../session/metadata.js';
+import { readPid } from '../session/pid.js';
+import { isProcessAlive } from '../session/process.js';
+import { CommandError } from '../ui/errors.js';
+import { invalidCDPResponseError } from '../ui/messages/errors.js';
+import { EXIT_CODES } from '../utils/exitCodes.js';
+/**
+ * Validate that an active session is running
+ *
+ * @returns PID of running session
+ * @throws Error When no active session is found
+ */
+export function validateActiveSession() {
+    const pid = readPid();
+    if (!pid || !isProcessAlive(pid)) {
+        throw new CommandError('No active session running', { suggestion: 'Start a session with: bdg <url>' }, EXIT_CODES.RESOURCE_NOT_FOUND);
+    }
+    return pid;
+}
+/**
+ * Get session metadata with validation
+ *
+ * @returns Session metadata including targetId and webSocketDebuggerUrl
+ * @throws Error When metadata is invalid or missing required fields
+ */
+export function getValidatedSessionMetadata() {
+    const metadata = readSessionMetadata();
+    if (!metadata?.targetId || !metadata.webSocketDebuggerUrl) {
+        throw new CommandError('No target information in session metadata', { note: 'Session may have been started with an older version' }, EXIT_CODES.SESSION_FILE_ERROR);
+    }
+    return metadata;
+}
+/**
+ * Verify that the CDP target still exists
+ *
+ * @param metadata - Session metadata containing targetId
+ * @param port - CDP port number
+ * @throws Error When CDP response is invalid or target not found
+ */
+export async function verifyTargetExists(metadata, port) {
+    const response = await fetch(`http://127.0.0.1:${port}/json/list`);
+    const targetsData = await response.json();
+    if (!Array.isArray(targetsData)) {
+        throw new Error(invalidCDPResponseError());
+    }
+    const target = targetsData.find((t) => t.id === metadata.targetId);
+    if (!target) {
+        throw new CommandError('Session target not found (tab may have been closed)', { 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,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAuBlD;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB;IACnC,MAAM,GAAG,GAAG,OAAO,EAAE,CAAC;IACtB,IAAI,CAAC,GAAG,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,EAAE,CAAC;QACjC,MAAM,IAAI,YAAY,CACpB,2BAA2B,EAC3B,EAAE,UAAU,EAAE,iCAAiC,EAAE,EACjD,UAAU,CAAC,kBAAkB,CAC9B,CAAC;IACJ,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,2BAA2B;IACzC,MAAM,QAAQ,GAAG,mBAAmB,EAAE,CAAC;IAEvC,IAAI,CAAC,QAAQ,EAAE,QAAQ,IAAI,CAAC,QAAQ,CAAC,oBAAoB,EAAE,CAAC;QAC1D,MAAM,IAAI,YAAY,CACpB,2CAA2C,EAC3C,EAAE,IAAI,EAAE,qDAAqD,EAAE,EAC/D,UAAU,CAAC,kBAAkB,CAC9B,CAAC;IACJ,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,QAAyB,EAAE,IAAY;IAC9E,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,uBAAuB,EAAE,CAAC,CAAC;IAC7C,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,MAAM,IAAI,YAAY,CACpB,qDAAqD,EACrD,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"}