@lhremote/core 0.0.0 → 0.1.0

package/dist/services/app.test.js

@@ -0,0 +1,265 @@
+import { spawn } from "node:child_process";
+import { accessSync } from "node:fs";
+import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
+import { AppLaunchError, AppNotFoundError } from "./errors.js";
+import { AppService } from "./app.js";
+vi.mock("node:child_process", () => ({
+    spawn: vi.fn(),
+}));
+vi.mock("node:fs", () => ({
+    accessSync: vi.fn(),
+    constants: { X_OK: 1 },
+}));
+vi.mock("../cdp/index.js", () => ({
+    discoverTargets: vi.fn(),
+}));
+vi.mock("get-port", () => ({
+    default: vi.fn(),
+}));
+import { discoverTargets } from "../cdp/index.js";
+import getPort from "get-port";
+const mockedSpawn = vi.mocked(spawn);
+const mockedAccessSync = vi.mocked(accessSync);
+const mockedDiscoverTargets = vi.mocked(discoverTargets);
+const mockedGetPort = vi.mocked(getPort);
+/** Use zero probe delay in tests to avoid 3s waits. */
+const FAST_OPTIONS = { launchProbeDelay: 0 };
+function makeMockChild() {
+    const listeners = new Map();
+    const child = {
+        unref: vi.fn(),
+        kill: vi.fn(),
+        on: vi.fn((event, handler) => {
+            if (!listeners.has(event))
+                listeners.set(event, new Set());
+            listeners.get(event).add(handler);
+            return child;
+        }),
+        removeListener: vi.fn((event, handler) => {
+            listeners.get(event)?.delete(handler);
+            return child;
+        }),
+        pid: 12345,
+        exitCode: null,
+    };
+    // Helper to simulate process exit from tests
+    child._emitExit = (code) => {
+        child.exitCode = code;
+        for (const handler of listeners.get("exit") ?? []) {
+            handler(code, null);
+        }
+    };
+    return child;
+}
+afterEach(() => {
+    vi.restoreAllMocks();
+    delete process.env["LINKEDHELPER_PATH"];
+});
+describe("AppService", () => {
+    describe("cdpPort getter", () => {
+        it("returns the explicit port when provided", () => {
+            const service = new AppService(9222);
+            expect(service.cdpPort).toBe(9222);
+        });
+        it("throws when no port assigned and launch() not called", () => {
+            const service = new AppService();
+            expect(() => service.cdpPort).toThrow(/call launch\(\) first/);
+        });
+    });
+    describe("findBinary", () => {
+        it("returns the darwin path on macOS", () => {
+            vi.stubGlobal("process", { ...process, platform: "darwin", env: {} });
+            mockedAccessSync.mockReturnValue(undefined);
+            const result = AppService.findBinary();
+            expect(result).toBe("/Applications/linked-helper.app/Contents/MacOS/linked-helper");
+        });
+        it("returns the win32 path on Windows", () => {
+            vi.stubGlobal("process", {
+                ...process,
+                platform: "win32",
+                env: { LOCALAPPDATA: "C:\\Users\\test\\AppData\\Local" },
+            });
+            mockedAccessSync.mockReturnValue(undefined);
+            const result = AppService.findBinary();
+            expect(result).toContain("linked-helper.exe");
+            expect(result).toContain("Local");
+        });
+        it("returns the linux path on Linux", () => {
+            vi.stubGlobal("process", { ...process, platform: "linux", env: {} });
+            mockedAccessSync.mockReturnValue(undefined);
+            const result = AppService.findBinary();
+            expect(result).toBe("/opt/linked-helper/linked-helper");
+        });
+        it("uses LINKEDHELPER_PATH env override", () => {
+            vi.stubGlobal("process", {
+                ...process,
+                platform: "darwin",
+                env: { LINKEDHELPER_PATH: "/custom/path/lh" },
+            });
+            mockedAccessSync.mockReturnValue(undefined);
+            const result = AppService.findBinary();
+            expect(result).toBe("/custom/path/lh");
+        });
+        it("throws AppNotFoundError when binary does not exist", () => {
+            vi.stubGlobal("process", { ...process, platform: "darwin", env: {} });
+            mockedAccessSync.mockImplementation(() => {
+                throw new Error("ENOENT");
+            });
+            expect(() => AppService.findBinary()).toThrow(AppNotFoundError);
+        });
+    });
+    describe("isRunning", () => {
+        it("returns true when CDP endpoint responds", async () => {
+            const service = new AppService(9222);
+            mockedDiscoverTargets.mockResolvedValue([]);
+            expect(await service.isRunning()).toBe(true);
+        });
+        it("returns false when CDP endpoint is unreachable", async () => {
+            const service = new AppService(9222);
+            mockedDiscoverTargets.mockRejectedValue(new Error("connection refused"));
+            expect(await service.isRunning()).toBe(false);
+        });
+        it("returns false when no port is assigned", async () => {
+            const service = new AppService();
+            expect(await service.isRunning()).toBe(false);
+        });
+    });
+    describe("launch", () => {
+        beforeEach(() => {
+            vi.stubGlobal("process", { ...process, platform: "darwin", env: {} });
+        });
+        it("skips launch if already running with explicit port", async () => {
+            const service = new AppService(9222, FAST_OPTIONS);
+            mockedDiscoverTargets.mockResolvedValue([]);
+            await service.launch();
+            expect(mockedSpawn).not.toHaveBeenCalled();
+        });
+        it("spawns the binary with explicit CDP port argument", async () => {
+            const service = new AppService(9222, FAST_OPTIONS);
+            mockedDiscoverTargets.mockRejectedValue(new Error("not running"));
+            mockedAccessSync.mockReturnValue(undefined);
+            const child = makeMockChild();
+            mockedSpawn.mockReturnValue(child);
+            await service.launch();
+            expect(mockedSpawn).toHaveBeenCalledWith("/Applications/linked-helper.app/Contents/MacOS/linked-helper", ["--remote-debugging-port=9222"], { detached: true, stdio: "ignore" });
+            expect(child.unref).toHaveBeenCalled();
+        });
+        it("selects a free port via get-port when no port provided", async () => {
+            const service = new AppService(undefined, FAST_OPTIONS);
+            mockedGetPort.mockResolvedValue(54321);
+            mockedAccessSync.mockReturnValue(undefined);
+            const child = makeMockChild();
+            mockedSpawn.mockReturnValue(child);
+            await service.launch();
+            expect(mockedGetPort).toHaveBeenCalled();
+            expect(mockedSpawn).toHaveBeenCalledWith(expect.any(String), ["--remote-debugging-port=54321"], { detached: true, stdio: "ignore" });
+            expect(service.cdpPort).toBe(54321);
+        });
+        it("reuses assigned port on second launch() call", async () => {
+            const service = new AppService(undefined, FAST_OPTIONS);
+            mockedGetPort.mockResolvedValue(54321);
+            mockedAccessSync.mockReturnValue(undefined);
+            const child = makeMockChild();
+            mockedSpawn.mockReturnValue(child);
+            await service.launch();
+            expect(service.cdpPort).toBe(54321);
+            // Reset call counts for second launch assertions
+            mockedGetPort.mockClear();
+            mockedSpawn.mockClear();
+            // Second launch — port is already assigned, app reported as running
+            mockedDiscoverTargets.mockResolvedValue([]);
+            await service.launch();
+            // getPort must not be called again — port was already assigned
+            expect(mockedGetPort).not.toHaveBeenCalled();
+            // spawn must not be called again — app is already running
+            expect(mockedSpawn).not.toHaveBeenCalled();
+            expect(service.cdpPort).toBe(54321);
+        });
+        it("throws AppLaunchError on spawn error", async () => {
+            const service = new AppService(9222, FAST_OPTIONS);
+            mockedDiscoverTargets.mockRejectedValue(new Error("not running"));
+            mockedAccessSync.mockReturnValue(undefined);
+            const child = makeMockChild();
+            child.on.mockImplementation((event, handler) => {
+                if (event === "error") {
+                    queueMicrotask(() => handler(new Error("ENOENT")));
+                }
+                return child;
+            });
+            mockedSpawn.mockReturnValue(child);
+            await expect(service.launch()).rejects.toThrow(AppLaunchError);
+        });
+    });
+    describe("quit", () => {
+        beforeEach(() => {
+            vi.stubGlobal("process", { ...process, platform: "darwin", env: {} });
+        });
+        it("sends SIGTERM and waits for exit", async () => {
+            const service = new AppService(9222, FAST_OPTIONS);
+            mockedDiscoverTargets.mockRejectedValue(new Error("not running"));
+            mockedAccessSync.mockReturnValue(undefined);
+            const child = makeMockChild();
+            const emitExit = child._emitExit;
+            // Simulate process exiting shortly after SIGTERM
+            child.kill.mockImplementation(() => {
+                queueMicrotask(() => emitExit(0));
+            });
+            mockedSpawn.mockReturnValue(child);
+            await service.launch();
+            await service.quit();
+            expect(child.kill).toHaveBeenCalledWith("SIGTERM");
+        });
+        it("escalates to SIGKILL when process does not exit after SIGTERM", async () => {
+            vi.useFakeTimers({ shouldAdvanceTime: true });
+            const service = new AppService(9222, FAST_OPTIONS);
+            mockedDiscoverTargets.mockRejectedValue(new Error("not running"));
+            mockedAccessSync.mockReturnValue(undefined);
+            const child = makeMockChild();
+            const emitExit = child._emitExit;
+            let killCount = 0;
+            child.kill.mockImplementation(() => {
+                killCount++;
+                // Only exit on SIGKILL (second kill call)
+                if (killCount === 2) {
+                    queueMicrotask(() => emitExit(137));
+                }
+            });
+            mockedSpawn.mockReturnValue(child);
+            await service.launch();
+            const quitPromise = service.quit();
+            // Advance past the graceful timeout
+            await vi.advanceTimersByTimeAsync(11_000);
+            await quitPromise;
+            expect(child.kill).toHaveBeenCalledWith("SIGTERM");
+            expect(child.kill).toHaveBeenCalledWith("SIGKILL");
+            vi.useRealTimers();
+        });
+        it("falls back to CDP close when no spawned process", async () => {
+            const service = new AppService(9222);
+            mockedDiscoverTargets.mockResolvedValue([
+                {
+                    id: "T1",
+                    type: "page",
+                    title: "",
+                    url: "",
+                    description: "",
+                    devtoolsFrontendUrl: "",
+                },
+            ]);
+            const mockFetch = vi.fn().mockResolvedValue({ ok: true });
+            vi.stubGlobal("fetch", mockFetch);
+            await service.quit();
+            expect(mockFetch).toHaveBeenCalledWith("http://127.0.0.1:9222/json/close/T1");
+        });
+        it("does not throw when CDP close fails", async () => {
+            const service = new AppService(9222);
+            mockedDiscoverTargets.mockRejectedValue(new Error("not running"));
+            await expect(service.quit()).resolves.toBeUndefined();
+        });
+        it("does nothing when no port assigned and no child process", async () => {
+            const service = new AppService();
+            await expect(service.quit()).resolves.toBeUndefined();
+        });
+    });
+});
+//# sourceMappingURL=app.test.js.map

package/dist/services/app.test.js.map

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

package/dist/services/errors.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Base class for all service-layer errors.
+ */
+export declare class ServiceError extends Error {
+    constructor(message: string, options?: ErrorOptions);
+}
+/**
+ * Thrown when the LinkedHelper application binary cannot be found
+ * at the expected platform-specific location.
+ */
+export declare class AppNotFoundError extends ServiceError {
+    constructor(message?: string);
+}
+/**
+ * Thrown when the LinkedHelper application fails to start.
+ */
+export declare class AppLaunchError extends ServiceError {
+    constructor(message: string, options?: ErrorOptions);
+}
+/**
+ * Thrown when the LinkedHelper launcher is not reachable via CDP.
+ */
+export declare class LinkedHelperNotRunningError extends ServiceError {
+    constructor(port: number);
+}
+/**
+ * Thrown when starting a LinkedHelper instance fails.
+ */
+export declare class StartInstanceError extends ServiceError {
+    constructor(accountId: number, reason?: string);
+}
+/**
+ * Thrown when an expected LinkedHelper instance is not running.
+ */
+export declare class InstanceNotRunningError extends ServiceError {
+    constructor(message?: string);
+}
+/**
+ * Thrown when profile extraction times out waiting for data
+ * to appear in the database.
+ */
+export declare class ExtractionTimeoutError extends ServiceError {
+    constructor(profileUrl: string, timeoutMs: number);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/services/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/services/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,qBAAa,YAAa,SAAQ,KAAK;gBACzB,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY;CAIpD;AAED;;;GAGG;AACH,qBAAa,gBAAiB,SAAQ,YAAY;gBACpC,OAAO,CAAC,EAAE,MAAM;CAM7B;AAED;;GAEG;AACH,qBAAa,cAAe,SAAQ,YAAY;gBAClC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY;CAIpD;AAED;;GAEG;AACH,qBAAa,2BAA4B,SAAQ,YAAY;gBAC/C,IAAI,EAAE,MAAM;CAMzB;AAED;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,YAAY;gBACtC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM;CAM/C;AAED;;GAEG;AACH,qBAAa,uBAAwB,SAAQ,YAAY;gBAC3C,OAAO,CAAC,EAAE,MAAM;CAI7B;AAED;;;GAGG;AACH,qBAAa,sBAAuB,SAAQ,YAAY;gBAC1C,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM;CAMlD"}

package/dist/services/errors.js

@@ -0,0 +1,66 @@
+/**
+ * Base class for all service-layer errors.
+ */
+export class ServiceError extends Error {
+    constructor(message, options) {
+        super(message, options);
+        this.name = "ServiceError";
+    }
+}
+/**
+ * Thrown when the LinkedHelper application binary cannot be found
+ * at the expected platform-specific location.
+ */
+export class AppNotFoundError extends ServiceError {
+    constructor(message) {
+        super(message ?? "LinkedHelper application binary not found. Set LINKEDHELPER_PATH to override.");
+        this.name = "AppNotFoundError";
+    }
+}
+/**
+ * Thrown when the LinkedHelper application fails to start.
+ */
+export class AppLaunchError extends ServiceError {
+    constructor(message, options) {
+        super(message, options);
+        this.name = "AppLaunchError";
+    }
+}
+/**
+ * Thrown when the LinkedHelper launcher is not reachable via CDP.
+ */
+export class LinkedHelperNotRunningError extends ServiceError {
+    constructor(port) {
+        super(`LinkedHelper is not running (no CDP endpoint at port ${String(port)})`);
+        this.name = "LinkedHelperNotRunningError";
+    }
+}
+/**
+ * Thrown when starting a LinkedHelper instance fails.
+ */
+export class StartInstanceError extends ServiceError {
+    constructor(accountId, reason) {
+        super(`Failed to start instance for account ${String(accountId)}${reason ? `: ${reason}` : ""}`);
+        this.name = "StartInstanceError";
+    }
+}
+/**
+ * Thrown when an expected LinkedHelper instance is not running.
+ */
+export class InstanceNotRunningError extends ServiceError {
+    constructor(message) {
+        super(message ?? "Instance not running");
+        this.name = "InstanceNotRunningError";
+    }
+}
+/**
+ * Thrown when profile extraction times out waiting for data
+ * to appear in the database.
+ */
+export class ExtractionTimeoutError extends ServiceError {
+    constructor(profileUrl, timeoutMs) {
+        super(`Profile extraction timed out after ${String(timeoutMs)}ms for ${profileUrl}`);
+        this.name = "ExtractionTimeoutError";
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/services/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/services/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,OAAO,YAAa,SAAQ,KAAK;IACrC,YAAY,OAAe,EAAE,OAAsB;QACjD,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;IAC7B,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,OAAO,gBAAiB,SAAQ,YAAY;IAChD,YAAY,OAAgB;QAC1B,KAAK,CACH,OAAO,IAAI,+EAA+E,CAC3F,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;IACjC,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,cAAe,SAAQ,YAAY;IAC9C,YAAY,OAAe,EAAE,OAAsB;QACjD,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;IAC/B,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,2BAA4B,SAAQ,YAAY;IAC3D,YAAY,IAAY;QACtB,KAAK,CACH,wDAAwD,MAAM,CAAC,IAAI,CAAC,GAAG,CACxE,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,6BAA6B,CAAC;IAC5C,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,kBAAmB,SAAQ,YAAY;IAClD,YAAY,SAAiB,EAAE,MAAe;QAC5C,KAAK,CACH,wCAAwC,MAAM,CAAC,SAAS,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,KAAK,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAC1F,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACnC,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,uBAAwB,SAAQ,YAAY;IACvD,YAAY,OAAgB;QAC1B,KAAK,CAAC,OAAO,IAAI,sBAAsB,CAAC,CAAC;QACzC,IAAI,CAAC,IAAI,GAAG,yBAAyB,CAAC;IACxC,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,OAAO,sBAAuB,SAAQ,YAAY;IACtD,YAAY,UAAkB,EAAE,SAAiB;QAC/C,KAAK,CACH,sCAAsC,MAAM,CAAC,SAAS,CAAC,UAAU,UAAU,EAAE,CAC9E,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;IACvC,CAAC;CACF"}

package/dist/services/errors.test.d.ts

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

package/dist/services/errors.test.d.ts.map

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

package/dist/services/errors.test.js

@@ -0,0 +1,71 @@
+import { describe, expect, it } from "vitest";
+import { AppLaunchError, AppNotFoundError, ExtractionTimeoutError, InstanceNotRunningError, LinkedHelperNotRunningError, ServiceError, StartInstanceError, } from "./errors.js";
+describe("Service errors", () => {
+    it("should set correct name for ServiceError", () => {
+        const error = new ServiceError("test");
+        expect(error.name).toBe("ServiceError");
+        expect(error.message).toBe("test");
+        expect(error).toBeInstanceOf(Error);
+    });
+    it("should support cause via ErrorOptions", () => {
+        const cause = new TypeError("original");
+        const error = new ServiceError("wrapper", { cause });
+        expect(error.cause).toBe(cause);
+    });
+    it("should set correct name for AppNotFoundError", () => {
+        const error = new AppNotFoundError();
+        expect(error.name).toBe("AppNotFoundError");
+        expect(error.message).toContain("binary not found");
+        expect(error).toBeInstanceOf(ServiceError);
+        expect(error).toBeInstanceOf(Error);
+    });
+    it("should allow custom message for AppNotFoundError", () => {
+        const error = new AppNotFoundError("custom path");
+        expect(error.message).toBe("custom path");
+    });
+    it("should set correct name for AppLaunchError", () => {
+        const error = new AppLaunchError("spawn failed");
+        expect(error.name).toBe("AppLaunchError");
+        expect(error.message).toBe("spawn failed");
+        expect(error).toBeInstanceOf(ServiceError);
+    });
+    it("should support cause for AppLaunchError", () => {
+        const cause = new Error("ENOENT");
+        const error = new AppLaunchError("spawn failed", { cause });
+        expect(error.cause).toBe(cause);
+    });
+    it("should set correct name for LinkedHelperNotRunningError", () => {
+        const error = new LinkedHelperNotRunningError(9222);
+        expect(error.name).toBe("LinkedHelperNotRunningError");
+        expect(error.message).toContain("9222");
+        expect(error).toBeInstanceOf(ServiceError);
+    });
+    it("should set correct name for StartInstanceError", () => {
+        const error = new StartInstanceError(42);
+        expect(error.name).toBe("StartInstanceError");
+        expect(error.message).toContain("42");
+        expect(error).toBeInstanceOf(ServiceError);
+    });
+    it("should include reason in StartInstanceError", () => {
+        const error = new StartInstanceError(42, "account is already running");
+        expect(error.message).toContain("account is already running");
+    });
+    it("should set correct name for InstanceNotRunningError", () => {
+        const error = new InstanceNotRunningError();
+        expect(error.name).toBe("InstanceNotRunningError");
+        expect(error.message).toBe("Instance not running");
+        expect(error).toBeInstanceOf(ServiceError);
+    });
+    it("should allow custom message for InstanceNotRunningError", () => {
+        const error = new InstanceNotRunningError("LinkedIn target not found");
+        expect(error.message).toBe("LinkedIn target not found");
+    });
+    it("should set correct name for ExtractionTimeoutError", () => {
+        const error = new ExtractionTimeoutError("https://www.linkedin.com/in/test", 30000);
+        expect(error.name).toBe("ExtractionTimeoutError");
+        expect(error.message).toContain("30000ms");
+        expect(error.message).toContain("linkedin.com/in/test");
+        expect(error).toBeInstanceOf(ServiceError);
+    });
+});
+//# sourceMappingURL=errors.test.js.map

package/dist/services/errors.test.js.map

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

package/dist/services/index.d.ts

@@ -0,0 +1,8 @@
+export { AppService, type AppServiceOptions } from "./app.js";
+export { InstanceService } from "./instance.js";
+export { startInstanceWithRecovery, waitForInstancePort, waitForInstanceShutdown, type StartInstanceOutcome, } from "./instance-lifecycle.js";
+export { LauncherService } from "./launcher.js";
+export { checkStatus, type AccountInstanceStatus, type DatabaseStatus, type LauncherStatus, type StatusReport, } from "./status.js";
+export { ProfileService, extractSlug, type VisitAndExtractOptions } from "./profile.js";
+export { AppLaunchError, AppNotFoundError, ExtractionTimeoutError, InstanceNotRunningError, LinkedHelperNotRunningError, ServiceError, StartInstanceError, } from "./errors.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/services/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,KAAK,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAC9D,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EACL,yBAAyB,EACzB,mBAAmB,EACnB,uBAAuB,EACvB,KAAK,oBAAoB,GAC1B,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EACL,WAAW,EACX,KAAK,qBAAqB,EAC1B,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,YAAY,GAClB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,KAAK,sBAAsB,EAAE,MAAM,cAAc,CAAC;AACxF,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,sBAAsB,EACtB,uBAAuB,EACvB,2BAA2B,EAC3B,YAAY,EACZ,kBAAkB,GACnB,MAAM,aAAa,CAAC"}

package/dist/services/index.js

@@ -0,0 +1,8 @@
+export { AppService } from "./app.js";
+export { InstanceService } from "./instance.js";
+export { startInstanceWithRecovery, waitForInstancePort, waitForInstanceShutdown, } from "./instance-lifecycle.js";
+export { LauncherService } from "./launcher.js";
+export { checkStatus, } from "./status.js";
+export { ProfileService, extractSlug } from "./profile.js";
+export { AppLaunchError, AppNotFoundError, ExtractionTimeoutError, InstanceNotRunningError, LinkedHelperNotRunningError, ServiceError, StartInstanceError, } from "./errors.js";
+//# sourceMappingURL=index.js.map

package/dist/services/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/services/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAA0B,MAAM,UAAU,CAAC;AAC9D,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EACL,yBAAyB,EACzB,mBAAmB,EACnB,uBAAuB,GAExB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EACL,WAAW,GAKZ,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,cAAc,EAAE,WAAW,EAA+B,MAAM,cAAc,CAAC;AACxF,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,sBAAsB,EACtB,uBAAuB,EACvB,2BAA2B,EAC3B,YAAY,EACZ,kBAAkB,GACnB,MAAM,aAAa,CAAC"}

package/dist/services/instance-lifecycle.d.ts

@@ -0,0 +1,38 @@
+import type { LauncherService } from "./launcher.js";
+/**
+ * Result of a start-instance operation.
+ */
+export type StartInstanceOutcome = {
+    status: "started";
+    port: number;
+} | {
+    status: "already_running";
+    port: number;
+} | {
+    status: "timeout";
+};
+/**
+ * Start a LinkedHelper instance with idempotent handling and crash recovery.
+ *
+ * - If the instance is already running and reachable, returns `already_running`.
+ * - If the launcher reports "already running" but the port is not discoverable
+ *   (stale state after crash), performs crash recovery: stop → delay → restart.
+ * - After starting, polls for the instance CDP port until available or timeout.
+ */
+export declare function startInstanceWithRecovery(launcher: LauncherService, accountId: number, launcherPort: number): Promise<StartInstanceOutcome>;
+/**
+ * Poll for the instance CDP port until available or timeout.
+ *
+ * The underlying `discoverInstancePort` verifies each candidate port
+ * responds to the CDP `/json/list` endpoint, so the returned port is
+ * guaranteed to be a working CDP port.
+ */
+export declare function waitForInstancePort(launcherPort: number): Promise<number | null>;
+/**
+ * Poll until no instance CDP port is discoverable, or timeout.
+ *
+ * Use after `stopInstance()` to ensure the process has fully exited
+ * before starting a new instance.
+ */
+export declare function waitForInstanceShutdown(launcherPort: number): Promise<void>;
+//# sourceMappingURL=instance-lifecycle.d.ts.map

package/dist/services/instance-lifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"instance-lifecycle.d.ts","sourceRoot":"","sources":["../../src/services/instance-lifecycle.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAoBrD;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAC5B;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACnC;IAAE,MAAM,EAAE,iBAAiB,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC3C;IAAE,MAAM,EAAE,SAAS,CAAA;CAAE,CAAC;AAE1B;;;;;;;GAOG;AACH,wBAAsB,yBAAyB,CAC7C,QAAQ,EAAE,eAAe,EACzB,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,oBAAoB,CAAC,CA4B/B;AAED;;;;;;GAMG;AACH,wBAAsB,mBAAmB,CACvC,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAYxB;AAED;;;;;GAKG;AACH,wBAAsB,uBAAuB,CAC3C,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,IAAI,CAAC,CAUf"}

package/dist/services/instance-lifecycle.js

@@ -0,0 +1,87 @@
+import { discoverInstancePort } from "../cdp/index.js";
+import { StartInstanceError } from "./errors.js";
+/**
+ * Maximum time to wait for the instance CDP port to become available (ms).
+ *
+ * LinkedHelper instances are full Electron apps that load LinkedIn on startup,
+ * so the CDP endpoint may not be ready for 30+ seconds after the process starts.
+ */
+const PORT_DISCOVERY_TIMEOUT = 45_000;
+/** Maximum time to wait for the instance CDP port to disappear after stop (ms). */
+const PORT_SHUTDOWN_TIMEOUT = 15_000;
+/** Interval between port discovery attempts (ms). */
+const PORT_DISCOVERY_INTERVAL = 1_000;
+/** Delay after crash recovery stop before retrying start (ms). */
+const CRASH_RECOVERY_DELAY = 2_000;
+/**
+ * Start a LinkedHelper instance with idempotent handling and crash recovery.
+ *
+ * - If the instance is already running and reachable, returns `already_running`.
+ * - If the launcher reports "already running" but the port is not discoverable
+ *   (stale state after crash), performs crash recovery: stop → delay → restart.
+ * - After starting, polls for the instance CDP port until available or timeout.
+ */
+export async function startInstanceWithRecovery(launcher, accountId, launcherPort) {
+    try {
+        await launcher.startInstance(accountId);
+    }
+    catch (error) {
+        if (error instanceof StartInstanceError &&
+            error.message.includes("already running")) {
+            const existingPort = await discoverInstancePort(launcherPort);
+            if (existingPort !== null) {
+                return { status: "already_running", port: existingPort };
+            }
+            // Stale state — crash recovery
+            await launcher.stopInstance(accountId);
+            await sleep(CRASH_RECOVERY_DELAY);
+            await launcher.startInstance(accountId);
+        }
+        else {
+            throw error;
+        }
+    }
+    const port = await waitForInstancePort(launcherPort);
+    if (port === null) {
+        return { status: "timeout" };
+    }
+    return { status: "started", port };
+}
+/**
+ * Poll for the instance CDP port until available or timeout.
+ *
+ * The underlying `discoverInstancePort` verifies each candidate port
+ * responds to the CDP `/json/list` endpoint, so the returned port is
+ * guaranteed to be a working CDP port.
+ */
+export async function waitForInstancePort(launcherPort) {
+    const deadline = Date.now() + PORT_DISCOVERY_TIMEOUT;
+    while (Date.now() < deadline) {
+        const port = await discoverInstancePort(launcherPort);
+        if (port !== null) {
+            return port;
+        }
+        await sleep(PORT_DISCOVERY_INTERVAL);
+    }
+    return null;
+}
+/**
+ * Poll until no instance CDP port is discoverable, or timeout.
+ *
+ * Use after `stopInstance()` to ensure the process has fully exited
+ * before starting a new instance.
+ */
+export async function waitForInstanceShutdown(launcherPort) {
+    const deadline = Date.now() + PORT_SHUTDOWN_TIMEOUT;
+    while (Date.now() < deadline) {
+        const port = await discoverInstancePort(launcherPort);
+        if (port === null) {
+            return;
+        }
+        await sleep(PORT_DISCOVERY_INTERVAL);
+    }
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=instance-lifecycle.js.map