@lhremote/core 0.0.0 → 0.2.0

package/dist/cdp/discovery.js

@@ -0,0 +1,33 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+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":"AAAA,yCAAyC;AACzC,oCAAoC;AAGpC,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,56 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+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":"AAGA;;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,42 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+/**
+ * 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,yCAAyC;AACzC,oCAAoC;AAEpC;;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,37 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+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,yCAAyC;AACzC,oCAAoC;AAEpC,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,6 @@
+export { CDPClient } from "./client.js";
+export { discoverTargets } from "./discovery.js";
+export { discoverInstancePort, killInstanceProcesses, } from "./instance-discovery.js";
+export { findApp, type DiscoveredApp } from "./app-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":"AAGA,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,EAAE,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACjE,OAAO,EACL,kBAAkB,EAClB,QAAQ,EACR,kBAAkB,EAClB,eAAe,GAChB,MAAM,aAAa,CAAC"}

package/dist/cdp/index.js

@@ -0,0 +1,8 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+export { CDPClient } from "./client.js";
+export { discoverTargets } from "./discovery.js";
+export { discoverInstancePort, killInstanceProcesses, } from "./instance-discovery.js";
+export { findApp } from "./app-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,yCAAyC;AACzC,oCAAoC;AAEpC,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,EAAE,OAAO,EAAsB,MAAM,oBAAoB,CAAC;AACjE,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,MAAyB,GACtC,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":""}

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

@@ -0,0 +1,36 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+import { afterAll, beforeAll, describe, expect, it } from "vitest";
+import { pidToPorts, portToPid } from "pid-port";
+import psList from "ps-list";
+import { launchChromium, } from "./testing/launch-chromium.js";
+describe("instance-discovery packages (integration)", () => {
+    let chromium;
+    beforeAll(async () => {
+        chromium = await launchChromium();
+    }, 30_000);
+    afterAll(async () => {
+        await chromium.close();
+    });
+    it("portToPid should find the Chromium process by port", async () => {
+        const pid = await portToPid({ port: chromium.port, host: "*" });
+        expect(pid).toEqual(expect.any(Number));
+        expect(pid).toBeGreaterThan(0);
+    });
+    it("psList should include the Chromium process with correct ppid", async () => {
+        const processes = await psList();
+        const chromiumProc = processes.find((p) => p.pid === chromium.process.pid);
+        expect(chromiumProc).toBeDefined();
+        expect(chromiumProc?.ppid).toEqual(expect.any(Number));
+    });
+    it("pidToPorts should include the Chromium CDP port", async () => {
+        const pid = await portToPid({ port: chromium.port, host: "*" });
+        if (pid === undefined) {
+            throw new Error("Expected portToPid to return a PID");
+        }
+        const ports = await pidToPorts(pid);
+        expect(ports).toBeInstanceOf(Set);
+        expect(ports.has(chromium.port)).toBe(true);
+    });
+});
+//# sourceMappingURL=instance-discovery.integration.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"instance-discovery.integration.test.js","sourceRoot":"","sources":["../../src/cdp/instance-discovery.integration.test.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,oCAAoC;AAEpC,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AACnE,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AACjD,OAAO,MAAM,MAAM,SAAS,CAAC;AAC7B,OAAO,EACL,cAAc,GAEf,MAAM,8BAA8B,CAAC;AAEtC,QAAQ,CAAC,2CAA2C,EAAE,GAAG,EAAE;IACzD,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,oDAAoD,EAAE,KAAK,IAAI,EAAE;QAClE,MAAM,GAAG,GAAG,MAAM,SAAS,CAAC,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC;QAEhE,MAAM,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;QACxC,MAAM,CAAC,GAAG,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;IACjC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8DAA8D,EAAE,KAAK,IAAI,EAAE;QAC5E,MAAM,SAAS,GAAG,MAAM,MAAM,EAAE,CAAC;QACjC,MAAM,YAAY,GAAG,SAAS,CAAC,IAAI,CACjC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,QAAQ,CAAC,OAAO,CAAC,GAAG,CACtC,CAAC;QAEF,MAAM,CAAC,YAAY,CAAC,CAAC,WAAW,EAAE,CAAC;QACnC,MAAM,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;IACzD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iDAAiD,EAAE,KAAK,IAAI,EAAE;QAC/D,MAAM,GAAG,GAAG,MAAM,SAAS,CAAC,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC;QAChE,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;YACtB,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;QACxD,CAAC;QAED,MAAM,KAAK,GAAG,MAAM,UAAU,CAAC,GAAG,CAAC,CAAC;QAEpC,MAAM,CAAC,KAAK,CAAC,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC;QAClC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC9C,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/cdp/instance-discovery.js

@@ -0,0 +1,118 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+import { pidToPorts, portToPid } from "pid-port";
+import psList from "ps-list";
+import { DEFAULT_CDP_PORT } from "../constants.js";
+import { isCdpPort } from "../utils/cdp-port.js";
+/**
+ * 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 async function discoverInstancePort(launcherPort = DEFAULT_CDP_PORT) {
+    const launcherPid = await findPidListeningOn(launcherPort);
+    if (launcherPid === null) {
+        return null;
+    }
+    const childPids = await findChildPids(launcherPid);
+    if (childPids.length === 0) {
+        return null;
+    }
+    const results = await Promise.all(childPids.map((pid) => findCdpPort(pid, launcherPort)));
+    return results.find((port) => port !== null) ?? null;
+}
+/**
+ * Find the PID of a process listening on the given TCP port.
+ */
+async function findPidListeningOn(port) {
+    try {
+        const pid = await portToPid({ port, host: "*" });
+        return pid ?? null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Find PIDs of child processes for the given parent PID.
+ */
+async function findChildPids(parentPid) {
+    try {
+        const processes = await psList();
+        return processes
+            .filter((p) => p.ppid === parentPid)
+            .map((p) => p.pid);
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Find the CDP debugging port for the given PID.
+ *
+ * Tries each listening port (excluding `excludePort`) with an HTTP fetch
+ * to `/json/list`.  Returns the first port that responds successfully.
+ */
+async function findCdpPort(pid, excludePort) {
+    let ports;
+    try {
+        ports = await pidToPorts(pid);
+    }
+    catch {
+        return null;
+    }
+    const candidates = [...ports].filter((p) => p !== excludePort);
+    if (candidates.length === 0) {
+        return null;
+    }
+    try {
+        return await Promise.any(candidates.map(async (port) => {
+            if (await isCdpPort(port)) {
+                return port;
+            }
+            throw new Error("not CDP");
+        }));
+    }
+    catch {
+        // AggregateError — no candidate port responded to CDP
+        return 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 async function killInstanceProcesses(launcherPort) {
+    const launcherPid = await findPidListeningOn(launcherPort);
+    if (launcherPid === null) {
+        return;
+    }
+    const childPids = await findChildPids(launcherPid);
+    for (const pid of childPids) {
+        try {
+            process.kill(pid, "SIGKILL");
+        }
+        catch {
+            // Process may already be dead
+        }
+    }
+}
+//# sourceMappingURL=instance-discovery.js.map

package/dist/cdp/instance-discovery.js.map

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

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

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

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

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

package/dist/cdp/instance-discovery.test.js

@@ -0,0 +1,112 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
+import { discoverInstancePort } from "./instance-discovery.js";
+vi.mock("pid-port", () => ({
+    portToPid: vi.fn(),
+    pidToPorts: vi.fn(),
+}));
+vi.mock("ps-list", () => ({
+    default: vi.fn(),
+}));
+import { pidToPorts, portToPid } from "pid-port";
+import psList from "ps-list";
+describe("discoverInstancePort", () => {
+    beforeEach(() => {
+        // Mock fetch to simulate a responding CDP endpoint
+        vi.spyOn(globalThis, "fetch").mockResolvedValue(new Response("[]", { status: 200 }));
+    });
+    afterEach(() => {
+        vi.restoreAllMocks();
+    });
+    it("should return null when launcher is not running", async () => {
+        vi.mocked(portToPid).mockRejectedValue(new Error("Could not find a process that uses port `9222`"));
+        const port = await discoverInstancePort(9222);
+        expect(port).toBeNull();
+    });
+    it("should return null when portToPid returns undefined", async () => {
+        vi.mocked(portToPid).mockResolvedValue(undefined);
+        const port = await discoverInstancePort(9222);
+        expect(port).toBeNull();
+    });
+    it("should return null when launcher has no children", async () => {
+        vi.mocked(portToPid).mockResolvedValue(12345);
+        vi.mocked(psList).mockResolvedValue([
+            { pid: 99999, name: "other", ppid: 1 },
+        ]);
+        const port = await discoverInstancePort(9222);
+        expect(port).toBeNull();
+    });
+    it("should discover instance port from child process", async () => {
+        vi.mocked(portToPid).mockResolvedValue(12345);
+        vi.mocked(psList).mockResolvedValue([
+            { pid: 12346, name: "electron", ppid: 12345 },
+            { pid: 99999, name: "other", ppid: 1 },
+        ]);
+        vi.mocked(pidToPorts).mockResolvedValue(new Set([55123]));
+        const port = await discoverInstancePort(9222);
+        expect(port).toBe(55123);
+    });
+    it("should skip ports matching the launcher port", async () => {
+        vi.mocked(portToPid).mockResolvedValue(12345);
+        vi.mocked(psList).mockResolvedValue([
+            { pid: 12346, name: "electron", ppid: 12345 },
+        ]);
+        vi.mocked(pidToPorts).mockResolvedValue(new Set([9222, 55999]));
+        const port = await discoverInstancePort(9222);
+        expect(port).toBe(55999);
+    });
+    it("should use default launcher port 9222", async () => {
+        vi.mocked(portToPid).mockResolvedValue(12345);
+        vi.mocked(psList).mockResolvedValue([
+            { pid: 12346, name: "electron", ppid: 12345 },
+        ]);
+        vi.mocked(pidToPorts).mockResolvedValue(new Set([44444]));
+        const port = await discoverInstancePort();
+        expect(port).toBe(44444);
+        expect(portToPid).toHaveBeenCalledWith({ port: 9222, host: "*" });
+    });
+    it("should return null when pidToPorts throws", async () => {
+        vi.mocked(portToPid).mockResolvedValue(12345);
+        vi.mocked(psList).mockResolvedValue([
+            { pid: 12346, name: "electron", ppid: 12345 },
+        ]);
+        vi.mocked(pidToPorts).mockRejectedValue(new Error("failed"));
+        const port = await discoverInstancePort(9222);
+        expect(port).toBeNull();
+    });
+    it("should return null when psList throws", async () => {
+        vi.mocked(portToPid).mockResolvedValue(12345);
+        vi.mocked(psList).mockRejectedValue(new Error("failed"));
+        const port = await discoverInstancePort(9222);
+        expect(port).toBeNull();
+    });
+    it("should skip ports that do not respond to CDP", async () => {
+        vi.mocked(portToPid).mockResolvedValue(12345);
+        vi.mocked(psList).mockResolvedValue([
+            { pid: 12346, name: "electron", ppid: 12345 },
+        ]);
+        vi.mocked(pidToPorts).mockResolvedValue(new Set([50000, 50001]));
+        // Port 50000 rejects (not CDP), port 50001 responds
+        vi.mocked(globalThis.fetch).mockImplementation(async (input) => {
+            const url = String(input);
+            if (url.includes(":50000/")) {
+                throw new Error("ECONNREFUSED");
+            }
+            return new Response("[]", { status: 200 });
+        });
+        const port = await discoverInstancePort(9222);
+        expect(port).toBe(50001);
+    });
+    it("should return null when no port responds to CDP", async () => {
+        vi.mocked(portToPid).mockResolvedValue(12345);
+        vi.mocked(psList).mockResolvedValue([
+            { pid: 12346, name: "electron", ppid: 12345 },
+        ]);
+        vi.mocked(pidToPorts).mockResolvedValue(new Set([50000]));
+        vi.mocked(globalThis.fetch).mockRejectedValue(new Error("ECONNREFUSED"));
+        const port = await discoverInstancePort(9222);
+        expect(port).toBeNull();
+    });
+});
+//# sourceMappingURL=instance-discovery.test.js.map

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

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

package/dist/cdp/testing/launch-chromium.d.ts

@@ -0,0 +1,24 @@
+import { type ChildProcess } from "node:child_process";
+/** Result of launching a test Chromium instance. */
+export interface ChromiumInstance {
+    /** CDP debugging port. */
+    port: number;
+    /** The spawned Chromium process. */
+    process: ChildProcess;
+    /** Gracefully shut down the Chromium instance. */
+    close: () => Promise<void>;
+}
+/**
+ * Launch a headless Chromium instance with CDP enabled on a random free port.
+ *
+ * Uses the Chromium binary installed by `playwright-core`.  The instance
+ * is configured for test isolation (temp profile, no sandbox).
+ *
+ * @param options.timeout - Maximum time (ms) to wait for CDP to become
+ *   available (default 10 000).
+ * @returns A {@link ChromiumInstance} handle.
+ */
+export declare function launchChromium(options?: {
+    timeout?: number;
+}): Promise<ChromiumInstance>;
+//# sourceMappingURL=launch-chromium.d.ts.map

package/dist/cdp/testing/launch-chromium.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"launch-chromium.d.ts","sourceRoot":"","sources":["../../../src/cdp/testing/launch-chromium.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,YAAY,EAAS,MAAM,oBAAoB,CAAC;AAQ9D,oDAAoD;AACpD,MAAM,WAAW,gBAAgB;IAC/B,0BAA0B;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,oCAAoC;IACpC,OAAO,EAAE,YAAY,CAAC;IACtB,kDAAkD;IAClD,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5B;AAwBD;;;;;;;;;GASG;AACH,wBAAsB,cAAc,CAAC,OAAO,CAAC,EAAE;IAC7C,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAgE5B"}