browser-debugger-cli 0.5.1 → 0.6.1

package/dist/connection/pageReadiness.js.map

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

package/dist/connection/portReservation.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Port reservation utilities for Chrome launcher.
+ *
+ * Provides atomic port reservation to prevent race conditions during
+ * Chrome launch when multiple processes might try to bind to the same port.
+ */
+/**
+ * Port reservation handle with release function.
+ */
+export interface PortReservation {
+    /** Release the port reservation */
+    release: () => void;
+}
+/**
+ * Atomically reserve a port to prevent race conditions during Chrome launch.
+ *
+ * Creates a temporary TCP server on the port, which prevents other processes
+ * from binding to it. Returns a release function to free the port.
+ *
+ * The port must be released BEFORE launching Chrome so Chrome can bind to it.
+ * This function is only for atomically checking availability.
+ *
+ * @param port - Port number to reserve
+ * @returns Promise resolving to reservation object with release function
+ * @throws ChromeLaunchError If port is already in use
+ *
+ * @example
+ * ```typescript
+ * // Check if port is available
+ * const reservation = await reservePort(9222);
+ *
+ * // Immediately release so Chrome can bind to it
+ * reservation.release();
+ *
+ * // Now launch Chrome on the port
+ * const chrome = await launchChrome({ port: 9222 });
+ * ```
+ */
+export declare function reservePort(port: number): Promise<PortReservation>;
+//# sourceMappingURL=portReservation.d.ts.map

package/dist/connection/portReservation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"portReservation.d.ts","sourceRoot":"","sources":["../../src/connection/portReservation.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAQH;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,mCAAmC;IACnC,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAsB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAoBxE"}

package/dist/connection/portReservation.js

@@ -0,0 +1,55 @@
+/**
+ * Port reservation utilities for Chrome launcher.
+ *
+ * Provides atomic port reservation to prevent race conditions during
+ * Chrome launch when multiple processes might try to bind to the same port.
+ */
+import * as net from 'net';
+import { portInUseError } from '../ui/messages/chrome.js';
+import { ChromeLaunchError } from './errors.js';
+/**
+ * Atomically reserve a port to prevent race conditions during Chrome launch.
+ *
+ * Creates a temporary TCP server on the port, which prevents other processes
+ * from binding to it. Returns a release function to free the port.
+ *
+ * The port must be released BEFORE launching Chrome so Chrome can bind to it.
+ * This function is only for atomically checking availability.
+ *
+ * @param port - Port number to reserve
+ * @returns Promise resolving to reservation object with release function
+ * @throws ChromeLaunchError If port is already in use
+ *
+ * @example
+ * ```typescript
+ * // Check if port is available
+ * const reservation = await reservePort(9222);
+ *
+ * // Immediately release so Chrome can bind to it
+ * reservation.release();
+ *
+ * // Now launch Chrome on the port
+ * const chrome = await launchChrome({ port: 9222 });
+ * ```
+ */
+export async function reservePort(port) {
+    return new Promise((resolve, reject) => {
+        const server = net.createServer();
+        server.once('error', (err) => {
+            if (err.code === 'EADDRINUSE') {
+                reject(new ChromeLaunchError(portInUseError(port)));
+            }
+            else {
+                reject(err);
+            }
+        });
+        server.listen(port, '127.0.0.1', () => {
+            resolve({
+                release: () => {
+                    server.close();
+                },
+            });
+        });
+    });
+}
+//# sourceMappingURL=portReservation.js.map

package/dist/connection/portReservation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"portReservation.js","sourceRoot":"","sources":["../../src/connection/portReservation.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,GAAG,MAAM,KAAK,CAAC;AAE3B,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAEzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAUhD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,IAAY;IAC5C,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,MAAM,MAAM,GAAG,GAAG,CAAC,YAAY,EAAE,CAAC;QAElC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,GAA0B,EAAE,EAAE;YAClD,IAAI,GAAG,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;gBAC9B,MAAM,CAAC,IAAI,iBAAiB,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YACtD,CAAC;iBAAM,CAAC;gBACN,MAAM,CAAC,GAAG,CAAC,CAAC;YACd,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,WAAW,EAAE,GAAG,EAAE;YACpC,OAAO,CAAC;gBACN,OAAO,EAAE,GAAG,EAAE;oBACZ,MAAM,CAAC,KAAK,EAAE,CAAC;gBACjB,CAAC;aACF,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/connection/typed-cdp.d.ts

@@ -0,0 +1,145 @@
+/**
+ * Type-safe CDP Connection Wrapper
+ *
+ * Provides compile-time type safety for Chrome DevTools Protocol methods
+ * using official TypeScript definitions from devtools-protocol package.
+ *
+ * Benefits:
+ * - Autocomplete for all 300+ CDP methods
+ * - Type-checked parameters and return values
+ * - Type-safe event handlers
+ * - No runtime overhead (types erased at compile time)
+ */
+import type { CDPConnection } from './cdp.js';
+import type { EventCleanup } from './events.js';
+import type Protocol from 'devtools-protocol/types/protocol';
+import type ProtocolMapping from 'devtools-protocol/types/protocol-mapping';
+/**
+ * Extract parameter type from a CDP command.
+ *
+ * If command has no parameters, returns empty object type.
+ * If command has single parameter array, returns first element.
+ */
+type CommandParams<T extends keyof ProtocolMapping.Commands> = ProtocolMapping.Commands[T]['paramsType'] extends [infer P] ? P : ProtocolMapping.Commands[T]['paramsType'] extends [] ? Record<string, never> : never;
+/**
+ * Extract return type from a CDP command.
+ */
+type CommandReturn<T extends keyof ProtocolMapping.Commands> = ProtocolMapping.Commands[T]['returnType'];
+/**
+ * Extract event parameter type from a CDP event.
+ *
+ * If event has no parameters, returns empty object.
+ * If event has single parameter array, returns first element.
+ */
+type EventParams<T extends keyof ProtocolMapping.Events> = ProtocolMapping.Events[T] extends [
+    infer P
+] ? P : ProtocolMapping.Events[T] extends [] ? void : never;
+/**
+ * Type-safe wrapper around CDPConnection.
+ *
+ * Provides strongly-typed methods for sending CDP commands and
+ * registering event handlers.
+ *
+ * @example
+ * ```typescript
+ * const cdp = new CDPConnection(wsUrl);
+ * const typed = new TypedCDPConnection(cdp);
+ *
+ * // Type-safe command with autocomplete
+ * const response = await typed.send('Network.getCookies', { urls: ['http://example.com'] });
+ * // response type: Protocol.Network.GetCookiesResponse
+ *
+ * // Type-safe event handler
+ * typed.on('Network.requestWillBeSent', (event) => {
+ *   // event type: Protocol.Network.RequestWillBeSentEvent
+ *   console.log(event.request.url);
+ * });
+ * ```
+ */
+export declare class TypedCDPConnection {
+    private cdp;
+    constructor(cdp: CDPConnection);
+    /**
+     * Send a type-safe CDP command.
+     *
+     * @param method - CDP method name (autocomplete available for 300+ methods)
+     * @param params - Command parameters (type-checked)
+     * @returns Promise resolving to command response (type-safe)
+     *
+     * @example
+     * ```typescript
+     * // Network domain
+     * const cookies = await typed.send('Network.getCookies', { urls: ['http://example.com'] });
+     *
+     * // Runtime domain
+     * const result = await typed.send('Runtime.evaluate', {
+     *   expression: 'document.title',
+     *   returnByValue: true
+     * });
+     *
+     * // DOM domain
+     * const doc = await typed.send('DOM.getDocument', {});
+     * ```
+     */
+    send<T extends keyof ProtocolMapping.Commands>(method: T, params: CommandParams<T>): Promise<CommandReturn<T>>;
+    /**
+     * Register a type-safe event handler.
+     *
+     * @param event - CDP event name (autocomplete available)
+     * @param handler - Event handler with type-safe parameters
+     * @returns Handler ID for later removal
+     *
+     * @example
+     * ```typescript
+     * // Network events
+     * const id = typed.on('Network.requestWillBeSent', (event) => {
+     *   console.log(event.request.url, event.request.method);
+     * });
+     *
+     * // Console events
+     * typed.on('Runtime.consoleAPICalled', (event) => {
+     *   console.log(event.type, event.args);
+     * });
+     *
+     * // Page events
+     * typed.on('Page.loadEventFired', (event) => {
+     *   console.log('Page loaded at:', event.timestamp);
+     * });
+     * ```
+     */
+    on<T extends keyof ProtocolMapping.Events>(event: T, handler: (params: EventParams<T>) => void): EventCleanup;
+    /**
+     * Remove an event handler by ID.
+     *
+     * @param event - CDP event name
+     * @param handlerId - Handler ID returned from on()
+     *
+     * @example
+     * ```typescript
+     * const id = typed.on('Network.requestWillBeSent', handler);
+     * // Later...
+     * typed.off('Network.requestWillBeSent', id);
+     * ```
+     */
+    off(event: string, handlerId: number): void;
+    /**
+     * Access underlying CDPConnection for advanced use cases.
+     *
+     * Use this when you need to call methods not covered by the typed wrapper,
+     * or when you need to access connection state/methods directly.
+     */
+    get raw(): CDPConnection;
+}
+/**
+ * Re-export Protocol namespace for easy access to types.
+ *
+ * @example
+ * ```typescript
+ * import { Protocol } from '../connection/typed-cdp.js';
+ *
+ * type Cookie = Protocol.Network.Cookie;
+ * type Headers = Protocol.Network.Headers;
+ * ```
+ */
+export type { Protocol };
+//# sourceMappingURL=typed-cdp.d.ts.map

package/dist/connection/typed-cdp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"typed-cdp.d.ts","sourceRoot":"","sources":["../../src/connection/typed-cdp.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAC9C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,KAAK,QAAQ,MAAM,kCAAkC,CAAC;AAC7D,OAAO,KAAK,eAAe,MAAM,0CAA0C,CAAC;AAE5E;;;;;GAKG;AACH,KAAK,aAAa,CAAC,CAAC,SAAS,MAAM,eAAe,CAAC,QAAQ,IACzD,eAAe,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,GACvD,CAAC,GACD,eAAe,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,SAAS,EAAE,GAClD,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,GACrB,KAAK,CAAC;AAEd;;GAEG;AACH,KAAK,aAAa,CAAC,CAAC,SAAS,MAAM,eAAe,CAAC,QAAQ,IACzD,eAAe,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC;AAE5C;;;;;GAKG;AACH,KAAK,WAAW,CAAC,CAAC,SAAS,MAAM,eAAe,CAAC,MAAM,IAAI,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS;IAC3F,MAAM,CAAC;CACR,GACG,CAAC,GACD,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,EAAE,GAClC,IAAI,GACJ,KAAK,CAAC;AAEZ;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBAAa,kBAAkB;IACjB,OAAO,CAAC,GAAG;gBAAH,GAAG,EAAE,aAAa;IAEtC;;;;;;;;;;;;;;;;;;;;;OAqBG;IACG,IAAI,CAAC,CAAC,SAAS,MAAM,eAAe,CAAC,QAAQ,EACjD,MAAM,EAAE,CAAC,EACT,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC,GACvB,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;IAK5B;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACH,EAAE,CAAC,CAAC,SAAS,MAAM,eAAe,CAAC,MAAM,EACvC,KAAK,EAAE,CAAC,EACR,OAAO,EAAE,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,KAAK,IAAI,GACxC,YAAY;IAIf;;;;;;;;;;;;OAYG;IACH,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI;IAI3C;;;;;OAKG;IACH,IAAI,GAAG,IAAI,aAAa,CAEvB;CACF;AAED;;;;;;;;;;GAUG;AACH,YAAY,EAAE,QAAQ,EAAE,CAAC"}

package/dist/connection/typed-cdp.js

@@ -0,0 +1,120 @@
+/**
+ * Type-safe CDP Connection Wrapper
+ *
+ * Provides compile-time type safety for Chrome DevTools Protocol methods
+ * using official TypeScript definitions from devtools-protocol package.
+ *
+ * Benefits:
+ * - Autocomplete for all 300+ CDP methods
+ * - Type-checked parameters and return values
+ * - Type-safe event handlers
+ * - No runtime overhead (types erased at compile time)
+ */
+/**
+ * Type-safe wrapper around CDPConnection.
+ *
+ * Provides strongly-typed methods for sending CDP commands and
+ * registering event handlers.
+ *
+ * @example
+ * ```typescript
+ * const cdp = new CDPConnection(wsUrl);
+ * const typed = new TypedCDPConnection(cdp);
+ *
+ * // Type-safe command with autocomplete
+ * const response = await typed.send('Network.getCookies', { urls: ['http://example.com'] });
+ * // response type: Protocol.Network.GetCookiesResponse
+ *
+ * // Type-safe event handler
+ * typed.on('Network.requestWillBeSent', (event) => {
+ *   // event type: Protocol.Network.RequestWillBeSentEvent
+ *   console.log(event.request.url);
+ * });
+ * ```
+ */
+export class TypedCDPConnection {
+    cdp;
+    constructor(cdp) {
+        this.cdp = cdp;
+    }
+    /**
+     * Send a type-safe CDP command.
+     *
+     * @param method - CDP method name (autocomplete available for 300+ methods)
+     * @param params - Command parameters (type-checked)
+     * @returns Promise resolving to command response (type-safe)
+     *
+     * @example
+     * ```typescript
+     * // Network domain
+     * const cookies = await typed.send('Network.getCookies', { urls: ['http://example.com'] });
+     *
+     * // Runtime domain
+     * const result = await typed.send('Runtime.evaluate', {
+     *   expression: 'document.title',
+     *   returnByValue: true
+     * });
+     *
+     * // DOM domain
+     * const doc = await typed.send('DOM.getDocument', {});
+     * ```
+     */
+    async send(method, params) {
+        const result = await this.cdp.send(method, params);
+        return result;
+    }
+    /**
+     * Register a type-safe event handler.
+     *
+     * @param event - CDP event name (autocomplete available)
+     * @param handler - Event handler with type-safe parameters
+     * @returns Handler ID for later removal
+     *
+     * @example
+     * ```typescript
+     * // Network events
+     * const id = typed.on('Network.requestWillBeSent', (event) => {
+     *   console.log(event.request.url, event.request.method);
+     * });
+     *
+     * // Console events
+     * typed.on('Runtime.consoleAPICalled', (event) => {
+     *   console.log(event.type, event.args);
+     * });
+     *
+     * // Page events
+     * typed.on('Page.loadEventFired', (event) => {
+     *   console.log('Page loaded at:', event.timestamp);
+     * });
+     * ```
+     */
+    on(event, handler) {
+        return this.cdp.on(event, handler);
+    }
+    /**
+     * Remove an event handler by ID.
+     *
+     * @param event - CDP event name
+     * @param handlerId - Handler ID returned from on()
+     *
+     * @example
+     * ```typescript
+     * const id = typed.on('Network.requestWillBeSent', handler);
+     * // Later...
+     * typed.off('Network.requestWillBeSent', id);
+     * ```
+     */
+    off(event, handlerId) {
+        this.cdp.off(event, handlerId);
+    }
+    /**
+     * Access underlying CDPConnection for advanced use cases.
+     *
+     * Use this when you need to call methods not covered by the typed wrapper,
+     * or when you need to access connection state/methods directly.
+     */
+    get raw() {
+        return this.cdp;
+    }
+}
+//# sourceMappingURL=typed-cdp.js.map

package/dist/connection/typed-cdp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"typed-cdp.js","sourceRoot":"","sources":["../../src/connection/typed-cdp.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAwCH;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,OAAO,kBAAkB;IACT;IAApB,YAAoB,GAAkB;QAAlB,QAAG,GAAH,GAAG,CAAe;IAAG,CAAC;IAE1C;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,KAAK,CAAC,IAAI,CACR,MAAS,EACT,MAAwB;QAExB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,MAAiC,CAAC,CAAC;QAC9E,OAAO,MAA0B,CAAC;IACpC,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACH,EAAE,CACA,KAAQ,EACR,OAAyC;QAEzC,OAAO,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,KAAK,EAAE,OAAoC,CAAC,CAAC;IAClE,CAAC;IAED;;;;;;;;;;;;OAYG;IACH,GAAG,CAAC,KAAa,EAAE,SAAiB;QAClC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;IACjC,CAAC;IAED;;;;;OAKG;IACH,IAAI,GAAG;QACL,OAAO,IAAI,CAAC,GAAG,CAAC;IAClB,CAAC;CACF"}

package/dist/connection/types.d.ts

@@ -0,0 +1,103 @@
+/**
+ * Connection module type definitions.
+ *
+ * Contains types specific to Chrome DevTools Protocol connections,
+ * Chrome launching, and connection management.
+ */
+/**
+ * Chrome DevTools Protocol message structure.
+ *
+ * CDP uses a JSON-RPC-like protocol over WebSocket with request/response
+ * correlation via message IDs.
+ */
+export interface CDPMessage {
+    /** Message ID for request/response correlation */
+    id?: number;
+    /** CDP method name (e.g., 'Page.navigate', 'Network.enable') */
+    method?: string;
+    /** Method parameters */
+    params?: Record<string, unknown>;
+    /** Method result (present in responses) */
+    result?: unknown;
+    /** Error information (present in error responses) */
+    error?: {
+        code?: number;
+        message: string;
+    };
+    /** Session ID for commands sent to specific targets */
+    sessionId?: string;
+}
+/**
+ * CDP target information from /json/list endpoint.
+ */
+export interface CDPTarget {
+    /** Target ID */
+    id: string;
+    /** Target type (page, worker, service_worker, etc.) */
+    type: string;
+    /** Page title */
+    title: string;
+    /** Page URL */
+    url: string;
+    /** WebSocket debugger URL for CDP connection */
+    webSocketDebuggerUrl: string;
+}
+/**
+ * Optional tuning parameters for CDPConnection.connect.
+ */
+export interface ConnectionOptions {
+    /** Milliseconds to wait for the initial socket open */
+    timeout?: number;
+    /** Number of connection attempts before failing */
+    maxRetries?: number;
+    /** Reconnect automatically when the socket closes */
+    autoReconnect?: boolean;
+    /** Interval between ping frames to keep CDP alive */
+    keepaliveInterval?: number;
+    /** Async hook invoked after a successful reconnect */
+    onReconnect?: (() => Promise<void>) | undefined;
+    /** Async hook invoked when WebSocket closes unexpectedly */
+    onDisconnect?: ((code: number, reason: string) => void | Promise<void>) | undefined;
+}
+/**
+ * Options for CDPConnection.create() factory method.
+ *
+ * Extends ConnectionOptions to include logger configuration for consistent
+ * options object pattern across constructor and factory.
+ */
+export interface CreateOptions extends ConnectionOptions {
+    /** Logger instance for connection lifecycle events */
+    logger?: Logger;
+}
+/**
+ * Information about a launched Chrome instance.
+ */
+export interface LaunchedChrome {
+    /** Process ID of the Chrome instance */
+    pid: number;
+    /** Remote debugging port Chrome is listening on */
+    port: number;
+    /** Resolved Chrome user data directory (profile path) */
+    userDataDir?: string | undefined;
+    /** Async function to terminate Chrome and cleanup temp directories */
+    kill: () => Promise<void>;
+}
+/**
+ * Logger interface for connection module.
+ *
+ * Allows dependency injection of different logging implementations
+ * without coupling to specific UI or logging libraries.
+ *
+ * Compatible with both console and bdg's Logger interface.
+ */
+export interface Logger {
+    /** Log informational message */
+    info(message: string): void;
+    /** Log debug message (only shown with debug flag) */
+    debug(message: string): void;
+}
+/**
+ * Cleanup function type for resource management.
+ */
+export type CleanupFunction = () => void;
+//# sourceMappingURL=types.d.ts.map

package/dist/connection/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/connection/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;GAKG;AACH,MAAM,WAAW,UAAU;IACzB,kDAAkD;IAClD,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,gEAAgE;IAChE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,wBAAwB;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,2CAA2C;IAC3C,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,qDAAqD;IACrD,KAAK,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3C,uDAAuD;IACvD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,gBAAgB;IAChB,EAAE,EAAE,MAAM,CAAC;IACX,uDAAuD;IACvD,IAAI,EAAE,MAAM,CAAC;IACb,iBAAiB;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,eAAe;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,gDAAgD;IAChD,oBAAoB,EAAE,MAAM,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,uDAAuD;IACvD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,mDAAmD;IACnD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,qDAAqD;IACrD,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,qDAAqD;IACrD,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,sDAAsD;IACtD,WAAW,CAAC,EAAE,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,SAAS,CAAC;IAChD,4DAA4D;IAC5D,YAAY,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,SAAS,CAAC;CACrF;AAED;;;;;GAKG;AACH,MAAM,WAAW,aAAc,SAAQ,iBAAiB;IACtD,sDAAsD;IACtD,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,wCAAwC;IACxC,GAAG,EAAE,MAAM,CAAC;IACZ,mDAAmD;IACnD,IAAI,EAAE,MAAM,CAAC;IACb,yDAAyD;IACzD,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,sEAAsE;IACtE,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,MAAM;IACrB,gCAAgC;IAChC,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,qDAAqD;IACrD,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,MAAM,IAAI,CAAC"}

package/dist/connection/types.js

@@ -0,0 +1,8 @@
+/**
+ * Connection module type definitions.
+ *
+ * Contains types specific to Chrome DevTools Protocol connections,
+ * Chrome launching, and connection management.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/connection/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/connection/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/constants.d.ts

@@ -25,81 +25,6 @@ export declare const DEFAULT_CHROME_HANDLE_SIGINT = false;
  * Persistent Chrome profile directory path (relative to user home)
  */
 export declare const CHROME_PROFILE_DIR = "chrome-profile";
-/**
- * Maximum CDP connection retry attempts before failing
- */
-export declare const CDP_MAX_CONNECTION_RETRIES = 3;
-/**
- * CDP connection timeout in milliseconds (10 seconds)
- * Maximum time to wait for WebSocket connection to establish
- */
-export declare const CDP_CONNECTION_TIMEOUT_MS = 10000;
-/**
- * WebSocket handshake timeout in milliseconds (5 seconds)
- * Maximum time to wait for WebSocket handshake to complete
- */
-export declare const WEBSOCKET_HANDSHAKE_TIMEOUT_MS = 5000;
-/**
- * WebSocket maximum payload size in bytes (100MB)
- * Allows large DOM snapshots without hitting payload limits
- */
-export declare const WEBSOCKET_MAX_PAYLOAD_BYTES: number;
-/**
- * CDP command timeout in milliseconds (30 seconds)
- * Maximum time to wait for CDP command responses
- * Balances responsiveness with time for heavy operations (DOM traversal, etc.)
- */
-export declare const CDP_COMMAND_TIMEOUT_MS = 30000;
-/**
- * CDP keepalive ping interval in milliseconds (30 seconds)
- * Prevents connection timeout during long-running sessions
- */
-export declare const CDP_KEEPALIVE_INTERVAL = 30000;
-/**
- * CDP reconnection retry limit
- * Maximum number of reconnection attempts before giving up
- */
-export declare const CDP_MAX_RECONNECT_ATTEMPTS = 5;
-/**
- * CDP base retry delay in milliseconds (1 second)
- * Starting delay for exponential backoff retry strategy
- */
-export declare const CDP_BASE_RETRY_DELAY_MS = 1000;
-/**
- * CDP maximum retry delay in milliseconds (5 seconds)
- * Cap for exponential backoff during connection retries
- */
-export declare const CDP_MAX_RETRY_DELAY_MS = 5000;
-/**
- * CDP maximum reconnection delay in milliseconds (10 seconds)
- * Cap for exponential backoff during reconnection attempts
- */
-export declare const CDP_MAX_RECONNECT_DELAY_MS = 10000;
-/**
- * CDP keepalive maximum missed pongs threshold
- * Connection is considered dead after this many consecutive missed pongs
- */
-export declare const CDP_MAX_MISSED_PONGS = 3;
-/**
- * CDP pong timeout in milliseconds (5 seconds)
- * Maximum time to wait for pong response after sending ping
- */
-export declare const CDP_PONG_TIMEOUT_MS = 5000;
-/**
- * WebSocket normal closure code (RFC 6455)
- * Indicates graceful connection shutdown
- */
-export declare const WEBSOCKET_NORMAL_CLOSURE = 1000;
-/**
- * WebSocket no pong received closure code
- * Custom code for keepalive failure (no pong received)
- */
-export declare const WEBSOCKET_NO_PONG_CLOSURE = 1001;
-/**
- * UTF-8 text encoding identifier
- * Standard encoding for text data conversion
- */
-export declare const UTF8_ENCODING = "utf8";
 /**
  * HTTP localhost address for CDP endpoints
  * Standard loopback address for Chrome DevTools Protocol
@@ -195,12 +120,4 @@ export declare function getIPCRequestTimeout(): number;
  * Description for port option in CLI commands
  */
 export declare const PORT_OPTION_DESCRIPTION = "Chrome debugging port";
-/**
- * Description for timeout option in CLI commands
- */
-export declare const TIMEOUT_OPTION_DESCRIPTION = "Auto-stop after timeout (optional)";
-/**
- * Description for user-data-dir option in CLI commands
- */
-export declare const USER_DATA_DIR_OPTION_DESCRIPTION = "Chrome user data directory (default: ~/.bdg/chrome-profile)";
 //# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH;;GAEG;AACH,eAAO,MAAM,gBAAgB,OAAO,CAAC;AAErC;;;GAGG;AACH,eAAO,MAAM,kBAAkB,QAA2B,CAAC;AAE3D;;GAEG;AACH,eAAO,MAAM,wBAAwB,WAAW,CAAC;AAEjD;;GAEG;AACH,eAAO,MAAM,4BAA4B,QAAQ,CAAC;AAElD;;GAEG;AACH,eAAO,MAAM,kBAAkB,mBAAmB,CAAC;AAEnD;;GAEG;AACH,eAAO,MAAM,0BAA0B,IAAI,CAAC;AAE5C;;;GAGG;AACH,eAAO,MAAM,yBAAyB,QAAQ,CAAC;AAE/C;;;GAGG;AACH,eAAO,MAAM,8BAA8B,OAAO,CAAC;AAEnD;;;GAGG;AACH,eAAO,MAAM,2BAA2B,QAAoB,CAAC;AAE7D;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,QAAQ,CAAC;AAE5C;;;GAGG;AACH,eAAO,MAAM,sBAAsB,QAAQ,CAAC;AAE5C;;;GAGG;AACH,eAAO,MAAM,0BAA0B,IAAI,CAAC;AAE5C;;;GAGG;AACH,eAAO,MAAM,uBAAuB,OAAO,CAAC;AAE5C;;;GAGG;AACH,eAAO,MAAM,sBAAsB,OAAO,CAAC;AAE3C;;;GAGG;AACH,eAAO,MAAM,0BAA0B,QAAQ,CAAC;AAEhD;;;GAGG;AACH,eAAO,MAAM,oBAAoB,IAAI,CAAC;AAEtC;;;GAGG;AACH,eAAO,MAAM,mBAAmB,OAAO,CAAC;AAExC;;;GAGG;AACH,eAAO,MAAM,wBAAwB,OAAO,CAAC;AAE7C;;;GAGG;AACH,eAAO,MAAM,yBAAyB,OAAO,CAAC;AAE9C;;;GAGG;AACH,eAAO,MAAM,aAAa,SAAS,CAAC;AAEpC;;;GAGG;AACH,eAAO,MAAM,cAAc,cAAc,CAAC;AAE1C;;;GAGG;AACH,eAAO,MAAM,aAAa,mBAAmB,CAAC;AAE9C;;;;;;;GAOG;AACH,eAAO,MAAM,gBAAgB,UAS5B,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,mBAAmB,UAK/B,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAIpD,CAAC;AAMF;;;GAGG;AACH,eAAO,MAAM,oBAAoB,QAAQ,CAAC;AAE1C;;;GAGG;AACH,eAAO,MAAM,oBAAoB,QAAQ,CAAC;AAE1C;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,QAAkB,CAAC;AAMjD;;;GAGG;AACH,eAAO,MAAM,2BAA2B,QAAmB,CAAC;AAE5D;;;GAGG;AACH,eAAO,MAAM,kCAAkC,QAAmB,CAAC;AAEnE;;;GAGG;AACH,eAAO,MAAM,sBAAsB,QAAkB,CAAC;AAMtD;;;GAGG;AACH,eAAO,MAAM,qBAAqB,QAAQ,CAAC;AAE3C;;;GAGG;AACH,eAAO,MAAM,8BAA8B,QAAQ,CAAC;AAEpD;;;;GAIG;AACH,eAAO,MAAM,iCAAiC,OAAO,CAAC;AAMtD;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,CAI7C;AAMD;;GAEG;AACH,eAAO,MAAM,uBAAuB,0BAA0B,CAAC;AAE/D;;GAEG;AACH,eAAO,MAAM,0BAA0B,uCAAuC,CAAC;AAE/E;;GAEG;AACH,eAAO,MAAM,gCAAgC,gEACkB,CAAC"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH;;GAEG;AACH,eAAO,MAAM,gBAAgB,OAAO,CAAC;AAErC;;;GAGG;AACH,eAAO,MAAM,kBAAkB,QAA2B,CAAC;AAE3D;;GAEG;AACH,eAAO,MAAM,wBAAwB,WAAW,CAAC;AAEjD;;GAEG;AACH,eAAO,MAAM,4BAA4B,QAAQ,CAAC;AAElD;;GAEG;AACH,eAAO,MAAM,kBAAkB,mBAAmB,CAAC;AAEnD;;;GAGG;AACH,eAAO,MAAM,cAAc,cAAc,CAAC;AAE1C;;;GAGG;AACH,eAAO,MAAM,aAAa,mBAAmB,CAAC;AAE9C;;;;;;;GAOG;AACH,eAAO,MAAM,gBAAgB,UAS5B,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,mBAAmB,UAK/B,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAIpD,CAAC;AAMF;;;GAGG;AACH,eAAO,MAAM,oBAAoB,QAAQ,CAAC;AAE1C;;;GAGG;AACH,eAAO,MAAM,oBAAoB,QAAQ,CAAC;AAE1C;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,QAAkB,CAAC;AAMjD;;;GAGG;AACH,eAAO,MAAM,2BAA2B,QAAmB,CAAC;AAE5D;;;GAGG;AACH,eAAO,MAAM,kCAAkC,QAAmB,CAAC;AAEnE;;;GAGG;AACH,eAAO,MAAM,sBAAsB,QAAkB,CAAC;AAMtD;;;GAGG;AACH,eAAO,MAAM,qBAAqB,QAAQ,CAAC;AAE3C;;;GAGG;AACH,eAAO,MAAM,8BAA8B,QAAQ,CAAC;AAEpD;;;;GAIG;AACH,eAAO,MAAM,iCAAiC,OAAO,CAAC;AAMtD;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,CAI7C;AAMD;;GAEG;AACH,eAAO,MAAM,uBAAuB,0BAA0B,CAAC"}