import { afterEach, describe, expect, it, vi } from "vitest"; import type { GatewayService } from "./service.js"; import { describeGatewayServiceRestart, readGatewayServiceState, resolveGatewayService, startGatewayService, } from "./service.js"; import { createMockGatewayService } from "./service.test-helpers.js"; const originalPlatformDescriptor = Object.getOwnPropertyDescriptor(process, "platform"); function setPlatform(value: NodeJS.Platform | "aix") { if (!originalPlatformDescriptor) { throw new Error("missing process.platform descriptor"); } Object.defineProperty(process, "platform", { configurable: true, enumerable: originalPlatformDescriptor.enumerable ?? false, value, }); } afterEach(() => { if (!originalPlatformDescriptor) { return; } Object.defineProperty(process, "platform", originalPlatformDescriptor); }); function createService(overrides: Partial = {}): GatewayService { return createMockGatewayService(overrides); } describe("resolveGatewayService", () => { it.each([ { platform: "darwin" as const, label: "LaunchAgent", loadedText: "loaded" }, { platform: "linux" as const, label: "systemd", loadedText: "enabled" }, { platform: "win32" as const, label: "Scheduled Task", loadedText: "registered" }, ])("returns the registered adapter for $platform", ({ platform, label, loadedText }) => { setPlatform(platform); const service = resolveGatewayService(); expect(service.label).toBe(label); expect(service.loadedText).toBe(loadedText); }); it("throws for unsupported platforms", () => { setPlatform("aix"); expect(() => resolveGatewayService()).toThrow("Gateway service install not supported on aix"); }); it("describes scheduled restart handoffs consistently", () => { expect(describeGatewayServiceRestart("Gateway", { outcome: "scheduled" })).toEqual({ scheduled: true, daemonActionResult: "scheduled", message: "restart scheduled, gateway will restart momentarily", progressMessage: "Gateway service restart scheduled.", }); }); }); describe("readGatewayServiceState", () => { it("tracks installed, loaded, and running separately", async () => { const service = createService({ isLoaded: vi.fn(async () => true), readCommand: vi.fn(async () => ({ programArguments: ["openclaw", "gateway", "run"], environment: { OPENCLAW_GATEWAY_PORT: "18789" }, })), readRuntime: vi.fn(async () => ({ status: "running" })), }); const state = await readGatewayServiceState(service, { env: { OPENCLAW_GATEWAY_PORT: "1" }, }); expect(state.installed).toBe(true); expect(state.loaded).toBe(true); expect(state.running).toBe(true); expect(state.env.OPENCLAW_GATEWAY_PORT).toBe("18789"); }); }); describe("startGatewayService", () => { it("returns missing-install without attempting restart", async () => { const service = createService(); const result = await startGatewayService(service, { env: {}, stdout: process.stdout, }); expect(result.outcome).toBe("missing-install"); expect(service.restart).not.toHaveBeenCalled(); }); it("restarts stopped installed services and returns post-start state", async () => { const readCommand = vi.fn(async () => ({ programArguments: ["openclaw", "gateway", "run"], environment: { OPENCLAW_GATEWAY_PORT: "18789" }, })); const isLoaded = vi .fn() .mockResolvedValueOnce(false) .mockResolvedValueOnce(true); const readRuntime = vi .fn() .mockResolvedValueOnce({ status: "stopped" }) .mockResolvedValueOnce({ status: "running" }); const service = createService({ readCommand, isLoaded, readRuntime, }); const result = await startGatewayService(service, { env: {}, stdout: process.stdout, }); expect(result.outcome).toBe("started"); expect(service.restart).toHaveBeenCalledTimes(1); expect(result.state.installed).toBe(true); expect(result.state.loaded).toBe(true); expect(result.state.running).toBe(true); }); it("falls back to missing-install when restart fails and install artifacts are gone", async () => { const readCommand = vi .fn() .mockResolvedValueOnce({ programArguments: ["openclaw", "gateway", "run"], }) .mockResolvedValueOnce(null); const service = createService({ readCommand, restart: vi.fn(async () => { throw new Error("launchctl bootstrap failed"); }), }); const result = await startGatewayService(service, { env: {}, stdout: process.stdout, }); expect(result.outcome).toBe("missing-install"); expect(result.state.installed).toBe(false); }); });