@lhremote/core 0.7.0 → 0.8.0

package/dist/operations/comment-on-post.test.js

@@ -0,0 +1,240 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
+vi.mock("../services/account-resolution.js", () => ({
+    resolveAccount: vi.fn(),
+}));
+vi.mock("../services/instance-context.js", () => ({
+    withDatabase: vi.fn(),
+}));
+vi.mock("../db/index.js", () => ({
+    ActionBudgetRepository: vi.fn(),
+}));
+vi.mock("../cdp/discovery.js", () => ({
+    discoverTargets: vi.fn(),
+}));
+vi.mock("../cdp/client.js", () => ({
+    CDPClient: vi.fn(),
+}));
+vi.mock("../linkedin/dom-automation.js", () => ({
+    waitForElement: vi.fn(),
+    scrollTo: vi.fn(),
+    click: vi.fn(),
+    typeText: vi.fn(),
+}));
+vi.mock("../utils/delay.js", () => ({
+    delay: vi.fn().mockResolvedValue(undefined),
+}));
+import { resolveAccount } from "../services/account-resolution.js";
+import { withDatabase } from "../services/instance-context.js";
+import { ActionBudgetRepository } from "../db/index.js";
+import { discoverTargets } from "../cdp/discovery.js";
+import { CDPClient } from "../cdp/client.js";
+import { waitForElement, scrollTo, click, typeText } from "../linkedin/dom-automation.js";
+import { BudgetExceededError } from "../services/errors.js";
+import { commentOnPost } from "./comment-on-post.js";
+const MOCK_CDP_PORT = 9222;
+const MOCK_POST_URL = "https://www.linkedin.com/feed/update/urn:li:activity:123/";
+function createMockClient() {
+    return {
+        connect: vi.fn().mockResolvedValue(undefined),
+        disconnect: vi.fn(),
+        send: vi.fn().mockResolvedValue(undefined),
+        navigate: vi.fn().mockResolvedValue({ frameId: "F1" }),
+        waitForEvent: vi.fn().mockResolvedValue(undefined),
+    };
+}
+function setupMocks(budgetEntries = [
+    {
+        limitTypeId: 19,
+        limitType: "PostComment",
+        dailyLimit: 10,
+        campaignUsed: 2,
+        directUsed: 0,
+        totalUsed: 2,
+        remaining: 8,
+    },
+]) {
+    vi.mocked(resolveAccount).mockResolvedValue(1);
+    vi.mocked(withDatabase).mockImplementation(async (_accountId, callback) => callback({ db: {} }));
+    vi.mocked(ActionBudgetRepository).mockImplementation(function () {
+        return {
+            getActionBudget: vi.fn().mockReturnValue(budgetEntries),
+            getLimitTypes: vi.fn().mockReturnValue([]),
+        };
+    });
+    vi.mocked(discoverTargets).mockResolvedValue([
+        { id: "T1", type: "page", title: "LinkedIn", url: "https://www.linkedin.com/feed/", description: "", devtoolsFrontendUrl: "" },
+    ]);
+    const mockClient = createMockClient();
+    vi.mocked(CDPClient).mockImplementation(function () {
+        return mockClient;
+    });
+    // Reset DOM automation mocks to default resolved state
+    vi.mocked(waitForElement).mockResolvedValue(undefined);
+    vi.mocked(scrollTo).mockResolvedValue(undefined);
+    vi.mocked(click).mockResolvedValue(undefined);
+    vi.mocked(typeText).mockResolvedValue(undefined);
+    return mockClient;
+}
+describe("commentOnPost", () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+    });
+    afterEach(() => {
+        vi.restoreAllMocks();
+    });
+    it("rejects empty comment text", async () => {
+        await expect(commentOnPost({ postUrl: MOCK_POST_URL, text: "", cdpPort: MOCK_CDP_PORT })).rejects.toThrow("Comment text cannot be empty");
+    });
+    it("rejects whitespace-only comment text", async () => {
+        await expect(commentOnPost({ postUrl: MOCK_POST_URL, text: "   ", cdpPort: MOCK_CDP_PORT })).rejects.toThrow("Comment text cannot be empty");
+    });
+    it("rejects invalid LinkedIn post URL", async () => {
+        await expect(commentOnPost({ postUrl: "https://example.com/foo", text: "hello", cdpPort: MOCK_CDP_PORT })).rejects.toThrow("Invalid LinkedIn post URL");
+    });
+    it("accepts /feed/update/ URL format", async () => {
+        setupMocks();
+        const result = await commentOnPost({
+            postUrl: "https://www.linkedin.com/feed/update/urn:li:activity:123456/",
+            text: "hello",
+            cdpPort: MOCK_CDP_PORT,
+        });
+        expect(result.success).toBe(true);
+    });
+    it("accepts /posts/ URL format", async () => {
+        setupMocks();
+        const result = await commentOnPost({
+            postUrl: "https://www.linkedin.com/posts/johndoe_activity-123456-abcd/",
+            text: "hello",
+            cdpPort: MOCK_CDP_PORT,
+        });
+        expect(result.success).toBe(true);
+    });
+    it("rejects non-loopback host without allowRemote", async () => {
+        await expect(commentOnPost({
+            postUrl: MOCK_POST_URL,
+            text: "hello",
+            cdpPort: MOCK_CDP_PORT,
+            cdpHost: "192.168.1.100",
+        })).rejects.toThrow("Non-loopback CDP host");
+    });
+    it("allows non-loopback host with allowRemote", async () => {
+        const mockClient = setupMocks();
+        const result = await commentOnPost({
+            postUrl: MOCK_POST_URL,
+            text: "hello",
+            cdpPort: MOCK_CDP_PORT,
+            cdpHost: "192.168.1.100",
+            allowRemote: true,
+        });
+        expect(result.success).toBe(true);
+        expect(mockClient.connect).toHaveBeenCalled();
+    });
+    it("throws BudgetExceededError when PostComment limit reached", async () => {
+        setupMocks([
+            {
+                limitTypeId: 19,
+                limitType: "PostComment",
+                dailyLimit: 10,
+                campaignUsed: 10,
+                directUsed: 0,
+                totalUsed: 10,
+                remaining: 0,
+            },
+        ]);
+        await expect(commentOnPost({ postUrl: MOCK_POST_URL, text: "hello", cdpPort: MOCK_CDP_PORT })).rejects.toThrow(BudgetExceededError);
+    });
+    it("proceeds when PostComment has remaining budget", async () => {
+        setupMocks();
+        const result = await commentOnPost({
+            postUrl: MOCK_POST_URL,
+            text: "Great post!",
+            cdpPort: MOCK_CDP_PORT,
+        });
+        expect(result.success).toBe(true);
+        expect(result.postUrl).toBe(MOCK_POST_URL);
+        expect(result.commentText).toBe("Great post!");
+    });
+    it("proceeds when PostComment has no daily limit (unlimited)", async () => {
+        setupMocks([
+            {
+                limitTypeId: 19,
+                limitType: "PostComment",
+                dailyLimit: null,
+                campaignUsed: 0,
+                directUsed: 0,
+                totalUsed: 0,
+                remaining: null,
+            },
+        ]);
+        const result = await commentOnPost({
+            postUrl: MOCK_POST_URL,
+            text: "hello",
+            cdpPort: MOCK_CDP_PORT,
+        });
+        expect(result.success).toBe(true);
+    });
+    it("proceeds when PostComment limit type is not in budget", async () => {
+        setupMocks([
+            {
+                limitTypeId: 8,
+                limitType: "Invite",
+                dailyLimit: 100,
+                campaignUsed: 5,
+                directUsed: 0,
+                totalUsed: 5,
+                remaining: 95,
+            },
+        ]);
+        const result = await commentOnPost({
+            postUrl: MOCK_POST_URL,
+            text: "hello",
+            cdpPort: MOCK_CDP_PORT,
+        });
+        expect(result.success).toBe(true);
+    });
+    it("throws when no LinkedIn page is found", async () => {
+        setupMocks();
+        vi.mocked(discoverTargets).mockResolvedValue([]);
+        await expect(commentOnPost({ postUrl: MOCK_POST_URL, text: "hello", cdpPort: MOCK_CDP_PORT })).rejects.toThrow("No LinkedIn page found");
+    });
+    it("navigates to post URL and performs DOM automation", async () => {
+        const mockClient = setupMocks();
+        await commentOnPost({
+            postUrl: MOCK_POST_URL,
+            text: "Nice!",
+            cdpPort: MOCK_CDP_PORT,
+        });
+        // Verify navigation
+        expect(mockClient.send).toHaveBeenCalledWith("Page.enable");
+        expect(mockClient.navigate).toHaveBeenCalledWith(MOCK_POST_URL);
+        expect(mockClient.waitForEvent).toHaveBeenCalledWith("Page.loadEventFired");
+        // Verify DOM automation sequence
+        expect(waitForElement).toHaveBeenCalled();
+        expect(scrollTo).toHaveBeenCalled();
+        expect(click).toHaveBeenCalledTimes(2); // comment input + submit
+        expect(typeText).toHaveBeenCalled();
+    });
+    it("disconnects CDP client even on error", async () => {
+        const mockClient = setupMocks();
+        vi.mocked(waitForElement).mockRejectedValue(new Error("timeout"));
+        await expect(commentOnPost({ postUrl: MOCK_POST_URL, text: "hello", cdpPort: MOCK_CDP_PORT })).rejects.toThrow("timeout");
+        expect(mockClient.disconnect).toHaveBeenCalled();
+    });
+    it("passes connection options to resolveAccount", async () => {
+        setupMocks();
+        await commentOnPost({
+            postUrl: MOCK_POST_URL,
+            text: "hello",
+            cdpPort: 1234,
+            cdpHost: "localhost",
+            allowRemote: true,
+        });
+        expect(resolveAccount).toHaveBeenCalledWith(1234, {
+            host: "localhost",
+            allowRemote: true,
+        });
+    });
+});
+//# sourceMappingURL=comment-on-post.test.js.map

package/dist/operations/comment-on-post.test.js.map

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

package/dist/operations/dismiss-errors.d.ts

@@ -0,0 +1,22 @@
+import type { ConnectionOptions } from "./types.js";
+/**
+ * Input for the dismiss-errors operation.
+ */
+export type DismissErrorsInput = ConnectionOptions;
+/**
+ * Output from the dismiss-errors operation.
+ */
+export interface DismissErrorsOutput {
+    readonly accountId: number;
+    readonly dismissed: number;
+    readonly nonDismissable: number;
+}
+/**
+ * Dismiss closable error popups in the LinkedHelper instance UI.
+ *
+ * Connects to both the launcher and instance, finds popup close/OK
+ * buttons, and clicks them via CDP.  Returns the number of dismissed
+ * vs non-dismissable popups.
+ */
+export declare function dismissErrors(input: DismissErrorsInput): Promise<DismissErrorsOutput>;
+//# sourceMappingURL=dismiss-errors.d.ts.map

package/dist/operations/dismiss-errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dismiss-errors.d.ts","sourceRoot":"","sources":["../../src/operations/dismiss-errors.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEpD;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,iBAAiB,CAAC;AAEnD;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACjC;AAED;;;;;;GAMG;AACH,wBAAsB,aAAa,CACjC,KAAK,EAAE,kBAAkB,GACxB,OAAO,CAAC,mBAAmB,CAAC,CA2C9B"}

package/dist/operations/dismiss-errors.js

@@ -0,0 +1,55 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+import { resolveAccount } from "../services/account-resolution.js";
+import { InstanceService } from "../services/instance.js";
+import { LauncherService } from "../services/launcher.js";
+import { DEFAULT_CDP_PORT } from "../constants.js";
+/**
+ * Dismiss closable error popups in the LinkedHelper instance UI.
+ *
+ * Connects to both the launcher and instance, finds popup close/OK
+ * buttons, and clicks them via CDP.  Returns the number of dismissed
+ * vs non-dismissable popups.
+ */
+export async function dismissErrors(input) {
+    const cdpPort = input.cdpPort ?? DEFAULT_CDP_PORT;
+    const cdpOptions = {
+        ...(input.cdpHost !== undefined && { host: input.cdpHost }),
+        ...(input.allowRemote !== undefined && { allowRemote: input.allowRemote }),
+    };
+    const accountId = await resolveAccount(cdpPort, cdpOptions);
+    let dismissed = 0;
+    let nonDismissable = 0;
+    // Dismiss launcher popup
+    const launcher = new LauncherService(cdpPort, cdpOptions);
+    try {
+        await launcher.connect();
+        const popupDismissed = await launcher.dismissPopup();
+        if (popupDismissed) {
+            dismissed++;
+        }
+        else {
+            // Check if there's a non-dismissable popup
+            const popupState = await launcher.getPopupState();
+            if (popupState !== null && popupState.blocked) {
+                nonDismissable++;
+            }
+        }
+    }
+    finally {
+        launcher.disconnect();
+    }
+    // Dismiss instance UI popups
+    const instance = new InstanceService(cdpPort, cdpOptions);
+    try {
+        await instance.connect();
+        const result = await instance.dismissInstancePopups();
+        dismissed += result.dismissed;
+        nonDismissable += result.nonDismissable;
+    }
+    finally {
+        instance.disconnect();
+    }
+    return { accountId, dismissed, nonDismissable };
+}
+//# sourceMappingURL=dismiss-errors.js.map

package/dist/operations/dismiss-errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dismiss-errors.js","sourceRoot":"","sources":["../../src/operations/dismiss-errors.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,oCAAoC;AAEpC,OAAO,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AACnE,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAiBnD;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,KAAyB;IAEzB,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,IAAI,gBAAgB,CAAC;IAElD,MAAM,UAAU,GAAG;QACjB,GAAG,CAAC,KAAK,CAAC,OAAO,KAAK,SAAS,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC;QAC3D,GAAG,CAAC,KAAK,CAAC,WAAW,KAAK,SAAS,IAAI,EAAE,WAAW,EAAE,KAAK,CAAC,WAAW,EAAE,CAAC;KAC3E,CAAC;IAEF,MAAM,SAAS,GAAG,MAAM,cAAc,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;IAE5D,IAAI,SAAS,GAAG,CAAC,CAAC;IAClB,IAAI,cAAc,GAAG,CAAC,CAAC;IAEvB,yBAAyB;IACzB,MAAM,QAAQ,GAAG,IAAI,eAAe,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;IAC1D,IAAI,CAAC;QACH,MAAM,QAAQ,CAAC,OAAO,EAAE,CAAC;QACzB,MAAM,cAAc,GAAG,MAAM,QAAQ,CAAC,YAAY,EAAE,CAAC;QACrD,IAAI,cAAc,EAAE,CAAC;YACnB,SAAS,EAAE,CAAC;QACd,CAAC;aAAM,CAAC;YACN,2CAA2C;YAC3C,MAAM,UAAU,GAAG,MAAM,QAAQ,CAAC,aAAa,EAAE,CAAC;YAClD,IAAI,UAAU,KAAK,IAAI,IAAI,UAAU,CAAC,OAAO,EAAE,CAAC;gBAC9C,cAAc,EAAE,CAAC;YACnB,CAAC;QACH,CAAC;IACH,CAAC;YAAS,CAAC;QACT,QAAQ,CAAC,UAAU,EAAE,CAAC;IACxB,CAAC;IAED,6BAA6B;IAC7B,MAAM,QAAQ,GAAG,IAAI,eAAe,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;IAC1D,IAAI,CAAC;QACH,MAAM,QAAQ,CAAC,OAAO,EAAE,CAAC;QACzB,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,qBAAqB,EAAE,CAAC;QACtD,SAAS,IAAI,MAAM,CAAC,SAAS,CAAC;QAC9B,cAAc,IAAI,MAAM,CAAC,cAAc,CAAC;IAC1C,CAAC;YAAS,CAAC;QACT,QAAQ,CAAC,UAAU,EAAE,CAAC;IACxB,CAAC;IAED,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,cAAc,EAAE,CAAC;AAClD,CAAC"}

package/dist/operations/dismiss-errors.test.d.ts

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

package/dist/operations/dismiss-errors.test.d.ts.map

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

package/dist/operations/dismiss-errors.test.js

@@ -0,0 +1,136 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
+vi.mock("../services/account-resolution.js", () => ({
+    resolveAccount: vi.fn(),
+}));
+vi.mock("../services/launcher.js", () => ({
+    LauncherService: vi.fn(),
+}));
+vi.mock("../services/instance.js", () => ({
+    InstanceService: vi.fn(),
+}));
+import { resolveAccount } from "../services/account-resolution.js";
+import { InstanceService } from "../services/instance.js";
+import { LauncherService } from "../services/launcher.js";
+import { dismissErrors } from "./dismiss-errors.js";
+describe("dismissErrors", () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+    });
+    afterEach(() => {
+        vi.restoreAllMocks();
+    });
+    it("returns zero counts when no popups present", async () => {
+        vi.mocked(resolveAccount).mockResolvedValue(1);
+        const mockLauncher = {
+            connect: vi.fn().mockResolvedValue(undefined),
+            disconnect: vi.fn(),
+            dismissPopup: vi.fn().mockResolvedValue(false),
+            getPopupState: vi.fn().mockResolvedValue(null),
+        };
+        vi.mocked(LauncherService).mockImplementation(function () {
+            return mockLauncher;
+        });
+        const mockInstance = {
+            connect: vi.fn().mockResolvedValue(undefined),
+            disconnect: vi.fn(),
+            dismissInstancePopups: vi.fn().mockResolvedValue({ dismissed: 0, nonDismissable: 0 }),
+        };
+        vi.mocked(InstanceService).mockImplementation(function () {
+            return mockInstance;
+        });
+        const result = await dismissErrors({ cdpPort: 9222 });
+        expect(result.accountId).toBe(1);
+        expect(result.dismissed).toBe(0);
+        expect(result.nonDismissable).toBe(0);
+    });
+    it("dismisses launcher popup and instance popups", async () => {
+        vi.mocked(resolveAccount).mockResolvedValue(1);
+        const mockLauncher = {
+            connect: vi.fn().mockResolvedValue(undefined),
+            disconnect: vi.fn(),
+            dismissPopup: vi.fn().mockResolvedValue(true),
+        };
+        vi.mocked(LauncherService).mockImplementation(function () {
+            return mockLauncher;
+        });
+        const mockInstance = {
+            connect: vi.fn().mockResolvedValue(undefined),
+            disconnect: vi.fn(),
+            dismissInstancePopups: vi.fn().mockResolvedValue({ dismissed: 2, nonDismissable: 0 }),
+        };
+        vi.mocked(InstanceService).mockImplementation(function () {
+            return mockInstance;
+        });
+        const result = await dismissErrors({ cdpPort: 9222 });
+        expect(result.dismissed).toBe(3);
+        expect(result.nonDismissable).toBe(0);
+    });
+    it("reports non-dismissable launcher popup", async () => {
+        vi.mocked(resolveAccount).mockResolvedValue(1);
+        const mockLauncher = {
+            connect: vi.fn().mockResolvedValue(undefined),
+            disconnect: vi.fn(),
+            dismissPopup: vi.fn().mockResolvedValue(false),
+            getPopupState: vi.fn().mockResolvedValue({ blocked: true, closable: false }),
+        };
+        vi.mocked(LauncherService).mockImplementation(function () {
+            return mockLauncher;
+        });
+        const mockInstance = {
+            connect: vi.fn().mockResolvedValue(undefined),
+            disconnect: vi.fn(),
+            dismissInstancePopups: vi.fn().mockResolvedValue({ dismissed: 0, nonDismissable: 1 }),
+        };
+        vi.mocked(InstanceService).mockImplementation(function () {
+            return mockInstance;
+        });
+        const result = await dismissErrors({ cdpPort: 9222 });
+        expect(result.dismissed).toBe(0);
+        expect(result.nonDismissable).toBe(2);
+    });
+    it("passes connection options to resolveAccount", async () => {
+        vi.mocked(resolveAccount).mockResolvedValue(1);
+        const mockLauncher = {
+            connect: vi.fn().mockResolvedValue(undefined),
+            disconnect: vi.fn(),
+            dismissPopup: vi.fn().mockResolvedValue(false),
+            getPopupState: vi.fn().mockResolvedValue(null),
+        };
+        vi.mocked(LauncherService).mockImplementation(function () {
+            return mockLauncher;
+        });
+        const mockInstance = {
+            connect: vi.fn().mockResolvedValue(undefined),
+            disconnect: vi.fn(),
+            dismissInstancePopups: vi.fn().mockResolvedValue({ dismissed: 0, nonDismissable: 0 }),
+        };
+        vi.mocked(InstanceService).mockImplementation(function () {
+            return mockInstance;
+        });
+        await dismissErrors({
+            cdpPort: 1234,
+            cdpHost: "192.168.1.1",
+            allowRemote: true,
+        });
+        expect(resolveAccount).toHaveBeenCalledWith(1234, {
+            host: "192.168.1.1",
+            allowRemote: true,
+        });
+    });
+    it("disconnects services even on error", async () => {
+        vi.mocked(resolveAccount).mockResolvedValue(1);
+        const mockLauncher = {
+            connect: vi.fn().mockResolvedValue(undefined),
+            disconnect: vi.fn(),
+            dismissPopup: vi.fn().mockRejectedValue(new Error("CDP failure")),
+        };
+        vi.mocked(LauncherService).mockImplementation(function () {
+            return mockLauncher;
+        });
+        await expect(dismissErrors({ cdpPort: 9222 })).rejects.toThrow("CDP failure");
+        expect(mockLauncher.disconnect).toHaveBeenCalledOnce();
+    });
+});
+//# sourceMappingURL=dismiss-errors.test.js.map

package/dist/operations/dismiss-errors.test.js.map

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

package/dist/operations/endorse-skills.d.ts

@@ -0,0 +1,10 @@
+import type { EphemeralActionResult } from "../types/index.js";
+import { type EphemeralActionInput } from "./ephemeral-action.js";
+export interface EndorseSkillsInput extends EphemeralActionInput {
+    readonly skillNames?: string[] | undefined;
+    readonly limit?: number | undefined;
+    readonly skipIfNotEndorsable?: boolean | undefined;
+}
+export type EndorseSkillsOutput = EphemeralActionResult;
+export declare function endorseSkills(input: EndorseSkillsInput): Promise<EndorseSkillsOutput>;
+//# sourceMappingURL=endorse-skills.d.ts.map

package/dist/operations/endorse-skills.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"endorse-skills.d.ts","sourceRoot":"","sources":["../../src/operations/endorse-skills.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAkB,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAC/E,OAAO,EAEL,KAAK,oBAAoB,EAC1B,MAAM,uBAAuB,CAAC;AAE/B,MAAM,WAAW,kBAAmB,SAAQ,oBAAoB;IAC9D,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;IAC3C,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,QAAQ,CAAC,mBAAmB,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CACpD;AAED,MAAM,MAAM,mBAAmB,GAAG,qBAAqB,CAAC;AAExD,wBAAsB,aAAa,CACjC,KAAK,EAAE,kBAAkB,GACxB,OAAO,CAAC,mBAAmB,CAAC,CAQ9B"}

package/dist/operations/endorse-skills.js

@@ -0,0 +1,12 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+import { executeEphemeralAction, } from "./ephemeral-action.js";
+export async function endorseSkills(input) {
+    const actionSettings = {
+        skipIfNotEndorsable: input.skipIfNotEndorsable ?? true,
+        ...(input.skillNames !== undefined && { skillNames: input.skillNames }),
+        ...(input.limit !== undefined && { limit: input.limit }),
+    };
+    return executeEphemeralAction("EndorseSkills", input, actionSettings);
+}
+//# sourceMappingURL=endorse-skills.js.map

package/dist/operations/endorse-skills.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"endorse-skills.js","sourceRoot":"","sources":["../../src/operations/endorse-skills.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,oCAAoC;AAGpC,OAAO,EACL,sBAAsB,GAEvB,MAAM,uBAAuB,CAAC;AAU/B,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,KAAyB;IAEzB,MAAM,cAAc,GAAmB;QACrC,mBAAmB,EAAE,KAAK,CAAC,mBAAmB,IAAI,IAAI;QACtD,GAAG,CAAC,KAAK,CAAC,UAAU,KAAK,SAAS,IAAI,EAAE,UAAU,EAAE,KAAK,CAAC,UAAU,EAAE,CAAC;QACvE,GAAG,CAAC,KAAK,CAAC,KAAK,KAAK,SAAS,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC;KACzD,CAAC;IAEF,OAAO,sBAAsB,CAAC,eAAe,EAAE,KAAK,EAAE,cAAc,CAAC,CAAC;AACxE,CAAC"}

package/dist/operations/enrich-profile.d.ts

@@ -0,0 +1,18 @@
+import type { EphemeralActionResult } from "../types/index.js";
+import { type EphemeralActionInput } from "./ephemeral-action.js";
+/** Per-category enrichment toggle. */
+export interface EnrichmentCategory {
+    readonly shouldEnrich: boolean;
+    readonly actualDate?: number | undefined;
+    readonly types?: string[] | undefined;
+}
+export interface EnrichProfileInput extends EphemeralActionInput {
+    readonly profileInfo?: EnrichmentCategory | undefined;
+    readonly phones?: EnrichmentCategory | undefined;
+    readonly emails?: EnrichmentCategory | undefined;
+    readonly socials?: EnrichmentCategory | undefined;
+    readonly companies?: EnrichmentCategory | undefined;
+}
+export type EnrichProfileOutput = EphemeralActionResult;
+export declare function enrichProfile(input: EnrichProfileInput): Promise<EnrichProfileOutput>;
+//# sourceMappingURL=enrich-profile.d.ts.map

package/dist/operations/enrich-profile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"enrich-profile.d.ts","sourceRoot":"","sources":["../../src/operations/enrich-profile.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAkB,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAC/E,OAAO,EAEL,KAAK,oBAAoB,EAC1B,MAAM,uBAAuB,CAAC;AAE/B,sCAAsC;AACtC,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACzC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;CACvC;AAED,MAAM,WAAW,kBAAmB,SAAQ,oBAAoB;IAC9D,QAAQ,CAAC,WAAW,CAAC,EAAE,kBAAkB,GAAG,SAAS,CAAC;IACtD,QAAQ,CAAC,MAAM,CAAC,EAAE,kBAAkB,GAAG,SAAS,CAAC;IACjD,QAAQ,CAAC,MAAM,CAAC,EAAE,kBAAkB,GAAG,SAAS,CAAC;IACjD,QAAQ,CAAC,OAAO,CAAC,EAAE,kBAAkB,GAAG,SAAS,CAAC;IAClD,QAAQ,CAAC,SAAS,CAAC,EAAE,kBAAkB,GAAG,SAAS,CAAC;CACrD;AAED,MAAM,MAAM,mBAAmB,GAAG,qBAAqB,CAAC;AAExD,wBAAsB,aAAa,CACjC,KAAK,EAAE,kBAAkB,GACxB,OAAO,CAAC,mBAAmB,CAAC,CAW9B"}

package/dist/operations/enrich-profile.js

@@ -0,0 +1,15 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+import { executeEphemeralAction, } from "./ephemeral-action.js";
+export async function enrichProfile(input) {
+    const defaults = { shouldEnrich: false };
+    const actionSettings = {
+        profileInfo: input.profileInfo ?? defaults,
+        phones: input.phones ?? defaults,
+        emails: input.emails ?? { ...defaults, types: ["personal", "business"] },
+        socials: input.socials ?? defaults,
+        companies: input.companies ?? defaults,
+    };
+    return executeEphemeralAction("DataEnrichment", input, actionSettings);
+}
+//# sourceMappingURL=enrich-profile.js.map

package/dist/operations/enrich-profile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"enrich-profile.js","sourceRoot":"","sources":["../../src/operations/enrich-profile.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,oCAAoC;AAGpC,OAAO,EACL,sBAAsB,GAEvB,MAAM,uBAAuB,CAAC;AAmB/B,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,KAAyB;IAEzB,MAAM,QAAQ,GAAuB,EAAE,YAAY,EAAE,KAAK,EAAE,CAAC;IAC7D,MAAM,cAAc,GAAmB;QACrC,WAAW,EAAE,KAAK,CAAC,WAAW,IAAI,QAAQ;QAC1C,MAAM,EAAE,KAAK,CAAC,MAAM,IAAI,QAAQ;QAChC,MAAM,EAAE,KAAK,CAAC,MAAM,IAAI,EAAE,GAAG,QAAQ,EAAE,KAAK,EAAE,CAAC,UAAU,EAAE,UAAU,CAAC,EAAE;QACxE,OAAO,EAAE,KAAK,CAAC,OAAO,IAAI,QAAQ;QAClC,SAAS,EAAE,KAAK,CAAC,SAAS,IAAI,QAAQ;KACvC,CAAC;IAEF,OAAO,sBAAsB,CAAC,gBAAgB,EAAE,KAAK,EAAE,cAAc,CAAC,CAAC;AACzE,CAAC"}

package/dist/operations/ephemeral-action.d.ts

@@ -0,0 +1,22 @@
+import type { ActionSettings, EphemeralActionResult } from "../types/index.js";
+import type { ConnectionOptions } from "./types.js";
+/**
+ * Shared input fields for all ephemeral action operations.
+ *
+ * Each individual action operation extends this with action-specific
+ * parameters.
+ */
+export interface EphemeralActionInput extends ConnectionOptions {
+    readonly personId?: number | undefined;
+    readonly url?: string | undefined;
+    readonly keepCampaign?: boolean | undefined;
+}
+/**
+ * Execute a single action on a single person via the ephemeral campaign
+ * service.
+ *
+ * Shared helper used by all individual action operations
+ * (message-person, send-invite, etc.).
+ */
+export declare function executeEphemeralAction(actionType: string, input: EphemeralActionInput, actionSettings?: ActionSettings): Promise<EphemeralActionResult>;
+//# sourceMappingURL=ephemeral-action.d.ts.map

package/dist/operations/ephemeral-action.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ephemeral-action.d.ts","sourceRoot":"","sources":["../../src/operations/ephemeral-action.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAK/E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEpD;;;;;GAKG;AACH,MAAM,WAAW,oBAAqB,SAAQ,iBAAiB;IAC7D,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACvC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CAC7C;AAED;;;;;;GAMG;AACH,wBAAsB,sBAAsB,CAC1C,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,oBAAoB,EAC3B,cAAc,CAAC,EAAE,cAAc,GAC9B,OAAO,CAAC,qBAAqB,CAAC,CAmBhC"}

package/dist/operations/ephemeral-action.js

@@ -0,0 +1,31 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+import { resolveAccount } from "../services/account-resolution.js";
+import { withInstanceDatabase } from "../services/instance-context.js";
+import { EphemeralCampaignService } from "../services/ephemeral-campaign.js";
+import { DEFAULT_CDP_PORT } from "../constants.js";
+/**
+ * Execute a single action on a single person via the ephemeral campaign
+ * service.
+ *
+ * Shared helper used by all individual action operations
+ * (message-person, send-invite, etc.).
+ */
+export async function executeEphemeralAction(actionType, input, actionSettings) {
+    if ((input.personId == null) === (input.url == null)) {
+        throw new Error("Exactly one of personId or url must be provided");
+    }
+    const target = input.personId ?? input.url;
+    const cdpPort = input.cdpPort ?? DEFAULT_CDP_PORT;
+    const accountId = await resolveAccount(cdpPort, {
+        ...(input.cdpHost !== undefined && { host: input.cdpHost }),
+        ...(input.allowRemote !== undefined && { allowRemote: input.allowRemote }),
+    });
+    return withInstanceDatabase(cdpPort, accountId, async ({ instance, db }) => {
+        const ephemeral = new EphemeralCampaignService(instance, db);
+        return ephemeral.execute(actionType, target, actionSettings, {
+            ...(input.keepCampaign !== undefined && { keepCampaign: input.keepCampaign }),
+        });
+    });
+}
+//# sourceMappingURL=ephemeral-action.js.map

package/dist/operations/ephemeral-action.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ephemeral-action.js","sourceRoot":"","sources":["../../src/operations/ephemeral-action.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,oCAAoC;AAGpC,OAAO,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AACvE,OAAO,EAAE,wBAAwB,EAAE,MAAM,mCAAmC,CAAC;AAC7E,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAenD;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,UAAkB,EAClB,KAA2B,EAC3B,cAA+B;IAE/B,IAAI,CAAC,KAAK,CAAC,QAAQ,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,IAAI,IAAI,CAAC,EAAE,CAAC;QACrD,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;IACrE,CAAC;IAED,MAAM,MAAM,GAAoB,KAAK,CAAC,QAAQ,IAAK,KAAK,CAAC,GAAc,CAAC;IACxE,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,IAAI,gBAAgB,CAAC;IAElD,MAAM,SAAS,GAAG,MAAM,cAAc,CAAC,OAAO,EAAE;QAC9C,GAAG,CAAC,KAAK,CAAC,OAAO,KAAK,SAAS,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC;QAC3D,GAAG,CAAC,KAAK,CAAC,WAAW,KAAK,SAAS,IAAI,EAAE,WAAW,EAAE,KAAK,CAAC,WAAW,EAAE,CAAC;KAC3E,CAAC,CAAC;IAEH,OAAO,oBAAoB,CAAC,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,EAAE,EAAE;QACzE,MAAM,SAAS,GAAG,IAAI,wBAAwB,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;QAC7D,OAAO,SAAS,CAAC,OAAO,CAAC,UAAU,EAAE,MAAM,EAAE,cAAc,EAAE;YAC3D,GAAG,CAAC,KAAK,CAAC,YAAY,KAAK,SAAS,IAAI,EAAE,YAAY,EAAE,KAAK,CAAC,YAAY,EAAE,CAAC;SAC9E,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC"}