browser-debugger-cli 0.6.0 → 0.6.1

package/dist/connection/pageReadiness.js

@@ -1,21 +1,30 @@
 /**
- * Smart page readiness detection using self-tuning thresholds
+ * Smart page readiness detection using fixed thresholds
  *
- * This module provides adaptive page load detection that works for any page type
+ * This module provides page load detection that works for most page types
  * without configuration. It uses a three-phase approach:
  * 1. Load event (baseline readiness)
- * 2. Network stability (adapts to request patterns)
- * 3. DOM stability (adapts to mutation rate)
+ * 2. Network stability (200ms idle threshold)
+ * 3. DOM stability (300ms idle threshold)
  */
+// Readiness Detection Thresholds
+/** Network idle threshold in milliseconds - network is stable when no requests for this duration */
+const NETWORK_IDLE_THRESHOLD_MS = 200;
+/** DOM stable threshold in milliseconds - DOM is stable when no mutations for this duration */
+const DOM_STABLE_THRESHOLD_MS = 300;
+/** Interval for checking deadline expiration in milliseconds */
+const DEADLINE_CHECK_INTERVAL_MS = 100;
+/** Interval for checking network activity in milliseconds */
+const NETWORK_CHECK_INTERVAL_MS = 50;
 /**
- * Wait for page to be ready using self-tuning detection
+ * Wait for page to be ready using fixed thresholds
  *
  * Strategy (always applied):
  * 1. Wait for load event (baseline readiness)
- * 2. Wait for network to stabilize (adaptive 200ms idle)
- * 3. Wait for DOM to stabilize (adaptive 300ms idle)
+ * 2. Wait for network to stabilize (200ms idle threshold)
+ * 3. Wait for DOM to stabilize (300ms idle threshold)
  *
- * All thresholds adapt to observed page behavior.
+ * Uses fixed thresholds that work well for most pages.
  * No framework detection, no configuration needed.
  * Works for static HTML, SPAs, and everything in between.
  *
@@ -35,13 +44,10 @@ export async function waitForPageReady(cdp, options = {}) {
     const maxWaitMs = options.maxWaitMs ?? 5000;
     const deadline = Date.now() + maxWaitMs;
     try {
-        // Phase 1: Wait for load event (baseline)
         await waitForLoadEvent(cdp, deadline);
         console.error('[readiness] ✓ Load event');
-        // Phase 2: Wait for network stability (always - modern web is async)
         const networkIdleMs = await waitForNetworkStable(cdp, deadline);
         console.error(`[readiness] ✓ Network stable (${networkIdleMs}ms idle)`);
-        // Phase 3: Wait for DOM stability (always - SPAs mutate after load)
         const domIdleMs = await waitForDOMStable(cdp, deadline);
         console.error(`[readiness] ✓ DOM stable (${domIdleMs}ms idle)`);
         console.error('[readiness] ✓ Page ready');
@@ -49,7 +55,6 @@ export async function waitForPageReady(cdp, options = {}) {
     catch (error) {
         const message = error instanceof Error ? error.message : String(error);
         console.error(`[readiness] ${message}, proceeding anyway`);
-        // Don't rethrow - allow session to continue
     }
 }
 /**
@@ -70,27 +75,25 @@ export async function waitForPageReady(cdp, options = {}) {
  */
 async function waitForLoadEvent(cdp, deadline) {
     await cdp.send('Page.enable');
-    // Check if page already loaded (handles Chrome pre-navigation)
     try {
         const result = (await cdp.send('Runtime.evaluate', {
             expression: 'document.readyState',
             returnByValue: true,
         }));
         if (result.result.value === 'complete') {
-            // Load event already fired
             return;
         }
     }
-    catch {
-        // Ignore evaluation errors, proceed to wait for event
+    catch (error) {
+        console.error(`[readiness] Failed to check document.readyState: ${error instanceof Error ? error.message : String(error)}`);
     }
     return new Promise((resolve, reject) => {
         let timeout;
-        let handlerId;
+        let cleanupHandler;
         const cleanup = () => {
             clearTimeout(timeout);
-            if (handlerId !== undefined) {
-                cdp.off('Page.loadEventFired', handlerId);
+            if (cleanupHandler) {
+                cleanupHandler();
             }
         };
         const checkDeadline = () => {
@@ -99,14 +102,14 @@ async function waitForLoadEvent(cdp, deadline) {
                 reject(new Error('Load event timeout'));
             }
             else {
-                timeout = setTimeout(checkDeadline, 100);
+                timeout = setTimeout(checkDeadline, DEADLINE_CHECK_INTERVAL_MS);
             }
         };
         const loadHandler = () => {
             cleanup();
             resolve();
         };
-        handlerId = cdp.on('Page.loadEventFired', loadHandler);
+        cleanupHandler = cdp.on('Page.loadEventFired', loadHandler);
         checkDeadline();
     });
 }
@@ -136,17 +139,9 @@ async function waitForNetworkStable(cdp, deadline) {
     await cdp.send('Network.enable');
     let activeRequests = 0;
     let lastActivity = Date.now();
-    const intervals = [];
-    let lastRequestTime = Date.now();
-    // Track request patterns
     const requestHandler = () => {
-        const now = Date.now();
-        const interval = now - lastRequestTime;
-        if (interval < 5000)
-            intervals.push(interval);
-        lastRequestTime = now;
         activeRequests++;
-        lastActivity = now;
+        lastActivity = Date.now();
     };
     const finishHandler = () => {
         activeRequests--;
@@ -154,29 +149,25 @@ async function waitForNetworkStable(cdp, deadline) {
             lastActivity = Date.now();
         }
     };
-    const requestHandlerId = cdp.on('Network.requestWillBeSent', requestHandler);
-    const loadingFinishedId = cdp.on('Network.loadingFinished', finishHandler);
-    const loadingFailedId = cdp.on('Network.loadingFailed', finishHandler);
+    const cleanupRequest = cdp.on('Network.requestWillBeSent', requestHandler);
+    const cleanupFinished = cdp.on('Network.loadingFinished', finishHandler);
+    const cleanupFailed = cdp.on('Network.loadingFailed', finishHandler);
     try {
-        // Use fixed threshold for immediate detection
-        const idleThreshold = 200; // 200ms idle = network stable
-        // Detection phase: wait for stability
         while (Date.now() < deadline) {
             if (activeRequests === 0) {
                 const idleTime = Date.now() - lastActivity;
-                if (idleTime >= idleThreshold) {
+                if (idleTime >= NETWORK_IDLE_THRESHOLD_MS) {
                     return idleTime; // Success!
                 }
             }
-            await delay(50); // Check every 50ms
+            await delay(NETWORK_CHECK_INTERVAL_MS);
         }
         throw new Error('Network stability timeout');
     }
     finally {
-        // Cleanup handlers
-        cdp.off('Network.requestWillBeSent', requestHandlerId);
-        cdp.off('Network.loadingFinished', loadingFinishedId);
-        cdp.off('Network.loadingFailed', loadingFailedId);
+        cleanupRequest();
+        cleanupFinished();
+        cleanupFailed();
     }
 }
 /**
@@ -205,7 +196,6 @@ async function waitForNetworkStable(cdp, deadline) {
  * @throws Error if deadline exceeded
  */
 async function waitForDOMStable(cdp, deadline) {
-    // Inject mutation observer
     await cdp.send('Runtime.evaluate', {
         expression: `
       window.__bdg_mutations = 0;
@@ -227,24 +217,20 @@ async function waitForDOMStable(cdp, deadline) {
     `,
     });
     try {
-        // Use fixed threshold for immediate detection
-        const stableThreshold = 300; // 300ms no mutations = DOM stable
-        // Detection phase: wait for stability
         while (Date.now() < deadline) {
             const checkResult = (await cdp.send('Runtime.evaluate', {
                 expression: 'Date.now() - window.__bdg_lastMutation',
                 returnByValue: true,
             }));
             const timeSinceLastMutation = checkResult.result.value ?? 0;
-            if (timeSinceLastMutation >= stableThreshold) {
+            if (timeSinceLastMutation >= DOM_STABLE_THRESHOLD_MS) {
                 return timeSinceLastMutation; // Success!
             }
-            await delay(100); // Check every 100ms
+            await delay(DEADLINE_CHECK_INTERVAL_MS);
         }
         throw new Error('DOM stability timeout');
     }
     finally {
-        // Cleanup observer
         await cdp
             .send('Runtime.evaluate', {
             expression: `
@@ -254,9 +240,7 @@ async function waitForDOMStable(cdp, deadline) {
         delete window.__bdg_lastMutation;
       `,
         })
-            .catch(() => {
-            // Ignore cleanup errors
-        });
+            .catch(() => { });
     }
 }
 /**

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

@@ -11,6 +11,7 @@
  * - 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';
 /**
@@ -106,7 +107,7 @@ export declare class TypedCDPConnection {
      * });
      * ```
      */
-    on<T extends keyof ProtocolMapping.Events>(event: T, handler: (params: EventParams<T>) => void): number;
+    on<T extends keyof ProtocolMapping.Events>(event: T, handler: (params: EventParams<T>) => void): EventCleanup;
     /**
      * Remove an event handler by ID.
      *

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

@@ -1 +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,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,MAAM;IAIT;;;;;;;;;;;;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"}
+{"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.map

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