@lhremote/core 0.0.0 → 0.1.0

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

@@ -0,0 +1,34 @@
+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,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,130 @@
+import { pidToPorts, portToPid } from "pid-port";
+import psList from "ps-list";
+/**
+ * Default CDP port used by the LinkedHelper launcher process.
+ */
+const DEFAULT_LAUNCHER_PORT = 9222;
+/**
+ * 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_LAUNCHER_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
+        }
+    }
+}
+/**
+ * Check whether a port exposes a CDP `/json/list` endpoint.
+ */
+async function isCdpPort(port) {
+    try {
+        const response = await fetch(`http://127.0.0.1:${String(port)}/json/list`);
+        return response.ok;
+    }
+    catch {
+        return false;
+    }
+}
+//# 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,110 @@
+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":"AAAA,OAAO,EAAE,KAAK,YAAY,EAAS,MAAM,oBAAoB,CAAC;AAO9D,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"}

package/dist/cdp/testing/launch-chromium.js

@@ -0,0 +1,90 @@
+import { spawn } from "node:child_process";
+import { createServer } from "node:net";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { chromium } from "playwright-core";
+import { discoverTargets } from "../discovery.js";
+/**
+ * Find a free TCP port by briefly binding to port 0.
+ */
+async function findFreePort() {
+    return new Promise((resolve, reject) => {
+        const server = createServer();
+        server.listen(0, "127.0.0.1", () => {
+            const addr = server.address();
+            if (addr === null || typeof addr === "string") {
+                server.close();
+                reject(new Error("Failed to get port from server address"));
+                return;
+            }
+            const { port } = addr;
+            server.close(() => {
+                resolve(port);
+            });
+        });
+        server.on("error", reject);
+    });
+}
+/**
+ * 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 async function launchChromium(options) {
+    const timeout = options?.timeout ?? 10_000;
+    const port = await findFreePort();
+    const userDataDir = join(tmpdir(), `lhremote-cdp-test-${port.toString()}-${Date.now().toString(36)}`);
+    const executablePath = chromium.executablePath();
+    const child = spawn(executablePath, [
+        `--remote-debugging-port=${port.toString()}`,
+        `--user-data-dir=${userDataDir}`,
+        "--headless",
+        "--no-sandbox",
+        "--disable-gpu",
+        "--disable-extensions",
+        "--use-mock-keychain",
+    ], { stdio: "ignore" });
+    // Wait for CDP endpoint to become available
+    const deadline = Date.now() + timeout;
+    let ready = false;
+    while (Date.now() < deadline) {
+        try {
+            const targets = await discoverTargets(port);
+            if (targets.length > 0) {
+                ready = true;
+                break;
+            }
+        }
+        catch {
+            // Not ready yet
+        }
+        await new Promise((r) => setTimeout(r, 100));
+    }
+    if (!ready) {
+        child.kill("SIGKILL");
+        throw new Error(`Chromium CDP endpoint did not become available on port ${port.toString()} within ${timeout.toString()}ms`);
+    }
+    const close = async () => {
+        if (child.exitCode !== null) {
+            return;
+        }
+        child.kill("SIGTERM");
+        await new Promise((resolve) => {
+            const timer = setTimeout(() => {
+                child.kill("SIGKILL");
+                resolve();
+            }, 5_000);
+            child.on("exit", () => {
+                clearTimeout(timer);
+                resolve();
+            });
+        });
+    };
+    return { port, process: child, close };
+}
+//# sourceMappingURL=launch-chromium.js.map

package/dist/cdp/testing/launch-chromium.js.map

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

package/dist/db/client.d.ts

@@ -0,0 +1,13 @@
+import Database from "better-sqlite3";
+/**
+ * Read-only SQLite client for querying a LinkedHelper database.
+ *
+ * Opens the database in read-only mode. LinkedHelper uses WAL
+ * journaling, so concurrent reads do not block writes.
+ */
+export declare class DatabaseClient {
+    readonly db: Database.Database;
+    constructor(dbPath: string);
+    close(): void;
+}
+//# sourceMappingURL=client.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/db/client.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AAEtC;;;;;GAKG;AACH,qBAAa,cAAc;IACzB,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,CAAC;gBAEnB,MAAM,EAAE,MAAM;IAI1B,KAAK,IAAI,IAAI;CAGd"}

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

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

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

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

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

@@ -0,0 +1,59 @@
+import { afterEach, describe, expect, it } from "vitest";
+import { DatabaseClient } from "./client.js";
+import { FIXTURE_PATH } from "./testing/open-fixture.js";
+describe("DatabaseClient (integration)", () => {
+    let client;
+    afterEach(() => {
+        client?.close();
+        client = undefined;
+    });
+    it("opens the fixture database in read-only mode", () => {
+        client = new DatabaseClient(FIXTURE_PATH);
+        expect(client.db.readonly).toBe(true);
+    });
+    it("reads data from the real schema", () => {
+        client = new DatabaseClient(FIXTURE_PATH);
+        const row = client.db
+            .prepare("SELECT first_name FROM person_mini_profile WHERE person_id = ?")
+            .get(1);
+        expect(row?.first_name).toBe("Ada");
+    });
+    it("rejects write operations", () => {
+        client = new DatabaseClient(FIXTURE_PATH);
+        const { db } = client;
+        expect(() => db.exec("INSERT INTO people (id) VALUES (9999)")).toThrow(/readonly/i);
+    });
+    it("throws when the database file does not exist", () => {
+        expect(() => new DatabaseClient("/nonexistent/path/to/lh.db")).toThrow();
+    });
+    it("can query all profile-related tables", () => {
+        client = new DatabaseClient(FIXTURE_PATH);
+        const tables = [
+            "people",
+            "person_mini_profile",
+            "person_external_ids",
+            "person_current_position",
+            "person_positions",
+            "person_education",
+            "skills",
+            "person_skill",
+            "person_email",
+        ];
+        for (const table of tables) {
+            const row = client.db
+                .prepare(`SELECT COUNT(*) AS cnt FROM ${table}`)
+                .get();
+            expect(row.cnt).toBeGreaterThanOrEqual(0);
+        }
+    });
+    it("close() releases the file handle", () => {
+        client = new DatabaseClient(FIXTURE_PATH);
+        const { db } = client;
+        client.close();
+        // After close, queries should throw
+        expect(() => db.prepare("SELECT 1").get()).toThrow();
+        // Prevent afterEach from double-closing
+        client = undefined;
+    });
+});
+//# sourceMappingURL=client.integration.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"client.integration.test.js","sourceRoot":"","sources":["../../src/db/client.integration.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAEzD,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAEzD,QAAQ,CAAC,8BAA8B,EAAE,GAAG,EAAE;IAC5C,IAAI,MAAkC,CAAC;IAEvC,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,EAAE,KAAK,EAAE,CAAC;QAChB,MAAM,GAAG,SAAS,CAAC;IACrB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8CAA8C,EAAE,GAAG,EAAE;QACtD,MAAM,GAAG,IAAI,cAAc,CAAC,YAAY,CAAC,CAAC;QAC1C,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACxC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iCAAiC,EAAE,GAAG,EAAE;QACzC,MAAM,GAAG,IAAI,cAAc,CAAC,YAAY,CAAC,CAAC;QAE1C,MAAM,GAAG,GAAG,MAAM,CAAC,EAAE;aAClB,OAAO,CAAC,gEAAgE,CAAC;aACzE,GAAG,CAAC,CAAC,CAAuC,CAAC;QAEhD,MAAM,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACtC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0BAA0B,EAAE,GAAG,EAAE;QAClC,MAAM,GAAG,IAAI,cAAc,CAAC,YAAY,CAAC,CAAC;QAC1C,MAAM,EAAE,EAAE,EAAE,GAAG,MAAM,CAAC;QAEtB,MAAM,CAAC,GAAG,EAAE,CACV,EAAE,CAAC,IAAI,CAAC,uCAAuC,CAAC,CACjD,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IACzB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8CAA8C,EAAE,GAAG,EAAE;QACtD,MAAM,CACJ,GAAG,EAAE,CAAC,IAAI,cAAc,CAAC,4BAA4B,CAAC,CACvD,CAAC,OAAO,EAAE,CAAC;IACd,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sCAAsC,EAAE,GAAG,EAAE;QAC9C,MAAM,GAAG,IAAI,cAAc,CAAC,YAAY,CAAC,CAAC;QAE1C,MAAM,MAAM,GAAG;YACb,QAAQ;YACR,qBAAqB;YACrB,qBAAqB;YACrB,yBAAyB;YACzB,kBAAkB;YAClB,kBAAkB;YAClB,QAAQ;YACR,cAAc;YACd,cAAc;SACf,CAAC;QAEF,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,MAAM,GAAG,GAAG,MAAM,CAAC,EAAE;iBAClB,OAAO,CAAC,+BAA+B,KAAK,EAAE,CAAC;iBAC/C,GAAG,EAAqB,CAAC;YAC5B,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,sBAAsB,CAAC,CAAC,CAAC,CAAC;QAC5C,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kCAAkC,EAAE,GAAG,EAAE;QAC1C,MAAM,GAAG,IAAI,cAAc,CAAC,YAAY,CAAC,CAAC;QAC1C,MAAM,EAAE,EAAE,EAAE,GAAG,MAAM,CAAC;QACtB,MAAM,CAAC,KAAK,EAAE,CAAC;QAEf,oCAAoC;QACpC,MAAM,CAAC,GAAG,EAAE,CACV,EAAE,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,GAAG,EAAE,CAC7B,CAAC,OAAO,EAAE,CAAC;QAEZ,wCAAwC;QACxC,MAAM,GAAG,SAAS,CAAC;IACrB,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/db/client.js

@@ -0,0 +1,17 @@
+import Database from "better-sqlite3";
+/**
+ * Read-only SQLite client for querying a LinkedHelper database.
+ *
+ * Opens the database in read-only mode. LinkedHelper uses WAL
+ * journaling, so concurrent reads do not block writes.
+ */
+export class DatabaseClient {
+    db;
+    constructor(dbPath) {
+        this.db = new Database(dbPath, { readonly: true });
+    }
+    close() {
+        this.db.close();
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/db/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/db/client.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AAEtC;;;;;GAKG;AACH,MAAM,OAAO,cAAc;IAChB,EAAE,CAAoB;IAE/B,YAAY,MAAc;QACxB,IAAI,CAAC,EAAE,GAAG,IAAI,QAAQ,CAAC,MAAM,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;IACrD,CAAC;IAED,KAAK;QACH,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC;IAClB,CAAC;CACF"}

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

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

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

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

package/dist/db/client.test.js

@@ -0,0 +1,46 @@
+import { afterEach, beforeEach, describe, expect, it } from "vitest";
+import { DatabaseClient } from "./client.js";
+import { openFixture } from "./testing/open-fixture.js";
+describe("DatabaseClient", () => {
+    describe("constructor", () => {
+        it("throws when the database file does not exist", () => {
+            expect(() => new DatabaseClient("/nonexistent/path/to/lh.db")).toThrow();
+        });
+    });
+    describe("with in-memory fixture", () => {
+        let client;
+        beforeEach(() => {
+            const db = openFixture();
+            client = { db };
+        });
+        afterEach(() => {
+            client.db.close();
+        });
+        it("can read data from the real schema", () => {
+            const row = client.db
+                .prepare("SELECT first_name FROM person_mini_profile WHERE person_id = ?")
+                .get(1);
+            expect(row?.first_name).toBe("Ada");
+        });
+        it("fixture schema includes all profile-related tables", () => {
+            const tables = [
+                "people",
+                "person_mini_profile",
+                "person_external_ids",
+                "person_current_position",
+                "person_positions",
+                "person_education",
+                "skills",
+                "person_skill",
+                "person_email",
+            ];
+            for (const table of tables) {
+                const row = client.db
+                    .prepare(`SELECT COUNT(*) AS cnt FROM ${table}`)
+                    .get();
+                expect(row.cnt).toBeGreaterThanOrEqual(0);
+            }
+        });
+    });
+});
+//# sourceMappingURL=client.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"client.test.js","sourceRoot":"","sources":["../../src/db/client.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAErE,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAExD,QAAQ,CAAC,gBAAgB,EAAE,GAAG,EAAE;IAC9B,QAAQ,CAAC,aAAa,EAAE,GAAG,EAAE;QAC3B,EAAE,CAAC,8CAA8C,EAAE,GAAG,EAAE;YACtD,MAAM,CACJ,GAAG,EAAE,CAAC,IAAI,cAAc,CAAC,4BAA4B,CAAC,CACvD,CAAC,OAAO,EAAE,CAAC;QACd,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,wBAAwB,EAAE,GAAG,EAAE;QACtC,IAAI,MAA8C,CAAC;QAEnD,UAAU,CAAC,GAAG,EAAE;YACd,MAAM,EAAE,GAAG,WAAW,EAAE,CAAC;YACzB,MAAM,GAAG,EAAE,EAAE,EAAE,CAAC;QAClB,CAAC,CAAC,CAAC;QAEH,SAAS,CAAC,GAAG,EAAE;YACb,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC;QACpB,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,oCAAoC,EAAE,GAAG,EAAE;YAC5C,MAAM,GAAG,GAAG,MAAM,CAAC,EAAE;iBAClB,OAAO,CAAC,gEAAgE,CAAC;iBACzE,GAAG,CAAC,CAAC,CAAuC,CAAC;YAChD,MAAM,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACtC,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,oDAAoD,EAAE,GAAG,EAAE;YAC5D,MAAM,MAAM,GAAG;gBACb,QAAQ;gBACR,qBAAqB;gBACrB,qBAAqB;gBACrB,yBAAyB;gBACzB,kBAAkB;gBAClB,kBAAkB;gBAClB,QAAQ;gBACR,cAAc;gBACd,cAAc;aACf,CAAC;YAEF,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;gBAC3B,MAAM,GAAG,GAAG,MAAM,CAAC,EAAE;qBAClB,OAAO,CAAC,+BAA+B,KAAK,EAAE,CAAC;qBAC/C,GAAG,EAAqB,CAAC;gBAC5B,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,sBAAsB,CAAC,CAAC,CAAC,CAAC;YAC5C,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/db/discovery.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Resolves the database file path for a LinkedHelper account.
+ *
+ * @throws {DatabaseNotFoundError} if the database file does not exist.
+ */
+export declare function discoverDatabase(accountId: number): string;
+/**
+ * Scans the LinkedHelper partitions directory and returns a map of
+ * every account ID to its database file path.
+ *
+ * Only accounts whose database file actually exists are included.
+ */
+export declare function discoverAllDatabases(): Map<number, string>;
+//# sourceMappingURL=discovery.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"discovery.d.ts","sourceRoot":"","sources":["../../src/db/discovery.ts"],"names":[],"mappings":"AAqCA;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAM1D;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,IAAI,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CA8B1D"}

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

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

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

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