browser-debugger-cli 0.1.0 → 0.2.0

package/dist/commands/cdp.js

@@ -0,0 +1,45 @@
+import { runCommand } from '../commands/shared/CommandRunner.js';
+import { callCDP } from '../ipc/client.js';
+import { validateIPCResponse } from '../ipc/responseValidator.js';
+import { getErrorMessage } from '../utils/errors.js';
+import { EXIT_CODES } from '../utils/exitCodes.js';
+/**
+ * Register CDP command.
+ *
+ * @param program - Commander.js Command instance to register commands on
+ */
+export function registerCdpCommand(program) {
+    program
+        .command('cdp')
+        .description('Execute CDP method directly (low-level API access)')
+        .argument('<method>', 'CDP method name (e.g., Network.getCookies, Runtime.evaluate)')
+        .option('--params <json>', 'CDP method parameters as JSON')
+        .action(async (method, options) => {
+        await runCommand(async (opts) => {
+            // Parse parameters if provided
+            let params;
+            if (opts.params) {
+                try {
+                    params = JSON.parse(opts.params);
+                }
+                catch (error) {
+                    return {
+                        success: false,
+                        error: `Error parsing --params: ${getErrorMessage(error)}. Parameters must be valid JSON.`,
+                        exitCode: EXIT_CODES.INVALID_ARGUMENTS,
+                    };
+                }
+            }
+            // Send CDP call request to daemon
+            const response = await callCDP(method, params);
+            // Validate IPC response (throws on error)
+            validateIPCResponse(response);
+            return {
+                success: true,
+                data: response.data?.result,
+            };
+        }, { ...options, json: true } // Always output JSON for CDP commands
+        );
+    });
+}
+//# sourceMappingURL=cdp.js.map

package/dist/commands/cdp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cdp.js","sourceRoot":"","sources":["../../src/commands/cdp.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,UAAU,EAAE,MAAM,oCAAoC,CAAC;AAChE,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAC1C,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAUlD;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAAC,OAAgB;IACjD,OAAO;SACJ,OAAO,CAAC,KAAK,CAAC;SACd,WAAW,CAAC,oDAAoD,CAAC;SACjE,QAAQ,CAAC,UAAU,EAAE,8DAA8D,CAAC;SACpF,MAAM,CAAC,iBAAiB,EAAE,+BAA+B,CAAC;SAC1D,MAAM,CAAC,KAAK,EAAE,MAAc,EAAE,OAAmB,EAAE,EAAE;QACpD,MAAM,UAAU,CACd,KAAK,EAAE,IAAI,EAAE,EAAE;YACb,+BAA+B;YAC/B,IAAI,MAA2C,CAAC;YAChD,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;gBAChB,IAAI,CAAC;oBACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAA4B,CAAC;gBAC9D,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,OAAO;wBACL,OAAO,EAAE,KAAK;wBACd,KAAK,EAAE,2BAA2B,eAAe,CAAC,KAAK,CAAC,kCAAkC;wBAC1F,QAAQ,EAAE,UAAU,CAAC,iBAAiB;qBACvC,CAAC;gBACJ,CAAC;YACH,CAAC;YAED,kCAAkC;YAClC,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;YAE/C,0CAA0C;YAC1C,mBAAmB,CAAC,QAAQ,CAAC,CAAC;YAE9B,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,MAAM;aAC5B,CAAC;QACJ,CAAC,EACD,EAAE,GAAG,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,sCAAsC;SAClE,CAAC;IACJ,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/commands/cleanup.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"cleanup.d.ts","sourceRoot":"","sources":["../../src/commands/cleanup.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA0EzC;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAsG7D"}

package/dist/commands/cleanup.js

@@ -0,0 +1,129 @@
+import * as fs from 'fs';
+import { runCommand } from '../commands/shared/CommandRunner.js';
+import { jsonOption } from '../commands/shared/commonOptions.js';
+import { cleanupSession } from '../session/cleanup.js';
+import { getSessionFilePath } from '../session/paths.js';
+import { readPid } from '../session/pid.js';
+import { isProcessAlive } from '../session/process.js';
+import { sessionFilesCleanedMessage, sessionOutputRemovedMessage, sessionDirectoryCleanMessage, noSessionFilesMessage, staleSessionFoundMessage, forceCleanupWarningMessage, sessionStillActiveError, warningMessage, } from '../ui/messages/commands.js';
+import { getErrorMessage } from '../utils/errors.js';
+import { EXIT_CODES } from '../utils/exitCodes.js';
+/**
+ * Format cleanup result for human-readable output.
+ *
+ * @param data - Cleanup result data
+ */
+function formatCleanup(data) {
+    const { cleaned } = data;
+    if (cleaned.session) {
+        console.error(sessionFilesCleanedMessage());
+    }
+    if (cleaned.output) {
+        console.error(sessionOutputRemovedMessage());
+    }
+    if (data.warnings && data.warnings.length > 0) {
+        data.warnings.forEach((warning) => {
+            console.error(warningMessage(warning));
+        });
+    }
+    console.error('');
+    console.error(data.message);
+}
+/**
+ * Register cleanup command
+ *
+ * @param program - Commander.js Command instance to register commands on
+ */
+export function registerCleanupCommand(program) {
+    program
+        .command('cleanup')
+        .description('Clean up stale session files')
+        .option('-f, --force', 'Force cleanup even if session appears active')
+        .option('-a, --all', 'Also remove session.json output file')
+        .option('--aggressive', 'Kill all Chrome processes (uses chrome-launcher killAll)')
+        .addOption(jsonOption)
+        .action(async (options) => {
+        await runCommand(async (opts) => {
+            // Import cleanupStaleChrome dynamically
+            const { cleanupStaleChrome } = await import('../commands/shared/sessionController.js');
+            const pid = readPid();
+            let didCleanup = false;
+            let cleanedSession = false;
+            let cleanedOutput = false;
+            let cleanedChrome = false;
+            const warnings = [];
+            // Handle aggressive Chrome cleanup first if requested
+            if (opts.aggressive) {
+                const errorCount = await cleanupStaleChrome();
+                cleanedChrome = true;
+                if (errorCount > 0) {
+                    warnings.push('Some Chrome processes could not be killed');
+                }
+                didCleanup = true;
+            }
+            if (!pid) {
+                // No session files to clean up
+                // Fall through to check --all flag for session.json removal
+            }
+            else {
+                // PID file exists - handle session cleanup
+                const isAlive = isProcessAlive(pid);
+                if (isAlive && !opts.force) {
+                    return {
+                        success: false,
+                        error: sessionStillActiveError(pid),
+                        exitCode: EXIT_CODES.RESOURCE_BUSY,
+                        errorContext: {
+                            suggestions: ['Stop gracefully: bdg stop', 'Force cleanup: bdg cleanup --force'],
+                            warning: 'Force cleanup will remove session files but will NOT kill the running process',
+                        },
+                    };
+                }
+                if (isAlive && opts.force) {
+                    warnings.push(`Process ${pid} is still running but forcing cleanup anyway`);
+                    console.error(forceCleanupWarningMessage(pid));
+                }
+                else {
+                    console.error(staleSessionFoundMessage(pid));
+                }
+                cleanupSession();
+                cleanedSession = true;
+                didCleanup = true;
+            }
+            // Also remove session.json output file if --all flag is specified
+            if (opts.all) {
+                const outputPath = getSessionFilePath('OUTPUT');
+                if (fs.existsSync(outputPath)) {
+                    try {
+                        fs.unlinkSync(outputPath);
+                        cleanedOutput = true;
+                        didCleanup = true;
+                    }
+                    catch (error) {
+                        const errorMessage = getErrorMessage(error);
+                        warnings.push(`Could not remove session.json: ${errorMessage}`);
+                    }
+                }
+            }
+            // Check if any cleanup was performed
+            if (!didCleanup) {
+                return {
+                    success: true,
+                    data: {
+                        cleaned: { session: false, output: false, chrome: false },
+                        message: noSessionFilesMessage(),
+                    },
+                };
+            }
+            return {
+                success: true,
+                data: {
+                    cleaned: { session: cleanedSession, output: cleanedOutput, chrome: cleanedChrome },
+                    message: sessionDirectoryCleanMessage(),
+                    ...(warnings.length > 0 && { warnings }),
+                },
+            };
+        }, options, formatCleanup);
+    });
+}
+//# sourceMappingURL=cleanup.js.map

package/dist/commands/cleanup.js.map

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

package/dist/commands/console.d.ts

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

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

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

package/dist/commands/console.js

@@ -0,0 +1,92 @@
+import { runCommand } from '../commands/shared/CommandRunner.js';
+import { filterOption, jsonOption, lastOption } from '../commands/shared/commonOptions.js';
+import { getPeek } from '../ipc/client.js';
+import { validateIPCResponse } from '../ipc/responseValidator.js';
+import { noConsoleMessagesMessage, consoleMessagesHeader } from '../ui/messages/consoleMessages.js';
+import { EXIT_CODES } from '../utils/exitCodes.js';
+/**
+ * Format single console message for human-readable output.
+ *
+ * @param log - Console message to format
+ * @param index - Message index in the list
+ * @returns Formatted message string
+ */
+function formatConsoleMessage(log, index) {
+    const icons = {
+        log: 'ℹ',
+        error: '❌',
+        warning: '⚠️',
+        info: 'ℹ️',
+    };
+    const icon = icons[log.type] ?? 'ℹ';
+    const timestamp = new Date(log.timestamp).toISOString();
+    let output = `[${index}] ${icon} [${timestamp}] ${log.text}`;
+    if (log.args && log.args.length > 0) {
+        log.args.forEach((arg) => {
+            output += `\n    ${JSON.stringify(arg)}`;
+        });
+    }
+    return output;
+}
+/**
+ * Format console messages for human-readable output.
+ *
+ * @param data - Object containing logs array and optional filter
+ */
+function formatConsoleLogs(data) {
+    const { logs, filter } = data;
+    if (logs.length === 0) {
+        console.log(noConsoleMessagesMessage(filter));
+    }
+    else {
+        console.log(consoleMessagesHeader(logs.length, filter));
+        console.log();
+        logs.forEach((log, idx) => {
+            console.log(formatConsoleMessage(log, idx));
+        });
+    }
+}
+/**
+ * Register console command.
+ *
+ * @param program - Commander.js Command instance to register commands on
+ */
+export function registerConsoleCommand(program) {
+    program
+        .command('console')
+        .description('Query console logs from the active session')
+        .addOption(lastOption)
+        .addOption(filterOption(['log', 'error', 'warning', 'info']))
+        .addOption(jsonOption)
+        .action(async (options) => {
+        await runCommand(async (opts) => {
+            // Fetch preview data via IPC from daemon
+            const response = await getPeek();
+            // Validate IPC response (throws on error)
+            validateIPCResponse(response);
+            // Extract preview data from response
+            const output = response.data?.preview;
+            if (!output?.data.console) {
+                return {
+                    success: false,
+                    error: 'No console data available. Ensure console telemetry is active.',
+                    exitCode: EXIT_CODES.RESOURCE_NOT_FOUND,
+                };
+            }
+            let logs = [...output.data.console];
+            // Apply type filter if specified (Commander validates choices)
+            if (opts.filter) {
+                logs = logs.filter((log) => log.type === opts.filter);
+            }
+            // Apply last N filter if specified (Commander validates range)
+            if (opts.last > 0) {
+                logs = logs.slice(-opts.last);
+            }
+            return {
+                success: true,
+                data: { logs, ...(opts.filter && { filter: opts.filter }) },
+            };
+        }, options, formatConsoleLogs);
+    });
+}
+//# sourceMappingURL=console.js.map

package/dist/commands/console.js.map

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

package/dist/commands/details.d.ts

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

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

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

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') {
+        console.log(formatNetworkDetails(data.item));
+    }
+    else {
+        console.log(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,CAAC,GAAG,CAAC,oBAAoB,CAAC,IAAI,CAAC,IAAsB,CAAC,CAAC,CAAC;IACjE,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,IAAI,CAAC,IAAsB,CAAC,CAAC,CAAC;IACjE,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;AAqSzC;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAmD1D"}