browser-debugger-cli 0.6.0 → 0.6.1

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":"AAAA;;GAEG;AAIH,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC;AAC9E,OAAO,EAAE,UAAU,EAAE,MAAM,qCAAqC,CAAC;AAGjE,OAAO,EAAE,UAAU,EAAE,MAAM,oCAAoC,CAAC;AAChE,OAAO,EAAE,UAAU,EAAE,MAAM,oCAAoC,CAAC;AAGhE,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD;;;;;;;;;;;;;;;;GAgBG;AACH,KAAK,UAAU,iBAAiB,CAC9B,EAAiE;IAEjE,MAAM,EAAE,aAAa,EAAE,GAAG,MAAM,MAAM,CAAC,qBAAqB,CAAC,CAAC;IAC9D,MAAM,EAAE,qBAAqB,EAAE,2BAA2B,EAAE,kBAAkB,EAAE,GAAG,MAAM,MAAM,CAC7F,+BAA+B,CAChC,CAAC;IAEF,mBAAmB;IACnB,qBAAqB,EAAE,CAAC;IACxB,MAAM,QAAQ,GAAG,2BAA2B,EAAE,CAAC;IAC/C,MAAM,IAAI,GAAG,IAAI,CAAC,CAAC,eAAe;IAClC,MAAM,kBAAkB,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IAEzC,iBAAiB;IACjB,MAAM,GAAG,GAAG,IAAI,aAAa,EAAE,CAAC;IAChC,IAAI,CAAC,QAAQ,CAAC,oBAAoB,EAAE,CAAC;QACnC,MAAM,IAAI,YAAY,CACpB,kDAAkD,EAClD,EAAE,IAAI,EAAE,4DAA4D,EAAE,EACtE,UAAU,CAAC,kBAAkB,CAC9B,CAAC;IACJ,CAAC;IACD,MAAM,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAC,CAAC;IAEjD,IAAI,CAAC;QACH,OAAO,MAAM,EAAE,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IACjC,CAAC;YAAS,CAAC;QACT,GAAG,CAAC,KAAK,EAAE,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,+BAA+B,CAAC,OAAgB;IAC9D,MAAM,UAAU,GAAG,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,KAAK,CAAC,CAAC;IAExE,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,MAAM,IAAI,YAAY,CACpB,6BAA6B,EAC7B,EAAE,IAAI,EAAE,gEAAgE,EAAE,EAC1E,UAAU,CAAC,cAAc,CAC1B,CAAC;IACJ,CAAC;IAED,kCAAkC;IAClC,UAAU;SACP,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CAAC,mDAAmD,CAAC;SAChE,QAAQ,CAAC,YAAY,EAAE,8BAA8B,CAAC;SACtD,QAAQ,CAAC,SAAS,EAAE,eAAe,CAAC;SACpC,MAAM,CAAC,aAAa,EAAE,sDAAsD,EAAE,QAAQ,CAAC;SACvF,MAAM,CAAC,WAAW,EAAE,oDAAoD,CAAC;SACzE,SAAS,CAAC,UAAU,CAAC;SACrB,MAAM,CAAC,KAAK,EAAE,QAAgB,EAAE,KAAa,EAAE,OAA2B,EAAE,EAAE;QAC7E,MAAM,UAAU,CACd,KAAK,IAAI,EAAE;YACT,OAAO,MAAM,iBAAiB,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;gBAC3C,MAAM,WAAW,GAAG,aAAa,CAAC;oBAChC,KAAK,EAAE,OAAO,CAAC,KAAK;oBACpB,IAAI,EAAE,OAAO,CAAC,IAAI;iBACnB,CAAuC,CAAC;gBAEzC,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,WAAW,CAAC,CAAC;gBAEpE,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;oBACpB,OAAO;wBACL,OAAO,EAAE,KAAK;wBACd,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,wBAAwB;wBAC/C,QAAQ,EAAE,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,WAAW,CAAC;4BAC3C,CAAC,CAAC,UAAU,CAAC,kBAAkB;4BAC/B,CAAC,CAAC,UAAU,CAAC,iBAAiB;qBACjC,CAAC;gBACJ,CAAC;gBAED,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;YACzC,CAAC,CAAC,CAAC;QACL,CAAC,EACD,OAAO,EACP,gBAAgB,CACjB,CAAC;IACJ,CAAC,CAAC,CAAC;IAEL,2BAA2B;IAC3B,UAAU;SACP,OAAO,CAAC,OAAO,CAAC;SAChB,WAAW,CAAC,kBAAkB,CAAC;SAC/B,QAAQ,CAAC,YAAY,EAAE,8BAA8B,CAAC;SACtD,MAAM,CAAC,aAAa,EAAE,sDAAsD,EAAE,QAAQ,CAAC;SACvF,SAAS,CAAC,UAAU,CAAC;SACrB,MAAM,CAAC,KAAK,EAAE,QAAgB,EAAE,OAA4B,EAAE,EAAE;QAC/D,MAAM,UAAU,CACd,KAAK,IAAI,EAAE;YACT,OAAO,MAAM,iBAAiB,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;gBAC3C,MAAM,YAAY,GAAG,aAAa,CAAC;oBACjC,KAAK,EAAE,OAAO,CAAC,KAAK;iBACrB,CAAuB,CAAC;gBAEzB,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,GAAG,EAAE,QAAQ,EAAE,YAAY,CAAC,CAAC;gBAE/D,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;oBACpB,OAAO;wBACL,OAAO,EAAE,KAAK;wBACd,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,yBAAyB;wBAChD,QAAQ,EAAE,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,WAAW,CAAC;4BAC3C,CAAC,CAAC,UAAU,CAAC,kBAAkB;4BAC/B,CAAC,CAAC,UAAU,CAAC,iBAAiB;qBACjC,CAAC;gBACJ,CAAC;gBAED,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;YACzC,CAAC,CAAC,CAAC;QACL,CAAC,EACD,OAAO,EACP,iBAAiB,CAClB,CAAC;IACJ,CAAC,CAAC,CAAC;IAEL,4BAA4B;IAC5B,UAAU;SACP,OAAO,CAAC,QAAQ,CAAC;SACjB,WAAW,CAAC,oEAAoE,CAAC;SACjF,QAAQ,CAAC,YAAY,EAAE,oCAAoC,CAAC;SAC5D,MAAM,CAAC,aAAa,EAAE,sDAAsD,EAAE,QAAQ,CAAC;SACvF,MAAM,CAAC,mBAAmB,EAAE,uCAAuC,CAAC;SACpE,MAAM,CAAC,qBAAqB,EAAE,mDAAmD,EAAE,MAAM,CAAC;SAC1F,MAAM,CAAC,gBAAgB,EAAE,qCAAqC,EAAE,OAAO,CAAC;SACxE,SAAS,CAAC,UAAU,CAAC;SACrB,MAAM,CAAC,KAAK,EAAE,QAAgB,EAAE,OAA6B,EAAE,EAAE;QAChE,MAAM,UAAU,CACd,KAAK,IAAI,EAAE;YACT,OAAO,MAAM,iBAAiB,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;gBAC3C,MAAM,aAAa,GAAG,aAAa,CAAC;oBAClC,KAAK,EAAE,OAAO,CAAC,KAAK;oBACpB,cAAc,EAAE,OAAO,CAAC,cAAc;oBACtC,WAAW,EAAE,QAAQ,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC;oBAC9C,OAAO,EAAE,QAAQ,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC;iBACvC,CAKA,CAAC;gBAEF,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,GAAG,EAAE,QAAQ,EAAE,aAAa,CAAC,CAAC;gBAE9D,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;oBACpB,OAAO;wBACL,OAAO,EAAE,KAAK;wBACd,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,uBAAuB;wBAC9C,QAAQ,EAAE,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,WAAW,CAAC;4BAC3C,CAAC,CAAC,UAAU,CAAC,kBAAkB;4BAC/B,CAAC,CAAC,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,SAAS,CAAC;gCACjC,CAAC,CAAC,UAAU,CAAC,WAAW;gCACxB,CAAC,CAAC,UAAU,CAAC,iBAAiB;qBACnC,CAAC;gBACJ,CAAC;gBAED,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;YACzC,CAAC,CAAC,CAAC;QACL,CAAC,EACD,OAAO,EACP,kBAAkB,CACnB,CAAC;IACJ,CAAC,CAAC,CAAC;AACP,CAAC;AA8BD;;;;;GAKG;AACH,SAAS,gBAAgB,CAAC,MAAkB;IAC1C,MAAM,GAAG,GAAG,IAAI,eAAe,EAAE,CAAC;IAElC,GAAG,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;IAC7B,GAAG,CAAC,KAAK,EAAE,CAAC;IAEZ,MAAM,OAAO,GAAuB;QAClC,CAAC,UAAU,EAAE,MAAM,CAAC,QAAQ,IAAI,SAAS,CAAC;QAC1C,CAAC,cAAc,EAAE,MAAM,CAAC,WAAW,IAAI,SAAS,CAAC;KAClD,CAAC;IAEF,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC;QACrB,OAAO,CAAC,IAAI,CAAC,CAAC,YAAY,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC;IACjD,CAAC;IAED,IAAI,MAAM,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;QACjC,OAAO,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;IAC/D,CAAC;SAAM,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;QACxB,OAAO,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IACxC,CAAC;IAED,GAAG,CAAC,YAAY,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IAE9B,OAAO,GAAG,CAAC,KAAK,EAAE,CAAC;AACrB,CAAC;AAED;;;;;GAKG;AACH,SAAS,iBAAiB,CAAC,MAAmB;IAC5C,MAAM,GAAG,GAAG,IAAI,eAAe,EAAE,CAAC;IAElC,GAAG,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;IAC9B,GAAG,CAAC,KAAK,EAAE,CAAC;IAEZ,GAAG,CAAC,YAAY,CACd;QACE,CAAC,UAAU,EAAE,MAAM,CAAC,QAAQ,IAAI,SAAS,CAAC;QAC1C,CAAC,cAAc,EAAE,MAAM,CAAC,WAAW,IAAI,SAAS,CAAC;QACjD,CAAC,WAAW,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,cAAc,CAAC;KACzD,EACD,EAAE,CACH,CAAC;IAEF,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;QACtB,GAAG,CAAC,KAAK,EAAE,CAAC;QACZ,GAAG,CAAC,IAAI,CAAC,iDAAiD,CAAC,CAAC;IAC9D,CAAC;IAED,OAAO,GAAG,CAAC,KAAK,EAAE,CAAC;AACrB,CAAC;AAED;;;;;GAKG;AACH,SAAS,kBAAkB,CAAC,MAAoB;IAC9C,MAAM,GAAG,GAAG,IAAI,eAAe,EAAE,CAAC;IAElC,GAAG,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;IAC7B,GAAG,CAAC,KAAK,EAAE,CAAC;IAEZ,MAAM,OAAO,GAAuB;QAClC,CAAC,UAAU,EAAE,MAAM,CAAC,QAAQ,IAAI,SAAS,CAAC;QAC1C,CAAC,SAAS,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;KAC3C,CAAC;IAEF,IAAI,MAAM,CAAC,eAAe,KAAK,SAAS,EAAE,CAAC;QACzC,OAAO,CAAC,IAAI,CAAC,CAAC,kBAAkB,EAAE,MAAM,CAAC,eAAe,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;IACxE,CAAC;IAED,IAAI,MAAM,CAAC,kBAAkB,KAAK,SAAS,EAAE,CAAC;QAC5C,OAAO,CAAC,IAAI,CAAC,CAAC,YAAY,EAAE,MAAM,CAAC,kBAAkB,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IACzE,CAAC;IAED,IAAI,MAAM,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;QACpC,OAAO,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,GAAG,MAAM,CAAC,UAAU,IAAI,CAAC,CAAC,CAAC;IACxD,CAAC;IAED,GAAG,CAAC,YAAY,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IAE9B,GAAG,CAAC,KAAK,EAAE,CAAC;IACZ,GAAG,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IACxB,GAAG,CAAC,OAAO,CAAC,EAAE,EAAE;QACd,wDAAwD;QACxD,yDAAyD;QACzD,sDAAsD;KACvD,CAAC,CAAC;IAEH,OAAO,GAAG,CAAC,KAAK,EAAE,CAAC;AACrB,CAAC"}

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"}

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"}