@lhremote/core 0.0.0 → 0.1.0

package/dist/services/instance-lifecycle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"instance-lifecycle.js","sourceRoot":"","sources":["../../src/services/instance-lifecycle.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAEvD,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEjD;;;;;GAKG;AACH,MAAM,sBAAsB,GAAG,MAAM,CAAC;AAEtC,mFAAmF;AACnF,MAAM,qBAAqB,GAAG,MAAM,CAAC;AAErC,qDAAqD;AACrD,MAAM,uBAAuB,GAAG,KAAK,CAAC;AAEtC,kEAAkE;AAClE,MAAM,oBAAoB,GAAG,KAAK,CAAC;AAUnC;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAC7C,QAAyB,EACzB,SAAiB,EACjB,YAAoB;IAEpB,IAAI,CAAC;QACH,MAAM,QAAQ,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC;IAC1C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IACE,KAAK,YAAY,kBAAkB;YACnC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAC,EACzC,CAAC;YACD,MAAM,YAAY,GAAG,MAAM,oBAAoB,CAAC,YAAY,CAAC,CAAC;YAC9D,IAAI,YAAY,KAAK,IAAI,EAAE,CAAC;gBAC1B,OAAO,EAAE,MAAM,EAAE,iBAAiB,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC;YAC3D,CAAC;YAED,+BAA+B;YAC/B,MAAM,QAAQ,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC;YACvC,MAAM,KAAK,CAAC,oBAAoB,CAAC,CAAC;YAClC,MAAM,QAAQ,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC;QAC1C,CAAC;aAAM,CAAC;YACN,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAED,MAAM,IAAI,GAAG,MAAM,mBAAmB,CAAC,YAAY,CAAC,CAAC;IACrD,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;QAClB,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;IAC/B,CAAC;IAED,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;AACrC,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,YAAoB;IAEpB,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,sBAAsB,CAAC;IAErD,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,QAAQ,EAAE,CAAC;QAC7B,MAAM,IAAI,GAAG,MAAM,oBAAoB,CAAC,YAAY,CAAC,CAAC;QACtD,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;YAClB,OAAO,IAAI,CAAC;QACd,CAAC;QACD,MAAM,KAAK,CAAC,uBAAuB,CAAC,CAAC;IACvC,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,YAAoB;IAEpB,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,qBAAqB,CAAC;IAEpD,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,QAAQ,EAAE,CAAC;QAC7B,MAAM,IAAI,GAAG,MAAM,oBAAoB,CAAC,YAAY,CAAC,CAAC;QACtD,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;YAClB,OAAO;QACT,CAAC;QACD,MAAM,KAAK,CAAC,uBAAuB,CAAC,CAAC;IACvC,CAAC;AACH,CAAC;AAED,SAAS,KAAK,CAAC,EAAU;IACvB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AAC3D,CAAC"}

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

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

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

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

package/dist/services/instance-lifecycle.test.js

@@ -0,0 +1,152 @@
+import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
+vi.mock("../cdp/index.js", async (importOriginal) => {
+    const actual = await importOriginal();
+    return {
+        ...actual,
+        discoverInstancePort: vi.fn(),
+    };
+});
+import { discoverInstancePort } from "../cdp/index.js";
+import { StartInstanceError } from "./errors.js";
+import { startInstanceWithRecovery, waitForInstancePort, waitForInstanceShutdown, } from "./instance-lifecycle.js";
+function createMockLauncher(overrides = {}) {
+    return {
+        connect: vi.fn().mockResolvedValue(undefined),
+        disconnect: vi.fn(),
+        startInstance: vi.fn().mockResolvedValue(undefined),
+        stopInstance: vi.fn().mockResolvedValue(undefined),
+        listAccounts: vi.fn().mockResolvedValue([]),
+        ...overrides,
+    };
+}
+describe("startInstanceWithRecovery", () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+        vi.useFakeTimers({ shouldAdvanceTime: true });
+    });
+    afterEach(() => {
+        vi.useRealTimers();
+        vi.restoreAllMocks();
+    });
+    it("returns started with port on successful start", async () => {
+        const launcher = createMockLauncher();
+        vi.mocked(discoverInstancePort).mockResolvedValue(55123);
+        const result = await startInstanceWithRecovery(launcher, 42, 9222);
+        expect(launcher.startInstance).toHaveBeenCalledWith(42);
+        expect(result).toEqual({ status: "started", port: 55123 });
+    });
+    it("returns already_running when instance is running and port discoverable", async () => {
+        const launcher = createMockLauncher({
+            startInstance: vi
+                .fn()
+                .mockRejectedValue(new StartInstanceError(42, "account is already running")),
+        });
+        vi.mocked(discoverInstancePort).mockResolvedValue(55123);
+        const result = await startInstanceWithRecovery(launcher, 42, 9222);
+        expect(result).toEqual({ status: "already_running", port: 55123 });
+        expect(launcher.stopInstance).not.toHaveBeenCalled();
+    });
+    it("performs crash recovery when already running but no port", async () => {
+        const startInstance = vi
+            .fn()
+            .mockRejectedValueOnce(new StartInstanceError(42, "account is already running"))
+            .mockResolvedValueOnce(undefined);
+        const launcher = createMockLauncher({ startInstance });
+        // First call (already running check): no port → crash recovery
+        // After recovery + restart: port available
+        vi.mocked(discoverInstancePort)
+            .mockResolvedValueOnce(null)
+            .mockResolvedValue(55999);
+        const result = await startInstanceWithRecovery(launcher, 42, 9222);
+        expect(launcher.stopInstance).toHaveBeenCalledWith(42);
+        expect(startInstance).toHaveBeenCalledTimes(2);
+        expect(result).toEqual({ status: "started", port: 55999 });
+    });
+    it("returns timeout when port never becomes available", async () => {
+        const launcher = createMockLauncher();
+        vi.mocked(discoverInstancePort).mockResolvedValue(null);
+        const resultPromise = startInstanceWithRecovery(launcher, 42, 9222);
+        await vi.advanceTimersByTimeAsync(46_000);
+        const result = await resultPromise;
+        expect(result).toEqual({ status: "timeout" });
+    });
+    it("rethrows non-already-running StartInstanceError", async () => {
+        const launcher = createMockLauncher({
+            startInstance: vi
+                .fn()
+                .mockRejectedValue(new StartInstanceError(42, "license expired")),
+        });
+        await expect(startInstanceWithRecovery(launcher, 42, 9222)).rejects.toThrow("license expired");
+    });
+    it("rethrows non-StartInstanceError", async () => {
+        const launcher = createMockLauncher({
+            startInstance: vi
+                .fn()
+                .mockRejectedValue(new Error("network error")),
+        });
+        await expect(startInstanceWithRecovery(launcher, 42, 9222)).rejects.toThrow("network error");
+    });
+});
+describe("waitForInstancePort", () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+        vi.useFakeTimers({ shouldAdvanceTime: true });
+    });
+    afterEach(() => {
+        vi.useRealTimers();
+        vi.restoreAllMocks();
+    });
+    it("returns port immediately when available", async () => {
+        vi.mocked(discoverInstancePort).mockResolvedValue(55123);
+        const result = await waitForInstancePort(9222);
+        expect(result).toBe(55123);
+    });
+    it("polls until port becomes available", async () => {
+        vi.mocked(discoverInstancePort)
+            .mockResolvedValueOnce(null)
+            .mockResolvedValueOnce(null)
+            .mockResolvedValue(55123);
+        const result = await waitForInstancePort(9222);
+        expect(result).toBe(55123);
+        expect(discoverInstancePort).toHaveBeenCalledTimes(3);
+    });
+    it("returns null on timeout", async () => {
+        vi.mocked(discoverInstancePort).mockResolvedValue(null);
+        const resultPromise = waitForInstancePort(9222);
+        await vi.advanceTimersByTimeAsync(46_000);
+        const result = await resultPromise;
+        expect(result).toBeNull();
+    });
+});
+describe("waitForInstanceShutdown", () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+        vi.useFakeTimers({ shouldAdvanceTime: true });
+    });
+    afterEach(() => {
+        vi.useRealTimers();
+        vi.restoreAllMocks();
+    });
+    it("resolves immediately when no instance port is found", async () => {
+        vi.mocked(discoverInstancePort).mockResolvedValue(null);
+        await waitForInstanceShutdown(9222);
+        expect(discoverInstancePort).toHaveBeenCalledTimes(1);
+    });
+    it("polls until port disappears", async () => {
+        vi.mocked(discoverInstancePort)
+            .mockResolvedValueOnce(55123)
+            .mockResolvedValueOnce(55123)
+            .mockResolvedValue(null);
+        await waitForInstanceShutdown(9222);
+        expect(discoverInstancePort).toHaveBeenCalledTimes(3);
+    });
+    it("resolves after timeout even if port persists", async () => {
+        vi.mocked(discoverInstancePort).mockResolvedValue(55123);
+        const promise = waitForInstanceShutdown(9222);
+        await vi.advanceTimersByTimeAsync(46_000);
+        await promise;
+        // Should have polled multiple times then given up
+        expect(vi.mocked(discoverInstancePort).mock.calls.length).toBeGreaterThan(1);
+    });
+});
+//# sourceMappingURL=instance-lifecycle.test.js.map

package/dist/services/instance-lifecycle.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"instance-lifecycle.test.js","sourceRoot":"","sources":["../../src/services/instance-lifecycle.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAEzE,EAAE,CAAC,IAAI,CAAC,iBAAiB,EAAE,KAAK,EAAE,cAAc,EAAE,EAAE;IAClD,MAAM,MAAM,GAAG,MAAM,cAAc,EAAoC,CAAC;IACxE,OAAO;QACL,GAAG,MAAM;QACT,oBAAoB,EAAE,EAAE,CAAC,EAAE,EAAE;KAC9B,CAAC;AACJ,CAAC,CAAC,CAAC;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEjD,OAAO,EACL,yBAAyB,EACzB,mBAAmB,EACnB,uBAAuB,GACxB,MAAM,yBAAyB,CAAC;AAEjC,SAAS,kBAAkB,CACzB,YAA6D,EAAE;IAE/D,OAAO;QACL,OAAO,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,SAAS,CAAC;QAC7C,UAAU,EAAE,EAAE,CAAC,EAAE,EAAE;QACnB,aAAa,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,SAAS,CAAC;QACnD,YAAY,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,SAAS,CAAC;QAClD,YAAY,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,EAAE,CAAC;QAC3C,GAAG,SAAS;KACiB,CAAC;AAClC,CAAC;AAED,QAAQ,CAAC,2BAA2B,EAAE,GAAG,EAAE;IACzC,UAAU,CAAC,GAAG,EAAE;QACd,EAAE,CAAC,aAAa,EAAE,CAAC;QACnB,EAAE,CAAC,aAAa,CAAC,EAAE,iBAAiB,EAAE,IAAI,EAAE,CAAC,CAAC;IAChD,CAAC,CAAC,CAAC;IAEH,SAAS,CAAC,GAAG,EAAE;QACb,EAAE,CAAC,aAAa,EAAE,CAAC;QACnB,EAAE,CAAC,eAAe,EAAE,CAAC;IACvB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+CAA+C,EAAE,KAAK,IAAI,EAAE;QAC7D,MAAM,QAAQ,GAAG,kBAAkB,EAAE,CAAC;QACtC,EAAE,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAC;QAEzD,MAAM,MAAM,GAAG,MAAM,yBAAyB,CAAC,QAAQ,EAAE,EAAE,EAAE,IAAI,CAAC,CAAC;QAEnE,MAAM,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC,oBAAoB,CAAC,EAAE,CAAC,CAAC;QACxD,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IAC7D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wEAAwE,EAAE,KAAK,IAAI,EAAE;QACtF,MAAM,QAAQ,GAAG,kBAAkB,CAAC;YAClC,aAAa,EAAE,EAAE;iBACd,EAAE,EAAE;iBACJ,iBAAiB,CAChB,IAAI,kBAAkB,CAAC,EAAE,EAAE,4BAA4B,CAAC,CACzD;SACJ,CAAC,CAAC;QACH,EAAE,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAC;QAEzD,MAAM,MAAM,GAAG,MAAM,yBAAyB,CAAC,QAAQ,EAAE,EAAE,EAAE,IAAI,CAAC,CAAC;QAEnE,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,iBAAiB,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;QACnE,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC,GAAG,CAAC,gBAAgB,EAAE,CAAC;IACvD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0DAA0D,EAAE,KAAK,IAAI,EAAE;QACxE,MAAM,aAAa,GAAG,EAAE;aACrB,EAAE,EAAE;aACJ,qBAAqB,CACpB,IAAI,kBAAkB,CAAC,EAAE,EAAE,4BAA4B,CAAC,CACzD;aACA,qBAAqB,CAAC,SAAS,CAAC,CAAC;QAEpC,MAAM,QAAQ,GAAG,kBAAkB,CAAC,EAAE,aAAa,EAAE,CAAC,CAAC;QAEvD,+DAA+D;QAC/D,2CAA2C;QAC3C,EAAE,CAAC,MAAM,CAAC,oBAAoB,CAAC;aAC5B,qBAAqB,CAAC,IAAI,CAAC;aAC3B,iBAAiB,CAAC,KAAK,CAAC,CAAC;QAE5B,MAAM,MAAM,GAAG,MAAM,yBAAyB,CAAC,QAAQ,EAAE,EAAE,EAAE,IAAI,CAAC,CAAC;QAEnE,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC,oBAAoB,CAAC,EAAE,CAAC,CAAC;QACvD,MAAM,CAAC,aAAa,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC;QAC/C,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IAC7D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mDAAmD,EAAE,KAAK,IAAI,EAAE;QACjE,MAAM,QAAQ,GAAG,kBAAkB,EAAE,CAAC;QACtC,EAAE,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;QAExD,MAAM,aAAa,GAAG,yBAAyB,CAAC,QAAQ,EAAE,EAAE,EAAE,IAAI,CAAC,CAAC;QACpE,MAAM,EAAE,CAAC,wBAAwB,CAAC,MAAM,CAAC,CAAC;QAC1C,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC;QAEnC,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC;IAChD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iDAAiD,EAAE,KAAK,IAAI,EAAE;QAC/D,MAAM,QAAQ,GAAG,kBAAkB,CAAC;YAClC,aAAa,EAAE,EAAE;iBACd,EAAE,EAAE;iBACJ,iBAAiB,CAChB,IAAI,kBAAkB,CAAC,EAAE,EAAE,iBAAiB,CAAC,CAC9C;SACJ,CAAC,CAAC;QAEH,MAAM,MAAM,CACV,yBAAyB,CAAC,QAAQ,EAAE,EAAE,EAAE,IAAI,CAAC,CAC9C,CAAC,OAAO,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC;IACvC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iCAAiC,EAAE,KAAK,IAAI,EAAE;QAC/C,MAAM,QAAQ,GAAG,kBAAkB,CAAC;YAClC,aAAa,EAAE,EAAE;iBACd,EAAE,EAAE;iBACJ,iBAAiB,CAAC,IAAI,KAAK,CAAC,eAAe,CAAC,CAAC;SACjD,CAAC,CAAC;QAEH,MAAM,MAAM,CACV,yBAAyB,CAAC,QAAQ,EAAE,EAAE,EAAE,IAAI,CAAC,CAC9C,CAAC,OAAO,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC;IACrC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,qBAAqB,EAAE,GAAG,EAAE;IACnC,UAAU,CAAC,GAAG,EAAE;QACd,EAAE,CAAC,aAAa,EAAE,CAAC;QACnB,EAAE,CAAC,aAAa,CAAC,EAAE,iBAAiB,EAAE,IAAI,EAAE,CAAC,CAAC;IAChD,CAAC,CAAC,CAAC;IAEH,SAAS,CAAC,GAAG,EAAE;QACb,EAAE,CAAC,aAAa,EAAE,CAAC;QACnB,EAAE,CAAC,eAAe,EAAE,CAAC;IACvB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yCAAyC,EAAE,KAAK,IAAI,EAAE;QACvD,EAAE,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAC;QAEzD,MAAM,MAAM,GAAG,MAAM,mBAAmB,CAAC,IAAI,CAAC,CAAC;QAE/C,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC7B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oCAAoC,EAAE,KAAK,IAAI,EAAE;QAClD,EAAE,CAAC,MAAM,CAAC,oBAAoB,CAAC;aAC5B,qBAAqB,CAAC,IAAI,CAAC;aAC3B,qBAAqB,CAAC,IAAI,CAAC;aAC3B,iBAAiB,CAAC,KAAK,CAAC,CAAC;QAE5B,MAAM,MAAM,GAAG,MAAM,mBAAmB,CAAC,IAAI,CAAC,CAAC;QAE/C,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC3B,MAAM,CAAC,oBAAoB,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC;IACxD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yBAAyB,EAAE,KAAK,IAAI,EAAE;QACvC,EAAE,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;QAExD,MAAM,aAAa,GAAG,mBAAmB,CAAC,IAAI,CAAC,CAAC;QAChD,MAAM,EAAE,CAAC,wBAAwB,CAAC,MAAM,CAAC,CAAC;QAC1C,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC;QAEnC,MAAM,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,CAAC;IAC5B,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,yBAAyB,EAAE,GAAG,EAAE;IACvC,UAAU,CAAC,GAAG,EAAE;QACd,EAAE,CAAC,aAAa,EAAE,CAAC;QACnB,EAAE,CAAC,aAAa,CAAC,EAAE,iBAAiB,EAAE,IAAI,EAAE,CAAC,CAAC;IAChD,CAAC,CAAC,CAAC;IAEH,SAAS,CAAC,GAAG,EAAE;QACb,EAAE,CAAC,aAAa,EAAE,CAAC;QACnB,EAAE,CAAC,eAAe,EAAE,CAAC;IACvB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qDAAqD,EAAE,KAAK,IAAI,EAAE;QACnE,EAAE,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;QAExD,MAAM,uBAAuB,CAAC,IAAI,CAAC,CAAC;QAEpC,MAAM,CAAC,oBAAoB,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC;IACxD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6BAA6B,EAAE,KAAK,IAAI,EAAE;QAC3C,EAAE,CAAC,MAAM,CAAC,oBAAoB,CAAC;aAC5B,qBAAqB,CAAC,KAAK,CAAC;aAC5B,qBAAqB,CAAC,KAAK,CAAC;aAC5B,iBAAiB,CAAC,IAAI,CAAC,CAAC;QAE3B,MAAM,uBAAuB,CAAC,IAAI,CAAC,CAAC;QAEpC,MAAM,CAAC,oBAAoB,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC;IACxD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8CAA8C,EAAE,KAAK,IAAI,EAAE;QAC5D,EAAE,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAC;QAEzD,MAAM,OAAO,GAAG,uBAAuB,CAAC,IAAI,CAAC,CAAC;QAC9C,MAAM,EAAE,CAAC,wBAAwB,CAAC,MAAM,CAAC,CAAC;QAC1C,MAAM,OAAO,CAAC;QAEd,kDAAkD;QAClD,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;IAC/E,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/services/instance.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Controls a running LinkedHelper instance via CDP.
+ *
+ * An instance has two CDP targets on the same port:
+ * - **LinkedIn webview**: The Chromium page rendering linkedin.com
+ * - **Instance UI**: The Electron page hosting the LinkedHelper UI
+ *
+ * This service connects to both targets and provides methods for
+ * profile navigation and data extraction.
+ */
+export declare class InstanceService {
+    private readonly port;
+    private readonly host;
+    private linkedInClient;
+    private uiClient;
+    constructor(port: number, options?: {
+        host?: string;
+    });
+    /**
+     * Connect to both instance CDP targets (LinkedIn page and UI).
+     *
+     * The instance may still be loading LinkedIn after startup, so this
+     * method polls until both targets appear or the timeout is reached.
+     *
+     * @throws {InstanceNotRunningError} if the expected targets are not found within the timeout.
+     */
+    connect(): Promise<void>;
+    /**
+     * Disconnect from both targets.
+     */
+    disconnect(): void;
+    /**
+     * Navigate the LinkedIn webview to a profile URL.
+     *
+     * Enables the Page domain, navigates, and waits for the load event.
+     */
+    navigateToProfile(url: string): Promise<void>;
+    /**
+     * Trigger the SaveCurrentProfile action via the instance UI.
+     *
+     * This tells LinkedHelper to extract data from the currently
+     * displayed LinkedIn profile and save it to the database.
+     */
+    triggerExtraction(): Promise<void>;
+    /** Whether both clients are currently connected. */
+    get isConnected(): boolean;
+    private ensureLinkedInClient;
+    private ensureUiClient;
+}
+//# sourceMappingURL=instance.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"instance.d.ts","sourceRoot":"","sources":["../../src/services/instance.ts"],"names":[],"mappings":"AAUA;;;;;;;;;GASG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,cAAc,CAA0B;IAChD,OAAO,CAAC,QAAQ,CAA0B;gBAE9B,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE;IAKrD;;;;;;;OAOG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAyC9B;;OAEG;IACH,UAAU,IAAI,IAAI;IAOlB;;;;OAIG;IACG,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQnD;;;;;OAKG;IACG,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC;IAaxC,oDAAoD;IACpD,IAAI,WAAW,IAAI,OAAO,CAOzB;IAED,OAAO,CAAC,oBAAoB;IAO5B,OAAO,CAAC,cAAc;CAMvB"}

package/dist/services/instance.js

@@ -0,0 +1,121 @@
+import { CDPClient, discoverTargets } from "../cdp/index.js";
+import { InstanceNotRunningError, ServiceError } from "./errors.js";
+/** Maximum time to wait for both CDP targets to appear (ms). */
+const CONNECT_TIMEOUT = 30_000;
+/** Interval between target discovery polls (ms). */
+const CONNECT_POLL_INTERVAL = 1_000;
+/**
+ * Controls a running LinkedHelper instance via CDP.
+ *
+ * An instance has two CDP targets on the same port:
+ * - **LinkedIn webview**: The Chromium page rendering linkedin.com
+ * - **Instance UI**: The Electron page hosting the LinkedHelper UI
+ *
+ * This service connects to both targets and provides methods for
+ * profile navigation and data extraction.
+ */
+export class InstanceService {
+    port;
+    host;
+    linkedInClient = null;
+    uiClient = null;
+    constructor(port, options) {
+        this.port = port;
+        this.host = options?.host ?? "127.0.0.1";
+    }
+    /**
+     * Connect to both instance CDP targets (LinkedIn page and UI).
+     *
+     * The instance may still be loading LinkedIn after startup, so this
+     * method polls until both targets appear or the timeout is reached.
+     *
+     * @throws {InstanceNotRunningError} if the expected targets are not found within the timeout.
+     */
+    async connect() {
+        const deadline = Date.now() + CONNECT_TIMEOUT;
+        let targets = [];
+        let linkedInTarget;
+        let uiTarget;
+        while (Date.now() < deadline) {
+            targets = await discoverTargets(this.port, this.host);
+            linkedInTarget = targets.find(isLinkedInTarget);
+            uiTarget = targets.find(isUiTarget);
+            if (linkedInTarget && uiTarget) {
+                break;
+            }
+            await new Promise((resolve) => setTimeout(resolve, CONNECT_POLL_INTERVAL));
+        }
+        if (!linkedInTarget) {
+            throw new InstanceNotRunningError(`LinkedIn webview target not found among ${String(targets.length)} CDP target(s) on port ${String(this.port)}`);
+        }
+        if (!uiTarget) {
+            throw new InstanceNotRunningError(`Instance UI target not found among ${String(targets.length)} CDP target(s) on port ${String(this.port)}`);
+        }
+        const liClient = new CDPClient(this.port, { host: this.host });
+        await liClient.connect(linkedInTarget.id);
+        const ui = new CDPClient(this.port, { host: this.host });
+        await ui.connect(uiTarget.id);
+        this.linkedInClient = liClient;
+        this.uiClient = ui;
+    }
+    /**
+     * Disconnect from both targets.
+     */
+    disconnect() {
+        this.linkedInClient?.disconnect();
+        this.linkedInClient = null;
+        this.uiClient?.disconnect();
+        this.uiClient = null;
+    }
+    /**
+     * Navigate the LinkedIn webview to a profile URL.
+     *
+     * Enables the Page domain, navigates, and waits for the load event.
+     */
+    async navigateToProfile(url) {
+        const client = this.ensureLinkedInClient();
+        await client.send("Page.enable");
+        await client.navigate(url);
+        await client.waitForEvent("Page.loadEventFired");
+    }
+    /**
+     * Trigger the SaveCurrentProfile action via the instance UI.
+     *
+     * This tells LinkedHelper to extract data from the currently
+     * displayed LinkedIn profile and save it to the database.
+     */
+    async triggerExtraction() {
+        const client = this.ensureUiClient();
+        await client.evaluate(`(async () => {
+        const mws = window.mainWindowService;
+        if (!mws) throw new Error('mainWindowService not found on window');
+        return await mws.call('executeSingleAction', 'SaveCurrentProfile', {});
+      })()`, true);
+    }
+    /** Whether both clients are currently connected. */
+    get isConnected() {
+        return (this.linkedInClient !== null &&
+            this.linkedInClient.isConnected &&
+            this.uiClient !== null &&
+            this.uiClient.isConnected);
+    }
+    ensureLinkedInClient() {
+        if (!this.linkedInClient) {
+            throw new ServiceError("InstanceService is not connected (LinkedIn target)");
+        }
+        return this.linkedInClient;
+    }
+    ensureUiClient() {
+        if (!this.uiClient) {
+            throw new ServiceError("InstanceService is not connected (UI target)");
+        }
+        return this.uiClient;
+    }
+}
+function isLinkedInTarget(target) {
+    return target.type === "page" && target.url.includes("linkedin.com");
+}
+function isUiTarget(target) {
+    return target.type === "page" && target.url.includes("index.html");
+}
+//# sourceMappingURL=instance.js.map

package/dist/services/instance.js.map

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

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

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

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

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

package/dist/services/instance.test.js

@@ -0,0 +1,181 @@
+import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
+import { ServiceError } from "./errors.js";
+import { InstanceService } from "./instance.js";
+/** All created client mocks, in creation order. */
+let clientInstances = [];
+/** Lookup by target ID after connect() is called. */
+let clientsByTargetId = new Map();
+vi.mock("../cdp/index.js", () => ({
+    CDPClient: vi.fn().mockImplementation(function () {
+        const mocks = {
+            connect: vi.fn().mockImplementation(async (targetId) => {
+                if (targetId) {
+                    clientsByTargetId.set(targetId, mocks);
+                }
+            }),
+            disconnect: vi.fn(),
+            send: vi.fn().mockResolvedValue(undefined),
+            navigate: vi.fn().mockResolvedValue({ frameId: "F1" }),
+            evaluate: vi.fn().mockResolvedValue(undefined),
+            waitForEvent: vi.fn().mockResolvedValue(undefined),
+            isConnected: vi.fn().mockReturnValue(true),
+        };
+        clientInstances.push(mocks);
+        this.connect = mocks.connect;
+        this.disconnect = mocks.disconnect;
+        this.send = mocks.send;
+        this.navigate = mocks.navigate;
+        this.evaluate = mocks.evaluate;
+        this.waitForEvent = mocks.waitForEvent;
+        Object.defineProperty(this, "isConnected", {
+            get: mocks.isConnected,
+        });
+    }),
+    discoverTargets: vi.fn(),
+}));
+import { discoverTargets } from "../cdp/index.js";
+const mockedDiscoverTargets = vi.mocked(discoverTargets);
+function makeTarget(overrides) {
+    return {
+        description: "",
+        devtoolsFrontendUrl: "",
+        id: "DEFAULT",
+        title: "Test",
+        type: "page",
+        url: "about:blank",
+        webSocketDebuggerUrl: "ws://127.0.0.1:9223/devtools/page/DEFAULT",
+        ...overrides,
+    };
+}
+const LINKEDIN_TARGET = makeTarget({
+    id: "LI1",
+    url: "https://www.linkedin.com/feed/",
+    title: "LinkedIn Feed",
+});
+const UI_TARGET = makeTarget({
+    id: "UI1",
+    url: "chrome-extension://abc/index.html#/",
+    title: "LinkedHelper",
+});
+function getClientMocks(targetId) {
+    const mocks = clientsByTargetId.get(targetId);
+    if (!mocks) {
+        throw new Error(`No CDPClient mock found for target ${targetId}`);
+    }
+    return mocks;
+}
+beforeEach(() => {
+    clientInstances = [];
+    clientsByTargetId = new Map();
+});
+afterEach(() => {
+    vi.useRealTimers();
+    vi.restoreAllMocks();
+});
+describe("InstanceService", () => {
+    let service;
+    beforeEach(() => {
+        service = new InstanceService(9223);
+    });
+    describe("connect", () => {
+        it("discovers targets and connects to both on first poll", async () => {
+            mockedDiscoverTargets.mockResolvedValue([LINKEDIN_TARGET, UI_TARGET]);
+            await service.connect();
+            expect(service.isConnected).toBe(true);
+            expect(clientInstances).toHaveLength(2);
+            expect(clientsByTargetId.has("LI1")).toBe(true);
+            expect(clientsByTargetId.has("UI1")).toBe(true);
+        });
+        it("polls until both targets appear", async () => {
+            vi.useFakeTimers();
+            mockedDiscoverTargets
+                .mockResolvedValueOnce([UI_TARGET])
+                .mockResolvedValueOnce([UI_TARGET])
+                .mockResolvedValue([LINKEDIN_TARGET, UI_TARGET]);
+            const connectPromise = service.connect();
+            await vi.advanceTimersByTimeAsync(5_000);
+            await connectPromise;
+            expect(service.isConnected).toBe(true);
+            expect(mockedDiscoverTargets.mock.calls.length).toBeGreaterThanOrEqual(3);
+            vi.useRealTimers();
+        });
+        it("throws InstanceNotRunningError when no LinkedIn target", async () => {
+            vi.useFakeTimers();
+            mockedDiscoverTargets.mockResolvedValue([UI_TARGET]);
+            const promise = service.connect();
+            const assertion = expect(promise).rejects.toThrow(/LinkedIn webview target not found/);
+            await vi.advanceTimersByTimeAsync(31_000);
+            await assertion;
+            vi.useRealTimers();
+        });
+        it("throws InstanceNotRunningError when no UI target", async () => {
+            vi.useFakeTimers();
+            mockedDiscoverTargets.mockResolvedValue([LINKEDIN_TARGET]);
+            const promise = service.connect();
+            const assertion = expect(promise).rejects.toThrow(/Instance UI target not found/);
+            await vi.advanceTimersByTimeAsync(31_000);
+            await assertion;
+            vi.useRealTimers();
+        });
+        it("throws InstanceNotRunningError when no targets at all", async () => {
+            vi.useFakeTimers();
+            mockedDiscoverTargets.mockResolvedValue([]);
+            const promise = service.connect();
+            const assertion = expect(promise).rejects.toThrow(/LinkedIn webview target not found.*0 CDP target/);
+            await vi.advanceTimersByTimeAsync(31_000);
+            await assertion;
+            vi.useRealTimers();
+        });
+    });
+    describe("disconnect", () => {
+        it("disconnects both clients", async () => {
+            mockedDiscoverTargets.mockResolvedValue([LINKEDIN_TARGET, UI_TARGET]);
+            await service.connect();
+            service.disconnect();
+            const liClient = getClientMocks("LI1");
+            const uiClient = getClientMocks("UI1");
+            expect(liClient.disconnect).toHaveBeenCalledTimes(1);
+            expect(uiClient.disconnect).toHaveBeenCalledTimes(1);
+        });
+        it("does not throw when not connected", () => {
+            expect(() => service.disconnect()).not.toThrow();
+        });
+    });
+    describe("navigateToProfile", () => {
+        it("calls Page.enable, navigate, and waitForEvent on the LinkedIn client", async () => {
+            mockedDiscoverTargets.mockResolvedValue([LINKEDIN_TARGET, UI_TARGET]);
+            await service.connect();
+            await service.navigateToProfile("https://www.linkedin.com/in/test-user");
+            const liClient = getClientMocks("LI1");
+            const uiClient = getClientMocks("UI1");
+            // LinkedIn client should have received navigation calls
+            expect(liClient.send).toHaveBeenCalledWith("Page.enable");
+            expect(liClient.navigate).toHaveBeenCalledWith("https://www.linkedin.com/in/test-user");
+            expect(liClient.waitForEvent).toHaveBeenCalledWith("Page.loadEventFired");
+            // UI client should NOT have received any navigation calls
+            expect(uiClient.send).not.toHaveBeenCalled();
+            expect(uiClient.navigate).not.toHaveBeenCalled();
+            expect(uiClient.waitForEvent).not.toHaveBeenCalled();
+        });
+        it("throws ServiceError when not connected", async () => {
+            await expect(service.navigateToProfile("https://www.linkedin.com/in/test")).rejects.toThrow(ServiceError);
+        });
+    });
+    describe("triggerExtraction", () => {
+        it("evaluates SaveCurrentProfile on the UI client only", async () => {
+            mockedDiscoverTargets.mockResolvedValue([LINKEDIN_TARGET, UI_TARGET]);
+            await service.connect();
+            await service.triggerExtraction();
+            const liClient = getClientMocks("LI1");
+            const uiClient = getClientMocks("UI1");
+            // UI client should have received the extraction call
+            expect(uiClient.evaluate).toHaveBeenCalledWith(expect.stringContaining("SaveCurrentProfile"), true);
+            // LinkedIn client should NOT have received any evaluate call
+            expect(liClient.evaluate).not.toHaveBeenCalled();
+        });
+        it("throws ServiceError when not connected", async () => {
+            await expect(service.triggerExtraction()).rejects.toThrow(ServiceError);
+        });
+    });
+});
+//# sourceMappingURL=instance.test.js.map

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

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

package/dist/services/launcher.d.ts

@@ -0,0 +1,51 @@
+import type { Account, InstanceStatus } from "../types/index.js";
+/**
+ * Controls the LinkedHelper launcher process via CDP.
+ *
+ * The launcher is the main Electron window that manages LinkedIn
+ * account instances.  This service connects to it and provides
+ * methods to start/stop instances and query accounts.
+ */
+export declare class LauncherService {
+    private readonly port;
+    private readonly host;
+    private client;
+    constructor(port?: number, options?: {
+        host?: string;
+    });
+    /**
+     * Connect to the LinkedHelper launcher via CDP.
+     *
+     * @throws {LinkedHelperNotRunningError} if the launcher is not reachable.
+     */
+    connect(): Promise<void>;
+    /**
+     * Disconnect from the launcher.
+     */
+    disconnect(): void;
+    /**
+     * Start a LinkedHelper instance for the given account.
+     *
+     * @throws {StartInstanceError} if the instance fails to start.
+     */
+    startInstance(accountId: number): Promise<void>;
+    /**
+     * Stop a running LinkedHelper instance.
+     */
+    stopInstance(accountId: number): Promise<void>;
+    /**
+     * Query the status of an instance for the given account.
+     */
+    getInstanceStatus(accountId: number): Promise<InstanceStatus>;
+    /**
+     * List all accounts configured in the LinkedHelper Electron store.
+     *
+     * Accounts are discovered from the `linkedInPasswords` store key whose
+     * entries use the format `userId:li:accountId`.
+     */
+    listAccounts(): Promise<Account[]>;
+    /** Whether the service is currently connected to the launcher. */
+    get isConnected(): boolean;
+    private ensureConnected;
+}
+//# sourceMappingURL=launcher.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"launcher.d.ts","sourceRoot":"","sources":["../../src/services/launcher.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,OAAO,EACP,cAAc,EAEf,MAAM,mBAAmB,CAAC;AAU3B;;;;;;GAMG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,MAAM,CAA0B;gBAGtC,IAAI,GAAE,MAA8B,EACpC,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE;IAM7B;;;;OAIG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAa9B;;OAEG;IACH,UAAU,IAAI,IAAI;IAKlB;;;;OAIG;IACG,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAkCrD;;OAEG;IACG,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAapD;;OAEG;IACG,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAmBnE;;;;;OAKG;IACG,YAAY,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;IA6BxC,kEAAkE;IAClE,IAAI,WAAW,IAAI,OAAO,CAEzB;IAED,OAAO,CAAC,eAAe;CAMxB"}