@lhremote/core 0.0.0 → 0.1.0

package/dist/cdp/client.test.js

@@ -0,0 +1,269 @@
+import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
+import { CDPConnectionError, CDPEvaluationError, CDPTimeoutError, } from "./errors.js";
+import { CDPClient } from "./client.js";
+// Mock discovery so CDPClient.connect() resolves a WebSocket URL
+// without actually hitting a real HTTP endpoint.
+vi.mock("./discovery.js", () => ({
+    discoverTargets: vi.fn(),
+}));
+import { discoverTargets } from "./discovery.js";
+/**
+ * Minimal mock that simulates the browser-standard WebSocket API
+ * used by Node 22's global WebSocket.
+ */
+class MockWebSocket {
+    static instances = [];
+    eventHandlers = new Map();
+    url;
+    readyState = 0; // CONNECTING
+    constructor(url) {
+        this.url = typeof url === "string" ? url : url.toString();
+        MockWebSocket.instances.push(this);
+        // Simulate async open
+        queueMicrotask(() => {
+            this.readyState = 1; // OPEN
+            this.emit("open", {});
+        });
+    }
+    addEventListener(event, handler) {
+        let set = this.eventHandlers.get(event);
+        if (!set) {
+            set = new Set();
+            this.eventHandlers.set(event, set);
+        }
+        set.add(handler);
+    }
+    send = () => {
+        // default no-op, overridden by tests
+    };
+    close() {
+        this.readyState = 3; // CLOSED
+    }
+    // Test helpers
+    emit(event, data) {
+        const set = this.eventHandlers.get(event);
+        if (set) {
+            for (const handler of set) {
+                handler(data);
+            }
+        }
+    }
+    /** Simulate receiving a CDP message from the server. */
+    receiveMessage(obj) {
+        this.emit("message", { data: JSON.stringify(obj) });
+    }
+}
+// Replace the global WebSocket with our mock
+vi.stubGlobal("WebSocket", MockWebSocket);
+const MOCK_TARGETS = [
+    {
+        description: "",
+        devtoolsFrontendUrl: "",
+        id: "PAGE1",
+        type: "page",
+        title: "Test Page",
+        url: "about:blank",
+        webSocketDebuggerUrl: "ws://127.0.0.1:9222/devtools/page/PAGE1",
+    },
+];
+function lastMockWs() {
+    const ws = MockWebSocket.instances[MockWebSocket.instances.length - 1];
+    if (!ws) {
+        throw new Error("No MockWebSocket instance created");
+    }
+    return ws;
+}
+describe("CDPClient", () => {
+    let client;
+    beforeEach(() => {
+        MockWebSocket.instances = [];
+        vi.mocked(discoverTargets).mockResolvedValue(MOCK_TARGETS);
+        client = new CDPClient(9222, { timeout: 500 });
+    });
+    afterEach(() => {
+        client.disconnect();
+        vi.restoreAllMocks();
+    });
+    describe("connect", () => {
+        it("should connect to the first page target by default", async () => {
+            await client.connect();
+            expect(client.isConnected).toBe(true);
+            expect(discoverTargets).toHaveBeenCalledWith(9222, "127.0.0.1");
+            expect(MockWebSocket.instances).toHaveLength(1);
+            expect(lastMockWs().url).toBe("ws://127.0.0.1:9222/devtools/page/PAGE1");
+        });
+        it("should connect to a specific target by ID", async () => {
+            await client.connect("PAGE1");
+            expect(client.isConnected).toBe(true);
+        });
+        it("should throw when target ID not found", async () => {
+            await expect(client.connect("NONEXISTENT")).rejects.toThrow(CDPConnectionError);
+        });
+        it("should throw when target has no webSocketDebuggerUrl", async () => {
+            vi.mocked(discoverTargets).mockResolvedValue([
+                {
+                    description: "",
+                    devtoolsFrontendUrl: "",
+                    id: "NOURL",
+                    type: "page",
+                    title: "No WS",
+                    url: "about:blank",
+                },
+            ]);
+            await expect(client.connect()).rejects.toThrow(/webSocketDebuggerUrl/);
+        });
+    });
+    describe("send", () => {
+        it("should throw when not connected", async () => {
+            await expect(client.send("Runtime.evaluate")).rejects.toThrow(CDPConnectionError);
+        });
+        it("should correlate request and response by message ID", async () => {
+            await client.connect();
+            const ws = lastMockWs();
+            let sentMessage;
+            ws.send = (data) => {
+                sentMessage = data;
+            };
+            const resultPromise = client.send("Runtime.evaluate", {
+                expression: "1+1",
+            });
+            // Wait for send to be called
+            await vi.waitFor(() => expect(sentMessage).toBeDefined());
+            const parsed = JSON.parse(sentMessage);
+            expect(parsed.method).toBe("Runtime.evaluate");
+            // Simulate response
+            ws.receiveMessage({
+                id: parsed.id,
+                result: { result: { type: "number", value: 2 } },
+            });
+            const result = await resultPromise;
+            expect(result).toEqual({ result: { type: "number", value: 2 } });
+        });
+        it("should reject on CDP error response", async () => {
+            await client.connect();
+            const ws = lastMockWs();
+            let sentId;
+            ws.send = (data) => {
+                sentId = JSON.parse(data).id;
+            };
+            const resultPromise = client.send("BadMethod");
+            await vi.waitFor(() => expect(sentId).toBeDefined());
+            ws.receiveMessage({
+                id: sentId,
+                error: { message: "Method not found" },
+            });
+            await expect(resultPromise).rejects.toThrow(CDPEvaluationError);
+            await expect(resultPromise).rejects.toThrow(/Method not found/);
+        });
+        it("should reject on timeout", async () => {
+            await client.connect();
+            const ws = lastMockWs();
+            ws.send = () => {
+                /* swallow, never respond */
+            };
+            await expect(client.send("Slow.method")).rejects.toThrow(CDPTimeoutError);
+        });
+    });
+    describe("evaluate", () => {
+        it("should return evaluated value", async () => {
+            await client.connect();
+            const ws = lastMockWs();
+            ws.send = (data) => {
+                const msg = JSON.parse(data);
+                queueMicrotask(() => {
+                    ws.receiveMessage({
+                        id: msg.id,
+                        result: { result: { type: "number", value: 42 } },
+                    });
+                });
+            };
+            const result = await client.evaluate("21 * 2");
+            expect(result).toBe(42);
+        });
+        it("should throw CDPEvaluationError on exception", async () => {
+            await client.connect();
+            const ws = lastMockWs();
+            ws.send = (data) => {
+                const msg = JSON.parse(data);
+                queueMicrotask(() => {
+                    ws.receiveMessage({
+                        id: msg.id,
+                        result: {
+                            exceptionDetails: {
+                                exception: { description: "ReferenceError: x is not defined" },
+                            },
+                        },
+                    });
+                });
+            };
+            await expect(client.evaluate("x")).rejects.toThrow(CDPEvaluationError);
+            await expect(client.evaluate("x")).rejects.toThrow(/ReferenceError/);
+        });
+    });
+    describe("events", () => {
+        it("should dispatch CDP events to listeners", async () => {
+            await client.connect();
+            const ws = lastMockWs();
+            const received = [];
+            client.on("Page.loadEventFired", (params) => {
+                received.push(params);
+            });
+            ws.receiveMessage({
+                method: "Page.loadEventFired",
+                params: { timestamp: 12345 },
+            });
+            expect(received).toHaveLength(1);
+            expect(received[0]).toEqual({ timestamp: 12345 });
+        });
+        it("should remove listeners with off()", async () => {
+            await client.connect();
+            const ws = lastMockWs();
+            const received = [];
+            const handler = (params) => {
+                received.push(params);
+            };
+            client.on("Network.requestWillBeSent", handler);
+            ws.receiveMessage({
+                method: "Network.requestWillBeSent",
+                params: { requestId: "1" },
+            });
+            client.off("Network.requestWillBeSent", handler);
+            ws.receiveMessage({
+                method: "Network.requestWillBeSent",
+                params: { requestId: "2" },
+            });
+            expect(received).toHaveLength(1);
+        });
+        it("should resolve waitForEvent on event", async () => {
+            await client.connect();
+            const ws = lastMockWs();
+            const eventPromise = client.waitForEvent("Page.loadEventFired", 1000);
+            ws.receiveMessage({
+                method: "Page.loadEventFired",
+                params: { timestamp: 99 },
+            });
+            const result = await eventPromise;
+            expect(result).toEqual({ timestamp: 99 });
+        });
+        it("should reject waitForEvent on timeout", async () => {
+            await client.connect();
+            await expect(client.waitForEvent("Never.happens", 50)).rejects.toThrow(CDPTimeoutError);
+        });
+    });
+    describe("disconnect", () => {
+        it("should reject pending requests on disconnect", async () => {
+            await client.connect();
+            const ws = lastMockWs();
+            ws.send = () => {
+                /* swallow */
+            };
+            const pendingPromise = client.send("Runtime.evaluate", {
+                expression: "1",
+            });
+            client.disconnect();
+            await expect(pendingPromise).rejects.toThrow(CDPConnectionError);
+            expect(client.isConnected).toBe(false);
+        });
+    });
+});
+//# sourceMappingURL=client.test.js.map

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

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

package/dist/cdp/discovery.d.ts

@@ -0,0 +1,14 @@
+import type { CdpTarget } from "../types/cdp.js";
+/**
+ * Discover Chrome DevTools Protocol targets exposed at the given port.
+ *
+ * Fetches the `/json/list` HTTP endpoint that Chromium-based browsers
+ * expose for debugging target enumeration.
+ *
+ * @param port  - CDP debugging port (e.g. 9222 for the launcher process).
+ * @param host  - Host to connect to (default `127.0.0.1`).
+ * @returns Array of discovered CDP targets.
+ * @throws {CDPConnectionError} When the endpoint is unreachable.
+ */
+export declare function discoverTargets(port: number, host?: string): Promise<CdpTarget[]>;
+//# sourceMappingURL=discovery.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"discovery.d.ts","sourceRoot":"","sources":["../../src/cdp/discovery.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAQjD;;;;;;;;;;GAUG;AACH,wBAAsB,eAAe,CACnC,IAAI,EAAE,MAAM,EACZ,IAAI,GAAE,MAAqB,GAC1B,OAAO,CAAC,SAAS,EAAE,CAAC,CAoBtB"}

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

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

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

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

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

@@ -0,0 +1,25 @@
+import { afterAll, beforeAll, describe, expect, it } from "vitest";
+import { discoverTargets } from "./discovery.js";
+import { launchChromium, } from "./testing/launch-chromium.js";
+describe("discoverTargets (integration)", () => {
+    let chromium;
+    beforeAll(async () => {
+        chromium = await launchChromium();
+    }, 30_000);
+    afterAll(async () => {
+        await chromium.close();
+    });
+    it("should return targets from a real Chromium instance", async () => {
+        const targets = await discoverTargets(chromium.port);
+        expect(targets.length).toBeGreaterThan(0);
+    });
+    it("should return targets with expected shape", async () => {
+        const targets = await discoverTargets(chromium.port);
+        const page = targets.find((t) => t.type === "page");
+        expect(page).toBeDefined();
+        expect(page?.id).toEqual(expect.any(String));
+        expect(page?.webSocketDebuggerUrl).toEqual(expect.any(String));
+        expect(page?.webSocketDebuggerUrl).toMatch(/^ws:\/\//);
+    });
+});
+//# sourceMappingURL=discovery.integration.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"discovery.integration.test.js","sourceRoot":"","sources":["../../src/cdp/discovery.integration.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AACnE,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EACL,cAAc,GAEf,MAAM,8BAA8B,CAAC;AAEtC,QAAQ,CAAC,+BAA+B,EAAE,GAAG,EAAE;IAC7C,IAAI,QAA0B,CAAC;IAE/B,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,EAAE,CAAC,qDAAqD,EAAE,KAAK,IAAI,EAAE;QACnE,MAAM,OAAO,GAAG,MAAM,eAAe,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QAErD,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;IAC5C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2CAA2C,EAAE,KAAK,IAAI,EAAE;QACzD,MAAM,OAAO,GAAG,MAAM,eAAe,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QACrD,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC;QAEpD,MAAM,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC;QAC3B,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;QAC7C,MAAM,CAAC,IAAI,EAAE,oBAAoB,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;QAC/D,MAAM,CAAC,IAAI,EAAE,oBAAoB,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IACzD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/cdp/discovery.js

@@ -0,0 +1,31 @@
+import { CDPConnectionError } from "./errors.js";
+/**
+ * Default host used for CDP target discovery.
+ */
+const DEFAULT_HOST = "127.0.0.1";
+/**
+ * Discover Chrome DevTools Protocol targets exposed at the given port.
+ *
+ * Fetches the `/json/list` HTTP endpoint that Chromium-based browsers
+ * expose for debugging target enumeration.
+ *
+ * @param port  - CDP debugging port (e.g. 9222 for the launcher process).
+ * @param host  - Host to connect to (default `127.0.0.1`).
+ * @returns Array of discovered CDP targets.
+ * @throws {CDPConnectionError} When the endpoint is unreachable.
+ */
+export async function discoverTargets(port, host = DEFAULT_HOST) {
+    const url = `http://${host}:${port}/json/list`;
+    let response;
+    try {
+        response = await fetch(url);
+    }
+    catch (error) {
+        throw new CDPConnectionError(`Failed to discover CDP targets at ${url}: LinkedHelper not running or CDP not enabled`, { cause: error });
+    }
+    if (!response.ok) {
+        throw new CDPConnectionError(`CDP target discovery returned HTTP ${response.status.toString()} at ${url}`);
+    }
+    return (await response.json());
+}
+//# sourceMappingURL=discovery.js.map

package/dist/cdp/discovery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"discovery.js","sourceRoot":"","sources":["../../src/cdp/discovery.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEjD;;GAEG;AACH,MAAM,YAAY,GAAG,WAAW,CAAC;AAEjC;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,IAAY,EACZ,OAAe,YAAY;IAE3B,MAAM,GAAG,GAAG,UAAU,IAAI,IAAI,IAAI,YAAY,CAAC;IAE/C,IAAI,QAAkB,CAAC;IACvB,IAAI,CAAC;QACH,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,CAAC;IAC9B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,kBAAkB,CAC1B,qCAAqC,GAAG,+CAA+C,EACvF,EAAE,KAAK,EAAE,KAAK,EAAE,CACjB,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,MAAM,IAAI,kBAAkB,CAC1B,sCAAsC,QAAQ,CAAC,MAAM,CAAC,QAAQ,EAAE,OAAO,GAAG,EAAE,CAC7E,CAAC;IACJ,CAAC;IAED,OAAO,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAgB,CAAC;AAChD,CAAC"}

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

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

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

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

package/dist/cdp/discovery.test.js

@@ -0,0 +1,54 @@
+import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
+import { CDPConnectionError } from "./errors.js";
+import { discoverTargets } from "./discovery.js";
+const MOCK_TARGETS = [
+    {
+        description: "",
+        devtoolsFrontendUrl: "/devtools/inspector.html?ws=127.0.0.1:9222/devtools/page/ABC",
+        id: "ABC",
+        type: "page",
+        title: "LinkedHelper",
+        url: "chrome-extension://abc/index.html",
+        webSocketDebuggerUrl: "ws://127.0.0.1:9222/devtools/page/ABC",
+    },
+    {
+        description: "",
+        devtoolsFrontendUrl: "/devtools/inspector.html?ws=127.0.0.1:9222/devtools/worker/DEF",
+        id: "DEF",
+        type: "service_worker",
+        title: "Service Worker",
+        url: "chrome-extension://abc/sw.js",
+    },
+];
+describe("discoverTargets", () => {
+    beforeEach(() => {
+        vi.stubGlobal("fetch", vi.fn());
+    });
+    afterEach(() => {
+        vi.restoreAllMocks();
+    });
+    it("should return targets from /json/list endpoint", async () => {
+        vi.mocked(fetch).mockResolvedValue(new Response(JSON.stringify(MOCK_TARGETS), { status: 200 }));
+        const targets = await discoverTargets(9222);
+        expect(fetch).toHaveBeenCalledWith("http://127.0.0.1:9222/json/list");
+        expect(targets).toHaveLength(2);
+        expect(targets[0]?.id).toBe("ABC");
+        expect(targets[1]?.type).toBe("service_worker");
+    });
+    it("should use custom host when provided", async () => {
+        vi.mocked(fetch).mockResolvedValue(new Response(JSON.stringify([]), { status: 200 }));
+        await discoverTargets(9222, "192.168.1.10");
+        expect(fetch).toHaveBeenCalledWith("http://192.168.1.10:9222/json/list");
+    });
+    it("should throw CDPConnectionError when fetch fails", async () => {
+        vi.mocked(fetch).mockRejectedValue(new Error("ECONNREFUSED"));
+        await expect(discoverTargets(9222)).rejects.toThrow(CDPConnectionError);
+        await expect(discoverTargets(9222)).rejects.toThrow(/LinkedHelper not running/);
+    });
+    it("should throw CDPConnectionError on non-OK HTTP status", async () => {
+        vi.mocked(fetch).mockResolvedValue(new Response("Not Found", { status: 404 }));
+        await expect(discoverTargets(9222)).rejects.toThrow(CDPConnectionError);
+        await expect(discoverTargets(9222)).rejects.toThrow(/HTTP 404/);
+    });
+});
+//# sourceMappingURL=discovery.test.js.map

package/dist/cdp/discovery.test.js.map

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

package/dist/cdp/errors.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Base class for all CDP-related errors.
+ */
+export declare class CDPError extends Error {
+    constructor(message: string, options?: ErrorOptions);
+}
+/**
+ * Thrown when a WebSocket connection to a CDP target cannot be established
+ * or is unexpectedly lost.
+ */
+export declare class CDPConnectionError extends CDPError {
+    constructor(message: string, options?: ErrorOptions);
+}
+/**
+ * Thrown when a CDP request does not receive a response within the
+ * configured timeout.
+ */
+export declare class CDPTimeoutError extends CDPError {
+    constructor(message: string, options?: ErrorOptions);
+}
+/**
+ * Thrown when `Runtime.evaluate` (or similar) returns a CDP-level error
+ * or an exception from the evaluated expression.
+ */
+export declare class CDPEvaluationError extends CDPError {
+    constructor(message: string, options?: ErrorOptions);
+}
+//# sourceMappingURL=errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/cdp/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,qBAAa,QAAS,SAAQ,KAAK;gBACrB,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY;CAIpD;AAED;;;GAGG;AACH,qBAAa,kBAAmB,SAAQ,QAAQ;gBAClC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY;CAIpD;AAED;;;GAGG;AACH,qBAAa,eAAgB,SAAQ,QAAQ;gBAC/B,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY;CAIpD;AAED;;;GAGG;AACH,qBAAa,kBAAmB,SAAQ,QAAQ;gBAClC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY;CAIpD"}

package/dist/cdp/errors.js

@@ -0,0 +1,40 @@
+/**
+ * Base class for all CDP-related errors.
+ */
+export class CDPError extends Error {
+    constructor(message, options) {
+        super(message, options);
+        this.name = "CDPError";
+    }
+}
+/**
+ * Thrown when a WebSocket connection to a CDP target cannot be established
+ * or is unexpectedly lost.
+ */
+export class CDPConnectionError extends CDPError {
+    constructor(message, options) {
+        super(message, options);
+        this.name = "CDPConnectionError";
+    }
+}
+/**
+ * Thrown when a CDP request does not receive a response within the
+ * configured timeout.
+ */
+export class CDPTimeoutError extends CDPError {
+    constructor(message, options) {
+        super(message, options);
+        this.name = "CDPTimeoutError";
+    }
+}
+/**
+ * Thrown when `Runtime.evaluate` (or similar) returns a CDP-level error
+ * or an exception from the evaluated expression.
+ */
+export class CDPEvaluationError extends CDPError {
+    constructor(message, options) {
+        super(message, options);
+        this.name = "CDPEvaluationError";
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/cdp/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/cdp/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,OAAO,QAAS,SAAQ,KAAK;IACjC,YAAY,OAAe,EAAE,OAAsB;QACjD,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;IACzB,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,OAAO,kBAAmB,SAAQ,QAAQ;IAC9C,YAAY,OAAe,EAAE,OAAsB;QACjD,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACnC,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,OAAO,eAAgB,SAAQ,QAAQ;IAC3C,YAAY,OAAe,EAAE,OAAsB;QACjD,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,OAAO,kBAAmB,SAAQ,QAAQ;IAC9C,YAAY,OAAe,EAAE,OAAsB;QACjD,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACnC,CAAC;CACF"}

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

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

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

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

package/dist/cdp/errors.test.js

@@ -0,0 +1,35 @@
+import { describe, expect, it } from "vitest";
+import { CDPConnectionError, CDPError, CDPEvaluationError, CDPTimeoutError, } from "./errors.js";
+describe("CDP errors", () => {
+    it("should set correct name for CDPError", () => {
+        const error = new CDPError("test");
+        expect(error.name).toBe("CDPError");
+        expect(error.message).toBe("test");
+        expect(error).toBeInstanceOf(Error);
+    });
+    it("should set correct name for CDPConnectionError", () => {
+        const error = new CDPConnectionError("connection failed");
+        expect(error.name).toBe("CDPConnectionError");
+        expect(error.message).toBe("connection failed");
+        expect(error).toBeInstanceOf(CDPError);
+        expect(error).toBeInstanceOf(Error);
+    });
+    it("should set correct name for CDPTimeoutError", () => {
+        const error = new CDPTimeoutError("timed out");
+        expect(error.name).toBe("CDPTimeoutError");
+        expect(error.message).toBe("timed out");
+        expect(error).toBeInstanceOf(CDPError);
+    });
+    it("should set correct name for CDPEvaluationError", () => {
+        const error = new CDPEvaluationError("eval failed");
+        expect(error.name).toBe("CDPEvaluationError");
+        expect(error.message).toBe("eval failed");
+        expect(error).toBeInstanceOf(CDPError);
+    });
+    it("should support cause via ErrorOptions", () => {
+        const cause = new TypeError("original");
+        const error = new CDPConnectionError("wrapper", { cause });
+        expect(error.cause).toBe(cause);
+    });
+});
+//# sourceMappingURL=errors.test.js.map

package/dist/cdp/errors.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.test.js","sourceRoot":"","sources":["../../src/cdp/errors.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EACL,kBAAkB,EAClB,QAAQ,EACR,kBAAkB,EAClB,eAAe,GAChB,MAAM,aAAa,CAAC;AAErB,QAAQ,CAAC,YAAY,EAAE,GAAG,EAAE;IAC1B,EAAE,CAAC,sCAAsC,EAAE,GAAG,EAAE;QAC9C,MAAM,KAAK,GAAG,IAAI,QAAQ,CAAC,MAAM,CAAC,CAAC;QACnC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACpC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACnC,MAAM,CAAC,KAAK,CAAC,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;IACtC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gDAAgD,EAAE,GAAG,EAAE;QACxD,MAAM,KAAK,GAAG,IAAI,kBAAkB,CAAC,mBAAmB,CAAC,CAAC;QAC1D,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;QAC9C,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;QAChD,MAAM,CAAC,KAAK,CAAC,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC;QACvC,MAAM,CAAC,KAAK,CAAC,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;IACtC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6CAA6C,EAAE,GAAG,EAAE;QACrD,MAAM,KAAK,GAAG,IAAI,eAAe,CAAC,WAAW,CAAC,CAAC;QAC/C,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;QAC3C,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACxC,MAAM,CAAC,KAAK,CAAC,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC;IACzC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gDAAgD,EAAE,GAAG,EAAE;QACxD,MAAM,KAAK,GAAG,IAAI,kBAAkB,CAAC,aAAa,CAAC,CAAC;QACpD,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;QAC9C,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QAC1C,MAAM,CAAC,KAAK,CAAC,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC;IACzC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uCAAuC,EAAE,GAAG,EAAE;QAC/C,MAAM,KAAK,GAAG,IAAI,SAAS,CAAC,UAAU,CAAC,CAAC;QACxC,MAAM,KAAK,GAAG,IAAI,kBAAkB,CAAC,SAAS,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;QAC3D,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAClC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/cdp/index.d.ts

@@ -0,0 +1,5 @@
+export { CDPClient } from "./client.js";
+export { discoverTargets } from "./discovery.js";
+export { discoverInstancePort, killInstanceProcesses, } from "./instance-discovery.js";
+export { CDPConnectionError, CDPError, CDPEvaluationError, CDPTimeoutError, } from "./errors.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cdp/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EACL,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,kBAAkB,EAClB,QAAQ,EACR,kBAAkB,EAClB,eAAe,GAChB,MAAM,aAAa,CAAC"}

package/dist/cdp/index.js

@@ -0,0 +1,5 @@
+export { CDPClient } from "./client.js";
+export { discoverTargets } from "./discovery.js";
+export { discoverInstancePort, killInstanceProcesses, } from "./instance-discovery.js";
+export { CDPConnectionError, CDPError, CDPEvaluationError, CDPTimeoutError, } from "./errors.js";
+//# sourceMappingURL=index.js.map

package/dist/cdp/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cdp/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EACL,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,kBAAkB,EAClB,QAAQ,EACR,kBAAkB,EAClB,eAAe,GAChB,MAAM,aAAa,CAAC"}

package/dist/cdp/instance-discovery.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Discover the dynamic CDP port of a running LinkedHelper instance process.
+ *
+ * LinkedHelper spawns a separate Electron process for each LinkedIn account.
+ * That process listens for CDP connections on a dynamic port that changes
+ * every session.  This function discovers the port cross-platform using
+ * `pid-port` and `ps-list`.
+ *
+ * The heuristic is:
+ * 1. Find the launcher PID by looking for a process listening on `launcherPort`.
+ * 2. Find child processes of the launcher.
+ * 3. Among those children, find one listening on a TCP port that is NOT the
+ *    launcher port and that responds to the CDP `/json/list` endpoint.
+ *
+ * The instance process may listen on multiple ports (e.g. a web content
+ * server and a CDP debugging server).  We probe each candidate with an
+ * HTTP fetch to `/json/list` to ensure we return the actual CDP port.
+ *
+ * @param launcherPort - The known launcher CDP port (default 9222).
+ * @returns The dynamic instance CDP port, or `null` if no running instance was found.
+ */
+export declare function discoverInstancePort(launcherPort?: number): Promise<number | null>;
+/**
+ * Find and forcefully kill all instance child processes of the launcher.
+ *
+ * Use as a last resort when graceful `stopInstance()` fails and
+ * the instance process needs to be terminated at the OS level.
+ */
+export declare function killInstanceProcesses(launcherPort: number): Promise<void>;
+//# sourceMappingURL=instance-discovery.d.ts.map

package/dist/cdp/instance-discovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"instance-discovery.d.ts","sourceRoot":"","sources":["../../src/cdp/instance-discovery.ts"],"names":[],"mappings":"AAQA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,oBAAoB,CACxC,YAAY,GAAE,MAA8B,GAC3C,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAexB;AAiED;;;;;GAKG;AACH,wBAAsB,qBAAqB,CACzC,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,IAAI,CAAC,CAcf"}

package/dist/cdp/instance-discovery.integration.test.d.ts

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

package/dist/cdp/instance-discovery.integration.test.d.ts.map

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