@lhremote/core 0.0.0 → 0.2.0

package/dist/db/client.d.ts

@@ -0,0 +1,27 @@
+import { DatabaseSync } from "node:sqlite";
+/**
+ * Options for creating a DatabaseClient.
+ */
+export interface DatabaseClientOptions {
+    /**
+     * Whether to open the database in read-only mode.
+     * Defaults to true. LinkedHelper uses WAL journaling,
+     * so concurrent reads do not block writes.
+     */
+    readOnly?: boolean;
+}
+/**
+ * SQLite client for querying a LinkedHelper database.
+ *
+ * By default, opens the database in read-only mode. LinkedHelper uses WAL
+ * journaling, so concurrent reads do not block writes.
+ *
+ * Pass `{ readOnly: false }` to enable write operations (required for
+ * campaign management operations like reset).
+ */
+export declare class DatabaseClient {
+    readonly db: DatabaseSync;
+    constructor(dbPath: string, options?: DatabaseClientOptions);
+    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":"AAGA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC;;;;OAIG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;;;;;;;GAQG;AACH,qBAAa,cAAc;IACzB,QAAQ,CAAC,EAAE,EAAE,YAAY,CAAC;gBAEd,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,qBAA0B;IAK/D,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,63 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+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);
+        const { db } = client;
+        // Verify read-only by attempting a write
+        expect(() => db.exec("INSERT INTO people (id) VALUES (9999)")).toThrow(/readonly/i);
+    });
+    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,yCAAyC;AACzC,oCAAoC;AAEpC,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,EAAE,EAAE,EAAE,GAAG,MAAM,CAAC;QAEtB,yCAAyC;QACzC,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,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,23 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+import { DatabaseSync } from "node:sqlite";
+/**
+ * SQLite client for querying a LinkedHelper database.
+ *
+ * By default, opens the database in read-only mode. LinkedHelper uses WAL
+ * journaling, so concurrent reads do not block writes.
+ *
+ * Pass `{ readOnly: false }` to enable write operations (required for
+ * campaign management operations like reset).
+ */
+export class DatabaseClient {
+    db;
+    constructor(dbPath, options = {}) {
+        const { readOnly = true } = options;
+        this.db = new DatabaseSync(dbPath, { readOnly });
+    }
+    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,yCAAyC;AACzC,oCAAoC;AAEpC,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAc3C;;;;;;;;GAQG;AACH,MAAM,OAAO,cAAc;IAChB,EAAE,CAAe;IAE1B,YAAY,MAAc,EAAE,UAAiC,EAAE;QAC7D,MAAM,EAAE,QAAQ,GAAG,IAAI,EAAE,GAAG,OAAO,CAAC;QACpC,IAAI,CAAC,EAAE,GAAG,IAAI,YAAY,CAAC,MAAM,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC;IACnD,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,48 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+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,yCAAyC;AACzC,oCAAoC;AAEpC,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":"AAwCA;;;;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":""}

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

@@ -0,0 +1,101 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+import { copyFileSync, mkdirSync, rmSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { tmpdir } from "node:os";
+import { afterAll, beforeAll, describe, expect, it, vi } from "vitest";
+import { DatabaseClient } from "./client.js";
+import { DatabaseNotFoundError } from "./errors.js";
+import { discoverAllDatabases, discoverDatabase } from "./discovery.js";
+import { FIXTURE_PATH } from "./testing/open-fixture.js";
+// Mock only homedir — all other node:fs/node:os calls stay real.
+vi.mock("node:os", async (importOriginal) => {
+    const actual = await importOriginal();
+    return { ...actual, homedir: vi.fn(actual.homedir) };
+});
+const mockedHomedir = vi.mocked(homedir);
+describe("discovery (integration)", () => {
+    const tmpBase = join(tmpdir(), `lhremote-discovery-int-${Date.now().toString(36)}`);
+    const fakeHome = tmpBase;
+    // Linux layout: ~/.config/linked-helper/Partitions/...
+    const partitionsDir = join(fakeHome, ".config", "linked-helper", "Partitions");
+    let dbPath111;
+    let dbPath222;
+    function createPartition(accountId) {
+        const dir = join(partitionsDir, `linked-helper-account-${String(accountId)}-main`);
+        mkdirSync(dir, { recursive: true });
+        const dbPath = join(dir, "lh.db");
+        copyFileSync(FIXTURE_PATH, dbPath);
+        return dbPath;
+    }
+    beforeAll(() => {
+        mkdirSync(partitionsDir, { recursive: true });
+        dbPath111 = createPartition(111);
+        dbPath222 = createPartition(222);
+        // Account 333: partition directory exists but no lh.db inside
+        mkdirSync(join(partitionsDir, "linked-helper-account-333-main"), { recursive: true });
+        // Non-matching directories that should be ignored
+        mkdirSync(join(partitionsDir, "some-unrelated-dir"), { recursive: true });
+        vi.stubGlobal("process", { ...process, platform: "linux" });
+        mockedHomedir.mockReturnValue(fakeHome);
+    });
+    afterAll(() => {
+        vi.restoreAllMocks();
+        rmSync(tmpBase, { recursive: true, force: true });
+    });
+    describe("discoverDatabase", () => {
+        it("returns the path for an existing account", () => {
+            const result = discoverDatabase(111);
+            expect(result).toBe(dbPath111);
+        });
+        it("returns the path for another existing account", () => {
+            const result = discoverDatabase(222);
+            expect(result).toBe(dbPath222);
+        });
+        it("throws DatabaseNotFoundError for a nonexistent account", () => {
+            expect(() => discoverDatabase(999)).toThrow(DatabaseNotFoundError);
+        });
+        it("throws DatabaseNotFoundError when partition exists but db file is missing", () => {
+            expect(() => discoverDatabase(333)).toThrow(DatabaseNotFoundError);
+        });
+        it("discovered database can be opened by DatabaseClient", () => {
+            const path = discoverDatabase(111);
+            const client = new DatabaseClient(path);
+            const row = client.db
+                .prepare("SELECT first_name FROM person_mini_profile WHERE person_id = 1")
+                .get();
+            expect(row?.first_name).toBe("Ada");
+            client.close();
+        });
+    });
+    describe("discoverAllDatabases", () => {
+        it("finds all accounts with database files", () => {
+            const result = discoverAllDatabases();
+            expect(result.size).toBe(2);
+            expect(result.get(111)).toBe(dbPath111);
+            expect(result.get(222)).toBe(dbPath222);
+        });
+        it("excludes partitions where db file is missing", () => {
+            const result = discoverAllDatabases();
+            expect(result.has(333)).toBe(false);
+        });
+        it("excludes non-partition directories", () => {
+            const result = discoverAllDatabases();
+            // Only 111 and 222, not "some-unrelated-dir"
+            expect(result.size).toBe(2);
+        });
+        it("all discovered paths are openable by DatabaseClient", () => {
+            const result = discoverAllDatabases();
+            for (const [, path] of result) {
+                const client = new DatabaseClient(path);
+                const row = client.db
+                    .prepare("SELECT COUNT(*) AS cnt FROM people")
+                    .get();
+                expect(row.cnt).toBeGreaterThan(0);
+                client.close();
+            }
+        });
+    });
+});
+//# sourceMappingURL=discovery.integration.test.js.map

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

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

package/dist/db/discovery.js

@@ -0,0 +1,76 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+import { existsSync, readdirSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { DatabaseNotFoundError } from "./errors.js";
+const PARTITION_PREFIX = "linked-helper-account-";
+const PARTITION_SUFFIX = "-main";
+const DB_FILENAME = "lh.db";
+/**
+ * Returns the platform-specific base directory where LinkedHelper
+ * stores its per-account database partitions.
+ */
+function getBaseDirectory() {
+    switch (process.platform) {
+        case "darwin":
+            return join(homedir(), "Library", "Application Support", "linked-helper");
+        case "win32":
+            return join(process.env["APPDATA"] ?? join(homedir(), "AppData", "Roaming"), "linked-helper");
+        default:
+            // Linux and other POSIX
+            return join(homedir(), ".config", "linked-helper");
+    }
+}
+/**
+ * Builds the expected database path for a specific account.
+ */
+function buildDbPath(baseDir, accountId) {
+    const partition = `${PARTITION_PREFIX}${String(accountId)}${PARTITION_SUFFIX}`;
+    return join(baseDir, "Partitions", partition, DB_FILENAME);
+}
+/**
+ * Resolves the database file path for a LinkedHelper account.
+ *
+ * @throws {DatabaseNotFoundError} if the database file does not exist.
+ */
+export function discoverDatabase(accountId) {
+    const dbPath = buildDbPath(getBaseDirectory(), accountId);
+    if (!existsSync(dbPath)) {
+        throw new DatabaseNotFoundError(accountId);
+    }
+    return dbPath;
+}
+/**
+ * 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 function discoverAllDatabases() {
+    const baseDir = getBaseDirectory();
+    const partitionsDir = join(baseDir, "Partitions");
+    const result = new Map();
+    if (!existsSync(partitionsDir)) {
+        return result;
+    }
+    const entries = readdirSync(partitionsDir, { withFileTypes: true });
+    for (const entry of entries) {
+        if (!entry.isDirectory())
+            continue;
+        if (!entry.name.startsWith(PARTITION_PREFIX))
+            continue;
+        if (!entry.name.endsWith(PARTITION_SUFFIX))
+            continue;
+        const idStr = entry.name.slice(PARTITION_PREFIX.length, -PARTITION_SUFFIX.length);
+        const accountId = Number(idStr);
+        if (!Number.isInteger(accountId))
+            continue;
+        const dbPath = join(partitionsDir, entry.name, DB_FILENAME);
+        if (existsSync(dbPath)) {
+            result.set(accountId, dbPath);
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=discovery.js.map

package/dist/db/discovery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"discovery.js","sourceRoot":"","sources":["../../src/db/discovery.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,oCAAoC;AAEpC,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAClD,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAEpD,MAAM,gBAAgB,GAAG,wBAAwB,CAAC;AAClD,MAAM,gBAAgB,GAAG,OAAO,CAAC;AACjC,MAAM,WAAW,GAAG,OAAO,CAAC;AAE5B;;;GAGG;AACH,SAAS,gBAAgB;IACvB,QAAQ,OAAO,CAAC,QAAQ,EAAE,CAAC;QACzB,KAAK,QAAQ;YACX,OAAO,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,qBAAqB,EAAE,eAAe,CAAC,CAAC;QAC5E,KAAK,OAAO;YACV,OAAO,IAAI,CACT,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,SAAS,CAAC,EAC/D,eAAe,CAChB,CAAC;QACJ;YACE,wBAAwB;YACxB,OAAO,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,eAAe,CAAC,CAAC;IACvD,CAAC;AACH,CAAC;AAED;;GAEG;AACH,SAAS,WAAW,CAAC,OAAe,EAAE,SAAiB;IACrD,MAAM,SAAS,GAAG,GAAG,gBAAgB,GAAG,MAAM,CAAC,SAAS,CAAC,GAAG,gBAAgB,EAAE,CAAC;IAC/E,OAAO,IAAI,CAAC,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,WAAW,CAAC,CAAC;AAC7D,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,SAAiB;IAChD,MAAM,MAAM,GAAG,WAAW,CAAC,gBAAgB,EAAE,EAAE,SAAS,CAAC,CAAC;IAC1D,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;QACxB,MAAM,IAAI,qBAAqB,CAAC,SAAS,CAAC,CAAC;IAC7C,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB;IAClC,MAAM,OAAO,GAAG,gBAAgB,EAAE,CAAC;IACnC,MAAM,aAAa,GAAG,IAAI,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;IAElD,MAAM,MAAM,GAAG,IAAI,GAAG,EAAkB,CAAC;IAEzC,IAAI,CAAC,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC;QAC/B,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,MAAM,OAAO,GAAG,WAAW,CAAC,aAAa,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;IACpE,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE;YAAE,SAAS;QACnC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,gBAAgB,CAAC;YAAE,SAAS;QACvD,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,gBAAgB,CAAC;YAAE,SAAS;QAErD,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,CAC5B,gBAAgB,CAAC,MAAM,EACvB,CAAC,gBAAgB,CAAC,MAAM,CACzB,CAAC;QACF,MAAM,SAAS,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;QAChC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,SAAS,CAAC;YAAE,SAAS;QAE3C,MAAM,MAAM,GAAG,IAAI,CAAC,aAAa,EAAE,KAAK,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;QAC5D,IAAI,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;YACvB,MAAM,CAAC,GAAG,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;QAChC,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

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

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

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

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

package/dist/db/discovery.test.js

@@ -0,0 +1,125 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+import { existsSync, readdirSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { afterEach, describe, expect, it, vi } from "vitest";
+import { DatabaseNotFoundError } from "./errors.js";
+import { discoverAllDatabases, discoverDatabase } from "./discovery.js";
+vi.mock("node:fs", () => ({
+    existsSync: vi.fn(),
+    readdirSync: vi.fn(),
+}));
+vi.mock("node:os", () => ({
+    homedir: vi.fn(() => "/home/testuser"),
+}));
+const mockedExistsSync = vi.mocked(existsSync);
+const mockedReaddirSync = vi.mocked(readdirSync);
+const mockedHomedir = vi.mocked(homedir);
+afterEach(() => {
+    vi.restoreAllMocks();
+});
+describe("discoverDatabase", () => {
+    it("returns the database path when the file exists (darwin)", () => {
+        vi.stubGlobal("process", { ...process, platform: "darwin" });
+        mockedHomedir.mockReturnValue("/Users/alice");
+        mockedExistsSync.mockReturnValue(true);
+        const result = discoverDatabase(42);
+        expect(result).toBe(join("/Users/alice/Library/Application Support/linked-helper", "Partitions", "linked-helper-account-42-main", "lh.db"));
+    });
+    it("returns the database path when the file exists (win32)", () => {
+        vi.stubGlobal("process", {
+            ...process,
+            platform: "win32",
+            env: { APPDATA: "C:\\Users\\alice\\AppData\\Roaming" },
+        });
+        mockedHomedir.mockReturnValue("C:\\Users\\alice");
+        mockedExistsSync.mockReturnValue(true);
+        const result = discoverDatabase(7);
+        expect(result).toBe(join("C:\\Users\\alice\\AppData\\Roaming", "linked-helper", "Partitions", "linked-helper-account-7-main", "lh.db"));
+    });
+    it("returns the database path when the file exists (linux)", () => {
+        vi.stubGlobal("process", { ...process, platform: "linux" });
+        mockedHomedir.mockReturnValue("/home/alice");
+        mockedExistsSync.mockReturnValue(true);
+        const result = discoverDatabase(100);
+        expect(result).toBe(join("/home/alice/.config/linked-helper", "Partitions", "linked-helper-account-100-main", "lh.db"));
+    });
+    it("throws DatabaseNotFoundError when the file does not exist", () => {
+        vi.stubGlobal("process", { ...process, platform: "darwin" });
+        mockedHomedir.mockReturnValue("/Users/alice");
+        mockedExistsSync.mockReturnValue(false);
+        expect(() => discoverDatabase(99)).toThrow(DatabaseNotFoundError);
+        expect(() => discoverDatabase(99)).toThrow("No database found for account 99");
+    });
+});
+describe("discoverAllDatabases", () => {
+    it("returns an empty map when the partitions directory does not exist", () => {
+        vi.stubGlobal("process", { ...process, platform: "darwin" });
+        mockedHomedir.mockReturnValue("/Users/alice");
+        mockedExistsSync.mockReturnValue(false);
+        const result = discoverAllDatabases();
+        expect(result.size).toBe(0);
+    });
+    it("discovers multiple account databases", () => {
+        vi.stubGlobal("process", { ...process, platform: "darwin" });
+        mockedHomedir.mockReturnValue("/Users/alice");
+        const baseDir = join("/Users/alice", "Library", "Application Support", "linked-helper", "Partitions");
+        mockedExistsSync.mockImplementation((p) => {
+            const path = String(p);
+            if (path === baseDir)
+                return true;
+            if (path === join(baseDir, "linked-helper-account-1-main", "lh.db"))
+                return true;
+            if (path === join(baseDir, "linked-helper-account-2-main", "lh.db"))
+                return true;
+            return false;
+        });
+        mockedReaddirSync.mockReturnValue([
+            makeDirent("linked-helper-account-1-main", true),
+            makeDirent("linked-helper-account-2-main", true),
+            makeDirent("some-other-dir", true),
+            makeDirent("not-a-directory.txt", false),
+        ]);
+        const result = discoverAllDatabases();
+        expect(result.size).toBe(2);
+        expect(result.get(1)).toBe(join(baseDir, "linked-helper-account-1-main", "lh.db"));
+        expect(result.get(2)).toBe(join(baseDir, "linked-helper-account-2-main", "lh.db"));
+    });
+    it("skips partitions where the db file is missing", () => {
+        vi.stubGlobal("process", { ...process, platform: "darwin" });
+        mockedHomedir.mockReturnValue("/Users/alice");
+        const baseDir = join("/Users/alice", "Library", "Application Support", "linked-helper", "Partitions");
+        mockedExistsSync.mockImplementation((p) => {
+            const path = String(p);
+            if (path === baseDir)
+                return true;
+            // Account 1 has a db, account 2 does not
+            if (path === join(baseDir, "linked-helper-account-1-main", "lh.db"))
+                return true;
+            return false;
+        });
+        mockedReaddirSync.mockReturnValue([
+            makeDirent("linked-helper-account-1-main", true),
+            makeDirent("linked-helper-account-2-main", true),
+        ]);
+        const result = discoverAllDatabases();
+        expect(result.size).toBe(1);
+        expect(result.has(2)).toBe(false);
+    });
+});
+function makeDirent(name, isDir) {
+    return {
+        name,
+        isDirectory: () => isDir,
+        isFile: () => !isDir,
+        isBlockDevice: () => false,
+        isCharacterDevice: () => false,
+        isFIFO: () => false,
+        isSocket: () => false,
+        isSymbolicLink: () => false,
+        parentPath: "",
+        path: "",
+    };
+}
+//# sourceMappingURL=discovery.test.js.map

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

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

package/dist/db/errors.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Base class for all database-related errors.
+ */
+export declare class DatabaseError extends Error {
+    constructor(message: string, options?: ErrorOptions);
+}
+/**
+ * Thrown when a LinkedHelper database file cannot be found at the
+ * expected location for a given account.
+ */
+export declare class DatabaseNotFoundError extends DatabaseError {
+    constructor(accountId: number);
+}
+/**
+ * Thrown when a chat lookup yields no results.
+ */
+export declare class ChatNotFoundError extends DatabaseError {
+    constructor(chatId: number);
+}
+/**
+ * Thrown when a profile lookup yields no results. The person may not
+ * have been extracted by LinkedHelper yet.
+ */
+export declare class ProfileNotFoundError extends DatabaseError {
+    constructor(identifier: number | string);
+}
+/**
+ * Thrown when a campaign lookup yields no results.
+ */
+export declare class CampaignNotFoundError extends DatabaseError {
+    readonly campaignId: number;
+    constructor(campaignId: number);
+}
+/**
+ * Thrown when a campaign action lookup yields no results.
+ */
+export declare class ActionNotFoundError extends DatabaseError {
+    constructor(actionId: number, campaignId: number);
+}
+/**
+ * Thrown when an action has no successor in the campaign chain.
+ */
+export declare class NoNextActionError extends DatabaseError {
+    constructor(actionId: number, campaignId: number);
+}
+/**
+ * Thrown when an exclude list is not found for a campaign or action.
+ */
+export declare class ExcludeListNotFoundError extends DatabaseError {
+    constructor(level: "campaign" | "action", id: number);
+}
+//# sourceMappingURL=errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/db/errors.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,qBAAa,aAAc,SAAQ,KAAK;gBAC1B,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY;CAIpD;AAED;;;GAGG;AACH,qBAAa,qBAAsB,SAAQ,aAAa;gBAC1C,SAAS,EAAE,MAAM;CAI9B;AAED;;GAEG;AACH,qBAAa,iBAAkB,SAAQ,aAAa;gBACtC,MAAM,EAAE,MAAM;CAI3B;AAED;;;GAGG;AACH,qBAAa,oBAAqB,SAAQ,aAAa;gBACzC,UAAU,EAAE,MAAM,GAAG,MAAM;CAUxC;AAED;;GAEG;AACH,qBAAa,qBAAsB,SAAQ,aAAa;IACtD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;gBAEhB,UAAU,EAAE,MAAM;CAK/B;AAED;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,aAAa;gBACxC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM;CAMjD;AAED;;GAEG;AACH,qBAAa,iBAAkB,SAAQ,aAAa;gBACtC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM;CAMjD;AAED;;GAEG;AACH,qBAAa,wBAAyB,SAAQ,aAAa;gBAC7C,KAAK,EAAE,UAAU,GAAG,QAAQ,EAAE,EAAE,EAAE,MAAM;CAIrD"}