browser-debugger-cli 0.2.0 → 0.5.1

package/dist/__tests__/smoke/error-handling.smoke.test.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Error handling smoke tests.
+ *
+ * Tests error paths and user-facing error messages.
+ * WHY: Errors are high-risk areas - tests ensure helpful messages and proper exit codes.
+ */
+export {};
+//# sourceMappingURL=error-handling.smoke.test.d.ts.map

package/dist/__tests__/smoke/error-handling.smoke.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-handling.smoke.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/smoke/error-handling.smoke.test.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/__tests__/smoke/error-handling.smoke.test.js

@@ -0,0 +1,106 @@
+/**
+ * Error handling smoke tests.
+ *
+ * Tests error paths and user-facing error messages.
+ * WHY: Errors are high-risk areas - tests ensure helpful messages and proper exit codes.
+ */
+import * as assert from 'node:assert/strict';
+import { describe, it, afterEach } from 'node:test';
+import { runCommand } from '../../__testutils__/commandRunner.js';
+import { cleanupAllSessions, isDaemonRunning, killDaemon, waitForDaemon, } from '../../__testutils__/daemonHelpers.js';
+import { EXIT_CODES } from '../../utils/exitCodes.js';
+void describe('Error Handling Smoke Tests', () => {
+    afterEach(async () => {
+        // Cleanup after each test (no beforeEach needed if this works properly)
+        await cleanupAllSessions();
+    });
+    void it('should fail with helpful message when daemon not running', async () => {
+        // Try to peek without daemon running
+        // Note: peek auto-starts daemon, so it returns 83 after starting daemon
+        const result = await runCommand('peek', [], { timeout: 5000 });
+        // Should fail with resource not found (no session)
+        assert.equal(result.exitCode, EXIT_CODES.RESOURCE_NOT_FOUND);
+        // Should provide helpful error message about no session
+        assert.ok(/no.*session|session.*not.*found/i.test(result.stderr));
+    });
+    void it('should fail with helpful message when trying to stop without session', async () => {
+        // Try to stop without session
+        const result = await runCommand('stop', [], { timeout: 5000 });
+        // Should fail
+        assert.notEqual(result.exitCode, 0);
+        // Should provide helpful error message
+        assert.ok(result.stderr.includes('daemon'));
+    });
+    void it('should handle invalid URL gracefully', async () => {
+        // Note: URL validation is permissive - "not-a-valid-url" becomes "http://not-a-valid-url/"
+        // This test verifies error handling, not URL validation
+        const result = await runCommand('http://example.com', ['--port', '9229', '--headless'], {
+            timeout: 10000,
+        });
+        // Should succeed (URL is valid, session starts)
+        assert.equal(result.exitCode, 0);
+        // Should provide session started message
+        assert.ok(/session started|target:/i.test(result.stderr));
+    });
+    void it('should handle daemon crash during session', async () => {
+        // Start session with unique port
+        await runCommand('http://example.com', ['--port', '9230', '--headless'], { timeout: 10000 });
+        await waitForDaemon(5000);
+        // Kill daemon forcefully (simulate crash)
+        await killDaemon('SIGKILL');
+        // Wait for process to fully die
+        await new Promise((resolve) => setTimeout(resolve, 1000));
+        // Try to peek (should fail)
+        const peekResult = await runCommand('peek', [], { timeout: 5000 });
+        // Should fail
+        assert.notEqual(peekResult.exitCode, 0);
+        // Should provide helpful error message
+        assert.ok(peekResult.stderr.includes('daemon'));
+        // Daemon should not be running
+        assert.equal(isDaemonRunning(), false);
+    });
+    void it('should provide helpful error when Chrome fails to launch', async () => {
+        // Try to start with invalid Chrome path and unique port
+        const result = await runCommand('http://example.com', ['--port', '9231', '--headless'], {
+            timeout: 10000,
+            env: {
+                CHROME_PATH: '/nonexistent/chrome',
+            },
+        });
+        // Should fail (exit code 104 is acceptable for worker errors)
+        assert.notEqual(result.exitCode, 0);
+        // Should provide helpful error message mentioning Chrome
+        assert.ok(/chrome|browser|launch|binary/i.test(result.stderr));
+    });
+    void it('should cleanup stale sessions automatically', async () => {
+        // Start session with unique port
+        await runCommand('http://example.com', ['--port', '9232', '--headless'], { timeout: 10000 });
+        await waitForDaemon(5000);
+        // Kill daemon without cleanup (simulate crash)
+        await killDaemon('SIGKILL');
+        // Kill Chrome on port 9232 (simulating what happens when daemon crashes)
+        try {
+            const { execSync } = await import('child_process');
+            execSync(`lsof -ti:9232 | xargs kill -9 2>/dev/null || true`, { stdio: 'ignore' });
+        }
+        catch {
+            // Ignore errors if no process on port
+        }
+        // Wait for processes to fully die and port to be released
+        await new Promise((resolve) => setTimeout(resolve, 2000));
+        // Try to start new session (should cleanup stale and succeed)
+        const result = await runCommand('http://example.com', ['--port', '9232', '--headless'], {
+            timeout: 10000,
+        });
+        // Should succeed after cleanup
+        if (result.exitCode !== 0) {
+            console.error('Exit code:', result.exitCode);
+            console.error('Stderr:', result.stderr);
+            console.error('Stdout:', result.stdout);
+        }
+        assert.equal(result.exitCode, 0);
+        // New daemon should be running
+        assert.equal(isDaemonRunning(), true);
+    });
+});
+//# sourceMappingURL=error-handling.smoke.test.js.map

package/dist/__tests__/smoke/error-handling.smoke.test.js.map

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

package/dist/__tests__/smoke/session-lifecycle.smoke.test.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Session lifecycle smoke tests.
+ *
+ * Tests the complete user flow: start → collect data → stop → verify output.
+ * WHY: Highest-risk path with 0% coverage despite being critical user flow.
+ */
+export {};
+//# sourceMappingURL=session-lifecycle.smoke.test.d.ts.map

package/dist/__tests__/smoke/session-lifecycle.smoke.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-lifecycle.smoke.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/smoke/session-lifecycle.smoke.test.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/__tests__/smoke/session-lifecycle.smoke.test.js

@@ -0,0 +1,109 @@
+/**
+ * Session lifecycle smoke tests.
+ *
+ * Tests the complete user flow: start → collect data → stop → verify output.
+ * WHY: Highest-risk path with 0% coverage despite being critical user flow.
+ */
+import * as assert from 'node:assert/strict';
+import { describe, it, afterEach } from 'node:test';
+import { runCommand, runCommandJSON } from '../../__testutils__/commandRunner.js';
+import { cleanupAllSessions, isDaemonRunning, isSessionActive, readSessionOutput, waitForDaemon, } from '../../__testutils__/daemonHelpers.js';
+void describe('Session Lifecycle Smoke Tests', () => {
+    afterEach(async () => {
+        // Cleanup after each test (no beforeEach needed if this works properly)
+        await cleanupAllSessions();
+    });
+    void it('should start session and create daemon', async () => {
+        // Start session with a simple URL using a unique port to avoid conflicts
+        const result = await runCommand('http://example.com', ['--port', '9223', '--headless'], {
+            timeout: 10000,
+        });
+        // Should succeed
+        assert.equal(result.exitCode, 0);
+        // Daemon should be running
+        assert.equal(isDaemonRunning(), true);
+        // Session should be active
+        assert.equal(isSessionActive(), true);
+    });
+    void it('should collect data during session', async () => {
+        // Start session with unique port
+        const startResult = await runCommand('http://example.com', ['--port', '9224', '--headless'], {
+            timeout: 10000,
+        });
+        assert.equal(startResult.exitCode, 0, `Session start failed: ${startResult.stderr}`);
+        // Wait for daemon to be ready
+        await waitForDaemon(5000);
+        // Give Chrome time to navigate and collect some data
+        await new Promise((resolve) => setTimeout(resolve, 2000));
+        // Peek at collected data
+        const peekResult = await runCommandJSON('peek', [
+            '--json',
+        ]);
+        // Should have collected some data
+        assert.ok(peekResult);
+        assert.ok(typeof peekResult === 'object');
+        assert.ok('preview' in peekResult);
+        assert.ok('data' in peekResult.preview);
+        // Stop session to clean up
+        const stopResult = await runCommand('stop', [], { timeout: 10000 });
+        assert.equal(stopResult.exitCode, 0, `Stop failed: ${stopResult.stderr}`);
+    });
+    void it('should write output on stop', async () => {
+        // Start session with unique port
+        const startResult = await runCommand('http://example.com', ['--port', '9225', '--headless'], {
+            timeout: 10000,
+        });
+        assert.equal(startResult.exitCode, 0, `Session start failed: ${startResult.stderr}`);
+        await waitForDaemon(5000);
+        // Give Chrome time to collect data
+        await new Promise((resolve) => setTimeout(resolve, 2000));
+        // Stop session
+        const stopResult = await runCommand('stop', [], { timeout: 10000 });
+        // Should succeed
+        assert.equal(stopResult.exitCode, 0, `Stop failed: ${stopResult.stderr}`);
+        // Give filesystem time to write the file (increased for test stability)
+        await new Promise((resolve) => setTimeout(resolve, 2000));
+        // Output file should exist
+        const output = readSessionOutput();
+        assert.ok(output, 'Session output file should exist after stop');
+        assert.ok(typeof output === 'object');
+        // Output should have expected structure
+        assert.ok('version' in output);
+        assert.ok('success' in output);
+        assert.equal(output.success, true);
+        assert.ok('timestamp' in output);
+        assert.ok('data' in output);
+        assert.ok('target' in output);
+    });
+    void it('should cleanup daemon on stop', async () => {
+        // Start session with unique port
+        await runCommand('http://example.com', ['--port', '9226', '--headless'], { timeout: 10000 });
+        await waitForDaemon(5000);
+        // Stop session
+        await runCommand('stop', [], { timeout: 10000 });
+        // Wait for cleanup
+        await new Promise((resolve) => setTimeout(resolve, 1000));
+        // Daemon should no longer be running
+        assert.equal(isDaemonRunning(), false);
+        // Session should no longer be active
+        assert.equal(isSessionActive(), false);
+    });
+    void it('should handle concurrent session attempts gracefully', async () => {
+        // Start first session with unique port
+        const firstResult = await runCommand('http://example.com', ['--port', '9227', '--headless'], {
+            timeout: 10000,
+        });
+        assert.equal(firstResult.exitCode, 0, `First session start failed: ${firstResult.stderr}`);
+        await waitForDaemon(5000);
+        // Try to start second session (should fail)
+        const secondResult = await runCommand('http://another.com', ['--port', '9228', '--headless'], {
+            timeout: 10000,
+        });
+        // Should fail with daemon already running error
+        assert.notEqual(secondResult.exitCode, 0);
+        assert.ok(secondResult.stderr.includes('daemon') || secondResult.stderr.includes('already'), `Expected error about daemon, got: ${secondResult.stderr}`);
+        // First session should still be running
+        assert.equal(isDaemonRunning(), true);
+    });
+});
+//# sourceMappingURL=session-lifecycle.smoke.test.js.map

package/dist/__tests__/smoke/session-lifecycle.smoke.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-lifecycle.smoke.test.js","sourceRoot":"","sources":["../../../src/__tests__/smoke/session-lifecycle.smoke.test.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,MAAM,MAAM,oBAAoB,CAAC;AAC7C,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEpD,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AAC9E,OAAO,EACL,kBAAkB,EAClB,eAAe,EACf,eAAe,EACf,iBAAiB,EACjB,aAAa,GACd,MAAM,kCAAkC,CAAC;AAE1C,KAAK,QAAQ,CAAC,+BAA+B,EAAE,GAAG,EAAE;IAClD,SAAS,CAAC,KAAK,IAAI,EAAE;QACnB,wEAAwE;QACxE,MAAM,kBAAkB,EAAE,CAAC;IAC7B,CAAC,CAAC,CAAC;IAEH,KAAK,EAAE,CAAC,wCAAwC,EAAE,KAAK,IAAI,EAAE;QAC3D,yEAAyE;QACzE,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,oBAAoB,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE;YACtF,OAAO,EAAE,KAAK;SACf,CAAC,CAAC;QAEH,iBAAiB;QACjB,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;QAEjC,2BAA2B;QAC3B,MAAM,CAAC,KAAK,CAAC,eAAe,EAAE,EAAE,IAAI,CAAC,CAAC;QAEtC,2BAA2B;QAC3B,MAAM,CAAC,KAAK,CAAC,eAAe,EAAE,EAAE,IAAI,CAAC,CAAC;IACxC,CAAC,CAAC,CAAC;IAEH,KAAK,EAAE,CAAC,oCAAoC,EAAE,KAAK,IAAI,EAAE;QACvD,iCAAiC;QACjC,MAAM,WAAW,GAAG,MAAM,UAAU,CAAC,oBAAoB,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE;YAC3F,OAAO,EAAE,KAAK;SACf,CAAC,CAAC;QACH,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,QAAQ,EAAE,CAAC,EAAE,yBAAyB,WAAW,CAAC,MAAM,EAAE,CAAC,CAAC;QAErF,8BAA8B;QAC9B,MAAM,aAAa,CAAC,IAAI,CAAC,CAAC;QAE1B,qDAAqD;QACrD,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC;QAE1D,yBAAyB;QACzB,MAAM,UAAU,GAAG,MAAM,cAAc,CAAuC,MAAM,EAAE;YACpF,QAAQ;SACT,CAAC,CAAC;QAEH,kCAAkC;QAClC,MAAM,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC;QACtB,MAAM,CAAC,EAAE,CAAC,OAAO,UAAU,KAAK,QAAQ,CAAC,CAAC;QAC1C,MAAM,CAAC,EAAE,CAAC,SAAS,IAAI,UAAU,CAAC,CAAC;QACnC,MAAM,CAAC,EAAE,CAAC,MAAM,IAAI,UAAU,CAAC,OAAO,CAAC,CAAC;QAExC,2BAA2B;QAC3B,MAAM,UAAU,GAAG,MAAM,UAAU,CAAC,MAAM,EAAE,EAAE,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;QACpE,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,QAAQ,EAAE,CAAC,EAAE,gBAAgB,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC;IAC5E,CAAC,CAAC,CAAC;IAEH,KAAK,EAAE,CAAC,6BAA6B,EAAE,KAAK,IAAI,EAAE;QAChD,iCAAiC;QACjC,MAAM,WAAW,GAAG,MAAM,UAAU,CAAC,oBAAoB,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE;YAC3F,OAAO,EAAE,KAAK;SACf,CAAC,CAAC;QACH,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,QAAQ,EAAE,CAAC,EAAE,yBAAyB,WAAW,CAAC,MAAM,EAAE,CAAC,CAAC;QACrF,MAAM,aAAa,CAAC,IAAI,CAAC,CAAC;QAE1B,mCAAmC;QACnC,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC;QAE1D,eAAe;QACf,MAAM,UAAU,GAAG,MAAM,UAAU,CAAC,MAAM,EAAE,EAAE,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;QAEpE,iBAAiB;QACjB,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,QAAQ,EAAE,CAAC,EAAE,gBAAgB,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC;QAE1E,wEAAwE;QACxE,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC;QAE1D,2BAA2B;QAC3B,MAAM,MAAM,GAAG,iBAAiB,EAAE,CAAC;QACnC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,6CAA6C,CAAC,CAAC;QACjE,MAAM,CAAC,EAAE,CAAC,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC;QAEtC,wCAAwC;QACxC,MAAM,CAAC,EAAE,CAAC,SAAS,IAAI,MAAM,CAAC,CAAC;QAC/B,MAAM,CAAC,EAAE,CAAC,SAAS,IAAI,MAAM,CAAC,CAAC;QAC/B,MAAM,CAAC,KAAK,CAAE,MAA+B,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QAC7D,MAAM,CAAC,EAAE,CAAC,WAAW,IAAI,MAAM,CAAC,CAAC;QACjC,MAAM,CAAC,EAAE,CAAC,MAAM,IAAI,MAAM,CAAC,CAAC;QAC5B,MAAM,CAAC,EAAE,CAAC,QAAQ,IAAI,MAAM,CAAC,CAAC;IAChC,CAAC,CAAC,CAAC;IAEH,KAAK,EAAE,CAAC,+BAA+B,EAAE,KAAK,IAAI,EAAE;QAClD,iCAAiC;QACjC,MAAM,UAAU,CAAC,oBAAoB,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;QAC7F,MAAM,aAAa,CAAC,IAAI,CAAC,CAAC;QAE1B,eAAe;QACf,MAAM,UAAU,CAAC,MAAM,EAAE,EAAE,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;QAEjD,mBAAmB;QACnB,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC;QAE1D,qCAAqC;QACrC,MAAM,CAAC,KAAK,CAAC,eAAe,EAAE,EAAE,KAAK,CAAC,CAAC;QAEvC,qCAAqC;QACrC,MAAM,CAAC,KAAK,CAAC,eAAe,EAAE,EAAE,KAAK,CAAC,CAAC;IACzC,CAAC,CAAC,CAAC;IAEH,KAAK,EAAE,CAAC,sDAAsD,EAAE,KAAK,IAAI,EAAE;QACzE,uCAAuC;QACvC,MAAM,WAAW,GAAG,MAAM,UAAU,CAAC,oBAAoB,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE;YAC3F,OAAO,EAAE,KAAK;SACf,CAAC,CAAC;QACH,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,QAAQ,EAAE,CAAC,EAAE,+BAA+B,WAAW,CAAC,MAAM,EAAE,CAAC,CAAC;QAC3F,MAAM,aAAa,CAAC,IAAI,CAAC,CAAC;QAE1B,4CAA4C;QAC5C,MAAM,YAAY,GAAG,MAAM,UAAU,CAAC,oBAAoB,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE;YAC5F,OAAO,EAAE,KAAK;SACf,CAAC,CAAC;QAEH,gDAAgD;QAChD,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;QAC1C,MAAM,CAAC,EAAE,CACP,YAAY,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,YAAY,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,EACjF,qCAAqC,YAAY,CAAC,MAAM,EAAE,CAC3D,CAAC;QAEF,wCAAwC;QACxC,MAAM,CAAC,KAAK,CAAC,eAAe,EAAE,EAAE,IAAI,CAAC,CAAC;IACxC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/__testutils__/commandRunner.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Command runner for smoke tests.
+ *
+ * Executes bdg CLI commands in a subprocess and captures output.
+ * WHY: Enables end-to-end testing of CLI commands without mocking.
+ */
+export interface CommandResult {
+    exitCode: number;
+    stdout: string;
+    stderr: string;
+    error?: Error;
+}
+/**
+ * Run a bdg CLI command in a subprocess.
+ *
+ * @param command - Command name (e.g., 'start', 'stop', 'peek')
+ * @param args - Command arguments
+ * @param options - Execution options
+ * @returns Promise resolving to command result
+ *
+ * @example
+ * ```typescript
+ * const result = await runCommand('start', ['http://localhost:3000']);
+ * assert.equal(result.exitCode, 0);
+ * ```
+ */
+export declare function runCommand(command: string, args?: string[], options?: {
+    timeout?: number;
+    env?: Record<string, string>;
+}): Promise<CommandResult>;
+/**
+ * Run command and parse JSON output from stdout.
+ *
+ * @param command - Command name
+ * @param args - Command arguments
+ * @returns Parsed JSON output
+ *
+ * @example
+ * ```typescript
+ * const data = await runCommandJSON('peek');
+ * assert.ok(data.data.network.length > 0);
+ * ```
+ */
+export declare function runCommandJSON<T = unknown>(command: string, args?: string[]): Promise<T>;
+//# sourceMappingURL=commandRunner.d.ts.map

package/dist/__testutils__/commandRunner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commandRunner.d.ts","sourceRoot":"","sources":["../../src/__testutils__/commandRunner.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAQH,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,KAAK,CAAC;CACf;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,UAAU,CAC9B,OAAO,EAAE,MAAM,EACf,IAAI,GAAE,MAAM,EAAO,EACnB,OAAO,GAAE;IACP,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACzB,GACL,OAAO,CAAC,aAAa,CAAC,CAiExB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,cAAc,CAAC,CAAC,GAAG,OAAO,EAC9C,OAAO,EAAE,MAAM,EACf,IAAI,GAAE,MAAM,EAAO,GAClB,OAAO,CAAC,CAAC,CAAC,CAYZ"}

package/dist/__testutils__/commandRunner.js

@@ -0,0 +1,108 @@
+/**
+ * Command runner for smoke tests.
+ *
+ * Executes bdg CLI commands in a subprocess and captures output.
+ * WHY: Enables end-to-end testing of CLI commands without mocking.
+ */
+import { spawn } from 'child_process';
+import * as path from 'path';
+import { fileURLToPath } from 'url';
+import { ensureTestSessionDir, getTestHomeDir } from './testHome.js';
+/**
+ * Run a bdg CLI command in a subprocess.
+ *
+ * @param command - Command name (e.g., 'start', 'stop', 'peek')
+ * @param args - Command arguments
+ * @param options - Execution options
+ * @returns Promise resolving to command result
+ *
+ * @example
+ * ```typescript
+ * const result = await runCommand('start', ['http://localhost:3000']);
+ * assert.equal(result.exitCode, 0);
+ * ```
+ */
+export async function runCommand(command, args = [], options = {}) {
+    const { timeout = 30000, env = {} } = options;
+    // Path to compiled CLI entry point (ESM module compatibility)
+    const currentFileDir = path.dirname(fileURLToPath(import.meta.url));
+    const cliPath = path.resolve(currentFileDir, '../../dist/index.js');
+    const testSessionDir = ensureTestSessionDir();
+    const testHomeDir = getTestHomeDir();
+    return new Promise((resolve) => {
+        let stdout = '';
+        let stderr = '';
+        let timedOut = false;
+        const child = spawn('node', [cliPath, command, ...args], {
+            env: {
+                ...process.env,
+                BDG_SESSION_DIR: testSessionDir,
+                HOME: testHomeDir,
+                ...env,
+            },
+            stdio: ['ignore', 'pipe', 'pipe'],
+        });
+        const timeoutId = setTimeout(() => {
+            timedOut = true;
+            child.kill('SIGKILL');
+        }, timeout);
+        child.stdout?.on('data', (chunk) => {
+            stdout += chunk.toString();
+        });
+        child.stderr?.on('data', (chunk) => {
+            stderr += chunk.toString();
+        });
+        child.on('error', (error) => {
+            clearTimeout(timeoutId);
+            resolve({
+                exitCode: 1,
+                stdout,
+                stderr,
+                error,
+            });
+        });
+        child.on('close', (code) => {
+            clearTimeout(timeoutId);
+            if (timedOut) {
+                resolve({
+                    exitCode: 124, // Timeout exit code
+                    stdout,
+                    stderr: stderr + '\nCommand timed out',
+                });
+            }
+            else {
+                resolve({
+                    exitCode: code ?? 1,
+                    stdout,
+                    stderr,
+                });
+            }
+        });
+    });
+}
+/**
+ * Run command and parse JSON output from stdout.
+ *
+ * @param command - Command name
+ * @param args - Command arguments
+ * @returns Parsed JSON output
+ *
+ * @example
+ * ```typescript
+ * const data = await runCommandJSON('peek');
+ * assert.ok(data.data.network.length > 0);
+ * ```
+ */
+export async function runCommandJSON(command, args = []) {
+    const result = await runCommand(command, args);
+    if (result.exitCode !== 0) {
+        throw new Error(`Command failed: ${result.stderr}`);
+    }
+    try {
+        return JSON.parse(result.stdout);
+    }
+    catch {
+        throw new Error(`Failed to parse JSON: ${result.stdout}`);
+    }
+}
+//# sourceMappingURL=commandRunner.js.map

package/dist/__testutils__/commandRunner.js.map

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

package/dist/__testutils__/daemonHelpers.d.ts

@@ -0,0 +1,81 @@
+/**
+ * Daemon helper utilities for smoke tests.
+ *
+ * Provides functions to check daemon status and manage session state.
+ * WHY: Enables testing daemon lifecycle without exposing internals.
+ */
+/**
+ * Check if daemon is currently running.
+ *
+ * @returns True if daemon process is alive
+ *
+ * @example
+ * ```typescript
+ * await runCommand('http://localhost:3000', []);
+ * assert.ok(await isDaemonRunning());
+ * ```
+ */
+export declare function isDaemonRunning(): boolean;
+/**
+ * Check if session is currently active.
+ *
+ * @returns True if session process is alive
+ *
+ * @example
+ * ```typescript
+ * await runCommand('http://localhost:3000', []);
+ * assert.ok(await isSessionActive());
+ * ```
+ */
+export declare function isSessionActive(): boolean;
+/**
+ * Kill daemon process forcefully.
+ *
+ * @param signal - Kill signal (default: SIGTERM)
+ *
+ * @example
+ * ```typescript
+ * await killDaemon('SIGKILL'); // Simulate crash
+ * ```
+ */
+export declare function killDaemon(signal?: NodeJS.Signals): Promise<void>;
+/**
+ * Clean up all session files forcefully.
+ *
+ * WHY: Ensures clean state between tests.
+ *
+ * @example
+ * ```typescript
+ * afterEach(async () => {
+ *   await cleanupAllSessions();
+ * });
+ * ```
+ */
+export declare function cleanupAllSessions(): Promise<void>;
+/**
+ * Read session output file.
+ *
+ * @returns Parsed session output or null if not exists
+ *
+ * @example
+ * ```typescript
+ * await runCommand('stop', []);
+ * const output = readSessionOutput();
+ * assert.equal(output.success, true);
+ * ```
+ */
+export declare function readSessionOutput(): unknown;
+/**
+ * Wait for daemon to start (with timeout).
+ *
+ * @param timeoutMs - Timeout in milliseconds (default: 5000)
+ * @returns True if daemon started, false if timeout
+ *
+ * @example
+ * ```typescript
+ * runCommand('start', ['http://localhost:3000']); // Don't await
+ * assert.ok(await waitForDaemon(5000));
+ * ```
+ */
+export declare function waitForDaemon(timeoutMs?: number): Promise<boolean>;
+//# sourceMappingURL=daemonHelpers.d.ts.map

package/dist/__testutils__/daemonHelpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"daemonHelpers.d.ts","sourceRoot":"","sources":["../../src/__testutils__/daemonHelpers.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAYH;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,IAAI,OAAO,CAmBzC;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,IAAI,OAAO,CAYzC;AAED;;;;;;;;;GASG;AACH,wBAAsB,UAAU,CAAC,MAAM,GAAE,MAAM,CAAC,OAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CA6BlF;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC,CAiDxD;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,CAa3C;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,aAAa,CAAC,SAAS,GAAE,MAAa,GAAG,OAAO,CAAC,OAAO,CAAC,CAW9E"}