@lhremote/core 0.0.0 → 0.2.0

package/dist/testing/e2e-helpers.js

@@ -0,0 +1,114 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+import { describe } from "vitest";
+import { AppService } from "../services/app.js";
+import { AppNotFoundError } from "../services/errors.js";
+import { discoverTargets } from "../cdp/discovery.js";
+import { LauncherService } from "../services/launcher.js";
+import { delay } from "../utils/delay.js";
+const linkedHelperAvailable = (() => {
+    try {
+        AppService.findBinary();
+        return true;
+    }
+    catch (error) {
+        if (error instanceof AppNotFoundError) {
+            return false;
+        }
+        throw error;
+    }
+})();
+/**
+ * Wrapper around `describe.skipIf` that skips the suite when
+ * the LinkedHelper binary is not installed.
+ */
+export function describeE2E(name, fn) {
+    return describe.skipIf(!linkedHelperAvailable)(`${name} (e2e)`, fn);
+}
+/**
+ * Launch LinkedHelper and wait for the launcher to become fully ready.
+ *
+ * Readiness is verified in two phases:
+ * 1. The CDP HTTP endpoint (`/json/list`) returns at least one target.
+ * 2. A full `LauncherService` connection succeeds and can query accounts,
+ *    confirming the Electron renderer, `@electron/remote`, and the
+ *    electron-store are all operational.
+ *
+ * @param options.timeout Maximum ms to wait for full readiness (default 30 000).
+ */
+export async function launchApp(options) {
+    const timeout = options?.timeout ?? 30_000;
+    const app = new AppService(undefined, options?.appOptions);
+    await app.launch();
+    const port = app.cdpPort;
+    const deadline = Date.now() + timeout;
+    // Phase 1: Wait for CDP HTTP endpoint to expose targets
+    while (Date.now() < deadline) {
+        try {
+            const targets = await discoverTargets(port);
+            if (targets.length > 0)
+                break;
+        }
+        catch {
+            // Not ready yet
+        }
+        await delay(250);
+    }
+    // Phase 2: Wait for full launcher readiness (WebSocket + renderer loaded)
+    while (Date.now() < deadline) {
+        const launcher = new LauncherService(port);
+        try {
+            await launcher.connect();
+            await launcher.listAccounts();
+            launcher.disconnect();
+            return { app, port };
+        }
+        catch {
+            launcher.disconnect();
+        }
+        await delay(500);
+    }
+    // Clean up on timeout
+    try {
+        await app.quit();
+    }
+    catch {
+        // ignore
+    }
+    throw new Error(`LinkedHelper launcher did not become fully ready on port ${String(port)} within ${String(timeout)}ms`);
+}
+/**
+ * Quit LinkedHelper, swallowing errors for cleanup use.
+ */
+export async function quitApp(app) {
+    try {
+        await app.quit();
+    }
+    catch {
+        // Swallow errors during cleanup
+    }
+}
+/**
+ * Retry an async operation with configurable attempts and delay.
+ *
+ * Useful in E2E tests where CDP endpoints may be transiently
+ * unavailable during the LinkedHelper app lifecycle.
+ */
+export async function retryAsync(fn, options) {
+    const retries = options?.retries ?? 3;
+    const interval = options?.delay ?? 500;
+    let lastError;
+    for (let i = 0; i <= retries; i++) {
+        try {
+            return await fn();
+        }
+        catch (error) {
+            lastError = error;
+            if (i < retries) {
+                await delay(interval);
+            }
+        }
+    }
+    throw lastError;
+}
+//# sourceMappingURL=e2e-helpers.js.map

package/dist/testing/e2e-helpers.js.map

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

package/dist/testing/index.d.ts

@@ -0,0 +1,2 @@
+export { describeE2E, launchApp, type LaunchedApp, quitApp, retryAsync, } from "./e2e-helpers.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/testing/index.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,WAAW,EACX,SAAS,EACT,KAAK,WAAW,EAChB,OAAO,EACP,UAAU,GACX,MAAM,kBAAkB,CAAC"}

package/dist/testing/index.js

@@ -0,0 +1,4 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+export { describeE2E, launchApp, quitApp, retryAsync, } from "./e2e-helpers.js";
+//# sourceMappingURL=index.js.map

package/dist/testing/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/testing/index.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,oCAAoC;AAEpC,OAAO,EACL,WAAW,EACX,SAAS,EAET,OAAO,EACP,UAAU,GACX,MAAM,kBAAkB,CAAC"}

package/dist/types/account.d.ts

@@ -0,0 +1,13 @@
+/**
+ * A LinkedHelper account as stored in the Electron store.
+ *
+ * Each account corresponds to a LinkedIn identity managed by
+ * LinkedHelper and has its own database partition.
+ */
+export interface Account {
+    id: number;
+    liId: number;
+    name: string;
+    email?: string | undefined;
+}
+//# sourceMappingURL=account.d.ts.map

package/dist/types/account.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"account.d.ts","sourceRoot":"","sources":["../../src/types/account.ts"],"names":[],"mappings":"AAGA;;;;;GAKG;AACH,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC5B"}

package/dist/types/account.js

@@ -0,0 +1,4 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+export {};
+//# sourceMappingURL=account.js.map

package/dist/types/account.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"account.js","sourceRoot":"","sources":["../../src/types/account.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,oCAAoC"}

package/dist/types/account.test.d.ts

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

package/dist/types/account.test.d.ts.map

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

package/dist/types/account.test.js

@@ -0,0 +1,26 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+import { describe, expect, it } from "vitest";
+describe("Account type", () => {
+    it("should allow constructing a full Account", () => {
+        const account = {
+            id: 1,
+            liId: 363386,
+            name: "Test Account",
+            email: "test@example.com",
+        };
+        expect(account.id).toBe(1);
+        expect(account.liId).toBe(363386);
+        expect(account.name).toBe("Test Account");
+        expect(account.email).toBe("test@example.com");
+    });
+    it("should allow Account without optional email", () => {
+        const account = {
+            id: 2,
+            liId: 100000,
+            name: "No Email",
+        };
+        expect(account.email).toBeUndefined();
+    });
+});
+//# sourceMappingURL=account.test.js.map

package/dist/types/account.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"account.test.js","sourceRoot":"","sources":["../../src/types/account.test.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,oCAAoC;AAEpC,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAG9C,QAAQ,CAAC,cAAc,EAAE,GAAG,EAAE;IAC5B,EAAE,CAAC,0CAA0C,EAAE,GAAG,EAAE;QAClD,MAAM,OAAO,GAAY;YACvB,EAAE,EAAE,CAAC;YACL,IAAI,EAAE,MAAM;YACZ,IAAI,EAAE,cAAc;YACpB,KAAK,EAAE,kBAAkB;SAC1B,CAAC;QAEF,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC3B,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAClC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QAC1C,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;IACjD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6CAA6C,EAAE,GAAG,EAAE;QACrD,MAAM,OAAO,GAAY;YACvB,EAAE,EAAE,CAAC;YACL,IAAI,EAAE,MAAM;YACZ,IAAI,EAAE,UAAU;SACjB,CAAC;QAEF,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,aAAa,EAAE,CAAC;IACxC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/types/campaign.d.ts

@@ -0,0 +1,267 @@
+/**
+ * Campaign state enumeration.
+ */
+export type CampaignState = "active" | "paused" | "archived" | "invalid";
+/**
+ * Summary view of a campaign for list operations.
+ */
+export interface CampaignSummary {
+    id: number;
+    name: string;
+    description: string | null;
+    state: CampaignState;
+    liAccountId: number;
+    actionCount: number;
+    createdAt: string;
+}
+/**
+ * Full campaign with metadata.
+ */
+export interface Campaign {
+    id: number;
+    name: string;
+    description: string | null;
+    state: CampaignState;
+    liAccountId: number;
+    isPaused: boolean;
+    isArchived: boolean;
+    isValid: boolean | null;
+    createdAt: string;
+}
+/**
+ * Action configuration settings (stored as JSON in database).
+ */
+export interface ActionSettings {
+    [key: string]: unknown;
+}
+/**
+ * Action configuration.
+ */
+export interface ActionConfig {
+    id: number;
+    actionType: string;
+    actionSettings: ActionSettings;
+    coolDown: number;
+    maxActionResultsPerIteration: number;
+    isDraft: boolean;
+}
+/**
+ * Campaign action definition.
+ */
+export interface CampaignAction {
+    id: number;
+    campaignId: number;
+    name: string;
+    description: string | null;
+    config: ActionConfig;
+    versionId: number;
+}
+/**
+ * Result of a campaign action execution.
+ */
+export interface CampaignActionResult {
+    id: number;
+    actionVersionId: number;
+    personId: number;
+    result: number;
+    platform: string | null;
+    createdAt: string;
+}
+/**
+ * Person target state in a campaign action.
+ */
+export interface ActionTargetPerson {
+    actionId: number;
+    actionVersionId: number;
+    personId: number;
+    state: number;
+    liAccountId: number;
+}
+/**
+ * Options for listing campaigns.
+ */
+export interface ListCampaignsOptions {
+    includeArchived?: boolean;
+}
+/**
+ * Options for getting action results.
+ */
+export interface GetResultsOptions {
+    limit?: number;
+}
+/**
+ * Configuration for creating a new campaign.
+ */
+export interface CampaignConfig {
+    /** Campaign name. */
+    name: string;
+    /** Optional description. */
+    description?: string;
+    /** LinkedIn account ID (default: 1). */
+    liAccountId?: number;
+    /** Actions to include in the campaign. */
+    actions: CampaignActionConfig[];
+}
+/**
+ * Configuration for a single action within a campaign.
+ */
+export interface CampaignActionConfig {
+    /** Display name for the action. */
+    name: string;
+    /** Optional description. */
+    description?: string;
+    /** Action type identifier (e.g., 'VisitAndExtract', 'MessageToPerson'). */
+    actionType: string;
+    /** Milliseconds between action executions (default: 60000). */
+    coolDown?: number;
+    /** Maximum results per iteration (default: 10, -1 for unlimited). */
+    maxActionResultsPerIteration?: number;
+    /** Action-specific settings. */
+    actionSettings?: ActionSettings;
+}
+/**
+ * Runner state of the LinkedHelper main window.
+ */
+export type RunnerState = "idle" | "campaigns" | "stopping-campaigns";
+/**
+ * People counts for a campaign action by processing state.
+ */
+export interface ActionPeopleCounts {
+    /** Action ID. */
+    actionId: number;
+    /** Number of people queued (state=1). */
+    queued: number;
+    /** Number of people processed (state=2). */
+    processed: number;
+    /** Number of successful executions (state=3). */
+    successful: number;
+    /** Number of failed executions (state=4). */
+    failed: number;
+}
+/**
+ * Real-time campaign execution status.
+ */
+export interface CampaignStatus {
+    /** Campaign database record state. */
+    campaignState: CampaignState;
+    /** Whether the campaign is currently paused. */
+    isPaused: boolean;
+    /** Main window runner state. */
+    runnerState: RunnerState;
+    /** Per-action people counts. */
+    actionCounts: ActionPeopleCounts[];
+}
+/**
+ * Result of importing people into a campaign action from LinkedIn URLs.
+ */
+export interface ImportPeopleResult {
+    /** Action ID the people were imported into. */
+    actionId: number;
+    /** Number of people successfully added. */
+    successful: number;
+    /** Number of people already in the target queue. */
+    alreadyInQueue: number;
+    /** Number of people already processed. */
+    alreadyProcessed: number;
+    /** Number of URLs that failed to import. */
+    failed: number;
+}
+/**
+ * Configuration for updating an existing campaign.
+ *
+ * At least one field must be provided.
+ */
+export interface CampaignUpdateConfig {
+    /** New campaign name. */
+    name?: string;
+    /** New campaign description (null to clear). */
+    description?: string | null;
+}
+/**
+ * Aggregated results from a campaign run.
+ */
+export interface CampaignRunResult {
+    /** Campaign ID. */
+    campaignId: number;
+    /** All action results from the database. */
+    results: CampaignActionResult[];
+    /** Per-action people counts (live from CDP). */
+    actionCounts: ActionPeopleCounts[];
+}
+/**
+ * An entry in an exclude list (campaign-level or action-level).
+ */
+export interface ExcludeListEntry {
+    /** Internal person ID. */
+    personId: number;
+}
+/**
+ * Per-action result breakdown in campaign statistics.
+ */
+export interface ActionStatistics {
+    /** Action ID. */
+    actionId: number;
+    /** Action name. */
+    actionName: string;
+    /** Action type identifier. */
+    actionType: string;
+    /** Number of successful results (result=1). */
+    successful: number;
+    /** Number of reply results (result=2). */
+    replied: number;
+    /** Number of failed results (result=-1). */
+    failed: number;
+    /** Number of skipped results (result=-2). */
+    skipped: number;
+    /** Total results for this action. */
+    total: number;
+    /** Success rate as a percentage (0-100). */
+    successRate: number;
+    /** Earliest result timestamp for this action. */
+    firstResultAt: string | null;
+    /** Latest result timestamp for this action. */
+    lastResultAt: string | null;
+    /** Top error codes for this action, ordered by frequency. */
+    topErrors: ActionErrorSummary[];
+}
+/**
+ * Summary of a single error code within action statistics.
+ */
+export interface ActionErrorSummary {
+    /** Numeric error code. */
+    code: number;
+    /** Number of occurrences. */
+    count: number;
+    /** Whether this was an exception. */
+    isException: boolean;
+    /** Blame attribution: "LH", "LinkedIn", or "Proxy". */
+    whoToBlame: string;
+}
+/**
+ * Options for getting campaign statistics.
+ */
+export interface GetStatisticsOptions {
+    /** Filter to a specific action ID. */
+    actionId?: number;
+    /** Maximum number of top errors per action (default: 5). */
+    maxErrors?: number;
+}
+/**
+ * Campaign-wide statistics with per-action breakdowns.
+ */
+export interface CampaignStatistics {
+    /** Campaign ID. */
+    campaignId: number;
+    /** Per-action statistics. */
+    actions: ActionStatistics[];
+    /** Campaign-wide totals. */
+    totals: {
+        successful: number;
+        replied: number;
+        failed: number;
+        skipped: number;
+        total: number;
+        successRate: number;
+    };
+}
+//# sourceMappingURL=campaign.d.ts.map

package/dist/types/campaign.d.ts.map

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

package/dist/types/campaign.js

@@ -0,0 +1,4 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+export {};
+//# sourceMappingURL=campaign.js.map

package/dist/types/campaign.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"campaign.js","sourceRoot":"","sources":["../../src/types/campaign.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,oCAAoC"}

package/dist/types/cdp.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Entry returned by Chrome's HTTP `/json/list` debugging endpoint.
+ *
+ * This is NOT part of the CDP protocol itself — it's Chrome's proprietary
+ * HTTP interface for target discovery.  For protocol-level types
+ * (Runtime, Page, Target, etc.) use `devtools-protocol` directly.
+ */
+export interface CdpTarget {
+    description: string;
+    devtoolsFrontendUrl: string;
+    id: string;
+    title: string;
+    type: string;
+    url: string;
+    /** Missing when another debugger client is already attached. */
+    webSocketDebuggerUrl?: string | undefined;
+}
+//# sourceMappingURL=cdp.d.ts.map

package/dist/types/cdp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cdp.d.ts","sourceRoot":"","sources":["../../src/types/cdp.ts"],"names":[],"mappings":"AAGA;;;;;;GAMG;AACH,MAAM,WAAW,SAAS;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,gEAAgE;IAChE,oBAAoB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC3C"}

package/dist/types/cdp.js

@@ -0,0 +1,4 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+export {};
+//# sourceMappingURL=cdp.js.map

package/dist/types/cdp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cdp.js","sourceRoot":"","sources":["../../src/types/cdp.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,oCAAoC"}

package/dist/types/cdp.test.d.ts

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

package/dist/types/cdp.test.d.ts.map

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

package/dist/types/cdp.test.js

@@ -0,0 +1,30 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+import { describe, expect, it } from "vitest";
+describe("CDP types", () => {
+    it("should allow constructing a CdpTarget with webSocketDebuggerUrl", () => {
+        const target = {
+            description: "",
+            devtoolsFrontendUrl: "/devtools/inspector.html?ws=localhost:9222/devtools/page/ABC123",
+            id: "ABC123",
+            type: "page",
+            title: "LinkedHelper",
+            url: "chrome-extension://abc/index.html",
+            webSocketDebuggerUrl: "ws://localhost:9222/devtools/page/ABC123",
+        };
+        expect(target.type).toBe("page");
+        expect(target.webSocketDebuggerUrl).toContain("ws://");
+    });
+    it("should allow CdpTarget without webSocketDebuggerUrl (another client attached)", () => {
+        const target = {
+            description: "",
+            devtoolsFrontendUrl: "/devtools/inspector.html?ws=localhost:9222/devtools/page/DEF456",
+            id: "DEF456",
+            type: "page",
+            title: "LinkedHelper",
+            url: "chrome-extension://abc/index.html",
+        };
+        expect(target.webSocketDebuggerUrl).toBeUndefined();
+    });
+});
+//# sourceMappingURL=cdp.test.js.map

package/dist/types/cdp.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cdp.test.js","sourceRoot":"","sources":["../../src/types/cdp.test.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,oCAAoC;AAEpC,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAG9C,QAAQ,CAAC,WAAW,EAAE,GAAG,EAAE;IACzB,EAAE,CAAC,iEAAiE,EAAE,GAAG,EAAE;QACzE,MAAM,MAAM,GAAc;YACxB,WAAW,EAAE,EAAE;YACf,mBAAmB,EAAE,iEAAiE;YACtF,EAAE,EAAE,QAAQ;YACZ,IAAI,EAAE,MAAM;YACZ,KAAK,EAAE,cAAc;YACrB,GAAG,EAAE,mCAAmC;YACxC,oBAAoB,EAAE,0CAA0C;SACjE,CAAC;QAEF,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACjC,MAAM,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IACzD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+EAA+E,EAAE,GAAG,EAAE;QACvF,MAAM,MAAM,GAAc;YACxB,WAAW,EAAE,EAAE;YACf,mBAAmB,EAAE,iEAAiE;YACtF,EAAE,EAAE,QAAQ;YACZ,IAAI,EAAE,MAAM;YACZ,KAAK,EAAE,cAAc;YACrB,GAAG,EAAE,mCAAmC;SACzC,CAAC;QAEF,MAAM,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC,aAAa,EAAE,CAAC;IACtD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/types/index.d.ts

@@ -0,0 +1,6 @@
+export type { CurrentPosition, Education, ExternalId, ExternalIdTypeGroup, MiniProfile, Position, Profile, ProfileSearchOptions, ProfileSearchResult, ProfileSummary, Skill, } from "./profile.js";
+export type { InstanceInfo, InstanceStatus, StartInstanceParams, StartInstanceResult, } from "./instance.js";
+export type { Account } from "./account.js";
+export type { Chat, ChatParticipant, ConversationMessages, ConversationThread, Message, MessageStats, MessageSummary, } from "./messaging.js";
+export type { ActionConfig, ActionErrorSummary, ActionPeopleCounts, ActionStatistics, CampaignActionConfig, CampaignActionResult, ActionSettings, ActionTargetPerson, Campaign, CampaignAction, CampaignConfig, CampaignRunResult, CampaignState, CampaignStatistics, CampaignUpdateConfig, ExcludeListEntry, GetResultsOptions, GetStatisticsOptions, ImportPeopleResult, CampaignStatus, CampaignSummary, ListCampaignsOptions, RunnerState, } from "./campaign.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAGA,YAAY,EACV,eAAe,EACf,SAAS,EACT,UAAU,EACV,mBAAmB,EACnB,WAAW,EACX,QAAQ,EACR,OAAO,EACP,oBAAoB,EACpB,mBAAmB,EACnB,cAAc,EACd,KAAK,GACN,MAAM,cAAc,CAAC;AAEtB,YAAY,EACV,YAAY,EACZ,cAAc,EACd,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,eAAe,CAAC;AAEvB,YAAY,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAE5C,YAAY,EACV,IAAI,EACJ,eAAe,EACf,oBAAoB,EACpB,kBAAkB,EAClB,OAAO,EACP,YAAY,EACZ,cAAc,GACf,MAAM,gBAAgB,CAAC;AAExB,YAAY,EACV,YAAY,EACZ,kBAAkB,EAClB,kBAAkB,EAClB,gBAAgB,EAChB,oBAAoB,EACpB,oBAAoB,EACpB,cAAc,EACd,kBAAkB,EAClB,QAAQ,EACR,cAAc,EACd,cAAc,EACd,iBAAiB,EACjB,aAAa,EACb,kBAAkB,EAClB,oBAAoB,EACpB,gBAAgB,EAChB,iBAAiB,EACjB,oBAAoB,EACpB,kBAAkB,EAClB,cAAc,EACd,eAAe,EACf,oBAAoB,EACpB,WAAW,GACZ,MAAM,eAAe,CAAC"}

package/dist/types/index.js

@@ -0,0 +1,4 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+export {};
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,oCAAoC"}

package/dist/types/instance.d.ts

@@ -0,0 +1,36 @@
+/**
+ * LinkedHelper instance lifecycle types.
+ *
+ * An "instance" is a running LinkedHelper browser session tied to a
+ * specific LinkedIn account.
+ */
+export interface StartInstanceParams {
+    linkedInAccount: {
+        id: number;
+        liId: number;
+    };
+    accountData: {
+        id: number;
+        liId: number;
+    };
+    instanceId: number;
+    proxy: null;
+    license: null;
+    userId: null;
+    frontendSettings: Record<string, unknown>;
+    lhAccount: Record<string, unknown>;
+    zoomDefault: number;
+    shouldBringToFront: boolean;
+    shouldStartRunningCampaigns: boolean;
+}
+export interface StartInstanceResult {
+    success: boolean;
+    error?: string | undefined;
+}
+export type InstanceStatus = "stopped" | "starting" | "running" | "stopping";
+export interface InstanceInfo {
+    instanceId: number;
+    status: InstanceStatus;
+    debuggerPort?: number | undefined;
+}
+//# sourceMappingURL=instance.d.ts.map

package/dist/types/instance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"instance.d.ts","sourceRoot":"","sources":["../../src/types/instance.ts"],"names":[],"mappings":"AAGA;;;;;GAKG;AAEH,MAAM,WAAW,mBAAmB;IAClC,eAAe,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IAC9C,WAAW,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IAC1C,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,IAAI,CAAC;IACZ,OAAO,EAAE,IAAI,CAAC;IACd,MAAM,EAAE,IAAI,CAAC;IACb,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC1C,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,WAAW,EAAE,MAAM,CAAC;IACpB,kBAAkB,EAAE,OAAO,CAAC;IAC5B,2BAA2B,EAAE,OAAO,CAAC;CACtC;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC5B;AAED,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,UAAU,GAAG,SAAS,GAAG,UAAU,CAAC;AAE7E,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,cAAc,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACnC"}

package/dist/types/instance.js

@@ -0,0 +1,4 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+export {};
+//# sourceMappingURL=instance.js.map

package/dist/types/instance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"instance.js","sourceRoot":"","sources":["../../src/types/instance.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,oCAAoC"}

package/dist/types/instance.test.d.ts

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

package/dist/types/instance.test.d.ts.map

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