browser-debugger-cli 0.1.0 → 0.2.0

package/dist/commands/domSelectorParser.js

@@ -0,0 +1,20 @@
+/**
+ * Parse argument as either CSS selector or index
+ *
+ * @param arg - Argument to parse (e.g., ".error" or "1")
+ * @returns Parsed result indicating type and value
+ *
+ * @example
+ * parseSelectorOrIndex(".error") // \{ type: 'selector', value: '.error' \}
+ * parseSelectorOrIndex("1")      // \{ type: 'index', value: 1 \}
+ * parseSelectorOrIndex("42")     // \{ type: 'index', value: 42 \}
+ */
+export function parseSelectorOrIndex(arg) {
+    // If arg is a positive integer, treat as index
+    if (/^\d+$/.test(arg)) {
+        return { type: 'index', value: parseInt(arg, 10) };
+    }
+    // Otherwise treat as CSS selector
+    return { type: 'selector', value: arg };
+}
+//# sourceMappingURL=domSelectorParser.js.map

package/dist/commands/domSelectorParser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"domSelectorParser.js","sourceRoot":"","sources":["../../src/commands/domSelectorParser.ts"],"names":[],"mappings":"AAQA;;;;;;;;;;GAUG;AACH,MAAM,UAAU,oBAAoB,CAAC,GAAW;IAC9C,+CAA+C;IAC/C,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QACtB,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE,CAAC;IACrD,CAAC;IAED,kCAAkC;IAClC,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC;AAC1C,CAAC"}

package/dist/commands/network.d.ts

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

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

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

package/dist/commands/network.js

@@ -0,0 +1,43 @@
+import { runCommand } from '../commands/shared/CommandRunner.js';
+import { jsonOption } from '../commands/shared/commonOptions.js';
+import { callCDP } from '../ipc/client.js';
+import { validateIPCResponse } from '../ipc/responseValidator.js';
+import { formatCookies } from '../ui/formatters/index.js';
+/**
+ * Register network commands.
+ *
+ * @param program - Commander.js Command instance to register commands on
+ */
+export function registerNetworkCommands(program) {
+    const networkCmd = program.command('network').description('Inspect network state and resources');
+    // bdg network getCookies
+    networkCmd
+        .command('getCookies')
+        .description('List cookies from the current page')
+        .option('--url <url>', 'Filter cookies by URL')
+        .addOption(jsonOption)
+        .action(async (options) => {
+        await runCommand(async (opts) => {
+            // Build CDP method parameters
+            const params = {};
+            if (opts.url) {
+                params['urls'] = [opts.url];
+            }
+            // Call CDP Network.getCookies
+            const response = await callCDP('Network.getCookies', params);
+            // Validate IPC response (throws on error)
+            validateIPCResponse(response);
+            // Extract cookies from CDP response
+            const cookies = response.data?.result?.cookies ?? [];
+            return {
+                success: true,
+                data: cookies,
+            };
+        }, options, 
+        // Human-readable formatter (returns formatted string)
+        (cookies) => {
+            console.log(formatCookies(cookies));
+        });
+    });
+}
+//# sourceMappingURL=network.js.map

package/dist/commands/network.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"network.js","sourceRoot":"","sources":["../../src/commands/network.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,UAAU,EAAE,MAAM,oCAAoC,CAAC;AAChE,OAAO,EAAE,UAAU,EAAE,MAAM,oCAAoC,CAAC;AAChE,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAC1C,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAEjE,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAUzD;;;;GAIG;AACH,MAAM,UAAU,uBAAuB,CAAC,OAAgB;IACtD,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,WAAW,CAAC,qCAAqC,CAAC,CAAC;IAEjG,yBAAyB;IACzB,UAAU;SACP,OAAO,CAAC,YAAY,CAAC;SACrB,WAAW,CAAC,oCAAoC,CAAC;SACjD,MAAM,CAAC,aAAa,EAAE,uBAAuB,CAAC;SAC9C,SAAS,CAAC,UAAU,CAAC;SACrB,MAAM,CAAC,KAAK,EAAE,OAA0B,EAAE,EAAE;QAC3C,MAAM,UAAU,CACd,KAAK,EAAE,IAAI,EAAE,EAAE;YACb,8BAA8B;YAC9B,MAAM,MAAM,GAA4B,EAAE,CAAC;YAC3C,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC;gBACb,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAC9B,CAAC;YAED,8BAA8B;YAC9B,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,oBAAoB,EAAE,MAAM,CAAC,CAAC;YAE7D,0CAA0C;YAC1C,mBAAmB,CAAC,QAAQ,CAAC,CAAC;YAE9B,oCAAoC;YACpC,MAAM,OAAO,GAAI,QAAQ,CAAC,IAAI,EAAE,MAAiC,EAAE,OAAO,IAAI,EAAE,CAAC;YAEjF,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,IAAI,EAAE,OAAO;aACd,CAAC;QACJ,CAAC,EACD,OAAO;QACP,sDAAsD;QACtD,CAAC,OAAiB,EAAE,EAAE;YACpB,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC;QACtC,CAAC,CACF,CAAC;IACJ,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/commands/peek.d.ts

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

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

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

package/dist/commands/peek.js

@@ -0,0 +1,114 @@
+import { OutputBuilder } from '../commands/shared/OutputBuilder.js';
+import { jsonOption } from '../commands/shared/commonOptions.js';
+import { getPeek } from '../ipc/client.js';
+import { validateIPCResponse } from '../ipc/responseValidator.js';
+import { formatPreview } from '../ui/formatters/preview.js';
+import { invalidLastArgumentError } from '../ui/messages/commands.js';
+import { daemonNotRunningError, noPreviewDataError } from '../ui/messages/errors.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(noPreviewDataError());
+    }
+    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(invalidLastArgumentError(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;
+                }
+                // Clear screen before rendering to prevent stacked outputs in follow mode
+                if (options.follow) {
+                    console.clear();
+                }
+                // Add current view timestamp for follow mode to show refresh time
+                const previewOptions = options.follow
+                    ? { ...options, viewedAt: new Date() }
+                    : options;
+                console.log(formatPreview(output, previewOptions));
+            }
+            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(daemonNotRunningError());
+                }
+                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/commands/peek.js.map

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

package/dist/commands/shared/CommandRunner.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Standard options supported by CommandRunner.
+ * All commands that use CommandRunner must extend this interface.
+ */
+export interface BaseCommandOptions {
+    /** Output as JSON instead of human-readable format */
+    json?: boolean;
+}
+/**
+ * Result from a command handler.
+ * Handler functions should return this structure to indicate success/failure.
+ */
+export interface CommandResult<T = unknown> {
+    /** Whether the command succeeded */
+    success: boolean;
+    /** Data to output (for successful commands) */
+    data?: T;
+    /** Error message (for failed commands) */
+    error?: string;
+    /** Optional exit code override (defaults: SUCCESS=0, error codes from EXIT_CODES) */
+    exitCode?: number;
+}
+/**
+ * Handler function type.
+ * Command logic should be implemented as a function matching this signature.
+ */
+export type CommandHandler<TOptions extends BaseCommandOptions, TResult = unknown> = (options: TOptions) => Promise<CommandResult<TResult>>;
+/**
+ * Formatter function type for human-readable output.
+ * Receives the command result data and outputs to console.
+ */
+export type CommandFormatter<TResult = unknown> = (data: TResult) => void;
+/**
+ * Run a command with consistent error handling, output formatting, and exit codes.
+ * Eliminates boilerplate try-catch and JSON output logic from command handlers.
+ *
+ * This helper:
+ * - Wraps command logic in try-catch
+ * - Handles IPC connection errors (ENOENT, ECONNREFUSED)
+ * - Formats output as JSON or human-readable based on --json flag
+ * - Calls process.exit() with appropriate exit code
+ *
+ * @param handler - Command logic that returns CommandResult or throws
+ * @param options - Command options (must include json flag)
+ * @param formatter - Optional human-readable formatter (if not provided, outputs raw JSON)
+ *
+ * @example
+ * ```typescript
+ * await runCommand(
+ *   async (opts) => {
+ *     const data = await fetchData(opts.url);
+ *     return { success: true, data };
+ *   },
+ *   options,
+ *   formatData
+ * );
+ * ```
+ */
+export declare function runCommand<TOptions extends BaseCommandOptions, TResult = unknown>(handler: CommandHandler<TOptions, TResult>, options: TOptions, formatter?: CommandFormatter<TResult>): Promise<void>;
+//# sourceMappingURL=CommandRunner.d.ts.map

package/dist/commands/shared/CommandRunner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CommandRunner.d.ts","sourceRoot":"","sources":["../../../src/commands/shared/CommandRunner.ts"],"names":[],"mappings":"AAKA;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,sDAAsD;IACtD,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED;;;GAGG;AACH,MAAM,WAAW,aAAa,CAAC,CAAC,GAAG,OAAO;IACxC,oCAAoC;IACpC,OAAO,EAAE,OAAO,CAAC;IACjB,+CAA+C;IAC/C,IAAI,CAAC,EAAE,CAAC,CAAC;IACT,0CAA0C;IAC1C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qFAAqF;IACrF,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,MAAM,MAAM,cAAc,CAAC,QAAQ,SAAS,kBAAkB,EAAE,OAAO,GAAG,OAAO,IAAI,CACnF,OAAO,EAAE,QAAQ,KACd,OAAO,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC;AAErC;;;GAGG;AACH,MAAM,MAAM,gBAAgB,CAAC,OAAO,GAAG,OAAO,IAAI,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;AAE1E;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAsB,UAAU,CAAC,QAAQ,SAAS,kBAAkB,EAAE,OAAO,GAAG,OAAO,EACrF,OAAO,EAAE,cAAc,CAAC,QAAQ,EAAE,OAAO,CAAC,EAC1C,OAAO,EAAE,QAAQ,EACjB,SAAS,CAAC,EAAE,gBAAgB,CAAC,OAAO,CAAC,GACpC,OAAO,CAAC,IAAI,CAAC,CAwDf"}

package/dist/commands/shared/CommandRunner.js

@@ -0,0 +1,81 @@
+import { OutputBuilder } from '../../commands/shared/OutputBuilder.js';
+import { daemonNotRunningError, unknownError, genericError } from '../../ui/messages/errors.js';
+import { getErrorMessage } from '../../utils/errors.js';
+import { EXIT_CODES } from '../../utils/exitCodes.js';
+/**
+ * Run a command with consistent error handling, output formatting, and exit codes.
+ * Eliminates boilerplate try-catch and JSON output logic from command handlers.
+ *
+ * This helper:
+ * - Wraps command logic in try-catch
+ * - Handles IPC connection errors (ENOENT, ECONNREFUSED)
+ * - Formats output as JSON or human-readable based on --json flag
+ * - Calls process.exit() with appropriate exit code
+ *
+ * @param handler - Command logic that returns CommandResult or throws
+ * @param options - Command options (must include json flag)
+ * @param formatter - Optional human-readable formatter (if not provided, outputs raw JSON)
+ *
+ * @example
+ * ```typescript
+ * await runCommand(
+ *   async (opts) => {
+ *     const data = await fetchData(opts.url);
+ *     return { success: true, data };
+ *   },
+ *   options,
+ *   formatData
+ * );
+ * ```
+ */
+export async function runCommand(handler, options, formatter) {
+    try {
+        const result = await handler(options);
+        if (!result.success) {
+            // Error result from handler
+            if (options.json) {
+                console.log(JSON.stringify(OutputBuilder.buildJsonError(result.error ?? 'Unknown error'), null, 2));
+            }
+            else {
+                console.error(result.error ? genericError(result.error) : unknownError());
+            }
+            process.exit(result.exitCode ?? EXIT_CODES.UNHANDLED_EXCEPTION);
+        }
+        // Success - output data
+        if (options.json) {
+            console.log(JSON.stringify(result.data, null, 2));
+        }
+        else if (formatter) {
+            formatter(result.data);
+        }
+        else {
+            // Fallback: JSON output if no formatter provided
+            console.log(JSON.stringify(result.data, null, 2));
+        }
+        process.exit(EXIT_CODES.SUCCESS);
+    }
+    catch (error) {
+        const errorMessage = getErrorMessage(error);
+        // Detect daemon connection errors
+        if (errorMessage.includes('ENOENT') || errorMessage.includes('ECONNREFUSED')) {
+            if (options.json) {
+                console.log(JSON.stringify(OutputBuilder.buildJsonError('Daemon not running', {
+                    suggestion: 'Start it with: bdg <url>',
+                }), null, 2));
+            }
+            else {
+                console.error(daemonNotRunningError());
+            }
+            process.exit(EXIT_CODES.RESOURCE_NOT_FOUND);
+        }
+        // Generic error
+        if (options.json) {
+            console.log(JSON.stringify(OutputBuilder.buildJsonError(errorMessage), null, 2));
+        }
+        else {
+            console.error(genericError(errorMessage));
+        }
+        process.exit(EXIT_CODES.UNHANDLED_EXCEPTION);
+    }
+}
+//# sourceMappingURL=CommandRunner.js.map

package/dist/commands/shared/CommandRunner.js.map

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

package/dist/commands/shared/OutputBuilder.d.ts

@@ -0,0 +1,60 @@
+import type { BdgOutput, CDPTarget, NetworkRequest, ConsoleMessage, DOMData, TelemetryType } from '../../types';
+/**
+ * Output mode determines what data is included and how partial flag is set
+ */
+export type OutputMode = 'preview' | 'full' | 'final';
+/**
+ * Options for building output payloads
+ */
+export interface OutputBuilderOptions {
+    mode: OutputMode;
+    target: CDPTarget;
+    startTime: number;
+    networkRequests: NetworkRequest[];
+    consoleLogs: ConsoleMessage[];
+    domData?: DOMData;
+    activeTelemetry: TelemetryType[];
+}
+/**
+ * Helper: build output payloads for different modes with consistent metadata.
+ * Modes: preview (metadata only), full (with bodies), final (complete with DOM).
+ */
+export declare class OutputBuilder {
+    /**
+     * Build session output with consistent metadata.
+     *
+     * @param options - Configuration for output construction
+     * @returns BdgOutput payload
+     */
+    static build(options: OutputBuilderOptions): BdgOutput;
+    /**
+     * Build error output with consistent structure.
+     *
+     * @param error - Error object or string
+     * @param startTime - Session start timestamp
+     * @param target - Optional target information
+     * @returns BdgOutput payload with error
+     */
+    static buildError(error: unknown, startTime: number, target?: CDPTarget): BdgOutput;
+    /**
+     * Build a simple JSON error response for commands.
+     * Used by commands that don't follow the full BdgOutput structure (stop, cleanup, query).
+     *
+     * @param error - Error message or Error object
+     * @param options - Optional fields (exitCode, additional data)
+     * @returns JSON-serializable error object
+     */
+    static buildJsonError(error: string | Error, options?: {
+        exitCode?: number;
+        [key: string]: unknown;
+    }): Record<string, unknown>;
+    /**
+     * Build a simple JSON success response for commands.
+     * Used by commands that don't follow the full BdgOutput structure (stop, cleanup, query).
+     *
+     * @param data - Response data
+     * @returns JSON-serializable success object
+     */
+    static buildJsonSuccess(data: Record<string, unknown>): Record<string, unknown>;
+}
+//# sourceMappingURL=OutputBuilder.d.ts.map

package/dist/commands/shared/OutputBuilder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OutputBuilder.d.ts","sourceRoot":"","sources":["../../../src/commands/shared/OutputBuilder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,SAAS,EACT,SAAS,EACT,cAAc,EACd,cAAc,EACd,OAAO,EACP,aAAa,EACd,MAAM,SAAS,CAAC;AAIjB;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,MAAM,GAAG,OAAO,CAAC;AAEtD;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,UAAU,CAAC;IACjB,MAAM,EAAE,SAAS,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,cAAc,EAAE,CAAC;IAClC,WAAW,EAAE,cAAc,EAAE,CAAC;IAC9B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,eAAe,EAAE,aAAa,EAAE,CAAC;CAClC;AAED;;;GAGG;AACH,qBAAa,aAAa;IACxB;;;;;OAKG;IACH,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,oBAAoB,GAAG,SAAS;IA4FtD;;;;;;;OAOG;IACH,MAAM,CAAC,UAAU,CAAC,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,SAAS,GAAG,SAAS;IAYnF;;;;;;;OAOG;IACH,MAAM,CAAC,cAAc,CACnB,KAAK,EAAE,MAAM,GAAG,KAAK,EACrB,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,GACtD,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAS1B;;;;;;OAMG;IACH,MAAM,CAAC,gBAAgB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAOhF"}

package/dist/commands/shared/OutputBuilder.js

@@ -0,0 +1,138 @@
+import { getErrorMessage } from '../../utils/errors.js';
+import { VERSION } from '../../utils/version.js';
+/**
+ * Helper: build output payloads for different modes with consistent metadata.
+ * Modes: preview (metadata only), full (with bodies), final (complete with DOM).
+ */
+export class OutputBuilder {
+    /**
+     * Build session output with consistent metadata.
+     *
+     * @param options - Configuration for output construction
+     * @returns BdgOutput payload
+     */
+    static build(options) {
+        const { mode, target, startTime, networkRequests, consoleLogs, domData, activeTelemetry } = options;
+        const baseOutput = {
+            version: VERSION,
+            success: true,
+            timestamp: new Date().toISOString(),
+            duration: Date.now() - startTime,
+            target: {
+                url: target.url,
+                title: target.title,
+            },
+            // Only final outputs are complete (partial=false)
+            partial: mode !== 'final',
+        };
+        if (mode === 'preview') {
+            // Lightweight preview: metadata only, last 1000 items
+            const previewData = {};
+            if (activeTelemetry.includes('network')) {
+                previewData['network'] = networkRequests.slice(-1000).map((req) => ({
+                    requestId: req.requestId,
+                    url: req.url,
+                    method: req.method,
+                    timestamp: req.timestamp,
+                    status: req.status,
+                    mimeType: req.mimeType,
+                    // Exclude requestBody, responseBody, headers for lightweight preview
+                }));
+            }
+            if (activeTelemetry.includes('console')) {
+                previewData['console'] = consoleLogs.slice(-1000).map((msg) => ({
+                    type: msg.type,
+                    text: msg.text,
+                    timestamp: msg.timestamp,
+                    // Exclude args for lightweight preview
+                }));
+            }
+            // DOM omitted in preview (only captured on stop)
+            return {
+                ...baseOutput,
+                data: previewData,
+            };
+        }
+        if (mode === 'full') {
+            // Full mode: complete data with bodies
+            const fullData = {};
+            if (activeTelemetry.includes('network')) {
+                fullData['network'] = networkRequests; // All data with bodies
+            }
+            if (activeTelemetry.includes('console')) {
+                fullData['console'] = consoleLogs; // All data with args
+            }
+            // DOM omitted (only captured on stop)
+            return {
+                ...baseOutput,
+                data: fullData,
+            };
+        }
+        // Final mode - includes DOM, partial=false
+        const finalData = {};
+        if (activeTelemetry.includes('network')) {
+            finalData['network'] = networkRequests;
+        }
+        if (activeTelemetry.includes('console')) {
+            finalData['console'] = consoleLogs;
+        }
+        if (activeTelemetry.includes('dom') && domData) {
+            finalData['dom'] = domData;
+        }
+        return {
+            ...baseOutput,
+            partial: false,
+            data: finalData,
+        };
+    }
+    /**
+     * Build error output with consistent structure.
+     *
+     * @param error - Error object or string
+     * @param startTime - Session start timestamp
+     * @param target - Optional target information
+     * @returns BdgOutput payload with error
+     */
+    static buildError(error, startTime, target) {
+        return {
+            version: VERSION,
+            success: false,
+            timestamp: new Date().toISOString(),
+            duration: Date.now() - startTime,
+            target: target ? { url: target.url, title: target.title } : { url: '', title: '' },
+            data: {},
+            error: getErrorMessage(error),
+        };
+    }
+    /**
+     * Build a simple JSON error response for commands.
+     * Used by commands that don't follow the full BdgOutput structure (stop, cleanup, query).
+     *
+     * @param error - Error message or Error object
+     * @param options - Optional fields (exitCode, additional data)
+     * @returns JSON-serializable error object
+     */
+    static buildJsonError(error, options) {
+        return {
+            version: VERSION,
+            success: false,
+            error: error instanceof Error ? error.message : error,
+            ...options,
+        };
+    }
+    /**
+     * Build a simple JSON success response for commands.
+     * Used by commands that don't follow the full BdgOutput structure (stop, cleanup, query).
+     *
+     * @param data - Response data
+     * @returns JSON-serializable success object
+     */
+    static buildJsonSuccess(data) {
+        return {
+            version: VERSION,
+            success: true,
+            ...data,
+        };
+    }
+}
+//# sourceMappingURL=OutputBuilder.js.map

package/dist/commands/shared/OutputBuilder.js.map

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

package/dist/commands/shared/commonOptions.d.ts

@@ -0,0 +1,54 @@
+import { Option } from 'commander';
+/**
+ * Shared --json flag for all commands that support JSON output.
+ * Standard option for machine-readable output.
+ *
+ * @example
+ * ```typescript
+ * program
+ *   .command('status')
+ *   .addOption(jsonOption)
+ *   .action((options) => {
+ *     if (options.json) {
+ *       console.log(JSON.stringify(data));
+ *     }
+ *   });
+ * ```
+ */
+export declare const jsonOption: Option;
+/**
+ * Shared --last <n> option for pagination.
+ * Includes built-in validation for sensible limits.
+ *
+ * @example
+ * ```typescript
+ * program
+ *   .command('console')
+ *   .addOption(lastOption)
+ *   .action((options) => {
+ *     const logs = allLogs.slice(-options.last);
+ *   });
+ * ```
+ */
+export declare const lastOption: Option;
+/**
+ * Create a --filter option with specified valid choices.
+ * Includes built-in validation using Commander's .choices() method.
+ *
+ * @param validTypes - Array of valid filter values
+ * @returns Commander Option instance
+ *
+ * @example
+ * ```typescript
+ * program
+ *   .command('console')
+ *   .addOption(filterOption(['log', 'error', 'warning', 'info']))
+ *   .action((options) => {
+ *     if (options.filter) {
+ *       filtered = logs.filter(log => log.type === options.filter);
+ *     }
+ *   });
+ * ```
+ */
+export declare function filterOption(validTypes: string[]): Option;
+//# sourceMappingURL=commonOptions.d.ts.map

package/dist/commands/shared/commonOptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commonOptions.d.ts","sourceRoot":"","sources":["../../../src/commands/shared/commonOptions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAEnC;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,UAAU,QAA6C,CAAC;AAErE;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,UAAU,QAQnB,CAAC;AAEL;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,MAAM,CAIzD"}