@lhremote/core 0.7.0 → 0.9.0

package/dist/operations/get-post-stats.d.ts

@@ -0,0 +1,43 @@
+import type { PostStats } from "../types/post-analytics.js";
+import type { ConnectionOptions } from "./types.js";
+/**
+ * Input for the get-post-stats operation.
+ */
+export interface GetPostStatsInput extends ConnectionOptions {
+    /** LinkedIn post URL or raw URN (e.g. `urn:li:activity:1234567890`). */
+    readonly postUrl: string;
+}
+/**
+ * Output from the get-post-stats operation.
+ */
+export interface GetPostStatsOutput {
+    readonly stats: PostStats;
+}
+/**
+ * Extract a post activity URN from a LinkedIn post URL or raw URN.
+ *
+ * Supported formats:
+ * - `https://www.linkedin.com/feed/update/urn:li:activity:XXXXX/`
+ * - `https://www.linkedin.com/feed/update/urn:li:ugcPost:XXXXX/`
+ * - `https://www.linkedin.com/feed/update/urn:li:share:XXXXX/`
+ * - `https://www.linkedin.com/posts/username_activity-XXXXX-xxxx/`
+ * - Raw URN: `urn:li:activity:XXXXX`
+ */
+export declare function extractPostUrn(input: string): string;
+/**
+ * Resolve a post URL or URN into a navigable LinkedIn post detail URL.
+ * Accepts full LinkedIn URLs (returned as-is) or raw URNs (converted to URL).
+ */
+export declare function resolvePostDetailUrl(input: string): string;
+/**
+ * Retrieve engagement statistics for a LinkedIn post.
+ *
+ * Connects to the LinkedIn webview in LinkedHelper, navigates to the
+ * post detail page, and extracts engagement statistics from the
+ * rendered DOM.
+ *
+ * @param input - Post URL or URN and CDP connection parameters.
+ * @returns Engagement statistics for the post.
+ */
+export declare function getPostStats(input: GetPostStatsInput): Promise<GetPostStatsOutput>;
+//# sourceMappingURL=get-post-stats.d.ts.map

package/dist/operations/get-post-stats.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-post-stats.d.ts","sourceRoot":"","sources":["../../src/operations/get-post-stats.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAI5D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAIpD;;GAEG;AACH,MAAM,WAAW,iBAAkB,SAAQ,iBAAiB;IAC1D,wEAAwE;IACxE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;CAC3B;AAED;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAapD;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAI1D;AA+ED;;;;;;;;;GASG;AACH,wBAAsB,YAAY,CAChC,KAAK,EAAE,iBAAiB,GACvB,OAAO,CAAC,kBAAkB,CAAC,CAqE7B"}

package/dist/operations/get-post-stats.js

@@ -0,0 +1,164 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+import { resolveInstancePort } from "../cdp/index.js";
+import { CDPClient } from "../cdp/client.js";
+import { discoverTargets } from "../cdp/discovery.js";
+import { gaussianDelay } from "../utils/delay.js";
+import { delay } from "./get-feed.js";
+import { navigateAwayIf } from "./navigate-away.js";
+/**
+ * Extract a post activity URN from a LinkedIn post URL or raw URN.
+ *
+ * Supported formats:
+ * - `https://www.linkedin.com/feed/update/urn:li:activity:XXXXX/`
+ * - `https://www.linkedin.com/feed/update/urn:li:ugcPost:XXXXX/`
+ * - `https://www.linkedin.com/feed/update/urn:li:share:XXXXX/`
+ * - `https://www.linkedin.com/posts/username_activity-XXXXX-xxxx/`
+ * - Raw URN: `urn:li:activity:XXXXX`
+ */
+export function extractPostUrn(input) {
+    // Handle /feed/update/ URLs containing a URN path segment
+    const updateMatch = /\/feed\/update\/(urn:li:\w+:\d+)/.exec(input);
+    if (updateMatch?.[1])
+        return updateMatch[1];
+    // Handle /posts/ URLs that embed the activity ID in the slug
+    const postsMatch = /\/posts\/[^/]+_activity-(\d+)/.exec(input);
+    if (postsMatch?.[1])
+        return `urn:li:activity:${postsMatch[1]}`;
+    // Handle raw URN input
+    if (/^urn:li:\w+:\d+$/.test(input))
+        return input;
+    throw new Error(`Cannot extract post URN from: ${input}`);
+}
+/**
+ * Resolve a post URL or URN into a navigable LinkedIn post detail URL.
+ * Accepts full LinkedIn URLs (returned as-is) or raw URNs (converted to URL).
+ */
+export function resolvePostDetailUrl(input) {
+    if (input.startsWith("https://"))
+        return input;
+    if (input.startsWith("urn:li:"))
+        return `https://www.linkedin.com/feed/update/${input}/`;
+    throw new Error(`Invalid post identifier: ${input}`);
+}
+// ---------------------------------------------------------------------------
+// In-page DOM scraping script
+// ---------------------------------------------------------------------------
+/**
+ * JavaScript source evaluated inside the LinkedIn post detail page to
+ * extract engagement statistics from the rendered DOM.
+ *
+ * The post detail page renders engagement counts as text content
+ * (e.g. "42 reactions", "5 comments", "3 reposts").  The script
+ * searches the page body text for these patterns.
+ */
+const SCRAPE_POST_STATS_SCRIPT = `(() => {
+  let reactionCount = 0;
+  let commentCount = 0;
+  let shareCount = 0;
+
+  const countText = document.body.textContent || '';
+
+  function parseCount(pattern) {
+    const m = countText.match(pattern);
+    if (!m) return 0;
+    const raw = m[1].replace(/,/g, '');
+    const num = parseInt(raw, 10);
+    return isNaN(num) ? 0 : num;
+  }
+
+  reactionCount = parseCount(/(\\d[\\d,]*)\\s+reactions?/i);
+  commentCount = parseCount(/(\\d[\\d,]*)\\s+comments?/i);
+  shareCount = parseCount(/(\\d[\\d,]*)\\s+reposts?/i);
+
+  return { reactionCount, commentCount, shareCount };
+})()`;
+// ---------------------------------------------------------------------------
+// Wait for post detail to load
+// ---------------------------------------------------------------------------
+/**
+ * Poll the DOM until the post detail page has rendered.  The page is
+ * considered ready when an author link and at least one `span[dir="ltr"]`
+ * are present.
+ */
+async function waitForPostLoad(client, timeoutMs = 15_000) {
+    const deadline = Date.now() + timeoutMs;
+    while (Date.now() < deadline) {
+        const ready = await client.evaluate(`(() => {
+      const authorLink = document.querySelector('a[href*="/in/"], a[href*="/company/"]');
+      if (!authorLink) return false;
+      const ltrSpans = document.querySelectorAll('span[dir="ltr"]');
+      return ltrSpans.length > 0;
+    })()`);
+        if (ready)
+            return;
+        await delay(500);
+    }
+    throw new Error("Timed out waiting for post detail to appear in the DOM");
+}
+// ---------------------------------------------------------------------------
+// Main operation
+// ---------------------------------------------------------------------------
+/**
+ * Retrieve engagement statistics for a LinkedIn post.
+ *
+ * Connects to the LinkedIn webview in LinkedHelper, navigates to the
+ * post detail page, and extracts engagement statistics from the
+ * rendered DOM.
+ *
+ * @param input - Post URL or URN and CDP connection parameters.
+ * @returns Engagement statistics for the post.
+ */
+export async function getPostStats(input) {
+    const cdpPort = await resolveInstancePort(input.cdpPort, input.cdpHost);
+    const cdpHost = input.cdpHost ?? "127.0.0.1";
+    const allowRemote = input.allowRemote ?? false;
+    const postDetailUrl = resolvePostDetailUrl(input.postUrl);
+    // Keep using extractPostUrn for the output postUrn field
+    let postUrn;
+    try {
+        postUrn = extractPostUrn(input.postUrl);
+    }
+    catch {
+        postUrn = input.postUrl;
+    }
+    // Enforce loopback guard
+    if (!allowRemote && cdpHost !== "127.0.0.1" && cdpHost !== "localhost") {
+        throw new Error(`Non-loopback CDP host "${cdpHost}" requires --allow-remote. ` +
+            "This is a security measure to prevent remote code execution.");
+    }
+    const targets = await discoverTargets(cdpPort, cdpHost);
+    const linkedInTarget = targets.find((t) => t.type === "page" && t.url?.includes("linkedin.com"));
+    if (!linkedInTarget) {
+        throw new Error("No LinkedIn page found in LinkedHelper. " +
+            "Ensure LinkedHelper is running with an active LinkedIn session.");
+    }
+    const client = new CDPClient(cdpPort, { host: cdpHost, allowRemote });
+    await client.connect(linkedInTarget.id);
+    try {
+        // Navigate away if already on the post detail page to force a fresh load
+        await navigateAwayIf(client, "/feed/update/");
+        // Navigate to the post detail page
+        await client.navigate(postDetailUrl);
+        // Wait for the post content to render
+        await waitForPostLoad(client);
+        // Extract engagement stats from the DOM
+        const raw = await client.evaluate(SCRAPE_POST_STATS_SCRIPT);
+        if (!raw) {
+            throw new Error("Failed to extract post stats from the DOM");
+        }
+        const stats = {
+            postUrn,
+            reactionCount: raw.reactionCount,
+            reactionsByType: [],
+            commentCount: raw.commentCount,
+            shareCount: raw.shareCount,
+        };
+        await gaussianDelay(800, 300, 300, 1_800); // Post-action dwell
+        return { stats };
+    }
+    finally {
+        client.disconnect();
+    }
+}
+//# sourceMappingURL=get-post-stats.js.map

package/dist/operations/get-post-stats.js.map

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

package/dist/operations/get-post-stats.test.d.ts

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

package/dist/operations/get-post-stats.test.d.ts.map

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

package/dist/operations/get-post-stats.test.js

@@ -0,0 +1,169 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
+vi.mock("../cdp/discovery.js", () => ({
+    discoverTargets: vi.fn(),
+}));
+vi.mock("../cdp/client.js", () => ({
+    CDPClient: vi.fn(),
+}));
+vi.mock("../utils/delay.js", () => ({
+    gaussianDelay: vi.fn().mockResolvedValue(undefined),
+}));
+vi.mock("./navigate-away.js", () => ({
+    navigateAwayIf: vi.fn().mockResolvedValue(undefined),
+}));
+vi.mock("./get-feed.js", () => ({
+    delay: vi.fn().mockResolvedValue(undefined),
+}));
+import { discoverTargets } from "../cdp/discovery.js";
+import { CDPClient } from "../cdp/client.js";
+import { extractPostUrn, getPostStats, } from "./get-post-stats.js";
+describe("extractPostUrn", () => {
+    it("extracts URN from /feed/update/ URL with activity URN", () => {
+        expect(extractPostUrn("https://www.linkedin.com/feed/update/urn:li:activity:7123456789012345678/")).toBe("urn:li:activity:7123456789012345678");
+    });
+    it("extracts URN from /feed/update/ URL with ugcPost URN", () => {
+        expect(extractPostUrn("https://www.linkedin.com/feed/update/urn:li:ugcPost:7123456789012345678/")).toBe("urn:li:ugcPost:7123456789012345678");
+    });
+    it("extracts URN from /feed/update/ URL with share URN", () => {
+        expect(extractPostUrn("https://www.linkedin.com/feed/update/urn:li:share:7123456789012345678/")).toBe("urn:li:share:7123456789012345678");
+    });
+    it("extracts URN from /feed/update/ URL without trailing slash", () => {
+        expect(extractPostUrn("https://www.linkedin.com/feed/update/urn:li:activity:7123456789012345678")).toBe("urn:li:activity:7123456789012345678");
+    });
+    it("extracts activity URN from /posts/ URL", () => {
+        expect(extractPostUrn("https://www.linkedin.com/posts/johndoe_activity-7123456789012345678-abcd/")).toBe("urn:li:activity:7123456789012345678");
+    });
+    it("passes through raw URN input", () => {
+        expect(extractPostUrn("urn:li:activity:7123456789012345678")).toBe("urn:li:activity:7123456789012345678");
+    });
+    it("passes through raw ugcPost URN", () => {
+        expect(extractPostUrn("urn:li:ugcPost:7123456789012345678")).toBe("urn:li:ugcPost:7123456789012345678");
+    });
+    it("throws on unrecognised input", () => {
+        expect(() => extractPostUrn("https://example.com/foo")).toThrow("Cannot extract post URN from");
+    });
+    it("throws on empty input", () => {
+        expect(() => extractPostUrn("")).toThrow("Cannot extract post URN from");
+    });
+});
+describe("getPostStats", () => {
+    const CDP_PORT = 9222;
+    const POST_URL = "https://www.linkedin.com/feed/update/urn:li:activity:1234567890/";
+    function setupMocks(opts) {
+        const { postStats = { reactionCount: 42, commentCount: 5, shareCount: 3 }, readySequence = [true], } = opts ?? {};
+        vi.mocked(discoverTargets).mockResolvedValue([
+            {
+                id: "target-1",
+                type: "page",
+                title: "LinkedIn",
+                url: "https://www.linkedin.com/feed/",
+                description: "",
+                devtoolsFrontendUrl: "",
+            },
+        ]);
+        const disconnect = vi.fn();
+        const navigate = vi.fn().mockResolvedValue(undefined);
+        // Build evaluate mock call sequence:
+        // 1. readiness checks (boolean)
+        // 2. post stats scrape (object)
+        const evaluateMock = vi.fn();
+        for (const ready of readySequence) {
+            evaluateMock.mockResolvedValueOnce(ready);
+        }
+        evaluateMock.mockResolvedValueOnce(postStats);
+        vi.mocked(CDPClient).mockImplementation(function () {
+            return {
+                connect: vi.fn().mockResolvedValue(undefined),
+                disconnect,
+                navigate,
+                evaluate: evaluateMock,
+                send: vi.fn().mockResolvedValue(undefined),
+            };
+        });
+        return { evaluateMock, disconnect, navigate };
+    }
+    beforeEach(() => {
+        vi.clearAllMocks();
+    });
+    afterEach(() => {
+        vi.restoreAllMocks();
+    });
+    it("throws on non-loopback host without allowRemote", async () => {
+        await expect(getPostStats({
+            postUrl: POST_URL,
+            cdpPort: CDP_PORT,
+            cdpHost: "192.168.1.1",
+        })).rejects.toThrow("requires --allow-remote");
+    });
+    it("throws when no LinkedIn page found", async () => {
+        vi.mocked(discoverTargets).mockResolvedValue([]);
+        await expect(getPostStats({ postUrl: POST_URL, cdpPort: CDP_PORT })).rejects.toThrow("No LinkedIn page found in LinkedHelper");
+    });
+    it("navigates to post detail URL and extracts stats from DOM", async () => {
+        const { navigate } = setupMocks();
+        const result = await getPostStats({
+            postUrl: POST_URL,
+            cdpPort: CDP_PORT,
+        });
+        expect(navigate).toHaveBeenCalledWith("https://www.linkedin.com/feed/update/urn:li:activity:1234567890/");
+        expect(result.stats).toEqual({
+            postUrn: "urn:li:activity:1234567890",
+            reactionCount: 42,
+            reactionsByType: [],
+            commentCount: 5,
+            shareCount: 3,
+        });
+    });
+    it("returns empty reactionsByType (DOM has no breakdown)", async () => {
+        setupMocks({
+            postStats: { reactionCount: 100, commentCount: 10, shareCount: 5 },
+        });
+        const result = await getPostStats({
+            postUrl: POST_URL,
+            cdpPort: CDP_PORT,
+        });
+        expect(result.stats.reactionsByType).toEqual([]);
+        expect(result.stats.reactionCount).toBe(100);
+    });
+    it("handles zero counts gracefully", async () => {
+        setupMocks({
+            postStats: { reactionCount: 0, commentCount: 0, shareCount: 0 },
+        });
+        const result = await getPostStats({
+            postUrl: POST_URL,
+            cdpPort: CDP_PORT,
+        });
+        expect(result.stats).toEqual({
+            postUrn: "urn:li:activity:1234567890",
+            reactionCount: 0,
+            reactionsByType: [],
+            commentCount: 0,
+            shareCount: 0,
+        });
+    });
+    it("throws when DOM extraction returns null", async () => {
+        setupMocks({ postStats: null });
+        await expect(getPostStats({ postUrl: POST_URL, cdpPort: CDP_PORT })).rejects.toThrow("Failed to extract post stats from the DOM");
+    });
+    it("waits for post to load with polling", async () => {
+        const { evaluateMock } = setupMocks({
+            readySequence: [false, false, true],
+        });
+        await getPostStats({ postUrl: POST_URL, cdpPort: CDP_PORT });
+        // 3 readiness checks + 1 stats scrape = 4
+        expect(evaluateMock).toHaveBeenCalledTimes(4);
+    });
+    it("disconnects CDP client after successful operation", async () => {
+        const { disconnect } = setupMocks();
+        await getPostStats({ postUrl: POST_URL, cdpPort: CDP_PORT });
+        expect(disconnect).toHaveBeenCalled();
+    });
+    it("disconnects CDP client even on error", async () => {
+        const { disconnect } = setupMocks({ postStats: null });
+        await expect(getPostStats({ postUrl: POST_URL, cdpPort: CDP_PORT })).rejects.toThrow();
+        expect(disconnect).toHaveBeenCalled();
+    });
+});
+//# sourceMappingURL=get-post-stats.test.js.map

package/dist/operations/get-post-stats.test.js.map

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

package/dist/operations/get-post.d.ts

@@ -0,0 +1,42 @@
+import type { PostComment, PostDetail } from "../types/post.js";
+import type { ConnectionOptions } from "./types.js";
+/**
+ * Input for the get-post operation.
+ */
+export interface GetPostInput extends ConnectionOptions {
+    /** LinkedIn post URL or raw URN (e.g. `urn:li:activity:1234567890`). */
+    readonly postUrl: string;
+    /**
+     * Maximum number of comments to load.  The operation clicks "Load more
+     * comments" until this limit is reached or no more comments are available.
+     * Defaults to 100.  Set to 0 to skip comment loading entirely.
+     */
+    readonly commentCount?: number | undefined;
+}
+/**
+ * Output from the get-post operation.
+ */
+export interface GetPostOutput {
+    /** Full post detail. */
+    readonly post: PostDetail;
+    /** Comments on this post. */
+    readonly comments: PostComment[];
+    /** Comment pagination metadata. */
+    readonly commentsPaging: {
+        readonly start: number;
+        readonly count: number;
+        readonly total: number;
+    };
+}
+/**
+ * Retrieve detailed data for a single LinkedIn post with its comment thread.
+ *
+ * Connects to the LinkedIn webview in LinkedHelper, navigates to the
+ * post detail page, and extracts post data and comments from the
+ * rendered DOM.
+ *
+ * @param input - Post URL or URN, and CDP connection options.
+ * @returns Post detail with comments and pagination metadata.
+ */
+export declare function getPost(input: GetPostInput): Promise<GetPostOutput>;
+//# sourceMappingURL=get-post.d.ts.map

package/dist/operations/get-post.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-post.d.ts","sourceRoot":"","sources":["../../src/operations/get-post.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAIhE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAKpD;;GAEG;AACH,MAAM,WAAW,YAAa,SAAQ,iBAAiB;IACrD,wEAAwE;IACxE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB;;;;OAIG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC5C;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,wBAAwB;IACxB,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,6BAA6B;IAC7B,QAAQ,CAAC,QAAQ,EAAE,WAAW,EAAE,CAAC;IACjC,mCAAmC;IACnC,QAAQ,CAAC,cAAc,EAAE;QACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;KACxB,CAAC;CACH;AAqVD;;;;;;;;;GASG;AACH,wBAAsB,OAAO,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,aAAa,CAAC,CAmHzE"}