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

package/dist/ipc/__tests__/client.contract.test.js

@@ -0,0 +1,466 @@
+/**
+ * IPC Client Contract Tests
+ *
+ * Tests the public API behavior of IPC client functions WITHOUT testing implementation details.
+ * Follows the testing philosophy: "Test the contract, not the implementation"
+ *
+ * Contract:
+ * - Input: Function calls with parameters
+ * - Output: Responses from daemon via Unix socket
+ * - Behavior: Connect, send request, receive response, handle errors/timeouts
+ *
+ * What we test:
+ * ✅ Behavior: Client function calls → daemon responses
+ * ✅ Invariants: "Requests receive responses", "Errors propagate correctly"
+ * ✅ Edge cases: Daemon not running, timeouts, malformed responses
+ *
+ * What we DON'T test:
+ * ❌ Internal sendRequest() implementation
+ * ❌ Socket buffer handling details
+ * ❌ How JSONL parsing works internally
+ */
+import assert from 'node:assert/strict';
+import * as fs from 'node:fs';
+import * as net from 'node:net';
+import * as os from 'node:os';
+import * as path from 'node:path';
+import { afterEach, beforeEach, describe, it } from 'node:test';
+import * as ipcClient from '../client.js';
+/**
+ * Mock daemon server that responds to IPC requests.
+ * Simulates daemon behavior without starting actual worker processes.
+ */
+class MockDaemonServer {
+    server = null;
+    socketPath;
+    clients = [];
+    /**
+     * Behavior modes for testing different scenarios
+     */
+    mode = 'normal'; // Close connection before sending response
+    constructor(socketPath) {
+        this.socketPath = socketPath;
+    }
+    /**
+     * Start mock daemon server
+     */
+    async start() {
+        return new Promise((resolve, reject) => {
+            // Remove existing socket if present
+            try {
+                fs.unlinkSync(this.socketPath);
+            }
+            catch {
+                // Ignore - socket may not exist
+            }
+            this.server = net.createServer((socket) => {
+                this.clients.push(socket);
+                let buffer = '';
+                socket.on('data', (chunk) => {
+                    buffer += chunk.toString('utf-8');
+                    // Process complete JSONL frames
+                    const lines = buffer.split('\n');
+                    buffer = lines.pop() ?? '';
+                    for (const line of lines) {
+                        if (line.trim()) {
+                            this.handleRequest(socket, line);
+                        }
+                    }
+                });
+                socket.on('error', () => {
+                    // Ignore client errors
+                });
+            });
+            this.server.listen(this.socketPath, () => {
+                resolve();
+            });
+            this.server.on('error', reject);
+        });
+    }
+    /**
+     * Handle incoming request and send appropriate response
+     */
+    handleRequest(socket, line) {
+        try {
+            const request = JSON.parse(line);
+            // Handle different behavior modes
+            switch (this.mode) {
+                case 'slow':
+                    // Delay response (useful for timeout testing)
+                    setTimeout(() => {
+                        this.sendNormalResponse(socket, request);
+                    }, 10000); // 10s delay (longer than 5s client timeout)
+                    break;
+                case 'malformed':
+                    // Send invalid JSON
+                    socket.write('{"invalid": json}\n');
+                    break;
+                case 'error':
+                    // Send error response
+                    this.sendErrorResponse(socket, request);
+                    break;
+                case 'silent':
+                    // Don't send any response
+                    break;
+                case 'close_early':
+                    // Close connection immediately
+                    socket.end();
+                    break;
+                case 'normal':
+                    this.sendNormalResponse(socket, request);
+                    break;
+            }
+        }
+        catch {
+            // Invalid JSON in request - send error response
+            socket.write(JSON.stringify({
+                type: 'error_response',
+                sessionId: 'unknown',
+                status: 'error',
+                error: 'Invalid request JSON',
+            }) + '\n');
+        }
+    }
+    /**
+     * Send normal successful response
+     */
+    sendNormalResponse(socket, request) {
+        if (request.type === 'handshake_request') {
+            const response = {
+                type: 'handshake_response',
+                sessionId: request.sessionId,
+                status: 'ok',
+                message: 'Mock daemon connected',
+            };
+            socket.write(JSON.stringify(response) + '\n');
+        }
+        else if (request.type === 'status_request') {
+            const response = {
+                type: 'status_response',
+                sessionId: request.sessionId,
+                status: 'ok',
+                data: {
+                    daemonPid: process.pid,
+                    daemonStartTime: Date.now(),
+                    socketPath: this.socketPath,
+                },
+            };
+            socket.write(JSON.stringify(response) + '\n');
+        }
+    }
+    /**
+     * Send error response
+     */
+    sendErrorResponse(socket, request) {
+        const response = {
+            type: request.type.replace('_request', '_response'),
+            sessionId: request.sessionId,
+            status: 'error',
+            error: 'Mock daemon error',
+        };
+        socket.write(JSON.stringify(response) + '\n');
+    }
+    /**
+     * Stop mock daemon server
+     */
+    async stop() {
+        return new Promise((resolve) => {
+            // Close all client connections
+            for (const client of this.clients) {
+                client.end();
+            }
+            this.clients = [];
+            if (this.server) {
+                this.server.close(() => {
+                    // Remove socket file
+                    try {
+                        fs.unlinkSync(this.socketPath);
+                    }
+                    catch {
+                        // Ignore - socket may not exist
+                    }
+                    resolve();
+                });
+            }
+            else {
+                resolve();
+            }
+        });
+    }
+}
+void describe('IPC Client Contract Tests', () => {
+    let mockDaemon;
+    let tmpDir;
+    let originalHome;
+    let originalUserProfile;
+    let socketPath;
+    beforeEach(async () => {
+        // Create temp directory for socket
+        tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), 'bdg-ipc-client-test-'));
+        // Override HOME to use temp directory
+        originalHome = process.env['HOME'];
+        originalUserProfile = process.env['USERPROFILE'];
+        process.env['HOME'] = tmpDir;
+        if (process.platform === 'win32') {
+            process.env['USERPROFILE'] = tmpDir;
+        }
+        // Create .bdg directory
+        const bdgDir = path.join(tmpDir, '.bdg');
+        fs.mkdirSync(bdgDir, { recursive: true });
+        // Get socket path (matches IPCServer.getSocketPath())
+        socketPath = path.join(bdgDir, 'daemon.sock');
+        // Start mock daemon
+        mockDaemon = new MockDaemonServer(socketPath);
+        await mockDaemon.start();
+    });
+    afterEach(async () => {
+        // Stop mock daemon
+        if (mockDaemon) {
+            await mockDaemon.stop();
+        }
+        // Restore environment
+        if (originalHome !== undefined) {
+            process.env['HOME'] = originalHome;
+        }
+        else {
+            delete process.env['HOME'];
+        }
+        if (originalUserProfile !== undefined) {
+            process.env['USERPROFILE'] = originalUserProfile;
+        }
+        else {
+            delete process.env['USERPROFILE'];
+        }
+        // Cleanup temp directory
+        try {
+            fs.rmSync(tmpDir, { recursive: true, force: true });
+        }
+        catch {
+            // Ignore cleanup errors
+        }
+    });
+    void describe('connectToDaemon()', () => {
+        void it('connects to daemon and receives handshake response', async () => {
+            // Test the CONTRACT: Client connects → daemon responds
+            const response = await ipcClient.connectToDaemon();
+            // Verify response structure (contract)
+            assert.equal(response.type, 'handshake_response');
+            assert.equal(response.status, 'ok');
+            assert.ok(response.sessionId); // Should have a session ID
+            assert.ok(response.message); // Should have a message
+        });
+        void it('throws error when daemon is not running', async () => {
+            // Stop daemon to simulate not running
+            await mockDaemon.stop();
+            // Test the CONTRACT: No daemon → connection error
+            await assert.rejects(async () => {
+                await ipcClient.connectToDaemon();
+            }, {
+                name: 'Error',
+                message: /Connection error/,
+            });
+        });
+        void it('throws error on timeout (5s)', async () => {
+            // Configure mock daemon to be slow (10s delay)
+            mockDaemon.mode = 'slow';
+            // Test the CONTRACT: Slow response → timeout error
+            await assert.rejects(async () => {
+                await ipcClient.connectToDaemon();
+            }, {
+                name: 'Error',
+                message: /handshake request timeout after 5s/,
+            });
+        });
+        void it('throws error on malformed response', async () => {
+            // Configure mock daemon to send invalid JSON
+            mockDaemon.mode = 'malformed';
+            // Test the CONTRACT: Invalid JSON → parse error
+            await assert.rejects(async () => {
+                await ipcClient.connectToDaemon();
+            }, {
+                name: 'Error',
+                message: /Failed to parse handshake response/,
+            });
+        });
+        void it('throws error when connection closes early', async () => {
+            // Configure mock daemon to close connection immediately
+            mockDaemon.mode = 'close_early';
+            // Test the CONTRACT: Early close → connection closed error
+            await assert.rejects(async () => {
+                await ipcClient.connectToDaemon();
+            }, {
+                name: 'Error',
+                message: /Connection closed before handshake response received/,
+            });
+        });
+    });
+    void describe('getStatus()', () => {
+        void it('requests status and receives response', async () => {
+            // Test the CONTRACT: Status request → status response
+            const response = await ipcClient.getStatus();
+            // Verify response structure (contract)
+            assert.equal(response.type, 'status_response');
+            assert.equal(response.status, 'ok');
+            assert.ok(response.data);
+            assert.ok(response.data.daemonPid);
+            assert.ok(response.data.socketPath);
+        });
+        void it('throws error when daemon is not running', async () => {
+            // Stop daemon
+            await mockDaemon.stop();
+            // Test the CONTRACT: No daemon → connection error
+            await assert.rejects(async () => {
+                await ipcClient.getStatus();
+            }, {
+                name: 'Error',
+                message: /Connection error/,
+            });
+        });
+        void it('throws error on timeout', async () => {
+            // Configure mock daemon to be slow
+            mockDaemon.mode = 'slow';
+            // Test the CONTRACT: Slow response → timeout
+            await assert.rejects(async () => {
+                await ipcClient.getStatus();
+            }, {
+                name: 'Error',
+                message: /status request timeout after 5s/,
+            });
+        });
+        void it('propagates daemon errors', async () => {
+            // Configure mock daemon to send error response
+            mockDaemon.mode = 'error';
+            // Test the CONTRACT: Daemon error → client receives error
+            // Note: Current implementation doesn't check status in response
+            // This test documents current behavior
+            const response = await ipcClient.getStatus();
+            assert.equal(response.status, 'error');
+        });
+    });
+    void describe('Socket cleanup', () => {
+        void it('cleans up socket after successful response', async () => {
+            // First request
+            await ipcClient.connectToDaemon();
+            // Second request should work (socket was cleaned up)
+            const response = await ipcClient.getStatus();
+            assert.equal(response.status, 'ok');
+            // Third request should also work
+            const response2 = await ipcClient.connectToDaemon();
+            assert.equal(response2.status, 'ok');
+        });
+        void it('cleans up socket after error', async () => {
+            // Configure daemon to send malformed response
+            mockDaemon.mode = 'malformed';
+            // First request fails
+            await assert.rejects(async () => {
+                await ipcClient.connectToDaemon();
+            });
+            // Reset to normal mode
+            mockDaemon.mode = 'normal';
+            // Second request should work (socket was cleaned up despite error)
+            const response = await ipcClient.getStatus();
+            assert.equal(response.status, 'ok');
+        });
+        void it('cleans up socket after timeout', async () => {
+            // Configure daemon to be slow (causes timeout)
+            mockDaemon.mode = 'slow';
+            // First request times out
+            await assert.rejects(async () => {
+                await ipcClient.connectToDaemon();
+            });
+            // Reset to normal mode
+            mockDaemon.mode = 'normal';
+            // Second request should work (socket was cleaned up after timeout)
+            const response = await ipcClient.getStatus();
+            assert.equal(response.status, 'ok');
+        });
+    });
+    void describe('Concurrent requests', () => {
+        void it('handles multiple concurrent requests', async () => {
+            // Test the INVARIANT: Multiple concurrent requests all succeed
+            const requests = [
+                ipcClient.connectToDaemon(),
+                ipcClient.getStatus(),
+                ipcClient.connectToDaemon(),
+                ipcClient.getStatus(),
+            ];
+            const responses = await Promise.all(requests);
+            // Verify all requests succeeded
+            assert.equal(responses.length, 4);
+            assert.equal(responses[0]?.type, 'handshake_response');
+            assert.equal(responses[1]?.type, 'status_response');
+            assert.equal(responses[2]?.type, 'handshake_response');
+            assert.equal(responses[3]?.type, 'status_response');
+        });
+        void it('handles mixed success/failure in concurrent requests', async () => {
+            // Configure daemon to send error responses
+            mockDaemon.mode = 'error';
+            // Mix of requests that will all get errors
+            const requests = [ipcClient.getStatus(), ipcClient.connectToDaemon()];
+            const responses = await Promise.all(requests);
+            // Both should receive error responses
+            assert.equal(responses[0]?.status, 'error');
+            assert.equal(responses[1]?.status, 'error');
+            // Reset to normal mode and verify recovery
+            mockDaemon.mode = 'normal';
+            const recovery = await ipcClient.getStatus();
+            assert.equal(recovery.status, 'ok');
+        });
+    });
+    void describe('JSONL protocol', () => {
+        void it('handles requests with unique session IDs', async () => {
+            // Test the PROPERTY: Each request has unique session ID
+            const response1 = await ipcClient.connectToDaemon();
+            const response2 = await ipcClient.connectToDaemon();
+            // Session IDs should be different (UUID random)
+            assert.notEqual(response1.sessionId, response2.sessionId);
+        });
+        void it('preserves session ID in response', async () => {
+            // Test the INVARIANT: Response sessionId matches request sessionId
+            // This is tested implicitly by the mock daemon echoing back sessionId
+            const response = await ipcClient.getStatus();
+            // Mock daemon echoes sessionId, so if we get a response, it matched
+            assert.ok(response.sessionId);
+            assert.equal(typeof response.sessionId, 'string');
+        });
+    });
+    void describe('Error handling edge cases', () => {
+        void it('handles silent daemon (no response)', async () => {
+            // Configure daemon to receive but not respond
+            mockDaemon.mode = 'silent';
+            // Test the CONTRACT: No response → timeout
+            await assert.rejects(async () => {
+                await ipcClient.getStatus();
+            }, {
+                name: 'Error',
+                message: /status request timeout after 5s/,
+            });
+        });
+        void it('handles partial response followed by close', async () => {
+            // Create custom mock that sends partial JSON
+            await mockDaemon.stop();
+            const partialServer = net.createServer((socket) => {
+                socket.on('data', () => {
+                    // Send incomplete JSON and close
+                    socket.write('{"type": "status');
+                    socket.end();
+                });
+            });
+            await new Promise((resolve) => {
+                partialServer.listen(socketPath, resolve);
+            });
+            // Test the CONTRACT: Partial response → connection closed error
+            await assert.rejects(async () => {
+                await ipcClient.getStatus();
+            }, {
+                name: 'Error',
+                message: /Connection closed before status response received/,
+            });
+            // Cleanup
+            await new Promise((resolve) => {
+                partialServer.close(() => resolve());
+            });
+        });
+    });
+});
+//# sourceMappingURL=client.contract.test.js.map

package/dist/ipc/__tests__/client.contract.test.js.map

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

package/dist/ipc/client.d.ts

@@ -0,0 +1,109 @@
+/**
+ * IPC Client - Minimal JSONL handshake MVP
+ *
+ * Connects to the daemon's Unix domain socket and performs handshake.
+ */
+import { type ClientResponse } from './commands.js';
+import type { HandshakeResponse, PeekResponse, StartSessionResponse, StatusResponse, StopSessionResponse } from './types.js';
+import type { CollectorType } from '@/types.js';
+/**
+ * Connect to the daemon and perform handshake.
+ *
+ * @returns Handshake response from daemon
+ * @throws Error if connection fails or handshake times out
+ */
+export declare function connectToDaemon(): Promise<HandshakeResponse>;
+/**
+ * Request status information from the daemon.
+ *
+ * @returns Status response with daemon and session metadata
+ * @throws Error if connection fails, daemon is not running, or request times out
+ */
+export declare function getStatus(): Promise<StatusResponse>;
+/**
+ * Request preview data from the daemon.
+ *
+ * @returns Peek response with session preview data
+ * @throws Error if connection fails, daemon is not running, or request times out
+ */
+export declare function getPeek(): Promise<PeekResponse>;
+/**
+ * Request daemon to start a new browser session.
+ *
+ * @param url - Target URL to navigate to
+ * @param options - Session configuration options
+ * @returns Start session response with worker and Chrome metadata
+ * @throws Error if connection fails, daemon is not running, or request times out
+ */
+export declare function startSession(url: string, options?: {
+    port?: number;
+    timeout?: number;
+    collectors?: CollectorType[];
+    includeAll?: boolean;
+    userDataDir?: string;
+    maxBodySize?: number;
+}): Promise<StartSessionResponse>;
+/**
+ * Request session stop from the daemon.
+ *
+ * @returns Stop session response with success/error status
+ * @throws Error if connection fails, daemon is not running, or request times out
+ */
+export declare function stopSession(): Promise<StopSessionResponse>;
+/**
+ * Query DOM elements by CSS selector via the daemon's worker.
+ *
+ * @param selector - CSS selector to query
+ * @returns DOM query response with matched elements
+ * @throws Error if connection fails, daemon is not running, or request times out
+ */
+export declare function queryDOM(selector: string): Promise<ClientResponse<'dom_query'>>;
+/**
+ * Highlight DOM elements in the browser via the daemon's worker.
+ *
+ * @param options - Highlight options (selector, index, nodeId, color, etc.)
+ * @returns DOM highlight response with highlighted node information
+ * @throws Error if connection fails, daemon is not running, or request times out
+ */
+export declare function highlightDOM(options: {
+    selector?: string;
+    index?: number;
+    nodeId?: number;
+    first?: boolean;
+    nth?: number;
+    color?: string;
+    opacity?: number;
+}): Promise<ClientResponse<'dom_highlight'>>;
+/**
+ * Get full HTML and attributes for DOM elements via the daemon's worker.
+ *
+ * @param options - Get options (selector, index, nodeId, all, nth)
+ * @returns DOM get response with node information
+ * @throws Error if connection fails, daemon is not running, or request times out
+ */
+export declare function getDOM(options: {
+    selector?: string;
+    index?: number;
+    nodeId?: number;
+    all?: boolean;
+    nth?: number;
+}): Promise<ClientResponse<'dom_get'>>;
+/**
+ * Get details for a specific network request or console message via the daemon's worker.
+ *
+ * @param type - Type of item: 'network' or 'console'
+ * @param id - Request ID for network, index for console
+ * @returns Worker details response with full object (including bodies/args)
+ * @throws Error if connection fails, daemon is not running, or request times out
+ */
+export declare function getDetails(type: 'network' | 'console', id: string): Promise<ClientResponse<'worker_details'>>;
+/**
+ * Execute arbitrary CDP method via the daemon's worker.
+ *
+ * @param method - CDP method name (e.g., 'Network.getCookies', 'Runtime.evaluate')
+ * @param params - CDP method parameters (optional)
+ * @returns CDP call response with method result
+ * @throws Error if connection fails, daemon is not running, or request times out
+ */
+export declare function callCDP(method: string, params?: Record<string, unknown>): Promise<ClientResponse<'cdp_call'>>;
+//# sourceMappingURL=client.d.ts.map

package/dist/ipc/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/ipc/client.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AASH,OAAO,EAAwC,KAAK,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAC9F,OAAO,KAAK,EAEV,iBAAiB,EAEjB,YAAY,EAEZ,oBAAoB,EAEpB,cAAc,EAEd,mBAAmB,EACpB,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAuFhD;;;;;GAKG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC,iBAAiB,CAAC,CAOlE;AAED;;;;;GAKG;AACH,wBAAsB,SAAS,IAAI,OAAO,CAAC,cAAc,CAAC,CAOzD;AAED;;;;;GAKG;AACH,wBAAsB,OAAO,IAAI,OAAO,CAAC,YAAY,CAAC,CAOrD;AAED;;;;;;;GAOG;AACH,wBAAsB,YAAY,CAChC,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE;IACR,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,aAAa,EAAE,CAAC;IAC7B,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,GACA,OAAO,CAAC,oBAAoB,CAAC,CAc/B;AAED;;;;;GAKG;AACH,wBAAsB,WAAW,IAAI,OAAO,CAAC,mBAAmB,CAAC,CAOhE;AAsBD;;;;;;GAMG;AACH,wBAAsB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,WAAW,CAAC,CAAC,CAErF;AAED;;;;;;GAMG;AACH,wBAAsB,YAAY,CAAC,OAAO,EAAE;IAC1C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,GAAG,OAAO,CAAC,cAAc,CAAC,eAAe,CAAC,CAAC,CAE3C;AAED;;;;;;GAMG;AACH,wBAAsB,MAAM,CAAC,OAAO,EAAE;IACpC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,GAAG,OAAO,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC,CAErC;AAED;;;;;;;GAOG;AACH,wBAAsB,UAAU,CAC9B,IAAI,EAAE,SAAS,GAAG,SAAS,EAC3B,EAAE,EAAE,MAAM,GACT,OAAO,CAAC,cAAc,CAAC,gBAAgB,CAAC,CAAC,CAE3C;AAED;;;;;;;GAOG;AACH,wBAAsB,OAAO,CAC3B,MAAM,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B,OAAO,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC,CAErC"}