browser-debugger-cli 0.6.0 → 0.6.2

package/dist/ipc/client.js

@@ -1,251 +1,180 @@
-/* eslint-disable import/order */
 /**
- * IPC Client - Minimal JSONL handshake MVP
+ * IPC Client
  *
- * Connects to the daemon's Unix domain socket and performs handshake.
+ * Public API for communicating with the daemon via Unix socket.
+ * Provides high-level functions for session lifecycle and queries.
  */
-import { randomUUID } from 'crypto';
-import { connect } from 'net';
-import { getIPCRequestTimeout } from '../constants.js';
-import { getDaemonSocketPath } from '../session/paths.js';
-import { getErrorMessage } from '../ui/errors/index.js';
-import { createLogger } from '../ui/logging/index.js';
-import { filterDefined } from '../utils/objects.js';
-const log = createLogger('client');
-/**
- * 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 = getDaemonSocketPath();
-    return new Promise((resolve, reject) => {
-        const socket = connect(socketPath);
-        let buffer = '';
-        let resolved = false;
-        // Set request timeout
-        const timeoutMs = getIPCRequestTimeout();
-        const timeout = setTimeout(() => {
-            if (!resolved) {
-                resolved = true;
-                socket.destroy();
-                reject(new Error(`${requestName} request timeout after ${timeoutMs / 1000}s`));
-            }
-        }, timeoutMs);
-        socket.on('connect', () => {
-            log.debug(`Connected to daemon for ${requestName} request`);
-            socket.write(JSON.stringify(request) + '\n');
-            log.debug(`${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);
-                        log.debug(`${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);
-                const fullMessage = [
-                    `IPC ${requestName} connection error`,
-                    `Socket: ${socketPath}`,
-                    `Details: ${err.message}`,
-                ].join(' | ');
-                reject(new Error(fullMessage));
-            }
-        });
-        socket.on('end', () => {
-            if (!resolved) {
-                resolved = true;
-                clearTimeout(timeout);
-                reject(new Error(`Connection closed before ${requestName} response received`));
-            }
-        });
-    });
-}
+import { sendRequest } from './transport/index.js';
+import { withSession } from './utils/index.js';
 /**
  * Connect to the daemon and perform handshake.
+ * Verifies daemon is running and ready to accept commands.
+ *
+ * @returns Handshake response with connection status
+ * @throws Error if connection fails or times out
  *
- * @returns Handshake response from daemon
- * @throws Error if connection fails or handshake times out
+ * @example
+ * ```typescript
+ * const response = await connectToDaemon();
+ * if (response.status === 'ok') {
+ *   console.log('Connected:', response.message);
+ * }
+ * ```
  */
 export async function connectToDaemon() {
-    const request = {
-        type: 'handshake_request',
-        sessionId: randomUUID(),
-    };
-    return sendRequest(request, 'handshake');
+    const request = withSession({ type: 'handshake_request' });
+    return sendRequest(request, 'handshake', 'handshake_response');
 }
 /**
  * Request status information from the daemon.
+ * Returns daemon state, session metadata, and activity metrics.
+ *
+ * @returns Status response with daemon and session information
+ * @throws Error if connection fails or times out
  *
- * @returns Status response with daemon and session metadata
- * @throws Error if connection fails, daemon is not running, or request times out
+ * @example
+ * ```typescript
+ * const response = await getStatus();
+ * if (response.status === 'ok' && response.data) {
+ *   console.log('Daemon PID:', response.data.daemonPid);
+ *   console.log('Session active:', !!response.data.sessionPid);
+ * }
+ * ```
  */
 export async function getStatus() {
-    const request = {
-        type: 'status_request',
-        sessionId: randomUUID(),
-    };
-    return sendRequest(request, 'status');
+    const request = withSession({ type: 'status_request' });
+    return sendRequest(request, 'status', 'status_response');
 }
 /**
  * Request preview data from the daemon.
+ * Returns snapshot of collected telemetry without stopping session.
  *
- * @returns Peek response with session preview data
- * @throws Error if connection fails, daemon is not running, or request times out
+ * @returns Peek response with preview data
+ * @throws Error if connection fails, times out, or no active session
+ *
+ * @example
+ * ```typescript
+ * const response = await getPeek();
+ * if (response.status === 'ok' && response.data) {
+ *   console.log('Network requests:', response.data.preview.data.network?.length);
+ *   console.log('Console messages:', response.data.preview.data.console?.length);
+ * }
+ * ```
  */
 export async function getPeek() {
-    const request = {
-        type: 'peek_request',
-        sessionId: randomUUID(),
-    };
-    return sendRequest(request, 'peek');
+    const request = withSession({ type: 'peek_request' });
+    return sendRequest(request, 'peek', 'peek_response');
 }
 /**
  * Request daemon to start a new browser session.
+ * Launches Chrome, establishes CDP connection, and begins telemetry collection.
  *
  * @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
+ * @returns Start session response with worker and Chrome PIDs
+ * @throws Error if connection fails, session already running, or Chrome launch fails
+ *
+ * @example
+ * ```typescript
+ * const response = await startSession('http://localhost:3000', {
+ *   timeout: 30,
+ *   headless: true,
+ *   maxBodySize: 10
+ * });
+ * if (response.status === 'ok' && response.data) {
+ *   console.log('Session started, worker PID:', response.data.workerPid);
+ * }
+ * ```
  */
 export async function startSession(url, options) {
-    const request = {
+    const request = withSession({
         type: 'start_session_request',
-        sessionId: randomUUID(),
         url,
-        ...filterDefined({
-            port: options?.port,
-            timeout: options?.timeout,
-            telemetry: options?.telemetry,
-            includeAll: options?.includeAll,
-            userDataDir: options?.userDataDir,
-            maxBodySize: options?.maxBodySize,
-            headless: options?.headless,
-            chromeWsUrl: options?.chromeWsUrl,
+        ...(options && {
+            port: options.port,
+            timeout: options.timeout,
+            telemetry: options.telemetry,
+            includeAll: options.includeAll,
+            userDataDir: options.userDataDir,
+            maxBodySize: options.maxBodySize,
+            headless: options.headless,
+            chromeWsUrl: options.chromeWsUrl,
         }),
-    };
-    return sendRequest(request, 'start session');
+    });
+    return sendRequest(request, 'start session', 'start_session_response');
 }
 /**
  * Request session stop from the daemon.
+ * Stops telemetry collection, closes Chrome, and writes output file.
+ *
+ * @returns Stop session response with termination status
+ * @throws Error if connection fails, times out, or no active session
  *
- * @returns Stop session response with success/error status
- * @throws Error if connection fails, daemon is not running, or request times out
+ * @example
+ * ```typescript
+ * const response = await stopSession();
+ * if (response.status === 'ok') {
+ *   console.log('Session stopped:', response.message);
+ * }
+ * ```
  */
 export async function stopSession() {
-    const request = {
-        type: 'stop_session_request',
-        sessionId: randomUUID(),
-    };
-    return sendRequest(request, 'stop session');
+    const request = withSession({ type: 'stop_session_request' });
+    return sendRequest(request, 'stop session', 'stop_session_response');
 }
 /**
- * Generic command sender - works for any registered command in the COMMANDS registry.
+ * Send a command to the worker process.
+ * Internal helper for worker commands (details, CDP calls).
  *
- * @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
+ * @param commandName - Name of the command to send
+ * @param params - Command parameters (without type field)
+ * @returns Command response from worker
+ * @throws Error if connection fails or command execution fails
  */
 async function sendCommand(commandName, params) {
     const request = {
-        type: `${commandName}_request`,
-        sessionId: randomUUID(),
         ...params,
+        type: `${commandName}_request`,
+        sessionId: withSession({ type: '' }).sessionId,
     };
-    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);
+    return sendRequest(request, commandName, `${commandName}_response`);
 }
 /**
- * Get full HTML and attributes for DOM elements via the daemon's worker.
+ * Get details for a specific network request or console message.
+ * Retrieves full data (headers, body, stack trace) for a telemetry item.
  *
- * @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);
-}
-/**
- * Capture page screenshot via the daemon's worker.
- *
- * @param path - Output file path (absolute path)
- * @param options - Screenshot options (format, quality, fullPage)
- * @returns Screenshot response with metadata (path, dimensions, size)
- * @throws Error if connection fails, daemon is not running, or request times out
- */
-export async function captureScreenshot(path, options) {
-    return sendCommand('dom_screenshot', {
-        path,
-        ...filterDefined({
-            format: options?.format,
-            quality: options?.quality,
-            fullPage: options?.fullPage,
-        }),
-    });
-}
-/**
- * Get details for a specific network request or console message via the daemon's worker.
+ * @param type - Type of item to retrieve ('network' or 'console')
+ * @param id - Unique identifier of the item
+ * @returns Response with full item details
+ * @throws Error if connection fails or item not found
  *
- * @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
+ * @example
+ * ```typescript
+ * const response = await getDetails('network', 'req-123');
+ * if (response.status === 'ok' && response.data) {
+ *   console.log('Full request:', response.data.item);
+ * }
+ * ```
  */
 export async function getDetails(type, id) {
     return sendCommand('worker_details', { itemType: type, id });
 }
 /**
  * Execute arbitrary CDP method via the daemon's worker.
+ * Forwards CDP commands to the worker's active CDP connection.
+ *
+ * @param method - CDP method name (e.g., 'Network.getCookies')
+ * @param params - Optional method parameters
+ * @returns Response with CDP method result
+ * @throws Error if connection fails or CDP method fails
  *
- * @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
+ * @example
+ * ```typescript
+ * const response = await callCDP('Network.getCookies', {});
+ * if (response.status === 'ok' && response.data) {
+ *   console.log('Cookies:', response.data.result);
+ * }
+ * ```
  */
 export async function callCDP(method, params) {
     return sendCommand('cdp_call', { method, ...(params && { params }) });

package/dist/ipc/client.js.map

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

package/dist/ipc/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * IPC Module
+ *
+ * Public API for inter-process communication between CLI, daemon, and worker.
+ *
+ * Organized into layers:
+ * - Client API (high-level functions for CLI commands)
+ * - Session messages (lifecycle and query types)
+ * - Protocol (worker command schemas and type guards)
+ * - Transport (low-level socket communication)
+ * - Validation (response validation utilities)
+ */
+export * from './client.js';
+export * from './session/index.js';
+export * from './protocol/index.js';
+export { validateIPCResponse } from './utils/responseValidator.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ipc/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,cAAc,aAAa,CAAC;AAG5B,cAAc,oBAAoB,CAAC;AAGnC,cAAc,qBAAqB,CAAC;AAGpC,OAAO,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC"}

package/dist/ipc/index.js

@@ -0,0 +1,23 @@
+/**
+ * IPC Module
+ *
+ * Public API for inter-process communication between CLI, daemon, and worker.
+ *
+ * Organized into layers:
+ * - Client API (high-level functions for CLI commands)
+ * - Session messages (lifecycle and query types)
+ * - Protocol (worker command schemas and type guards)
+ * - Transport (low-level socket communication)
+ * - Validation (response validation utilities)
+ */
+// Public client API
+export * from './client.js';
+// Session message types
+export * from './session/index.js';
+// Protocol types (worker commands)
+export * from './protocol/index.js';
+// Validation utilities (re-exported from utils for public API)
+export { validateIPCResponse } from './utils/responseValidator.js';
+// Note: transport/ is internal and not exported (used by client.ts)
+// Note: other utils are internal and not exported (except validateIPCResponse)
+//# sourceMappingURL=index.js.map

package/dist/ipc/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/ipc/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,oBAAoB;AACpB,cAAc,aAAa,CAAC;AAE5B,wBAAwB;AACxB,cAAc,oBAAoB,CAAC;AAEnC,mCAAmC;AACnC,cAAc,qBAAqB,CAAC;AAEpC,+DAA+D;AAC/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AAEnE,oEAAoE;AACpE,+EAA+E"}

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

@@ -0,0 +1,144 @@
+/**
+ * Worker Command Schemas
+ *
+ * Defines the request/response schemas for commands sent to the worker process.
+ * Each command has a request schema (input) and response data schema (output).
+ */
+import type { PageState, SessionActivity } from '../../ipc/session/types.js';
+/**
+ * Worker peek command request schema.
+ */
+export interface WorkerPeekCommand {
+    /** Number of recent items to return. */
+    lastN?: number;
+    /** Offset from the end (for pagination). Default: 0 (most recent). */
+    offset?: number;
+}
+/**
+ * Worker peek command response data.
+ */
+export interface WorkerPeekData {
+    version: string;
+    startTime: number;
+    duration: number;
+    target: {
+        url: string;
+        title: string;
+    };
+    activeTelemetry: string[];
+    network: Array<{
+        requestId: string;
+        timestamp: number;
+        method: string;
+        url: string;
+        status?: number;
+        mimeType?: string;
+    }>;
+    console: Array<{
+        timestamp: number;
+        type: string;
+        text: string;
+    }>;
+    /** Total number of network requests (for pagination). */
+    totalNetwork?: number;
+    /** Total number of console messages (for pagination). */
+    totalConsole?: number;
+    /** Whether there are more network items available. */
+    hasMoreNetwork?: boolean;
+    /** Whether there are more console items available. */
+    hasMoreConsole?: boolean;
+}
+/**
+ * Worker details command request schema.
+ */
+export interface WorkerDetailsCommand {
+    /** Type of item to get details for. */
+    itemType: 'network' | 'console';
+    /** Unique identifier of the item. */
+    id: string;
+}
+/**
+ * Worker details command response data.
+ */
+export interface WorkerDetailsData {
+    /** The requested item (network request or console message). */
+    item: unknown;
+}
+/**
+ * CDP call command request schema.
+ */
+export interface CdpCallCommand {
+    /** CDP method name (e.g., 'Network.getCookies'). */
+    method: string;
+    /** Optional parameters for the CDP method. */
+    params?: Record<string, unknown>;
+}
+/**
+ * CDP call command response data.
+ */
+export interface CdpCallData {
+    /** Result from CDP method call. */
+    result: unknown;
+}
+/**
+ * Worker status command request schema (no parameters required).
+ */
+export type WorkerStatusCommand = Record<string, unknown>;
+/**
+ * Worker status command response data.
+ */
+export interface WorkerStatusData {
+    startTime: number;
+    duration: number;
+    target: PageState;
+    activeTelemetry: string[];
+    activity: SessionActivity;
+}
+/**
+ * Command definition structure.
+ */
+type CommandDef<TReq, TRes> = {
+    requestSchema: TReq;
+    responseSchema: TRes;
+};
+/**
+ * Shape of the command registry.
+ */
+export type RegistryShape = {
+    worker_peek: CommandDef<WorkerPeekCommand, WorkerPeekData>;
+    worker_details: CommandDef<WorkerDetailsCommand, WorkerDetailsData>;
+    worker_status: CommandDef<WorkerStatusCommand, WorkerStatusData>;
+    cdp_call: CommandDef<CdpCallCommand, CdpCallData>;
+};
+/**
+ * Central registry of all worker commands.
+ * Maps command names to their request/response schemas.
+ */
+export declare const COMMANDS: {
+    readonly worker_peek: {
+        readonly requestSchema: WorkerPeekCommand;
+        readonly responseSchema: WorkerPeekData;
+    };
+    readonly worker_details: {
+        readonly requestSchema: WorkerDetailsCommand;
+        readonly responseSchema: WorkerDetailsData;
+    };
+    readonly worker_status: {
+        readonly requestSchema: WorkerStatusCommand;
+        readonly responseSchema: WorkerStatusData;
+    };
+    readonly cdp_call: {
+        readonly requestSchema: CdpCallCommand;
+        readonly responseSchema: CdpCallData;
+    };
+};
+/**
+ * All registered command schemas.
+ */
+export type CommandSchemas = typeof COMMANDS;
+/**
+ * All valid command names.
+ */
+export type CommandName = keyof typeof COMMANDS;
+export {};
+//# sourceMappingURL=commands.d.ts.map

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

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

package/dist/ipc/protocol/commands.js

@@ -0,0 +1,23 @@
+/**
+ * Worker Command Schemas
+ *
+ * Defines the request/response schemas for commands sent to the worker process.
+ * Each command has a request schema (input) and response data schema (output).
+ */
+/**
+ * Central registry of all worker commands.
+ * Maps command names to their request/response schemas.
+ */
+export const COMMANDS = {
+    worker_peek: { requestSchema: {}, responseSchema: {} },
+    worker_details: {
+        requestSchema: {},
+        responseSchema: {},
+    },
+    worker_status: {
+        requestSchema: {},
+        responseSchema: {},
+    },
+    cdp_call: { requestSchema: {}, responseSchema: {} },
+};
+//# sourceMappingURL=commands.js.map

package/dist/ipc/protocol/commands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands.js","sourceRoot":"","sources":["../../../src/ipc/protocol/commands.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA6GH;;;GAGG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,WAAW,EAAE,EAAE,aAAa,EAAE,EAAuB,EAAE,cAAc,EAAE,EAAoB,EAAE;IAC7F,cAAc,EAAE;QACd,aAAa,EAAE,EAA0B;QACzC,cAAc,EAAE,EAAuB;KACxC;IACD,aAAa,EAAE;QACb,aAAa,EAAE,EAAyB;QACxC,cAAc,EAAE,EAAsB;KACvC;IACD,QAAQ,EAAE,EAAE,aAAa,EAAE,EAAoB,EAAE,cAAc,EAAE,EAAiB,EAAE;CACpD,CAAC"}