browser-debugger-cli 0.0.1-alpha.0 → 0.1.0-alpha.1

package/dist/cli/commands/peek.js

@@ -0,0 +1,109 @@
+import { formatPreview, formatNoPreviewDataMessage, } from '../formatters/previewFormatter.js';
+import { OutputBuilder } from '../handlers/OutputBuilder.js';
+import { jsonOption } from '../handlers/commonOptions.js';
+import { getPeek } from '../../ipc/client.js';
+import { validateIPCResponse } from '../../ipc/responseValidator.js';
+import { EXIT_CODES } from '../../utils/exitCodes.js';
+/**
+ * Handle errors in a consistent way for both follow and one-time modes.
+ *
+ * @param error - Error message
+ * @param options - Preview options
+ * @param exitCode - Exit code to use if not in follow mode
+ */
+function handlePreviewError(error, options, exitCode) {
+    if (options.json) {
+        console.log(JSON.stringify(OutputBuilder.buildJsonError(error), null, 2));
+    }
+    else {
+        console.error(formatNoPreviewDataMessage());
+    }
+    if (!options.follow) {
+        process.exit(exitCode);
+    }
+}
+/**
+ * Register peek command.
+ *
+ * @param program - Commander.js Command instance to register commands on
+ */
+export function registerPeekCommand(program) {
+    program
+        .command('peek')
+        .description('Preview collected data without stopping the session')
+        .addOption(jsonOption)
+        .option('-v, --verbose', 'Use verbose output with full URLs and formatting')
+        .option('-n, --network', 'Show only network requests')
+        .option('-c, --console', 'Show only console messages')
+        .option('-f, --follow', 'Watch for updates (like tail -f)')
+        .option('--last <count>', 'Show last N items', '10')
+        .action(async (options) => {
+        // Validate --last parameter
+        const lastN = parseInt(options.last ?? '10', 10);
+        if (isNaN(lastN) || lastN < 1 || lastN > 1000) {
+            console.error('Error: --last must be between 1 and 1000');
+            console.error('Provided value:', options.last);
+            process.exit(EXIT_CODES.INVALID_ARGUMENTS);
+        }
+        options.last = lastN.toString();
+        const showPreview = async () => {
+            try {
+                // Fetch preview data via IPC from daemon
+                const response = await getPeek();
+                // Validate IPC response (will throw on error)
+                try {
+                    validateIPCResponse(response);
+                }
+                catch {
+                    handlePreviewError(response.error ?? 'Unknown error', options, EXIT_CODES.RESOURCE_NOT_FOUND);
+                    return;
+                }
+                // Extract preview data from response
+                const output = response.data?.preview;
+                if (!output) {
+                    handlePreviewError('No preview data in response', options, EXIT_CODES.RESOURCE_NOT_FOUND);
+                    return;
+                }
+                if (!options.follow) {
+                    console.clear();
+                }
+                console.log(formatPreview(output, options));
+            }
+            catch {
+                // Handle IPC connection errors (daemon not running, etc.)
+                // Note: validateIPCResponse errors are caught above
+                if (options.json) {
+                    console.log(JSON.stringify(OutputBuilder.buildJsonError('Daemon not running', {
+                        suggestion: 'Start it with: bdg <url>',
+                    }), null, 2));
+                }
+                else {
+                    console.error('Error: Daemon not running');
+                    console.error('Start it with: bdg <url>');
+                }
+                if (!options.follow) {
+                    process.exit(EXIT_CODES.RESOURCE_NOT_FOUND);
+                }
+            }
+        };
+        if (options.follow) {
+            // Follow mode: update every second
+            console.error('Following live preview (Ctrl+C to stop)...\n');
+            await showPreview();
+            const followInterval = setInterval(() => {
+                void showPreview();
+            }, 1000);
+            // Handle Ctrl+C gracefully
+            process.on('SIGINT', () => {
+                clearInterval(followInterval);
+                console.error('\nStopped following preview');
+                process.exit(EXIT_CODES.SUCCESS);
+            });
+        }
+        else {
+            // One-time preview
+            await showPreview();
+        }
+    });
+}
+//# sourceMappingURL=peek.js.map

package/dist/cli/commands/peek.js.map

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

package/dist/cli/commands/query.d.ts

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

package/dist/cli/commands/query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/query.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAoBzC;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAkJ3D"}

package/dist/cli/commands/query.js

@@ -0,0 +1,127 @@
+import { OutputBuilder } from '../handlers/OutputBuilder.js';
+import { DEFAULT_DEBUG_PORT, PORT_OPTION_DESCRIPTION } from '../../constants.js';
+import { readPid } from '../../session/pid.js';
+import { isProcessAlive } from '../../session/process.js';
+import { getErrorMessage } from '../../utils/errors.js';
+import { EXIT_CODES } from '../../utils/exitCodes.js';
+/**
+ * Register query command
+ *
+ * @param program - Commander.js Command instance to register commands on
+ * @returns void
+ */
+export function registerQueryCommand(program) {
+    program
+        .command('query')
+        .description('Execute JavaScript in the active session for live debugging')
+        .argument('<script>', 'JavaScript to execute (e.g., "document.querySelector(\'input[type=email]\').value")')
+        .option('-p, --port <number>', PORT_OPTION_DESCRIPTION, DEFAULT_DEBUG_PORT)
+        .option('-j, --json', 'Wrap result in version/success format')
+        .action(async (script, options) => {
+        try {
+            const port = parseInt(options.port, 10);
+            // Check if session is running
+            const pid = readPid();
+            if (!pid || !isProcessAlive(pid)) {
+                const errorMsg = 'No active session running';
+                if (options.json) {
+                    console.log(JSON.stringify(OutputBuilder.buildJsonError(errorMsg, {
+                        suggestion: 'Start a session with: bdg <url>',
+                    }), null, 2));
+                }
+                else {
+                    console.error(`Error: ${errorMsg}`);
+                    console.error('Start a session with: bdg <url>');
+                }
+                process.exit(EXIT_CODES.RESOURCE_NOT_FOUND);
+            }
+            // Read session metadata to get the target ID
+            const { readSessionMetadata } = await import('../../session/metadata.js');
+            const metadata = readSessionMetadata();
+            if (!metadata?.targetId || !metadata.webSocketDebuggerUrl) {
+                const errorMsg = 'No target information in session metadata';
+                if (options.json) {
+                    console.log(JSON.stringify(OutputBuilder.buildJsonError(errorMsg, {
+                        note: 'Session may have been started with an older version',
+                    }), null, 2));
+                }
+                else {
+                    console.error(`Error: ${errorMsg}`);
+                    console.error('Session may have been started with an older version');
+                }
+                process.exit(EXIT_CODES.SESSION_FILE_ERROR);
+            }
+            // Verify the target still exists
+            const response = await fetch(`http://127.0.0.1:${port}/json/list`);
+            const targetsData = await response.json();
+            if (!Array.isArray(targetsData)) {
+                const errorMsg = 'Invalid response from CDP';
+                if (options.json) {
+                    console.log(JSON.stringify(OutputBuilder.buildJsonError(errorMsg), null, 2));
+                }
+                else {
+                    console.error(`Error: ${errorMsg}`);
+                }
+                process.exit(EXIT_CODES.CDP_CONNECTION_FAILURE);
+            }
+            const target = targetsData.find((t) => t.id === metadata.targetId);
+            if (!target) {
+                const errorMsg = 'Session target not found (tab may have been closed)';
+                if (options.json) {
+                    console.log(JSON.stringify(OutputBuilder.buildJsonError(errorMsg, {
+                        suggestion: 'Start a new session with: bdg <url>',
+                    }), null, 2));
+                }
+                else {
+                    console.error(`Error: ${errorMsg}`);
+                    console.error('Start a new session with: bdg <url>');
+                }
+                process.exit(EXIT_CODES.RESOURCE_NOT_FOUND);
+            }
+            // Create temporary CDP connection using stored webSocketDebuggerUrl
+            const { CDPConnection } = await import('../../connection/cdp.js');
+            const cdp = new CDPConnection();
+            await cdp.connect(metadata.webSocketDebuggerUrl);
+            // Execute JavaScript
+            const result = (await cdp.send('Runtime.evaluate', {
+                expression: script,
+                returnByValue: true,
+                awaitPromise: true,
+            }));
+            cdp.close();
+            // Output result
+            if (result.exceptionDetails) {
+                const errorMsg = result.exceptionDetails.exception?.description ?? 'Unknown error executing script';
+                if (options.json) {
+                    console.log(JSON.stringify(OutputBuilder.buildJsonError(errorMsg), null, 2));
+                }
+                else {
+                    console.error('Error executing script:');
+                    console.error(errorMsg);
+                }
+                process.exit(EXIT_CODES.UNHANDLED_EXCEPTION);
+            }
+            // Output result (wrapped if --json, raw otherwise)
+            if (options.json) {
+                console.log(JSON.stringify(OutputBuilder.buildJsonSuccess({
+                    result: result.result?.value,
+                }), null, 2));
+            }
+            else {
+                console.log(JSON.stringify(result.result?.value, null, 2));
+            }
+            process.exit(EXIT_CODES.SUCCESS);
+        }
+        catch (error) {
+            const errorMsg = getErrorMessage(error);
+            if (options.json) {
+                console.log(JSON.stringify(OutputBuilder.buildJsonError(errorMsg), null, 2));
+            }
+            else {
+                console.error(`Error: ${errorMsg}`);
+            }
+            process.exit(EXIT_CODES.UNHANDLED_EXCEPTION);
+        }
+    });
+}
+//# sourceMappingURL=query.js.map

package/dist/cli/commands/query.js.map

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

package/dist/cli/commands/start.d.ts

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

package/dist/cli/commands/start.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"start.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/start.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA6GzC;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAO5D"}

package/dist/cli/commands/start.js

@@ -0,0 +1,78 @@
+import { startSessionViaDaemon } from '../handlers/daemonSessionController.js';
+import { DEFAULT_DEBUG_PORT, PORT_OPTION_DESCRIPTION, TIMEOUT_OPTION_DESCRIPTION, USER_DATA_DIR_OPTION_DESCRIPTION, } from '../../constants.js';
+/**
+ * Apply shared collector options to a command
+ *
+ * @param command - Commander.js Command instance to apply options to
+ * @returns The modified Command instance with all collector options applied
+ */
+function applyCollectorOptions(command) {
+    return command
+        .option('-p, --port <number>', PORT_OPTION_DESCRIPTION, DEFAULT_DEBUG_PORT)
+        .option('-t, --timeout <seconds>', TIMEOUT_OPTION_DESCRIPTION)
+        .option('-u, --user-data-dir <path>', USER_DATA_DIR_OPTION_DESCRIPTION)
+        .option('-a, --all', 'Include all data (disable filtering of tracking/analytics)')
+        .option('-m, --max-body-size <megabytes>', 'Maximum response body size in MB (default: 5MB)', '5')
+        .option('--compact', 'Use compact JSON format (no indentation) for output files');
+}
+/**
+ * Parse a string to integer, returning undefined if not provided
+ * @param value - Optional string value to parse
+ * @param fieldName - Name of the field being parsed (for error messages)
+ * @returns Parsed integer or undefined if value was not provided
+ * @throws Error if value is provided but not a valid integer
+ */
+function parseOptionalInt(value, fieldName) {
+    if (value === undefined) {
+        return undefined;
+    }
+    const parsed = parseInt(value, 10);
+    if (isNaN(parsed)) {
+        throw new Error(`Invalid ${fieldName}: "${value}" is not a valid integer`);
+    }
+    return parsed;
+}
+/**
+ * Transform CLI options into session options
+ *
+ * @param options - Parsed command-line options from Commander
+ * @returns Session options object with parsed and normalized values
+ */
+function buildSessionOptions(options) {
+    const maxBodySizeMB = parseOptionalInt(options.maxBodySize, 'max-body-size');
+    return {
+        port: parseInt(options.port, 10),
+        timeout: parseOptionalInt(options.timeout, 'timeout'),
+        userDataDir: options.userDataDir,
+        includeAll: options.all ?? false,
+        maxBodySize: maxBodySizeMB !== undefined ? maxBodySizeMB * 1024 * 1024 : undefined,
+        compact: options.compact ?? false,
+    };
+}
+/**
+ * Common action handler for collector commands
+ *
+ * @param url - Target URL to collect telemetry from
+ * @param options - Parsed command-line options from Commander
+ * @returns Promise that resolves when session completes or is stopped
+ */
+async function collectorAction(url, options) {
+    const sessionOptions = buildSessionOptions(options);
+    // Always collect all 3 types (dom, network, console)
+    const collectors = ['dom', 'network', 'console'];
+    // Dispatch to daemon via IPC instead of running in-process
+    await startSessionViaDaemon(url, sessionOptions, collectors);
+}
+/**
+ * Register the start command
+ *
+ * @param program - Commander.js Command instance to register command on
+ * @returns void
+ */
+export function registerStartCommands(program) {
+    // Default command: always collects all 3 types (dom, network, console)
+    applyCollectorOptions(program.argument('<url>', 'Target URL (example.com or localhost:3000)')).action(async (url, options) => {
+        await collectorAction(url, options);
+    });
+}
+//# sourceMappingURL=start.js.map

package/dist/cli/commands/start.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"start.js","sourceRoot":"","sources":["../../../src/cli/commands/start.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,qBAAqB,EAAE,MAAM,2CAA2C,CAAC;AAClF,OAAO,EACL,kBAAkB,EAClB,uBAAuB,EACvB,0BAA0B,EAC1B,gCAAgC,GACjC,MAAM,aAAa,CAAC;AAqBrB;;;;;GAKG;AACH,SAAS,qBAAqB,CAAC,OAAgB;IAC7C,OAAO,OAAO;SACX,MAAM,CAAC,qBAAqB,EAAE,uBAAuB,EAAE,kBAAkB,CAAC;SAC1E,MAAM,CAAC,yBAAyB,EAAE,0BAA0B,CAAC;SAC7D,MAAM,CAAC,4BAA4B,EAAE,gCAAgC,CAAC;SACtE,MAAM,CAAC,WAAW,EAAE,4DAA4D,CAAC;SACjF,MAAM,CACL,iCAAiC,EACjC,iDAAiD,EACjD,GAAG,CACJ;SACA,MAAM,CAAC,WAAW,EAAE,2DAA2D,CAAC,CAAC;AACtF,CAAC;AAED;;;;;;GAMG;AACH,SAAS,gBAAgB,CAAC,KAAyB,EAAE,SAAiB;IACpE,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IACnC,IAAI,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;QAClB,MAAM,IAAI,KAAK,CAAC,WAAW,SAAS,MAAM,KAAK,0BAA0B,CAAC,CAAC;IAC7E,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;GAKG;AACH,SAAS,mBAAmB,CAAC,OAAyB;IAQpD,MAAM,aAAa,GAAG,gBAAgB,CAAC,OAAO,CAAC,WAAW,EAAE,eAAe,CAAC,CAAC;IAC7E,OAAO;QACL,IAAI,EAAE,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC;QAChC,OAAO,EAAE,gBAAgB,CAAC,OAAO,CAAC,OAAO,EAAE,SAAS,CAAC;QACrD,WAAW,EAAE,OAAO,CAAC,WAAW;QAChC,UAAU,EAAE,OAAO,CAAC,GAAG,IAAI,KAAK;QAChC,WAAW,EAAE,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,aAAa,GAAG,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,SAAS;QAClF,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,KAAK;KAClC,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,KAAK,UAAU,eAAe,CAAC,GAAW,EAAE,OAAyB;IACnE,MAAM,cAAc,GAAG,mBAAmB,CAAC,OAAO,CAAC,CAAC;IAEpD,qDAAqD;IACrD,MAAM,UAAU,GAAoB,CAAC,KAAK,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;IAElE,2DAA2D;IAC3D,MAAM,qBAAqB,CAAC,GAAG,EAAE,cAAc,EAAE,UAAU,CAAC,CAAC;AAC/D,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB,CAAC,OAAgB;IACpD,uEAAuE;IACvE,qBAAqB,CACnB,OAAO,CAAC,QAAQ,CAAC,OAAO,EAAE,4CAA4C,CAAC,CACxE,CAAC,MAAM,CAAC,KAAK,EAAE,GAAW,EAAE,OAAyB,EAAE,EAAE;QACxD,MAAM,eAAe,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IACtC,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/cli/commands/status.d.ts

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

package/dist/cli/commands/status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/status.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAwBzC;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAyE5D"}

package/dist/cli/commands/status.js

@@ -0,0 +1,84 @@
+import { formatSessionStatus, formatStatusAsJson, formatNoSessionMessage, } from '../formatters/statusFormatter.js';
+import { getStatus } from '../../ipc/client.js';
+import { cleanupStaleDaemonPid } from '../../session/cleanup.js';
+import { getErrorMessage } from '../../utils/errors.js';
+import { EXIT_CODES } from '../../utils/exitCodes.js';
+import { VERSION } from '../../utils/version.js';
+/**
+ * Register status command
+ *
+ * @param program - Commander.js Command instance to register commands on
+ * @returns void
+ */
+export function registerStatusCommand(program) {
+    program
+        .command('status')
+        .description('Show active session status and collection statistics')
+        .option('-j, --json', 'Output as JSON')
+        .option('-v, --verbose', 'Show detailed Chrome diagnostics')
+        .action(async (options) => {
+        try {
+            // Request status from daemon via IPC
+            const response = await getStatus();
+            // Handle IPC error response
+            if (response.status === 'error') {
+                console.error(`Daemon error: ${response.error ?? 'Unknown error'}`);
+                process.exit(EXIT_CODES.UNHANDLED_EXCEPTION);
+            }
+            // Extract data from response
+            const { data } = response;
+            if (!data) {
+                console.error('Invalid response from daemon: missing data');
+                process.exit(EXIT_CODES.UNHANDLED_EXCEPTION);
+            }
+            // Check if there's an active session
+            if (!data.sessionPid || !data.sessionMetadata) {
+                if (options.json) {
+                    console.log(JSON.stringify({ version: VERSION, active: false }, null, 2));
+                }
+                else {
+                    console.error(formatNoSessionMessage());
+                }
+                process.exit(EXIT_CODES.SUCCESS);
+            }
+            // Convert IPC metadata to SessionMetadata format
+            const metadata = {
+                bdgPid: data.sessionMetadata.bdgPid,
+                chromePid: data.sessionMetadata.chromePid,
+                startTime: data.sessionMetadata.startTime,
+                port: data.sessionMetadata.port,
+                targetId: data.sessionMetadata.targetId,
+                webSocketDebuggerUrl: data.sessionMetadata.webSocketDebuggerUrl,
+                activeCollectors: data.sessionMetadata.activeCollectors,
+            };
+            if (options.json) {
+                // JSON output
+                const jsonOutput = formatStatusAsJson(metadata, data.sessionPid);
+                console.log(JSON.stringify(jsonOutput, null, 2));
+            }
+            else {
+                // Human-readable output
+                console.log(formatSessionStatus(metadata, data.sessionPid, options.verbose ?? false));
+            }
+            process.exit(EXIT_CODES.SUCCESS);
+        }
+        catch (error) {
+            // Handle connection errors (daemon not running)
+            const errorMessage = getErrorMessage(error);
+            if (errorMessage.includes('ENOENT') || errorMessage.includes('ECONNREFUSED')) {
+                // P0 Fix #2: Auto-cleanup stale daemon PID if it exists
+                const cleaned = cleanupStaleDaemonPid();
+                if (cleaned) {
+                    console.error('Daemon not running (stale PID cleaned up). Start it with: bdg <url>');
+                }
+                else {
+                    console.error('Daemon not running. Start it with: bdg <url>');
+                }
+                process.exit(EXIT_CODES.RESOURCE_NOT_FOUND);
+            }
+            console.error(`Error checking status: ${errorMessage}`);
+            process.exit(EXIT_CODES.UNHANDLED_EXCEPTION);
+        }
+    });
+}
+//# sourceMappingURL=status.js.map

package/dist/cli/commands/status.js.map

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

package/dist/cli/commands/stop.d.ts

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

package/dist/cli/commands/stop.d.ts.map

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

package/dist/cli/commands/stop.js

@@ -0,0 +1,146 @@
+import { runCommand } from '../handlers/CommandRunner.js';
+import { jsonOption } from '../handlers/commonOptions.js';
+import { stopSession } from '../../ipc/client.js';
+import { IPCErrorCode } from '../../ipc/types.js';
+import { clearChromePid } from '../../session/chrome.js';
+import { killChromeProcess } from '../../session/process.js';
+import { getErrorMessage } from '../../utils/errors.js';
+import { EXIT_CODES } from '../../utils/exitCodes.js';
+/**
+ * Format stop result for human-readable output.
+ *
+ * @param data - Stop result data
+ */
+function formatStop(data) {
+    if (data.stopped.bdg) {
+        console.error('Session stopped successfully');
+    }
+    if (data.stopped.chrome) {
+        console.error('Killed Chrome');
+    }
+    if (data.warnings && data.warnings.length > 0) {
+        data.warnings.forEach((warning) => {
+            console.error(`Warning: ${warning}`);
+        });
+    }
+}
+/**
+ * Map daemon error codes to appropriate exit codes.
+ *
+ * @param errorCode - IPC error code from daemon response
+ * @returns Semantic exit code
+ */
+function getExitCodeForDaemonError(errorCode) {
+    switch (errorCode) {
+        case IPCErrorCode.NO_SESSION:
+            return EXIT_CODES.RESOURCE_NOT_FOUND;
+        case IPCErrorCode.SESSION_KILL_FAILED:
+            return EXIT_CODES.UNHANDLED_EXCEPTION;
+        case IPCErrorCode.DAEMON_ERROR:
+            return EXIT_CODES.UNHANDLED_EXCEPTION;
+        case IPCErrorCode.SESSION_ALREADY_RUNNING:
+            return EXIT_CODES.UNHANDLED_EXCEPTION;
+        case IPCErrorCode.WORKER_START_FAILED:
+            return EXIT_CODES.UNHANDLED_EXCEPTION;
+        case IPCErrorCode.CHROME_LAUNCH_FAILED:
+            return EXIT_CODES.UNHANDLED_EXCEPTION;
+        case IPCErrorCode.CDP_TIMEOUT:
+            return EXIT_CODES.UNHANDLED_EXCEPTION;
+        case undefined:
+            return EXIT_CODES.UNHANDLED_EXCEPTION;
+    }
+}
+/**
+ * Register stop command
+ *
+ * @param program - Commander.js Command instance to register commands on
+ */
+export function registerStopCommand(program) {
+    program
+        .command('stop')
+        .description('Stop all active sessions and free ports (does not capture output)')
+        .option('--kill-chrome', 'Also kill Chrome browser')
+        .addOption(jsonOption)
+        .action(async (options) => {
+        await runCommand(async (opts) => {
+            try {
+                // Try to stop session via IPC (daemon)
+                const response = await stopSession();
+                if (response.status === 'ok') {
+                    // Session stopped successfully via daemon
+                    let chromeStopped = false;
+                    const warnings = [];
+                    // Handle Chrome if requested (daemon captured Chrome PID before cleanup)
+                    if (opts.killChrome) {
+                        const chromePid = response.chromePid;
+                        if (chromePid) {
+                            try {
+                                killChromeProcess(chromePid, 'SIGTERM');
+                                chromeStopped = true;
+                                console.error(`Killed Chrome (PID ${chromePid})`);
+                                clearChromePid();
+                            }
+                            catch (chromeError) {
+                                const errorMessage = chromeError instanceof Error ? chromeError.message : String(chromeError);
+                                warnings.push(`Could not kill Chrome: ${errorMessage}`);
+                            }
+                        }
+                        else {
+                            warnings.push('Chrome PID not found (Chrome was not launched by bdg)');
+                        }
+                    }
+                    return {
+                        success: true,
+                        data: {
+                            stopped: { bdg: true, chrome: chromeStopped },
+                            message: response.message ?? 'Session stopped successfully',
+                            ...(warnings.length > 0 && { warnings }),
+                        },
+                    };
+                }
+                else {
+                    // Daemon returned error
+                    // Special case: NO_SESSION is not really an error - it's a success (desired state achieved)
+                    if (response.errorCode === IPCErrorCode.NO_SESSION) {
+                        return {
+                            success: true,
+                            data: {
+                                stopped: { bdg: false, chrome: false },
+                                message: response.message ?? 'No active session found',
+                            },
+                        };
+                    }
+                    // Other errors are actual failures
+                    const exitCode = getExitCodeForDaemonError(response.errorCode);
+                    return {
+                        success: false,
+                        error: response.message ?? 'Failed to stop session',
+                        exitCode,
+                    };
+                }
+            }
+            catch (error) {
+                // IPC transport failure (ENOENT, ECONNREFUSED, timeout, etc.)
+                const errorMessage = getErrorMessage(error);
+                // Check if it's a connection error (daemon not running)
+                if (errorMessage.includes('ENOENT') || errorMessage.includes('ECONNREFUSED')) {
+                    return {
+                        success: false,
+                        error: 'Daemon not running',
+                        exitCode: EXIT_CODES.RESOURCE_NOT_FOUND,
+                        errorContext: {
+                            suggestion: 'Start a session first with: bdg <url>',
+                        },
+                    };
+                }
+                // Other errors (timeout, parse failures, etc.)
+                return {
+                    success: false,
+                    error: `Stop session failed: ${errorMessage}`,
+                    exitCode: EXIT_CODES.UNHANDLED_EXCEPTION,
+                };
+            }
+        }, options, formatStop);
+    });
+}
+//# sourceMappingURL=stop.js.map

package/dist/cli/commands/stop.js.map

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