@lhremote/core 0.1.0 → 0.2.1

package/dist/db/repositories/campaign-exclude-list.js

@@ -0,0 +1,204 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+import { ActionNotFoundError, CampaignNotFoundError, ExcludeListNotFoundError, } from "../errors.js";
+/**
+ * Repository for campaign exclude-list operations.
+ *
+ * Provides read operations (getExcludeList) and write operations
+ * (addToExcludeList, removeFromExcludeList) for campaign and
+ * action-level exclude lists.
+ *
+ * Write operations require the DatabaseClient to be opened with
+ * `{ readOnly: false }`.
+ */
+export class CampaignExcludeListRepository {
+    client;
+    stmtGetCampaign;
+    stmtGetCampaignActions;
+    // Write statements (prepared lazily to avoid issues with read-only mode)
+    writeStatements = null;
+    constructor(client) {
+        this.client = client;
+        const { db } = client;
+        this.stmtGetCampaign = db.prepare(`SELECT id, name, description, is_paused, is_archived, is_valid,
+              li_account_id, created_at
+       FROM campaigns WHERE id = ?`);
+        this.stmtGetCampaignActions = db.prepare(`SELECT a.id, a.campaign_id
+       FROM actions a
+       WHERE a.campaign_id = ?
+       ORDER BY a.id`);
+    }
+    /**
+     * Get the exclude list for a campaign or action.
+     *
+     * @param campaignId - Campaign ID (verified to exist).
+     * @param actionId - If provided, get the action-level exclude list.
+     *   Otherwise, get the campaign-level exclude list.
+     * @throws {CampaignNotFoundError} if the campaign does not exist.
+     * @throws {ActionNotFoundError} if actionId is provided and not in the campaign.
+     * @throws {ExcludeListNotFoundError} if the exclude list chain is not found.
+     */
+    getExcludeList(campaignId, actionId) {
+        const { collectionId } = this.resolveExcludeListContext(campaignId, actionId);
+        const rows = this.client.db
+            .prepare(`SELECT person_id FROM collection_people
+         WHERE collection_id = ?
+         ORDER BY person_id`)
+            .all(collectionId);
+        return rows.map((r) => ({ personId: r.person_id }));
+    }
+    /**
+     * Add people to a campaign or action exclude list.
+     *
+     * @param campaignId - Campaign ID (verified to exist).
+     * @param personIds - Person IDs to add.
+     * @param actionId - If provided, add to the action-level exclude list.
+     * @returns Number of people actually added (excludes already-present).
+     * @throws {CampaignNotFoundError} if the campaign does not exist.
+     * @throws {ActionNotFoundError} if actionId is provided and not in the campaign.
+     * @throws {ExcludeListNotFoundError} if the exclude list chain is not found.
+     */
+    addToExcludeList(campaignId, personIds, actionId) {
+        if (personIds.length === 0)
+            return 0;
+        const { collectionId } = this.resolveExcludeListContext(campaignId, actionId);
+        const stmts = this.getWriteStatements();
+        let added = 0;
+        this.client.db.exec("BEGIN");
+        try {
+            for (const personId of personIds) {
+                const result = stmts.insertCollectionPerson.run(collectionId, personId);
+                if (result.changes > 0)
+                    added++;
+            }
+            this.client.db.exec("COMMIT");
+        }
+        catch (e) {
+            this.client.db.exec("ROLLBACK");
+            throw e;
+        }
+        return added;
+    }
+    /**
+     * Remove people from a campaign or action exclude list.
+     *
+     * @param campaignId - Campaign ID (verified to exist).
+     * @param personIds - Person IDs to remove.
+     * @param actionId - If provided, remove from the action-level exclude list.
+     * @returns Number of people actually removed.
+     * @throws {CampaignNotFoundError} if the campaign does not exist.
+     * @throws {ActionNotFoundError} if actionId is provided and not in the campaign.
+     * @throws {ExcludeListNotFoundError} if the exclude list chain is not found.
+     */
+    removeFromExcludeList(campaignId, personIds, actionId) {
+        if (personIds.length === 0)
+            return 0;
+        const { collectionId } = this.resolveExcludeListContext(campaignId, actionId);
+        const stmts = this.getWriteStatements();
+        let removed = 0;
+        this.client.db.exec("BEGIN");
+        try {
+            for (const personId of personIds) {
+                const result = stmts.deleteCollectionPerson.run(collectionId, personId);
+                if (result.changes > 0)
+                    removed++;
+            }
+            this.client.db.exec("COMMIT");
+        }
+        catch (e) {
+            this.client.db.exec("ROLLBACK");
+            throw e;
+        }
+        return removed;
+    }
+    /**
+     * Prepare write statements lazily (only when needed).
+     * This avoids issues when the client is opened in read-only mode.
+     */
+    getWriteStatements() {
+        if (this.writeStatements)
+            return this.writeStatements;
+        const { db } = this.client;
+        this.writeStatements = {
+            insertCollectionPerson: db.prepare(`INSERT OR IGNORE INTO collection_people (collection_id, person_id)
+         VALUES (?, ?)`),
+            deleteCollectionPerson: db.prepare(`DELETE FROM collection_people
+         WHERE collection_id = ? AND person_id = ?`),
+        };
+        return this.writeStatements;
+    }
+    /**
+     * Resolve the collection_id for an exclude list.
+     *
+     * Follows the chain: exclude_list_id -> collection_people_versions -> collection_id.
+     *
+     * @param level - "campaign" or "action"
+     * @param id - Campaign ID (if level is "campaign") or action ID (if level is "action")
+     * @throws {ExcludeListNotFoundError} if the exclude list chain is not found.
+     */
+    resolveExcludeListCollectionId(level, id) {
+        const { db } = this.client;
+        let excludeListId = null;
+        if (level === "campaign") {
+            const row = db
+                .prepare(`SELECT exclude_list_id FROM campaign_versions
+           WHERE campaign_id = ? ORDER BY id DESC LIMIT 1`)
+                .get(id);
+            excludeListId = row?.exclude_list_id ?? null;
+        }
+        else {
+            const row = db
+                .prepare(`SELECT exclude_list_id FROM action_versions
+           WHERE action_id = ? ORDER BY id DESC LIMIT 1`)
+                .get(id);
+            excludeListId = row?.exclude_list_id ?? null;
+        }
+        if (excludeListId === null) {
+            throw new ExcludeListNotFoundError(level, id);
+        }
+        // Resolve CPV -> collection_id
+        const cpv = db
+            .prepare(`SELECT collection_id FROM collection_people_versions WHERE id = ?`)
+            .get(excludeListId);
+        if (!cpv) {
+            throw new ExcludeListNotFoundError(level, id);
+        }
+        return cpv.collection_id;
+    }
+    /**
+     * Validate campaign/action and resolve the exclude-list collection ID.
+     *
+     * Shared preamble for {@link getExcludeList}, {@link addToExcludeList},
+     * and {@link removeFromExcludeList}.
+     *
+     * @param campaignId - Campaign ID (verified to exist).
+     * @param actionId - If provided, scope to the action-level exclude list.
+     * @throws {CampaignNotFoundError} if the campaign does not exist.
+     * @throws {ActionNotFoundError} if actionId is provided and not in the campaign.
+     * @throws {ExcludeListNotFoundError} if the exclude list chain is not found.
+     */
+    resolveExcludeListContext(campaignId, actionId) {
+        this.verifyCampaignExists(campaignId);
+        if (actionId !== undefined) {
+            const rows = this.stmtGetCampaignActions.all(campaignId);
+            if (!rows.some((a) => a.id === actionId)) {
+                throw new ActionNotFoundError(actionId, campaignId);
+            }
+        }
+        const level = actionId !== undefined ? "action" : "campaign";
+        const targetId = actionId ?? campaignId;
+        const collectionId = this.resolveExcludeListCollectionId(level, targetId);
+        return { collectionId, level, targetId };
+    }
+    /**
+     * Verify that a campaign exists.
+     *
+     * @throws {CampaignNotFoundError} if no campaign exists with the given ID.
+     */
+    verifyCampaignExists(campaignId) {
+        const row = this.stmtGetCampaign.get(campaignId);
+        if (!row)
+            throw new CampaignNotFoundError(campaignId);
+    }
+}
+//# sourceMappingURL=campaign-exclude-list.js.map

package/dist/db/repositories/campaign-exclude-list.js.map

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

package/dist/db/repositories/campaign-exclude-list.test.d.ts

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

package/dist/db/repositories/campaign-exclude-list.test.d.ts.map

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

package/dist/db/repositories/campaign-exclude-list.test.js

@@ -0,0 +1,132 @@
+// 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 { ActionNotFoundError, CampaignNotFoundError, ExcludeListNotFoundError, } from "../errors.js";
+import { openFixture } from "../testing/open-fixture.js";
+import { CampaignExcludeListRepository } from "./campaign-exclude-list.js";
+describe("CampaignExcludeListRepository", () => {
+    let db;
+    let client;
+    let repo;
+    beforeEach(() => {
+        db = openFixture();
+        client = { db };
+        repo = new CampaignExcludeListRepository(client);
+    });
+    afterEach(() => {
+        db.close();
+    });
+    describe("getExcludeList", () => {
+        // Campaign 1 has campaign-level exclude list with person 2 pre-populated
+        // Campaign 5 has campaign-level exclude list (empty) and action-level lists (empty)
+        it("returns campaign-level exclude list", () => {
+            const entries = repo.getExcludeList(1);
+            expect(entries).toEqual([{ personId: 2 }]);
+        });
+        it("returns empty list when no people excluded", () => {
+            const entries = repo.getExcludeList(5);
+            expect(entries).toEqual([]);
+        });
+        it("returns action-level exclude list", () => {
+            const entries = repo.getExcludeList(1, 1);
+            // Action 1's exclude list (collection 2) has no people
+            expect(entries).toEqual([]);
+        });
+        it("throws CampaignNotFoundError for missing campaign", () => {
+            expect(() => repo.getExcludeList(999)).toThrow(CampaignNotFoundError);
+        });
+        it("throws ActionNotFoundError for action not in campaign", () => {
+            expect(() => repo.getExcludeList(1, 999)).toThrow(ActionNotFoundError);
+        });
+        it("throws ExcludeListNotFoundError when campaign has no exclude list chain", () => {
+            // Campaign 2 has no campaign_versions entry
+            expect(() => repo.getExcludeList(2)).toThrow(ExcludeListNotFoundError);
+        });
+        it("returns entries ordered by person_id", () => {
+            // Add multiple people to campaign 1's exclude list
+            db.exec(`
+        INSERT INTO collection_people (collection_id, person_id) VALUES (1, 3);
+        INSERT INTO collection_people (collection_id, person_id) VALUES (1, 1);
+      `);
+            const entries = repo.getExcludeList(1);
+            expect(entries.map((e) => e.personId)).toEqual([1, 2, 3]);
+        });
+    });
+    describe("addToExcludeList", () => {
+        it("adds people to campaign-level exclude list", () => {
+            const added = repo.addToExcludeList(1, [1, 3]);
+            expect(added).toBe(2);
+            // Verify in database
+            const entries = repo.getExcludeList(1);
+            expect(entries.map((e) => e.personId)).toContain(1);
+            expect(entries.map((e) => e.personId)).toContain(3);
+        });
+        it("skips already-excluded people", () => {
+            // Person 2 is already in campaign 1's exclude list
+            const added = repo.addToExcludeList(1, [2, 3]);
+            expect(added).toBe(1); // Only person 3 was newly added
+            const entries = repo.getExcludeList(1);
+            expect(entries).toHaveLength(2); // Person 2 (existing) + person 3 (new)
+        });
+        it("adds people to action-level exclude list", () => {
+            const added = repo.addToExcludeList(1, [1], 1);
+            expect(added).toBe(1);
+            const entries = repo.getExcludeList(1, 1);
+            expect(entries).toEqual([{ personId: 1 }]);
+        });
+        it("returns 0 for empty person list", () => {
+            const added = repo.addToExcludeList(1, []);
+            expect(added).toBe(0);
+        });
+        it("throws CampaignNotFoundError for missing campaign", () => {
+            expect(() => repo.addToExcludeList(999, [1])).toThrow(CampaignNotFoundError);
+        });
+        it("throws ActionNotFoundError for action not in campaign", () => {
+            expect(() => repo.addToExcludeList(1, [1], 999)).toThrow(ActionNotFoundError);
+        });
+        it("throws ExcludeListNotFoundError when exclude list chain missing", () => {
+            expect(() => repo.addToExcludeList(2, [1])).toThrow(ExcludeListNotFoundError);
+        });
+    });
+    describe("removeFromExcludeList", () => {
+        it("removes people from campaign-level exclude list", () => {
+            // Person 2 is in campaign 1's exclude list
+            const removed = repo.removeFromExcludeList(1, [2]);
+            expect(removed).toBe(1);
+            const entries = repo.getExcludeList(1);
+            expect(entries).toEqual([]);
+        });
+        it("returns 0 for people not in the list", () => {
+            const removed = repo.removeFromExcludeList(1, [999]);
+            expect(removed).toBe(0);
+        });
+        it("removes people from action-level exclude list", () => {
+            // First add a person to action 1's exclude list
+            repo.addToExcludeList(1, [1], 1);
+            const removed = repo.removeFromExcludeList(1, [1], 1);
+            expect(removed).toBe(1);
+            const entries = repo.getExcludeList(1, 1);
+            expect(entries).toEqual([]);
+        });
+        it("handles mixed present and absent people", () => {
+            // Person 2 is in the list, person 999 is not
+            const removed = repo.removeFromExcludeList(1, [2, 999]);
+            expect(removed).toBe(1);
+        });
+        it("returns 0 for empty person list", () => {
+            const removed = repo.removeFromExcludeList(1, []);
+            expect(removed).toBe(0);
+        });
+        it("throws CampaignNotFoundError for missing campaign", () => {
+            expect(() => repo.removeFromExcludeList(999, [1])).toThrow(CampaignNotFoundError);
+        });
+        it("throws ActionNotFoundError for action not in campaign", () => {
+            expect(() => repo.removeFromExcludeList(1, [1], 999)).toThrow(ActionNotFoundError);
+        });
+        it("throws ExcludeListNotFoundError when exclude list chain missing", () => {
+            expect(() => repo.removeFromExcludeList(2, [1])).toThrow(ExcludeListNotFoundError);
+        });
+    });
+});
+//# sourceMappingURL=campaign-exclude-list.test.js.map

package/dist/db/repositories/campaign-exclude-list.test.js.map

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

package/dist/db/repositories/campaign-statistics.d.ts

@@ -0,0 +1,58 @@
+import type { CampaignStatistics, GetStatisticsOptions } from "../../types/index.js";
+import type { DatabaseClient } from "../client.js";
+/**
+ * Repository for campaign statistics and reset operations.
+ *
+ * Provides read operations (getStatistics) and write operations
+ * (resetForRerun) for campaign execution data.
+ *
+ * Write operations require the DatabaseClient to be opened with
+ * `{ readOnly: false }`.
+ */
+export declare class CampaignStatisticsRepository {
+    private readonly client;
+    private readonly stmtGetCampaign;
+    private readonly stmtGetCampaignActions;
+    private readonly stmtGetActionVersions;
+    private writeStatements;
+    constructor(client: DatabaseClient);
+    /**
+     * Get aggregated statistics for a campaign.
+     *
+     * Returns per-action result breakdowns (success/failure/skip/reply rates),
+     * top error codes with blame attribution, and processing timeline.
+     *
+     * @throws {CampaignNotFoundError} if no campaign exists with the given ID.
+     * @throws {ActionNotFoundError} if actionId is provided and not in the campaign.
+     */
+    getStatistics(campaignId: number, options?: GetStatisticsOptions): CampaignStatistics;
+    /**
+     * Reset persons for re-run in a campaign.
+     *
+     * This performs the three-table reset pattern required by LinkedHelper:
+     * 1. Requeue person in action_target_people (state = 1)
+     * 2. Reset person_in_campaigns_history (result_status = -999)
+     * 3. Delete old action_results (and FK children)
+     *
+     * @throws {CampaignNotFoundError} if no campaign exists with the given ID.
+     */
+    resetForRerun(campaignId: number, personIds: number[]): void;
+    /**
+     * Get all actions for a campaign.
+     *
+     * @throws {CampaignNotFoundError} if no campaign exists with the given ID.
+     */
+    private getCampaignActions;
+    /**
+     * Prepare write statements lazily (only when needed).
+     * This avoids issues when the client is opened in read-only mode.
+     */
+    private getWriteStatements;
+    /**
+     * Verify that a campaign exists.
+     *
+     * @throws {CampaignNotFoundError} if no campaign exists with the given ID.
+     */
+    private verifyCampaignExists;
+}
+//# sourceMappingURL=campaign-statistics.d.ts.map

package/dist/db/repositories/campaign-statistics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"campaign-statistics.d.ts","sourceRoot":"","sources":["../../../src/db/repositories/campaign-statistics.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAMV,kBAAkB,EAClB,oBAAoB,EACrB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AA6BnD;;;;;;;;GAQG;AACH,qBAAa,4BAA4B;IAc3B,OAAO,CAAC,QAAQ,CAAC,MAAM;IAbnC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAC;IACjC,OAAO,CAAC,QAAQ,CAAC,sBAAsB,CAAC;IACxC,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAAC;IAGvC,OAAO,CAAC,eAAe,CAMP;gBAEa,MAAM,EAAE,cAAc;IA8BnD;;;;;;;;OAQG;IACH,aAAa,CACX,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE,oBAAyB,GACjC,kBAAkB;IAyIrB;;;;;;;;;OASG;IACH,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,IAAI;IAuC5D;;;;OAIG;IACH,OAAO,CAAC,kBAAkB;IAoC1B;;;OAGG;IACH,OAAO,CAAC,kBAAkB;IAqD1B;;;;OAIG;IACH,OAAO,CAAC,oBAAoB;CAI7B"}