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

package/dist/cli/handlers/daemonSessionController.js

@@ -0,0 +1,108 @@
+import { startSession as sendStartSessionRequest } from '../../ipc/client.js';
+import { IPCErrorCode } from '../../ipc/types.js';
+import { getErrorMessage } from '../../utils/errors.js';
+import { EXIT_CODES } from '../../utils/exitCodes.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 async function startSessionViaDaemon(url, options, collectors) {
+    try {
+        console.error('[bdg] Connecting to daemon...');
+        // Send start_session_request to daemon
+        const requestOptions = {};
+        if (options.port !== undefined)
+            requestOptions.port = options.port;
+        if (options.timeout !== undefined)
+            requestOptions.timeout = options.timeout;
+        if (collectors.length > 0)
+            requestOptions.collectors = collectors;
+        if (options.includeAll !== undefined)
+            requestOptions.includeAll = options.includeAll;
+        if (options.userDataDir !== undefined)
+            requestOptions.userDataDir = options.userDataDir;
+        if (options.maxBodySize !== undefined)
+            requestOptions.maxBodySize = options.maxBodySize;
+        const response = await sendStartSessionRequest(url, requestOptions);
+        // Check for errors
+        if (response.status === 'error') {
+            // Special handling for SESSION_ALREADY_RUNNING with helpful context
+            if (response.errorCode === IPCErrorCode.SESSION_ALREADY_RUNNING && response.existingSession) {
+                const { pid, targetUrl, duration } = response.existingSession;
+                const durationStr = duration
+                    ? duration < 60
+                        ? `${duration}s`
+                        : `${Math.floor(duration / 60)}m ${duration % 60}s`
+                    : 'unknown';
+                console.error(`\nError: Session already running`);
+                console.error(`  PID:      ${pid}`);
+                if (targetUrl) {
+                    console.error(`  Target:   ${targetUrl}`);
+                }
+                console.error(`  Duration: ${durationStr}`);
+                console.error(``);
+                console.error(`Suggestions:`);
+                console.error(`  View session:     bdg status`);
+                console.error(`  Stop and restart: bdg stop && bdg ${url}`);
+                console.error(``);
+            }
+            else {
+                console.error(`[bdg] Daemon error: ${response.message ?? 'Unknown error'}`);
+            }
+            process.exit(EXIT_CODES.UNHANDLED_EXCEPTION);
+        }
+        // Extract metadata from response
+        const { data } = response;
+        if (!data) {
+            console.error('[bdg] Invalid response from daemon: missing data');
+            process.exit(EXIT_CODES.UNHANDLED_EXCEPTION);
+        }
+        // Output session information
+        console.error(`[bdg] Session started via daemon`);
+        console.error(`[bdg] Worker PID: ${data.workerPid}`);
+        console.error(`[bdg] Chrome PID: ${data.chromePid}`);
+        console.error(`[bdg] Target: ${data.targetUrl}`);
+        if (data.targetTitle) {
+            console.error(`[bdg] Title: ${data.targetTitle}`);
+        }
+        const collectorNames = collectors.length === 3 ? 'network, console, and DOM' : collectors.join(', ');
+        if (options.timeout) {
+            console.error(`[bdg] Collecting ${collectorNames} for ${options.timeout}s... ` +
+                `(auto-stop on timeout, or use 'bdg stop' to stop early)`);
+        }
+        else {
+            console.error(`[bdg] Collecting ${collectorNames}... ` + `(use 'bdg stop' when ready to stop and output)`);
+        }
+        console.error('');
+        console.error('Available commands:');
+        console.error('  bdg status              Show session status');
+        console.error('  bdg peek                Preview collected data');
+        console.error('  bdg query <script>      Execute JavaScript in browser');
+        console.error('  bdg stop                Stop session and output results');
+        console.error('');
+        // Session runs in background worker - CLI exits immediately
+        // This allows user to run other commands in the same terminal
+        process.exit(0);
+    }
+    catch (error) {
+        // Handle connection errors
+        const errorMessage = getErrorMessage(error);
+        if (errorMessage.includes('ENOENT') || errorMessage.includes('ECONNREFUSED')) {
+            console.error('[bdg] Daemon not running');
+            console.error('[bdg] Try running the command again or check daemon status with: bdg status');
+            process.exit(EXIT_CODES.UNHANDLED_EXCEPTION);
+        }
+        console.error(`[bdg] Error: ${errorMessage}`);
+        process.exit(EXIT_CODES.UNHANDLED_EXCEPTION);
+    }
+}
+//# sourceMappingURL=daemonSessionController.js.map

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

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

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

@@ -0,0 +1,21 @@
+/**
+ * Aggressively cleanup stale Chrome processes launched by bdg.
+ *
+ * This function kills Chrome instances that were launched by bdg by:
+ * 1. Reading the Chrome PID from persistent cache (~/.bdg/chrome.pid)
+ * 2. Killing that specific Chrome process using cross-platform kill logic
+ *
+ * The cache survives session cleanup, so this works even after a normal session end.
+ *
+ * Cross-platform killing:
+ * - Windows: Uses `taskkill /pid <pid> /T /F` to kill process tree
+ * - Unix/macOS: Uses `process.kill(-pid, 'SIGKILL')` to kill process group
+ *
+ * Note: We can't use chromeLauncher.killAll() because it only tracks instances
+ * created via chromeLauncher.launch(), but we use new chromeLauncher.Launcher()
+ * which doesn't register in that tracking set.
+ *
+ * @returns Number of errors encountered during cleanup
+ */
+export declare function cleanupStaleChrome(): Promise<number>;
+//# sourceMappingURL=sessionController.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sessionController.d.ts","sourceRoot":"","sources":["../../../src/cli/handlers/sessionController.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,MAAM,CAAC,CAuC1D"}

package/dist/cli/handlers/sessionController.js

@@ -0,0 +1,55 @@
+import { getErrorMessage } from '../../utils/errors.js';
+/**
+ * Aggressively cleanup stale Chrome processes launched by bdg.
+ *
+ * This function kills Chrome instances that were launched by bdg by:
+ * 1. Reading the Chrome PID from persistent cache (~/.bdg/chrome.pid)
+ * 2. Killing that specific Chrome process using cross-platform kill logic
+ *
+ * The cache survives session cleanup, so this works even after a normal session end.
+ *
+ * Cross-platform killing:
+ * - Windows: Uses `taskkill /pid <pid> /T /F` to kill process tree
+ * - Unix/macOS: Uses `process.kill(-pid, 'SIGKILL')` to kill process group
+ *
+ * Note: We can't use chromeLauncher.killAll() because it only tracks instances
+ * created via chromeLauncher.launch(), but we use new chromeLauncher.Launcher()
+ * which doesn't register in that tracking set.
+ *
+ * @returns Number of errors encountered during cleanup
+ */
+export async function cleanupStaleChrome() {
+    console.error('\nAttempting to kill stale Chrome processes...');
+    try {
+        // Import session utilities (dynamic import for ES modules)
+        const { readChromePid, clearChromePid } = await import('../../session/chrome.js');
+        const { killChromeProcess } = await import('../../session/process.js');
+        // Read Chrome PID from persistent cache
+        const chromePid = readChromePid();
+        if (!chromePid) {
+            console.error('Warning: No Chrome PID found in cache');
+            console.error('   Either Chrome was already running, or no Chrome was launched by bdg\n');
+            return 0;
+        }
+        // Kill Chrome process (cross-platform)
+        console.error(`Killing Chrome process (PID: ${chromePid})...`);
+        try {
+            // Use SIGKILL for aggressive cleanup (force kill)
+            killChromeProcess(chromePid, 'SIGKILL');
+            console.error('Chrome process killed successfully');
+            // Clear the cache after successful kill
+            clearChromePid();
+            return 0;
+        }
+        catch (killError) {
+            console.error(`Error: Failed to kill Chrome process: ${getErrorMessage(killError)}`);
+            console.error('   Try manually killing Chrome processes if issues persist\n');
+            return 1;
+        }
+    }
+    catch (error) {
+        console.error(`Error: Failed to cleanup Chrome processes: ${getErrorMessage(error)}\n`);
+        return 1;
+    }
+}
+//# sourceMappingURL=sessionController.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sessionController.js","sourceRoot":"","sources":["../../../src/cli/handlers/sessionController.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEpD;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB;IACtC,OAAO,CAAC,KAAK,CAAC,gDAAgD,CAAC,CAAC;IAEhE,IAAI,CAAC;QACH,2DAA2D;QAC3D,MAAM,EAAE,aAAa,EAAE,cAAc,EAAE,GAAG,MAAM,MAAM,CAAC,qBAAqB,CAAC,CAAC;QAC9E,MAAM,EAAE,iBAAiB,EAAE,GAAG,MAAM,MAAM,CAAC,sBAAsB,CAAC,CAAC;QAEnE,wCAAwC;QACxC,MAAM,SAAS,GAAG,aAAa,EAAE,CAAC;QAElC,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,uCAAuC,CAAC,CAAC;YACvD,OAAO,CAAC,KAAK,CAAC,0EAA0E,CAAC,CAAC;YAC1F,OAAO,CAAC,CAAC;QACX,CAAC;QAED,uCAAuC;QACvC,OAAO,CAAC,KAAK,CAAC,gCAAgC,SAAS,MAAM,CAAC,CAAC;QAE/D,IAAI,CAAC;YACH,kDAAkD;YAClD,iBAAiB,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;YAExC,OAAO,CAAC,KAAK,CAAC,oCAAoC,CAAC,CAAC;YAEpD,wCAAwC;YACxC,cAAc,EAAE,CAAC;YAEjB,OAAO,CAAC,CAAC;QACX,CAAC;QAAC,OAAO,SAAS,EAAE,CAAC;YACnB,OAAO,CAAC,KAAK,CAAC,yCAAyC,eAAe,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;YACrF,OAAO,CAAC,KAAK,CAAC,8DAA8D,CAAC,CAAC;YAC9E,OAAO,CAAC,CAAC;QACX,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,8CAA8C,eAAe,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACxF,OAAO,CAAC,CAAC;IACX,CAAC;AACH,CAAC"}

package/dist/cli/registry.d.ts

@@ -0,0 +1,11 @@
+import type { Command } from 'commander';
+/**
+ * Command registration function type
+ */
+export type CommandRegistrar = (program: Command) => void;
+/**
+ * Registry of all CLI commands with grouping
+ * Order matters: groups organize commands in help output
+ */
+export declare const commandRegistry: CommandRegistrar[];
+//# sourceMappingURL=registry.d.ts.map

package/dist/cli/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/cli/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAazC;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;AAW1D;;;GAGG;AACH,eAAO,MAAM,eAAe,EAAE,gBAAgB,EA2B7C,CAAC"}

package/dist/cli/registry.js

@@ -0,0 +1,46 @@
+import { registerCdpCommand } from './commands/cdp.js';
+import { registerCleanupCommand } from './commands/cleanup.js';
+import { registerConsoleCommand } from './commands/console.js';
+import { registerDetailsCommand } from './commands/details.js';
+import { registerDomCommands } from './commands/dom/index.js';
+import { registerNetworkCommands } from './commands/network.js';
+import { registerPeekCommand } from './commands/peek.js';
+import { registerStartCommands } from './commands/start.js';
+import { registerStatusCommand } from './commands/status.js';
+import { registerStopCommand } from './commands/stop.js';
+/**
+ * Helper to add a command group
+ */
+const addCommandGroup = (groupName) => {
+    return (program) => {
+        program.commandsGroup(groupName);
+    };
+};
+/**
+ * Registry of all CLI commands with grouping
+ * Order matters: groups organize commands in help output
+ */
+export const commandRegistry = [
+    // Default command (no group)
+    registerStartCommands, // Default + dom/network/console
+    // Session Management Commands
+    addCommandGroup('Session Management:'),
+    registerStatusCommand,
+    registerStopCommand,
+    registerCleanupCommand,
+    // Data Inspection Commands
+    addCommandGroup('Data Inspection:'),
+    registerPeekCommand,
+    registerDetailsCommand,
+    registerDomCommands,
+    // CDP Commands
+    addCommandGroup('CDP Commands:'),
+    registerCdpCommand,
+    // Network Commands
+    addCommandGroup('Network Commands:'),
+    registerNetworkCommands,
+    // Console Commands
+    addCommandGroup('Console Commands:'),
+    registerConsoleCommand,
+];
+//# sourceMappingURL=registry.js.map

package/dist/cli/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/cli/registry.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AACnE,OAAO,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AACnE,OAAO,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AACnE,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACpE,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAO7D;;GAEG;AACH,MAAM,eAAe,GAAG,CAAC,SAAiB,EAAoB,EAAE;IAC9D,OAAO,CAAC,OAAgB,EAAE,EAAE;QAC1B,OAAO,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC;IACnC,CAAC,CAAC;AACJ,CAAC,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,eAAe,GAAuB;IACjD,6BAA6B;IAC7B,qBAAqB,EAAE,gCAAgC;IAEvD,8BAA8B;IAC9B,eAAe,CAAC,qBAAqB,CAAC;IACtC,qBAAqB;IACrB,mBAAmB;IACnB,sBAAsB;IAEtB,2BAA2B;IAC3B,eAAe,CAAC,kBAAkB,CAAC;IACnC,mBAAmB;IACnB,sBAAsB;IACtB,mBAAmB;IAEnB,eAAe;IACf,eAAe,CAAC,eAAe,CAAC;IAChC,kBAAkB;IAElB,mBAAmB;IACnB,eAAe,CAAC,mBAAmB,CAAC;IACpC,uBAAuB;IAEvB,mBAAmB;IACnB,eAAe,CAAC,mBAAmB,CAAC;IACpC,sBAAsB;CACvB,CAAC"}

package/dist/collectors/__tests__/network.contract.test.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Network collector contract tests
+ *
+ * Tests the public API behavior of startNetworkCollection WITHOUT testing implementation details.
+ * Follows the testing philosophy: "Test the contract, not the implementation"
+ *
+ * Coverage:
+ * 1. Request/response pairing - Normal flow with matching IDs
+ * 2. Out-of-order events - Response arrives before request
+ * 3. Stale requests - Incomplete requests after timeout
+ * 4. Failed requests - Network.loadingFailed events
+ * 5. Request limits - MAX_NETWORK_REQUESTS enforcement
+ * 6. Cleanup - Handler removal and state cleanup
+ * 7. Domain filtering - Tracking/analytics exclusion
+ * 8. Body fetching - Size limits and MIME type handling
+ *
+ * What we test:
+ * ✅ Behavior: Given CDP events → expect NetworkRequest array contents
+ * ✅ Invariants: "Requests are paired with responses", "Cleanup removes all handlers"
+ * ✅ Edge cases: Out-of-order, stale, limits, failures
+ *
+ * What we DON'T test:
+ * ❌ Internal requestMap structure
+ * ❌ Internal function calls (tryExactMatch, normalizeUrl, etc.)
+ * ❌ Implementation details (Map vs Set, event handler IDs)
+ */
+export {};
+//# sourceMappingURL=network.contract.test.d.ts.map

package/dist/collectors/__tests__/network.contract.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"network.contract.test.d.ts","sourceRoot":"","sources":["../../../src/collectors/__tests__/network.contract.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG"}