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

package/dist/ipc/client.js

@@ -0,0 +1,220 @@
+/**
+ * IPC Client - Minimal JSONL handshake MVP
+ *
+ * Connects to the daemon's Unix domain socket and performs handshake.
+ */
+import { randomUUID } from 'crypto';
+import { connect } from 'net';
+import { IPCServer } from '../daemon/ipcServer.js';
+import { getErrorMessage } from '../utils/errors.js';
+/**
+ * Generic IPC request sender that handles connection, timeout, and error handling.
+ * Supports both traditional IPC messages (handshake, status, etc.) and command messages (DOM commands).
+ *
+ * @param request - The IPC request to send (either IPCRequest or ClientRequest<T>)
+ * @param requestName - Human-readable name for logging (e.g., 'status', 'peek')
+ * @returns Promise that resolves with the response
+ */
+async function sendRequest(request, requestName) {
+    const socketPath = IPCServer.getSocketPath();
+    return new Promise((resolve, reject) => {
+        const socket = connect(socketPath);
+        let buffer = '';
+        let resolved = false;
+        // Set request timeout
+        const timeout = setTimeout(() => {
+            if (!resolved) {
+                resolved = true;
+                socket.destroy();
+                reject(new Error(`${requestName} request timeout after 5s`));
+            }
+        }, 5000);
+        socket.on('connect', () => {
+            console.error(`[client] Connected to daemon for ${requestName} request`);
+            socket.write(JSON.stringify(request) + '\n');
+            console.error(`[client] ${requestName} request sent`);
+        });
+        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() && !resolved) {
+                    try {
+                        const response = JSON.parse(line);
+                        console.error(`[client] ${requestName} response received`);
+                        resolved = true;
+                        clearTimeout(timeout);
+                        socket.destroy();
+                        resolve(response);
+                    }
+                    catch (error) {
+                        if (!resolved) {
+                            resolved = true;
+                            clearTimeout(timeout);
+                            socket.destroy();
+                            reject(new Error(`Failed to parse ${requestName} response: ${getErrorMessage(error)}`));
+                        }
+                    }
+                }
+            }
+        });
+        socket.on('error', (err) => {
+            if (!resolved) {
+                resolved = true;
+                clearTimeout(timeout);
+                reject(new Error(`Connection error: ${err.message}`));
+            }
+        });
+        socket.on('end', () => {
+            if (!resolved) {
+                resolved = true;
+                clearTimeout(timeout);
+                reject(new Error(`Connection closed before ${requestName} response received`));
+            }
+        });
+    });
+}
+/**
+ * Connect to the daemon and perform handshake.
+ *
+ * @returns Handshake response from daemon
+ * @throws Error if connection fails or handshake times out
+ */
+export async function connectToDaemon() {
+    const request = {
+        type: 'handshake_request',
+        sessionId: randomUUID(),
+    };
+    return sendRequest(request, 'handshake');
+}
+/**
+ * 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 async function getStatus() {
+    const request = {
+        type: 'status_request',
+        sessionId: randomUUID(),
+    };
+    return sendRequest(request, 'status');
+}
+/**
+ * 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 async function getPeek() {
+    const request = {
+        type: 'peek_request',
+        sessionId: randomUUID(),
+    };
+    return sendRequest(request, 'peek');
+}
+/**
+ * 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 async function startSession(url, options) {
+    const request = {
+        type: 'start_session_request',
+        sessionId: randomUUID(),
+        url,
+        ...(options?.port !== undefined && { port: options.port }),
+        ...(options?.timeout !== undefined && { timeout: options.timeout }),
+        ...(options?.collectors !== undefined && { collectors: options.collectors }),
+        ...(options?.includeAll !== undefined && { includeAll: options.includeAll }),
+        ...(options?.userDataDir !== undefined && { userDataDir: options.userDataDir }),
+        ...(options?.maxBodySize !== undefined && { maxBodySize: options.maxBodySize }),
+    };
+    return sendRequest(request, 'start session');
+}
+/**
+ * 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 async function stopSession() {
+    const request = {
+        type: 'stop_session_request',
+        sessionId: randomUUID(),
+    };
+    return sendRequest(request, 'stop session');
+}
+/**
+ * Generic command sender - works for any registered command in the COMMANDS registry.
+ *
+ * @param commandName - Name of the command from the COMMANDS registry
+ * @param params - Command parameters matching the command's request schema
+ * @returns Promise that resolves with the command response
+ */
+async function sendCommand(commandName, params) {
+    const request = {
+        type: `${commandName}_request`,
+        sessionId: randomUUID(),
+        ...params,
+    };
+    return sendRequest(request, commandName);
+}
+/**
+ * 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 async function queryDOM(selector) {
+    return sendCommand('dom_query', { selector });
+}
+/**
+ * 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 async function highlightDOM(options) {
+    return sendCommand('dom_highlight', options);
+}
+/**
+ * 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 async function getDOM(options) {
+    return sendCommand('dom_get', options);
+}
+/**
+ * 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 async function getDetails(type, id) {
+    return sendCommand('worker_details', { itemType: type, id });
+}
+/**
+ * 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 async function callCDP(method, params) {
+    return sendCommand('cdp_call', { method, ...(params && { params }) });
+}
+//# sourceMappingURL=client.js.map

package/dist/ipc/client.js.map

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

package/dist/ipc/commands.d.ts

@@ -0,0 +1,208 @@
+/**
+ * Unified Command Registry - Single Source of Truth
+ *
+ * This file defines all IPC commands and their schemas. Command types are defined once here,
+ * and utility types add sessionId/requestId at the boundaries (client/worker).
+ *
+ * Benefits:
+ * - No type duplication between client and worker
+ * - Adding a new command only requires updating this file and the handler
+ * - Type safety maintained throughout the stack
+ */
+/**
+ * DOM Query Command - Find elements by CSS selector
+ */
+export interface DomQueryCommand {
+    selector: string;
+}
+export interface DomQueryData {
+    selector: string;
+    count: number;
+    nodes: Array<{
+        index: number;
+        nodeId: number;
+        tag?: string;
+        classes?: string[];
+        preview?: string;
+    }>;
+}
+/**
+ * DOM Highlight Command - Highlight elements in browser
+ */
+export interface DomHighlightCommand {
+    selector?: string;
+    index?: number;
+    nodeId?: number;
+    first?: boolean;
+    nth?: number;
+    color?: string;
+    opacity?: number;
+}
+export interface DomHighlightData {
+    highlighted: number;
+    nodeIds: number[];
+}
+/**
+ * DOM Get Command - Get full HTML and attributes for elements
+ */
+export interface DomGetCommand {
+    selector?: string;
+    index?: number;
+    nodeId?: number;
+    all?: boolean;
+    nth?: number;
+}
+export interface DomGetData {
+    nodes: Array<{
+        nodeId: number;
+        tag?: string;
+        attributes?: Record<string, unknown>;
+        classes?: string[];
+        outerHTML?: string;
+    }>;
+}
+/**
+ * Worker Peek Command - Get lightweight preview of collected data
+ */
+export interface WorkerPeekCommand {
+    lastN?: number;
+}
+export interface WorkerPeekData {
+    version: string;
+    startTime: number;
+    duration: number;
+    target: {
+        url: string;
+        title: string;
+    };
+    activeCollectors: string[];
+    network: Array<{
+        requestId: string;
+        timestamp: number;
+        method: string;
+        url: string;
+        status?: number;
+        mimeType?: string;
+    }>;
+    console: Array<{
+        timestamp: number;
+        type: string;
+        text: string;
+    }>;
+}
+/**
+ * Worker Details Command - Get full object for specific network/console item
+ */
+export interface WorkerDetailsCommand {
+    itemType: 'network' | 'console';
+    id: string;
+}
+export interface WorkerDetailsData {
+    item: unknown;
+}
+/**
+ * CDP Call Command - Execute arbitrary CDP method
+ */
+export interface CdpCallCommand {
+    method: string;
+    params?: Record<string, unknown>;
+}
+export interface CdpCallData {
+    result: unknown;
+}
+/**
+ * Registry of all available commands.
+ * Each command has a request schema and response schema.
+ */
+export declare const COMMANDS: {
+    readonly dom_query: {
+        readonly requestSchema: DomQueryCommand;
+        readonly responseSchema: DomQueryData;
+    };
+    readonly dom_highlight: {
+        readonly requestSchema: DomHighlightCommand;
+        readonly responseSchema: DomHighlightData;
+    };
+    readonly dom_get: {
+        readonly requestSchema: DomGetCommand;
+        readonly responseSchema: DomGetData;
+    };
+    readonly worker_peek: {
+        readonly requestSchema: WorkerPeekCommand;
+        readonly responseSchema: WorkerPeekData;
+    };
+    readonly worker_details: {
+        readonly requestSchema: WorkerDetailsCommand;
+        readonly responseSchema: WorkerDetailsData;
+    };
+    readonly cdp_call: {
+        readonly requestSchema: CdpCallCommand;
+        readonly responseSchema: CdpCallData;
+    };
+};
+export type CommandName = keyof typeof COMMANDS;
+/**
+ * Worker Request - Command with requestId (daemon -\> worker via stdin)
+ */
+export type WorkerRequest<T extends CommandName> = {
+    type: `${T}_request`;
+    requestId: string;
+} & (typeof COMMANDS)[T]['requestSchema'];
+/**
+ * Worker Response - Command result with requestId (worker -\> daemon via stdout)
+ */
+export type WorkerResponse<T extends CommandName> = {
+    type: `${T}_response`;
+    requestId: string;
+    success: boolean;
+    data?: (typeof COMMANDS)[T]['responseSchema'];
+    error?: string;
+};
+/**
+ * Client Request - Command with sessionId (CLI -\> daemon via Unix socket)
+ */
+export type ClientRequest<T extends CommandName> = {
+    type: `${T}_request`;
+    sessionId: string;
+} & (typeof COMMANDS)[T]['requestSchema'];
+/**
+ * Client Response - Command result with sessionId (daemon -\> CLI via Unix socket)
+ */
+export type ClientResponse<T extends CommandName> = {
+    type: `${T}_response`;
+    sessionId: string;
+    status: 'ok' | 'error';
+    data?: (typeof COMMANDS)[T]['responseSchema'];
+    error?: string;
+};
+/**
+ * Union of all possible worker request types
+ */
+export type WorkerRequestUnion = {
+    [K in CommandName]: WorkerRequest<K>;
+}[CommandName];
+/**
+ * Union of all possible worker response types
+ */
+export type WorkerResponseUnion = {
+    [K in CommandName]: WorkerResponse<K>;
+}[CommandName];
+/**
+ * Union of all possible client request types
+ */
+export type ClientRequestUnion = {
+    [K in CommandName]: ClientRequest<K>;
+}[CommandName];
+/**
+ * Check if a message type corresponds to a registered command
+ */
+export declare function isCommandRequest(type: string): type is `${CommandName}_request`;
+/**
+ * Check if a message type corresponds to a command response
+ */
+export declare function isCommandResponse(type: string): type is `${CommandName}_response`;
+/**
+ * Extract command name from message type
+ */
+export declare function getCommandName(type: string): CommandName | null;
+//# sourceMappingURL=commands.d.ts.map

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

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

package/dist/ipc/commands.js

@@ -0,0 +1,69 @@
+/**
+ * Unified Command Registry - Single Source of Truth
+ *
+ * This file defines all IPC commands and their schemas. Command types are defined once here,
+ * and utility types add sessionId/requestId at the boundaries (client/worker).
+ *
+ * Benefits:
+ * - No type duplication between client and worker
+ * - Adding a new command only requires updating this file and the handler
+ * - Type safety maintained throughout the stack
+ */
+// =============================================================================
+// Command Registry - Single Source of Truth
+// =============================================================================
+/**
+ * Registry of all available commands.
+ * Each command has a request schema and response schema.
+ */
+export const COMMANDS = {
+    dom_query: {
+        requestSchema: {},
+        responseSchema: {},
+    },
+    dom_highlight: {
+        requestSchema: {},
+        responseSchema: {},
+    },
+    dom_get: {
+        requestSchema: {},
+        responseSchema: {},
+    },
+    worker_peek: {
+        requestSchema: {},
+        responseSchema: {},
+    },
+    worker_details: {
+        requestSchema: {},
+        responseSchema: {},
+    },
+    cdp_call: {
+        requestSchema: {},
+        responseSchema: {},
+    },
+};
+// =============================================================================
+// Type Guards
+// =============================================================================
+/**
+ * Check if a message type corresponds to a registered command
+ */
+export function isCommandRequest(type) {
+    const commandName = type.replace('_request', '');
+    return commandName in COMMANDS;
+}
+/**
+ * Check if a message type corresponds to a command response
+ */
+export function isCommandResponse(type) {
+    const commandName = type.replace('_response', '');
+    return commandName in COMMANDS;
+}
+/**
+ * Extract command name from message type
+ */
+export function getCommandName(type) {
+    const commandName = type.replace(/_request|_response/, '');
+    return commandName in COMMANDS ? commandName : null;
+}
+//# sourceMappingURL=commands.js.map

package/dist/ipc/commands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands.js","sourceRoot":"","sources":["../../src/ipc/commands.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAuHH,gFAAgF;AAChF,4CAA4C;AAC5C,gFAAgF;AAEhF;;;GAGG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,SAAS,EAAE;QACT,aAAa,EAAE,EAAqB;QACpC,cAAc,EAAE,EAAkB;KACnC;IACD,aAAa,EAAE;QACb,aAAa,EAAE,EAAyB;QACxC,cAAc,EAAE,EAAsB;KACvC;IACD,OAAO,EAAE;QACP,aAAa,EAAE,EAAmB;QAClC,cAAc,EAAE,EAAgB;KACjC;IACD,WAAW,EAAE;QACX,aAAa,EAAE,EAAuB;QACtC,cAAc,EAAE,EAAoB;KACrC;IACD,cAAc,EAAE;QACd,aAAa,EAAE,EAA0B;QACzC,cAAc,EAAE,EAAuB;KACxC;IACD,QAAQ,EAAE;QACR,aAAa,EAAE,EAAoB;QACnC,cAAc,EAAE,EAAiB;KAClC;CACO,CAAC;AAuEX,gFAAgF;AAChF,cAAc;AACd,gFAAgF;AAEhF;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAC3C,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAgB,CAAC;IAChE,OAAO,WAAW,IAAI,QAAQ,CAAC;AACjC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAY;IAC5C,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,CAAgB,CAAC;IACjE,OAAO,WAAW,IAAI,QAAQ,CAAC;AACjC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,oBAAoB,EAAE,EAAE,CAAgB,CAAC;IAC1E,OAAO,WAAW,IAAI,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC;AACtD,CAAC"}

package/dist/ipc/responseValidator.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Base response interface for validation.
+ * Both IPCResponse and ClientResponse follow this structure.
+ */
+interface BaseResponse {
+    status: 'ok' | 'error';
+    error?: string;
+}
+/**
+ * Response type with success status.
+ * Used for type narrowing after validation.
+ */
+type SuccessResponse<T extends BaseResponse> = T & {
+    status: 'ok';
+};
+/**
+ * Validate IPC response and throw on error.
+ * Standardizes error handling for all IPC/CDP calls.
+ *
+ * This function:
+ * - Checks if response.status === 'error'
+ * - Throws Error with response.error message if present
+ * - Narrows TypeScript type to exclude error status after validation
+ *
+ * Works with both IPCResponse (legacy) and ClientResponse (new) types.
+ *
+ * @param response - IPC or CDP response from daemon
+ * @throws Error if response.status === 'error'
+ *
+ * @example
+ * ```typescript
+ * const response = await callCDP('Network.getCookies', params);
+ * validateIPCResponse(response); // Throws if error
+ * // TypeScript now knows response.status === 'ok'
+ * const cookies = response.data?.result.cookies;
+ * ```
+ */
+export declare function validateIPCResponse<T extends BaseResponse>(response: T): asserts response is SuccessResponse<T>;
+export {};
+//# sourceMappingURL=responseValidator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"responseValidator.d.ts","sourceRoot":"","sources":["../../src/ipc/responseValidator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,UAAU,YAAY;IACpB,MAAM,EAAE,IAAI,GAAG,OAAO,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,KAAK,eAAe,CAAC,CAAC,SAAS,YAAY,IAAI,CAAC,GAAG;IAAE,MAAM,EAAE,IAAI,CAAA;CAAE,CAAC;AAEpE;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,SAAS,YAAY,EACxD,QAAQ,EAAE,CAAC,GACV,OAAO,CAAC,QAAQ,IAAI,eAAe,CAAC,CAAC,CAAC,CAIxC"}

package/dist/ipc/responseValidator.js

@@ -0,0 +1,28 @@
+/**
+ * Validate IPC response and throw on error.
+ * Standardizes error handling for all IPC/CDP calls.
+ *
+ * This function:
+ * - Checks if response.status === 'error'
+ * - Throws Error with response.error message if present
+ * - Narrows TypeScript type to exclude error status after validation
+ *
+ * Works with both IPCResponse (legacy) and ClientResponse (new) types.
+ *
+ * @param response - IPC or CDP response from daemon
+ * @throws Error if response.status === 'error'
+ *
+ * @example
+ * ```typescript
+ * const response = await callCDP('Network.getCookies', params);
+ * validateIPCResponse(response); // Throws if error
+ * // TypeScript now knows response.status === 'ok'
+ * const cookies = response.data?.result.cookies;
+ * ```
+ */
+export function validateIPCResponse(response) {
+    if (response.status === 'error') {
+        throw new Error(response.error ?? 'Unknown IPC error');
+    }
+}
+//# sourceMappingURL=responseValidator.js.map

package/dist/ipc/responseValidator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"responseValidator.js","sourceRoot":"","sources":["../../src/ipc/responseValidator.ts"],"names":[],"mappings":"AAeA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,UAAU,mBAAmB,CACjC,QAAW;IAEX,IAAI,QAAQ,CAAC,MAAM,KAAK,OAAO,EAAE,CAAC;QAChC,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,IAAI,mBAAmB,CAAC,CAAC;IACzD,CAAC;AACH,CAAC"}