browser-debugger-cli 0.6.0 → 0.6.1

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

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/connection/errors.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;GAKG;AACH,8BAAsB,eAAgB,SAAQ,KAAK;IACjD,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;gBAEvB,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK;CAO3C;AAED;;;;;;;GAOG;AACH,qBAAa,kBAAmB,SAAQ,eAAe;IACrD,QAAQ,CAAC,IAAI,0BAA0B;IACvC,QAAQ,CAAC,QAAQ,OAAO;CACzB;AAED;;;;;;;GAOG;AACH,qBAAa,iBAAkB,SAAQ,eAAe;IACpD,QAAQ,CAAC,IAAI,yBAAyB;IACtC,QAAQ,CAAC,QAAQ,OAAO;CACzB;AAED;;;;;;GAMG;AACH,qBAAa,eAAgB,SAAQ,eAAe;IAClD,QAAQ,CAAC,IAAI,uBAAuB;IACpC,QAAQ,CAAC,QAAQ,OAAO;CACzB;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAKtD"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/connection/errors.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH;;;;;GAKG;AACH,8BAAsB,eAAgB,SAAQ,KAAK;IACjD,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;gBAEvB,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK;CAO3C;AAED;;;;;;;GAOG;AACH,qBAAa,kBAAmB,SAAQ,eAAe;IACrD,QAAQ,CAAC,IAAI,0BAA0B;IACvC,QAAQ,CAAC,QAAQ,MAAqC;CACvD;AAED;;;;;;;GAOG;AACH,qBAAa,iBAAkB,SAAQ,eAAe;IACpD,QAAQ,CAAC,IAAI,yBAAyB;IACtC,QAAQ,CAAC,QAAQ,MAAoC;CACtD;AAED;;;;;;GAMG;AACH,qBAAa,eAAgB,SAAQ,eAAe;IAClD,QAAQ,CAAC,IAAI,uBAAuB;IACpC,QAAQ,CAAC,QAAQ,MAA0B;CAC5C;AAED;;;;;GAKG;AACH,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/connection/errors.js

@@ -3,6 +3,7 @@
  *
  * Provides structured error handling for CDP connections and Chrome launches.
  */
+import { EXIT_CODES } from '../utils/exitCodes.js';
 /**
  * Base error class for all connection-related errors.
  *
@@ -28,7 +29,7 @@ export class ConnectionError extends Error {
  */
 export class CDPConnectionError extends ConnectionError {
     code = 'CDP_CONNECTION_ERROR';
-    exitCode = 101; // CDP_CONNECTION_FAILURE
+    exitCode = EXIT_CODES.CDP_CONNECTION_FAILURE;
 }
 /**
  * Chrome launch failed.
@@ -40,7 +41,7 @@ export class CDPConnectionError extends ConnectionError {
  */
 export class ChromeLaunchError extends ConnectionError {
     code = 'CHROME_LAUNCH_ERROR';
-    exitCode = 100; // CHROME_LAUNCH_FAILURE
+    exitCode = EXIT_CODES.CHROME_LAUNCH_FAILURE;
 }
 /**
  * CDP command timed out.
@@ -51,33 +52,13 @@ export class ChromeLaunchError extends ConnectionError {
  */
 export class CDPTimeoutError extends ConnectionError {
     code = 'CDP_TIMEOUT_ERROR';
-    exitCode = 102; // CDP_TIMEOUT
+    exitCode = EXIT_CODES.CDP_TIMEOUT;
 }
 /**
  * Extract error message from unknown error type.
  *
- * Safely extracts error messages from various error types:
- * - Error instances → error.message
- * - Unknown types → String(error)
- *
- * Useful for error handling when error type is unknown.
- *
- * @param error - Error of unknown type
- * @returns Error message string
- *
- * @example
- * ```typescript
- * try {
- *   await someOperation();
- * } catch (error) {
- *   throw new ChromeLaunchError(`Failed: ${getErrorMessage(error)}`, error);
- * }
- * ```
+ * @deprecated Import from \@/utils/errors.ts instead.
+ * Re-exported for backward compatibility.
  */
-export function getErrorMessage(error) {
-    if (error instanceof Error) {
-        return error.message;
-    }
-    return String(error);
-}
+export { getErrorMessage } from '../utils/errors.js';
 //# sourceMappingURL=errors.js.map

package/dist/connection/errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/connection/errors.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;GAKG;AACH,MAAM,OAAgB,eAAgB,SAAQ,KAAK;IAIjD,YAAY,OAAe,EAAE,KAAa;QACxC,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC;QAClC,IAAI,KAAK,EAAE,CAAC;YACV,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACrB,CAAC;IACH,CAAC;CACF;AAED;;;;;;;GAOG;AACH,MAAM,OAAO,kBAAmB,SAAQ,eAAe;IAC5C,IAAI,GAAG,sBAAsB,CAAC;IAC9B,QAAQ,GAAG,GAAG,CAAC,CAAC,yBAAyB;CACnD;AAED;;;;;;;GAOG;AACH,MAAM,OAAO,iBAAkB,SAAQ,eAAe;IAC3C,IAAI,GAAG,qBAAqB,CAAC;IAC7B,QAAQ,GAAG,GAAG,CAAC,CAAC,wBAAwB;CAClD;AAED;;;;;;GAMG;AACH,MAAM,OAAO,eAAgB,SAAQ,eAAe;IACzC,IAAI,GAAG,mBAAmB,CAAC;IAC3B,QAAQ,GAAG,GAAG,CAAC,CAAC,cAAc;CACxC;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,eAAe,CAAC,KAAc;IAC5C,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAC3B,OAAO,KAAK,CAAC,OAAO,CAAC;IACvB,CAAC;IACD,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;AACvB,CAAC"}
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/connection/errors.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAElD;;;;;GAKG;AACH,MAAM,OAAgB,eAAgB,SAAQ,KAAK;IAIjD,YAAY,OAAe,EAAE,KAAa;QACxC,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC;QAClC,IAAI,KAAK,EAAE,CAAC;YACV,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACrB,CAAC;IACH,CAAC;CACF;AAED;;;;;;;GAOG;AACH,MAAM,OAAO,kBAAmB,SAAQ,eAAe;IAC5C,IAAI,GAAG,sBAAsB,CAAC;IAC9B,QAAQ,GAAG,UAAU,CAAC,sBAAsB,CAAC;CACvD;AAED;;;;;;;GAOG;AACH,MAAM,OAAO,iBAAkB,SAAQ,eAAe;IAC3C,IAAI,GAAG,qBAAqB,CAAC;IAC7B,QAAQ,GAAG,UAAU,CAAC,qBAAqB,CAAC;CACtD;AAED;;;;;;GAMG;AACH,MAAM,OAAO,eAAgB,SAAQ,eAAe;IACzC,IAAI,GAAG,mBAAmB,CAAC;IAC3B,QAAQ,GAAG,UAAU,CAAC,WAAW,CAAC;CAC5C;AAED;;;;;GAKG;AACH,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/connection/events.d.ts

@@ -0,0 +1,30 @@
+/**
+ * CDP Event Source Interface
+ *
+ * Minimal interface for CDP event handling, decoupling telemetry collectors
+ * from CDPConnection implementation details.
+ */
+/** Cleanup function to unregister an event handler. */
+export type EventCleanup = () => void;
+/**
+ * Minimal interface for subscribing to CDP events.
+ *
+ * @example
+ * ```typescript
+ * const cleanup = events.on('Network.requestWillBeSent', (params) => {
+ *   console.log('Request:', params.request.url);
+ * });
+ * cleanup(); // Unregister
+ * ```
+ */
+export interface CDPEventSource {
+    /**
+     * Register an event handler for a specific CDP event.
+     *
+     * @param event - CDP event name (e.g., 'Network.requestWillBeSent')
+     * @param handler - Function to call when event is received
+     * @returns Cleanup function to unregister the handler
+     */
+    on<T = unknown>(event: string, handler: (params: T) => void): EventCleanup;
+}
+//# sourceMappingURL=events.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../src/connection/events.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,uDAAuD;AACvD,MAAM,MAAM,YAAY,GAAG,MAAM,IAAI,CAAC;AAEtC;;;;;;;;;;GAUG;AACH,MAAM,WAAW,cAAc;IAC7B;;;;;;OAMG;IACH,EAAE,CAAC,CAAC,GAAG,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,IAAI,GAAG,YAAY,CAAC;CAC5E"}

package/dist/connection/events.js

@@ -0,0 +1,8 @@
+/**
+ * CDP Event Source Interface
+ *
+ * Minimal interface for CDP event handling, decoupling telemetry collectors
+ * from CDPConnection implementation details.
+ */
+export {};
+//# sourceMappingURL=events.js.map

package/dist/connection/events.js.map

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

package/dist/connection/handlers.d.ts

@@ -16,7 +16,7 @@ type EventParams<T extends keyof ProtocolMapping.Events> = ProtocolMapping.Event
  * Supports both legacy untyped usage and new type-safe usage with TypedCDPConnection.
  */
 export declare class CDPHandlerRegistry {
-    private handlers;
+    private cleanupFunctions;
     /**
      * Register a CDP event handler and track it for cleanup (legacy API).
      *
@@ -24,7 +24,7 @@ export declare class CDPHandlerRegistry {
      * @param event - CDP event name (e.g., 'Network.requestWillBeSent')
      * @param handler - Event handler function
      *
-     * @deprecated Use registerTyped() with TypedCDPConnection for type safety
+     * @deprecated Since v0.5.0. Use registerTyped() with TypedCDPConnection for type safety. Will be removed in v1.0.0.
      */
     register<T>(cdp: CDPConnection, event: string, handler: (params: T) => void): void;
     /**
@@ -48,10 +48,8 @@ export declare class CDPHandlerRegistry {
     registerTyped<T extends keyof ProtocolMapping.Events>(typed: TypedCDPConnection, event: T, handler: (params: EventParams<T>) => void): void;
     /**
      * Remove all registered event handlers and clear the registry.
-     *
-     * @param cdp - CDP connection instance (or TypedCDPConnection.raw)
      */
-    cleanup(cdp: CDPConnection): void;
+    cleanup(): void;
     /**
      * Get the number of registered handlers.
      *

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

@@ -1 +1 @@
-{"version":3,"file":"handlers.d.ts","sourceRoot":"","sources":["../../src/connection/handlers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,eAAe,MAAM,0CAA0C,CAAC;AAE5E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAEpE;;GAEG;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;;;;;;;GAOG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAA4C;IAE5D;;;;;;;;OAQG;IACH,QAAQ,CAAC,CAAC,EAAE,GAAG,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,IAAI,GAAG,IAAI;IAKlF;;;;;;;;;;;;;;;;;OAiBG;IACH,aAAa,CAAC,CAAC,SAAS,MAAM,eAAe,CAAC,MAAM,EAClD,KAAK,EAAE,kBAAkB,EACzB,KAAK,EAAE,CAAC,EACR,OAAO,EAAE,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,KAAK,IAAI,GACxC,IAAI;IAKP;;;;OAIG;IACH,OAAO,CAAC,GAAG,EAAE,aAAa,GAAG,IAAI;IAKjC;;;;OAIG;IACH,IAAI,IAAI,MAAM;CAGf"}
+{"version":3,"file":"handlers.d.ts","sourceRoot":"","sources":["../../src/connection/handlers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,eAAe,MAAM,0CAA0C,CAAC;AAE5E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAEpE;;GAEG;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;;;;;;;GAOG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,gBAAgB,CAAyB;IAEjD;;;;;;;;OAQG;IACH,QAAQ,CAAC,CAAC,EAAE,GAAG,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,IAAI,GAAG,IAAI;IAKlF;;;;;;;;;;;;;;;;;OAiBG;IACH,aAAa,CAAC,CAAC,SAAS,MAAM,eAAe,CAAC,MAAM,EAClD,KAAK,EAAE,kBAAkB,EACzB,KAAK,EAAE,CAAC,EACR,OAAO,EAAE,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,KAAK,IAAI,GACxC,IAAI;IAKP;;OAEG;IACH,OAAO,IAAI,IAAI;IAKf;;;;OAIG;IACH,IAAI,IAAI,MAAM;CAGf"}

package/dist/connection/handlers.js

@@ -7,7 +7,7 @@
  * Supports both legacy untyped usage and new type-safe usage with TypedCDPConnection.
  */
 export class CDPHandlerRegistry {
-    handlers = [];
+    cleanupFunctions = [];
     /**
      * Register a CDP event handler and track it for cleanup (legacy API).
      *
@@ -15,11 +15,11 @@ export class CDPHandlerRegistry {
      * @param event - CDP event name (e.g., 'Network.requestWillBeSent')
      * @param handler - Event handler function
      *
-     * @deprecated Use registerTyped() with TypedCDPConnection for type safety
+     * @deprecated Since v0.5.0. Use registerTyped() with TypedCDPConnection for type safety. Will be removed in v1.0.0.
      */
     register(cdp, event, handler) {
-        const id = cdp.on(event, handler);
-        this.handlers.push({ event, id });
+        const cleanup = cdp.on(event, handler);
+        this.cleanupFunctions.push(cleanup);
     }
     /**
      * Register a type-safe CDP event handler and track it for cleanup.
@@ -40,17 +40,15 @@ export class CDPHandlerRegistry {
      * ```
      */
     registerTyped(typed, event, handler) {
-        const id = typed.on(event, handler);
-        this.handlers.push({ event, id });
+        const cleanup = typed.on(event, handler);
+        this.cleanupFunctions.push(cleanup);
     }
     /**
      * Remove all registered event handlers and clear the registry.
-     *
-     * @param cdp - CDP connection instance (or TypedCDPConnection.raw)
      */
-    cleanup(cdp) {
-        this.handlers.forEach(({ event, id }) => cdp.off(event, id));
-        this.handlers.length = 0;
+    cleanup() {
+        this.cleanupFunctions.forEach((cleanup) => cleanup());
+        this.cleanupFunctions.length = 0;
     }
     /**
      * Get the number of registered handlers.
@@ -58,7 +56,7 @@ export class CDPHandlerRegistry {
      * @returns Number of active handlers
      */
     size() {
-        return this.handlers.length;
+        return this.cleanupFunctions.length;
     }
 }
 //# sourceMappingURL=handlers.js.map

package/dist/connection/handlers.js.map

@@ -1 +1 @@
-{"version":3,"file":"handlers.js","sourceRoot":"","sources":["../../src/connection/handlers.ts"],"names":[],"mappings":"AAgBA;;;;;;;GAOG;AACH,MAAM,OAAO,kBAAkB;IACrB,QAAQ,GAAyC,EAAE,CAAC;IAE5D;;;;;;;;OAQG;IACH,QAAQ,CAAI,GAAkB,EAAE,KAAa,EAAE,OAA4B;QACzE,MAAM,EAAE,GAAG,GAAG,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QAClC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC;IACpC,CAAC;IAED;;;;;;;;;;;;;;;;;OAiBG;IACH,aAAa,CACX,KAAyB,EACzB,KAAQ,EACR,OAAyC;QAEzC,MAAM,EAAE,GAAG,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QACpC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC;IACpC,CAAC;IAED;;;;OAIG;IACH,OAAO,CAAC,GAAkB;QACxB,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC;QAC7D,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC;IAC3B,CAAC;IAED;;;;OAIG;IACH,IAAI;QACF,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC;IAC9B,CAAC;CACF"}
+{"version":3,"file":"handlers.js","sourceRoot":"","sources":["../../src/connection/handlers.ts"],"names":[],"mappings":"AAgBA;;;;;;;GAOG;AACH,MAAM,OAAO,kBAAkB;IACrB,gBAAgB,GAAsB,EAAE,CAAC;IAEjD;;;;;;;;OAQG;IACH,QAAQ,CAAI,GAAkB,EAAE,KAAa,EAAE,OAA4B;QACzE,MAAM,OAAO,GAAG,GAAG,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QACvC,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACtC,CAAC;IAED;;;;;;;;;;;;;;;;;OAiBG;IACH,aAAa,CACX,KAAyB,EACzB,KAAQ,EACR,OAAyC;QAEzC,MAAM,OAAO,GAAG,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QACzC,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACtC,CAAC;IAED;;OAEG;IACH,OAAO;QACL,IAAI,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC;QACtD,IAAI,CAAC,gBAAgB,CAAC,MAAM,GAAG,CAAC,CAAC;IACnC,CAAC;IAED;;;;OAIG;IACH,IAAI;QACF,OAAO,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC;IACtC,CAAC;CACF"}

package/dist/connection/launcher/binaryResolver.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Chrome binary resolution and validation.
+ *
+ * Handles resolving Chrome binary path from options or environment variables,
+ * and validates that the binary exists and is executable.
+ */
+/**
+ * Options containing Chrome binary path configuration.
+ */
+export interface BinaryResolverOptions {
+    /** Explicit Chrome binary path (overrides CHROME_PATH env var) */
+    chromePath?: string | undefined;
+}
+/**
+ * Resolve Chrome binary path from options or environment variable.
+ *
+ * Validates that the resolved binary:
+ * - Exists on the filesystem
+ * - Is a regular file (not a directory)
+ * - Has execute permissions
+ *
+ * @param options - Configuration with optional chromePath
+ * @returns Resolved and validated Chrome binary path, or undefined if not specified
+ * @throws ChromeLaunchError if binary path is invalid or not executable
+ *
+ * @example
+ * ```typescript
+ * // From options
+ * const binary = resolveChromeBinary({ chromePath: '/usr/bin/google-chrome' });
+ *
+ * // From environment variable
+ * process.env['CHROME_PATH'] = '/opt/chrome/chrome';
+ * const binary = resolveChromeBinary({});
+ *
+ * // Not specified (returns undefined, launcher will use default)
+ * const binary = resolveChromeBinary({});
+ * ```
+ */
+export declare function resolveChromeBinary(options: BinaryResolverOptions): string | undefined;
+//# sourceMappingURL=binaryResolver.d.ts.map

package/dist/connection/launcher/binaryResolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"binaryResolver.d.ts","sourceRoot":"","sources":["../../../src/connection/launcher/binaryResolver.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAaH;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,kEAAkE;IAClE,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACjC;AAeD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,qBAAqB,GAAG,MAAM,GAAG,SAAS,CAwCtF"}

package/dist/connection/launcher/binaryResolver.js

@@ -0,0 +1,78 @@
+/**
+ * Chrome binary resolution and validation.
+ *
+ * Handles resolving Chrome binary path from options or environment variables,
+ * and validates that the binary exists and is executable.
+ */
+import * as fs from 'fs';
+import { getChromeDiagnostics } from '../../connection/diagnostics.js';
+import { ChromeLaunchError, getErrorMessage } from '../../connection/errors.js';
+import { formatDiagnosticsForError } from '../../ui/messages/chrome.js';
+import { chromeBinaryOverrideNotFound, chromeBinaryOverrideNotExecutable, chromeBinaryOverrideIsDirectory, } from '../../ui/messages/chrome.js';
+/**
+ * Get formatted Chrome diagnostics for error messages.
+ *
+ * Retrieves Chrome installation information and formats it for display
+ * in error messages. Uses cached diagnostics to avoid repeated filesystem scans.
+ *
+ * @returns Array of formatted diagnostic strings
+ */
+function getFormattedDiagnostics() {
+    const diagnostics = getChromeDiagnostics();
+    return formatDiagnosticsForError(diagnostics);
+}
+/**
+ * Resolve Chrome binary path from options or environment variable.
+ *
+ * Validates that the resolved binary:
+ * - Exists on the filesystem
+ * - Is a regular file (not a directory)
+ * - Has execute permissions
+ *
+ * @param options - Configuration with optional chromePath
+ * @returns Resolved and validated Chrome binary path, or undefined if not specified
+ * @throws ChromeLaunchError if binary path is invalid or not executable
+ *
+ * @example
+ * ```typescript
+ * // From options
+ * const binary = resolveChromeBinary({ chromePath: '/usr/bin/google-chrome' });
+ *
+ * // From environment variable
+ * process.env['CHROME_PATH'] = '/opt/chrome/chrome';
+ * const binary = resolveChromeBinary({});
+ *
+ * // Not specified (returns undefined, launcher will use default)
+ * const binary = resolveChromeBinary({});
+ * ```
+ */
+export function resolveChromeBinary(options) {
+    const override = options.chromePath ?? process.env['CHROME_PATH'];
+    if (!override) {
+        return undefined;
+    }
+    const chromePath = override.trim();
+    if (!chromePath) {
+        return undefined;
+    }
+    const sourceLabel = options.chromePath ? 'chromePath option' : 'CHROME_PATH';
+    if (!fs.existsSync(chromePath)) {
+        const diagnostics = getFormattedDiagnostics();
+        throw new ChromeLaunchError(`${chromeBinaryOverrideNotFound(chromePath, sourceLabel)}\n\n${diagnostics.join('\n')}`);
+    }
+    try {
+        const stats = fs.statSync(chromePath);
+        if (stats.isDirectory()) {
+            throw new ChromeLaunchError(chromeBinaryOverrideIsDirectory(chromePath, sourceLabel));
+        }
+        fs.accessSync(chromePath, fs.constants.X_OK);
+    }
+    catch (error) {
+        if (error instanceof ChromeLaunchError) {
+            throw error;
+        }
+        throw new ChromeLaunchError(`${chromeBinaryOverrideNotExecutable(chromePath, sourceLabel)}\n\n${getErrorMessage(error)}`, error instanceof Error ? error : undefined);
+    }
+    return chromePath;
+}
+//# sourceMappingURL=binaryResolver.js.map

package/dist/connection/launcher/binaryResolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"binaryResolver.js","sourceRoot":"","sources":["../../../src/connection/launcher/binaryResolver.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AAEzB,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC5E,OAAO,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAC;AACpE,OAAO,EACL,4BAA4B,EAC5B,iCAAiC,EACjC,+BAA+B,GAChC,MAAM,yBAAyB,CAAC;AAUjC;;;;;;;GAOG;AACH,SAAS,uBAAuB;IAC9B,MAAM,WAAW,GAAG,oBAAoB,EAAE,CAAC;IAC3C,OAAO,yBAAyB,CAAC,WAAW,CAAC,CAAC;AAChD,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,UAAU,mBAAmB,CAAC,OAA8B;IAChE,MAAM,QAAQ,GAAG,OAAO,CAAC,UAAU,IAAI,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;IAElE,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,UAAU,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC;IACnC,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,aAAa,CAAC;IAE7E,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC/B,MAAM,WAAW,GAAG,uBAAuB,EAAE,CAAC;QAC9C,MAAM,IAAI,iBAAiB,CACzB,GAAG,4BAA4B,CAAC,UAAU,EAAE,WAAW,CAAC,OAAO,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACxF,CAAC;IACJ,CAAC;IAED,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;QACtC,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;YACxB,MAAM,IAAI,iBAAiB,CAAC,+BAA+B,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC,CAAC;QACxF,CAAC;QAED,EAAE,CAAC,UAAU,CAAC,UAAU,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IAC/C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,iBAAiB,EAAE,CAAC;YACvC,MAAM,KAAK,CAAC;QACd,CAAC;QAED,MAAM,IAAI,iBAAiB,CACzB,GAAG,iCAAiC,CAAC,UAAU,EAAE,WAAW,CAAC,OAAO,eAAe,CAAC,KAAK,CAAC,EAAE,EAC5F,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAC3C,CAAC;IACJ,CAAC;IAED,OAAO,UAAU,CAAC;AACpB,CAAC"}

package/dist/connection/launcher/flagsBuilder.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Chrome command-line flags builder.
+ *
+ * Constructs the Chrome flags array from launch options, handling:
+ * - Base chrome-launcher defaults
+ * - bdg-specific flags (remote debugging, etc.)
+ * - Docker environment detection and GPU-disabling flags
+ * - Headless mode
+ */
+/**
+ * Options that affect Chrome flags construction.
+ */
+export interface FlagsBuilderOptions {
+    /** CDP port number for remote debugging */
+    port?: number | undefined;
+    /** Whether to ignore chrome-launcher default flags */
+    ignoreDefaultFlags?: boolean | undefined;
+    /** Whether to launch in headless mode */
+    headless?: boolean | undefined;
+    /** Additional Chrome command-line flags */
+    chromeFlags?: string[] | undefined;
+}
+/**
+ * Check if running inside a Docker container.
+ *
+ * Detects Docker environment by checking for:
+ * 1. /.dockerenv file (standard Docker indicator)
+ * 2. "docker" or "containerd" in /proc/self/cgroup
+ *
+ * @returns True if running in Docker, false otherwise
+ */
+export declare function isDocker(): boolean;
+/**
+ * Build Chrome flags array from launch options.
+ *
+ * Uses chrome-launcher default flags as base (unless ignoreDefaultFlags is true)
+ * and layers bdg-specific overrides on top. Headless mode uses the new headless
+ * implementation for better compatibility.
+ *
+ * When running in Docker, automatically adds GPU-disabling flags to work around
+ * graphics limitations in containerized environments.
+ *
+ * @param options - Launch options containing flag preferences
+ * @returns Array of Chrome command-line flags
+ *
+ * @example
+ * ```typescript
+ * // Standard flags
+ * const flags = buildChromeFlags({ port: 9222 });
+ *
+ * // Headless with custom flags
+ * const flags = buildChromeFlags({
+ *   port: 9222,
+ *   headless: true,
+ *   chromeFlags: ['--window-size=1920,1080']
+ * });
+ *
+ * // Docker environment (auto-detects)
+ * const flags = buildChromeFlags({ port: 9222 });
+ * // Includes --disable-gpu, --no-sandbox if in Docker
+ * ```
+ */
+export declare function buildChromeFlags(options: FlagsBuilderOptions): string[];
+//# sourceMappingURL=flagsBuilder.d.ts.map

package/dist/connection/launcher/flagsBuilder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flagsBuilder.d.ts","sourceRoot":"","sources":["../../../src/connection/launcher/flagsBuilder.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAaH;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,2CAA2C;IAC3C,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,sDAAsD;IACtD,kBAAkB,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACzC,yCAAyC;IACzC,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC/B,2CAA2C;IAC3C,WAAW,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;CACpC;AAID;;;;;;;;GAQG;AACH,wBAAgB,QAAQ,IAAI,OAAO,CAelC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,mBAAmB,GAAG,MAAM,EAAE,CAoBvE"}

package/dist/connection/launcher/flagsBuilder.js

@@ -0,0 +1,84 @@
+/**
+ * Chrome command-line flags builder.
+ *
+ * Constructs the Chrome flags array from launch options, handling:
+ * - Base chrome-launcher defaults
+ * - bdg-specific flags (remote debugging, etc.)
+ * - Docker environment detection and GPU-disabling flags
+ * - Headless mode
+ */
+import * as fs from 'fs';
+import * as chromeLauncher from 'chrome-launcher';
+import { BDG_CHROME_FLAGS, DEFAULT_CDP_PORT, HEADLESS_FLAG, DOCKER_CHROME_FLAGS, } from '../../constants.js';
+const REMOTE_DEBUGGING_FLAG = (port) => `--remote-debugging-port=${port}`;
+/**
+ * Check if running inside a Docker container.
+ *
+ * Detects Docker environment by checking for:
+ * 1. /.dockerenv file (standard Docker indicator)
+ * 2. "docker" or "containerd" in /proc/self/cgroup
+ *
+ * @returns True if running in Docker, false otherwise
+ */
+export function isDocker() {
+    try {
+        if (fs.existsSync('/.dockerenv')) {
+            return true;
+        }
+        if (fs.existsSync('/proc/self/cgroup')) {
+            const cgroup = fs.readFileSync('/proc/self/cgroup', 'utf8');
+            return cgroup.includes('docker') || cgroup.includes('containerd');
+        }
+        return false;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Build Chrome flags array from launch options.
+ *
+ * Uses chrome-launcher default flags as base (unless ignoreDefaultFlags is true)
+ * and layers bdg-specific overrides on top. Headless mode uses the new headless
+ * implementation for better compatibility.
+ *
+ * When running in Docker, automatically adds GPU-disabling flags to work around
+ * graphics limitations in containerized environments.
+ *
+ * @param options - Launch options containing flag preferences
+ * @returns Array of Chrome command-line flags
+ *
+ * @example
+ * ```typescript
+ * // Standard flags
+ * const flags = buildChromeFlags({ port: 9222 });
+ *
+ * // Headless with custom flags
+ * const flags = buildChromeFlags({
+ *   port: 9222,
+ *   headless: true,
+ *   chromeFlags: ['--window-size=1920,1080']
+ * });
+ *
+ * // Docker environment (auto-detects)
+ * const flags = buildChromeFlags({ port: 9222 });
+ * // Includes --disable-gpu, --no-sandbox if in Docker
+ * ```
+ */
+export function buildChromeFlags(options) {
+    const port = options.port ?? DEFAULT_CDP_PORT;
+    const baseFlags = options.ignoreDefaultFlags ? [] : chromeLauncher.Launcher.defaultFlags();
+    const bdgFlags = [REMOTE_DEBUGGING_FLAG(port), ...BDG_CHROME_FLAGS];
+    const dockerFlags = isDocker() ? DOCKER_CHROME_FLAGS : [];
+    if (options.headless) {
+        return [
+            HEADLESS_FLAG,
+            ...baseFlags,
+            ...bdgFlags,
+            ...dockerFlags,
+            ...(options.chromeFlags ?? []),
+        ];
+    }
+    return [...baseFlags, ...bdgFlags, ...dockerFlags, ...(options.chromeFlags ?? [])];
+}
+//# sourceMappingURL=flagsBuilder.js.map

package/dist/connection/launcher/flagsBuilder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"flagsBuilder.js","sourceRoot":"","sources":["../../../src/connection/launcher/flagsBuilder.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AAEzB,OAAO,KAAK,cAAc,MAAM,iBAAiB,CAAC;AAElD,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,aAAa,EACb,mBAAmB,GACpB,MAAM,gBAAgB,CAAC;AAgBxB,MAAM,qBAAqB,GAAG,CAAC,IAAY,EAAU,EAAE,CAAC,2BAA2B,IAAI,EAAE,CAAC;AAE1F;;;;;;;;GAQG;AACH,MAAM,UAAU,QAAQ;IACtB,IAAI,CAAC;QACH,IAAI,EAAE,CAAC,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC;YACjC,OAAO,IAAI,CAAC;QACd,CAAC;QAED,IAAI,EAAE,CAAC,UAAU,CAAC,mBAAmB,CAAC,EAAE,CAAC;YACvC,MAAM,MAAM,GAAG,EAAE,CAAC,YAAY,CAAC,mBAAmB,EAAE,MAAM,CAAC,CAAC;YAC5D,OAAO,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;QACpE,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAA4B;IAC3D,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,gBAAgB,CAAC;IAE9C,MAAM,SAAS,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,cAAc,CAAC,QAAQ,CAAC,YAAY,EAAE,CAAC;IAE3F,MAAM,QAAQ,GAAa,CAAC,qBAAqB,CAAC,IAAI,CAAC,EAAE,GAAG,gBAAgB,CAAC,CAAC;IAE9E,MAAM,WAAW,GAAG,QAAQ,EAAE,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,EAAE,CAAC;IAE1D,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;QACrB,OAAO;YACL,aAAa;YACb,GAAG,SAAS;YACZ,GAAG,QAAQ;YACX,GAAG,WAAW;YACd,GAAG,CAAC,OAAO,CAAC,WAAW,IAAI,EAAE,CAAC;SAC/B,CAAC;IACJ,CAAC;IAED,OAAO,CAAC,GAAG,SAAS,EAAE,GAAG,QAAQ,EAAE,GAAG,WAAW,EAAE,GAAG,CAAC,OAAO,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC,CAAC;AACrF,CAAC"}

package/dist/connection/launcher/preferencesLoader.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Chrome preferences loader.
+ *
+ * Handles loading Chrome preferences from files or inline options,
+ * and validates that they are JSON-serializable for chrome-launcher compatibility.
+ */
+/**
+ * JSONLike type matching chrome-launcher's internal type definition.
+ *
+ * Used for Chrome preferences that must be JSON-serializable values.
+ * chrome-launcher enforces this constraint to ensure preferences can be
+ * safely serialized and passed to Chrome process.
+ */
+type JSONLike = {
+    [property: string]: JSONLike;
+} | readonly JSONLike[] | string | number | boolean | null;
+/**
+ * Options for loading Chrome preferences.
+ */
+export interface PreferencesLoaderOptions {
+    /** Path to JSON file containing Chrome preferences */
+    prefsFile?: string | undefined;
+    /** Inline Chrome preferences object */
+    prefs?: Record<string, unknown> | undefined;
+}
+/**
+ * Load Chrome preferences from file or inline options.
+ *
+ * Supports two modes:
+ * 1. **File-based**: Load preferences from JSON file (prefsFile)
+ * 2. **Inline**: Use preferences directly from options (prefs)
+ *
+ * File-based loading takes precedence over inline preferences.
+ *
+ * @param options - Options containing preferences configuration
+ * @returns Preferences object, or undefined if none specified
+ * @throws ChromeLaunchError if file doesn't exist, is invalid JSON, or wrong format
+ *
+ * @example
+ * ```typescript
+ * // From file
+ * const prefs = loadChromePrefs({ prefsFile: './chrome-prefs.json' });
+ *
+ * // Inline
+ * const prefs = loadChromePrefs({
+ *   prefs: {
+ *     'profile.default_content_settings.popups': 0,
+ *     'download.default_directory': '/tmp/downloads'
+ *   }
+ * });
+ * ```
+ */
+export declare function loadChromePrefs(options: PreferencesLoaderOptions): Record<string, unknown> | undefined;
+/**
+ * Type-safe conversion for Chrome preferences from unknown to JSONLike.
+ *
+ * chrome-launcher requires preferences to match its internal JSONLike type constraint
+ * for type safety. This function validates that preferences are JSON-serializable
+ * before casting to ensure runtime safety.
+ *
+ * @param prefs - Preferences object with unknown values from JSON parsing
+ * @returns Preferences compatible with chrome-launcher's JSONLike constraint, or undefined
+ * @throws ChromeLaunchError if preferences contain non-JSON-serializable values
+ *
+ * @example
+ * ```typescript
+ * const prefs = loadChromePrefs({ prefsFile: './prefs.json' });
+ * const compatible = ensureJSONCompatiblePrefs(prefs);
+ * // Now safe to pass to chrome-launcher
+ * ```
+ */
+export declare function ensureJSONCompatiblePrefs(prefs: Record<string, unknown> | undefined): Record<string, JSONLike> | undefined;
+export {};
+//# sourceMappingURL=preferencesLoader.d.ts.map

package/dist/connection/launcher/preferencesLoader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preferencesLoader.d.ts","sourceRoot":"","sources":["../../../src/connection/launcher/preferencesLoader.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAWH;;;;;;GAMG;AACH,KAAK,QAAQ,GACT;IACE,CAAC,QAAQ,EAAE,MAAM,GAAG,QAAQ,CAAC;CAC9B,GACD,SAAS,QAAQ,EAAE,GACnB,MAAM,GACN,MAAM,GACN,OAAO,GACP,IAAI,CAAC;AAET;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,sDAAsD;IACtD,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,uCAAuC;IACvC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;CAC7C;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,wBAAwB,GAChC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAkCrC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GACzC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,GAAG,SAAS,CAetC"}