browser-debugger-cli 0.2.0 → 0.5.1

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

package/dist/__testutils__/testHome.js

@@ -0,0 +1,57 @@
+/**
+ * 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.
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import { fileURLToPath } from 'url';
+let cachedSessionDir = null;
+let cachedHomeDir = null;
+/**
+ * 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 function ensureTestSessionDir() {
+    if (cachedSessionDir) {
+        return cachedSessionDir;
+    }
+    const currentDir = path.dirname(fileURLToPath(import.meta.url));
+    const repoRoot = path.resolve(currentDir, '..', '..');
+    const fallbackDir = path.join(repoRoot, '.tmp', 'bdg-smoke-session');
+    const desiredDir = process.env['BDG_TEST_SESSION_DIR'] ?? fallbackDir;
+    fs.mkdirSync(desiredDir, { recursive: true });
+    process.env['BDG_SESSION_DIR'] = desiredDir;
+    cachedSessionDir = desiredDir;
+    return cachedSessionDir;
+}
+/**
+ * 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 function getTestHomeDir() {
+    if (cachedHomeDir) {
+        return cachedHomeDir;
+    }
+    const currentDir = path.dirname(fileURLToPath(import.meta.url));
+    const repoRoot = path.resolve(currentDir, '..', '..');
+    const fallbackDir = path.join(repoRoot, '.tmp', 'bdg-smoke-home');
+    const desiredDir = process.env['BDG_TEST_HOME_DIR'] ?? fallbackDir;
+    fs.mkdirSync(desiredDir, { recursive: true });
+    // Create Library/Application Support structure for Chrome's Crashpad
+    const libraryDir = path.join(desiredDir, 'Library', 'Application Support', 'Google', 'Chrome');
+    fs.mkdirSync(libraryDir, { recursive: true });
+    cachedHomeDir = desiredDir;
+    return cachedHomeDir;
+}
+//# sourceMappingURL=testHome.js.map

package/dist/__testutils__/testHome.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"testHome.js","sourceRoot":"","sources":["../../src/__testutils__/testHome.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AAEpC,IAAI,gBAAgB,GAAkB,IAAI,CAAC;AAC3C,IAAI,aAAa,GAAkB,IAAI,CAAC;AAExC;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB;IAClC,IAAI,gBAAgB,EAAE,CAAC;QACrB,OAAO,gBAAgB,CAAC;IAC1B,CAAC;IAED,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IAChE,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;IACtD,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,mBAAmB,CAAC,CAAC;IAErE,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,sBAAsB,CAAC,IAAI,WAAW,CAAC;IACtE,EAAE,CAAC,SAAS,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAE9C,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,GAAG,UAAU,CAAC;IAE5C,gBAAgB,GAAG,UAAU,CAAC;IAC9B,OAAO,gBAAgB,CAAC;AAC1B,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,cAAc;IAC5B,IAAI,aAAa,EAAE,CAAC;QAClB,OAAO,aAAa,CAAC;IACvB,CAAC;IAED,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IAChE,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;IACtD,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,gBAAgB,CAAC,CAAC;IAElE,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,IAAI,WAAW,CAAC;IACnE,EAAE,CAAC,SAAS,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAE9C,qEAAqE;IACrE,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,SAAS,EAAE,qBAAqB,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAC/F,EAAE,CAAC,SAAS,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAE9C,aAAa,GAAG,UAAU,CAAC;IAC3B,OAAO,aAAa,CAAC;AACvB,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"testProcess.d.ts","sourceRoot":"","sources":["../../src/__testutils__/testProcess.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAIH;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,IAAI,CAwB1D;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,IAAI,IAAI,CAK1C;AAED;;;GAGG;AACH,wBAAgB,eAAe,IAAI,OAAO,CAEzC"}
+{"version":3,"file":"testProcess.d.ts","sourceRoot":"","sources":["../../src/__testutils__/testProcess.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAIH;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,IAAI,CAkC1D;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,IAAI,IAAI,CAK1C;AAED;;;GAGG;AACH,wBAAgB,eAAe,IAAI,OAAO,CAEzC"}

package/dist/__testutils__/testProcess.js

@@ -37,9 +37,10 @@ export function mockProcessAlive(alivePids) {
     originalKill ??= process.kill.bind(process);
     const alivePidSet = new Set(alivePids);
     process.kill = ((pid, signal) => {
+        const normalizedPid = Math.abs(pid);
         // Signal 0 is used to check if process exists (doesn't actually send signal)
         if (signal === 0 || signal === undefined) {
-            if (alivePidSet.has(pid)) {
+            if (alivePidSet.has(normalizedPid)) {
                 // Process is alive - return true
                 return true;
             }
@@ -52,8 +53,15 @@ export function mockProcessAlive(alivePids) {
                 throw err;
             }
         }
-        // For other signals, delegate to original implementation
-        return originalKill(pid, signal);
+        if (!alivePidSet.has(normalizedPid)) {
+            const err = new Error(`kill ESRCH`);
+            err.code = 'ESRCH';
+            err.errno = -3;
+            err.syscall = 'kill';
+            throw err;
+        }
+        alivePidSet.delete(normalizedPid);
+        return true;
     });
 }
 /**

package/dist/__testutils__/testProcess.js.map

@@ -1 +1 @@
-{"version":3,"file":"testProcess.js","sourceRoot":"","sources":["../../src/__testutils__/testProcess.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,IAAI,YAAY,GAA+B,IAAI,CAAC;AAEpD;;;;;;;;GAQG;AACH,MAAM,UAAU,gBAAgB,CAAC,SAAmB;IAClD,oFAAoF;IACpF,YAAY,KAAK,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAE5C,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,SAAS,CAAC,CAAC;IAEvC,OAAO,CAAC,IAAI,GAAG,CAAC,CAAC,GAAW,EAAE,MAAgC,EAAE,EAAE;QAChE,6EAA6E;QAC7E,IAAI,MAAM,KAAK,CAAC,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzC,IAAI,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;gBACzB,iCAAiC;gBACjC,OAAO,IAAI,CAAC;YACd,CAAC;iBAAM,CAAC;gBACN,+DAA+D;gBAC/D,MAAM,GAAG,GAAG,IAAI,KAAK,CAAC,YAAY,CAA0B,CAAC;gBAC7D,GAAG,CAAC,IAAI,GAAG,OAAO,CAAC;gBACnB,GAAG,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;gBACf,GAAG,CAAC,OAAO,GAAG,MAAM,CAAC;gBACrB,MAAM,GAAG,CAAC;YACZ,CAAC;QACH,CAAC;QACD,yDAAyD;QACzD,OAAQ,YAAoC,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IAC5D,CAAC,CAAwB,CAAC;AAC5B,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,mBAAmB;IACjC,IAAI,YAAY,KAAK,IAAI,EAAE,CAAC;QAC1B,OAAO,CAAC,IAAI,GAAG,YAAY,CAAC;QAC5B,YAAY,GAAG,IAAI,CAAC;IACtB,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe;IAC7B,OAAO,YAAY,KAAK,IAAI,CAAC;AAC/B,CAAC"}
+{"version":3,"file":"testProcess.js","sourceRoot":"","sources":["../../src/__testutils__/testProcess.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,IAAI,YAAY,GAA+B,IAAI,CAAC;AAEpD;;;;;;;;GAQG;AACH,MAAM,UAAU,gBAAgB,CAAC,SAAmB;IAClD,oFAAoF;IACpF,YAAY,KAAK,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAE5C,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,SAAS,CAAC,CAAC;IAEvC,OAAO,CAAC,IAAI,GAAG,CAAC,CAAC,GAAW,EAAE,MAAgC,EAAE,EAAE;QAChE,MAAM,aAAa,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACpC,6EAA6E;QAC7E,IAAI,MAAM,KAAK,CAAC,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzC,IAAI,WAAW,CAAC,GAAG,CAAC,aAAa,CAAC,EAAE,CAAC;gBACnC,iCAAiC;gBACjC,OAAO,IAAI,CAAC;YACd,CAAC;iBAAM,CAAC;gBACN,+DAA+D;gBAC/D,MAAM,GAAG,GAAG,IAAI,KAAK,CAAC,YAAY,CAA0B,CAAC;gBAC7D,GAAG,CAAC,IAAI,GAAG,OAAO,CAAC;gBACnB,GAAG,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;gBACf,GAAG,CAAC,OAAO,GAAG,MAAM,CAAC;gBACrB,MAAM,GAAG,CAAC;YACZ,CAAC;QACH,CAAC;QAED,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,aAAa,CAAC,EAAE,CAAC;YACpC,MAAM,GAAG,GAAG,IAAI,KAAK,CAAC,YAAY,CAA0B,CAAC;YAC7D,GAAG,CAAC,IAAI,GAAG,OAAO,CAAC;YACnB,GAAG,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;YACf,GAAG,CAAC,OAAO,GAAG,MAAM,CAAC;YACrB,MAAM,GAAG,CAAC;QACZ,CAAC;QAED,WAAW,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;QAClC,OAAO,IAAI,CAAC;IACd,CAAC,CAAwB,CAAC;AAC5B,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,mBAAmB;IACjC,IAAI,YAAY,KAAK,IAAI,EAAE,CAAC;QAC1B,OAAO,CAAC,IAAI,GAAG,YAAY,CAAC;QAC5B,YAAY,GAAG,IAAI,CAAC;IACtB,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe;IAC7B,OAAO,YAAY,KAAK,IAAI,CAAC;AAC/B,CAAC"}

package/dist/cli/commands/__tests__/start.unit.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=start.unit.test.d.ts.map

package/dist/cli/commands/__tests__/start.unit.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"start.unit.test.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/__tests__/start.unit.test.ts"],"names":[],"mappings":""}

package/dist/cli/commands/__tests__/start.unit.test.js

@@ -0,0 +1,131 @@
+import assert from 'node:assert/strict';
+import { describe, it } from 'node:test';
+import { validateCollectorFlags, resolveCollectors } from '../../commands/start.js';
+/**
+ * Unit tests for collector flag validation and resolution
+ */
+void describe('validateCollectorFlags', () => {
+    void it('should not throw when no collector flags are provided', () => {
+        assert.doesNotThrow(() => {
+            validateCollectorFlags({ port: '9222' });
+        });
+    });
+    void it('should not throw when only additive flags are provided', () => {
+        assert.doesNotThrow(() => {
+            validateCollectorFlags({ port: '9222', dom: true, network: true });
+        });
+    });
+    void it('should not throw when only subtractive flags are provided', () => {
+        assert.doesNotThrow(() => {
+            validateCollectorFlags({ port: '9222', skipDom: true });
+        });
+    });
+    void it('should throw when --dom and --skip-dom are both provided', () => {
+        assert.throws(() => {
+            validateCollectorFlags({ port: '9222', dom: true, skipDom: true });
+        }, {
+            name: 'Error',
+            message: /Conflicting collector flags detected: --dom and --skip-dom/,
+        });
+    });
+    void it('should throw when --network and --skip-network are both provided', () => {
+        assert.throws(() => {
+            validateCollectorFlags({ port: '9222', network: true, skipNetwork: true });
+        }, {
+            name: 'Error',
+            message: /Conflicting collector flags detected: --network and --skip-network/,
+        });
+    });
+    void it('should throw when --console and --skip-console are both provided', () => {
+        assert.throws(() => {
+            validateCollectorFlags({ port: '9222', console: true, skipConsole: true });
+        }, {
+            name: 'Error',
+            message: /Conflicting collector flags detected: --console and --skip-console/,
+        });
+    });
+    void it('should throw when multiple conflicts are present', () => {
+        assert.throws(() => {
+            validateCollectorFlags({
+                port: '9222',
+                dom: true,
+                skipDom: true,
+                network: true,
+                skipNetwork: true,
+            });
+        }, {
+            name: 'Error',
+            message: /Conflicting collector flags detected.*--dom and --skip-dom.*--network and --skip-network/s,
+        });
+    });
+});
+void describe('resolveCollectors', () => {
+    void it('should return all collectors when no flags are provided', () => {
+        const collectors = resolveCollectors({ port: '9222' });
+        assert.deepEqual(collectors, ['dom', 'network', 'console']);
+    });
+    void it('should return only dom when --dom is provided', () => {
+        const collectors = resolveCollectors({ port: '9222', dom: true });
+        assert.deepEqual(collectors, ['dom']);
+    });
+    void it('should return only network when --network is provided', () => {
+        const collectors = resolveCollectors({ port: '9222', network: true });
+        assert.deepEqual(collectors, ['network']);
+    });
+    void it('should return only console when --console is provided', () => {
+        const collectors = resolveCollectors({ port: '9222', console: true });
+        assert.deepEqual(collectors, ['console']);
+    });
+    void it('should return dom and network when both additive flags are provided', () => {
+        const collectors = resolveCollectors({ port: '9222', dom: true, network: true });
+        assert.deepEqual(collectors, ['dom', 'network']);
+    });
+    void it('should return all three when all additive flags are provided', () => {
+        const collectors = resolveCollectors({
+            port: '9222',
+            dom: true,
+            network: true,
+            console: true,
+        });
+        assert.deepEqual(collectors, ['dom', 'network', 'console']);
+    });
+    void it('should exclude dom when --skip-dom is provided', () => {
+        const collectors = resolveCollectors({ port: '9222', skipDom: true });
+        assert.deepEqual(collectors, ['network', 'console']);
+    });
+    void it('should exclude network when --skip-network is provided', () => {
+        const collectors = resolveCollectors({ port: '9222', skipNetwork: true });
+        assert.deepEqual(collectors, ['dom', 'console']);
+    });
+    void it('should exclude console when --skip-console is provided', () => {
+        const collectors = resolveCollectors({ port: '9222', skipConsole: true });
+        assert.deepEqual(collectors, ['dom', 'network']);
+    });
+    void it('should exclude multiple collectors when multiple --skip-* flags are provided', () => {
+        const collectors = resolveCollectors({
+            port: '9222',
+            skipDom: true,
+            skipNetwork: true,
+        });
+        assert.deepEqual(collectors, ['console']);
+    });
+    void it('should return empty array when all collectors are disabled', () => {
+        const collectors = resolveCollectors({
+            port: '9222',
+            skipDom: true,
+            skipNetwork: true,
+            skipConsole: true,
+        });
+        assert.deepEqual(collectors, []);
+    });
+    void it('should prioritize additive flags over subtractive flags', () => {
+        // When additive flags are present, subtractive flags should be ignored
+        const collectors = resolveCollectors({
+            port: '9222',
+            dom: true,
+            skipConsole: true, // Should be ignored because additive flag is present
+        });
+        assert.deepEqual(collectors, ['dom']);
+    });
+});
+//# sourceMappingURL=start.unit.test.js.map