@lhremote/core 0.7.0 → 0.9.0

package/dist/linkedin/__tests__/dom-automation.integration.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dom-automation.integration.test.d.ts","sourceRoot":"","sources":["../../../src/linkedin/__tests__/dom-automation.integration.test.ts"],"names":[],"mappings":""}

package/dist/linkedin/__tests__/dom-automation.integration.test.js

@@ -0,0 +1,160 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+import { afterAll, afterEach, beforeAll, beforeEach, describe, expect, it } from "vitest";
+import { CDPClient } from "../../cdp/client.js";
+import { CDPEvaluationError, CDPTimeoutError } from "../../cdp/errors.js";
+import { launchChromium, } from "../../cdp/testing/launch-chromium.js";
+import { click, scrollTo, typeText, waitForElement } from "../dom-automation.js";
+/** Timeout for beforeEach operations (connect + reset) on slow CI runners. */
+const BEFORE_EACH_TIMEOUT = 15_000;
+/**
+ * Race a promise against a timeout, throwing a descriptive error on expiry.
+ */
+async function withTimeout(promise, ms, label) {
+    const ac = new AbortController();
+    const timeout = new Promise((_resolve, reject) => {
+        const timer = setTimeout(() => {
+            reject(new Error(`${label} timed out after ${ms}ms`));
+        }, ms);
+        ac.signal.addEventListener("abort", () => clearTimeout(timer));
+    });
+    try {
+        return await Promise.race([promise, timeout]);
+    }
+    finally {
+        ac.abort();
+    }
+}
+/**
+ * Helper to clear document body and create elements without innerHTML
+ * (which is blocked by Chromium's Trusted Types policy).
+ */
+async function resetBody(client) {
+    await client.evaluate(`while (document.body.firstChild) document.body.removeChild(document.body.firstChild)`);
+}
+describe("DOM automation (integration)", () => {
+    let chromium;
+    let client;
+    beforeAll(async () => {
+        chromium = await launchChromium();
+    }, 30_000);
+    afterAll(async () => {
+        await chromium.close();
+    });
+    beforeEach(async () => {
+        client = new CDPClient(chromium.port, { timeout: BEFORE_EACH_TIMEOUT });
+        await withTimeout(client.connect(), BEFORE_EACH_TIMEOUT, "client.connect()");
+        await withTimeout(resetBody(client), BEFORE_EACH_TIMEOUT, "resetBody()");
+    });
+    afterEach(() => {
+        client.disconnect();
+    });
+    // ── waitForElement ──────────────────────────────────────────────
+    describe("waitForElement", () => {
+        it("should resolve immediately when element already exists", async () => {
+            await client.evaluate(`(() => {
+        const el = document.createElement('div');
+        el.id = 'existing';
+        el.textContent = 'Hello';
+        document.body.appendChild(el);
+      })()`);
+            await waitForElement(client, "#existing", { timeout: 2000 });
+        });
+        it("should resolve when element appears after a delay", { timeout: 15_000 }, async () => {
+            await client.evaluate(`
+        setTimeout(() => {
+          const el = document.createElement('div');
+          el.id = 'delayed';
+          document.body.appendChild(el);
+        }, 200);
+      `);
+            await waitForElement(client, "#delayed", { timeout: 5000 });
+        });
+        it("should reject with CDPTimeoutError when element never appears", async () => {
+            await expect(waitForElement(client, "#nonexistent", { timeout: 500 })).rejects.toThrow(CDPTimeoutError);
+        });
+    });
+    // ── click ───────────────────────────────────────────────────────
+    describe("click", () => {
+        it("should click the element via JS .click()", async () => {
+            await client.evaluate(`(() => {
+        const btn = document.createElement('button');
+        btn.id = 'btn';
+        btn.textContent = 'Click me';
+        document.body.appendChild(btn);
+        window.__clicked = false;
+        btn.addEventListener('click', () => { window.__clicked = true; });
+      })()`);
+            await click(client, "#btn");
+            const clicked = await client.evaluate("window.__clicked");
+            expect(clicked).toBe(true);
+        });
+        it("should throw CDPEvaluationError when element not found", async () => {
+            await expect(click(client, "#missing")).rejects.toThrow(CDPEvaluationError);
+        });
+    });
+    // ── scrollTo ────────────────────────────────────────────────────
+    describe("scrollTo", () => {
+        it("should scroll the element into view", async () => {
+            await client.evaluate(`(() => {
+        document.body.style.margin = '0';
+        document.body.style.height = '3000px';
+        const el = document.createElement('div');
+        el.id = 'bottom';
+        el.textContent = 'Bottom';
+        el.style.position = 'absolute';
+        el.style.top = '2500px';
+        document.body.appendChild(el);
+      })()`);
+            // Verify element is initially below the viewport
+            const beforeY = await client.evaluate(`document.getElementById('bottom').getBoundingClientRect().top`);
+            expect(beforeY).toBeGreaterThan(600);
+            await scrollTo(client, "#bottom");
+            // Verify element is now within the viewport
+            const afterRect = await client.evaluate(`(() => {
+          const r = document.getElementById('bottom').getBoundingClientRect();
+          return { top: r.top, bottom: r.bottom };
+        })()`);
+            const viewportHeight = await client.evaluate("window.innerHeight");
+            expect(afterRect.top).toBeGreaterThanOrEqual(0);
+            expect(afterRect.top).toBeLessThan(viewportHeight);
+        });
+        it("should throw CDPEvaluationError when element not found", async () => {
+            await expect(scrollTo(client, "#missing")).rejects.toThrow(CDPEvaluationError);
+        });
+    });
+    // ── typeText ────────────────────────────────────────────────────
+    describe("typeText", () => {
+        it("should type characters one-by-one into an input", async () => {
+            await client.evaluate(`(() => {
+        const input = document.createElement('input');
+        input.id = 'input';
+        input.type = 'text';
+        document.body.appendChild(input);
+        window.__inputEvents = 0;
+        input.addEventListener('keydown', () => { window.__inputEvents++; });
+      })()`);
+            await typeText(client, "#input", "hello");
+            const value = await client.evaluate(`document.getElementById('input').value`);
+            expect(value).toBe("hello");
+            // Each character should have triggered a keydown event
+            const eventCount = await client.evaluate("window.__inputEvents");
+            expect(eventCount).toBe(5);
+        });
+        it("should type into a contenteditable element", async () => {
+            await client.evaluate(`(() => {
+        const editor = document.createElement('div');
+        editor.id = 'editor';
+        editor.contentEditable = 'true';
+        document.body.appendChild(editor);
+      })()`);
+            await typeText(client, "#editor", "abc");
+            const text = await client.evaluate(`document.getElementById('editor').textContent`);
+            expect(text).toBe("abc");
+        });
+        it("should throw CDPEvaluationError when element not found", async () => {
+            await expect(typeText(client, "#missing", "text")).rejects.toThrow(CDPEvaluationError);
+        });
+    });
+});
+//# sourceMappingURL=dom-automation.integration.test.js.map

package/dist/linkedin/__tests__/dom-automation.integration.test.js.map

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

package/dist/linkedin/dom-automation-retry.test.d.ts

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

package/dist/linkedin/dom-automation-retry.test.d.ts.map

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

package/dist/linkedin/dom-automation-retry.test.js

@@ -0,0 +1,51 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+import { describe, expect, it, vi } from "vitest";
+// Mock delay internals before importing the module under test so retries
+// resolve instantly (Vitest hoists vi.mock, but explicit ordering is clearer).
+vi.mock("../utils/delay.js", () => ({
+    delay: vi.fn().mockResolvedValue(undefined),
+    randomDelay: vi.fn().mockResolvedValue(undefined),
+    randomBetween: vi.fn().mockReturnValue(0),
+    gaussianRandom: vi.fn().mockReturnValue(0),
+    gaussianDelay: vi.fn().mockResolvedValue(undefined),
+    gaussianBetween: vi.fn().mockReturnValue(0),
+    maybeHesitate: vi.fn().mockResolvedValue(undefined),
+    maybeBreak: vi.fn().mockResolvedValue(undefined),
+    simulateReadingTime: vi.fn().mockResolvedValue(undefined),
+}));
+import { retryInteraction } from "./dom-automation.js";
+describe("retryInteraction", () => {
+    it("returns the result on first success", async () => {
+        const fn = vi.fn().mockResolvedValue("ok");
+        const result = await retryInteraction(fn, 3);
+        expect(result).toBe("ok");
+        expect(fn).toHaveBeenCalledTimes(1);
+    });
+    it("retries on failure and returns eventual success", async () => {
+        const fn = vi
+            .fn()
+            .mockRejectedValueOnce(new Error("fail"))
+            .mockResolvedValue("recovered");
+        const result = await retryInteraction(fn, 3);
+        expect(result).toBe("recovered");
+        expect(fn).toHaveBeenCalledTimes(2);
+    });
+    it("throws after exhausting all attempts", async () => {
+        const fn = vi.fn().mockRejectedValue(new Error("persistent"));
+        await expect(retryInteraction(fn, 2)).rejects.toThrow("persistent");
+        expect(fn).toHaveBeenCalledTimes(2);
+    });
+    it("defaults to 2 max attempts", async () => {
+        const fn = vi.fn().mockRejectedValue(new Error("fail"));
+        await expect(retryInteraction(fn)).rejects.toThrow("fail");
+        expect(fn).toHaveBeenCalledTimes(2);
+    });
+    it("returns null without retrying when fn returns null", async () => {
+        const fn = vi.fn().mockResolvedValue(null);
+        const result = await retryInteraction(fn, 3);
+        expect(result).toBeNull();
+        expect(fn).toHaveBeenCalledTimes(1);
+    });
+});
+//# sourceMappingURL=dom-automation-retry.test.js.map

package/dist/linkedin/dom-automation-retry.test.js.map

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

package/dist/linkedin/dom-automation.d.ts

@@ -0,0 +1,224 @@
+import type { CDPClient } from "../cdp/client.js";
+import type { HumanizedMouse } from "./humanized-mouse.js";
+/** Options for {@link waitForElement}. */
+export interface WaitForElementOptions {
+    /** Maximum time to wait in ms (default: 30 000). */
+    timeout?: number;
+    /** Polling interval in ms (default: 100). */
+    pollInterval?: number;
+}
+/** Text input method for {@link typeText}. */
+export type TypeMethod = "type";
+/**
+ * Poll the DOM until an element matching the selector appears.
+ *
+ * When a {@link HumanizedMouse} is provided, tiny idle mouse movements
+ * (1–5 px) are dispatched on ~20% of poll cycles once the wait exceeds
+ * 500 ms.  This prevents the cursor from remaining perfectly still
+ * during long element waits — a detectable automation fingerprint.
+ *
+ * @param client   - Connected CDP client targeting the page.
+ * @param selector - CSS selector to query.
+ * @param options  - Timeout and polling interval.
+ * @param mouse    - Optional humanized mouse (enables idle drift).
+ * @throws {CDPTimeoutError} If the element does not appear within the timeout.
+ */
+export declare function waitForElement(client: CDPClient, selector: string, options?: WaitForElementOptions, mouse?: HumanizedMouse | null): Promise<void>;
+/**
+ * Wait until the DOM stops mutating for `quietMs` milliseconds.
+ *
+ * Installs a `MutationObserver` via `Runtime.evaluate` that tracks
+ * the timestamp of the last mutation.  Polls until no mutations have
+ * occurred for the configured quiet period, then adds a "visual
+ * scanning" Gaussian delay to simulate a human pausing to read.
+ *
+ * @param client  - Connected CDP client targeting the page.
+ * @param quietMs - Milliseconds of mutation silence required (default: 500).
+ */
+export declare function waitForDOMStable(client: CDPClient, quietMs?: number): Promise<void>;
+/**
+ * Scroll the page until the target element is visible in the viewport.
+ *
+ * The element must already exist in the DOM.  Use {@link waitForElement}
+ * first if it may not be present yet.
+ *
+ * @param client   - Connected CDP client targeting the page.
+ * @param selector - CSS selector for the element to scroll to.
+ * @throws {CDPEvaluationError} If the element is not found.
+ */
+export declare function scrollTo(client: CDPClient, selector: string): Promise<void>;
+/**
+ * Trigger a hover on an element by dispatching `mouseenter` + `mouseover`.
+ *
+ * This is used to reveal hover-dependent UI such as the LinkedIn
+ * reactions menu popup.
+ *
+ * @param client   - Connected CDP client targeting the page.
+ * @param selector - CSS selector for the element to hover.
+ * @throws {CDPEvaluationError} If the element is not found.
+ */
+export declare function hover(client: CDPClient, selector: string): Promise<void>;
+/**
+ * Click an element via its JavaScript `.click()` method.
+ *
+ * Uses JS `.click()` rather than `Input.dispatchMouseEvent` because the
+ * latter does not reliably trigger handlers on LinkedIn's React components.
+ *
+ * @param client   - Connected CDP client targeting the page.
+ * @param selector - CSS selector for the element to click.
+ * @throws {CDPEvaluationError} If the element is not found.
+ */
+export declare function click(client: CDPClient, selector: string): Promise<void>;
+/**
+ * Type text into a focused element character-by-character.
+ *
+ * The element is focused first, then each character is dispatched via
+ * CDP `Input.dispatchKeyEvent` with character-context-aware Gaussian
+ * delays to approximate human typing cadence:
+ *
+ * - **Intra-word** (letters, digits): ~65 ms mean — fast, rhythmic typing
+ * - **Word boundary** (space): ~180 ms mean — natural pause between words
+ * - **Sentence boundary** (space after `.!?`): ~350 ms mean — thinking pause
+ * - **Paragraph boundary** (newline): ~700 ms mean — composing the next thought
+ * - **Micro-hesitation** (5% per character): ~300 ms extra — brief mid-word thinking
+ *
+ * @param client   - Connected CDP client targeting the page.
+ * @param selector - CSS selector for the input element.
+ * @param text     - The string to type.
+ * @param method   - Input method (default: `"type"`).
+ * @throws {CDPEvaluationError} If the element is not found.
+ */
+export declare function typeText(client: CDPClient, selector: string, text: string, method?: TypeMethod): Promise<void>;
+/** Bounding rect returned by element bounds queries. */
+export interface ElementBounds {
+    top: number;
+    bottom: number;
+    height: number;
+}
+/**
+ * Get the bounding rect of a DOM element selected by CSS selector.
+ *
+ * @returns `null` if the element is not found.
+ */
+export declare function getElementBounds(client: CDPClient, selector: string): Promise<ElementBounds | null>;
+/**
+ * Get the bounding rect of the Nth element matching a CSS selector.
+ *
+ * Equivalent to `document.querySelectorAll(baseSelector)[index]`.
+ *
+ * @returns `null` if no element exists at the given index.
+ */
+export declare function getElementBoundsByIndex(client: CDPClient, baseSelector: string, index: number): Promise<ElementBounds | null>;
+/**
+ * Get the viewport height (`window.innerHeight`).
+ */
+export declare function getViewportHeight(client: CDPClient): Promise<number>;
+/**
+ * Scroll the page until the target element is centered in the viewport,
+ * using incremental humanized mouse-wheel strokes.
+ *
+ * When a {@link HumanizedMouse} is available, the cursor scrolls the page
+ * in small increments until the element's bounding rect is in the viewport
+ * center zone.  Falls back to instant `scrollIntoView` otherwise.
+ *
+ * @param client   - Connected CDP client targeting the page.
+ * @param selector - CSS selector for the element to scroll to.
+ * @param mouse    - Optional humanized mouse instance.
+ */
+export declare function humanizedScrollTo(client: CDPClient, selector: string, mouse?: HumanizedMouse | null): Promise<void>;
+/**
+ * Scroll the page until the Nth element matching a selector is centered,
+ * using incremental humanized mouse-wheel strokes.
+ *
+ * Falls back to instant `scrollIntoView` when humanized mouse is unavailable.
+ *
+ * @param client       - Connected CDP client targeting the page.
+ * @param baseSelector - CSS selector matching multiple elements.
+ * @param index        - Zero-based index into the matched elements.
+ * @param mouse        - Optional humanized mouse instance.
+ */
+export declare function humanizedScrollToByIndex(client: CDPClient, baseSelector: string, index: number, mouse?: HumanizedMouse | null): Promise<void>;
+/** Viewport-relative point returned by `getElementCenter`. */
+interface ElementCenter {
+    x: number;
+    y: number;
+}
+/**
+ * Get a jittered viewport-relative point near the center of a DOM element.
+ *
+ * A Gaussian offset is applied so the click target varies naturally within
+ * the element bounds, removing the dead-center automation fingerprint.
+ *
+ * @returns `null` if the element is not found.
+ */
+export declare function getElementCenter(client: CDPClient, selector: string): Promise<ElementCenter | null>;
+/**
+ * Click an element with humanized mouse movement when available.
+ *
+ * When a {@link HumanizedMouse} is provided and available, the cursor
+ * follows a Bezier path to the element center before clicking.  The
+ * VirtualMouse dispatches `mousePressed` / `mouseReleased` via CDP.
+ *
+ * **Pre-focus hover** (60% probability, HumanizedMouse only): before
+ * clicking, the cursor first moves to a point 20–50 px from the target,
+ * pauses briefly to simulate visual scanning, then proceeds to the
+ * target — a two-phase approach that mimics how a human visually locates
+ * a button before moving to click it.
+ *
+ * **Viewport comfort zone**: if the target sits in the outer 20% of the
+ * viewport, a small scroll brings it more central before interacting.
+ *
+ * Falls back to the standard JS `.click()` when humanized mouse is
+ * unavailable (or the element cannot be located by bounding rect).
+ *
+ * @param client - Connected CDP client targeting the LinkedIn page.
+ * @param selector - CSS selector for the element to click.
+ * @param mouse  - Optional humanized mouse instance.
+ */
+export declare function humanizedClick(client: CDPClient, selector: string, mouse?: HumanizedMouse | null): Promise<void>;
+/**
+ * Hover over an element with humanized mouse movement when available.
+ *
+ * When a {@link HumanizedMouse} is provided, the cursor physically
+ * moves to the element center — which is more realistic than
+ * dispatching synthetic `mouseenter` / `mouseover` JS events.
+ *
+ * Falls back to synthetic JS events when unavailable.
+ *
+ * @param client - Connected CDP client targeting the LinkedIn page.
+ * @param selector - CSS selector for the element to hover.
+ * @param mouse  - Optional humanized mouse instance.
+ */
+export declare function humanizedHover(client: CDPClient, selector: string, mouse?: HumanizedMouse | null): Promise<void>;
+/**
+ * Scroll the page vertically with humanized mouse-wheel strokes.
+ *
+ * When a {@link HumanizedMouse} is provided, scrolling is emulated as
+ * incremental wheel strokes (150 px / 25 ms) at the given position,
+ * matching the behavior of a physical mouse wheel.
+ *
+ * Falls back to a single CDP `mouseWheel` event when unavailable.
+ *
+ * @param client - Connected CDP client targeting the LinkedIn page.
+ * @param deltaY - Pixels to scroll (positive = down).
+ * @param x      - Viewport X coordinate for the scroll position.
+ * @param y      - Viewport Y coordinate for the scroll position.
+ * @param mouse  - Optional humanized mouse instance.
+ */
+export declare function humanizedScrollY(client: CDPClient, deltaY: number, x: number, y: number, mouse?: HumanizedMouse | null): Promise<void>;
+/**
+ * Retry an interaction function with escalating Gaussian-distributed
+ * delays between attempts.
+ *
+ * Wraps critical interaction sequences (click after scroll, hover after
+ * navigate) where elements may vanish due to React re-renders.  Each
+ * retry waits progressively longer — `800 * (attempt + 1)` ms mean —
+ * giving the page time to stabilise.
+ *
+ * @param fn          - The async interaction to attempt.
+ * @param maxAttempts - Maximum number of attempts (default: 2).
+ * @returns The result of the first successful attempt.
+ */
+export declare function retryInteraction<T>(fn: () => Promise<T>, maxAttempts?: number): Promise<T>;
+export {};
+//# sourceMappingURL=dom-automation.d.ts.map

package/dist/linkedin/dom-automation.d.ts.map

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