@lhremote/core 0.7.0 → 0.8.0

package/dist/db/index.d.ts

@@ -1,5 +1,5 @@
 export { DatabaseClient, type DatabaseClientOptions } from "./client.js";
 export { discoverAllDatabases, discoverDatabase } from "./discovery.js";
 export { ActionNotFoundError, CampaignNotFoundError, ChatNotFoundError, DatabaseError, DatabaseNotFoundError, ExcludeListNotFoundError, NoNextActionError, ProfileNotFoundError, } from "./errors.js";
-export { CampaignExcludeListRepository, CampaignRepository, CampaignStatisticsRepository, CollectionListRepository, type CollectionSummary, MessageRepository, ProfileRepository, } from "./repositories/index.js";
+export { ActionBudgetRepository, CampaignExcludeListRepository, CampaignRepository, CampaignStatisticsRepository, CollectionListRepository, type CollectionSummary, MessageRepository, ProfileRepository, } from "./repositories/index.js";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/db/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,cAAc,EAAE,KAAK,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACzE,OAAO,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACxE,OAAO,EACL,mBAAmB,EACnB,qBAAqB,EACrB,iBAAiB,EACjB,aAAa,EACb,qBAAqB,EACrB,wBAAwB,EACxB,iBAAiB,EACjB,oBAAoB,GACrB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,6BAA6B,EAC7B,kBAAkB,EAClB,4BAA4B,EAC5B,wBAAwB,EACxB,KAAK,iBAAiB,EACtB,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,yBAAyB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/db/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,cAAc,EAAE,KAAK,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACzE,OAAO,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACxE,OAAO,EACL,mBAAmB,EACnB,qBAAqB,EACrB,iBAAiB,EACjB,aAAa,EACb,qBAAqB,EACrB,wBAAwB,EACxB,iBAAiB,EACjB,oBAAoB,GACrB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,sBAAsB,EACtB,6BAA6B,EAC7B,kBAAkB,EAClB,4BAA4B,EAC5B,wBAAwB,EACxB,KAAK,iBAAiB,EACtB,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,yBAAyB,CAAC"}

package/dist/db/index.js

@@ -3,5 +3,5 @@
 export { DatabaseClient } from "./client.js";
 export { discoverAllDatabases, discoverDatabase } from "./discovery.js";
 export { ActionNotFoundError, CampaignNotFoundError, ChatNotFoundError, DatabaseError, DatabaseNotFoundError, ExcludeListNotFoundError, NoNextActionError, ProfileNotFoundError, } from "./errors.js";
-export { CampaignExcludeListRepository, CampaignRepository, CampaignStatisticsRepository, CollectionListRepository, MessageRepository, ProfileRepository, } from "./repositories/index.js";
+export { ActionBudgetRepository, CampaignExcludeListRepository, CampaignRepository, CampaignStatisticsRepository, CollectionListRepository, MessageRepository, ProfileRepository, } from "./repositories/index.js";
 //# sourceMappingURL=index.js.map

package/dist/db/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/db/index.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,oCAAoC;AAEpC,OAAO,EAAE,cAAc,EAA8B,MAAM,aAAa,CAAC;AACzE,OAAO,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACxE,OAAO,EACL,mBAAmB,EACnB,qBAAqB,EACrB,iBAAiB,EACjB,aAAa,EACb,qBAAqB,EACrB,wBAAwB,EACxB,iBAAiB,EACjB,oBAAoB,GACrB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,6BAA6B,EAC7B,kBAAkB,EAClB,4BAA4B,EAC5B,wBAAwB,EAExB,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,yBAAyB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/db/index.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,oCAAoC;AAEpC,OAAO,EAAE,cAAc,EAA8B,MAAM,aAAa,CAAC;AACzE,OAAO,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACxE,OAAO,EACL,mBAAmB,EACnB,qBAAqB,EACrB,iBAAiB,EACjB,aAAa,EACb,qBAAqB,EACrB,wBAAwB,EACxB,iBAAiB,EACjB,oBAAoB,GACrB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,sBAAsB,EACtB,6BAA6B,EAC7B,kBAAkB,EAClB,4BAA4B,EAC5B,wBAAwB,EAExB,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,yBAAyB,CAAC"}

package/dist/db/repositories/action-budget.d.ts

@@ -0,0 +1,29 @@
+import type { ActionBudgetEntry, LimitType } from "../../types/index.js";
+import type { DatabaseClient } from "../client.js";
+/**
+ * Repository for reading LinkedHelper rate limit data.
+ *
+ * Reads from LH's `limit_types`, `daily_limits`, and `action_results`
+ * tables to compute the current action budget.
+ */
+export declare class ActionBudgetRepository {
+    private readonly stmtLimitTypes;
+    private readonly stmtDailyLimits;
+    private readonly stmtTodayCountsByType;
+    constructor(client: DatabaseClient);
+    /**
+     * Get all limit types defined by LinkedHelper.
+     */
+    getLimitTypes(): LimitType[];
+    /**
+     * Get the full action budget: limit types, daily limits, and today's usage.
+     *
+     * Campaign usage comes from LH's `action_results` table.
+     * Direct usage (CDP-direct actions like comments/reactions) is accepted
+     * as a parameter since it is tracked externally.
+     *
+     * @param directCounts  Map of limit type ID → count of CDP-direct actions today.
+     */
+    getActionBudget(directCounts?: ReadonlyMap<number, number>): ActionBudgetEntry[];
+}
+//# sourceMappingURL=action-budget.d.ts.map

package/dist/db/repositories/action-budget.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"action-budget.d.ts","sourceRoot":"","sources":["../../../src/db/repositories/action-budget.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACzE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAwCnD;;;;;GAKG;AACH,qBAAa,sBAAsB;IACjC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC;IAChC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAC;IACjC,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAAC;gBAE3B,MAAM,EAAE,cAAc;IAqBlC;;OAEG;IACH,aAAa,IAAI,SAAS,EAAE;IAK5B;;;;;;;;OAQG;IACH,eAAe,CACb,YAAY,GAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAa,GACpD,iBAAiB,EAAE;CAyCvB"}

package/dist/db/repositories/action-budget.js

@@ -0,0 +1,100 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+/**
+ * Maps LinkedHelper action config types to their corresponding limit type IDs.
+ *
+ * These IDs match the `limit_types` table in the LH database.
+ * Action types that do not consume daily limits (e.g. Waiter,
+ * FilterContactsOutOfMyNetwork) are intentionally omitted.
+ */
+const ACTION_TYPE_TO_LIMIT_TYPE = new Map([
+    ["SaveCurrentProfile", 1],
+    ["InvitePerson", 8],
+    ["SendMessage", 9],
+    ["MessageToEventAttendees", 10],
+    ["SendInMail", 11],
+    ["EndorseSkills", 12],
+    ["InviteToGroup", 13],
+    ["Follow", 16],
+    ["Unfollow", 17],
+    ["LikePost", 18],
+    ["SendPersonToWebhook", 23],
+    ["GetEmailFromPAS", 24],
+    ["SendPersonToExternalCRM", 31],
+]);
+/**
+ * Repository for reading LinkedHelper rate limit data.
+ *
+ * Reads from LH's `limit_types`, `daily_limits`, and `action_results`
+ * tables to compute the current action budget.
+ */
+export class ActionBudgetRepository {
+    stmtLimitTypes;
+    stmtDailyLimits;
+    stmtTodayCountsByType;
+    constructor(client) {
+        const { db } = client;
+        this.stmtLimitTypes = db.prepare(`SELECT id, type FROM limit_types ORDER BY id`);
+        this.stmtDailyLimits = db.prepare(`SELECT id, max_limit FROM daily_limits`);
+        this.stmtTodayCountsByType = db.prepare(`SELECT ac.actionType AS action_type, COUNT(*) AS count_today
+       FROM action_results ar
+       JOIN action_versions av ON ar.action_version_id = av.id
+       JOIN action_configs ac ON av.config_id = ac.id
+       WHERE date(ar.created_at) = date('now', 'localtime')
+       GROUP BY ac.actionType`);
+    }
+    /**
+     * Get all limit types defined by LinkedHelper.
+     */
+    getLimitTypes() {
+        const rows = this.stmtLimitTypes.all();
+        return rows.map((r) => ({ id: r.id, type: r.type }));
+    }
+    /**
+     * Get the full action budget: limit types, daily limits, and today's usage.
+     *
+     * Campaign usage comes from LH's `action_results` table.
+     * Direct usage (CDP-direct actions like comments/reactions) is accepted
+     * as a parameter since it is tracked externally.
+     *
+     * @param directCounts  Map of limit type ID → count of CDP-direct actions today.
+     */
+    getActionBudget(directCounts = new Map()) {
+        const limitTypes = this.stmtLimitTypes.all();
+        const dailyLimits = this.stmtDailyLimits.all();
+        const todayCounts = this.stmtTodayCountsByType.all();
+        // Build daily limit lookup: limit_type_id → max_limit
+        const limitMap = new Map();
+        for (const dl of dailyLimits) {
+            limitMap.set(dl.id, dl.max_limit);
+        }
+        // Build campaign usage lookup: limit_type_id → count
+        const campaignUsageMap = new Map();
+        for (const row of todayCounts) {
+            const limitTypeId = ACTION_TYPE_TO_LIMIT_TYPE.get(row.action_type);
+            if (limitTypeId !== undefined) {
+                const existing = campaignUsageMap.get(limitTypeId) ?? 0;
+                campaignUsageMap.set(limitTypeId, existing + row.count_today);
+            }
+        }
+        return limitTypes.map((lt) => {
+            const dailyLimit = limitMap.get(lt.id) ?? null;
+            const campaignUsed = campaignUsageMap.get(lt.id) ?? 0;
+            const directUsed = directCounts.get(lt.id) ?? 0;
+            const totalUsed = campaignUsed + directUsed;
+            const remaining = dailyLimit !== null
+                ? Math.max(0, dailyLimit - totalUsed)
+                : null;
+            return {
+                limitTypeId: lt.id,
+                limitType: lt.type,
+                dailyLimit,
+                campaignUsed,
+                directUsed,
+                totalUsed,
+                remaining,
+            };
+        });
+    }
+}
+//# sourceMappingURL=action-budget.js.map

package/dist/db/repositories/action-budget.js.map

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

package/dist/db/repositories/action-budget.test.d.ts

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

package/dist/db/repositories/action-budget.test.d.ts.map

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

package/dist/db/repositories/action-budget.test.js

@@ -0,0 +1,181 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+import { DatabaseSync } from "node:sqlite";
+import { afterEach, beforeEach, describe, expect, it } from "vitest";
+import { ActionBudgetRepository } from "./action-budget.js";
+function createBudgetDb() {
+    const db = new DatabaseSync(":memory:");
+    db.exec(`
+    CREATE TABLE limit_types (
+      id INTEGER PRIMARY KEY,
+      type TEXT NOT NULL
+    )
+  `);
+    db.exec(`
+    INSERT INTO limit_types (id, type) VALUES
+      (8, 'Invite'),
+      (9, 'Message'),
+      (16, 'Follow'),
+      (18, 'PostLike')
+  `);
+    db.exec(`
+    CREATE TABLE daily_limits (
+      id INTEGER PRIMARY KEY,
+      max_limit INTEGER NOT NULL
+    )
+  `);
+    db.exec(`
+    INSERT INTO daily_limits (id, max_limit) VALUES
+      (8, 100),
+      (16, 150)
+  `);
+    db.exec(`
+    CREATE TABLE action_configs (
+      id INTEGER PRIMARY KEY,
+      actionType TEXT NOT NULL
+    )
+  `);
+    db.exec(`INSERT INTO action_configs (id, actionType) VALUES (1, 'InvitePerson')`);
+    db.exec(`INSERT INTO action_configs (id, actionType) VALUES (2, 'Follow')`);
+    db.exec(`
+    CREATE TABLE action_versions (
+      id INTEGER PRIMARY KEY,
+      action_id INTEGER NOT NULL,
+      config_id INTEGER NOT NULL
+    )
+  `);
+    db.exec(`INSERT INTO action_versions (id, action_id, config_id) VALUES (1, 1, 1)`);
+    db.exec(`INSERT INTO action_versions (id, action_id, config_id) VALUES (2, 2, 2)`);
+    db.exec(`
+    CREATE TABLE action_results (
+      id INTEGER PRIMARY KEY,
+      action_version_id INTEGER NOT NULL,
+      person_id INTEGER NOT NULL,
+      result INTEGER NOT NULL DEFAULT 0,
+      created_at DATETIME NOT NULL
+    )
+  `);
+    // Insert today's results
+    const today = new Date().toISOString().split("T")[0] ?? "";
+    db.exec(`
+    INSERT INTO action_results (action_version_id, person_id, result, created_at)
+    VALUES
+      (1, 100, 1, '${today} 10:00:00'),
+      (1, 101, 1, '${today} 10:05:00'),
+      (1, 102, -1, '${today} 10:10:00'),
+      (2, 200, 1, '${today} 11:00:00')
+  `);
+    // Insert yesterday's results (should NOT be counted)
+    const yesterday = new Date(Date.now() - 86_400_000).toISOString().split("T")[0] ?? "";
+    db.exec(`
+    INSERT INTO action_results (action_version_id, person_id, result, created_at)
+    VALUES
+      (1, 103, 1, '${yesterday} 10:00:00'),
+      (2, 201, 1, '${yesterday} 11:00:00')
+  `);
+    return db;
+}
+describe("ActionBudgetRepository", () => {
+    let db;
+    let repo;
+    beforeEach(() => {
+        db = createBudgetDb();
+        repo = new ActionBudgetRepository({ db });
+    });
+    afterEach(() => {
+        db.close();
+    });
+    describe("getLimitTypes", () => {
+        it("returns all limit types ordered by ID", () => {
+            const types = repo.getLimitTypes();
+            expect(types).toEqual([
+                { id: 8, type: "Invite" },
+                { id: 9, type: "Message" },
+                { id: 16, type: "Follow" },
+                { id: 18, type: "PostLike" },
+            ]);
+        });
+    });
+    describe("getActionBudget", () => {
+        it("combines limit types, daily limits, and today's usage", () => {
+            const entries = repo.getActionBudget();
+            // Invite: limit 100, 3 today (2 success + 1 fail — all results counted)
+            const invite = entries.find((e) => e.limitType === "Invite");
+            expect(invite).toEqual({
+                limitTypeId: 8,
+                limitType: "Invite",
+                dailyLimit: 100,
+                campaignUsed: 3,
+                directUsed: 0,
+                totalUsed: 3,
+                remaining: 97,
+            });
+            // Follow: limit 150, 1 today
+            const follow = entries.find((e) => e.limitType === "Follow");
+            expect(follow).toEqual({
+                limitTypeId: 16,
+                limitType: "Follow",
+                dailyLimit: 150,
+                campaignUsed: 1,
+                directUsed: 0,
+                totalUsed: 1,
+                remaining: 149,
+            });
+            // Message: no daily limit configured, 0 used
+            const message = entries.find((e) => e.limitType === "Message");
+            expect(message).toEqual({
+                limitTypeId: 9,
+                limitType: "Message",
+                dailyLimit: null,
+                campaignUsed: 0,
+                directUsed: 0,
+                totalUsed: 0,
+                remaining: null,
+            });
+        });
+        it("includes direct counts in budget", () => {
+            const directCounts = new Map([[18, 5]]);
+            const entries = repo.getActionBudget(directCounts);
+            const postLike = entries.find((e) => e.limitType === "PostLike");
+            expect(postLike).toEqual({
+                limitTypeId: 18,
+                limitType: "PostLike",
+                dailyLimit: null,
+                campaignUsed: 0,
+                directUsed: 5,
+                totalUsed: 5,
+                remaining: null,
+            });
+        });
+        it("clamps remaining to zero when over limit", () => {
+            const directCounts = new Map([[8, 200]]);
+            const entries = repo.getActionBudget(directCounts);
+            const invite = entries.find((e) => e.limitType === "Invite");
+            expect(invite?.remaining).toBe(0);
+            expect(invite?.totalUsed).toBe(203); // 3 campaign + 200 direct
+        });
+        it("returns empty entries when no limit types exist", () => {
+            const emptyDb = new DatabaseSync(":memory:");
+            emptyDb.exec(`CREATE TABLE limit_types (id INTEGER PRIMARY KEY, type TEXT NOT NULL)`);
+            emptyDb.exec(`CREATE TABLE daily_limits (id INTEGER PRIMARY KEY, max_limit INTEGER NOT NULL)`);
+            emptyDb.exec(`
+        CREATE TABLE action_results (
+          id INTEGER PRIMARY KEY, action_version_id INTEGER NOT NULL,
+          person_id INTEGER NOT NULL, result INTEGER NOT NULL DEFAULT 0,
+          created_at DATETIME NOT NULL
+        )
+      `);
+            emptyDb.exec(`
+        CREATE TABLE action_versions (
+          id INTEGER PRIMARY KEY, action_id INTEGER NOT NULL, config_id INTEGER NOT NULL
+        )
+      `);
+            emptyDb.exec(`CREATE TABLE action_configs (id INTEGER PRIMARY KEY, actionType TEXT NOT NULL)`);
+            const emptyRepo = new ActionBudgetRepository({ db: emptyDb });
+            const entries = emptyRepo.getActionBudget();
+            expect(entries).toEqual([]);
+            emptyDb.close();
+        });
+    });
+});
+//# sourceMappingURL=action-budget.test.js.map

package/dist/db/repositories/action-budget.test.js.map

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

package/dist/db/repositories/campaign-hard-delete.integration.test.d.ts

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

package/dist/db/repositories/campaign-hard-delete.integration.test.d.ts.map

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

package/dist/db/repositories/campaign-hard-delete.integration.test.js

@@ -0,0 +1,78 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+import { afterAll, beforeAll, describe, expect, it } from "vitest";
+import { DatabaseClient } from "../client.js";
+import { openFixture } from "../testing/open-fixture.js";
+import { CampaignRepository } from "./campaign.js";
+import { CampaignNotFoundError } from "../errors.js";
+describe("CampaignRepository.deleteCampaign (integration)", () => {
+    let rawDb;
+    let client;
+    let repo;
+    beforeAll(() => {
+        // Use openFixture() for an isolated writable copy
+        rawDb = openFixture();
+        // Ensure SQLite enforces foreign key constraints so delete order is validated
+        rawDb.exec("PRAGMA foreign_keys = ON");
+        const fkPragma = rawDb
+            .prepare("PRAGMA foreign_keys")
+            .get();
+        expect(fkPragma.foreign_keys).toBe(1);
+        // Pause campaign 1 so it can be hard-deleted
+        // (fixture has it as active: is_paused=0, is_archived=0, is_valid=1)
+        rawDb.exec("UPDATE campaigns SET is_paused = 1 WHERE id = 1");
+        // Wrap the raw DatabaseSync in a DatabaseClient for the repo
+        client = { db: rawDb, close: () => rawDb.close() };
+        repo = new CampaignRepository(client);
+    });
+    afterAll(() => {
+        rawDb.close();
+    });
+    function countRows(table, where, params) {
+        const row = rawDb.prepare(`SELECT COUNT(*) AS cnt FROM ${table} WHERE ${where}`).get(...params);
+        return row.cnt;
+    }
+    it("removes campaign 1 and all related rows", () => {
+        // Pre-conditions: campaign 1 has data in all related tables
+        expect(countRows("campaigns", "id = ?", [1])).toBe(1);
+        expect(countRows("actions", "campaign_id = ?", [1])).toBeGreaterThan(0);
+        expect(countRows("action_versions", "action_id IN (SELECT id FROM actions WHERE campaign_id = ?)", [1])).toBeGreaterThan(0);
+        expect(countRows("action_configs", "id IN (SELECT DISTINCT av.config_id FROM action_versions av JOIN actions a ON av.action_id = a.id WHERE a.campaign_id = ?)", [1])).toBeGreaterThan(0);
+        expect(countRows("action_target_people", "action_id IN (SELECT id FROM actions WHERE campaign_id = ?)", [1])).toBeGreaterThan(0);
+        expect(countRows("action_results", "action_version_id IN (SELECT av.id FROM action_versions av JOIN actions a ON av.action_id = a.id WHERE a.campaign_id = ?)", [1])).toBeGreaterThan(0);
+        expect(countRows("person_in_campaigns_history", "campaign_id = ?", [1])).toBeGreaterThan(0);
+        expect(countRows("campaign_versions", "campaign_id = ?", [1])).toBeGreaterThan(0);
+        // Exclude list chain pre-conditions
+        const excludeListCount = countRows("collection_people_versions", "id IN (SELECT av.exclude_list_id FROM action_versions av JOIN actions a ON av.action_id = a.id WHERE a.campaign_id = ? AND av.exclude_list_id IS NOT NULL UNION SELECT cv.exclude_list_id FROM campaign_versions cv WHERE cv.campaign_id = ? AND cv.exclude_list_id IS NOT NULL)", [1, 1]);
+        expect(excludeListCount).toBeGreaterThan(0);
+        // Perform the hard delete (with FK constraints enforced)
+        repo.deleteCampaign(1);
+        // Post-conditions: all related rows are gone
+        expect(countRows("campaigns", "id = ?", [1])).toBe(0);
+        expect(countRows("actions", "campaign_id = ?", [1])).toBe(0);
+        expect(countRows("action_versions", "action_id IN (SELECT id FROM actions WHERE campaign_id = ?)", [1])).toBe(0);
+        expect(countRows("action_target_people", "action_id IN (SELECT id FROM actions WHERE campaign_id = ?)", [1])).toBe(0);
+        expect(countRows("action_results", "action_version_id IN (SELECT av.id FROM action_versions av JOIN actions a ON av.action_id = a.id WHERE a.campaign_id = ?)", [1])).toBe(0);
+        expect(countRows("action_result_flags", "action_result_id IN (SELECT ar.id FROM action_results ar JOIN action_versions av ON ar.action_version_id = av.id JOIN actions a ON av.action_id = a.id WHERE a.campaign_id = ?)", [1])).toBe(0);
+        expect(countRows("action_result_messages", "action_result_id IN (SELECT ar.id FROM action_results ar JOIN action_versions av ON ar.action_version_id = av.id JOIN actions a ON av.action_id = a.id WHERE a.campaign_id = ?)", [1])).toBe(0);
+        expect(countRows("person_in_campaigns_history", "campaign_id = ?", [1])).toBe(0);
+        expect(countRows("campaign_versions", "campaign_id = ?", [1])).toBe(0);
+        // Verify action_configs for campaign 1 are deleted
+        // (config ID 1 belonged to campaign 1's action)
+        expect(countRows("action_configs", "id = ?", [1])).toBe(0);
+        // Verify exclude list chain is cleaned up
+        expect(countRows("collection_people_versions", "id IN (1, 2)", [])).toBe(0);
+        expect(countRows("collections", "id IN (1, 2)", [])).toBe(0);
+    });
+    it("throws CampaignNotFoundError for non-existent campaign", () => {
+        expect(() => repo.deleteCampaign(9999)).toThrow(CampaignNotFoundError);
+    });
+    it("does not affect other campaigns", () => {
+        // Campaign 2 should still exist after deleting campaign 1
+        expect(countRows("campaigns", "id = ?", [2])).toBe(1);
+        expect(countRows("actions", "campaign_id = ?", [2])).toBeGreaterThan(0);
+        expect(countRows("action_versions", "action_id IN (SELECT id FROM actions WHERE campaign_id = ?)", [2])).toBeGreaterThan(0);
+        expect(countRows("action_configs", "id = ?", [2])).toBe(1);
+    });
+});
+//# sourceMappingURL=campaign-hard-delete.integration.test.js.map

package/dist/db/repositories/campaign-hard-delete.integration.test.js.map

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

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

@@ -63,6 +63,20 @@ export declare class CampaignRepository {
      * @throws {CampaignNotFoundError} if no campaign exists with the given ID.
      */
     updateCampaign(campaignId: number, updates: CampaignUpdateConfig): Campaign;
+    /**
+     * Hard-delete a campaign and all related rows from the database.
+     *
+     * Removes all data across: action_result_flags, action_result_messages,
+     * action_results, action_target_people, person_in_campaigns_history,
+     * campaign_versions, action_versions, actions, action_configs,
+     * and the exclude list chain (collection_people, collection_people_versions,
+     * collections).
+     *
+     * Callers must verify the campaign is not active before calling this method.
+     *
+     * @throws {CampaignNotFoundError} if no campaign exists with the given ID.
+     */
+    deleteCampaign(campaignId: number): void;
     /**
      * Prepare write statements lazily (only when needed).
      * This avoids issues when the client is opened in read-only mode.

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

@@ -1 +1 @@
-{"version":3,"file":"campaign.d.ts","sourceRoot":"","sources":["../../../src/db/repositories/campaign.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAGV,oBAAoB,EACpB,oBAAoB,EACpB,0BAA0B,EAC1B,QAAQ,EACR,cAAc,EACd,mBAAmB,EAEnB,aAAa,EACb,eAAe,EACf,oBAAoB,EACpB,iBAAiB,EACjB,yBAAyB,EACzB,oBAAoB,EACrB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAuFnD;;;;;;;;;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;IAuDnD;;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;IA+BzB;;;;;OAKG;IACH,UAAU,CACR,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE,yBAA8B,GACtC;QAAE,MAAM,EAAE,mBAAmB,EAAE,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE;IAsEnD;;;;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;;;;;;;;OAQG;IACH,YAAY,CACV,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,0BAA0B,GAClC,cAAc;IAuEjB;;;;;;;;;;OAUG;IACH,gBAAgB,CACd,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EAAE,GAClB;QAAE,YAAY,EAAE,MAAM,CAAA;KAAE;CAoD5B"}
+{"version":3,"file":"campaign.d.ts","sourceRoot":"","sources":["../../../src/db/repositories/campaign.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAGV,oBAAoB,EACpB,oBAAoB,EACpB,0BAA0B,EAC1B,QAAQ,EACR,cAAc,EACd,mBAAmB,EAEnB,aAAa,EACb,eAAe,EACf,oBAAoB,EACpB,iBAAiB,EACjB,yBAAyB,EACzB,oBAAoB,EACrB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAuFnD;;;;;;;;;GASG;AACH,qBAAa,kBAAkB;IAqCjB,OAAO,CAAC,QAAQ,CAAC,MAAM;IApCnC,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,CA2BP;gBAEa,MAAM,EAAE,cAAc;IAuDnD;;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;IA+BzB;;;;;OAKG;IACH,UAAU,CACR,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE,yBAA8B,GACtC;QAAE,MAAM,EAAE,mBAAmB,EAAE,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE;IAsEnD;;;;OAIG;IACH,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,aAAa;IAKnD;;;;OAIG;IACH,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,oBAAoB,GAAG,QAAQ;IAyB3E;;;;;;;;;;;;OAYG;IACH,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAoExC;;;OAGG;IACH,OAAO,CAAC,kBAAkB;IAmJ1B;;;;;;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;;;;;;;;OAQG;IACH,YAAY,CACV,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,0BAA0B,GAClC,cAAc;IAuEjB;;;;;;;;;;OAUG;IACH,gBAAgB,CACd,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EAAE,GAClB;QAAE,YAAY,EAAE,MAAM,CAAA;KAAE;CAoD5B"}

package/dist/db/repositories/campaign.js

@@ -278,6 +278,69 @@ export class CampaignRepository {
         }
         return this.getCampaign(campaignId);
     }
+    /**
+     * Hard-delete a campaign and all related rows from the database.
+     *
+     * Removes all data across: action_result_flags, action_result_messages,
+     * action_results, action_target_people, person_in_campaigns_history,
+     * campaign_versions, action_versions, actions, action_configs,
+     * and the exclude list chain (collection_people, collection_people_versions,
+     * collections).
+     *
+     * Callers must verify the campaign is not active before calling this method.
+     *
+     * @throws {CampaignNotFoundError} if no campaign exists with the given ID.
+     */
+    deleteCampaign(campaignId) {
+        // Verify campaign exists
+        this.getCampaign(campaignId);
+        const stmts = this.getWriteStatements();
+        const { db } = this.client;
+        // Collect IDs needed after FK-referencing rows are deleted
+        const configRows = stmts.selectConfigIds.all(campaignId);
+        const configIds = configRows.map((r) => r.config_id);
+        const excludeRows = stmts.selectExcludeListInfo.all(campaignId, campaignId);
+        const excludeVersionIds = excludeRows.map((r) => r.version_id);
+        const excludeCollectionIds = [...new Set(excludeRows.map((r) => r.collection_id))];
+        db.exec("BEGIN");
+        try {
+            // 1. Delete result children (FK: action_result_flags/messages → action_results)
+            stmts.deleteResultFlagsByCampaign.run(campaignId);
+            stmts.deleteResultMessagesByCampaign.run(campaignId);
+            // 2. Delete results (FK: action_results → action_versions)
+            stmts.deleteResultsByCampaign.run(campaignId);
+            // 3. Delete target people (FK: action_target_people → actions)
+            stmts.deleteTargetPeopleByCampaign.run(campaignId);
+            // 4. Delete campaign history
+            stmts.deleteCampaignHistory.run(campaignId);
+            // 5. Delete collection_people for exclude lists
+            stmts.deleteCollectionPeopleByCampaign.run(campaignId, campaignId);
+            // 6. Delete campaign_versions (FK → campaigns)
+            stmts.deleteCampaignVersions.run(campaignId);
+            // 7. Delete action_versions (FK → actions)
+            stmts.deleteActionVersionsByCampaign.run(campaignId);
+            // 8. Delete actions (FK → campaigns)
+            stmts.deleteActionsByCampaign.run(campaignId);
+            // 9. Delete action_configs (collected before transaction)
+            for (const configId of configIds) {
+                stmts.deleteActionConfig.run(configId);
+            }
+            // 10. Delete exclude list versions and collections
+            for (const versionId of excludeVersionIds) {
+                stmts.deleteCollectionPeopleVersion.run(versionId);
+            }
+            for (const collectionId of excludeCollectionIds) {
+                stmts.deleteCollection.run(collectionId);
+            }
+            // 11. Delete the campaign itself
+            stmts.deleteCampaign.run(campaignId);
+            db.exec("COMMIT");
+        }
+        catch (e) {
+            db.exec("ROLLBACK");
+            throw e;
+        }
+    }
     /**
      * Prepare write statements lazily (only when needed).
      * This avoids issues when the client is opened in read-only mode.
@@ -309,6 +372,68 @@ export class CampaignRepository {
          VALUES (?, ?, ?, 1, ?, STRFTIME('%Y-%m-%dT%H:%M:%fZ', 'NOW'))`),
             countTarget: db.prepare(`SELECT COUNT(*) AS cnt FROM action_target_people
          WHERE action_id = ? AND person_id = ?`),
+            deleteResultFlagsByCampaign: db.prepare(`DELETE FROM action_result_flags
+         WHERE action_result_id IN (
+           SELECT ar.id FROM action_results ar
+           JOIN action_versions av ON ar.action_version_id = av.id
+           JOIN actions a ON av.action_id = a.id
+           WHERE a.campaign_id = ?
+         )`),
+            deleteResultMessagesByCampaign: db.prepare(`DELETE FROM action_result_messages
+         WHERE action_result_id IN (
+           SELECT ar.id FROM action_results ar
+           JOIN action_versions av ON ar.action_version_id = av.id
+           JOIN actions a ON av.action_id = a.id
+           WHERE a.campaign_id = ?
+         )`),
+            deleteResultsByCampaign: db.prepare(`DELETE FROM action_results
+         WHERE action_version_id IN (
+           SELECT av.id FROM action_versions av
+           JOIN actions a ON av.action_id = a.id
+           WHERE a.campaign_id = ?
+         )`),
+            deleteTargetPeopleByCampaign: db.prepare(`DELETE FROM action_target_people
+         WHERE action_id IN (
+           SELECT id FROM actions WHERE campaign_id = ?
+         )`),
+            deleteCampaignHistory: db.prepare(`DELETE FROM person_in_campaigns_history
+         WHERE campaign_id = ?`),
+            deleteCollectionPeopleByCampaign: db.prepare(`DELETE FROM collection_people
+         WHERE collection_id IN (
+           SELECT cpv.collection_id FROM collection_people_versions cpv
+           WHERE cpv.id IN (
+             SELECT av.exclude_list_id FROM action_versions av
+             JOIN actions a ON av.action_id = a.id
+             WHERE a.campaign_id = ? AND av.exclude_list_id IS NOT NULL
+             UNION
+             SELECT cv.exclude_list_id FROM campaign_versions cv
+             WHERE cv.campaign_id = ? AND cv.exclude_list_id IS NOT NULL
+           )
+         )`),
+            deleteCampaignVersions: db.prepare(`DELETE FROM campaign_versions WHERE campaign_id = ?`),
+            selectExcludeListInfo: db.prepare(`SELECT cpv.id AS version_id, cpv.collection_id
+         FROM collection_people_versions cpv
+         WHERE cpv.id IN (
+           SELECT av.exclude_list_id FROM action_versions av
+           JOIN actions a ON av.action_id = a.id
+           WHERE a.campaign_id = ? AND av.exclude_list_id IS NOT NULL
+           UNION
+           SELECT cv.exclude_list_id FROM campaign_versions cv
+           WHERE cv.campaign_id = ? AND cv.exclude_list_id IS NOT NULL
+         )`),
+            deleteActionVersionsByCampaign: db.prepare(`DELETE FROM action_versions
+         WHERE action_id IN (
+           SELECT id FROM actions WHERE campaign_id = ?
+         )`),
+            selectConfigIds: db.prepare(`SELECT DISTINCT av.config_id
+         FROM action_versions av
+         JOIN actions a ON av.action_id = a.id
+         WHERE a.campaign_id = ?`),
+            deleteActionsByCampaign: db.prepare(`DELETE FROM actions WHERE campaign_id = ?`),
+            deleteActionConfig: db.prepare(`DELETE FROM action_configs WHERE id = ?`),
+            deleteCollectionPeopleVersion: db.prepare(`DELETE FROM collection_people_versions WHERE id = ?`),
+            deleteCollection: db.prepare(`DELETE FROM collections WHERE id = ?`),
+            deleteCampaign: db.prepare(`DELETE FROM campaigns WHERE id = ?`),
         };
         return this.writeStatements;
     }