browser-debugger-cli 0.5.1 → 0.6.1

package/dist/commands/{domEvalHelpers.js → dom/evalHelpers.js}

@@ -1,14 +1,14 @@
-import { readSessionMetadata } from '../session/metadata.js';
-import { readPid } from '../session/pid.js';
-import { isProcessAlive } from '../session/process.js';
-import { CommandError } from '../ui/errors/index.js';
-import { invalidCDPResponseError } from '../ui/messages/errors.js';
-import { EXIT_CODES } from '../utils/exitCodes.js';
+import { readSessionMetadata } from '../../session/metadata.js';
+import { readPid } from '../../session/pid.js';
+import { isProcessAlive } from '../../session/process.js';
+import { CommandError } from '../../ui/errors/index.js';
+import { EXIT_CODES } from '../../utils/exitCodes.js';
+import { fetchCDPTargetById } from '../../utils/http.js';
 /**
  * Type guard to validate CDP Runtime.evaluate response structure
  *
  * @param value - Value to check
- * @returns True if value is a valid RuntimeEvaluateResult
+ * @returns True if value is a valid Protocol.Runtime.EvaluateResponse
  */
 function isRuntimeEvaluateResult(value) {
     if (typeof value !== 'object' || value === null) {
@@ -75,17 +75,18 @@ export function getValidatedSessionMetadata() {
 /**
  * Verify that the CDP target still exists
  *
+ * Uses the centralized fetchCDPTargetById utility which includes timeout
+ * safeguards and consistent error handling.
+ *
  * @param metadata - Session metadata containing targetId
  * @param port - CDP port number
- * @throws Error When CDP response is invalid or target not found
+ * @throws CommandError When target not found (tab may have been closed)
  */
 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());
+    if (!metadata.targetId) {
+        throw new CommandError('Session metadata missing targetId', { suggestion: 'Start a new session with: bdg <url>' }, EXIT_CODES.RESOURCE_NOT_FOUND);
     }
-    const target = targetsData.find((t) => t.id === metadata.targetId);
+    const target = await fetchCDPTargetById(metadata.targetId, port);
     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);
     }
@@ -118,4 +119,4 @@ export async function executeScript(cdp, script) {
     }
     return response;
 }
-//# sourceMappingURL=domEvalHelpers.js.map
+//# sourceMappingURL=evalHelpers.js.map

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

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

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

@@ -0,0 +1,47 @@
+/**
+ * Form interaction helpers for filling inputs, clicking buttons, etc.
+ */
+import type { CDPConnection } from '../../connection/cdp.js';
+import { type FillOptions, type FillResult, type ClickResult } from './reactEventHelpers.js';
+/**
+ * Fill a form element with a value in a React-compatible way.
+ *
+ * @param cdp - CDP connection
+ * @param selector - CSS selector for the element
+ * @param value - Value to fill
+ * @param options - Fill options
+ * @returns Promise resolving to fill result
+ *
+ * @throws CommandError When element operations fail
+ *
+ * @example
+ * ```typescript
+ * const result = await fillElement(cdp, 'input[name="email"]', 'test@example.com');
+ * if (result.success) {
+ *   console.log(`Filled ${result.elementType} with value: ${result.value}`);
+ * }
+ * ```
+ */
+export declare function fillElement(cdp: CDPConnection, selector: string, value: string, options?: FillOptions): Promise<FillResult>;
+/**
+ * Click an element.
+ *
+ * @param cdp - CDP connection
+ * @param selector - CSS selector for the element
+ * @param options - Click options
+ * @returns Promise resolving to click result
+ *
+ * @throws CommandError When element operations fail
+ *
+ * @example
+ * ```typescript
+ * const result = await clickElement(cdp, 'button[type="submit"]');
+ * if (result.success) {
+ *   console.log(`Clicked ${result.elementType}`);
+ * }
+ * ```
+ */
+export declare function clickElement(cdp: CDPConnection, selector: string, options?: {
+    index?: number;
+}): Promise<ClickResult>;
+//# sourceMappingURL=formFillHelpers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"formFillHelpers.d.ts","sourceRoot":"","sources":["../../../src/commands/dom/formFillHelpers.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAIzD,OAAO,EAIL,KAAK,WAAW,EAChB,KAAK,UAAU,EACf,KAAK,WAAW,EAEjB,MAAM,wBAAwB,CAAC;AAEhC;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,WAAW,CAC/B,GAAG,EAAE,aAAa,EAClB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,WAAgB,GACxB,OAAO,CAAC,UAAU,CAAC,CA+DrB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,YAAY,CAChC,GAAG,EAAE,aAAa,EAClB,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAO,GAC/B,OAAO,CAAC,WAAW,CAAC,CA8DtB"}

package/dist/commands/dom/formFillHelpers.js

@@ -0,0 +1,185 @@
+/**
+ * Form interaction helpers for filling inputs, clicking buttons, etc.
+ */
+import { CommandError } from '../../ui/errors/index.js';
+import { EXIT_CODES } from '../../utils/exitCodes.js';
+import { REACT_FILL_SCRIPT, CLICK_ELEMENT_SCRIPT, GET_ELEMENT_BY_INDEX_SCRIPT, } from './reactEventHelpers.js';
+/**
+ * Fill a form element with a value in a React-compatible way.
+ *
+ * @param cdp - CDP connection
+ * @param selector - CSS selector for the element
+ * @param value - Value to fill
+ * @param options - Fill options
+ * @returns Promise resolving to fill result
+ *
+ * @throws CommandError When element operations fail
+ *
+ * @example
+ * ```typescript
+ * const result = await fillElement(cdp, 'input[name="email"]', 'test@example.com');
+ * if (result.success) {
+ *   console.log(`Filled ${result.elementType} with value: ${result.value}`);
+ * }
+ * ```
+ */
+export async function fillElement(cdp, selector, value, options = {}) {
+    let targetSelector = selector;
+    // If index is specified, resolve it to a unique selector first
+    if (options.index !== undefined) {
+        const indexResult = await getElementByIndex(cdp, selector, options.index);
+        if (!indexResult.success) {
+            return indexResult;
+        }
+        if (!indexResult.uniqueSelector) {
+            throw new CommandError('Failed to resolve unique selector for element index', { note: 'Element index resolution returned no unique selector' }, EXIT_CODES.SOFTWARE_ERROR);
+        }
+        targetSelector = indexResult.uniqueSelector;
+    }
+    // Execute the fill script
+    const expression = `(${REACT_FILL_SCRIPT})('${escapeSelectorForJS(targetSelector)}', '${escapeValueForJS(value)}', ${JSON.stringify({ blur: options.blur ?? true })})`;
+    try {
+        const response = await cdp.send('Runtime.evaluate', {
+            expression,
+            returnByValue: true,
+            userGesture: true, // Treat as user-initiated action
+        });
+        // Type guard for CDP response
+        const cdpResponse = response;
+        if (cdpResponse.exceptionDetails) {
+            throw new CommandError('Script execution failed', { note: cdpResponse.exceptionDetails.text ?? 'Unknown error' }, EXIT_CODES.SOFTWARE_ERROR);
+        }
+        if (cdpResponse.result?.value) {
+            return cdpResponse.result.value;
+        }
+        throw new CommandError('Unexpected response format', { note: 'CDP response missing result.value' }, EXIT_CODES.SOFTWARE_ERROR);
+    }
+    catch (error) {
+        if (error instanceof CommandError) {
+            throw error;
+        }
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        throw new CommandError('Failed to fill element', { note: errorMessage }, EXIT_CODES.SOFTWARE_ERROR);
+    }
+}
+/**
+ * Click an element.
+ *
+ * @param cdp - CDP connection
+ * @param selector - CSS selector for the element
+ * @param options - Click options
+ * @returns Promise resolving to click result
+ *
+ * @throws CommandError When element operations fail
+ *
+ * @example
+ * ```typescript
+ * const result = await clickElement(cdp, 'button[type="submit"]');
+ * if (result.success) {
+ *   console.log(`Clicked ${result.elementType}`);
+ * }
+ * ```
+ */
+export async function clickElement(cdp, selector, options = {}) {
+    let targetSelector = selector;
+    // If index is specified, resolve it to a unique selector first
+    if (options.index !== undefined) {
+        const indexResult = await getElementByIndex(cdp, selector, options.index);
+        if (!indexResult.success) {
+            return indexResult;
+        }
+        if (!indexResult.uniqueSelector) {
+            throw new CommandError('Failed to resolve unique selector for element index', { note: 'Element index resolution returned no unique selector' }, EXIT_CODES.SOFTWARE_ERROR);
+        }
+        targetSelector = indexResult.uniqueSelector;
+    }
+    // Execute the click script
+    const expression = `(${CLICK_ELEMENT_SCRIPT})('${escapeSelectorForJS(targetSelector)}')`;
+    try {
+        const response = await cdp.send('Runtime.evaluate', {
+            expression,
+            returnByValue: true,
+            userGesture: true,
+        });
+        const cdpResponse = response;
+        if (cdpResponse.exceptionDetails) {
+            throw new CommandError('Script execution failed', { note: cdpResponse.exceptionDetails.text ?? 'Unknown error' }, EXIT_CODES.SOFTWARE_ERROR);
+        }
+        if (cdpResponse.result?.value) {
+            return cdpResponse.result.value;
+        }
+        throw new CommandError('Unexpected response format', { note: 'CDP response missing result.value' }, EXIT_CODES.SOFTWARE_ERROR);
+    }
+    catch (error) {
+        if (error instanceof CommandError) {
+            throw error;
+        }
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        throw new CommandError('Failed to click element', { note: errorMessage }, EXIT_CODES.SOFTWARE_ERROR);
+    }
+}
+/**
+ * Get element by index when selector matches multiple elements.
+ *
+ * @param cdp - CDP connection
+ * @param selector - CSS selector
+ * @param index - Element index (1-based)
+ * @returns Promise resolving to element info
+ *
+ * @throws CommandError When element operations fail
+ *
+ * @internal
+ */
+async function getElementByIndex(cdp, selector, index) {
+    const expression = `(${GET_ELEMENT_BY_INDEX_SCRIPT})('${escapeSelectorForJS(selector)}', ${index})`;
+    try {
+        const response = await cdp.send('Runtime.evaluate', {
+            expression,
+            returnByValue: true,
+        });
+        const cdpResponse = response;
+        if (cdpResponse.exceptionDetails) {
+            throw new CommandError('Script execution failed', { note: cdpResponse.exceptionDetails.text ?? 'Unknown error' }, EXIT_CODES.SOFTWARE_ERROR);
+        }
+        if (cdpResponse.result?.value) {
+            return cdpResponse.result.value;
+        }
+        throw new CommandError('Unexpected response format', { note: 'CDP response missing result.value' }, EXIT_CODES.SOFTWARE_ERROR);
+    }
+    catch (error) {
+        if (error instanceof CommandError) {
+            throw error;
+        }
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        throw new CommandError('Failed to get element by index', { note: errorMessage }, EXIT_CODES.SOFTWARE_ERROR);
+    }
+}
+/**
+ * Escape CSS selector for safe inclusion in JavaScript string.
+ * Uses JSON.stringify to handle all special characters safely.
+ *
+ * @param selector - CSS selector to escape
+ * @returns Escaped selector (without surrounding quotes)
+ *
+ * @internal
+ */
+function escapeSelectorForJS(selector) {
+    // JSON.stringify handles all escaping (backslashes, quotes, newlines, control chars)
+    // Remove surrounding quotes since we add them in the template
+    return JSON.stringify(selector).slice(1, -1);
+}
+/**
+ * Escape value for safe inclusion in JavaScript string.
+ * Uses JSON.stringify to handle all special characters safely.
+ *
+ * @param value - Value to escape
+ * @returns Escaped value (without surrounding quotes)
+ *
+ * @internal
+ */
+function escapeValueForJS(value) {
+    // JSON.stringify handles all escaping (backslashes, quotes, newlines, control chars)
+    // Remove surrounding quotes since we add them in the template
+    return JSON.stringify(value).slice(1, -1);
+}
+//# sourceMappingURL=formFillHelpers.js.map

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

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

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

@@ -0,0 +1,17 @@
+/**
+ * Form interaction commands for filling inputs, clicking buttons, and submitting forms.
+ */
+import type { Command } from 'commander';
+/**
+ * Register form interaction commands.
+ *
+ * @param program - Commander program instance
+ *
+ * @remarks
+ * Registers the following commands:
+ * - `bdg dom fill <selector> <value>` - Fill form fields
+ * - `bdg dom click <selector>` - Click elements
+ * - `bdg dom submit <selector>` - Submit forms with smart waiting
+ */
+export declare function registerFormInteractionCommands(program: Command): void;
+//# sourceMappingURL=formInteraction.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"formInteraction.d.ts","sourceRoot":"","sources":["../../../src/commands/dom/formInteraction.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAgEzC;;;;;;;;;;GAUG;AACH,wBAAgB,+BAA+B,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAmItE"}

package/dist/commands/dom/formInteraction.js

@@ -0,0 +1,239 @@
+/**
+ * Form interaction commands for filling inputs, clicking buttons, and submitting forms.
+ */
+import { fillElement, clickElement } from '../../commands/dom/formFillHelpers.js';
+import { submitForm } from '../../commands/dom/formSubmitHelpers.js';
+import { runCommand } from '../../commands/shared/CommandRunner.js';
+import { jsonOption } from '../../commands/shared/commonOptions.js';
+import { CommandError } from '../../ui/errors/index.js';
+import { OutputFormatter } from '../../ui/formatting.js';
+import { EXIT_CODES } from '../../utils/exitCodes.js';
+import { filterDefined } from '../../utils/objects.js';
+/**
+ * Execute a function with an active CDP connection.
+ *
+ * Handles the full connection lifecycle:
+ * 1. Validates active session
+ * 2. Gets session metadata
+ * 3. Verifies target exists
+ * 4. Creates and connects CDP
+ * 5. Executes callback
+ * 6. Closes CDP connection (even on error)
+ *
+ * @param fn - Callback to execute with CDP connection
+ * @returns Result from callback
+ * @throws Error if session validation or connection fails
+ *
+ * @internal
+ */
+async function withCDPConnection(fn) {
+    const { CDPConnection } = await import('../../connection/cdp.js');
+    const { validateActiveSession, getValidatedSessionMetadata, verifyTargetExists } = await import('../../commands/dom/evalHelpers.js');
+    // Validate session
+    validateActiveSession();
+    const metadata = getValidatedSessionMetadata();
+    const port = 9222; // Default port
+    await verifyTargetExists(metadata, port);
+    // Connect to CDP
+    const cdp = new CDPConnection();
+    if (!metadata.webSocketDebuggerUrl) {
+        throw new CommandError('Missing webSocketDebuggerUrl in session metadata', { note: 'Session metadata may be corrupted or from an older version' }, EXIT_CODES.SESSION_FILE_ERROR);
+    }
+    await cdp.connect(metadata.webSocketDebuggerUrl);
+    try {
+        return await fn(cdp, metadata);
+    }
+    finally {
+        cdp.close();
+    }
+}
+/**
+ * Register form interaction commands.
+ *
+ * @param program - Commander program instance
+ *
+ * @remarks
+ * Registers the following commands:
+ * - `bdg dom fill <selector> <value>` - Fill form fields
+ * - `bdg dom click <selector>` - Click elements
+ * - `bdg dom submit <selector>` - Submit forms with smart waiting
+ */
+export function registerFormInteractionCommands(program) {
+    const domCommand = program.commands.find((cmd) => cmd.name() === 'dom');
+    if (!domCommand) {
+        throw new CommandError('DOM command group not found', { note: 'This is an internal error - DOM commands may not be registered' }, EXIT_CODES.SOFTWARE_ERROR);
+    }
+    // bdg dom fill <selector> <value>
+    domCommand
+        .command('fill')
+        .description('Fill a form field with a value (React-compatible)')
+        .argument('<selector>', 'CSS selector for the element')
+        .argument('<value>', 'Value to fill')
+        .option('--index <n>', 'Element index if selector matches multiple (1-based)', parseInt)
+        .option('--no-blur', 'Do not blur after filling (keeps focus on element)')
+        .addOption(jsonOption)
+        .action(async (selector, value, options) => {
+        await runCommand(async () => {
+            return await withCDPConnection(async (cdp) => {
+                const fillOptions = filterDefined({
+                    index: options.index,
+                    blur: options.blur,
+                });
+                const result = await fillElement(cdp, selector, value, fillOptions);
+                if (!result.success) {
+                    return {
+                        success: false,
+                        error: result.error ?? 'Failed to fill element',
+                        exitCode: result.error?.includes('not found')
+                            ? EXIT_CODES.RESOURCE_NOT_FOUND
+                            : EXIT_CODES.INVALID_ARGUMENTS,
+                    };
+                }
+                return { success: true, data: result };
+            });
+        }, options, formatFillOutput);
+    });
+    // bdg dom click <selector>
+    domCommand
+        .command('click')
+        .description('Click an element')
+        .argument('<selector>', 'CSS selector for the element')
+        .option('--index <n>', 'Element index if selector matches multiple (1-based)', parseInt)
+        .addOption(jsonOption)
+        .action(async (selector, options) => {
+        await runCommand(async () => {
+            return await withCDPConnection(async (cdp) => {
+                const clickOptions = filterDefined({
+                    index: options.index,
+                });
+                const result = await clickElement(cdp, selector, clickOptions);
+                if (!result.success) {
+                    return {
+                        success: false,
+                        error: result.error ?? 'Failed to click element',
+                        exitCode: result.error?.includes('not found')
+                            ? EXIT_CODES.RESOURCE_NOT_FOUND
+                            : EXIT_CODES.INVALID_ARGUMENTS,
+                    };
+                }
+                return { success: true, data: result };
+            });
+        }, options, formatClickOutput);
+    });
+    // bdg dom submit <selector>
+    domCommand
+        .command('submit')
+        .description('Submit a form by clicking submit button and waiting for completion')
+        .argument('<selector>', 'CSS selector for the submit button')
+        .option('--index <n>', 'Element index if selector matches multiple (1-based)', parseInt)
+        .option('--wait-navigation', 'Wait for page navigation after submit')
+        .option('--wait-network <ms>', 'Wait for network idle after submit (milliseconds)', '1000')
+        .option('--timeout <ms>', 'Maximum time to wait (milliseconds)', '10000')
+        .addOption(jsonOption)
+        .action(async (selector, options) => {
+        await runCommand(async () => {
+            return await withCDPConnection(async (cdp) => {
+                const submitOptions = filterDefined({
+                    index: options.index,
+                    waitNavigation: options.waitNavigation,
+                    waitNetwork: parseInt(options.waitNetwork, 10),
+                    timeout: parseInt(options.timeout, 10),
+                });
+                const result = await submitForm(cdp, selector, submitOptions);
+                if (!result.success) {
+                    return {
+                        success: false,
+                        error: result.error ?? 'Failed to submit form',
+                        exitCode: result.error?.includes('not found')
+                            ? EXIT_CODES.RESOURCE_NOT_FOUND
+                            : result.error?.includes('Timeout')
+                                ? EXIT_CODES.CDP_TIMEOUT
+                                : EXIT_CODES.INVALID_ARGUMENTS,
+                    };
+                }
+                return { success: true, data: result };
+            });
+        }, options, formatSubmitOutput);
+    });
+}
+/**
+ * Format fill command output for human-readable display.
+ *
+ * @param result - Fill result
+ * @returns Formatted string
+ */
+function formatFillOutput(result) {
+    const fmt = new OutputFormatter();
+    fmt.text('✓ Element Filled');
+    fmt.blank();
+    const details = [
+        ['Selector', result.selector ?? 'unknown'],
+        ['Element Type', result.elementType ?? 'unknown'],
+    ];
+    if (result.inputType) {
+        details.push(['Input Type', result.inputType]);
+    }
+    if (result.checked !== undefined) {
+        details.push(['Checked', result.checked ? 'true' : 'false']);
+    }
+    else if (result.value) {
+        details.push(['Value', result.value]);
+    }
+    fmt.keyValueList(details, 15);
+    return fmt.build();
+}
+/**
+ * Format click command output for human-readable display.
+ *
+ * @param result - Click result
+ * @returns Formatted string
+ */
+function formatClickOutput(result) {
+    const fmt = new OutputFormatter();
+    fmt.text('✓ Element Clicked');
+    fmt.blank();
+    fmt.keyValueList([
+        ['Selector', result.selector ?? 'unknown'],
+        ['Element Type', result.elementType ?? 'unknown'],
+        ['Clickable', result.clickable ? 'yes' : 'no (warning)'],
+    ], 15);
+    if (!result.clickable) {
+        fmt.blank();
+        fmt.text('⚠ Warning: Element may not have a click handler');
+    }
+    return fmt.build();
+}
+/**
+ * Format submit command output for human-readable display.
+ *
+ * @param result - Submit result
+ * @returns Formatted string
+ */
+function formatSubmitOutput(result) {
+    const fmt = new OutputFormatter();
+    fmt.text('✓ Form Submitted');
+    fmt.blank();
+    const details = [
+        ['Selector', result.selector ?? 'unknown'],
+        ['Clicked', result.clicked ? 'yes' : 'no'],
+    ];
+    if (result.networkRequests !== undefined) {
+        details.push(['Network Requests', result.networkRequests.toString()]);
+    }
+    if (result.navigationOccurred !== undefined) {
+        details.push(['Navigation', result.navigationOccurred ? 'yes' : 'no']);
+    }
+    if (result.waitTimeMs !== undefined) {
+        details.push(['Wait Time', `${result.waitTimeMs}ms`]);
+    }
+    fmt.keyValueList(details, 20);
+    fmt.blank();
+    fmt.text('Next steps:');
+    fmt.section('', [
+        'bdg peek --network --last 10    Check network requests',
+        'bdg console --last 5             Check console messages',
+        'bdg status                       Check session state',
+    ]);
+    return fmt.build();
+}
+//# sourceMappingURL=formInteraction.js.map

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

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

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

@@ -0,0 +1,58 @@
+/**
+ * Form submission helpers with smart network waiting.
+ */
+import type { CDPConnection } from '../../connection/cdp.js';
+/**
+ * Options for submitting a form.
+ */
+export interface SubmitOptions {
+    /** Element index if selector matches multiple (1-based) */
+    index?: number;
+    /** Wait for page navigation after submit (default: false) */
+    waitNavigation?: boolean;
+    /** Wait for network idle after submit in milliseconds (default: 1000) */
+    waitNetwork?: number;
+    /** Maximum time to wait in milliseconds (default: 10000) */
+    timeout?: number;
+}
+/**
+ * Result of form submission.
+ */
+export interface SubmitResult {
+    success: boolean;
+    error?: string;
+    selector?: string;
+    clicked?: boolean;
+    networkRequests?: number;
+    navigationOccurred?: boolean;
+    waitTimeMs?: number;
+}
+/**
+ * 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 declare function submitForm(cdp: CDPConnection, selector: string, options?: SubmitOptions): Promise<SubmitResult>;
+//# sourceMappingURL=formSubmitHelpers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"formSubmitHelpers.d.ts","sourceRoot":"","sources":["../../../src/commands/dom/formSubmitHelpers.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAKzD;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,2DAA2D;IAC3D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,6DAA6D;IAC7D,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,yEAAyE;IACzE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,4DAA4D;IAC5D,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAsB,UAAU,CAC9B,GAAG,EAAE,aAAa,EAClB,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,aAAkB,GAC1B,OAAO,CAAC,YAAY,CAAC,CA6DvB"}