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> = {}): 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<GatewayService["isLoaded" ]>()
.mockResolvedValueOnce(false )
.mockResolvedValueOnce(true );
const readRuntime = vi
.fn<GatewayService["readRuntime" ]>()
.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<GatewayService["readCommand" ]>()
.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 );
});
});
Messung V0.5 in Prozent C=100 H=100 G=100
¤ Dauer der Verarbeitung: 0.11 Sekunden
(vorverarbeitet am 2026-06-09)
¤
*© Formatika GbR, Deutschland