@lhremote/core 0.7.0 → 0.8.0

package/dist/services/ephemeral-campaign.js

@@ -0,0 +1,210 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+import { ProfileRepository } from "../db/index.js";
+import { delay } from "../utils/delay.js";
+import { CampaignService } from "./campaign.js";
+import { CampaignExecutionError, CampaignTimeoutError } from "./errors.js";
+/** Default timeout for ephemeral action execution (5 minutes). */
+const DEFAULT_TIMEOUT = 300_000;
+/** Default interval between status polls (2 seconds). */
+const DEFAULT_POLL_INTERVAL = 2_000;
+/** Prefix for ephemeral campaign names. */
+const CAMPAIGN_NAME_PREFIX = "[ephemeral]";
+/**
+ * Executes a single LinkedHelper action on a single person without
+ * manual campaign setup.
+ *
+ * Creates a temporary campaign, adds the requested action, imports the
+ * target person, starts the campaign runner, polls for completion,
+ * extracts the result, then hard-deletes the campaign (or archives it
+ * if `keepCampaign: true`).
+ */
+export class EphemeralCampaignService {
+    campaignService;
+    profileRepo;
+    constructor(instance, db) {
+        this.campaignService = new CampaignService(instance, db);
+        this.profileRepo = new ProfileRepository(db);
+    }
+    /**
+     * Execute a single action on a single person using a temporary campaign.
+     *
+     * @param actionType - Action type identifier (e.g., 'MessageToPerson', 'InvitePerson').
+     * @param target - Person ID (number) or LinkedIn profile URL (string).
+     * @param actionSettings - Action-specific settings (e.g., message template).
+     * @param options - Execution options (timeout, keepCampaign, etc.).
+     * @returns Action result with success status, person ID, and action results.
+     *
+     * @throws {CampaignExecutionError} if the target cannot be resolved, import fails,
+     *   or the campaign cannot be started.
+     * @throws {CampaignTimeoutError} if the action does not complete within the timeout.
+     */
+    async execute(actionType, target, actionSettings, options) {
+        const timeout = options?.timeout ?? DEFAULT_TIMEOUT;
+        const pollInterval = options?.pollInterval ?? DEFAULT_POLL_INTERVAL;
+        const keepCampaign = options?.keepCampaign ?? false;
+        // Step 1: Resolve target to LinkedIn URL and person ID (if known)
+        const resolved = this.resolveTarget(target);
+        // Step 2: Create temporary campaign
+        const campaign = await this.campaignService.create({
+            name: `${CAMPAIGN_NAME_PREFIX} ${actionType} ${new Date().toISOString()}`,
+            actions: [
+                {
+                    name: actionType,
+                    actionType,
+                    ...(actionSettings !== undefined && { actionSettings }),
+                    coolDown: 0,
+                    maxActionResultsPerIteration: 1,
+                },
+            ],
+        });
+        try {
+            // Step 3: Import target person
+            const importResult = await this.campaignService.importPeopleFromUrls(campaign.id, [resolved.linkedInUrl]);
+            if (importResult.successful === 0 && importResult.alreadyInQueue === 0 && importResult.alreadyProcessed === 0) {
+                throw new CampaignExecutionError(`Failed to import target into campaign: ${resolved.linkedInUrl}`, campaign.id);
+            }
+            // Resolve person ID if not yet known (URL-based target)
+            const personId = resolved.personId ?? this.resolvePersonIdFromUrl(resolved.linkedInUrl);
+            // Step 4: Start campaign
+            await this.campaignService.start(campaign.id, []);
+            // Step 5: Poll for completion
+            await this.pollForCompletion(campaign.id, timeout, pollInterval);
+            // Step 6: Get results
+            const runResult = await this.campaignService.getResults(campaign.id);
+            const results = runResult.results;
+            const success = results.some((r) => r.result > 0);
+            // Step 7: Cleanup
+            await this.cleanup(campaign.id, keepCampaign);
+            return {
+                success,
+                personId,
+                results,
+                ...(keepCampaign && { campaignId: campaign.id }),
+            };
+        }
+        catch (error) {
+            await this.cleanup(campaign.id, keepCampaign);
+            throw error;
+        }
+    }
+    /**
+     * Resolve a target (person ID or URL) to a LinkedIn URL and optional person ID.
+     */
+    resolveTarget(target) {
+        if (typeof target === "number") {
+            // Person ID → look up LinkedIn URL from profile
+            const profiles = this.profileRepo.findByIds([target]);
+            const profile = profiles[0];
+            if (!profile) {
+                throw new CampaignExecutionError(`Person ${String(target)} not found in database`);
+            }
+            const publicId = profile.externalIds.find((e) => e.typeGroup === "public");
+            if (!publicId) {
+                throw new CampaignExecutionError(`Person ${String(target)} has no LinkedIn public ID`);
+            }
+            return {
+                linkedInUrl: `https://www.linkedin.com/in/${publicId.externalId}`,
+                personId: target,
+            };
+        }
+        // String target → validate and normalize LinkedIn URL; person ID resolved after import
+        const slug = this.extractSlug(target);
+        return {
+            linkedInUrl: `https://www.linkedin.com/in/${slug}`,
+            personId: undefined,
+        };
+    }
+    /**
+     * Resolve person ID from a LinkedIn profile URL after import.
+     */
+    resolvePersonIdFromUrl(linkedInUrl) {
+        const slug = this.extractSlug(linkedInUrl);
+        try {
+            const profile = this.profileRepo.findByPublicId(slug);
+            return profile.id;
+        }
+        catch (cause) {
+            throw new CampaignExecutionError(`Could not resolve person ID for ${linkedInUrl} after import`, undefined, { cause: cause instanceof Error ? cause : undefined });
+        }
+    }
+    /**
+     * Extract the LinkedIn public ID (slug) from a profile URL.
+     */
+    extractSlug(url) {
+        const match = /linkedin\.com\/in\/([^/?#]+)/.exec(url);
+        if (!match?.[1]) {
+            throw new CampaignExecutionError(`Invalid LinkedIn profile URL: ${url}`);
+        }
+        return match[1];
+    }
+    /**
+     * Poll campaign status until the target person's action completes or times out.
+     */
+    async pollForCompletion(campaignId, timeout, pollInterval) {
+        const deadline = Date.now() + timeout;
+        while (Date.now() < deadline) {
+            const status = await this.campaignService.getStatus(campaignId);
+            const counts = status.actionCounts[0];
+            // Action complete when at least one person is successful or failed
+            if (counts && (counts.successful > 0 || counts.failed > 0)) {
+                return;
+            }
+            // Runner returned to idle with no queued people — action is done
+            if (status.runnerState === "idle" && counts && counts.queued === 0) {
+                return;
+            }
+            const remaining = deadline - Date.now();
+            if (remaining <= 0)
+                break;
+            await delay(Math.min(pollInterval, remaining));
+        }
+        throw new CampaignTimeoutError(`Ephemeral action did not complete within ${String(timeout)}ms`, campaignId);
+    }
+    /**
+     * Stop and remove/archive an ephemeral campaign (best-effort).
+     */
+    async cleanup(campaignId, keepCampaign) {
+        await this.safeStop(campaignId);
+        if (keepCampaign) {
+            await this.safeArchive(campaignId);
+        }
+        else {
+            this.safeHardDelete(campaignId);
+        }
+    }
+    /**
+     * Stop campaign without throwing on failure.
+     */
+    async safeStop(campaignId) {
+        try {
+            await this.campaignService.stop(campaignId);
+        }
+        catch {
+            // Best-effort cleanup — campaign may already be stopped
+        }
+    }
+    /**
+     * Archive campaign without throwing on failure.
+     */
+    async safeArchive(campaignId) {
+        try {
+            await this.campaignService.delete(campaignId);
+        }
+        catch {
+            // Best-effort cleanup
+        }
+    }
+    /**
+     * Hard-delete campaign without throwing on failure.
+     */
+    safeHardDelete(campaignId) {
+        try {
+            this.campaignService.hardDelete(campaignId);
+        }
+        catch {
+            // Best-effort cleanup
+        }
+    }
+}
+//# sourceMappingURL=ephemeral-campaign.js.map

package/dist/services/ephemeral-campaign.js.map

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

package/dist/services/ephemeral-campaign.test.d.ts

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

package/dist/services/ephemeral-campaign.test.d.ts.map

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

package/dist/services/ephemeral-campaign.test.js

@@ -0,0 +1,333 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
+import { CampaignExecutionError, CampaignTimeoutError, } from "./errors.js";
+import { EphemeralCampaignService } from "./ephemeral-campaign.js";
+// Mock InstanceService
+const mockEvaluateUI = vi.fn();
+vi.mock("./instance.js", () => ({
+    InstanceService: vi.fn().mockImplementation(function () {
+        this.evaluateUI = mockEvaluateUI;
+    }),
+}));
+// Mock CampaignRepository (via db/index.js)
+const mockListCampaigns = vi.fn();
+const mockGetCampaign = vi.fn();
+const mockGetCampaignActions = vi.fn();
+const mockGetResults = vi.fn();
+const mockFixIsValid = vi.fn();
+const mockCreateActionExcludeLists = vi.fn();
+const mockDeleteCampaign = vi.fn();
+// Mock CampaignStatisticsRepository
+const mockResetForRerun = vi.fn();
+// Mock ProfileRepository
+const mockFindByIds = vi.fn();
+const mockFindByPublicId = vi.fn();
+vi.mock("../db/index.js", async (importOriginal) => {
+    const original = await importOriginal();
+    return {
+        CampaignRepository: vi.fn().mockImplementation(function () {
+            this.listCampaigns = mockListCampaigns;
+            this.getCampaign = mockGetCampaign;
+            this.getCampaignActions = mockGetCampaignActions;
+            this.getResults = mockGetResults;
+            this.fixIsValid = mockFixIsValid;
+            this.createActionExcludeLists = mockCreateActionExcludeLists;
+            this.deleteCampaign = mockDeleteCampaign;
+        }),
+        CampaignStatisticsRepository: vi.fn().mockImplementation(function () {
+            this.resetForRerun = mockResetForRerun;
+        }),
+        ProfileRepository: vi.fn().mockImplementation(function () {
+            this.findByIds = mockFindByIds;
+            this.findByPublicId = mockFindByPublicId;
+        }),
+        CampaignNotFoundError: original.CampaignNotFoundError,
+        ActionNotFoundError: original.ActionNotFoundError,
+        ProfileNotFoundError: original.ProfileNotFoundError,
+    };
+});
+import { InstanceService } from "./instance.js";
+const MOCK_CAMPAIGN = {
+    id: 99,
+    name: "[ephemeral] MessageToPerson",
+    description: null,
+    state: "paused",
+    liAccountId: 1,
+    isPaused: true,
+    isArchived: false,
+    isValid: true,
+    createdAt: "2025-01-15T00:00:00Z",
+};
+const MOCK_ACTIONS = [
+    {
+        id: 10,
+        campaignId: 99,
+        name: "MessageToPerson",
+        description: null,
+        config: {
+            id: 100,
+            actionType: "MessageToPerson",
+            actionSettings: { message: "Hello" },
+            coolDown: 0,
+            maxActionResultsPerIteration: 1,
+            isDraft: false,
+        },
+        versionId: 1000,
+    },
+];
+const MOCK_PROFILE = {
+    id: 42,
+    miniProfile: { firstName: "Ada", lastName: "Lovelace", headline: "Engineer", avatar: null },
+    externalIds: [
+        { externalId: "ada-lovelace", typeGroup: "public", isMemberId: false },
+        { externalId: "123456789", typeGroup: "member", isMemberId: true },
+    ],
+    currentPosition: null,
+    education: [],
+    skills: [],
+    emails: [],
+};
+const MOCK_RESULT = {
+    id: 1,
+    actionVersionId: 1000,
+    personId: 42,
+    result: 1,
+    platform: "LINKEDIN",
+    createdAt: "2025-01-15T12:00:00Z",
+    profile: { firstName: "Ada", lastName: "Lovelace", headline: "Engineer", company: null, title: null },
+};
+afterEach(() => {
+    vi.restoreAllMocks();
+});
+describe("EphemeralCampaignService", () => {
+    let service;
+    beforeEach(() => {
+        vi.useFakeTimers();
+        vi.clearAllMocks();
+        mockEvaluateUI.mockResolvedValue(undefined);
+        const instance = new InstanceService(9223);
+        service = new EphemeralCampaignService(instance, {});
+    });
+    afterEach(() => {
+        vi.useRealTimers();
+    });
+    /**
+     * Set up mocks for a successful execute() flow:
+     *   create → import → start (idle + unpause + runner) → poll (status) → results → stop → cleanup
+     */
+    function setupSuccessFlow() {
+        // create: CDP createCampaign returns campaign ID
+        mockEvaluateUI.mockResolvedValueOnce({ id: 99 });
+        mockGetCampaign.mockReturnValue(MOCK_CAMPAIGN);
+        mockGetCampaignActions.mockReturnValue(MOCK_ACTIONS);
+        // import: CDP importPeopleFromUrls
+        mockEvaluateUI.mockResolvedValueOnce({
+            total: { addToTarget: { successful: 1, alreadyInQueue: 0, alreadyProcessed: 0, failed: 0 } },
+        });
+        // start: waitForIdle (idle), unpause, start runner
+        mockEvaluateUI
+            .mockResolvedValueOnce("idle") // getRunnerState
+            .mockResolvedValueOnce(undefined) // unpause
+            .mockResolvedValueOnce(true); // start
+        // poll: getStatus (campaign + actions + runnerState + isPaused + actionCounts)
+        mockEvaluateUI
+            .mockResolvedValueOnce("idle") // runnerState
+            .mockResolvedValueOnce(false) // isPaused
+            .mockResolvedValueOnce({ queued: 0, processed: 0, successful: 1, failed: 0 }); // actionCounts
+        // results
+        mockGetResults.mockReturnValue([MOCK_RESULT]);
+        // stop: pause + stop runner
+        mockEvaluateUI
+            .mockResolvedValueOnce(undefined) // pause
+            .mockResolvedValueOnce(undefined); // stop runner
+        // hardDelete is sync (db only)
+    }
+    describe("execute with person ID target", () => {
+        it("executes full lifecycle: create → import → start → poll → results → cleanup", async () => {
+            mockFindByIds.mockReturnValue([MOCK_PROFILE]);
+            setupSuccessFlow();
+            const promise = service.execute("MessageToPerson", 42, { message: "Hello" });
+            await vi.advanceTimersByTimeAsync(10_000);
+            const result = await promise;
+            expect(result.success).toBe(true);
+            expect(result.personId).toBe(42);
+            expect(result.results).toEqual([MOCK_RESULT]);
+            expect(result.campaignId).toBeUndefined();
+        });
+        it("resolves LinkedIn URL from person profile", async () => {
+            mockFindByIds.mockReturnValue([MOCK_PROFILE]);
+            setupSuccessFlow();
+            const promise = service.execute("MessageToPerson", 42);
+            await vi.advanceTimersByTimeAsync(10_000);
+            await promise;
+            // import call should include the resolved LinkedIn URL
+            const importExpr = mockEvaluateUI.mock.calls[1]?.[0];
+            expect(importExpr).toContain("ada-lovelace");
+        });
+        it("throws CampaignExecutionError when person ID not found", async () => {
+            mockFindByIds.mockReturnValue([null]);
+            await expect(service.execute("MessageToPerson", 999)).rejects.toThrow(CampaignExecutionError);
+        });
+        it("throws CampaignExecutionError when person has no public ID", async () => {
+            mockFindByIds.mockReturnValue([{
+                    ...MOCK_PROFILE,
+                    externalIds: [{ externalId: "123", typeGroup: "member", isMemberId: true }],
+                }]);
+            await expect(service.execute("MessageToPerson", 42)).rejects.toThrow(CampaignExecutionError);
+        });
+    });
+    describe("execute with LinkedIn URL target", () => {
+        it("imports from URL and resolves person ID after import", async () => {
+            mockFindByPublicId.mockReturnValue(MOCK_PROFILE);
+            setupSuccessFlow();
+            const promise = service.execute("InvitePerson", "https://www.linkedin.com/in/ada-lovelace");
+            await vi.advanceTimersByTimeAsync(10_000);
+            const result = await promise;
+            expect(result.success).toBe(true);
+            expect(result.personId).toBe(42);
+            expect(mockFindByPublicId).toHaveBeenCalledWith("ada-lovelace");
+        });
+        it("throws CampaignExecutionError for invalid LinkedIn URL before campaign creation", async () => {
+            await expect(service.execute("InvitePerson", "https://example.com/not-linkedin")).rejects.toThrow(CampaignExecutionError);
+            // No CDP calls should have been made (validation fails before create)
+            expect(mockEvaluateUI).not.toHaveBeenCalled();
+        });
+    });
+    describe("import failure", () => {
+        it("throws CampaignExecutionError when import fails and cleans up", async () => {
+            mockFindByIds.mockReturnValue([MOCK_PROFILE]);
+            // create succeeds
+            mockEvaluateUI.mockResolvedValueOnce({ id: 99 });
+            mockGetCampaign.mockReturnValue(MOCK_CAMPAIGN);
+            mockGetCampaignActions.mockReturnValue(MOCK_ACTIONS);
+            // import returns zero successful
+            mockEvaluateUI.mockResolvedValueOnce({
+                total: { addToTarget: { successful: 0, alreadyInQueue: 0, alreadyProcessed: 0, failed: 1 } },
+            });
+            await expect(service.execute("MessageToPerson", 42)).rejects.toThrow(CampaignExecutionError);
+            // Verify cleanup happened (hardDelete is sync)
+            expect(mockDeleteCampaign).toHaveBeenCalledWith(99);
+        });
+    });
+    describe("timeout handling", () => {
+        it("throws CampaignTimeoutError when action does not complete", async () => {
+            mockFindByIds.mockReturnValue([MOCK_PROFILE]);
+            // create
+            mockEvaluateUI.mockResolvedValueOnce({ id: 99 });
+            mockGetCampaign.mockReturnValue(MOCK_CAMPAIGN);
+            mockGetCampaignActions.mockReturnValue(MOCK_ACTIONS);
+            // import
+            mockEvaluateUI.mockResolvedValueOnce({
+                total: { addToTarget: { successful: 1, alreadyInQueue: 0, alreadyProcessed: 0, failed: 0 } },
+            });
+            // start
+            mockEvaluateUI
+                .mockResolvedValueOnce("idle")
+                .mockResolvedValueOnce(undefined)
+                .mockResolvedValueOnce(true);
+            // poll: return type-correct shapes that keep the poll going (never completes)
+            // getStatus calls 3 CDP methods: runnerState, isPaused, actionCounts
+            let pollCall = 0;
+            mockEvaluateUI.mockImplementation(() => {
+                const phase = pollCall % 3;
+                pollCall++;
+                if (phase === 0)
+                    return Promise.resolve("campaigns");
+                if (phase === 1)
+                    return Promise.resolve(false);
+                return Promise.resolve({ queued: 1, processed: 0, successful: 0, failed: 0 });
+            });
+            const promise = service.execute("MessageToPerson", 42, undefined, { timeout: 5_000 });
+            const caughtPromise = promise.catch((e) => e);
+            await vi.advanceTimersByTimeAsync(10_000);
+            const error = await caughtPromise;
+            expect(error).toBeInstanceOf(CampaignTimeoutError);
+        });
+    });
+    describe("keepCampaign option", () => {
+        it("archives instead of hard-deleting when keepCampaign is true", async () => {
+            mockFindByIds.mockReturnValue([MOCK_PROFILE]);
+            setupSuccessFlow();
+            const promise = service.execute("MessageToPerson", 42, undefined, { keepCampaign: true });
+            await vi.advanceTimersByTimeAsync(10_000);
+            const result = await promise;
+            expect(result.campaignId).toBe(99);
+            // Should NOT hard-delete
+            expect(mockDeleteCampaign).not.toHaveBeenCalled();
+            // Archive is done via CDP (setCampaignArchivedStatus) — verify the call
+            const archiveCall = mockEvaluateUI.mock.calls.find((call) => call[0].includes("setCampaignArchivedStatus"));
+            expect(archiveCall).toBeDefined();
+        });
+    });
+    describe("failed action result", () => {
+        it("returns success=false when action result is negative", async () => {
+            mockFindByIds.mockReturnValue([MOCK_PROFILE]);
+            // create
+            mockEvaluateUI.mockResolvedValueOnce({ id: 99 });
+            mockGetCampaign.mockReturnValue(MOCK_CAMPAIGN);
+            mockGetCampaignActions.mockReturnValue(MOCK_ACTIONS);
+            // import
+            mockEvaluateUI.mockResolvedValueOnce({
+                total: { addToTarget: { successful: 1, alreadyInQueue: 0, alreadyProcessed: 0, failed: 0 } },
+            });
+            // start
+            mockEvaluateUI
+                .mockResolvedValueOnce("idle")
+                .mockResolvedValueOnce(undefined)
+                .mockResolvedValueOnce(true);
+            // poll: action failed
+            mockEvaluateUI
+                .mockResolvedValueOnce("idle")
+                .mockResolvedValueOnce(false)
+                .mockResolvedValueOnce({ queued: 0, processed: 0, successful: 0, failed: 1 });
+            // results
+            const failedResult = { ...MOCK_RESULT, result: -1 };
+            mockGetResults.mockReturnValue([failedResult]);
+            // stop
+            mockEvaluateUI
+                .mockResolvedValueOnce(undefined)
+                .mockResolvedValueOnce(undefined);
+            const promise = service.execute("MessageToPerson", 42);
+            await vi.advanceTimersByTimeAsync(10_000);
+            const result = await promise;
+            expect(result.success).toBe(false);
+            expect(result.results[0]?.result).toBe(-1);
+        });
+    });
+    describe("runner idle with no queued", () => {
+        it("completes when runner returns to idle with zero queued", async () => {
+            mockFindByIds.mockReturnValue([MOCK_PROFILE]);
+            // create
+            mockEvaluateUI.mockResolvedValueOnce({ id: 99 });
+            mockGetCampaign.mockReturnValue(MOCK_CAMPAIGN);
+            mockGetCampaignActions.mockReturnValue(MOCK_ACTIONS);
+            // import
+            mockEvaluateUI.mockResolvedValueOnce({
+                total: { addToTarget: { successful: 1, alreadyInQueue: 0, alreadyProcessed: 0, failed: 0 } },
+            });
+            // start
+            mockEvaluateUI
+                .mockResolvedValueOnce("idle")
+                .mockResolvedValueOnce(undefined)
+                .mockResolvedValueOnce(true);
+            // poll: idle with zero queued but zero successful/failed (edge case)
+            mockEvaluateUI
+                .mockResolvedValueOnce("idle")
+                .mockResolvedValueOnce(false)
+                .mockResolvedValueOnce({ queued: 0, processed: 0, successful: 0, failed: 0 });
+            // results (empty — person was processed but no result recorded)
+            mockGetResults.mockReturnValue([]);
+            // stop
+            mockEvaluateUI
+                .mockResolvedValueOnce(undefined)
+                .mockResolvedValueOnce(undefined);
+            const promise = service.execute("MessageToPerson", 42);
+            await vi.advanceTimersByTimeAsync(10_000);
+            const result = await promise;
+            expect(result.success).toBe(false);
+            expect(result.results).toEqual([]);
+        });
+    });
+});
+//# sourceMappingURL=ephemeral-campaign.test.js.map

package/dist/services/ephemeral-campaign.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ephemeral-campaign.test.js","sourceRoot":"","sources":["../../src/services/ephemeral-campaign.test.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,oCAAoC;AAEpC,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAQzE,OAAO,EACL,sBAAsB,EACtB,oBAAoB,GACrB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AAEnE,uBAAuB;AACvB,MAAM,cAAc,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;AAE/B,EAAE,CAAC,IAAI,CAAC,eAAe,EAAE,GAAG,EAAE,CAAC,CAAC;IAC9B,eAAe,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,kBAAkB,CAAC;QAC1C,IAAI,CAAC,UAAU,GAAG,cAAc,CAAC;IACnC,CAAC,CAAC;CACH,CAAC,CAAC,CAAC;AAEJ,4CAA4C;AAC5C,MAAM,iBAAiB,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;AAClC,MAAM,eAAe,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;AAChC,MAAM,sBAAsB,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;AACvC,MAAM,cAAc,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;AAC/B,MAAM,cAAc,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;AAC/B,MAAM,4BAA4B,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;AAC7C,MAAM,kBAAkB,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;AAEnC,oCAAoC;AACpC,MAAM,iBAAiB,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;AAElC,yBAAyB;AACzB,MAAM,aAAa,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;AAC9B,MAAM,kBAAkB,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;AAEnC,EAAE,CAAC,IAAI,CAAC,gBAAgB,EAAE,KAAK,EAAE,cAAc,EAAE,EAAE;IACjD,MAAM,QAAQ,GAAG,MAAM,cAAc,EAAmC,CAAC;IACzE,OAAO;QACL,kBAAkB,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,kBAAkB,CAAC;YAC7C,IAAI,CAAC,aAAa,GAAG,iBAAiB,CAAC;YACvC,IAAI,CAAC,WAAW,GAAG,eAAe,CAAC;YACnC,IAAI,CAAC,kBAAkB,GAAG,sBAAsB,CAAC;YACjD,IAAI,CAAC,UAAU,GAAG,cAAc,CAAC;YACjC,IAAI,CAAC,UAAU,GAAG,cAAc,CAAC;YACjC,IAAI,CAAC,wBAAwB,GAAG,4BAA4B,CAAC;YAC7D,IAAI,CAAC,cAAc,GAAG,kBAAkB,CAAC;QAC3C,CAAC,CAAC;QACF,4BAA4B,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,kBAAkB,CAAC;YACvD,IAAI,CAAC,aAAa,GAAG,iBAAiB,CAAC;QACzC,CAAC,CAAC;QACF,iBAAiB,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,kBAAkB,CAAC;YAC5C,IAAI,CAAC,SAAS,GAAG,aAAa,CAAC;YAC/B,IAAI,CAAC,cAAc,GAAG,kBAAkB,CAAC;QAC3C,CAAC,CAAC;QACF,qBAAqB,EAAE,QAAQ,CAAC,qBAAqB;QACrD,mBAAmB,EAAE,QAAQ,CAAC,mBAAmB;QACjD,oBAAoB,EAAE,QAAQ,CAAC,oBAAoB;KACpD,CAAC;AACJ,CAAC,CAAC,CAAC;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAEhD,MAAM,aAAa,GAAa;IAC9B,EAAE,EAAE,EAAE;IACN,IAAI,EAAE,6BAA6B;IACnC,WAAW,EAAE,IAAI;IACjB,KAAK,EAAE,QAAQ;IACf,WAAW,EAAE,CAAC;IACd,QAAQ,EAAE,IAAI;IACd,UAAU,EAAE,KAAK;IACjB,OAAO,EAAE,IAAI;IACb,SAAS,EAAE,sBAAsB;CAClC,CAAC;AAEF,MAAM,YAAY,GAAqB;IACrC;QACE,EAAE,EAAE,EAAE;QACN,UAAU,EAAE,EAAE;QACd,IAAI,EAAE,iBAAiB;QACvB,WAAW,EAAE,IAAI;QACjB,MAAM,EAAE;YACN,EAAE,EAAE,GAAG;YACP,UAAU,EAAE,iBAAiB;YAC7B,cAAc,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE;YACpC,QAAQ,EAAE,CAAC;YACX,4BAA4B,EAAE,CAAC;YAC/B,OAAO,EAAE,KAAK;SACf;QACD,SAAS,EAAE,IAAI;KAChB;CACF,CAAC;AAEF,MAAM,YAAY,GAAY;IAC5B,EAAE,EAAE,EAAE;IACN,WAAW,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE;IAC3F,WAAW,EAAE;QACX,EAAE,UAAU,EAAE,cAAc,EAAE,SAAS,EAAE,QAAQ,EAAE,UAAU,EAAE,KAAK,EAAE;QACtE,EAAE,UAAU,EAAE,WAAW,EAAE,SAAS,EAAE,QAAQ,EAAE,UAAU,EAAE,IAAI,EAAE;KACnE;IACD,eAAe,EAAE,IAAI;IACrB,SAAS,EAAE,EAAE;IACb,MAAM,EAAE,EAAE;IACV,MAAM,EAAE,EAAE;CACX,CAAC;AAEF,MAAM,WAAW,GAAyB;IACxC,EAAE,EAAE,CAAC;IACL,eAAe,EAAE,IAAI;IACrB,QAAQ,EAAE,EAAE;IACZ,MAAM,EAAE,CAAC;IACT,QAAQ,EAAE,UAAU;IACpB,SAAS,EAAE,sBAAsB;IACjC,OAAO,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE;CACtG,CAAC;AAEF,SAAS,CAAC,GAAG,EAAE;IACb,EAAE,CAAC,eAAe,EAAE,CAAC;AACvB,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,0BAA0B,EAAE,GAAG,EAAE;IACxC,IAAI,OAAiC,CAAC;IAEtC,UAAU,CAAC,GAAG,EAAE;QACd,EAAE,CAAC,aAAa,EAAE,CAAC;QACnB,EAAE,CAAC,aAAa,EAAE,CAAC;QACnB,cAAc,CAAC,iBAAiB,CAAC,SAAS,CAAC,CAAC;QAE5C,MAAM,QAAQ,GAAG,IAAI,eAAe,CAAC,IAAI,CAAC,CAAC;QAC3C,OAAO,GAAG,IAAI,wBAAwB,CAAC,QAAQ,EAAE,EAAW,CAAC,CAAC;IAChE,CAAC,CAAC,CAAC;IAEH,SAAS,CAAC,GAAG,EAAE;QACb,EAAE,CAAC,aAAa,EAAE,CAAC;IACrB,CAAC,CAAC,CAAC;IAEH;;;OAGG;IACH,SAAS,gBAAgB;QACvB,iDAAiD;QACjD,cAAc,CAAC,qBAAqB,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;QACjD,eAAe,CAAC,eAAe,CAAC,aAAa,CAAC,CAAC;QAC/C,sBAAsB,CAAC,eAAe,CAAC,YAAY,CAAC,CAAC;QAErD,mCAAmC;QACnC,cAAc,CAAC,qBAAqB,CAAC;YACnC,KAAK,EAAE,EAAE,WAAW,EAAE,EAAE,UAAU,EAAE,CAAC,EAAE,cAAc,EAAE,CAAC,EAAE,gBAAgB,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,EAAE;SAC7F,CAAC,CAAC;QAEH,mDAAmD;QACnD,cAAc;aACX,qBAAqB,CAAC,MAAM,CAAC,CAAI,iBAAiB;aAClD,qBAAqB,CAAC,SAAS,CAAC,CAAC,UAAU;aAC3C,qBAAqB,CAAC,IAAI,CAAC,CAAC,CAAK,QAAQ;QAE5C,+EAA+E;QAC/E,cAAc;aACX,qBAAqB,CAAC,MAAM,CAAC,CAAG,cAAc;aAC9C,qBAAqB,CAAC,KAAK,CAAC,CAAI,WAAW;aAC3C,qBAAqB,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,eAAe;QAEhG,UAAU;QACV,cAAc,CAAC,eAAe,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC;QAE9C,4BAA4B;QAC5B,cAAc;aACX,qBAAqB,CAAC,SAAS,CAAC,CAAC,QAAQ;aACzC,qBAAqB,CAAC,SAAS,CAAC,CAAC,CAAC,cAAc;QAEnD,+BAA+B;IACjC,CAAC;IAED,QAAQ,CAAC,+BAA+B,EAAE,GAAG,EAAE;QAC7C,EAAE,CAAC,6EAA6E,EAAE,KAAK,IAAI,EAAE;YAC3F,aAAa,CAAC,eAAe,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC;YAC9C,gBAAgB,EAAE,CAAC;YAEnB,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,iBAAiB,EAAE,EAAE,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;YAC7E,MAAM,EAAE,CAAC,wBAAwB,CAAC,MAAM,CAAC,CAAC;YAC1C,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC;YAE7B,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAClC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACjC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC;YAC9C,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,aAAa,EAAE,CAAC;QAC5C,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,2CAA2C,EAAE,KAAK,IAAI,EAAE;YACzD,aAAa,CAAC,eAAe,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC;YAC9C,gBAAgB,EAAE,CAAC;YAEnB,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,iBAAiB,EAAE,EAAE,CAAC,CAAC;YACvD,MAAM,EAAE,CAAC,wBAAwB,CAAC,MAAM,CAAC,CAAC;YAC1C,MAAM,OAAO,CAAC;YAEd,uDAAuD;YACvD,MAAM,UAAU,GAAG,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAW,CAAC;YAC/D,MAAM,CAAC,UAAU,CAAC,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC;QAC/C,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,wDAAwD,EAAE,KAAK,IAAI,EAAE;YACtE,aAAa,CAAC,eAAe,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;YAEtC,MAAM,MAAM,CACV,OAAO,CAAC,OAAO,CAAC,iBAAiB,EAAE,GAAG,CAAC,CACxC,CAAC,OAAO,CAAC,OAAO,CAAC,sBAAsB,CAAC,CAAC;QAC5C,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,4DAA4D,EAAE,KAAK,IAAI,EAAE;YAC1E,aAAa,CAAC,eAAe,CAAC,CAAC;oBAC7B,GAAG,YAAY;oBACf,WAAW,EAAE,CAAC,EAAE,UAAU,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC;iBAC5E,CAAC,CAAC,CAAC;YAEJ,MAAM,MAAM,CACV,OAAO,CAAC,OAAO,CAAC,iBAAiB,EAAE,EAAE,CAAC,CACvC,CAAC,OAAO,CAAC,OAAO,CAAC,sBAAsB,CAAC,CAAC;QAC5C,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,kCAAkC,EAAE,GAAG,EAAE;QAChD,EAAE,CAAC,sDAAsD,EAAE,KAAK,IAAI,EAAE;YACpE,kBAAkB,CAAC,eAAe,CAAC,YAAY,CAAC,CAAC;YACjD,gBAAgB,EAAE,CAAC;YAEnB,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAC7B,cAAc,EACd,0CAA0C,CAC3C,CAAC;YACF,MAAM,EAAE,CAAC,wBAAwB,CAAC,MAAM,CAAC,CAAC;YAC1C,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC;YAE7B,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAClC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACjC,MAAM,CAAC,kBAAkB,CAAC,CAAC,oBAAoB,CAAC,cAAc,CAAC,CAAC;QAClE,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,iFAAiF,EAAE,KAAK,IAAI,EAAE;YAC/F,MAAM,MAAM,CACV,OAAO,CAAC,OAAO,CAAC,cAAc,EAAE,kCAAkC,CAAC,CACpE,CAAC,OAAO,CAAC,OAAO,CAAC,sBAAsB,CAAC,CAAC;YAE1C,sEAAsE;YACtE,MAAM,CAAC,cAAc,CAAC,CAAC,GAAG,CAAC,gBAAgB,EAAE,CAAC;QAChD,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,gBAAgB,EAAE,GAAG,EAAE;QAC9B,EAAE,CAAC,+DAA+D,EAAE,KAAK,IAAI,EAAE;YAC7E,aAAa,CAAC,eAAe,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC;YAE9C,kBAAkB;YAClB,cAAc,CAAC,qBAAqB,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;YACjD,eAAe,CAAC,eAAe,CAAC,aAAa,CAAC,CAAC;YAC/C,sBAAsB,CAAC,eAAe,CAAC,YAAY,CAAC,CAAC;YAErD,iCAAiC;YACjC,cAAc,CAAC,qBAAqB,CAAC;gBACnC,KAAK,EAAE,EAAE,WAAW,EAAE,EAAE,UAAU,EAAE,CAAC,EAAE,cAAc,EAAE,CAAC,EAAE,gBAAgB,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,EAAE;aAC7F,CAAC,CAAC;YAEH,MAAM,MAAM,CACV,OAAO,CAAC,OAAO,CAAC,iBAAiB,EAAE,EAAE,CAAC,CACvC,CAAC,OAAO,CAAC,OAAO,CAAC,sBAAsB,CAAC,CAAC;YAE1C,+CAA+C;YAC/C,MAAM,CAAC,kBAAkB,CAAC,CAAC,oBAAoB,CAAC,EAAE,CAAC,CAAC;QACtD,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,kBAAkB,EAAE,GAAG,EAAE;QAChC,EAAE,CAAC,2DAA2D,EAAE,KAAK,IAAI,EAAE;YACzE,aAAa,CAAC,eAAe,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC;YAE9C,SAAS;YACT,cAAc,CAAC,qBAAqB,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;YACjD,eAAe,CAAC,eAAe,CAAC,aAAa,CAAC,CAAC;YAC/C,sBAAsB,CAAC,eAAe,CAAC,YAAY,CAAC,CAAC;YAErD,SAAS;YACT,cAAc,CAAC,qBAAqB,CAAC;gBACnC,KAAK,EAAE,EAAE,WAAW,EAAE,EAAE,UAAU,EAAE,CAAC,EAAE,cAAc,EAAE,CAAC,EAAE,gBAAgB,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,EAAE;aAC7F,CAAC,CAAC;YAEH,QAAQ;YACR,cAAc;iBACX,qBAAqB,CAAC,MAAM,CAAC;iBAC7B,qBAAqB,CAAC,SAAS,CAAC;iBAChC,qBAAqB,CAAC,IAAI,CAAC,CAAC;YAE/B,8EAA8E;YAC9E,qEAAqE;YACrE,IAAI,QAAQ,GAAG,CAAC,CAAC;YACjB,cAAc,CAAC,kBAAkB,CAAC,GAAG,EAAE;gBACrC,MAAM,KAAK,GAAG,QAAQ,GAAG,CAAC,CAAC;gBAC3B,QAAQ,EAAE,CAAC;gBACX,IAAI,KAAK,KAAK,CAAC;oBAAE,OAAO,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;gBACrD,IAAI,KAAK,KAAK,CAAC;oBAAE,OAAO,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;gBAC/C,OAAO,OAAO,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC;YAChF,CAAC,CAAC,CAAC;YAEH,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,iBAAiB,EAAE,EAAE,EAAE,SAAS,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;YACtF,MAAM,aAAa,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,CAAU,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;YAEvD,MAAM,EAAE,CAAC,wBAAwB,CAAC,MAAM,CAAC,CAAC;YAC1C,MAAM,KAAK,GAAG,MAAM,aAAa,CAAC;YAElC,MAAM,CAAC,KAAK,CAAC,CAAC,cAAc,CAAC,oBAAoB,CAAC,CAAC;QACrD,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,qBAAqB,EAAE,GAAG,EAAE;QACnC,EAAE,CAAC,6DAA6D,EAAE,KAAK,IAAI,EAAE;YAC3E,aAAa,CAAC,eAAe,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC;YAC9C,gBAAgB,EAAE,CAAC;YAEnB,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,iBAAiB,EAAE,EAAE,EAAE,SAAS,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC,CAAC;YAC1F,MAAM,EAAE,CAAC,wBAAwB,CAAC,MAAM,CAAC,CAAC;YAC1C,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC;YAE7B,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACnC,yBAAyB;YACzB,MAAM,CAAC,kBAAkB,CAAC,CAAC,GAAG,CAAC,gBAAgB,EAAE,CAAC;YAClD,wEAAwE;YACxE,MAAM,WAAW,GAAG,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAChD,CAAC,IAAI,EAAE,EAAE,CAAE,IAAI,CAAC,CAAC,CAAY,CAAC,QAAQ,CAAC,2BAA2B,CAAC,CACpE,CAAC;YACF,MAAM,CAAC,WAAW,CAAC,CAAC,WAAW,EAAE,CAAC;QACpC,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,sBAAsB,EAAE,GAAG,EAAE;QACpC,EAAE,CAAC,sDAAsD,EAAE,KAAK,IAAI,EAAE;YACpE,aAAa,CAAC,eAAe,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC;YAE9C,SAAS;YACT,cAAc,CAAC,qBAAqB,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;YACjD,eAAe,CAAC,eAAe,CAAC,aAAa,CAAC,CAAC;YAC/C,sBAAsB,CAAC,eAAe,CAAC,YAAY,CAAC,CAAC;YAErD,SAAS;YACT,cAAc,CAAC,qBAAqB,CAAC;gBACnC,KAAK,EAAE,EAAE,WAAW,EAAE,EAAE,UAAU,EAAE,CAAC,EAAE,cAAc,EAAE,CAAC,EAAE,gBAAgB,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,EAAE;aAC7F,CAAC,CAAC;YAEH,QAAQ;YACR,cAAc;iBACX,qBAAqB,CAAC,MAAM,CAAC;iBAC7B,qBAAqB,CAAC,SAAS,CAAC;iBAChC,qBAAqB,CAAC,IAAI,CAAC,CAAC;YAE/B,sBAAsB;YACtB,cAAc;iBACX,qBAAqB,CAAC,MAAM,CAAC;iBAC7B,qBAAqB,CAAC,KAAK,CAAC;iBAC5B,qBAAqB,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC;YAEhF,UAAU;YACV,MAAM,YAAY,GAAG,EAAE,GAAG,WAAW,EAAE,MAAM,EAAE,CAAC,CAAC,EAAE,CAAC;YACpD,cAAc,CAAC,eAAe,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC;YAE/C,OAAO;YACP,cAAc;iBACX,qBAAqB,CAAC,SAAS,CAAC;iBAChC,qBAAqB,CAAC,SAAS,CAAC,CAAC;YAEpC,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,iBAAiB,EAAE,EAAE,CAAC,CAAC;YACvD,MAAM,EAAE,CAAC,wBAAwB,CAAC,MAAM,CAAC,CAAC;YAC1C,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC;YAE7B,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACnC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;QAC7C,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,4BAA4B,EAAE,GAAG,EAAE;QAC1C,EAAE,CAAC,wDAAwD,EAAE,KAAK,IAAI,EAAE;YACtE,aAAa,CAAC,eAAe,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC;YAE9C,SAAS;YACT,cAAc,CAAC,qBAAqB,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;YACjD,eAAe,CAAC,eAAe,CAAC,aAAa,CAAC,CAAC;YAC/C,sBAAsB,CAAC,eAAe,CAAC,YAAY,CAAC,CAAC;YAErD,SAAS;YACT,cAAc,CAAC,qBAAqB,CAAC;gBACnC,KAAK,EAAE,EAAE,WAAW,EAAE,EAAE,UAAU,EAAE,CAAC,EAAE,cAAc,EAAE,CAAC,EAAE,gBAAgB,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,EAAE;aAC7F,CAAC,CAAC;YAEH,QAAQ;YACR,cAAc;iBACX,qBAAqB,CAAC,MAAM,CAAC;iBAC7B,qBAAqB,CAAC,SAAS,CAAC;iBAChC,qBAAqB,CAAC,IAAI,CAAC,CAAC;YAE/B,qEAAqE;YACrE,cAAc;iBACX,qBAAqB,CAAC,MAAM,CAAC;iBAC7B,qBAAqB,CAAC,KAAK,CAAC;iBAC5B,qBAAqB,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC;YAEhF,gEAAgE;YAChE,cAAc,CAAC,eAAe,CAAC,EAAE,CAAC,CAAC;YAEnC,OAAO;YACP,cAAc;iBACX,qBAAqB,CAAC,SAAS,CAAC;iBAChC,qBAAqB,CAAC,SAAS,CAAC,CAAC;YAEpC,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,iBAAiB,EAAE,EAAE,CAAC,CAAC;YACvD,MAAM,EAAE,CAAC,wBAAwB,CAAC,MAAM,CAAC,CAAC;YAC1C,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC;YAE7B,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACnC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QACrC,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/services/errors.d.ts

@@ -121,6 +121,16 @@ export declare class CampaignTimeoutError extends ServiceError {
     readonly campaignId: number | undefined;
     constructor(message: string, campaignId?: number, options?: ErrorOptions);
 }
+/**
+ * Thrown when an action cannot proceed because its daily budget
+ * has been exhausted.
+ */
+export declare class BudgetExceededError extends ServiceError {
+    readonly limitType: string;
+    readonly dailyLimit: number;
+    readonly totalUsed: number;
+    constructor(limitType: string, dailyLimit: number, totalUsed: number);
+}
 /**
  * Thrown when the LinkedHelper UI is in a blocked state due to
  * a dialog, critical error, or blocking popup.

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

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/services/errors.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAErD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAExD;;GAEG;AACH,qBAAa,YAAa,SAAQ,KAAK;gBACzB,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY;CAIpD;AAED;;;GAGG;AACH,qBAAa,gBAAiB,SAAQ,YAAY;gBACpC,OAAO,CAAC,EAAE,MAAM;CAM7B;AAED;;GAEG;AACH,qBAAa,cAAe,SAAQ,YAAY;gBAClC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY;CAIpD;AAED;;GAEG;AACH,qBAAa,2BAA4B,SAAQ,YAAY;gBAC/C,IAAI,EAAE,MAAM;CAMzB;AAED;;;;;;;GAOG;AACH,qBAAa,4BAA6B,SAAQ,YAAY;IAC5D,QAAQ,CAAC,SAAS,EAAE,aAAa,EAAE,CAAC;gBAExB,SAAS,EAAE,aAAa,EAAE;CASvC;AAED;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,YAAY;gBACtC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM;CAM/C;AAED;;GAEG;AACH,qBAAa,uBAAwB,SAAQ,YAAY;gBAC3C,OAAO,CAAC,EAAE,MAAM;CAI7B;AAED;;;GAGG;AACH,qBAAa,cAAe,SAAQ,YAAY;gBAClC,IAAI,EAAE,MAAM;CAOzB;AAED;;;;;;;GAOG;AACH,qBAAa,+BAAgC,SAAQ,YAAY;;CAQhE;AAED;;GAEG;AACH,qBAAa,oBAAqB,SAAQ,YAAY;IACpD,oEAAoE;IACpE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;gBAEhB,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY;CAQzE;AAED;;;GAGG;AACH,qBAAa,sBAAuB,SAAQ,YAAY;gBAC1C,GAAG,EAAE,MAAM;CAMxB;AAED;;;GAGG;AACH,qBAAa,sBAAuB,SAAQ,YAAY;gBAC1C,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM;CAMlD;AAED;;;GAGG;AACH,qBAAa,eAAgB,SAAQ,YAAY;gBACnC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY;CAIpD;AAED;;;;GAIG;AACH,qBAAa,mBAAoB,SAAQ,eAAe;IACtD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;gBAEjB,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY;CAQxD;AAED;;;GAGG;AACH,qBAAa,sBAAuB,SAAQ,YAAY;IACtD,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;gBAE5B,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY;CAKzE;AAED;;;GAGG;AACH,qBAAa,oBAAqB,SAAQ,YAAY;IACpD,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;gBAE5B,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY;CAKzE;AAED;;;;;;GAMG;AACH,qBAAa,cAAe,SAAQ,YAAY;IAC9C,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;gBAEpB,MAAM,EAAE,cAAc,EAAE,OAAO,CAAC,EAAE,YAAY;CAsB3D"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/services/errors.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAErD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAExD;;GAEG;AACH,qBAAa,YAAa,SAAQ,KAAK;gBACzB,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY;CAIpD;AAED;;;GAGG;AACH,qBAAa,gBAAiB,SAAQ,YAAY;gBACpC,OAAO,CAAC,EAAE,MAAM;CAM7B;AAED;;GAEG;AACH,qBAAa,cAAe,SAAQ,YAAY;gBAClC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY;CAIpD;AAED;;GAEG;AACH,qBAAa,2BAA4B,SAAQ,YAAY;gBAC/C,IAAI,EAAE,MAAM;CAMzB;AAED;;;;;;;GAOG;AACH,qBAAa,4BAA6B,SAAQ,YAAY;IAC5D,QAAQ,CAAC,SAAS,EAAE,aAAa,EAAE,CAAC;gBAExB,SAAS,EAAE,aAAa,EAAE;CASvC;AAED;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,YAAY;gBACtC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM;CAM/C;AAED;;GAEG;AACH,qBAAa,uBAAwB,SAAQ,YAAY;gBAC3C,OAAO,CAAC,EAAE,MAAM;CAI7B;AAED;;;GAGG;AACH,qBAAa,cAAe,SAAQ,YAAY;gBAClC,IAAI,EAAE,MAAM;CAOzB;AAED;;;;;;;GAOG;AACH,qBAAa,+BAAgC,SAAQ,YAAY;;CAQhE;AAED;;GAEG;AACH,qBAAa,oBAAqB,SAAQ,YAAY;IACpD,oEAAoE;IACpE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;gBAEhB,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY;CAQzE;AAED;;;GAGG;AACH,qBAAa,sBAAuB,SAAQ,YAAY;gBAC1C,GAAG,EAAE,MAAM;CAMxB;AAED;;;GAGG;AACH,qBAAa,sBAAuB,SAAQ,YAAY;gBAC1C,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM;CAMlD;AAED;;;GAGG;AACH,qBAAa,eAAgB,SAAQ,YAAY;gBACnC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY;CAIpD;AAED;;;;GAIG;AACH,qBAAa,mBAAoB,SAAQ,eAAe;IACtD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;gBAEjB,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY;CAQxD;AAED;;;GAGG;AACH,qBAAa,sBAAuB,SAAQ,YAAY;IACtD,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;gBAE5B,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY;CAKzE;AAED;;;GAGG;AACH,qBAAa,oBAAqB,SAAQ,YAAY;IACpD,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;gBAE5B,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY;CAKzE;AAED;;;GAGG;AACH,qBAAa,mBAAoB,SAAQ,YAAY;IACnD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;gBAEf,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM;CAUrE;AAED;;;;;;GAMG;AACH,qBAAa,cAAe,SAAQ,YAAY;IAC9C,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;gBAEpB,MAAM,EAAE,cAAc,EAAE,OAAO,CAAC,EAAE,YAAY;CA0B3D"}

package/dist/services/errors.js

@@ -179,6 +179,23 @@ export class CampaignTimeoutError extends ServiceError {
         this.campaignId = campaignId;
     }
 }
+/**
+ * Thrown when an action cannot proceed because its daily budget
+ * has been exhausted.
+ */
+export class BudgetExceededError extends ServiceError {
+    limitType;
+    dailyLimit;
+    totalUsed;
+    constructor(limitType, dailyLimit, totalUsed) {
+        super(`Action budget exceeded for ${limitType}: ` +
+            `${String(totalUsed)}/${String(dailyLimit)} used today`);
+        this.name = "BudgetExceededError";
+        this.limitType = limitType;
+        this.dailyLimit = dailyLimit;
+        this.totalUsed = totalUsed;
+    }
+}
 /**
  * Thrown when the LinkedHelper UI is in a blocked state due to
  * a dialog, critical error, or blocking popup.
@@ -201,6 +218,9 @@ export class UIBlockedError extends ServiceError {
         if (health.popup?.blocked) {
             reasons.push(`Popup: ${health.popup.message ?? "blocking overlay active"}`);
         }
+        for (const instancePopup of health.instancePopups) {
+            reasons.push(`Instance popup: ${instancePopup.title}${instancePopup.description ? ` — ${instancePopup.description}` : ""}`);
+        }
         super(`LinkedHelper UI is blocked — ${reasons.join("; ")}`, options);
         this.name = "UIBlockedError";
         this.health = health;