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

package/dist/cli/handlers/SessionLoop.js

@@ -0,0 +1,47 @@
+/**
+ * Manages the session monitoring loop
+ */
+export class SessionLoop {
+    /**
+     * Run session loop until stopped or error
+     *
+     * Monitors WebSocket connection and target lifecycle.
+     * Throws error if connection lost or tab closed.
+     *
+     * @param session - Active BDG session instance
+     * @param target - CDP target being monitored
+     * @throws Error if WebSocket connection lost or browser tab closed
+     */
+    static async run(session, target) {
+        if (!session) {
+            throw new Error('Session not initialized');
+        }
+        const cdp = session.getCDP();
+        const waitForNextCheck = () => new Promise((resolve) => {
+            let timer;
+            let handlerId;
+            const handleTargetDestroyed = (params) => {
+                if (params.targetId === target.id) {
+                    clearTimeout(timer);
+                    cdp.off('Target.targetDestroyed', handlerId);
+                    resolve('destroyed');
+                }
+            };
+            handlerId = cdp.on('Target.targetDestroyed', handleTargetDestroyed);
+            timer = setTimeout(() => {
+                cdp.off('Target.targetDestroyed', handlerId);
+                resolve('continue');
+            }, 2000);
+        });
+        for (;;) {
+            const result = await waitForNextCheck();
+            if (!session.isConnected()) {
+                throw new Error('WebSocket connection lost');
+            }
+            if (result === 'destroyed') {
+                throw new Error('Browser tab was closed');
+            }
+        }
+    }
+}
+//# sourceMappingURL=SessionLoop.js.map

package/dist/cli/handlers/SessionLoop.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SessionLoop.js","sourceRoot":"","sources":["../../../src/cli/handlers/SessionLoop.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,MAAM,OAAO,WAAW;IACtB;;;;;;;;;OASG;IACH,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,OAAmB,EAAE,MAAiB;QACrD,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;QAC7C,CAAC;QAED,MAAM,GAAG,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;QAE7B,MAAM,gBAAgB,GAAG,GAAsC,EAAE,CAC/D,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;YACtB,IAAI,KAAoC,CAAC;YACzC,IAAI,SAAiB,CAAC;YAEtB,MAAM,qBAAqB,GAAG,CAAC,MAAgC,EAAQ,EAAE;gBACvE,IAAI,MAAM,CAAC,QAAQ,KAAK,MAAM,CAAC,EAAE,EAAE,CAAC;oBAClC,YAAY,CAAC,KAAK,CAAC,CAAC;oBACpB,GAAG,CAAC,GAAG,CAAC,wBAAwB,EAAE,SAAS,CAAC,CAAC;oBAC7C,OAAO,CAAC,WAAW,CAAC,CAAC;gBACvB,CAAC;YACH,CAAC,CAAC;YAEF,SAAS,GAAG,GAAG,CAAC,EAAE,CAChB,wBAAwB,EACxB,qBAAqB,CACtB,CAAC;YAEF,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;gBACtB,GAAG,CAAC,GAAG,CAAC,wBAAwB,EAAE,SAAS,CAAC,CAAC;gBAC7C,OAAO,CAAC,UAAU,CAAC,CAAC;YACtB,CAAC,EAAE,IAAI,CAAC,CAAC;QACX,CAAC,CAAC,CAAC;QAEL,SAAS,CAAC;YACR,MAAM,MAAM,GAAG,MAAM,gBAAgB,EAAE,CAAC;YAExC,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC;gBAC3B,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC;YAC/C,CAAC;YAED,IAAI,MAAM,KAAK,WAAW,EAAE,CAAC;gBAC3B,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC;YAC5C,CAAC;QACH,CAAC;IACH,CAAC;CACF"}

package/dist/cli/handlers/ShutdownController.d.ts

@@ -0,0 +1,38 @@
+import type { BdgSession } from '../../session/BdgSession.js';
+import type { CDPTarget, LaunchedChrome } from '../../types.js';
+import { OutputWriter } from './OutputWriter.js';
+/**
+ * Minimal session state interface
+ */
+export interface SessionState {
+    session: BdgSession | null;
+    launchedChrome: LaunchedChrome | null;
+    isShuttingDown: boolean;
+    startTime: number;
+    target: CDPTarget | null;
+    compact: boolean;
+}
+/**
+ * Orchestrates shutdown sequence and cleanup operations
+ */
+export declare class ShutdownController {
+    private state;
+    private shutdownKeepalive;
+    private outputWriter;
+    constructor(state: SessionState, outputWriter?: OutputWriter);
+    /**
+     * Execute graceful shutdown sequence.
+     * Stops session, writes output, and exits process.
+     */
+    shutdown(): Promise<void>;
+    /**
+     * Cleanup without stopping session (error path).
+     * Clears timers, tears down Chrome if launched, and removes session files.
+     */
+    cleanup(): Promise<void>;
+    /**
+     * Finalize shutdown: write output, cleanup, and exit (internal use only)
+     */
+    private finalize;
+}
+//# sourceMappingURL=ShutdownController.d.ts.map

package/dist/cli/handlers/ShutdownController.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ShutdownController.d.ts","sourceRoot":"","sources":["../../../src/cli/handlers/ShutdownController.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAE1D,OAAO,KAAK,EAAa,SAAS,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAGpE,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,UAAU,GAAG,IAAI,CAAC;IAC3B,cAAc,EAAE,cAAc,GAAG,IAAI,CAAC;IACtC,cAAc,EAAE,OAAO,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,SAAS,GAAG,IAAI,CAAC;IACzB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;GAEG;AACH,qBAAa,kBAAkB;IAK3B,OAAO,CAAC,KAAK;IAJf,OAAO,CAAC,iBAAiB,CAA+B;IACxD,OAAO,CAAC,YAAY,CAAe;gBAGzB,KAAK,EAAE,YAAY,EAC3B,YAAY,CAAC,EAAE,YAAY;IAK7B;;;OAGG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAsB/B;;;OAGG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAc9B;;OAEG;IACH,OAAO,CAAC,QAAQ;CA8BjB"}

package/dist/cli/handlers/ShutdownController.js

@@ -0,0 +1,83 @@
+import { cleanupSession } from '../../session/cleanup.js';
+import { OutputBuilder } from './OutputBuilder.js';
+import { OutputWriter } from './OutputWriter.js';
+/**
+ * Orchestrates shutdown sequence and cleanup operations
+ */
+export class ShutdownController {
+    state;
+    shutdownKeepalive = null;
+    outputWriter;
+    constructor(state, outputWriter) {
+        this.state = state;
+        this.outputWriter = outputWriter ?? new OutputWriter();
+    }
+    /**
+     * Execute graceful shutdown sequence.
+     * Stops session, writes output, and exits process.
+     */
+    async shutdown() {
+        if (this.state.isShuttingDown || !this.state.session) {
+            return;
+        }
+        this.state.isShuttingDown = true;
+        // Keep event loop alive IMMEDIATELY to prevent premature exit during async operations
+        // This must be set before any await points
+        this.shutdownKeepalive = setInterval(() => { }, 1000);
+        try {
+            console.error('Stopping session...');
+            const output = await this.state.session.stop();
+            this.finalize(output, 0);
+        }
+        catch (error) {
+            console.error('Error during shutdown:', error);
+            const errorOutput = OutputBuilder.buildError(error, this.state.startTime);
+            this.finalize(errorOutput, 1);
+        }
+    }
+    /**
+     * Cleanup without stopping session (error path).
+     * Clears timers, tears down Chrome if launched, and removes session files.
+     */
+    async cleanup() {
+        // Kill Chrome if we launched it
+        if (this.state.launchedChrome) {
+            try {
+                await this.state.launchedChrome.kill();
+            }
+            catch {
+                // Ignore errors during cleanup
+            }
+        }
+        // Cleanup session files
+        cleanupSession();
+    }
+    /**
+     * Finalize shutdown: write output, cleanup, and exit (internal use only)
+     */
+    finalize(output, exitCode) {
+        // Write output
+        this.outputWriter.writeSessionOutput(output, exitCode, this.state.compact);
+        // Leave Chrome running for future sessions
+        if (this.state.launchedChrome) {
+            const chromeMessage = exitCode === 0
+                ? 'Leaving Chrome running for future sessions (use persistent profile)'
+                : 'Leaving Chrome running (use persistent profile)';
+            console.error(chromeMessage);
+            console.error(`Chrome PID: ${this.state.launchedChrome.pid}, port: ${this.state.launchedChrome.port}`);
+        }
+        // Cleanup session files
+        try {
+            cleanupSession();
+        }
+        catch (cleanupError) {
+            console.error('Error cleaning up session:', cleanupError);
+        }
+        // Clear keepalive and exit
+        if (this.shutdownKeepalive) {
+            clearInterval(this.shutdownKeepalive);
+        }
+        process.exit(exitCode);
+    }
+}
+//# sourceMappingURL=ShutdownController.js.map

package/dist/cli/handlers/ShutdownController.js.map

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

package/dist/cli/handlers/SignalHandler.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Interface for shutdown callback
+ */
+export interface SignalHandlerOptions {
+    onShutdown: () => Promise<void>;
+}
+/**
+ * Manages process signal handling for graceful shutdown
+ */
+export declare class SignalHandler {
+    private options;
+    private isHandling;
+    constructor(options: SignalHandlerOptions);
+    /**
+     * Register signal handlers for graceful shutdown.
+     */
+    register(): void;
+    /**
+     * Unregister all signal handlers.
+     */
+    unregister(): void;
+    /**
+     * Handle shutdown signals (SIGINT, SIGTERM)
+     */
+    private handleSignal;
+    /**
+     * Handle unhandled promise rejections
+     */
+    private handleUnhandledRejection;
+    /**
+     * Handle uncaught exceptions
+     */
+    private handleUncaughtException;
+}
+//# sourceMappingURL=SignalHandler.d.ts.map

package/dist/cli/handlers/SignalHandler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SignalHandler.d.ts","sourceRoot":"","sources":["../../../src/cli/handlers/SignalHandler.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,UAAU,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CACjC;AAED;;GAEG;AACH,qBAAa,aAAa;IAGZ,OAAO,CAAC,OAAO;IAF3B,OAAO,CAAC,UAAU,CAAS;gBAEP,OAAO,EAAE,oBAAoB;IAEjD;;OAEG;IACH,QAAQ,IAAI,IAAI;IAUhB;;OAEG;IACH,UAAU,IAAI,IAAI;IAOlB;;OAEG;IACH,OAAO,CAAC,YAAY;IAqBpB;;OAEG;IACH,OAAO,CAAC,wBAAwB,CAS9B;IAEF;;OAEG;IACH,OAAO,CAAC,uBAAuB,CAS7B;CACH"}

package/dist/cli/handlers/SignalHandler.js

@@ -0,0 +1,81 @@
+import { cleanupSession } from '../../session/cleanup.js';
+import { EXIT_CODES } from '../../utils/exitCodes.js';
+/**
+ * Manages process signal handling for graceful shutdown
+ */
+export class SignalHandler {
+    options;
+    isHandling = false;
+    constructor(options) {
+        this.options = options;
+    }
+    /**
+     * Register signal handlers for graceful shutdown.
+     */
+    register() {
+        const handler = (signal) => this.handleSignal(signal);
+        process.on('SIGINT', () => handler('SIGINT'));
+        process.on('SIGTERM', () => handler('SIGTERM'));
+        process.on('unhandledRejection', this.handleUnhandledRejection);
+        process.on('uncaughtException', this.handleUncaughtException);
+    }
+    /**
+     * Unregister all signal handlers.
+     */
+    unregister() {
+        process.removeAllListeners('SIGINT');
+        process.removeAllListeners('SIGTERM');
+        process.removeAllListeners('unhandledRejection');
+        process.removeAllListeners('uncaughtException');
+    }
+    /**
+     * Handle shutdown signals (SIGINT, SIGTERM)
+     */
+    handleSignal(signal) {
+        if (this.isHandling) {
+            return;
+        }
+        this.isHandling = true;
+        console.error(`\nReceived ${signal}, shutting down gracefully...`);
+        this.unregister();
+        void (async () => {
+            try {
+                await this.options.onShutdown();
+                // onShutdown calls process.exit(), so we should never reach here
+            }
+            catch (error) {
+                console.error('Fatal error during shutdown:', error);
+                process.exit(EXIT_CODES.SIGNAL_HANDLER_ERROR);
+            }
+        })();
+    }
+    /**
+     * Handle unhandled promise rejections
+     */
+    handleUnhandledRejection = (reason) => {
+        console.error('Unhandled rejection:', reason);
+        console.error('Cleaning up session files...');
+        try {
+            cleanupSession();
+        }
+        catch (error) {
+            console.error('Error during cleanup:', error);
+        }
+        process.exit(EXIT_CODES.UNHANDLED_EXCEPTION);
+    };
+    /**
+     * Handle uncaught exceptions
+     */
+    handleUncaughtException = (error) => {
+        console.error('Uncaught exception:', error);
+        console.error('Cleaning up session files...');
+        try {
+            cleanupSession();
+        }
+        catch (cleanupError) {
+            console.error('Error during cleanup:', cleanupError);
+        }
+        process.exit(EXIT_CODES.UNHANDLED_EXCEPTION);
+    };
+}
+//# sourceMappingURL=SignalHandler.js.map

package/dist/cli/handlers/SignalHandler.js.map

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

package/dist/cli/handlers/TargetSetup.d.ts

@@ -0,0 +1,42 @@
+import { BdgSession } from '../../session/BdgSession.js';
+import type { CDPTarget, SessionOptions } from '../../types.js';
+/**
+ * Handles CDP target setup and session creation
+ */
+export declare class TargetSetup {
+    /**
+     * Create CDP connection and find/create target tab
+     *
+     * @param url - Original URL from CLI (for matching)
+     * @param targetUrl - Normalized target URL
+     * @param port - Chrome debugging port
+     * @param reuseTab - Whether to reuse existing tab
+     * @param sessionOptions - Session-level collection options
+     * @returns Session and target metadata
+     */
+    static setup(url: string, targetUrl: string, port: number, reuseTab: boolean, sessionOptions?: SessionOptions): Promise<{
+        session: BdgSession;
+        target: CDPTarget;
+    }>;
+    /**
+     * Fetch the current list of available CDP targets from Chrome.
+     * Used during session bootstrap to select a temporary connection target and to
+     * refresh metadata when the session creates or reuses tabs.
+     *
+     * @param port - Chrome debugging port
+     * @returns Array of CDP targets
+     */
+    private static fetchTargets;
+    /**
+     * Locate a specific CDP target by ID. Falls back to a fresh fetch when cached
+     * metadata is missing or incomplete (e.g., webSocketDebuggerUrl absent).
+     *
+     * @param targetId - Target ID to find
+     * @param port - Chrome debugging port
+     * @param cachedTargets - Optional cached target list
+     * @returns CDP target with webSocketDebuggerUrl
+     * @throws Error if target not found or missing webSocketDebuggerUrl
+     */
+    private static findTargetById;
+}
+//# sourceMappingURL=TargetSetup.d.ts.map

package/dist/cli/handlers/TargetSetup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TargetSetup.d.ts","sourceRoot":"","sources":["../../../src/cli/handlers/TargetSetup.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,OAAO,KAAK,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAEzD;;GAEG;AACH,qBAAa,WAAW;IACtB;;;;;;;;;OASG;WACU,KAAK,CAChB,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,OAAO,EACjB,cAAc,GAAE,cAAmB,GAClC,OAAO,CAAC;QAAE,OAAO,EAAE,UAAU,CAAC;QAAC,MAAM,EAAE,SAAS,CAAA;KAAE,CAAC;IAoCtD;;;;;;;OAOG;mBACkB,YAAY;IAKjC;;;;;;;;;OASG;mBACkB,cAAc;CA2BpC"}

package/dist/cli/handlers/TargetSetup.js

@@ -0,0 +1,87 @@
+import { createOrFindTarget } from '../../connection/tabs.js';
+import { BdgSession } from '../../session/BdgSession.js';
+/**
+ * Handles CDP target setup and session creation
+ */
+export class TargetSetup {
+    /**
+     * Create CDP connection and find/create target tab
+     *
+     * @param url - Original URL from CLI (for matching)
+     * @param targetUrl - Normalized target URL
+     * @param port - Chrome debugging port
+     * @param reuseTab - Whether to reuse existing tab
+     * @param sessionOptions - Session-level collection options
+     * @returns Session and target metadata
+     */
+    static async setup(url, targetUrl, port, reuseTab, sessionOptions = {}) {
+        // Fetch targets once
+        const initialTargets = await this.fetchTargets(port);
+        if (initialTargets.length === 0) {
+            throw new Error('No targets available in Chrome');
+        }
+        // Use first available target to establish CDP connection
+        const tempTarget = initialTargets[0];
+        if (!tempTarget) {
+            throw new Error('No targets available in Chrome');
+        }
+        const tempSession = new BdgSession(tempTarget, port, sessionOptions);
+        await tempSession.connect();
+        if (!tempSession.isConnected()) {
+            throw new Error('Failed to establish CDP connection');
+        }
+        // Create or find target tab using TabManager
+        console.error(`Finding or creating tab for: ${targetUrl}`);
+        const target = await createOrFindTarget(url, tempSession.getCDP(), reuseTab);
+        console.error(`Using tab: ${target.url}`);
+        // Find full target metadata (refetches only if not in cache or new tab created)
+        const fullTarget = await this.findTargetById(target.id, port, initialTargets);
+        // Close temp session and reconnect to the correct target
+        tempSession.getCDP().close();
+        const session = new BdgSession(fullTarget, port, sessionOptions);
+        await session.connect();
+        return { session, target: fullTarget };
+    }
+    /**
+     * Fetch the current list of available CDP targets from Chrome.
+     * Used during session bootstrap to select a temporary connection target and to
+     * refresh metadata when the session creates or reuses tabs.
+     *
+     * @param port - Chrome debugging port
+     * @returns Array of CDP targets
+     */
+    static async fetchTargets(port) {
+        const response = await fetch(`http://127.0.0.1:${port}/json/list`);
+        return (await response.json());
+    }
+    /**
+     * Locate a specific CDP target by ID. Falls back to a fresh fetch when cached
+     * metadata is missing or incomplete (e.g., webSocketDebuggerUrl absent).
+     *
+     * @param targetId - Target ID to find
+     * @param port - Chrome debugging port
+     * @param cachedTargets - Optional cached target list
+     * @returns CDP target with webSocketDebuggerUrl
+     * @throws Error if target not found or missing webSocketDebuggerUrl
+     */
+    static async findTargetById(targetId, port, cachedTargets) {
+        // First check cached targets if provided
+        if (cachedTargets) {
+            const cached = cachedTargets.find((t) => t.id === targetId);
+            if (cached?.webSocketDebuggerUrl) {
+                return cached;
+            }
+        }
+        // Not in cache or missing webSocketDebuggerUrl - refetch
+        const targets = await this.fetchTargets(port);
+        const target = targets.find((t) => t.id === targetId);
+        if (!target) {
+            throw new Error(`Could not find target ${targetId}`);
+        }
+        if (!target.webSocketDebuggerUrl) {
+            throw new Error(`Could not find webSocketDebuggerUrl for target ${targetId}`);
+        }
+        return target;
+    }
+}
+//# sourceMappingURL=TargetSetup.js.map

package/dist/cli/handlers/TargetSetup.js.map

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

package/dist/cli/handlers/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/cli/handlers/commonOptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commonOptions.d.ts","sourceRoot":"","sources":["../../../src/cli/handlers/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"}

package/dist/cli/handlers/commonOptions.js

@@ -0,0 +1,64 @@
+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 const jsonOption = new Option('-j, --json', 'Output as JSON');
+/**
+ * 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 const lastOption = new Option('--last <n>', 'Show last N items')
+    .default(0)
+    .argParser((val) => {
+    const n = parseInt(val, 10);
+    if (isNaN(n) || n < 0 || n > 10000) {
+        throw new Error('--last must be between 0 and 10000');
+    }
+    return n;
+});
+/**
+ * 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 function filterOption(validTypes) {
+    return new Option('--filter <type>', `Filter by type (${validTypes.join(', ')})`).choices(validTypes);
+}
+//# sourceMappingURL=commonOptions.js.map

package/dist/cli/handlers/commonOptions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"commonOptions.js","sourceRoot":"","sources":["../../../src/cli/handlers/commonOptions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAEnC;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,IAAI,MAAM,CAAC,YAAY,EAAE,gBAAgB,CAAC,CAAC;AAErE;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,IAAI,MAAM,CAAC,YAAY,EAAE,mBAAmB,CAAC;KACpE,OAAO,CAAC,CAAC,CAAC;KACV,SAAS,CAAC,CAAC,GAAG,EAAE,EAAE;IACjB,MAAM,CAAC,GAAG,QAAQ,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IAC5B,IAAI,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,KAAK,EAAE,CAAC;QACnC,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;IACxD,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC,CAAC,CAAC;AAEL;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,YAAY,CAAC,UAAoB;IAC/C,OAAO,IAAI,MAAM,CAAC,iBAAiB,EAAE,mBAAmB,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,OAAO,CACvF,UAAU,CACX,CAAC;AACJ,CAAC"}

package/dist/cli/handlers/daemonSessionController.d.ts

@@ -0,0 +1,23 @@
+import type { CollectorType } from '@/types.js';
+/**
+ * Start a session via the daemon using IPC.
+ *
+ * This replaces the in-process sessionController.startSession() by:
+ * 1. Sending a start_session_request to the daemon
+ * 2. Waiting for the worker to launch and report readiness
+ * 3. Outputting metadata about the running session
+ * 4. Keeping the process alive while the session runs
+ *
+ * @param url - Target URL to navigate to
+ * @param options - Session configuration options
+ * @param collectors - Array of collector types to enable
+ */
+export declare function startSessionViaDaemon(url: string, options: {
+    port: number;
+    timeout: number | undefined;
+    userDataDir: string | undefined;
+    includeAll: boolean;
+    maxBodySize: number | undefined;
+    compact: boolean;
+}, collectors: CollectorType[]): Promise<void>;
+//# sourceMappingURL=daemonSessionController.d.ts.map

package/dist/cli/handlers/daemonSessionController.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"daemonSessionController.d.ts","sourceRoot":"","sources":["../../../src/cli/handlers/daemonSessionController.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAIhD;;;;;;;;;;;;GAYG;AACH,wBAAsB,qBAAqB,CACzC,GAAG,EAAE,MAAM,EACX,OAAO,EAAE;IACP,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,UAAU,EAAE,OAAO,CAAC;IACpB,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,OAAO,EAAE,OAAO,CAAC;CAClB,EACD,UAAU,EAAE,aAAa,EAAE,GAC1B,OAAO,CAAC,IAAI,CAAC,CAyGf"}