@lhremote/core 0.0.0 → 0.2.0

package/dist/cdp/testing/launch-chromium.js

@@ -0,0 +1,93 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+import { spawn } from "node:child_process";
+import { createServer } from "node:net";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { chromium } from "playwright-core";
+import { discoverTargets } from "../discovery.js";
+import { delay } from "../../utils/delay.js";
+/**
+ * Find a free TCP port by briefly binding to port 0.
+ */
+async function findFreePort() {
+    return new Promise((resolve, reject) => {
+        const server = createServer();
+        server.listen(0, "127.0.0.1", () => {
+            const addr = server.address();
+            if (addr === null || typeof addr === "string") {
+                server.close();
+                reject(new Error("Failed to get port from server address"));
+                return;
+            }
+            const { port } = addr;
+            server.close(() => {
+                resolve(port);
+            });
+        });
+        server.on("error", reject);
+    });
+}
+/**
+ * Launch a headless Chromium instance with CDP enabled on a random free port.
+ *
+ * Uses the Chromium binary installed by `playwright-core`.  The instance
+ * is configured for test isolation (temp profile, no sandbox).
+ *
+ * @param options.timeout - Maximum time (ms) to wait for CDP to become
+ *   available (default 10 000).
+ * @returns A {@link ChromiumInstance} handle.
+ */
+export async function launchChromium(options) {
+    const timeout = options?.timeout ?? 10_000;
+    const port = await findFreePort();
+    const userDataDir = join(tmpdir(), `lhremote-cdp-test-${port.toString()}-${Date.now().toString(36)}`);
+    const executablePath = chromium.executablePath();
+    const child = spawn(executablePath, [
+        `--remote-debugging-port=${port.toString()}`,
+        `--user-data-dir=${userDataDir}`,
+        "--headless",
+        "--no-sandbox",
+        "--disable-gpu",
+        "--disable-extensions",
+        "--use-mock-keychain",
+    ], { stdio: "ignore" });
+    // Wait for CDP endpoint to become available
+    const deadline = Date.now() + timeout;
+    let ready = false;
+    while (Date.now() < deadline) {
+        try {
+            const targets = await discoverTargets(port);
+            if (targets.length > 0) {
+                ready = true;
+                break;
+            }
+        }
+        catch {
+            // Not ready yet
+        }
+        await delay(100);
+    }
+    if (!ready) {
+        child.kill("SIGKILL");
+        throw new Error(`Chromium CDP endpoint did not become available on port ${port.toString()} within ${timeout.toString()}ms`);
+    }
+    const close = async () => {
+        if (child.exitCode !== null) {
+            return;
+        }
+        child.kill("SIGTERM");
+        await new Promise((resolve) => {
+            const timer = setTimeout(() => {
+                child.kill("SIGKILL");
+                resolve();
+            }, 5_000);
+            child.on("exit", () => {
+                clearTimeout(timer);
+                resolve();
+            });
+        });
+    };
+    return { port, process: child, close };
+}
+//# sourceMappingURL=launch-chromium.js.map

package/dist/cdp/testing/launch-chromium.js.map

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

package/dist/constants.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Default CDP port used by the LinkedHelper launcher process.
+ */
+export declare const DEFAULT_CDP_PORT = 9222;
+//# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,eAAO,MAAM,gBAAgB,OAAO,CAAC"}

package/dist/constants.js

@@ -0,0 +1,7 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+/**
+ * Default CDP port used by the LinkedHelper launcher process.
+ */
+export const DEFAULT_CDP_PORT = 9222;
+//# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,oCAAoC;AAEpC;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,IAAI,CAAC"}

package/dist/data/action-types.d.ts

@@ -0,0 +1,39 @@
+/**
+ * LinkedHelper action type identifiers.
+ *
+ * These correspond to the `actionType` column in the `action_configs` table.
+ */
+export type ActionType = "CheckForReplies" | "DataEnrichment" | "EndorseSkills" | "FilterContactsOutOfMyNetwork" | "Follow" | "InMail" | "InvitePerson" | "MessageToPerson" | "PersonPostsLiker" | "RemoveFromFirstConnection" | "ScrapeMessagingHistory" | "VisitAndExtract" | "Waiter";
+/** Action category grouping. */
+export type ActionCategory = "people" | "messaging" | "engagement" | "crm" | "workflow";
+/** Schema for a single configuration field. */
+export interface ConfigFieldSchema {
+    type: "string" | "number" | "boolean" | "array" | "object";
+    required: boolean;
+    description: string;
+    default?: unknown;
+}
+/** Metadata about a single action type. */
+export interface ActionTypeInfo {
+    name: ActionType;
+    description: string;
+    category: ActionCategory;
+    configSchema: Record<string, ConfigFieldSchema>;
+    example?: Record<string, unknown>;
+}
+/** Return type for catalog queries. */
+export interface ActionTypeCatalog {
+    actionTypes: ActionTypeInfo[];
+}
+/**
+ * Get the action types catalog, optionally filtered by category.
+ */
+export declare function getActionTypeCatalog(category?: ActionCategory): ActionTypeCatalog;
+/**
+ * Get metadata for a single action type.
+ *
+ * @returns The action type info, or `undefined` if the type is unknown.
+ */
+export declare function getActionTypeInfo(actionType: ActionType): Readonly<ActionTypeInfo>;
+export declare function getActionTypeInfo(actionType: string): Readonly<ActionTypeInfo> | undefined;
+//# sourceMappingURL=action-types.d.ts.map

package/dist/data/action-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"action-types.d.ts","sourceRoot":"","sources":["../../src/data/action-types.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AACH,MAAM,MAAM,UAAU,GAClB,iBAAiB,GACjB,gBAAgB,GAChB,eAAe,GACf,8BAA8B,GAC9B,QAAQ,GACR,QAAQ,GACR,cAAc,GACd,iBAAiB,GACjB,kBAAkB,GAClB,2BAA2B,GAC3B,wBAAwB,GACxB,iBAAiB,GACjB,QAAQ,CAAC;AAEb,gCAAgC;AAChC,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,WAAW,GAAG,YAAY,GAAG,KAAK,GAAG,UAAU,CAAC;AAExF,+CAA+C;AAC/C,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,OAAO,GAAG,QAAQ,CAAC;IAC3D,QAAQ,EAAE,OAAO,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,2CAA2C;AAC3C,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,UAAU,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,cAAc,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;IAChD,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED,uCAAuC;AACvC,MAAM,WAAW,iBAAiB;IAChC,WAAW,EAAE,cAAc,EAAE,CAAC;CAC/B;AA0gBD;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,CAAC,EAAE,cAAc,GAAG,iBAAiB,CAQjF;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,UAAU,GACrB,QAAQ,CAAC,cAAc,CAAC,CAAC;AAC5B,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,MAAM,GACjB,QAAQ,CAAC,cAAc,CAAC,GAAG,SAAS,CAAC"}

package/dist/data/action-types.js

@@ -0,0 +1,497 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+const ACTION_TYPE_INFOS = [
+    {
+        name: "VisitAndExtract",
+        description: "Visit a LinkedIn profile and extract data (name, positions, education, skills).",
+        category: "people",
+        configSchema: {
+            extractCurrentOrganizations: {
+                type: "boolean",
+                required: false,
+                description: "Extract current company info during profile visit.",
+            },
+        },
+        example: { extractCurrentOrganizations: true },
+    },
+    {
+        name: "MessageToPerson",
+        description: "Send a direct message to a 1st-degree connection.",
+        category: "messaging",
+        configSchema: {
+            messageTemplate: {
+                type: "object",
+                required: true,
+                description: "Message template with variable substitution support (e.g., {firstName}).",
+            },
+            subjectTemplate: {
+                type: "object",
+                required: false,
+                description: "Optional subject line template for the message.",
+            },
+            rejectIfReplied: {
+                type: "boolean",
+                required: false,
+                description: "Skip person if they already replied in this campaign.",
+                default: false,
+            },
+            rejectIfMessaged: {
+                type: "boolean",
+                required: false,
+                description: "Skip person if a message was already sent to them.",
+                default: false,
+            },
+            rejectIfRepliedWithinCampaign: {
+                type: "boolean",
+                required: false,
+                description: "Skip person if they replied within the current campaign.",
+                default: false,
+            },
+            rejectIfMessagedAfterPreviousCampaignMessage: {
+                type: "boolean",
+                required: false,
+                description: "Skip person if they were messaged after a previous campaign message.",
+                default: false,
+            },
+            textInputMethod: {
+                type: "string",
+                required: false,
+                description: 'How to input text — "insert", "type", or "random".',
+            },
+        },
+        example: {
+            messageTemplate: {
+                type: "variants",
+                variants: [
+                    {
+                        type: "variant",
+                        child: {
+                            type: "group",
+                            children: [
+                                { type: "text", value: "Hello " },
+                                { type: "var", name: "firstName" },
+                            ],
+                        },
+                    },
+                ],
+            },
+            rejectIfReplied: false,
+        },
+    },
+    {
+        name: "InMail",
+        description: "Send an InMail message to a LinkedIn member (does not require a connection).",
+        category: "messaging",
+        configSchema: {
+            messageTemplate: {
+                type: "object",
+                required: true,
+                description: "InMail body template with variable substitution support.",
+            },
+            subjectTemplate: {
+                type: "object",
+                required: false,
+                description: "InMail subject line template.",
+            },
+            rejectIfReplied: {
+                type: "boolean",
+                required: false,
+                description: "Skip person if they already replied.",
+                default: false,
+            },
+            rejectIfRepliedWithinCampaign: {
+                type: "boolean",
+                required: false,
+                description: "Skip if person replied within this campaign.",
+            },
+            proceedOnOutOfCredits: {
+                type: "boolean",
+                required: false,
+                description: "Continue processing even when InMail credits are exhausted.",
+            },
+            textInputMethod: {
+                type: "string",
+                required: false,
+                description: 'How to input text — "insert", "type", or "random".',
+            },
+        },
+        example: {
+            messageTemplate: {
+                type: "variants",
+                variants: [
+                    {
+                        type: "variant",
+                        child: {
+                            type: "group",
+                            children: [
+                                { type: "text", value: "Hi " },
+                                { type: "var", name: "firstName" },
+                                { type: "text", value: ", message body here" },
+                            ],
+                        },
+                    },
+                ],
+            },
+            subjectTemplate: {
+                type: "group",
+                children: [
+                    { type: "text", value: "Subject line here" },
+                ],
+            },
+            rejectIfRepliedWithinCampaign: false,
+        },
+    },
+    {
+        name: "InvitePerson",
+        description: "Send a connection request to a LinkedIn member.",
+        category: "people",
+        configSchema: {
+            messageTemplate: {
+                type: "object",
+                required: true,
+                description: "Invitation message template with variable substitution (can be empty for no message).",
+            },
+            saveAsLeadSN: {
+                type: "boolean",
+                required: true,
+                description: "Save as lead in Sales Navigator.",
+            },
+            emailCustomFieldName: {
+                type: "string",
+                required: false,
+                description: "Custom field name for email (null if not used).",
+            },
+            textInputMethod: {
+                type: "string",
+                required: false,
+                description: 'How to input text — "insert", "type", or "random".',
+            },
+            goOverWeeklyInvitationLimit: {
+                type: "boolean",
+                required: false,
+                description: "Continue sending invitations even if the weekly invite limit is reached.",
+            },
+            extractEmailFromPAS: {
+                type: "boolean",
+                required: false,
+                description: "Extract email from the People Also Searched section.",
+            },
+            invitePersonByEmail: {
+                type: "boolean",
+                required: false,
+                description: "Invite by email instead of LinkedIn.",
+            },
+        },
+        example: {
+            messageTemplate: {
+                type: "variants",
+                variants: [
+                    {
+                        type: "variant",
+                        child: {
+                            type: "group",
+                            children: [
+                                { type: "text", value: "Hi " },
+                                { type: "var", name: "firstName" },
+                                {
+                                    type: "text",
+                                    value: ", I'd like to add you to my network.",
+                                },
+                            ],
+                        },
+                    },
+                ],
+            },
+            saveAsLeadSN: false,
+            extractEmailFromPAS: true,
+            emailCustomFieldName: null,
+        },
+    },
+    {
+        name: "Follow",
+        description: "Follow or unfollow a LinkedIn profile.",
+        category: "engagement",
+        configSchema: {
+            mode: {
+                type: "string",
+                required: false,
+                description: 'Follow or unfollow the person. Must be "follow" or "unfollow" (default: follow).',
+                default: "follow",
+            },
+            skipIfUnfollowable: {
+                type: "boolean",
+                required: true,
+                description: "Skip if person can't be unfollowed.",
+            },
+        },
+        example: { mode: "follow", skipIfUnfollowable: true },
+    },
+    {
+        name: "EndorseSkills",
+        description: "Endorse skills listed on a LinkedIn profile.",
+        category: "engagement",
+        configSchema: {
+            skillNames: {
+                type: "array",
+                required: false,
+                description: "Specific skill names to endorse (mutually exclusive with limit).",
+            },
+            limit: {
+                type: "number",
+                required: false,
+                description: "Max number of skills to endorse (mutually exclusive with skillNames).",
+            },
+            skipIfNotEndorsable: {
+                type: "boolean",
+                required: true,
+                description: "Skip if person has no endorsable skills.",
+            },
+        },
+        example: { limit: 3, skipIfNotEndorsable: true },
+    },
+    {
+        name: "CheckForReplies",
+        description: "Check for new message replies from contacts in the campaign.",
+        category: "messaging",
+        configSchema: {
+            moveToSuccessfulAfterMs: {
+                type: "number",
+                required: true,
+                description: "Auto-mark as successful after N milliseconds without a reply (null = never).",
+            },
+            treatMessageAcceptedAsReply: {
+                type: "boolean",
+                required: false,
+                description: "Count message acceptance as a reply.",
+            },
+            keepInQueueIfRequestIsNotAccepted: {
+                type: "boolean",
+                required: false,
+                description: "Keep checking if the connection request has not yet been accepted.",
+            },
+        },
+        example: {
+            moveToSuccessfulAfterMs: 86400000,
+            treatMessageAcceptedAsReply: false,
+            keepInQueueIfRequestIsNotAccepted: true,
+        },
+    },
+    {
+        name: "ScrapeMessagingHistory",
+        description: "Scrape all messaging history for the LinkedIn account.",
+        category: "messaging",
+        configSchema: {
+            delays: {
+                type: "object",
+                required: false,
+                description: "Per-step delay overrides (typePersonFullName, selectFoundPerson, sleepAfterScrollChatHistory, navigateToMessagingPage, navigateToProfile).",
+            },
+        },
+        example: {},
+    },
+    {
+        name: "Waiter",
+        description: "Pause the campaign pipeline for a configured delay before proceeding to the next action.",
+        category: "workflow",
+        configSchema: {
+            delay: {
+                type: "number",
+                required: true,
+                description: "Delay in hours before proceeding to the next action (min 0).",
+            },
+        },
+        example: { delay: 24 },
+    },
+    {
+        name: "DataEnrichment",
+        description: "Enrich profile data by extracting additional information from LinkedIn.",
+        category: "crm",
+        configSchema: {
+            profileInfo: {
+                type: "object",
+                required: true,
+                description: "Enrich profile info ({shouldEnrich: boolean, actualDate?: number}).",
+            },
+            phones: {
+                type: "object",
+                required: true,
+                description: "Enrich phone numbers ({shouldEnrich: boolean, actualDate?: number}).",
+            },
+            emails: {
+                type: "object",
+                required: true,
+                description: 'Enrich email addresses ({shouldEnrich: boolean, actualDate?: number, types: ["personal","business"]}).',
+            },
+            socials: {
+                type: "object",
+                required: true,
+                description: "Enrich social profiles ({shouldEnrich: boolean, actualDate?: number}).",
+            },
+            companies: {
+                type: "object",
+                required: true,
+                description: "Enrich company data ({shouldEnrich: boolean, actualDate?: number}).",
+            },
+            actualDate: {
+                type: "number",
+                required: false,
+                description: "Only enrich data newer than this timestamp (min 0).",
+            },
+        },
+        example: {
+            profileInfo: { shouldEnrich: false },
+            phones: { shouldEnrich: false },
+            emails: { shouldEnrich: false, types: ["personal", "business"] },
+            socials: { shouldEnrich: false },
+            companies: { shouldEnrich: true },
+        },
+    },
+    {
+        name: "PersonPostsLiker",
+        description: "Like and comment on posts and articles by a LinkedIn profile.",
+        category: "engagement",
+        configSchema: {
+            numberOfArticles: {
+                type: "number",
+                required: false,
+                description: "Number of articles to like. At least one of numberOfArticles or numberOfPosts must be > 0.",
+            },
+            numberOfPosts: {
+                type: "number",
+                required: false,
+                description: "Number of posts to like. At least one of numberOfArticles or numberOfPosts must be > 0.",
+            },
+            maxAgeOfArticles: {
+                type: "number",
+                required: false,
+                description: "Maximum age of articles in days (min 0).",
+            },
+            maxAgeOfPosts: {
+                type: "number",
+                required: false,
+                description: "Maximum age of posts in days (min 0).",
+            },
+            textInputMethod: {
+                type: "string",
+                required: false,
+                description: 'How to input comment text — "insert", "type", or "random".',
+            },
+            skipIfNotLiked: {
+                type: "boolean",
+                required: true,
+                description: "Skip if nothing was liked.",
+            },
+            shouldAddComment: {
+                type: "boolean",
+                required: false,
+                description: "Also add a comment to liked posts/articles.",
+            },
+            messageTemplate: {
+                type: "object",
+                required: false,
+                description: "Comment text template (required when shouldAddComment is true). Uses variable substitution.",
+            },
+        },
+        example: {
+            numberOfArticles: 2,
+            numberOfPosts: 2,
+            messageTemplate: {
+                type: "variants",
+                variants: [
+                    {
+                        type: "variant",
+                        child: {
+                            type: "group",
+                            children: [
+                                { type: "var", name: "firstName" },
+                                { type: "text", value: ", thanks for sharing!" },
+                            ],
+                        },
+                    },
+                ],
+            },
+            skipIfNotLiked: true,
+        },
+    },
+    {
+        name: "RemoveFromFirstConnection",
+        description: "Remove a person from 1st-degree connections (unfriend).",
+        category: "people",
+        configSchema: {
+            delays: {
+                type: "object",
+                required: false,
+                description: "Per-step delay overrides (navigateToProfile, clickOnMoreButton, clickOnRemoveConnectionButton).",
+            },
+        },
+    },
+    {
+        name: "FilterContactsOutOfMyNetwork",
+        description: "Filter out contacts who are no longer in your network (e.g., withdrawn invitations, removed connections).",
+        category: "crm",
+        configSchema: {
+            maxScrollDepth: {
+                type: "number",
+                required: false,
+                description: "Maximum scroll depth when browsing connections (min 0).",
+            },
+            checkUntil: {
+                type: "string",
+                required: false,
+                description: 'When to stop checking — "PreviouslyFound" or "FirstInviteDate".',
+            },
+            launchAutoAcceptInvites: {
+                type: "boolean",
+                required: false,
+                description: "Auto-accept pending invitations.",
+            },
+            launchAutoCancelInvites: {
+                type: "boolean",
+                required: false,
+                description: "Auto-cancel old pending invitations.",
+            },
+            cancelInvitesOlderThan: {
+                type: "number",
+                required: false,
+                description: "Cancel invites older than N milliseconds (required when launchAutoCancelInvites is true, min 1).",
+            },
+        },
+        example: {
+            maxScrollDepth: 200,
+            checkUntil: "PreviouslyFound",
+            cancelInvitesOlderThan: 2592000000,
+            launchAutoAcceptInvites: false,
+            launchAutoCancelInvites: true,
+        },
+    },
+];
+/** Deep-freeze an object and all nested objects. */
+function deepFreeze(obj) {
+    for (const value of Object.values(obj)) {
+        if (value !== null && typeof value === "object" && !Object.isFrozen(value)) {
+            deepFreeze(value);
+        }
+    }
+    return Object.freeze(obj);
+}
+// Freeze all catalog entries so consumers cannot mutate the shared static data.
+for (const info of ACTION_TYPE_INFOS) {
+    deepFreeze(info);
+}
+/** Map for O(1) lookup by action type name. */
+const ACTION_TYPE_MAP = new Map(ACTION_TYPE_INFOS.map((info) => [info.name, info]));
+/**
+ * Get the action types catalog, optionally filtered by category.
+ */
+export function getActionTypeCatalog(category) {
+    if (category === undefined) {
+        return { actionTypes: [...ACTION_TYPE_INFOS] };
+    }
+    return {
+        actionTypes: ACTION_TYPE_INFOS.filter((info) => info.category === category),
+    };
+}
+export function getActionTypeInfo(actionType) {
+    return ACTION_TYPE_MAP.get(actionType);
+}
+//# sourceMappingURL=action-types.js.map