@lhremote/core 0.0.0 → 0.1.0

package/dist/cdp/client.d.ts

@@ -0,0 +1,100 @@
+import type { Protocol } from "devtools-protocol";
+type EventListener = (params: unknown) => void;
+/**
+ * Chrome DevTools Protocol client.
+ *
+ * Communicates with a CDP-enabled process over WebSocket, providing:
+ * - Request/response correlation via incrementing message IDs
+ * - Event subscription
+ * - Convenience helpers for `Runtime.evaluate` and `Page.navigate`
+ * - Automatic reconnection with exponential backoff
+ */
+export declare class CDPClient {
+    private readonly port;
+    private readonly host;
+    private readonly timeout;
+    private ws;
+    private nextId;
+    private readonly pending;
+    private readonly listeners;
+    private connected;
+    private targetId;
+    private reconnecting;
+    constructor(port: number, options?: {
+        host?: string;
+        timeout?: number;
+    });
+    /**
+     * Open a WebSocket connection to a CDP target.
+     *
+     * @param targetId - Specific target ID to connect to.  When omitted the
+     *   first `page` target is used.
+     */
+    connect(targetId?: string): Promise<void>;
+    /**
+     * Close the connection.  Pending requests are rejected.
+     */
+    disconnect(): void;
+    /**
+     * Send a raw CDP method call and wait for the response.
+     *
+     * @param method - CDP method name, e.g. `"Runtime.evaluate"`.
+     * @param params - Method parameters.
+     * @returns The `result` field from the CDP response.
+     */
+    send(method: string, params?: Record<string, unknown>): Promise<unknown>;
+    /**
+     * Evaluate a JavaScript expression via `Runtime.evaluate`.
+     *
+     * @param expression  - JavaScript source to evaluate.
+     * @param awaitPromise - Whether to await a Promise result (default `false`).
+     * @returns The deserialized value from the remote context.
+     */
+    evaluate<T = unknown>(expression: string, awaitPromise?: boolean): Promise<T>;
+    /**
+     * Navigate the target to the given URL via `Page.navigate`.
+     */
+    navigate(url: string): Promise<Protocol.Page.NavigateResponse>;
+    /**
+     * Subscribe to a CDP event.
+     *
+     * @param event    - Event name, e.g. `"Page.loadEventFired"`.
+     * @param listener - Callback receiving the event parameters.
+     */
+    on(event: string, listener: EventListener): void;
+    /**
+     * Remove a previously registered event listener.
+     */
+    off(event: string, listener: EventListener): void;
+    /**
+     * Wait for a single occurrence of a CDP event.
+     *
+     * @param event   - Event name.
+     * @param timeout - Maximum wait time in ms (default: client timeout).
+     */
+    waitForEvent(event: string, timeout?: number): Promise<unknown>;
+    /** Whether the client currently has an open connection. */
+    get isConnected(): boolean;
+    /**
+     * Resolve a `ws://` URL for the given target ID, or the first page target.
+     */
+    private resolveWebSocketUrl;
+    /**
+     * Open a WebSocket and wire up message handling.
+     */
+    private openWebSocket;
+    /**
+     * Handle an incoming WebSocket message — either a method response or an event.
+     */
+    private handleMessage;
+    /**
+     * Attempt to reconnect with exponential backoff.
+     */
+    private attemptReconnect;
+    /**
+     * Reject all pending requests (used on disconnect / close).
+     */
+    private rejectAllPending;
+}
+export {};
+//# sourceMappingURL=client.d.ts.map

package/dist/cdp/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/cdp/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAwBlD,KAAK,aAAa,GAAG,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,CAAC;AAE/C;;;;;;;;GAQG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IAEjC,OAAO,CAAC,EAAE,CAA0B;IACpC,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqC;IAC7D,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAyC;IAEnE,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,QAAQ,CAAuB;IACvC,OAAO,CAAC,YAAY,CAAS;gBAG3B,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE;IAO/C;;;;;OAKG;IACG,OAAO,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAK/C;;OAEG;IACH,UAAU,IAAI,IAAI;IAUlB;;;;;;OAMG;IACG,IAAI,CACR,MAAM,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B,OAAO,CAAC,OAAO,CAAC;IAoBnB;;;;;;OAMG;IACG,QAAQ,CAAC,CAAC,GAAG,OAAO,EACxB,UAAU,EAAE,MAAM,EAClB,YAAY,UAAQ,GACnB,OAAO,CAAC,CAAC,CAAC;IAqBb;;OAEG;IACG,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,gBAAgB,CAAC;IAMpE;;;;;OAKG;IACH,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,GAAG,IAAI;IAShD;;OAEG;IACH,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,GAAG,IAAI;IAIjD;;;;;OAKG;IACG,YAAY,CAChB,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,OAAO,CAAC;IAmBnB,2DAA2D;IAC3D,IAAI,WAAW,IAAI,OAAO,CAEzB;IAMD;;OAEG;YACW,mBAAmB;IA8BjC;;OAEG;IACH,OAAO,CAAC,aAAa;IA2CrB;;OAEG;IACH,OAAO,CAAC,aAAa;IAmCrB;;OAEG;YACW,gBAAgB;IAsB9B;;OAEG;IACH,OAAO,CAAC,gBAAgB;CAOzB"}

package/dist/cdp/client.integration.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=client.integration.test.d.ts.map

package/dist/cdp/client.integration.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.integration.test.d.ts","sourceRoot":"","sources":["../../src/cdp/client.integration.test.ts"],"names":[],"mappings":""}

package/dist/cdp/client.integration.test.js

@@ -0,0 +1,70 @@
+import { afterAll, afterEach, beforeAll, describe, expect, it } from "vitest";
+import { CDPClient } from "./client.js";
+import { CDPEvaluationError } from "./errors.js";
+import { launchChromium, } from "./testing/launch-chromium.js";
+describe("CDPClient (integration)", () => {
+    let chromium;
+    let client;
+    beforeAll(async () => {
+        chromium = await launchChromium();
+    }, 30_000);
+    afterAll(async () => {
+        await chromium.close();
+    });
+    afterEach(() => {
+        client.disconnect();
+    });
+    describe("connect", () => {
+        it("should connect to a real Chromium page target", async () => {
+            client = new CDPClient(chromium.port);
+            await client.connect();
+            expect(client.isConnected).toBe(true);
+        });
+    });
+    describe("evaluate", () => {
+        it("should evaluate a JavaScript expression", async () => {
+            client = new CDPClient(chromium.port);
+            await client.connect();
+            const result = await client.evaluate("2 + 2");
+            expect(result).toBe(4);
+        });
+        it("should evaluate expressions returning objects", async () => {
+            client = new CDPClient(chromium.port);
+            await client.connect();
+            const result = await client.evaluate("({ a: 1, b: 'hello' })");
+            expect(result).toEqual({ a: 1, b: "hello" });
+        });
+        it("should throw CDPEvaluationError on runtime exception", async () => {
+            client = new CDPClient(chromium.port);
+            await client.connect();
+            await expect(client.evaluate("throw new Error('test error')")).rejects.toThrow(CDPEvaluationError);
+        });
+        it("should await promise results when awaitPromise is true", async () => {
+            client = new CDPClient(chromium.port);
+            await client.connect();
+            const result = await client.evaluate("Promise.resolve(42)", true);
+            expect(result).toBe(42);
+        });
+    });
+    describe("navigate", () => {
+        it("should navigate to a data URL", async () => {
+            client = new CDPClient(chromium.port);
+            await client.connect();
+            const response = await client.navigate("data:text/html,<h1>Integration Test</h1>");
+            expect(response.frameId).toEqual(expect.any(String));
+        });
+    });
+    describe("events", () => {
+        it("should receive CDP events from the browser", async () => {
+            client = new CDPClient(chromium.port);
+            await client.connect();
+            // Enable Page domain to receive events
+            await client.send("Page.enable");
+            const eventPromise = client.waitForEvent("Page.loadEventFired", 10_000);
+            await client.navigate("data:text/html,<h1>Event Test</h1>");
+            const params = (await eventPromise);
+            expect(params.timestamp).toEqual(expect.any(Number));
+        });
+    });
+});
+//# sourceMappingURL=client.integration.test.js.map

package/dist/cdp/client.integration.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.integration.test.js","sourceRoot":"","sources":["../../src/cdp/client.integration.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9E,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EACL,cAAc,GAEf,MAAM,8BAA8B,CAAC;AAEtC,QAAQ,CAAC,yBAAyB,EAAE,GAAG,EAAE;IACvC,IAAI,QAA0B,CAAC;IAC/B,IAAI,MAAiB,CAAC;IAEtB,SAAS,CAAC,KAAK,IAAI,EAAE;QACnB,QAAQ,GAAG,MAAM,cAAc,EAAE,CAAC;IACpC,CAAC,EAAE,MAAM,CAAC,CAAC;IAEX,QAAQ,CAAC,KAAK,IAAI,EAAE;QAClB,MAAM,QAAQ,CAAC,KAAK,EAAE,CAAC;IACzB,CAAC,CAAC,CAAC;IAEH,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,CAAC,UAAU,EAAE,CAAC;IACtB,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,SAAS,EAAE,GAAG,EAAE;QACvB,EAAE,CAAC,+CAA+C,EAAE,KAAK,IAAI,EAAE;YAC7D,MAAM,GAAG,IAAI,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;YACtC,MAAM,MAAM,CAAC,OAAO,EAAE,CAAC;YAEvB,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACxC,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,UAAU,EAAE,GAAG,EAAE;QACxB,EAAE,CAAC,yCAAyC,EAAE,KAAK,IAAI,EAAE;YACvD,MAAM,GAAG,IAAI,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;YACtC,MAAM,MAAM,CAAC,OAAO,EAAE,CAAC;YAEvB,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAS,OAAO,CAAC,CAAC;YAEtD,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACzB,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,+CAA+C,EAAE,KAAK,IAAI,EAAE;YAC7D,MAAM,GAAG,IAAI,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;YACtC,MAAM,MAAM,CAAC,OAAO,EAAE,CAAC;YAEvB,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,QAAQ,CAClC,wBAAwB,CACzB,CAAC;YAEF,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC;QAC/C,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,sDAAsD,EAAE,KAAK,IAAI,EAAE;YACpE,MAAM,GAAG,IAAI,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;YACtC,MAAM,MAAM,CAAC,OAAO,EAAE,CAAC;YAEvB,MAAM,MAAM,CACV,MAAM,CAAC,QAAQ,CAAC,+BAA+B,CAAC,CACjD,CAAC,OAAO,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAC;QACxC,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,wDAAwD,EAAE,KAAK,IAAI,EAAE;YACtE,MAAM,GAAG,IAAI,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;YACtC,MAAM,MAAM,CAAC,OAAO,EAAE,CAAC;YAEvB,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,QAAQ,CAClC,qBAAqB,EACrB,IAAI,CACL,CAAC;YAEF,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC1B,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,UAAU,EAAE,GAAG,EAAE;QACxB,EAAE,CAAC,+BAA+B,EAAE,KAAK,IAAI,EAAE;YAC7C,MAAM,GAAG,IAAI,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;YACtC,MAAM,MAAM,CAAC,OAAO,EAAE,CAAC;YAEvB,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,QAAQ,CACpC,0CAA0C,CAC3C,CAAC;YAEF,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;QACvD,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,QAAQ,EAAE,GAAG,EAAE;QACtB,EAAE,CAAC,4CAA4C,EAAE,KAAK,IAAI,EAAE;YAC1D,MAAM,GAAG,IAAI,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;YACtC,MAAM,MAAM,CAAC,OAAO,EAAE,CAAC;YAEvB,uCAAuC;YACvC,MAAM,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;YAEjC,MAAM,YAAY,GAAG,MAAM,CAAC,YAAY,CACtC,qBAAqB,EACrB,MAAM,CACP,CAAC;YAEF,MAAM,MAAM,CAAC,QAAQ,CAAC,oCAAoC,CAAC,CAAC;YAE5D,MAAM,MAAM,GAAG,CAAC,MAAM,YAAY,CAA0B,CAAC;YAC7D,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;QACvD,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/cdp/client.js

@@ -0,0 +1,286 @@
+import { CDPConnectionError, CDPEvaluationError, CDPTimeoutError, } from "./errors.js";
+import { discoverTargets } from "./discovery.js";
+/** Default timeout for CDP requests (ms). */
+const DEFAULT_TIMEOUT = 30_000;
+/** Maximum reconnection attempts before giving up. */
+const MAX_RECONNECT_ATTEMPTS = 5;
+/** Base delay for exponential backoff (ms). */
+const RECONNECT_BASE_DELAY = 500;
+/**
+ * Chrome DevTools Protocol client.
+ *
+ * Communicates with a CDP-enabled process over WebSocket, providing:
+ * - Request/response correlation via incrementing message IDs
+ * - Event subscription
+ * - Convenience helpers for `Runtime.evaluate` and `Page.navigate`
+ * - Automatic reconnection with exponential backoff
+ */
+export class CDPClient {
+    port;
+    host;
+    timeout;
+    ws = null;
+    nextId = 1;
+    pending = new Map();
+    listeners = new Map();
+    connected = false;
+    targetId = null;
+    reconnecting = false;
+    constructor(port, options) {
+        this.port = port;
+        this.host = options?.host ?? "127.0.0.1";
+        this.timeout = options?.timeout ?? DEFAULT_TIMEOUT;
+    }
+    /**
+     * Open a WebSocket connection to a CDP target.
+     *
+     * @param targetId - Specific target ID to connect to.  When omitted the
+     *   first `page` target is used.
+     */
+    async connect(targetId) {
+        const wsUrl = await this.resolveWebSocketUrl(targetId);
+        await this.openWebSocket(wsUrl);
+    }
+    /**
+     * Close the connection.  Pending requests are rejected.
+     */
+    disconnect() {
+        this.connected = false;
+        this.rejectAllPending(new CDPConnectionError("Client disconnected"));
+        if (this.ws) {
+            this.ws.close();
+            this.ws = null;
+        }
+    }
+    /**
+     * Send a raw CDP method call and wait for the response.
+     *
+     * @param method - CDP method name, e.g. `"Runtime.evaluate"`.
+     * @param params - Method parameters.
+     * @returns The `result` field from the CDP response.
+     */
+    async send(method, params) {
+        const ws = this.ws;
+        if (!ws || !this.connected) {
+            throw new CDPConnectionError("Not connected");
+        }
+        const id = this.nextId++;
+        const message = JSON.stringify({ id, method, params });
+        return new Promise((resolve, reject) => {
+            const timer = setTimeout(() => {
+                this.pending.delete(id);
+                reject(new CDPTimeoutError(`Timed out waiting for response to ${method} (id=${id.toString()})`));
+            }, this.timeout);
+            this.pending.set(id, { resolve, reject, timer });
+            ws.send(message);
+        });
+    }
+    /**
+     * Evaluate a JavaScript expression via `Runtime.evaluate`.
+     *
+     * @param expression  - JavaScript source to evaluate.
+     * @param awaitPromise - Whether to await a Promise result (default `false`).
+     * @returns The deserialized value from the remote context.
+     */
+    async evaluate(expression, awaitPromise = false) {
+        const result = (await this.send("Runtime.evaluate", {
+            expression,
+            awaitPromise,
+            returnByValue: true,
+        }));
+        if (result.exceptionDetails) {
+            const desc = result.exceptionDetails.exception?.description ??
+                result.exceptionDetails.text ??
+                "Unknown evaluation error";
+            throw new CDPEvaluationError(desc);
+        }
+        return result.result?.value;
+    }
+    /**
+     * Navigate the target to the given URL via `Page.navigate`.
+     */
+    async navigate(url) {
+        return (await this.send("Page.navigate", {
+            url,
+        }));
+    }
+    /**
+     * Subscribe to a CDP event.
+     *
+     * @param event    - Event name, e.g. `"Page.loadEventFired"`.
+     * @param listener - Callback receiving the event parameters.
+     */
+    on(event, listener) {
+        let set = this.listeners.get(event);
+        if (!set) {
+            set = new Set();
+            this.listeners.set(event, set);
+        }
+        set.add(listener);
+    }
+    /**
+     * Remove a previously registered event listener.
+     */
+    off(event, listener) {
+        this.listeners.get(event)?.delete(listener);
+    }
+    /**
+     * Wait for a single occurrence of a CDP event.
+     *
+     * @param event   - Event name.
+     * @param timeout - Maximum wait time in ms (default: client timeout).
+     */
+    async waitForEvent(event, timeout) {
+        const ms = timeout ?? this.timeout;
+        return new Promise((resolve, reject) => {
+            const timer = setTimeout(() => {
+                this.off(event, handler);
+                reject(new CDPTimeoutError(`Timed out waiting for event ${event}`));
+            }, ms);
+            const handler = (params) => {
+                clearTimeout(timer);
+                this.off(event, handler);
+                resolve(params);
+            };
+            this.on(event, handler);
+        });
+    }
+    /** Whether the client currently has an open connection. */
+    get isConnected() {
+        return this.connected;
+    }
+    // ---------------------------------------------------------------------------
+    // Private
+    // ---------------------------------------------------------------------------
+    /**
+     * Resolve a `ws://` URL for the given target ID, or the first page target.
+     */
+    async resolveWebSocketUrl(targetId) {
+        const targets = await discoverTargets(this.port, this.host);
+        let target;
+        if (targetId) {
+            target = targets.find((t) => t.id === targetId);
+        }
+        else {
+            target = targets.find((t) => t.type === "page");
+        }
+        if (!target) {
+            throw new CDPConnectionError(targetId
+                ? `Target ${targetId} not found among ${targets.length.toString()} targets`
+                : `No page target found among ${targets.length.toString()} targets`);
+        }
+        if (!target.webSocketDebuggerUrl) {
+            throw new CDPConnectionError(`Target ${target.id} has no webSocketDebuggerUrl (another debugger may be attached)`);
+        }
+        this.targetId = target.id;
+        return target.webSocketDebuggerUrl;
+    }
+    /**
+     * Open a WebSocket and wire up message handling.
+     */
+    openWebSocket(url) {
+        return new Promise((resolve, reject) => {
+            const ws = new WebSocket(url);
+            let settled = false;
+            ws.addEventListener("open", () => {
+                if (settled)
+                    return;
+                settled = true;
+                this.ws = ws;
+                this.connected = true;
+                resolve();
+            });
+            ws.addEventListener("message", (event) => {
+                const data = event.data;
+                this.handleMessage(typeof data === "string" ? data : String(data));
+            });
+            ws.addEventListener("close", () => {
+                const wasConnected = this.connected;
+                this.connected = false;
+                this.rejectAllPending(new CDPConnectionError("WebSocket closed"));
+                if (!settled) {
+                    settled = true;
+                    reject(new CDPConnectionError(`WebSocket closed before opening to ${url}`));
+                }
+                else if (wasConnected) {
+                    void this.attemptReconnect();
+                }
+            });
+            ws.addEventListener("error", () => {
+                if (!settled) {
+                    settled = true;
+                    reject(new CDPConnectionError(`WebSocket connection failed to ${url}`));
+                }
+            });
+        });
+    }
+    /**
+     * Handle an incoming WebSocket message — either a method response or an event.
+     */
+    handleMessage(raw) {
+        let msg;
+        try {
+            msg = JSON.parse(raw);
+        }
+        catch {
+            return; // ignore malformed frames
+        }
+        // Response to a pending request
+        if (msg.id !== undefined) {
+            const pending = this.pending.get(msg.id);
+            if (pending) {
+                this.pending.delete(msg.id);
+                clearTimeout(pending.timer);
+                if (msg.error) {
+                    pending.reject(new CDPEvaluationError(msg.error.message));
+                }
+                else {
+                    pending.resolve(msg.result);
+                }
+            }
+            return;
+        }
+        // Event
+        if (msg.method) {
+            const set = this.listeners.get(msg.method);
+            if (set) {
+                for (const listener of set) {
+                    listener(msg.params);
+                }
+            }
+        }
+    }
+    /**
+     * Attempt to reconnect with exponential backoff.
+     */
+    async attemptReconnect() {
+        if (this.reconnecting || !this.targetId) {
+            return;
+        }
+        this.reconnecting = true;
+        for (let attempt = 0; attempt < MAX_RECONNECT_ATTEMPTS; attempt++) {
+            const delay = RECONNECT_BASE_DELAY * 2 ** attempt;
+            await new Promise((r) => setTimeout(r, delay));
+            try {
+                await this.connect(this.targetId ?? undefined);
+                this.reconnecting = false;
+                return;
+            }
+            catch {
+                // continue to next attempt
+            }
+        }
+        this.reconnecting = false;
+    }
+    /**
+     * Reject all pending requests (used on disconnect / close).
+     */
+    rejectAllPending(error) {
+        for (const [id, pending] of this.pending) {
+            clearTimeout(pending.timer);
+            pending.reject(error);
+            this.pending.delete(id);
+        }
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/cdp/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/cdp/client.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,eAAe,GAChB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEjD,6CAA6C;AAC7C,MAAM,eAAe,GAAG,MAAM,CAAC;AAE/B,sDAAsD;AACtD,MAAM,sBAAsB,GAAG,CAAC,CAAC;AAEjC,+CAA+C;AAC/C,MAAM,oBAAoB,GAAG,GAAG,CAAC;AAUjC;;;;;;;;GAQG;AACH,MAAM,OAAO,SAAS;IACH,IAAI,CAAS;IACb,IAAI,CAAS;IACb,OAAO,CAAS;IAEzB,EAAE,GAAqB,IAAI,CAAC;IAC5B,MAAM,GAAG,CAAC,CAAC;IACF,OAAO,GAAG,IAAI,GAAG,EAA0B,CAAC;IAC5C,SAAS,GAAG,IAAI,GAAG,EAA8B,CAAC;IAE3D,SAAS,GAAG,KAAK,CAAC;IAClB,QAAQ,GAAkB,IAAI,CAAC;IAC/B,YAAY,GAAG,KAAK,CAAC;IAE7B,YACE,IAAY,EACZ,OAA6C;QAE7C,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,IAAI,GAAG,OAAO,EAAE,IAAI,IAAI,WAAW,CAAC;QACzC,IAAI,CAAC,OAAO,GAAG,OAAO,EAAE,OAAO,IAAI,eAAe,CAAC;IACrD,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,OAAO,CAAC,QAAiB;QAC7B,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,mBAAmB,CAAC,QAAQ,CAAC,CAAC;QACvD,MAAM,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;IAClC,CAAC;IAED;;OAEG;IACH,UAAU;QACR,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC;QACvB,IAAI,CAAC,gBAAgB,CAAC,IAAI,kBAAkB,CAAC,qBAAqB,CAAC,CAAC,CAAC;QAErE,IAAI,IAAI,CAAC,EAAE,EAAE,CAAC;YACZ,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC;YAChB,IAAI,CAAC,EAAE,GAAG,IAAI,CAAC;QACjB,CAAC;IACH,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,IAAI,CACR,MAAc,EACd,MAAgC;QAEhC,MAAM,EAAE,GAAG,IAAI,CAAC,EAAE,CAAC;QACnB,IAAI,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;YAC3B,MAAM,IAAI,kBAAkB,CAAC,eAAe,CAAC,CAAC;QAChD,CAAC;QAED,MAAM,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;QACzB,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;QAEvD,OAAO,IAAI,OAAO,CAAU,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YAC9C,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;gBAC5B,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;gBACxB,MAAM,CAAC,IAAI,eAAe,CAAC,qCAAqC,MAAM,QAAQ,EAAE,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,CAAC;YACnG,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;YAEjB,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;YACjD,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACnB,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,QAAQ,CACZ,UAAkB,EAClB,YAAY,GAAG,KAAK;QAEpB,MAAM,MAAM,GAAG,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,kBAAkB,EAAE;YAClD,UAAU;YACV,YAAY;YACZ,aAAa,EAAE,IAAI;SACpB,CAAC,CAGD,CAAC;QAEF,IAAI,MAAM,CAAC,gBAAgB,EAAE,CAAC;YAC5B,MAAM,IAAI,GACR,MAAM,CAAC,gBAAgB,CAAC,SAAS,EAAE,WAAW;gBAC9C,MAAM,CAAC,gBAAgB,CAAC,IAAI;gBAC5B,0BAA0B,CAAC;YAC7B,MAAM,IAAI,kBAAkB,CAAC,IAAI,CAAC,CAAC;QACrC,CAAC;QAED,OAAO,MAAM,CAAC,MAAM,EAAE,KAAU,CAAC;IACnC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,QAAQ,CAAC,GAAW;QACxB,OAAO,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE;YACvC,GAAG;SACJ,CAAC,CAAmC,CAAC;IACxC,CAAC;IAED;;;;;OAKG;IACH,EAAE,CAAC,KAAa,EAAE,QAAuB;QACvC,IAAI,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACpC,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,GAAG,GAAG,IAAI,GAAG,EAAE,CAAC;YAChB,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QACjC,CAAC;QACD,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACpB,CAAC;IAED;;OAEG;IACH,GAAG,CAAC,KAAa,EAAE,QAAuB;QACxC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC9C,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,YAAY,CAChB,KAAa,EACb,OAAgB;QAEhB,MAAM,EAAE,GAAG,OAAO,IAAI,IAAI,CAAC,OAAO,CAAC;QAEnC,OAAO,IAAI,OAAO,CAAU,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YAC9C,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;gBAC5B,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;gBACzB,MAAM,CAAC,IAAI,eAAe,CAAC,+BAA+B,KAAK,EAAE,CAAC,CAAC,CAAC;YACtE,CAAC,EAAE,EAAE,CAAC,CAAC;YAEP,MAAM,OAAO,GAAkB,CAAC,MAAM,EAAE,EAAE;gBACxC,YAAY,CAAC,KAAK,CAAC,CAAC;gBACpB,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;gBACzB,OAAO,CAAC,MAAM,CAAC,CAAC;YAClB,CAAC,CAAC;YAEF,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QAC1B,CAAC,CAAC,CAAC;IACL,CAAC;IAED,2DAA2D;IAC3D,IAAI,WAAW;QACb,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;IAED,8EAA8E;IAC9E,UAAU;IACV,8EAA8E;IAE9E;;OAEG;IACK,KAAK,CAAC,mBAAmB,CAC/B,QAAiB;QAEjB,MAAM,OAAO,GAAG,MAAM,eAAe,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;QAE5D,IAAI,MAA6B,CAAC;QAClC,IAAI,QAAQ,EAAE,CAAC;YACb,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,QAAQ,CAAC,CAAC;QAClD,CAAC;aAAM,CAAC;YACN,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC;QAClD,CAAC;QAED,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,kBAAkB,CAC1B,QAAQ;gBACN,CAAC,CAAC,UAAU,QAAQ,oBAAoB,OAAO,CAAC,MAAM,CAAC,QAAQ,EAAE,UAAU;gBAC3E,CAAC,CAAC,8BAA8B,OAAO,CAAC,MAAM,CAAC,QAAQ,EAAE,UAAU,CACtE,CAAC;QACJ,CAAC;QAED,IAAI,CAAC,MAAM,CAAC,oBAAoB,EAAE,CAAC;YACjC,MAAM,IAAI,kBAAkB,CAC1B,UAAU,MAAM,CAAC,EAAE,iEAAiE,CACrF,CAAC;QACJ,CAAC;QAED,IAAI,CAAC,QAAQ,GAAG,MAAM,CAAC,EAAE,CAAC;QAC1B,OAAO,MAAM,CAAC,oBAAoB,CAAC;IACrC,CAAC;IAED;;OAEG;IACK,aAAa,CAAC,GAAW;QAC/B,OAAO,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YAC3C,MAAM,EAAE,GAAG,IAAI,SAAS,CAAC,GAAG,CAAC,CAAC;YAC9B,IAAI,OAAO,GAAG,KAAK,CAAC;YAEpB,EAAE,CAAC,gBAAgB,CAAC,MAAM,EAAE,GAAG,EAAE;gBAC/B,IAAI,OAAO;oBAAE,OAAO;gBACpB,OAAO,GAAG,IAAI,CAAC;gBACf,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;gBACb,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;gBACtB,OAAO,EAAE,CAAC;YACZ,CAAC,CAAC,CAAC;YAEH,EAAE,CAAC,gBAAgB,CAAC,SAAS,EAAE,CAAC,KAAmB,EAAE,EAAE;gBACrD,MAAM,IAAI,GAAY,KAAK,CAAC,IAAI,CAAC;gBACjC,IAAI,CAAC,aAAa,CAChB,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAC/C,CAAC;YACJ,CAAC,CAAC,CAAC;YAEH,EAAE,CAAC,gBAAgB,CAAC,OAAO,EAAE,GAAG,EAAE;gBAChC,MAAM,YAAY,GAAG,IAAI,CAAC,SAAS,CAAC;gBACpC,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC;gBACvB,IAAI,CAAC,gBAAgB,CAAC,IAAI,kBAAkB,CAAC,kBAAkB,CAAC,CAAC,CAAC;gBAClE,IAAI,CAAC,OAAO,EAAE,CAAC;oBACb,OAAO,GAAG,IAAI,CAAC;oBACf,MAAM,CAAC,IAAI,kBAAkB,CAAC,sCAAsC,GAAG,EAAE,CAAC,CAAC,CAAC;gBAC9E,CAAC;qBAAM,IAAI,YAAY,EAAE,CAAC;oBACxB,KAAK,IAAI,CAAC,gBAAgB,EAAE,CAAC;gBAC/B,CAAC;YACH,CAAC,CAAC,CAAC;YAEH,EAAE,CAAC,gBAAgB,CAAC,OAAO,EAAE,GAAG,EAAE;gBAChC,IAAI,CAAC,OAAO,EAAE,CAAC;oBACb,OAAO,GAAG,IAAI,CAAC;oBACf,MAAM,CACJ,IAAI,kBAAkB,CAAC,kCAAkC,GAAG,EAAE,CAAC,CAChE,CAAC;gBACJ,CAAC;YACH,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACK,aAAa,CAAC,GAAW;QAC/B,IAAI,GAAsG,CAAC;QAC3G,IAAI,CAAC;YACH,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAe,CAAC;QACtC,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,CAAC,0BAA0B;QACpC,CAAC;QAED,gCAAgC;QAChC,IAAI,GAAG,CAAC,EAAE,KAAK,SAAS,EAAE,CAAC;YACzB,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YACzC,IAAI,OAAO,EAAE,CAAC;gBACZ,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;gBAC5B,YAAY,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;gBAE5B,IAAI,GAAG,CAAC,KAAK,EAAE,CAAC;oBACd,OAAO,CAAC,MAAM,CAAC,IAAI,kBAAkB,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;gBAC5D,CAAC;qBAAM,CAAC;oBACN,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;gBAC9B,CAAC;YACH,CAAC;YACD,OAAO;QACT,CAAC;QAED,QAAQ;QACR,IAAI,GAAG,CAAC,MAAM,EAAE,CAAC;YACf,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;YAC3C,IAAI,GAAG,EAAE,CAAC;gBACR,KAAK,MAAM,QAAQ,IAAI,GAAG,EAAE,CAAC;oBAC3B,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;gBACvB,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,gBAAgB;QAC5B,IAAI,IAAI,CAAC,YAAY,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACxC,OAAO;QACT,CAAC;QACD,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;QAEzB,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,GAAG,sBAAsB,EAAE,OAAO,EAAE,EAAE,CAAC;YAClE,MAAM,KAAK,GAAG,oBAAoB,GAAG,CAAC,IAAI,OAAO,CAAC;YAClD,MAAM,IAAI,OAAO,CAAO,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC;YAErD,IAAI,CAAC;gBACH,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,IAAI,SAAS,CAAC,CAAC;gBAC/C,IAAI,CAAC,YAAY,GAAG,KAAK,CAAC;gBAC1B,OAAO;YACT,CAAC;YAAC,MAAM,CAAC;gBACP,2BAA2B;YAC7B,CAAC;QACH,CAAC;QAED,IAAI,CAAC,YAAY,GAAG,KAAK,CAAC;IAC5B,CAAC;IAED;;OAEG;IACK,gBAAgB,CAAC,KAAY;QACnC,KAAK,MAAM,CAAC,EAAE,EAAE,OAAO,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACzC,YAAY,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;YAC5B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACtB,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC;CACF"}

package/dist/cdp/client.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=client.test.d.ts.map

package/dist/cdp/client.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.test.d.ts","sourceRoot":"","sources":["../../src/cdp/client.test.ts"],"names":[],"mappings":""}