@lhremote/core 0.0.0 → 0.2.0

package/dist/db/repositories/campaign-statistics.test.js

@@ -0,0 +1,266 @@
+// 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, } from "../errors.js";
+import { openFixture } from "../testing/open-fixture.js";
+import { CampaignStatisticsRepository } from "./campaign-statistics.js";
+describe("CampaignStatisticsRepository", () => {
+    let db;
+    let client;
+    let repo;
+    beforeEach(() => {
+        db = openFixture();
+        client = { db };
+        repo = new CampaignStatisticsRepository(client);
+    });
+    afterEach(() => {
+        db.close();
+    });
+    describe("getStatistics", () => {
+        // Campaign 1 fixture data:
+        //   Action 1 ("Send Welcome Message", MessageToPerson) with 4 results:
+        //     person 1: result=1 (successful)
+        //     person 3: result=2 (replied)
+        //     person 2: result=-1 (failed)
+        //     person 4: result=-2 (skipped)
+        //   Error flags (code != NULL):
+        //     code=100, is_exception=0, who_to_blame='LinkedIn' (x2)
+        //     code=200, is_exception=1, who_to_blame='LH' (x1)
+        it("returns per-action breakdown for a campaign", () => {
+            const stats = repo.getStatistics(1);
+            expect(stats.campaignId).toBe(1);
+            expect(stats.actions).toHaveLength(1);
+            const action = stats.actions.at(0);
+            expect(action).toBeDefined();
+            expect(action).toMatchObject({
+                actionId: 1,
+                actionName: "Send Welcome Message",
+                actionType: "MessageToPerson",
+            });
+        });
+        it("counts successful/replied/failed/skipped correctly", () => {
+            const stats = repo.getStatistics(1);
+            const action = stats.actions.at(0);
+            expect(action).toBeDefined();
+            expect(action?.successful).toBe(1);
+            expect(action?.replied).toBe(1);
+            expect(action?.failed).toBe(1);
+            expect(action?.skipped).toBe(1);
+            expect(action?.total).toBe(4);
+        });
+        it("calculates success rate correctly", () => {
+            const stats = repo.getStatistics(1);
+            const action = stats.actions.at(0);
+            expect(action).toBeDefined();
+            // successRate = round(((successful + replied) / total) * 1000) / 10
+            // = round(((1 + 1) / 4) * 1000) / 10 = round(500) / 10 = 50
+            expect(action?.successRate).toBe(50);
+        });
+        it("returns top errors with blame attribution", () => {
+            const stats = repo.getStatistics(1);
+            const action = stats.actions.at(0);
+            expect(action).toBeDefined();
+            const errors = action?.topErrors ?? [];
+            expect(errors).toHaveLength(2);
+            expect(errors.at(0)).toMatchObject({
+                code: 100,
+                count: 2,
+                isException: false,
+                whoToBlame: "LinkedIn",
+            });
+            expect(errors.at(1)).toMatchObject({
+                code: 200,
+                count: 1,
+                isException: true,
+                whoToBlame: "LH",
+            });
+        });
+        it("orders top errors by count descending", () => {
+            const stats = repo.getStatistics(1);
+            const action = stats.actions.at(0);
+            expect(action).toBeDefined();
+            const errors = action?.topErrors ?? [];
+            for (let i = 1; i < errors.length; i++) {
+                expect(errors[i - 1]?.count).toBeGreaterThanOrEqual(errors[i]?.count ?? 0);
+            }
+        });
+        it("respects maxErrors option", () => {
+            const stats = repo.getStatistics(1, { maxErrors: 1 });
+            const action = stats.actions.at(0);
+            expect(action).toBeDefined();
+            const errors = action?.topErrors ?? [];
+            expect(errors).toHaveLength(1);
+            expect(errors.at(0)?.code).toBe(100);
+        });
+        it("filters by actionId when provided", () => {
+            const stats = repo.getStatistics(1, { actionId: 1 });
+            expect(stats.actions).toHaveLength(1);
+            expect(stats.actions.at(0)?.actionId).toBe(1);
+        });
+        it("throws CampaignNotFoundError for missing campaign", () => {
+            expect(() => repo.getStatistics(999)).toThrow(CampaignNotFoundError);
+        });
+        it("throws ActionNotFoundError for invalid actionId", () => {
+            expect(() => repo.getStatistics(1, { actionId: 999 })).toThrow(ActionNotFoundError);
+        });
+        it("handles campaign with no results", () => {
+            // Campaign 3 has no actions (archived)
+            const stats = repo.getStatistics(3);
+            expect(stats.campaignId).toBe(3);
+            expect(stats.actions).toHaveLength(0);
+            expect(stats.totals).toMatchObject({
+                successful: 0,
+                replied: 0,
+                failed: 0,
+                skipped: 0,
+                total: 0,
+                successRate: 0,
+            });
+        });
+        it("aggregates totals across all actions", () => {
+            const stats = repo.getStatistics(1);
+            expect(stats.totals).toMatchObject({
+                successful: 1,
+                replied: 1,
+                failed: 1,
+                skipped: 1,
+                total: 4,
+                successRate: 50,
+            });
+        });
+        it("includes first and last result timestamps", () => {
+            const stats = repo.getStatistics(1);
+            const action = stats.actions.at(0);
+            expect(action).toBeDefined();
+            expect(action?.firstResultAt).toBe("2025-01-15T12:30:00.000Z");
+            expect(action?.lastResultAt).toBe("2025-01-15T14:00:00.000Z");
+        });
+    });
+    describe("resetForRerun", () => {
+        it("resets person state for re-run", () => {
+            // Initial state: person 1 has state=2 (processed), person 3 has state=1 (queued)
+            const initialTargets = db
+                .prepare("SELECT person_id, state FROM action_target_people WHERE action_id = 1")
+                .all();
+            const initialPerson1 = initialTargets.find((t) => t.person_id === 1);
+            expect(initialPerson1).toBeDefined();
+            expect(initialPerson1?.state).toBe(2);
+            // Reset person 1
+            repo.resetForRerun(1, [1]);
+            // Verify state reset to 1 (queued)
+            const afterTargets = db
+                .prepare("SELECT person_id, state FROM action_target_people WHERE action_id = 1")
+                .all();
+            const afterPerson1 = afterTargets.find((t) => t.person_id === 1);
+            expect(afterPerson1).toBeDefined();
+            expect(afterPerson1?.state).toBe(1);
+        });
+        it("resets campaign history for re-run", () => {
+            // Initial state: person 1 has result_status=1 (success)
+            const initialHistory = db
+                .prepare("SELECT result_status FROM person_in_campaigns_history WHERE campaign_id = 1 AND person_id = 1")
+                .get();
+            expect(initialHistory).toBeDefined();
+            expect(initialHistory?.result_status).toBe(1);
+            // Reset person 1
+            repo.resetForRerun(1, [1]);
+            // Verify result_status reset to -999
+            const afterHistory = db
+                .prepare("SELECT result_status FROM person_in_campaigns_history WHERE campaign_id = 1 AND person_id = 1")
+                .get();
+            expect(afterHistory).toBeDefined();
+            expect(afterHistory?.result_status).toBe(-999);
+        });
+        it("deletes old action results and related records", () => {
+            // Verify initial state has results
+            const initialResults = db
+                .prepare("SELECT id FROM action_results WHERE action_version_id = 1 AND person_id = 1")
+                .all();
+            expect(initialResults).toHaveLength(1);
+            const initialFlags = db
+                .prepare("SELECT id FROM action_result_flags WHERE action_result_id = 1")
+                .all();
+            expect(initialFlags).toHaveLength(1);
+            const initialMessages = db
+                .prepare("SELECT id FROM action_result_messages WHERE action_result_id = 1")
+                .all();
+            expect(initialMessages).toHaveLength(1);
+            // Reset person 1
+            repo.resetForRerun(1, [1]);
+            // Verify all deleted
+            const afterResults = db
+                .prepare("SELECT id FROM action_results WHERE action_version_id = 1 AND person_id = 1")
+                .all();
+            expect(afterResults).toHaveLength(0);
+            const afterFlags = db
+                .prepare("SELECT id FROM action_result_flags WHERE action_result_id = 1")
+                .all();
+            expect(afterFlags).toHaveLength(0);
+            const afterMessages = db
+                .prepare("SELECT id FROM action_result_messages WHERE action_result_id = 1")
+                .all();
+            expect(afterMessages).toHaveLength(0);
+        });
+        it("handles multiple persons in a single reset", () => {
+            repo.resetForRerun(1, [1, 3]);
+            // Both persons should have state=1
+            const targets = db
+                .prepare("SELECT person_id, state FROM action_target_people WHERE action_id = 1")
+                .all();
+            const stateByPerson = new Map(targets.map((t) => [t.person_id, t.state]));
+            expect(stateByPerson.get(1)).toBe(1);
+            expect(stateByPerson.get(3)).toBe(1);
+        });
+        it("handles empty person list gracefully", () => {
+            // Should not throw
+            expect(() => repo.resetForRerun(1, [])).not.toThrow();
+        });
+        it("throws CampaignNotFoundError for missing campaign", () => {
+            expect(() => repo.resetForRerun(999, [1])).toThrow(CampaignNotFoundError);
+        });
+        it("handles campaign with no actions gracefully", () => {
+            // Campaign 3 has no actions
+            expect(() => repo.resetForRerun(3, [1])).not.toThrow();
+        });
+    });
+    describe("resetForRerun — rollback", () => {
+        it("rolls back transaction on error and preserves database state", () => {
+            // Snapshot initial state
+            const initialTargets = db
+                .prepare("SELECT person_id, state FROM action_target_people WHERE action_id = 1 ORDER BY person_id")
+                .all();
+            const initialHistory = db
+                .prepare("SELECT person_id, result_status FROM person_in_campaigns_history WHERE campaign_id = 1 ORDER BY person_id")
+                .all();
+            const initialResults = db
+                .prepare("SELECT id FROM action_results WHERE action_version_id = 1 ORDER BY id")
+                .all();
+            // Sabotage a write statement to force an error mid-transaction
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any -- private method access for rollback test
+            const stmts = repo.getWriteStatements();
+            const originalRun = stmts.resetHistory.run.bind(stmts.resetHistory);
+            stmts.resetHistory.run = () => {
+                throw new Error("Simulated DB error");
+            };
+            // Attempt reset — should throw the simulated error
+            expect(() => repo.resetForRerun(1, [1])).toThrow("Simulated DB error");
+            // Restore original to avoid side effects
+            stmts.resetHistory.run = originalRun;
+            // Verify database state is unchanged (ROLLBACK worked)
+            const afterTargets = db
+                .prepare("SELECT person_id, state FROM action_target_people WHERE action_id = 1 ORDER BY person_id")
+                .all();
+            const afterHistory = db
+                .prepare("SELECT person_id, result_status FROM person_in_campaigns_history WHERE campaign_id = 1 ORDER BY person_id")
+                .all();
+            const afterResults = db
+                .prepare("SELECT id FROM action_results WHERE action_version_id = 1 ORDER BY id")
+                .all();
+            expect(afterTargets).toEqual(initialTargets);
+            expect(afterHistory).toEqual(initialHistory);
+            expect(afterResults).toEqual(initialResults);
+        });
+    });
+});
+//# sourceMappingURL=campaign-statistics.test.js.map

package/dist/db/repositories/campaign-statistics.test.js.map

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

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

@@ -0,0 +1,103 @@
+import type { CampaignActionConfig, CampaignActionResult, Campaign, CampaignAction, CampaignState, CampaignSummary, CampaignUpdateConfig, GetResultsOptions, ListCampaignsOptions } from "../../types/index.js";
+import type { DatabaseClient } from "../client.js";
+/**
+ * Repository for campaign CRUD, creation support, and action chain operations.
+ *
+ * Provides read operations (list, get, getActions, getResults, getState)
+ * and write operations (fixIsValid, createActionExcludeLists, addAction,
+ * moveToNextAction, updateCampaign) for LinkedHelper campaigns.
+ *
+ * Write operations require the DatabaseClient to be opened with
+ * `{ readOnly: false }`.
+ */
+export declare class CampaignRepository {
+    private readonly client;
+    private readonly stmtListCampaigns;
+    private readonly stmtListAllCampaigns;
+    private readonly stmtGetCampaign;
+    private readonly stmtGetCampaignActions;
+    private readonly stmtGetResults;
+    private writeStatements;
+    constructor(client: DatabaseClient);
+    /**
+     * List campaigns, optionally including archived ones.
+     */
+    listCampaigns(options?: ListCampaignsOptions): CampaignSummary[];
+    /**
+     * Get a campaign by ID.
+     *
+     * @throws {CampaignNotFoundError} if no campaign exists with the given ID.
+     */
+    getCampaign(campaignId: number): Campaign;
+    /**
+     * Get all actions for a campaign.
+     *
+     * @throws {CampaignNotFoundError} if no campaign exists with the given ID.
+     */
+    getCampaignActions(campaignId: number): CampaignAction[];
+    /**
+     * Get execution results for a campaign.
+     *
+     * @throws {CampaignNotFoundError} if no campaign exists with the given ID.
+     */
+    getResults(campaignId: number, options?: GetResultsOptions): CampaignActionResult[];
+    /**
+     * Get the current state of a campaign.
+     *
+     * @throws {CampaignNotFoundError} if no campaign exists with the given ID.
+     */
+    getCampaignState(campaignId: number): CampaignState;
+    /**
+     * Update a campaign's name and/or description.
+     *
+     * @throws {CampaignNotFoundError} if no campaign exists with the given ID.
+     */
+    updateCampaign(campaignId: number, updates: CampaignUpdateConfig): Campaign;
+    /**
+     * Prepare write statements lazily (only when needed).
+     * This avoids issues when the client is opened in read-only mode.
+     */
+    private getWriteStatements;
+    /**
+     * Fix the is_valid flag after programmatic campaign creation.
+     *
+     * Campaigns created via `createCampaign()` have `is_valid = NULL`,
+     * making them invisible in the LinkedHelper UI. This sets
+     * `is_valid = 1` to match the behavior of the UI campaign editor.
+     */
+    fixIsValid(campaignId: number): void;
+    /**
+     * Create action-level exclude lists after programmatic campaign creation.
+     *
+     * The `createCampaign()` API creates campaign-level exclude lists but
+     * skips action-level ones due to a code path bug. The LH UI crashes
+     * with "Expected excludeListId but got null" when opening campaigns
+     * missing these. This creates the full exclude list chain for each
+     * action: collection -> collection_people_versions -> action_versions.
+     */
+    createActionExcludeLists(campaignId: number, liAccountId: number): void;
+    /**
+     * Add a new action to an existing campaign's action chain.
+     *
+     * Creates the full action record set via direct DB operations:
+     * action_configs -> actions -> action_versions (x2) -> exclude list chain.
+     *
+     * @throws {CampaignNotFoundError} if no campaign exists with the given ID.
+     */
+    addAction(campaignId: number, actionConfig: CampaignActionConfig, liAccountId: number): CampaignAction;
+    /**
+     * Move people from the current action to the next action in the chain.
+     *
+     * For each person:
+     * 1. Mark the person as successful (state=3) in the current action
+     * 2. Queue the person (state=1) in the next action's target list
+     *
+     * @throws {CampaignNotFoundError} if no campaign exists with the given ID.
+     * @throws {ActionNotFoundError} if the action does not belong to the campaign.
+     * @throws {NoNextActionError} if the action is the last in the chain.
+     */
+    moveToNextAction(campaignId: number, actionId: number, personIds: number[]): {
+        nextActionId: number;
+    };
+}
+//# sourceMappingURL=campaign.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"campaign.d.ts","sourceRoot":"","sources":["../../../src/db/repositories/campaign.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAGV,oBAAoB,EACpB,oBAAoB,EACpB,QAAQ,EACR,cAAc,EACd,aAAa,EACb,eAAe,EACf,oBAAoB,EACpB,iBAAiB,EACjB,oBAAoB,EACrB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AA0DnD;;;;;;;;;GASG;AACH,qBAAa,kBAAkB;IAsBjB,OAAO,CAAC,QAAQ,CAAC,MAAM;IArBnC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAC;IACnC,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAC;IACtC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAC;IACjC,OAAO,CAAC,QAAQ,CAAC,sBAAsB,CAAC;IACxC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC;IAGhC,OAAO,CAAC,eAAe,CAYP;gBAEa,MAAM,EAAE,cAAc;IAmDnD;;OAEG;IACH,aAAa,CAAC,OAAO,GAAE,oBAAyB,GAAG,eAAe,EAAE;IAoBpE;;;;OAIG;IACH,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,QAAQ;IAiBzC;;;;OAIG;IACH,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,cAAc,EAAE;IAoCxD;;;;OAIG;IACH,UAAU,CACR,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE,iBAAsB,GAC9B,oBAAoB,EAAE;IAqBzB;;;;OAIG;IACH,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,aAAa;IAKnD;;;;OAIG;IACH,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,oBAAoB,GAAG,QAAQ;IAyB3E;;;OAGG;IACH,OAAO,CAAC,kBAAkB;IAuD1B;;;;;;OAMG;IACH,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAKpC;;;;;;;;OAQG;IACH,wBAAwB,CAAC,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI;IAmCvE;;;;;;;OAOG;IACH,SAAS,CACP,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,oBAAoB,EAClC,WAAW,EAAE,MAAM,GAClB,cAAc;IA0EjB;;;;;;;;;;OAUG;IACH,gBAAgB,CACd,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EAAE,GAClB;QAAE,YAAY,EAAE,MAAM,CAAA;KAAE;CAoD5B"}