@dotobokuri/fleet-console 1.5.0

package/dist/cli.d.ts

@@ -0,0 +1,116 @@
+interface ConsoleLockPayload {
+    readonly pid: number;
+    readonly host: string;
+    readonly port: number;
+    readonly endpoint: string;
+    readonly startedAt: number;
+    readonly token: string;
+    readonly version: string;
+}
+interface ConsoleHealth {
+    readonly ok: true;
+    readonly pid: number;
+    readonly host: string;
+    readonly port: number;
+    readonly endpoint: string;
+    readonly startedAt: number;
+    readonly version: string;
+    readonly workspaceCount: number;
+}
+
+interface OpenBrowserDeps {
+    readonly platform?: NodeJS.Platform;
+    readonly spawnBrowser?: (command: string, args: readonly string[], options: {
+        readonly detached: true;
+        readonly stdio: "ignore";
+    }) => void;
+}
+
+interface ConsoleProbeResult {
+    readonly healthy: boolean;
+    readonly lock: ConsoleLockPayload | null;
+    readonly health?: ConsoleHealth;
+    readonly error?: string;
+}
+interface ConsoleHealthDeps {
+    readonly fetch?: typeof fetch;
+}
+declare function createConsoleHealthClient(deps?: ConsoleHealthDeps): {
+    probe: (lock: ConsoleLockPayload | null) => Promise<ConsoleProbeResult>;
+};
+
+type ConsoleCliMode = "start" | "stop" | "restart" | "status" | "help";
+interface ConsoleDaemonLifecycleDeps {
+    readonly env?: NodeJS.ProcessEnv;
+    readonly execPath?: string;
+    readonly serverModulePath?: string;
+    readonly spawnDetached?: (execPath: string, args: readonly string[], options: {
+        readonly detached: true;
+        readonly env: NodeJS.ProcessEnv;
+        readonly stdio: "ignore";
+    }) => void;
+    readonly sleep?: (ms: number) => Promise<void>;
+    readonly health?: ReturnType<typeof createConsoleHealthClient>;
+}
+interface OpenFleetConsoleDeps {
+    readonly lifecycle?: Pick<ReturnType<typeof createConsoleDaemonLifecycle>, "ensureDaemon" | "probe">;
+    readonly openBrowser?: (url: string, deps?: OpenBrowserDeps) => void;
+}
+interface OpenFleetConsoleResult {
+    readonly url: string;
+}
+interface ConsoleStatusDeps {
+    readonly lifecycle?: Pick<ReturnType<typeof createConsoleDaemonLifecycle>, "probe">;
+}
+interface ConsoleStopDeps {
+    readonly lifecycle?: Pick<ReturnType<typeof createConsoleDaemonLifecycle>, "stop">;
+}
+interface ConsoleRestartDeps {
+    readonly lifecycle?: Pick<ReturnType<typeof createConsoleDaemonLifecycle>, "stop" | "ensureDaemon" | "probe">;
+    readonly openBrowser?: (url: string, deps?: OpenBrowserDeps) => void;
+}
+interface OpenFleetWikiWorkspaceOptions {
+    readonly cwd: string;
+    readonly host?: string;
+    readonly port?: number;
+}
+interface OpenFleetWikiWorkspaceResult {
+    readonly host: string;
+    readonly pid: number;
+    readonly port: number;
+    readonly url: string;
+}
+interface ProbeFleetWikiDaemonOptions {
+    readonly cwd: string;
+}
+interface BuildConsoleHelpTextOptions {
+    readonly env?: NodeJS.ProcessEnv;
+    readonly isTTY?: boolean;
+    readonly release?: string;
+}
+declare function parseConsoleCliMode(argv: readonly string[]): ConsoleCliMode;
+declare function buildConsoleHelpText(options?: BuildConsoleHelpTextOptions): string;
+declare function buildWikiHelpText(options?: BuildConsoleHelpTextOptions): string;
+declare function createConsoleDaemonLifecycle(deps?: ConsoleDaemonLifecycleDeps): {
+    ensureDaemon: () => Promise<string>;
+    probe: () => Promise<{
+        buildStale: boolean;
+        healthy: boolean;
+        lock: ConsoleLockPayload | null;
+        health?: ConsoleHealth;
+        error?: string;
+    }>;
+    runServer: () => Promise<void>;
+    stop: () => Promise<void>;
+};
+declare function openFleetConsole(deps?: OpenFleetConsoleDeps): Promise<OpenFleetConsoleResult>;
+declare function openFleetWikiWorkspace(options: OpenFleetWikiWorkspaceOptions): Promise<OpenFleetWikiWorkspaceResult>;
+declare function probeFleetWikiDaemon(_options: ProbeFleetWikiDaemonOptions): Promise<OpenFleetWikiWorkspaceResult | null>;
+declare function stopDaemon(): Promise<void>;
+declare function runConsoleStatus(deps?: ConsoleStatusDeps): Promise<string>;
+declare function runConsoleStop(deps?: ConsoleStopDeps): Promise<string>;
+declare function runConsoleRestart(deps?: ConsoleRestartDeps): Promise<OpenFleetConsoleResult>;
+declare function main(): Promise<void>;
+declare function mainWiki(argv?: readonly string[]): Promise<void>;
+
+export { type BuildConsoleHelpTextOptions, type ConsoleCliMode, type ConsoleDaemonLifecycleDeps, type ConsoleRestartDeps, type ConsoleStatusDeps, type ConsoleStopDeps, type OpenFleetConsoleDeps, type OpenFleetConsoleResult, type OpenFleetWikiWorkspaceOptions, type OpenFleetWikiWorkspaceResult, type ProbeFleetWikiDaemonOptions, buildConsoleHelpText, buildWikiHelpText, createConsoleDaemonLifecycle, main, mainWiki, openFleetConsole, openFleetWikiWorkspace, parseConsoleCliMode, probeFleetWikiDaemon, runConsoleRestart, runConsoleStatus, runConsoleStop, stopDaemon };