browser-debugger-cli 0.5.1 → 0.6.1

package/dist/commands/dom/formSubmitHelpers.js

@@ -0,0 +1,176 @@
+/**
+ * Form submission helpers with smart network waiting.
+ */
+import { CDPConnectionError, CDPTimeoutError } from '../../connection/errors.js';
+import { clickElement } from './formFillHelpers.js';
+/**
+ * Submit a form by clicking the submit button and waiting for completion.
+ *
+ * @param cdp - CDP connection
+ * @param selector - CSS selector for submit button
+ * @param options - Submit options
+ * @returns Promise resolving to submit result
+ *
+ * @throws CDPTimeoutError When timeout is reached
+ * @throws CDPConnectionError When CDP communication fails
+ *
+ * @example
+ * ```typescript
+ * // Submit and wait for network idle
+ * const result = await submitForm(cdp, 'button[type="submit"]', {
+ *   waitNetwork: 1000,
+ *   timeout: 10000
+ * });
+ * ```
+ *
+ * @remarks
+ * This function:
+ * 1. Clicks the submit button
+ * 2. Monitors network activity
+ * 3. Waits for network idle (no requests for N ms)
+ * 4. Optionally waits for page navigation
+ */
+export async function submitForm(cdp, selector, options = {}) {
+    const { index, waitNavigation = false, waitNetwork = 1000, timeout = 10000 } = options;
+    const startTime = Date.now();
+    // Step 1: Click the submit button
+    const clickOptions = {};
+    if (index !== undefined) {
+        clickOptions.index = index;
+    }
+    const clickResult = await clickElement(cdp, selector, clickOptions);
+    if (!clickResult.success) {
+        return {
+            success: false,
+            error: clickResult.error ?? 'Click failed',
+            selector: clickResult.selector ?? selector,
+            clicked: false,
+        };
+    }
+    // If no waiting requested, return immediately
+    if (waitNetwork === 0 && !waitNavigation) {
+        return {
+            success: true,
+            selector: selector,
+            clicked: true,
+            networkRequests: 0,
+            navigationOccurred: false,
+            waitTimeMs: Date.now() - startTime,
+        };
+    }
+    // Step 2: Wait for network idle and/or navigation
+    try {
+        const waitResult = await waitForCompletion(cdp, {
+            waitNavigation,
+            waitNetwork,
+            timeout,
+        });
+        return {
+            success: true,
+            selector: selector,
+            clicked: true,
+            networkRequests: waitResult.networkRequests,
+            navigationOccurred: waitResult.navigationOccurred,
+            waitTimeMs: Date.now() - startTime,
+        };
+    }
+    catch (error) {
+        if (error instanceof CDPTimeoutError) {
+            return {
+                success: false,
+                error: `Timeout waiting for form submission to complete (${timeout}ms)`,
+                selector: selector,
+                clicked: true,
+                waitTimeMs: Date.now() - startTime,
+            };
+        }
+        throw error;
+    }
+}
+/**
+ * Wait for form submission to complete (network idle and/or navigation).
+ *
+ * @param cdp - CDP connection
+ * @param options - Wait options
+ * @returns Promise resolving to wait result
+ *
+ * @throws CDPTimeoutError When timeout is reached
+ *
+ * @internal
+ */
+async function waitForCompletion(cdp, options) {
+    const { waitNavigation, waitNetwork, timeout } = options;
+    let activeRequests = 0;
+    let networkRequests = 0;
+    let navigationOccurred = false;
+    let idleTimeout = null;
+    let timeoutHandle = null;
+    return new Promise((resolve, reject) => {
+        // Store cleanup functions for proper cleanup
+        const cleanupFunctions = [];
+        // Set up timeout
+        timeoutHandle = setTimeout(() => {
+            cleanup();
+            reject(new CDPTimeoutError('Wait for completion timed out', new Error(`Timeout after ${timeout}ms`)));
+        }, timeout);
+        const checkCompletion = () => {
+            // Check if all conditions are met
+            const networkIdle = waitNetwork === 0 || activeRequests === 0;
+            const navigationComplete = !waitNavigation || navigationOccurred;
+            if (networkIdle && navigationComplete) {
+                cleanup();
+                resolve({ networkRequests, navigationOccurred });
+            }
+        };
+        // Monitor network requests
+        const onRequestStarted = () => {
+            networkRequests++;
+            activeRequests++;
+            if (idleTimeout) {
+                clearTimeout(idleTimeout);
+                idleTimeout = null;
+            }
+        };
+        const onRequestFinished = () => {
+            activeRequests--;
+            if (activeRequests === 0 && waitNetwork > 0) {
+                // Start idle timer
+                idleTimeout = setTimeout(() => {
+                    checkCompletion();
+                }, waitNetwork);
+            }
+        };
+        // Monitor navigation
+        const onNavigated = () => {
+            navigationOccurred = true;
+            checkCompletion();
+        };
+        // Register event listeners and store cleanup functions
+        cleanupFunctions.push(cdp.on('Network.requestWillBeSent', onRequestStarted));
+        cleanupFunctions.push(cdp.on('Network.loadingFinished', onRequestFinished));
+        cleanupFunctions.push(cdp.on('Network.loadingFailed', onRequestFinished));
+        if (waitNavigation) {
+            cleanupFunctions.push(cdp.on('Page.frameNavigated', onNavigated));
+        }
+        // Enable network monitoring if not already enabled
+        cdp.send('Network.enable').catch((error) => {
+            cleanup();
+            reject(new CDPConnectionError('Failed to enable network monitoring', error));
+        });
+        // Start initial check (in case no network requests happen)
+        if (waitNetwork === 0 || activeRequests === 0) {
+            idleTimeout = setTimeout(() => {
+                checkCompletion();
+            }, waitNetwork);
+        }
+        function cleanup() {
+            if (idleTimeout)
+                clearTimeout(idleTimeout);
+            if (timeoutHandle)
+                clearTimeout(timeoutHandle);
+            // Call all cleanup functions
+            cleanupFunctions.forEach((cleanup) => cleanup());
+        }
+    });
+}
+//# sourceMappingURL=formSubmitHelpers.js.map

package/dist/commands/dom/formSubmitHelpers.js.map

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

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

@@ -0,0 +1,34 @@
+/**
+ * DOM helpers using CDP relay pattern.
+ *
+ * Provides query, get, and screenshot functionality using the worker's persistent CDP connection.
+ * All operations go through IPC callCDP() for optimal performance.
+ */
+import type { DomQueryResult, DomGetResult, ScreenshotResult, DomGetOptions, ScreenshotOptions } from '../../types/dom.js';
+export type { DomQueryResult, DomGetResult, ScreenshotResult, DomGetOptions, ScreenshotOptions };
+/**
+ * Query DOM elements by CSS selector using CDP relay.
+ *
+ * @param selector - CSS selector to query
+ * @returns Query result with matched nodes
+ * @throws CDPConnectionError if CDP operation fails
+ */
+export declare function queryDOMElements(selector: string): Promise<DomQueryResult>;
+/**
+ * Get full HTML and attributes for DOM elements using CDP relay.
+ *
+ * @param options - Get options (selector or nodeId, plus optional --all or --nth flags)
+ * @returns Get result with node details
+ * @throws CDPConnectionError if CDP operation fails
+ */
+export declare function getDOMElements(options: DomGetOptions): Promise<DomGetResult>;
+/**
+ * Capture a screenshot of the page using CDP relay.
+ *
+ * @param outputPath - Path to save screenshot
+ * @param options - Screenshot options (format, quality, fullPage)
+ * @returns Screenshot result with path, format, dimensions, and size
+ * @throws CDPConnectionError if CDP operation fails
+ */
+export declare function capturePageScreenshot(outputPath: string, options?: ScreenshotOptions): Promise<ScreenshotResult>;
+//# sourceMappingURL=helpers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../../src/commands/dom/helpers.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,KAAK,EACV,cAAc,EACd,YAAY,EACZ,gBAAgB,EAChB,aAAa,EACb,iBAAiB,EAClB,MAAM,gBAAgB,CAAC;AASxB,YAAY,EAAE,cAAc,EAAE,YAAY,EAAE,gBAAgB,EAAE,aAAa,EAAE,iBAAiB,EAAE,CAAC;AAQjG;;;;;;GAMG;AACH,wBAAsB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CA8FhF;AAED;;;;;;GAMG;AACH,wBAAsB,cAAc,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC,CAkIlF;AAED;;;;;;;GAOG;AACH,wBAAsB,qBAAqB,CACzC,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,gBAAgB,CAAC,CAyD3B"}

package/dist/commands/dom/helpers.js

@@ -0,0 +1,244 @@
+/**
+ * DOM helpers using CDP relay pattern.
+ *
+ * Provides query, get, and screenshot functionality using the worker's persistent CDP connection.
+ * All operations go through IPC callCDP() for optimal performance.
+ */
+import { CDPConnectionError } from '../../connection/errors.js';
+import { callCDP } from '../../ipc/client.js';
+import { CommandError } from '../../ui/errors/index.js';
+import { createLogger } from '../../ui/logging/index.js';
+import { ConcurrencyLimiter } from '../../utils/concurrency.js';
+import { EXIT_CODES } from '../../utils/exitCodes.js';
+const log = createLogger('dom');
+/**
+ * Maximum concurrent CDP calls for DOM operations.
+ * Prevents overwhelming CDP connection with too many simultaneous requests.
+ */
+const CDP_CONCURRENCY_LIMIT = 10;
+/**
+ * Query DOM elements by CSS selector using CDP relay.
+ *
+ * @param selector - CSS selector to query
+ * @returns Query result with matched nodes
+ * @throws CDPConnectionError if CDP operation fails
+ */
+export async function queryDOMElements(selector) {
+    // Enable DOM domain
+    await callCDP('DOM.enable', {});
+    // Get document root
+    const docResponse = await callCDP('DOM.getDocument', {});
+    const doc = docResponse.data?.result;
+    if (!doc?.root?.nodeId) {
+        throw new CDPConnectionError('Failed to get document root', new Error('No root node'));
+    }
+    // Query selector
+    const queryResponse = await callCDP('DOM.querySelectorAll', {
+        nodeId: doc.root.nodeId,
+        selector,
+    });
+    const queryResult = queryResponse.data?.result;
+    const nodeIds = queryResult?.nodeIds ?? [];
+    // Log progress for large queries
+    if (nodeIds.length > 20) {
+        log.debug(`Querying ${nodeIds.length} elements with selector: ${selector}`);
+    }
+    // Get info for each node with concurrency control
+    const limiter = new ConcurrencyLimiter(CDP_CONCURRENCY_LIMIT);
+    const nodes = await Promise.all(nodeIds.map((nodeId, index) => limiter.run(async () => {
+        // Describe node
+        const descResponse = await callCDP('DOM.describeNode', { nodeId });
+        const descResult = descResponse.data?.result;
+        const nodeDesc = descResult?.node;
+        if (!nodeDesc) {
+            return { index, nodeId };
+        }
+        // Parse attributes
+        const attributes = {};
+        if (nodeDesc.attributes) {
+            for (let i = 0; i < nodeDesc.attributes.length; i += 2) {
+                const key = nodeDesc.attributes[i];
+                const value = nodeDesc.attributes[i + 1];
+                if (key !== undefined && value !== undefined) {
+                    attributes[key] = value;
+                }
+            }
+        }
+        // Extract classes and create preview
+        const classes = attributes['class']?.split(/\s+/).filter((c) => c.length > 0);
+        const tag = nodeDesc.nodeName.toLowerCase();
+        // Get outer HTML for preview
+        const htmlResponse = await callCDP('DOM.getOuterHTML', { nodeId });
+        const htmlResult = htmlResponse.data?.result;
+        const outerHTML = htmlResult?.outerHTML ?? '';
+        // Create preview text
+        const textContent = outerHTML
+            .replace(/<[^>]*>/g, '')
+            .replace(/\s+/g, ' ')
+            .trim();
+        const preview = textContent.slice(0, 80) + (textContent.length > 80 ? '...' : '');
+        const node = { index, nodeId };
+        if (tag)
+            node.tag = tag;
+        if (classes)
+            node.classes = classes;
+        if (preview)
+            node.preview = preview;
+        return node;
+    })));
+    return {
+        selector,
+        count: nodes.length,
+        nodes,
+    };
+}
+/**
+ * Get full HTML and attributes for DOM elements using CDP relay.
+ *
+ * @param options - Get options (selector or nodeId, plus optional --all or --nth flags)
+ * @returns Get result with node details
+ * @throws CDPConnectionError if CDP operation fails
+ */
+export async function getDOMElements(options) {
+    await callCDP('DOM.enable', {});
+    let nodeIds = [];
+    if (options.nodeId !== undefined) {
+        nodeIds = [options.nodeId];
+    }
+    else if (options.selector) {
+        // Get document root
+        const docResponse = await callCDP('DOM.getDocument', {});
+        const doc = docResponse.data?.result;
+        if (!doc?.root?.nodeId) {
+            throw new CDPConnectionError('Failed to get document root', new Error('No root node'));
+        }
+        // Query selector
+        const queryResponse = await callCDP('DOM.querySelectorAll', {
+            nodeId: doc.root.nodeId,
+            selector: options.selector,
+        });
+        const queryResult = queryResponse.data?.result;
+        nodeIds = queryResult?.nodeIds ?? [];
+        if (nodeIds.length === 0) {
+            throw new CommandError(`No elements found matching "${options.selector}"`, { suggestion: 'Verify the CSS selector is correct' }, EXIT_CODES.RESOURCE_NOT_FOUND);
+        }
+        // Apply filtering
+        if (options.nth !== undefined) {
+            if (options.nth < 1 || options.nth > nodeIds.length) {
+                throw new CommandError(`--nth ${options.nth} out of range (found ${nodeIds.length} elements)`, { suggestion: `Use a value between 1 and ${nodeIds.length}` }, EXIT_CODES.INVALID_ARGUMENTS);
+            }
+            const nthNode = nodeIds[options.nth - 1];
+            if (nthNode === undefined) {
+                throw new CommandError(`Element at index ${options.nth} not found`, {}, EXIT_CODES.RESOURCE_NOT_FOUND);
+            }
+            nodeIds = [nthNode];
+        }
+        else if (!options.all) {
+            // Default: return first match only
+            const firstNode = nodeIds[0];
+            if (firstNode === undefined) {
+                throw new CommandError('No elements found', {}, EXIT_CODES.RESOURCE_NOT_FOUND);
+            }
+            nodeIds = [firstNode];
+        }
+    }
+    else {
+        throw new CommandError('Either selector or nodeId must be provided', {}, EXIT_CODES.INVALID_ARGUMENTS);
+    }
+    // Log progress for large fetches
+    if (nodeIds.length > 20) {
+        log.debug(`Fetching details for ${nodeIds.length} DOM elements`);
+    }
+    // Fetch node details with concurrency control
+    const limiter = new ConcurrencyLimiter(CDP_CONCURRENCY_LIMIT);
+    const nodes = await Promise.all(nodeIds.map((nodeId) => limiter.run(async () => {
+        // Describe node
+        const descResponse = await callCDP('DOM.describeNode', { nodeId });
+        const descResult = descResponse.data?.result;
+        const nodeDesc = descResult?.node;
+        if (!nodeDesc) {
+            return { nodeId };
+        }
+        // Parse attributes
+        const attributes = {};
+        if (nodeDesc.attributes) {
+            for (let i = 0; i < nodeDesc.attributes.length; i += 2) {
+                const key = nodeDesc.attributes[i];
+                const value = nodeDesc.attributes[i + 1];
+                if (key !== undefined && value !== undefined) {
+                    attributes[key] = value;
+                }
+            }
+        }
+        // Extract classes
+        const classes = attributes['class']?.split(/\s+/).filter((c) => c.length > 0);
+        const tag = nodeDesc.nodeName.toLowerCase();
+        // Get outer HTML
+        const htmlResponse = await callCDP('DOM.getOuterHTML', { nodeId });
+        const htmlResult = htmlResponse.data?.result;
+        const outerHTML = htmlResult?.outerHTML;
+        const node = { nodeId };
+        if (tag)
+            node.tag = tag;
+        if (Object.keys(attributes).length > 0)
+            node.attributes = attributes;
+        if (classes)
+            node.classes = classes;
+        if (outerHTML)
+            node.outerHTML = outerHTML;
+        return node;
+    })));
+    return { nodes };
+}
+/**
+ * Capture a screenshot of the page using CDP relay.
+ *
+ * @param outputPath - Path to save screenshot
+ * @param options - Screenshot options (format, quality, fullPage)
+ * @returns Screenshot result with path, format, dimensions, and size
+ * @throws CDPConnectionError if CDP operation fails
+ */
+export async function capturePageScreenshot(outputPath, options = {}) {
+    const format = options.format ?? 'png';
+    const quality = format === 'jpeg' ? (options.quality ?? 90) : undefined;
+    const fullPage = options.fullPage ?? true;
+    // Get viewport dimensions
+    const metricsResponse = await callCDP('Page.getLayoutMetrics', {});
+    const metricsResult = metricsResponse.data?.result;
+    const contentSize = metricsResult?.contentSize ?? { width: 0, height: 0 };
+    const viewport = metricsResult?.visualViewport ?? { clientWidth: 0, clientHeight: 0 };
+    // Capture screenshot
+    const screenshotResponse = await callCDP('Page.captureScreenshot', {
+        format,
+        ...(quality !== undefined && { quality }),
+        captureBeyondViewport: fullPage,
+    });
+    const screenshotResult = screenshotResponse.data?.result;
+    if (!screenshotResult?.data) {
+        throw new CDPConnectionError('No screenshot data returned', new Error('Empty response'));
+    }
+    const path = await import('path');
+    const { AtomicFileWriter } = await import('../../utils/atomicFile.js');
+    const buffer = Buffer.from(screenshotResult.data, 'base64');
+    const absolutePath = path.resolve(outputPath);
+    await AtomicFileWriter.writeBufferAsync(absolutePath, buffer);
+    const result = {
+        path: absolutePath,
+        format,
+        width: fullPage ? contentSize.width : viewport.clientWidth,
+        height: fullPage ? contentSize.height : viewport.clientHeight,
+        size: buffer.length,
+        fullPage,
+    };
+    if (quality !== undefined) {
+        result.quality = quality;
+    }
+    if (!fullPage) {
+        result.viewport = {
+            width: viewport.clientWidth,
+            height: viewport.clientHeight,
+        };
+    }
+    return result;
+}
+//# sourceMappingURL=helpers.js.map

package/dist/commands/dom/helpers.js.map

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

package/dist/commands/{dom.d.ts → dom/index.d.ts}

@@ -5,4 +5,4 @@ import type { Command } from 'commander';
  * @param program - Commander.js Command instance
  */
 export declare function registerDomCommands(program: Command): void;
-//# sourceMappingURL=dom.d.ts.map
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/commands/dom/index.js

@@ -0,0 +1,154 @@
+import { queryDOMElements, getDOMElements, capturePageScreenshot } from '../../commands/dom/helpers.js';
+import { runCommand } from '../../commands/shared/CommandRunner.js';
+import { formatDomQuery, formatDomGet, formatDomEval, formatDomScreenshot, } from '../../ui/formatters/dom.js';
+import { filterDefined } from '../../utils/objects.js';
+import { parsePositiveIntOption } from '../../utils/validation.js';
+/**
+ * Handle bdg dom query <selector> command
+ *
+ * Queries the DOM using a CSS selector and displays matching elements.
+ * Uses CDP relay through worker's persistent connection.
+ *
+ * @param selector - CSS selector to query (e.g., ".error", "#app", "button")
+ * @param options - Command options
+ */
+async function handleDomQuery(selector, options) {
+    await runCommand(async () => {
+        const result = await queryDOMElements(selector);
+        return { success: true, data: result };
+    }, options, formatDomQuery);
+}
+/**
+ * Handle bdg dom get command
+ *
+ * Retrieves full HTML and attributes for DOM elements. Accepts CSS selector or direct nodeId.
+ * Uses CDP relay through worker's persistent connection.
+ *
+ * @param selector - CSS selector (e.g., ".error")
+ * @param options - Command options including --all, --nth, and nodeId
+ */
+async function handleDomGet(selector, options) {
+    await runCommand(async () => {
+        const getOptions = filterDefined({
+            selector,
+            all: options.all,
+            nth: options.nth,
+            nodeId: options.nodeId,
+        });
+        const result = await getDOMElements(getOptions);
+        return { success: true, data: result };
+    }, 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.
+ * Uses CDP relay through worker's persistent connection.
+ *
+ * @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 result = await capturePageScreenshot(path, screenshotOptions);
+        return { success: true, data: result };
+    }, 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('../../commands/dom/evalHelpers.js');
+        // Validate session is running
+        validateActiveSession();
+        // Get and validate session metadata
+        const metadata = getValidatedSessionMetadata();
+        // Verify target still exists
+        const port = parsePositiveIntOption('port', options.port, {
+            defaultValue: 9222,
+            min: 1,
+            max: 65535,
+        });
+        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,
+            // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
+            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 get <selector>
+    dom
+        .command('get')
+        .description('Get full HTML and attributes for elements')
+        .argument('<selector>', 'CSS selector (e.g., ".error", "#app", "button")')
+        .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 (selector, options) => {
+        await handleDomGet(selector, 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=index.js.map

package/dist/commands/dom/index.js.map

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