@lhremote/cli 0.0.0 → 0.2.0

package/dist/handlers/scrape-messaging-history.test.js

@@ -0,0 +1,101 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
+vi.mock("@lhremote/core", async (importOriginal) => {
+    const actual = await importOriginal();
+    return {
+        ...actual,
+        scrapeMessagingHistory: vi.fn(),
+    };
+});
+import { InstanceNotRunningError, scrapeMessagingHistory, } from "@lhremote/core";
+import { handleScrapeMessagingHistory } from "./scrape-messaging-history.js";
+import { getStderr, getStdout } from "./testing/mock-helpers.js";
+const MOCK_STATS = {
+    totalChats: 42,
+    totalMessages: 256,
+    earliestMessage: "2024-06-01T10:00:00Z",
+    latestMessage: "2025-01-15T14:00:00Z",
+};
+const MOCK_RESULT = {
+    success: true,
+    actionType: "ScrapeMessagingHistory",
+    stats: MOCK_STATS,
+};
+describe("handleScrapeMessagingHistory", () => {
+    const originalExitCode = process.exitCode;
+    let stdoutSpy;
+    let stderrSpy;
+    beforeEach(() => {
+        process.exitCode = undefined;
+        vi.clearAllMocks();
+        stdoutSpy = vi.spyOn(process.stdout, "write").mockReturnValue(true);
+        stderrSpy = vi.spyOn(process.stderr, "write").mockReturnValue(true);
+    });
+    afterEach(() => {
+        process.exitCode = originalExitCode;
+        vi.restoreAllMocks();
+    });
+    it("prints JSON with --json", async () => {
+        vi.mocked(scrapeMessagingHistory).mockResolvedValue(MOCK_RESULT);
+        await handleScrapeMessagingHistory({ json: true });
+        expect(process.exitCode).toBeUndefined();
+        const output = JSON.parse(getStdout(stdoutSpy));
+        expect(output.success).toBe(true);
+        expect(output.actionType).toBe("ScrapeMessagingHistory");
+        expect(output.stats).toEqual(MOCK_STATS);
+    });
+    it("prints human-readable output by default", async () => {
+        vi.mocked(scrapeMessagingHistory).mockResolvedValue(MOCK_RESULT);
+        await handleScrapeMessagingHistory({});
+        expect(process.exitCode).toBeUndefined();
+        const output = getStdout(stdoutSpy);
+        expect(output).toContain("42 conversations");
+        expect(output).toContain("256 messages");
+        expect(output).toContain("2024-06-01");
+        expect(output).toContain("2025-01-15");
+    });
+    it("prints progress to stderr", async () => {
+        vi.mocked(scrapeMessagingHistory).mockResolvedValue(MOCK_RESULT);
+        await handleScrapeMessagingHistory({});
+        const stderr = getStderr(stderrSpy);
+        expect(stderr).toContain("Scraping messaging history");
+        expect(stderr).toContain("Done.");
+    });
+    it("omits date range when no messages", async () => {
+        vi.mocked(scrapeMessagingHistory).mockResolvedValue({
+            success: true,
+            actionType: "ScrapeMessagingHistory",
+            stats: {
+                totalChats: 0,
+                totalMessages: 0,
+                earliestMessage: null,
+                latestMessage: null,
+            },
+        });
+        await handleScrapeMessagingHistory({});
+        expect(process.exitCode).toBeUndefined();
+        const output = getStdout(stdoutSpy);
+        expect(output).toContain("0 conversations");
+        expect(output).not.toContain("Date range");
+    });
+    it("sets exitCode 1 when resolveAccount fails", async () => {
+        vi.mocked(scrapeMessagingHistory).mockRejectedValue(new Error("No accounts found."));
+        await handleScrapeMessagingHistory({});
+        expect(process.exitCode).toBe(1);
+        expect(getStderr(stderrSpy)).toContain("No accounts found.");
+    });
+    it("sets exitCode 1 when instance not running", async () => {
+        vi.mocked(scrapeMessagingHistory).mockRejectedValue(new InstanceNotRunningError("No LinkedHelper instance is running. Use start-instance first."));
+        await handleScrapeMessagingHistory({});
+        expect(process.exitCode).toBe(1);
+        expect(getStderr(stderrSpy)).toContain("No LinkedHelper instance is running.");
+    });
+    it("sets exitCode 1 on unexpected error", async () => {
+        vi.mocked(scrapeMessagingHistory).mockRejectedValue(new Error("connection reset"));
+        await handleScrapeMessagingHistory({});
+        expect(process.exitCode).toBe(1);
+        expect(getStderr(stderrSpy)).toContain("connection reset");
+    });
+});
+//# sourceMappingURL=scrape-messaging-history.test.js.map

package/dist/handlers/scrape-messaging-history.test.js.map

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

package/dist/handlers/start-instance.d.ts

@@ -0,0 +1,7 @@
+/** Handle the {@link https://github.com/alexey-pelykh/lhremote#account--instance | start-instance} CLI command. */
+export declare function handleStartInstance(accountIdArg: string, options: {
+    cdpPort?: number;
+    cdpHost?: string;
+    allowRemote?: boolean;
+}): Promise<void>;
+//# sourceMappingURL=start-instance.d.ts.map

package/dist/handlers/start-instance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"start-instance.d.ts","sourceRoot":"","sources":["../../src/handlers/start-instance.ts"],"names":[],"mappings":"AAUA,mHAAmH;AACnH,wBAAsB,mBAAmB,CACvC,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,OAAO,CAAA;CAAE,GACrE,OAAO,CAAC,IAAI,CAAC,CA+Cf"}

package/dist/handlers/start-instance.js

@@ -0,0 +1,42 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+import { DEFAULT_CDP_PORT, errorMessage, LauncherService, startInstanceWithRecovery, } from "@lhremote/core";
+/** Handle the {@link https://github.com/alexey-pelykh/lhremote#account--instance | start-instance} CLI command. */
+export async function handleStartInstance(accountIdArg, options) {
+    const accountId = Number(accountIdArg);
+    const cdpPort = options.cdpPort ?? DEFAULT_CDP_PORT;
+    const launcher = new LauncherService(cdpPort, {
+        ...(options.cdpHost !== undefined && { host: options.cdpHost }),
+        ...(options.allowRemote !== undefined && { allowRemote: options.allowRemote }),
+    });
+    try {
+        await launcher.connect();
+    }
+    catch (error) {
+        const message = errorMessage(error);
+        process.stderr.write(`${message}\n`);
+        process.exitCode = 1;
+        return;
+    }
+    try {
+        const outcome = await startInstanceWithRecovery(launcher, accountId, cdpPort);
+        if (outcome.status === "timeout") {
+            process.stderr.write("Instance started but failed to initialize within timeout.\n");
+            process.exitCode = 1;
+            return;
+        }
+        const verb = outcome.status === "already_running"
+            ? "already running"
+            : "started";
+        process.stdout.write(`Instance ${verb} for account ${String(accountId)} on CDP port ${String(outcome.port)}\n`);
+    }
+    catch (error) {
+        const message = errorMessage(error);
+        process.stderr.write(`${message}\n`);
+        process.exitCode = 1;
+    }
+    finally {
+        launcher.disconnect();
+    }
+}
+//# sourceMappingURL=start-instance.js.map

package/dist/handlers/start-instance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"start-instance.js","sourceRoot":"","sources":["../../src/handlers/start-instance.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,oCAAoC;AAEpC,OAAO,EACL,gBAAgB,EAChB,YAAY,EACZ,eAAe,EACf,yBAAyB,GAC1B,MAAM,gBAAgB,CAAC;AAExB,mHAAmH;AACnH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,YAAoB,EACpB,OAAsE;IAEtE,MAAM,SAAS,GAAG,MAAM,CAAC,YAAY,CAAC,CAAC;IACvC,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,gBAAgB,CAAC;IACpD,MAAM,QAAQ,GAAG,IAAI,eAAe,CAAC,OAAO,EAAE;QAC5C,GAAG,CAAC,OAAO,CAAC,OAAO,KAAK,SAAS,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC;QAC/D,GAAG,CAAC,OAAO,CAAC,WAAW,KAAK,SAAS,IAAI,EAAE,WAAW,EAAE,OAAO,CAAC,WAAW,EAAE,CAAC;KAC/E,CAAC,CAAC;IAEH,IAAI,CAAC;QACH,MAAM,QAAQ,CAAC,OAAO,EAAE,CAAC;IAC3B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,OAAO,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;QACpC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,OAAO,IAAI,CAAC,CAAC;QACrC,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;QACrB,OAAO;IACT,CAAC;IAED,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,yBAAyB,CAC7C,QAAQ,EACR,SAAS,EACT,OAAO,CACR,CAAC;QAEF,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YACjC,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,6DAA6D,CAC9D,CAAC;YACF,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;YACrB,OAAO;QACT,CAAC;QAED,MAAM,IAAI,GACR,OAAO,CAAC,MAAM,KAAK,iBAAiB;YAClC,CAAC,CAAC,iBAAiB;YACnB,CAAC,CAAC,SAAS,CAAC;QAEhB,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,YAAY,IAAI,gBAAgB,MAAM,CAAC,SAAS,CAAC,gBAAgB,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAC1F,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,OAAO,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;QACpC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,OAAO,IAAI,CAAC,CAAC;QACrC,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;IACvB,CAAC;YAAS,CAAC;QACT,QAAQ,CAAC,UAAU,EAAE,CAAC;IACxB,CAAC;AACH,CAAC"}

package/dist/handlers/start-instance.test.d.ts

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

package/dist/handlers/start-instance.test.d.ts.map

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

package/dist/handlers/start-instance.test.js

@@ -0,0 +1,97 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
+vi.mock("@lhremote/core", async (importOriginal) => {
+    const actual = await importOriginal();
+    return {
+        ...actual,
+        LauncherService: vi.fn(),
+        startInstanceWithRecovery: vi.fn(),
+    };
+});
+import { LauncherService, LinkedHelperNotRunningError, startInstanceWithRecovery, } from "@lhremote/core";
+import { handleStartInstance } from "./start-instance.js";
+import { mockLauncher } from "./testing/mock-helpers.js";
+describe("handleStartInstance", () => {
+    const originalExitCode = process.exitCode;
+    beforeEach(() => {
+        process.exitCode = undefined;
+        vi.clearAllMocks();
+    });
+    afterEach(() => {
+        process.exitCode = originalExitCode;
+        vi.restoreAllMocks();
+    });
+    it("prints success with port on successful start", async () => {
+        const stdoutSpy = vi
+            .spyOn(process.stdout, "write")
+            .mockReturnValue(true);
+        mockLauncher();
+        vi.mocked(startInstanceWithRecovery).mockResolvedValue({
+            status: "started",
+            port: 55123,
+        });
+        await handleStartInstance("42", {});
+        expect(stdoutSpy).toHaveBeenCalledWith("Instance started for account 42 on CDP port 55123\n");
+        expect(process.exitCode).toBeUndefined();
+    });
+    it("sets exitCode 1 on connection error", async () => {
+        const stderrSpy = vi
+            .spyOn(process.stderr, "write")
+            .mockReturnValue(true);
+        mockLauncher({
+            connect: vi
+                .fn()
+                .mockRejectedValue(new LinkedHelperNotRunningError(9222)),
+        });
+        await handleStartInstance("42", {});
+        expect(process.exitCode).toBe(1);
+        expect(stderrSpy).toHaveBeenCalledWith(expect.stringContaining("not running"));
+    });
+    it("handles idempotent 'already running' when port available", async () => {
+        const stdoutSpy = vi
+            .spyOn(process.stdout, "write")
+            .mockReturnValue(true);
+        mockLauncher();
+        vi.mocked(startInstanceWithRecovery).mockResolvedValue({
+            status: "already_running",
+            port: 55123,
+        });
+        await handleStartInstance("42", {});
+        expect(stdoutSpy).toHaveBeenCalledWith("Instance already running for account 42 on CDP port 55123\n");
+        expect(process.exitCode).toBeUndefined();
+    });
+    it("sets exitCode 1 on unexpected error", async () => {
+        const stderrSpy = vi
+            .spyOn(process.stderr, "write")
+            .mockReturnValue(true);
+        mockLauncher();
+        vi.mocked(startInstanceWithRecovery).mockRejectedValue(new Error("unexpected failure"));
+        await handleStartInstance("42", {});
+        expect(process.exitCode).toBe(1);
+        expect(stderrSpy).toHaveBeenCalledWith(expect.stringContaining("unexpected failure"));
+    });
+    it("passes cdpPort option to LauncherService", async () => {
+        vi.spyOn(process.stdout, "write").mockReturnValue(true);
+        mockLauncher();
+        vi.mocked(startInstanceWithRecovery).mockResolvedValue({
+            status: "started",
+            port: 55123,
+        });
+        await handleStartInstance("42", { cdpPort: 4567 });
+        expect(LauncherService).toHaveBeenCalledWith(4567, {});
+    });
+    it("sets exitCode 1 when instance fails to initialize within timeout", async () => {
+        const stderrSpy = vi
+            .spyOn(process.stderr, "write")
+            .mockReturnValue(true);
+        mockLauncher();
+        vi.mocked(startInstanceWithRecovery).mockResolvedValue({
+            status: "timeout",
+        });
+        await handleStartInstance("42", {});
+        expect(process.exitCode).toBe(1);
+        expect(stderrSpy).toHaveBeenCalledWith("Instance started but failed to initialize within timeout.\n");
+    });
+});
+//# sourceMappingURL=start-instance.test.js.map

package/dist/handlers/start-instance.test.js.map

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

package/dist/handlers/stop-instance.d.ts

@@ -0,0 +1,7 @@
+/** Handle the {@link https://github.com/alexey-pelykh/lhremote#account--instance | stop-instance} CLI command. */
+export declare function handleStopInstance(accountIdArg: string, options: {
+    cdpPort?: number;
+    cdpHost?: string;
+    allowRemote?: boolean;
+}): Promise<void>;
+//# sourceMappingURL=stop-instance.d.ts.map

package/dist/handlers/stop-instance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stop-instance.d.ts","sourceRoot":"","sources":["../../src/handlers/stop-instance.ts"],"names":[],"mappings":"AAKA,kHAAkH;AAClH,wBAAsB,kBAAkB,CACtC,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,OAAO,CAAA;CAAE,GACrE,OAAO,CAAC,IAAI,CAAC,CA6Bf"}

package/dist/handlers/stop-instance.js

@@ -0,0 +1,34 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+import { DEFAULT_CDP_PORT, errorMessage, LauncherService } from "@lhremote/core";
+/** Handle the {@link https://github.com/alexey-pelykh/lhremote#account--instance | stop-instance} CLI command. */
+export async function handleStopInstance(accountIdArg, options) {
+    const accountId = Number(accountIdArg);
+    const cdpPort = options.cdpPort ?? DEFAULT_CDP_PORT;
+    const launcher = new LauncherService(cdpPort, {
+        ...(options.cdpHost !== undefined && { host: options.cdpHost }),
+        ...(options.allowRemote !== undefined && { allowRemote: options.allowRemote }),
+    });
+    try {
+        await launcher.connect();
+    }
+    catch (error) {
+        const message = errorMessage(error);
+        process.stderr.write(`${message}\n`);
+        process.exitCode = 1;
+        return;
+    }
+    try {
+        await launcher.stopInstance(accountId);
+        process.stdout.write(`Instance stopped for account ${String(accountId)}\n`);
+    }
+    catch (error) {
+        const message = errorMessage(error);
+        process.stderr.write(`${message}\n`);
+        process.exitCode = 1;
+    }
+    finally {
+        launcher.disconnect();
+    }
+}
+//# sourceMappingURL=stop-instance.js.map

package/dist/handlers/stop-instance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stop-instance.js","sourceRoot":"","sources":["../../src/handlers/stop-instance.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,oCAAoC;AAEpC,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEjF,kHAAkH;AAClH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,YAAoB,EACpB,OAAsE;IAEtE,MAAM,SAAS,GAAG,MAAM,CAAC,YAAY,CAAC,CAAC;IACvC,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,gBAAgB,CAAC;IACpD,MAAM,QAAQ,GAAG,IAAI,eAAe,CAAC,OAAO,EAAE;QAC5C,GAAG,CAAC,OAAO,CAAC,OAAO,KAAK,SAAS,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC;QAC/D,GAAG,CAAC,OAAO,CAAC,WAAW,KAAK,SAAS,IAAI,EAAE,WAAW,EAAE,OAAO,CAAC,WAAW,EAAE,CAAC;KAC/E,CAAC,CAAC;IAEH,IAAI,CAAC;QACH,MAAM,QAAQ,CAAC,OAAO,EAAE,CAAC;IAC3B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,OAAO,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;QACpC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,OAAO,IAAI,CAAC,CAAC;QACrC,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;QACrB,OAAO;IACT,CAAC;IAED,IAAI,CAAC;QACH,MAAM,QAAQ,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC;QACvC,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,gCAAgC,MAAM,CAAC,SAAS,CAAC,IAAI,CACtD,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,OAAO,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;QACpC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,OAAO,IAAI,CAAC,CAAC;QACrC,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;IACvB,CAAC;YAAS,CAAC;QACT,QAAQ,CAAC,UAAU,EAAE,CAAC;IACxB,CAAC;AACH,CAAC"}

package/dist/handlers/stop-instance.test.d.ts

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

package/dist/handlers/stop-instance.test.d.ts.map

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

package/dist/handlers/stop-instance.test.js

@@ -0,0 +1,66 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
+vi.mock("@lhremote/core", async (importOriginal) => {
+    const actual = await importOriginal();
+    return {
+        ...actual,
+        LauncherService: vi.fn(),
+    };
+});
+import { LauncherService, LinkedHelperNotRunningError, } from "@lhremote/core";
+import { handleStopInstance } from "./stop-instance.js";
+import { mockLauncher } from "./testing/mock-helpers.js";
+describe("handleStopInstance", () => {
+    const originalExitCode = process.exitCode;
+    beforeEach(() => {
+        process.exitCode = undefined;
+        vi.clearAllMocks();
+    });
+    afterEach(() => {
+        process.exitCode = originalExitCode;
+        vi.restoreAllMocks();
+    });
+    it("prints success on successful stop", async () => {
+        const stdoutSpy = vi
+            .spyOn(process.stdout, "write")
+            .mockReturnValue(true);
+        mockLauncher({ stopInstance: vi.fn().mockResolvedValue(undefined) });
+        await handleStopInstance("42", {});
+        expect(stdoutSpy).toHaveBeenCalledWith("Instance stopped for account 42\n");
+        expect(process.exitCode).toBeUndefined();
+    });
+    it("sets exitCode 1 on connection error", async () => {
+        const stderrSpy = vi
+            .spyOn(process.stderr, "write")
+            .mockReturnValue(true);
+        mockLauncher({
+            connect: vi
+                .fn()
+                .mockRejectedValue(new LinkedHelperNotRunningError(9222)),
+        });
+        await handleStopInstance("42", {});
+        expect(process.exitCode).toBe(1);
+        expect(stderrSpy).toHaveBeenCalledWith(expect.stringContaining("not running"));
+    });
+    it("sets exitCode 1 on unexpected error", async () => {
+        const stderrSpy = vi
+            .spyOn(process.stderr, "write")
+            .mockReturnValue(true);
+        mockLauncher({
+            stopInstance: vi
+                .fn()
+                .mockRejectedValue(new Error("unexpected failure")),
+        });
+        await handleStopInstance("42", {});
+        expect(process.exitCode).toBe(1);
+        expect(stderrSpy).toHaveBeenCalledWith("unexpected failure\n");
+    });
+    it("passes cdpPort option to LauncherService", async () => {
+        vi.spyOn(process.stdout, "write").mockReturnValue(true);
+        mockLauncher({ stopInstance: vi.fn().mockResolvedValue(undefined) });
+        await handleStopInstance("42", { cdpPort: 4567 });
+        expect(LauncherService).toHaveBeenCalledWith(4567, {});
+    });
+});
+//# sourceMappingURL=stop-instance.test.js.map

package/dist/handlers/stop-instance.test.js.map

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

package/dist/handlers/testing/mock-helpers.d.ts

@@ -0,0 +1,56 @@
+import type { Mock } from "vitest";
+import { vi } from "vitest";
+import type { LauncherService } from "@lhremote/core";
+/**
+ * Collect all captured stdout output from a `process.stdout.write` spy.
+ */
+export declare function getStdout(spy: Mock): string;
+/**
+ * Collect all captured stderr output from a `process.stderr.write` spy.
+ */
+export declare function getStderr(spy: Mock): string;
+/**
+ * Mock {@link LauncherService} with optional method overrides.
+ *
+ * Returns the `disconnect` spy so callers can assert cleanup.
+ */
+export declare function mockLauncher(overrides?: Partial<LauncherService>): {
+    disconnect: ReturnType<typeof vi.fn>;
+};
+/**
+ * Mock {@link DatabaseClient} with a no-op `close` and empty `db`.
+ *
+ * Returns the `close` spy so callers can assert cleanup.
+ */
+export declare function mockDb(): {
+    close: ReturnType<typeof vi.fn>;
+};
+/**
+ * Mock {@link discoverAllDatabases} to return the given map.
+ *
+ * Defaults to a single account at id 1.
+ */
+export declare function mockDiscovery(databases?: Map<number, string>): void;
+/**
+ * Mock {@link resolveAccount} to return the given account id.
+ */
+export declare function mockResolveAccount(accountId?: number): void;
+/**
+ * Mock {@link withInstanceDatabase} so the callback receives a
+ * synthetic {@link InstanceDatabaseContext}.
+ *
+ * Returns the `executeAction` spy from the mock instance.
+ */
+export declare function mockWithInstanceDatabase(): {
+    executeAction: ReturnType<typeof vi.fn>;
+};
+/**
+ * Mock {@link withDatabase} so the callback receives a
+ * synthetic {@link DatabaseContext}.
+ *
+ * Returns a mock `db` object for further stubbing.
+ */
+export declare function mockWithDatabase(): {
+    db: Record<string, unknown>;
+};
+//# sourceMappingURL=mock-helpers.d.ts.map

package/dist/handlers/testing/mock-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock-helpers.d.ts","sourceRoot":"","sources":["../../../src/handlers/testing/mock-helpers.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AACnC,OAAO,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAE5B,OAAO,KAAK,EAIV,eAAe,EAChB,MAAM,gBAAgB,CAAC;AAUxB;;GAEG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,IAAI,GAAG,MAAM,CAE3C;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,IAAI,GAAG,MAAM,CAE3C;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAC1B,SAAS,GAAE,OAAO,CAAC,eAAe,CAAM,GACvC;IAAE,UAAU,EAAE,UAAU,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC,CAAA;CAAE,CAW1C;AAED;;;;GAIG;AACH,wBAAgB,MAAM,IAAI;IAAE,KAAK,EAAE,UAAU,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC,CAAA;CAAE,CAM5D;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAC3B,SAAS,GAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAiC,GAC7D,IAAI,CAEN;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,SAAI,GAAG,IAAI,CAEtD;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,IAAI;IAC1C,aAAa,EAAE,UAAU,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC;CACzC,CAcA;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,IAAI;IAAE,EAAE,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,CAWlE"}

package/dist/handlers/testing/mock-helpers.js

@@ -0,0 +1,95 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+import { vi } from "vitest";
+import { DatabaseClient as DatabaseClientCtor, LauncherService as LauncherServiceCtor, discoverAllDatabases, resolveAccount, withDatabase, withInstanceDatabase, } from "@lhremote/core";
+/**
+ * Collect all captured stdout output from a `process.stdout.write` spy.
+ */
+export function getStdout(spy) {
+    return spy.mock.calls.map((call) => String(call[0])).join("");
+}
+/**
+ * Collect all captured stderr output from a `process.stderr.write` spy.
+ */
+export function getStderr(spy) {
+    return spy.mock.calls.map((call) => String(call[0])).join("");
+}
+/**
+ * Mock {@link LauncherService} with optional method overrides.
+ *
+ * Returns the `disconnect` spy so callers can assert cleanup.
+ */
+export function mockLauncher(overrides = {}) {
+    const disconnect = vi.fn();
+    vi.mocked(LauncherServiceCtor).mockImplementation(function () {
+        return {
+            connect: vi.fn().mockResolvedValue(undefined),
+            disconnect,
+            listAccounts: vi.fn().mockResolvedValue([]),
+            ...overrides,
+        };
+    });
+    return { disconnect };
+}
+/**
+ * Mock {@link DatabaseClient} with a no-op `close` and empty `db`.
+ *
+ * Returns the `close` spy so callers can assert cleanup.
+ */
+export function mockDb() {
+    const close = vi.fn();
+    vi.mocked(DatabaseClientCtor).mockImplementation(function () {
+        return { close, db: {} };
+    });
+    return { close };
+}
+/**
+ * Mock {@link discoverAllDatabases} to return the given map.
+ *
+ * Defaults to a single account at id 1.
+ */
+export function mockDiscovery(databases = new Map([[1, "/path/to/db"]])) {
+    vi.mocked(discoverAllDatabases).mockReturnValue(databases);
+}
+/**
+ * Mock {@link resolveAccount} to return the given account id.
+ */
+export function mockResolveAccount(accountId = 1) {
+    vi.mocked(resolveAccount).mockResolvedValue(accountId);
+}
+/**
+ * Mock {@link withInstanceDatabase} so the callback receives a
+ * synthetic {@link InstanceDatabaseContext}.
+ *
+ * Returns the `executeAction` spy from the mock instance.
+ */
+export function mockWithInstanceDatabase() {
+    const executeAction = vi.fn().mockResolvedValue(undefined);
+    vi.mocked(withInstanceDatabase).mockImplementation(async (_cdpPort, _accountId, callback) => {
+        const mockInstance = { executeAction };
+        const mockDbObj = {};
+        return callback({
+            accountId: _accountId,
+            instance: mockInstance,
+            db: mockDbObj,
+        });
+    });
+    return { executeAction };
+}
+/**
+ * Mock {@link withDatabase} so the callback receives a
+ * synthetic {@link DatabaseContext}.
+ *
+ * Returns a mock `db` object for further stubbing.
+ */
+export function mockWithDatabase() {
+    const db = {};
+    vi.mocked(withDatabase).mockImplementation(async (_accountId, callback) => {
+        return callback({
+            accountId: _accountId,
+            db,
+        });
+    });
+    return { db };
+}
+//# sourceMappingURL=mock-helpers.js.map

package/dist/handlers/testing/mock-helpers.js.map

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

package/dist/program.d.ts

@@ -0,0 +1,6 @@
+import { Command } from "commander";
+/**
+ * Create the CLI program with all subcommands registered.
+ */
+export declare function createProgram(): Command;
+//# sourceMappingURL=program.d.ts.map

package/dist/program.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"program.d.ts","sourceRoot":"","sources":["../src/program.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,OAAO,EAAgC,MAAM,WAAW,CAAC;AAuElE;;GAEG;AACH,wBAAgB,aAAa,IAAI,OAAO,CAgXvC"}