browser-debugger-cli 0.3.0 → 0.6.0

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"}

package/dist/__testutils__/daemonHelpers.js

@@ -0,0 +1,206 @@
+/**
+ * Daemon helper utilities for smoke tests.
+ *
+ * Provides functions to check daemon status and manage session state.
+ * WHY: Enables testing daemon lifecycle without exposing internals.
+ */
+import * as fs from 'fs';
+import { getSessionFilePath } from '../session/paths.js';
+import { readPid } from '../session/pid.js';
+import { isProcessAlive } from '../session/process.js';
+import { ensureTestSessionDir } from './testHome.js';
+ensureTestSessionDir();
+/**
+ * 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 function isDaemonRunning() {
+    try {
+        const daemonPidPath = getSessionFilePath('DAEMON_PID');
+        if (!fs.existsSync(daemonPidPath)) {
+            return false;
+        }
+        const pidStr = fs.readFileSync(daemonPidPath, 'utf-8').trim();
+        const pid = parseInt(pidStr, 10);
+        if (isNaN(pid)) {
+            return false;
+        }
+        return isProcessAlive(pid);
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * 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 function isSessionActive() {
+    try {
+        const sessionPid = readPid();
+        if (sessionPid === null) {
+            return false;
+        }
+        return isProcessAlive(sessionPid);
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Kill daemon process forcefully.
+ *
+ * @param signal - Kill signal (default: SIGTERM)
+ *
+ * @example
+ * ```typescript
+ * await killDaemon('SIGKILL'); // Simulate crash
+ * ```
+ */
+export async function killDaemon(signal = 'SIGTERM') {
+    const daemonPidPath = getSessionFilePath('DAEMON_PID');
+    if (!fs.existsSync(daemonPidPath)) {
+        return;
+    }
+    const pidStr = fs.readFileSync(daemonPidPath, 'utf-8').trim();
+    const pid = parseInt(pidStr, 10);
+    if (!isNaN(pid) && isProcessAlive(pid)) {
+        process.kill(pid, signal);
+        // Wait for process to die
+        await new Promise((resolve) => {
+            const check = setInterval(() => {
+                if (!isProcessAlive(pid)) {
+                    clearInterval(check);
+                    resolve(undefined);
+                }
+            }, 100);
+            // Timeout after 5s
+            setTimeout(() => {
+                clearInterval(check);
+                resolve(undefined);
+            }, 5000);
+        });
+    }
+}
+/**
+ * Clean up all session files forcefully.
+ *
+ * WHY: Ensures clean state between tests.
+ *
+ * @example
+ * ```typescript
+ * afterEach(async () => {
+ *   await cleanupAllSessions();
+ * });
+ * ```
+ */
+export async function cleanupAllSessions() {
+    // Kill daemon if running via PID file
+    await killDaemon('SIGKILL');
+    // Kill ALL daemon/worker processes (handles orphaned processes from failed tests)
+    // This is aggressive but necessary for test isolation
+    try {
+        const { execSync } = await import('child_process');
+        execSync('pkill -9 -f "node.*dist/daemon" 2>/dev/null || true', { stdio: 'ignore' });
+        execSync('pkill -9 -f "node.*dist/daemon/worker" 2>/dev/null || true', { stdio: 'ignore' });
+    }
+    catch {
+        // Ignore errors
+    }
+    // Kill Chrome on all test ports (9222-9232)
+    try {
+        const { execSync } = await import('child_process');
+        for (let port = 9222; port <= 9232; port++) {
+            execSync(`lsof -ti:${port} | xargs kill -9 2>/dev/null || true`, { stdio: 'ignore' });
+        }
+    }
+    catch {
+        // Ignore errors if no process on port
+    }
+    // Wait for processes to fully die and ports to be released
+    // Increased to 2000ms to ensure complete cleanup between tests
+    await new Promise((resolve) => setTimeout(resolve, 2000));
+    // Remove all session files
+    const files = [
+        'DAEMON_PID',
+        'DAEMON_SOCKET',
+        'DAEMON_LOCK',
+        'PID',
+        'LOCK',
+        'METADATA',
+        'OUTPUT',
+    ];
+    for (const file of files) {
+        try {
+            const filePath = getSessionFilePath(file);
+            if (fs.existsSync(filePath)) {
+                fs.unlinkSync(filePath);
+            }
+        }
+        catch {
+            // Ignore errors
+        }
+    }
+}
+/**
+ * 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 function readSessionOutput() {
+    try {
+        const outputPath = getSessionFilePath('OUTPUT');
+        if (!fs.existsSync(outputPath)) {
+            return null;
+        }
+        const content = fs.readFileSync(outputPath, 'utf-8');
+        return JSON.parse(content);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * 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 async function waitForDaemon(timeoutMs = 5000) {
+    const startTime = Date.now();
+    while (Date.now() - startTime < timeoutMs) {
+        if (isDaemonRunning()) {
+            return true;
+        }
+        await new Promise((resolve) => setTimeout(resolve, 100));
+    }
+    return false;
+}
+//# sourceMappingURL=daemonHelpers.js.map

package/dist/__testutils__/daemonHelpers.js.map

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

package/dist/__testutils__/index.d.ts

@@ -12,4 +12,5 @@ export { useFakeClock, type ClockHelper } from './testClock.js';
 export { mockProcessAlive, restoreProcessAlive, isProcessMocked } from './testProcess.js';
 export { assertEventually, assertCDPMessage, assertThrowsAsync } from './assertions.js';
 export { createMockCDPMessage, createMockWebSocketUrl } from './testFixtures.js';
+export { cleanupBdgTest, cleanupPort } from './testCleanup.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/__testutils__/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AACtF,OAAO,EAAE,YAAY,EAAE,KAAK,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAChE,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAC1F,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACxF,OAAO,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/__testutils__/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AACtF,OAAO,EAAE,YAAY,EAAE,KAAK,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAChE,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAC1F,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACxF,OAAO,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AACjF,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/__testutils__/index.js

@@ -12,4 +12,5 @@ export { useFakeClock } from './testClock.js';
 export { mockProcessAlive, restoreProcessAlive, isProcessMocked } from './testProcess.js';
 export { assertEventually, assertCDPMessage, assertThrowsAsync } from './assertions.js';
 export { createMockCDPMessage, createMockWebSocketUrl } from './testFixtures.js';
+export { cleanupBdgTest, cleanupPort } from './testCleanup.js';
 //# sourceMappingURL=index.js.map

package/dist/__testutils__/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/__testutils__/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AACtF,OAAO,EAAE,YAAY,EAAoB,MAAM,gBAAgB,CAAC;AAChE,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAC1F,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACxF,OAAO,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/__testutils__/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AACtF,OAAO,EAAE,YAAY,EAAoB,MAAM,gBAAgB,CAAC;AAChE,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAC1F,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACxF,OAAO,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AACjF,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/__testutils__/testCleanup.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Test cleanup utilities for bdg integration tests
+ *
+ * Provides reusable cleanup functions to ensure Chrome processes and
+ * session files are properly cleaned up between tests.
+ */
+/**
+ * Clean up bdg session and Chrome processes using production cleanup code.
+ *
+ * This function uses bdg's own cleanup mechanisms to ensure tests clean up
+ * the same way production code does. Falls back to aggressive Chrome cleanup
+ * if bdg cleanup fails.
+ *
+ * @remarks
+ * Use this in afterEach() hooks to prevent test pollution and port conflicts.
+ *
+ * @example
+ * ```typescript
+ * import { cleanupBdgTest } from '../__testutils__/testCleanup.js';
+ *
+ * afterEach(async () => {
+ *   await cleanupBdgTest();
+ * });
+ * ```
+ */
+export declare function cleanupBdgTest(): Promise<void>;
+/**
+ * Clean up specific port by killing any process using it.
+ *
+ * Platform-specific implementation using lsof (macOS/Linux) or
+ * netstat (Windows - not yet implemented).
+ *
+ * @param port - Port number to free
+ *
+ * @example
+ * ```typescript
+ * import { cleanupPort } from '../__testutils__/testCleanup.js';
+ *
+ * beforeEach(async () => {
+ *   await cleanupPort(9222); // Ensure port is free before test
+ * });
+ * ```
+ */
+export declare function cleanupPort(port: number): void;
+//# sourceMappingURL=testCleanup.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"testCleanup.d.ts","sourceRoot":"","sources":["../../src/__testutils__/testCleanup.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC,CAyBpD;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAY9C"}

package/dist/__testutils__/testCleanup.js

@@ -0,0 +1,87 @@
+/**
+ * Test cleanup utilities for bdg integration tests
+ *
+ * Provides reusable cleanup functions to ensure Chrome processes and
+ * session files are properly cleaned up between tests.
+ */
+import { execSync } from 'child_process';
+/**
+ * Clean up bdg session and Chrome processes using production cleanup code.
+ *
+ * This function uses bdg's own cleanup mechanisms to ensure tests clean up
+ * the same way production code does. Falls back to aggressive Chrome cleanup
+ * if bdg cleanup fails.
+ *
+ * @remarks
+ * Use this in afterEach() hooks to prevent test pollution and port conflicts.
+ *
+ * @example
+ * ```typescript
+ * import { cleanupBdgTest } from '../__testutils__/testCleanup.js';
+ *
+ * afterEach(async () => {
+ *   await cleanupBdgTest();
+ * });
+ * ```
+ */
+export async function cleanupBdgTest() {
+    try {
+        // First, try normal cleanup
+        execSync('node dist/index.js cleanup --force', {
+            stdio: 'ignore',
+            timeout: 10000,
+        });
+    }
+    catch {
+        // If normal cleanup fails, try aggressive cleanup
+        try {
+            execSync('node dist/index.js cleanup --aggressive', {
+                stdio: 'ignore',
+                timeout: 10000,
+            });
+        }
+        catch {
+            // Last resort: import and use cleanup function directly
+            try {
+                const { cleanupStaleChrome } = await import('../commands/shared/sessionController.js');
+                await cleanupStaleChrome();
+            }
+            catch {
+                // Cleanup failed - log but don't throw to avoid breaking test runner
+                console.error('[testCleanup] All cleanup methods failed');
+            }
+        }
+    }
+}
+/**
+ * Clean up specific port by killing any process using it.
+ *
+ * Platform-specific implementation using lsof (macOS/Linux) or
+ * netstat (Windows - not yet implemented).
+ *
+ * @param port - Port number to free
+ *
+ * @example
+ * ```typescript
+ * import { cleanupPort } from '../__testutils__/testCleanup.js';
+ *
+ * beforeEach(async () => {
+ *   await cleanupPort(9222); // Ensure port is free before test
+ * });
+ * ```
+ */
+export function cleanupPort(port) {
+    try {
+        // Platform-specific cleanup (macOS/Linux only for now)
+        if (process.platform !== 'win32') {
+            execSync(`lsof -ti:${port} | xargs kill -9 2>/dev/null || true`, {
+                stdio: 'ignore',
+                timeout: 5000,
+            });
+        }
+    }
+    catch {
+        // Ignore errors - port may already be free
+    }
+}
+//# sourceMappingURL=testCleanup.js.map

package/dist/__testutils__/testCleanup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"testCleanup.js","sourceRoot":"","sources":["../../src/__testutils__/testCleanup.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc;IAClC,IAAI,CAAC;QACH,4BAA4B;QAC5B,QAAQ,CAAC,oCAAoC,EAAE;YAC7C,KAAK,EAAE,QAAQ;YACf,OAAO,EAAE,KAAK;SACf,CAAC,CAAC;IACL,CAAC;IAAC,MAAM,CAAC;QACP,kDAAkD;QAClD,IAAI,CAAC;YACH,QAAQ,CAAC,yCAAyC,EAAE;gBAClD,KAAK,EAAE,QAAQ;gBACf,OAAO,EAAE,KAAK;aACf,CAAC,CAAC;QACL,CAAC;QAAC,MAAM,CAAC;YACP,wDAAwD;YACxD,IAAI,CAAC;gBACH,MAAM,EAAE,kBAAkB,EAAE,GAAG,MAAM,MAAM,CAAC,wCAAwC,CAAC,CAAC;gBACtF,MAAM,kBAAkB,EAAE,CAAC;YAC7B,CAAC;YAAC,MAAM,CAAC;gBACP,qEAAqE;gBACrE,OAAO,CAAC,KAAK,CAAC,0CAA0C,CAAC,CAAC;YAC5D,CAAC;QACH,CAAC;IACH,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,IAAI,CAAC;QACH,uDAAuD;QACvD,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;YACjC,QAAQ,CAAC,YAAY,IAAI,sCAAsC,EAAE;gBAC/D,KAAK,EAAE,QAAQ;gBACf,OAAO,EAAE,IAAI;aACd,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,2CAA2C;IAC7C,CAAC;AACH,CAAC"}

package/dist/__testutils__/testHome.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Ensure smoke/integration tests use a writable BDG session directory and HOME.
+ *
+ * Some CI/macOS environments block writing to ~/.bdg and ~/Library directly.
+ * We point bdg to a repo-local session directory via BDG_SESSION_DIR and also
+ * override HOME so Chrome's Crashpad can write to ~/Library/Application Support/...
+ * without hitting sandbox restrictions.
+ */
+/**
+ * Set BDG_SESSION_DIR to a deterministic path under the repo and make sure it
+ * exists on disk. Subsequent calls are cheap and return the same path.
+ *
+ * @returns Absolute path used as BDG session directory for tests
+ */
+export declare function ensureTestSessionDir(): string;
+/**
+ * Get a writable HOME directory for tests that shields Chrome from sandbox restrictions.
+ *
+ * macOS workspace sandboxes block writes to ~/Library, causing Chrome's Crashpad to fail
+ * with EPERM errors. By overriding HOME to a repo-local directory, Chrome can safely
+ * write its crash handler settings without hitting the sandbox wall.
+ *
+ * @returns Absolute path to use as HOME for test processes
+ */
+export declare function getTestHomeDir(): string;
+//# sourceMappingURL=testHome.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"testHome.d.ts","sourceRoot":"","sources":["../../src/__testutils__/testHome.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AASH;;;;;GAKG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,CAgB7C;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAkBvC"}