@lhremote/core 0.0.0 → 0.2.0

package/README.md

@@ -2,12 +2,136 @@
 
 Core library for [lhremote](https://github.com/alexey-pelykh/lhremote) — LinkedHelper automation toolkit.
 
+This package provides services, data access, and CDP communication for controlling LinkedHelper. It is the foundation that both [`@lhremote/mcp`](../mcp) and [`@lhremote/cli`](../cli) build on.
+
 ## Installation
 
 ```bash
 npm install @lhremote/core
 ```
 
+## Key Exports
+
+### Services
+
+| Export | Description |
+|--------|-------------|
+| `AppService` | Detect, launch, and quit the LinkedHelper application |
+| `InstanceService` | Start and stop LinkedHelper instances for individual accounts |
+| `LauncherService` | Low-level launcher interaction via CDP |
+| `CampaignService` | Create, configure, start, stop, and monitor campaigns |
+| `resolveAccount` | Resolve the active account ID from a running instance |
+| `checkStatus` | Check launcher, instance, and database health |
+| `startInstanceWithRecovery` | Start an instance with automatic retry on failure |
+| `waitForInstancePort` | Wait for an instance CDP port to become available |
+| `waitForInstanceShutdown` | Wait for an instance to shut down |
+| `withDatabase` / `withInstanceDatabase` | Scoped database access helpers |
+
+### Data Access
+
+| Export | Description |
+|--------|-------------|
+| `CampaignRepository` | Campaign CRUD and action-chain management |
+| `ProfileRepository` | Profile lookups and search |
+| `MessageRepository` | Messaging history queries |
+| `DatabaseClient` | SQLite database connection management |
+| `discoverDatabase` / `discoverAllDatabases` | Locate LinkedHelper database files on disk |
+
+### Campaign Formats
+
+| Export | Description |
+|--------|-------------|
+| `parseCampaignYaml` / `parseCampaignJson` | Parse campaign configuration |
+| `serializeCampaignYaml` / `serializeCampaignJson` | Serialize campaign configuration |
+| `CampaignFormatError` | Error thrown on invalid campaign format input |
+
+### Action Catalog
+
+| Export | Description |
+|--------|-------------|
+| `getActionTypeCatalog` | List all available action types with metadata |
+| `getActionTypeInfo` | Get details for a specific action type |
+
+### CDP
+
+| Export | Description |
+|--------|-------------|
+| `findApp` | Detect running LinkedHelper instances via process inspection |
+| `discoverInstancePort` | Find the CDP port for a running instance |
+| `discoverTargets` | Discover CDP targets on a given port |
+| `killInstanceProcesses` | Kill processes associated with a LinkedHelper instance |
+
+### Operations
+
+| Export | Description |
+|--------|-------------|
+| `campaignStatus` | Retrieve campaign status with statistics and action details |
+
+### Constants & Utilities
+
+| Export | Description |
+|--------|-------------|
+| `DEFAULT_CDP_PORT` | Default CDP port used by LinkedHelper |
+| `delay` | Promise-based delay helper |
+| `errorMessage` | Extract a human-readable message from an unknown error |
+| `isCdpPort` | Check whether a value is a valid CDP port number |
+| `isLoopbackAddress` | Check whether a string is a loopback IP address |
+
+### Error Types
+
+| Export | Description |
+|--------|-------------|
+| `ServiceError` | Base class for service-layer errors |
+| `AccountResolutionError` | Failed to resolve the active account |
+| `ActionExecutionError` | Action execution failed |
+| `AppLaunchError` | LinkedHelper application failed to launch |
+| `AppNotFoundError` | LinkedHelper application not found |
+| `CampaignExecutionError` | Campaign execution failed |
+| `CampaignTimeoutError` | Campaign operation timed out |
+| `ExtractionTimeoutError` | Data extraction timed out |
+| `InstanceNotRunningError` | Target instance is not running |
+| `InvalidProfileUrlError` | Invalid LinkedIn profile URL |
+| `LinkedHelperNotRunningError` | LinkedHelper is not running |
+| `StartInstanceError` | Instance failed to start |
+| `WrongPortError` | Connected to wrong port / unexpected endpoint |
+| `CampaignNotFoundError` | Campaign not found in the database |
+| `ActionNotFoundError` | Action not found in the database |
+| `ChatNotFoundError` | Chat not found in the database |
+| `DatabaseError` | General database error |
+| `DatabaseNotFoundError` | Database file not found on disk |
+| `ExcludeListNotFoundError` | Exclude list not found in the database |
+| `NoNextActionError` | No next action available in the campaign |
+| `ProfileNotFoundError` | Profile not found in the database |
+| `CDPConnectionError` | CDP connection failed |
+| `CDPError` | General CDP protocol error |
+| `CDPEvaluationError` | CDP JavaScript evaluation failed |
+| `CDPTimeoutError` | CDP operation timed out |
+
+## Usage
+
+```typescript
+import {
+  findApp,
+  resolveAccount,
+  CampaignService,
+  withInstanceDatabase,
+} from "@lhremote/core";
+
+// Detect LinkedHelper
+const apps = await findApp();
+const cdpPort = apps[0].cdpPort!;
+
+// Resolve the active account
+const accountId = await resolveAccount(cdpPort);
+
+// Work with campaigns
+await withInstanceDatabase(cdpPort, accountId, async ({ instance, db }) => {
+  const campaigns = new CampaignService(instance, db);
+  const list = await campaigns.list();
+  console.log(list);
+});
+```
+
 ## License
 
 [AGPL-3.0-only](https://github.com/alexey-pelykh/lhremote/blob/main/LICENSE)

package/dist/cdp/app-discovery.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Result of discovering a running LinkedHelper application process.
+ */
+export interface DiscoveredApp {
+    /** OS process ID. */
+    pid: number;
+    /** CDP port the process is listening on, or `null` if none detected. */
+    cdpPort: number | null;
+    /** Whether the CDP endpoint responded to a probe. */
+    connectable: boolean;
+}
+/**
+ * Scan the system for running LinkedHelper application processes.
+ *
+ * For each matching process, attempts to detect a CDP debugging port
+ * by inspecting its listening TCP ports and probing them with an HTTP
+ * request to the CDP `/json/list` endpoint.
+ *
+ * @returns An array of discovered LinkedHelper processes (may be empty).
+ */
+export declare function findApp(): Promise<DiscoveredApp[]>;
+//# sourceMappingURL=app-discovery.d.ts.map

package/dist/cdp/app-discovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-discovery.d.ts","sourceRoot":"","sources":["../../src/cdp/app-discovery.ts"],"names":[],"mappings":"AAYA;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,qBAAqB;IACrB,GAAG,EAAE,MAAM,CAAC;IAEZ,wEAAwE;IACxE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAEvB,qDAAqD;IACrD,WAAW,EAAE,OAAO,CAAC;CACtB;AAED;;;;;;;;GAQG;AACH,wBAAsB,OAAO,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC,CAOxD"}

package/dist/cdp/app-discovery.js

@@ -0,0 +1,60 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+import { pidToPorts } from "pid-port";
+import psList from "ps-list";
+import { isCdpPort } from "../utils/cdp-port.js";
+/**
+ * Known LinkedHelper binary names across platforms.
+ */
+const BINARY_NAMES = ["linked-helper", "linked-helper.exe"];
+/**
+ * Scan the system for running LinkedHelper application processes.
+ *
+ * For each matching process, attempts to detect a CDP debugging port
+ * by inspecting its listening TCP ports and probing them with an HTTP
+ * request to the CDP `/json/list` endpoint.
+ *
+ * @returns An array of discovered LinkedHelper processes (may be empty).
+ */
+export async function findApp() {
+    const processes = await listLinkedHelperProcesses();
+    if (processes.length === 0) {
+        return [];
+    }
+    return Promise.all(processes.map(probeProcess));
+}
+/**
+ * List PIDs of processes whose name matches a known LinkedHelper binary.
+ */
+async function listLinkedHelperProcesses() {
+    try {
+        const all = await psList();
+        return all
+            .filter((p) => BINARY_NAMES.includes(p.name))
+            .map((p) => p.pid);
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Probe a single process for CDP connectivity.
+ */
+async function probeProcess(pid) {
+    let ports;
+    try {
+        ports = await pidToPorts(pid);
+    }
+    catch {
+        return { pid, cdpPort: null, connectable: false };
+    }
+    for (const port of ports) {
+        if (await isCdpPort(port)) {
+            return { pid, cdpPort: port, connectable: true };
+        }
+    }
+    // Process is running but no CDP port detected (or none responding)
+    const firstPort = [...ports][0] ?? null;
+    return { pid, cdpPort: firstPort, connectable: false };
+}
+//# sourceMappingURL=app-discovery.js.map

package/dist/cdp/app-discovery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-discovery.js","sourceRoot":"","sources":["../../src/cdp/app-discovery.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,oCAAoC;AAEpC,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,MAAM,MAAM,SAAS,CAAC;AAC7B,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAEjD;;GAEG;AACH,MAAM,YAAY,GAAG,CAAC,eAAe,EAAE,mBAAmB,CAAC,CAAC;AAgB5D;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,OAAO;IAC3B,MAAM,SAAS,GAAG,MAAM,yBAAyB,EAAE,CAAC;IACpD,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC3B,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,OAAO,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC;AAClD,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,yBAAyB;IACtC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,MAAM,EAAE,CAAC;QAC3B,OAAO,GAAG;aACP,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;aAC5C,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IACvB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,YAAY,CAAC,GAAW;IACrC,IAAI,KAAkB,CAAC;IACvB,IAAI,CAAC;QACH,KAAK,GAAG,MAAM,UAAU,CAAC,GAAG,CAAC,CAAC;IAChC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC;IACpD,CAAC;IAED,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,MAAM,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC;YAC1B,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;QACnD,CAAC;IACH,CAAC;IAED,mEAAmE;IACnE,MAAM,SAAS,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;IACxC,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC;AACzD,CAAC"}

package/dist/cdp/app-discovery.test.d.ts

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

package/dist/cdp/app-discovery.test.d.ts.map

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

package/dist/cdp/app-discovery.test.js

@@ -0,0 +1,124 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
+import { findApp } from "./app-discovery.js";
+vi.mock("pid-port", () => ({
+    pidToPorts: vi.fn(),
+}));
+vi.mock("ps-list", () => ({
+    default: vi.fn(),
+}));
+import { pidToPorts } from "pid-port";
+import psList from "ps-list";
+describe("findApp", () => {
+    beforeEach(() => {
+        vi.spyOn(globalThis, "fetch").mockResolvedValue(new Response("[]", { status: 200 }));
+    });
+    afterEach(() => {
+        vi.restoreAllMocks();
+    });
+    it("should return empty array when no LinkedHelper process is running", async () => {
+        vi.mocked(psList).mockResolvedValue([
+            { pid: 100, name: "chrome", ppid: 1 },
+            { pid: 200, name: "node", ppid: 1 },
+        ]);
+        const result = await findApp();
+        expect(result).toEqual([]);
+    });
+    it("should return empty array when psList throws", async () => {
+        vi.mocked(psList).mockRejectedValue(new Error("permission denied"));
+        const result = await findApp();
+        expect(result).toEqual([]);
+    });
+    it("should discover a linked-helper process with CDP port", async () => {
+        vi.mocked(psList).mockResolvedValue([
+            { pid: 1000, name: "linked-helper", ppid: 1 },
+        ]);
+        vi.mocked(pidToPorts).mockResolvedValue(new Set([9222]));
+        const result = await findApp();
+        expect(result).toEqual([
+            { pid: 1000, cdpPort: 9222, connectable: true },
+        ]);
+    });
+    it("should discover a linked-helper.exe process on Windows", async () => {
+        vi.mocked(psList).mockResolvedValue([
+            { pid: 2000, name: "linked-helper.exe", ppid: 1 },
+        ]);
+        vi.mocked(pidToPorts).mockResolvedValue(new Set([9333]));
+        const result = await findApp();
+        expect(result).toEqual([
+            { pid: 2000, cdpPort: 9333, connectable: true },
+        ]);
+    });
+    it("should discover multiple LinkedHelper processes", async () => {
+        vi.mocked(psList).mockResolvedValue([
+            { pid: 1000, name: "linked-helper", ppid: 1 },
+            { pid: 2000, name: "linked-helper", ppid: 1 },
+        ]);
+        vi.mocked(pidToPorts)
+            .mockResolvedValueOnce(new Set([9222]))
+            .mockResolvedValueOnce(new Set([9333]));
+        const result = await findApp();
+        expect(result).toEqual([
+            { pid: 1000, cdpPort: 9222, connectable: true },
+            { pid: 2000, cdpPort: 9333, connectable: true },
+        ]);
+    });
+    it("should return connectable false when CDP probe fails", async () => {
+        vi.mocked(psList).mockResolvedValue([
+            { pid: 1000, name: "linked-helper", ppid: 1 },
+        ]);
+        vi.mocked(pidToPorts).mockResolvedValue(new Set([9222]));
+        vi.mocked(globalThis.fetch).mockRejectedValue(new Error("ECONNREFUSED"));
+        const result = await findApp();
+        expect(result).toEqual([
+            { pid: 1000, cdpPort: 9222, connectable: false },
+        ]);
+    });
+    it("should return cdpPort null when pidToPorts throws", async () => {
+        vi.mocked(psList).mockResolvedValue([
+            { pid: 1000, name: "linked-helper", ppid: 1 },
+        ]);
+        vi.mocked(pidToPorts).mockRejectedValue(new Error("failed"));
+        const result = await findApp();
+        expect(result).toEqual([
+            { pid: 1000, cdpPort: null, connectable: false },
+        ]);
+    });
+    it("should return cdpPort null when process has no listening ports", async () => {
+        vi.mocked(psList).mockResolvedValue([
+            { pid: 1000, name: "linked-helper", ppid: 1 },
+        ]);
+        vi.mocked(pidToPorts).mockResolvedValue(new Set());
+        const result = await findApp();
+        expect(result).toEqual([
+            { pid: 1000, cdpPort: null, connectable: false },
+        ]);
+    });
+    it("should find CDP port among multiple listening ports", async () => {
+        vi.mocked(psList).mockResolvedValue([
+            { pid: 1000, name: "linked-helper", ppid: 1 },
+        ]);
+        vi.mocked(pidToPorts).mockResolvedValue(new Set([8080, 9222]));
+        vi.mocked(globalThis.fetch).mockImplementation(async (input) => {
+            const url = String(input);
+            if (url.includes(":8080/")) {
+                throw new Error("ECONNREFUSED");
+            }
+            return new Response("[]", { status: 200 });
+        });
+        const result = await findApp();
+        expect(result).toEqual([
+            { pid: 1000, cdpPort: 9222, connectable: true },
+        ]);
+    });
+    it("should not match processes with similar but different names", async () => {
+        vi.mocked(psList).mockResolvedValue([
+            { pid: 100, name: "linked-helper-updater", ppid: 1 },
+            { pid: 200, name: "my-linked-helper", ppid: 1 },
+        ]);
+        const result = await findApp();
+        expect(result).toEqual([]);
+    });
+});
+//# sourceMappingURL=app-discovery.test.js.map

package/dist/cdp/app-discovery.test.js.map

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

package/dist/cdp/client.d.ts

@@ -0,0 +1,114 @@
+import type { Protocol } from "devtools-protocol";
+type EventListener = (params: unknown) => void;
+/**
+ * Chrome DevTools Protocol client.
+ *
+ * Communicates with a CDP-enabled process over WebSocket, providing:
+ * - Request/response correlation via incrementing message IDs
+ * - Event subscription
+ * - Convenience helpers for `Runtime.evaluate` and `Page.navigate`
+ * - Automatic reconnection with exponential backoff
+ */
+export declare class CDPClient {
+    private readonly port;
+    private readonly host;
+    private readonly timeout;
+    private ws;
+    private nextId;
+    private readonly pending;
+    private readonly listeners;
+    private connected;
+    private targetId;
+    private reconnecting;
+    constructor(port: number, options?: {
+        host?: string;
+        timeout?: number;
+        allowRemote?: boolean;
+    });
+    /**
+     * Open a WebSocket connection to a CDP target.
+     *
+     * @param targetId - Specific target ID to connect to.  When omitted the
+     *   first `page` target is used.
+     */
+    connect(targetId?: string): Promise<void>;
+    /**
+     * Close the connection.  Pending requests are rejected.
+     */
+    disconnect(): void;
+    /**
+     * Send a raw CDP method call and wait for the response.
+     *
+     * @param method - CDP method name, e.g. `"Runtime.evaluate"`.
+     * @param params - Method parameters.
+     * @returns The `result` field from the CDP response.
+     */
+    send(method: string, params?: Record<string, unknown>): Promise<unknown>;
+    /**
+     * Evaluate a JavaScript expression via `Runtime.evaluate`.
+     *
+     * @param expression  - JavaScript source to evaluate.
+     * @param awaitPromise - Whether to await a Promise result (default `false`).
+     * @returns The deserialized value from the remote context.
+     */
+    evaluate<T = unknown>(expression: string, awaitPromise?: boolean): Promise<T>;
+    /**
+     * Navigate the target to the given URL via `Page.navigate`.
+     *
+     * Only `http:` and `https:` schemes are allowed.  Other schemes such as
+     * `file:`, `javascript:`, or `data:` are rejected to prevent misuse.
+     *
+     * @throws {TypeError} If the URL uses an unsupported scheme.
+     */
+    navigate(url: string): Promise<Protocol.Page.NavigateResponse>;
+    /**
+     * Subscribe to a CDP event.
+     *
+     * @param event    - Event name, e.g. `"Page.loadEventFired"`.
+     * @param listener - Callback receiving the event parameters.
+     */
+    on(event: string, listener: EventListener): void;
+    /**
+     * Remove a previously registered event listener.
+     */
+    off(event: string, listener: EventListener): void;
+    /**
+     * Wait for a single occurrence of a CDP event.
+     *
+     * @param event   - Event name.
+     * @param timeout - Maximum wait time in ms (default: client timeout).
+     */
+    waitForEvent(event: string, timeout?: number): Promise<unknown>;
+    /** Whether the client currently has an open connection. */
+    get isConnected(): boolean;
+    /**
+     * Resolve a `ws://` URL for the given target ID, or the first page target.
+     */
+    private resolveWebSocketUrl;
+    /**
+     * Open a WebSocket and wire up message handling.
+     */
+    private openWebSocket;
+    /**
+     * Handle an incoming WebSocket message — either a method response or an event.
+     */
+    private handleMessage;
+    /**
+     * Attempt to reconnect with exponential backoff.
+     *
+     * Called fire-and-forget from the WebSocket close handler.  When all
+     * {@link MAX_RECONNECT_ATTEMPTS} are exhausted a `"reconnect-exhausted"`
+     * event is emitted so callers can react to permanent connection loss.
+     */
+    private attemptReconnect;
+    /**
+     * Emit an event to registered listeners.
+     */
+    private emitEvent;
+    /**
+     * Reject all pending requests (used on disconnect / close).
+     */
+    private rejectAllPending;
+}
+export {};
+//# sourceMappingURL=client.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/cdp/client.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AA0BlD,KAAK,aAAa,GAAG,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,CAAC;AAE/C;;;;;;;;GAQG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IAEjC,OAAO,CAAC,EAAE,CAA0B;IACpC,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqC;IAC7D,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAyC;IAEnE,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,QAAQ,CAAuB;IACvC,OAAO,CAAC,YAAY,CAAS;gBAG3B,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,OAAO,CAAA;KAAE;IAsBtE;;;;;OAKG;IACG,OAAO,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAK/C;;OAEG;IACH,UAAU,IAAI,IAAI;IAUlB;;;;;;OAMG;IACG,IAAI,CACR,MAAM,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B,OAAO,CAAC,OAAO,CAAC;IAoBnB;;;;;;OAMG;IACG,QAAQ,CAAC,CAAC,GAAG,OAAO,EACxB,UAAU,EAAE,MAAM,EAClB,YAAY,UAAQ,GACnB,OAAO,CAAC,CAAC,CAAC;IAqBb;;;;;;;OAOG;IACG,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,gBAAgB,CAAC;IAWpE;;;;;OAKG;IACH,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,GAAG,IAAI;IAShD;;OAEG;IACH,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,GAAG,IAAI;IAIjD;;;;;OAKG;IACG,YAAY,CAChB,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,OAAO,CAAC;IAmBnB,2DAA2D;IAC3D,IAAI,WAAW,IAAI,OAAO,CAEzB;IAMD;;OAEG;YACW,mBAAmB;IA8BjC;;OAEG;IACH,OAAO,CAAC,aAAa;IA2CrB;;OAEG;IACH,OAAO,CAAC,aAAa;IA8BrB;;;;;;OAMG;YACW,gBAAgB;IAuB9B;;OAEG;IACH,OAAO,CAAC,SAAS;IASjB;;OAEG;IACH,OAAO,CAAC,gBAAgB;CAOzB"}

package/dist/cdp/client.integration.test.d.ts

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

package/dist/cdp/client.integration.test.d.ts.map

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

package/dist/cdp/client.integration.test.js

@@ -0,0 +1,77 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+import { afterAll, afterEach, beforeAll, describe, expect, it } from "vitest";
+import { CDPClient } from "./client.js";
+import { CDPEvaluationError } from "./errors.js";
+import { launchChromium, } from "./testing/launch-chromium.js";
+describe("CDPClient (integration)", () => {
+    let chromium;
+    let client;
+    beforeAll(async () => {
+        chromium = await launchChromium();
+    }, 30_000);
+    afterAll(async () => {
+        await chromium.close();
+    });
+    afterEach(() => {
+        client.disconnect();
+    });
+    describe("connect", () => {
+        it("should connect to a real Chromium page target", async () => {
+            client = new CDPClient(chromium.port);
+            await client.connect();
+            expect(client.isConnected).toBe(true);
+        });
+    });
+    describe("evaluate", () => {
+        it("should evaluate a JavaScript expression", async () => {
+            client = new CDPClient(chromium.port);
+            await client.connect();
+            const result = await client.evaluate("2 + 2");
+            expect(result).toBe(4);
+        });
+        it("should evaluate expressions returning objects", async () => {
+            client = new CDPClient(chromium.port);
+            await client.connect();
+            const result = await client.evaluate("({ a: 1, b: 'hello' })");
+            expect(result).toEqual({ a: 1, b: "hello" });
+        });
+        it("should throw CDPEvaluationError on runtime exception", async () => {
+            client = new CDPClient(chromium.port);
+            await client.connect();
+            await expect(client.evaluate("throw new Error('test error')")).rejects.toThrow(CDPEvaluationError);
+        });
+        it("should await promise results when awaitPromise is true", async () => {
+            client = new CDPClient(chromium.port);
+            await client.connect();
+            const result = await client.evaluate("Promise.resolve(42)", true);
+            expect(result).toBe(42);
+        });
+    });
+    describe("navigate", () => {
+        it("should navigate to an HTTP URL", async () => {
+            client = new CDPClient(chromium.port);
+            await client.connect();
+            const response = await client.navigate("http://example.com");
+            expect(response.frameId).toEqual(expect.any(String));
+        });
+        it("should reject non-HTTP schemes", async () => {
+            client = new CDPClient(chromium.port);
+            await client.connect();
+            await expect(client.navigate("data:text/html,<h1>Test</h1>")).rejects.toThrow(TypeError);
+        });
+    });
+    describe("events", () => {
+        it("should receive CDP events from the browser", async () => {
+            client = new CDPClient(chromium.port);
+            await client.connect();
+            // Enable Page domain to receive events
+            await client.send("Page.enable");
+            const eventPromise = client.waitForEvent("Page.loadEventFired", 10_000);
+            await client.navigate("http://example.com");
+            const params = (await eventPromise);
+            expect(params.timestamp).toEqual(expect.any(Number));
+        });
+    });
+});
+//# sourceMappingURL=client.integration.test.js.map

package/dist/cdp/client.integration.test.js.map

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