refactor(src): split oversized modules

src/cli/gateway-cli/shared.ts

@@ -0,0 +1,113 @@
+import {
+  resolveGatewayLaunchAgentLabel,
+  resolveGatewaySystemdServiceName,
+  resolveGatewayWindowsTaskName,
+} from "../../daemon/constants.js";
+import { resolveGatewayService } from "../../daemon/service.js";
+import { defaultRuntime } from "../../runtime.js";
+
+export function parsePort(raw: unknown): number | null {
+  if (raw === undefined || raw === null) return null;
+  const value =
+    typeof raw === "string"
+      ? raw
+      : typeof raw === "number" || typeof raw === "bigint"
+        ? raw.toString()
+        : null;
+  if (value === null) return null;
+  const parsed = Number.parseInt(value, 10);
+  if (!Number.isFinite(parsed) || parsed <= 0) return null;
+  return parsed;
+}
+
+export const toOptionString = (value: unknown): string | undefined => {
+  if (typeof value === "string") return value;
+  if (typeof value === "number" || typeof value === "bigint")
+    return value.toString();
+  return undefined;
+};
+
+export function describeUnknownError(err: unknown): string {
+  if (err instanceof Error) return err.message;
+  if (typeof err === "string") return err;
+  if (typeof err === "number" || typeof err === "bigint") return err.toString();
+  if (typeof err === "boolean") return err ? "true" : "false";
+  if (err && typeof err === "object") {
+    if ("message" in err && typeof err.message === "string") {
+      return err.message;
+    }
+    try {
+      return JSON.stringify(err);
+    } catch {
+      return "Unknown error";
+    }
+  }
+  return "Unknown error";
+}
+
+export function extractGatewayMiskeys(parsed: unknown): {
+  hasGatewayToken: boolean;
+  hasRemoteToken: boolean;
+} {
+  if (!parsed || typeof parsed !== "object") {
+    return { hasGatewayToken: false, hasRemoteToken: false };
+  }
+  const gateway = (parsed as Record<string, unknown>).gateway;
+  if (!gateway || typeof gateway !== "object") {
+    return { hasGatewayToken: false, hasRemoteToken: false };
+  }
+  const hasGatewayToken = "token" in (gateway as Record<string, unknown>);
+  const remote = (gateway as Record<string, unknown>).remote;
+  const hasRemoteToken =
+    remote && typeof remote === "object"
+      ? "token" in (remote as Record<string, unknown>)
+      : false;
+  return { hasGatewayToken, hasRemoteToken };
+}
+
+export function renderGatewayServiceStopHints(
+  env: NodeJS.ProcessEnv = process.env,
+): string[] {
+  const profile = env.CLAWDBOT_PROFILE;
+  switch (process.platform) {
+    case "darwin":
+      return [
+        "Tip: clawdbot daemon stop",
+        `Or: launchctl bootout gui/$UID/${resolveGatewayLaunchAgentLabel(profile)}`,
+      ];
+    case "linux":
+      return [
+        "Tip: clawdbot daemon stop",
+        `Or: systemctl --user stop ${resolveGatewaySystemdServiceName(profile)}.service`,
+      ];
+    case "win32":
+      return [
+        "Tip: clawdbot daemon stop",
+        `Or: schtasks /End /TN "${resolveGatewayWindowsTaskName(profile)}"`,
+      ];
+    default:
+      return ["Tip: clawdbot daemon stop"];
+  }
+}
+
+export async function maybeExplainGatewayServiceStop() {
+  const service = resolveGatewayService();
+  let loaded: boolean | null = null;
+  try {
+    loaded = await service.isLoaded({
+      env: process.env,
+      profile: process.env.CLAWDBOT_PROFILE,
+    });
+  } catch {
+    loaded = null;
+  }
+  if (loaded === false) return;
+  defaultRuntime.error(
+    loaded
+      ? `Gateway service appears ${service.loadedText}. Stop it first.`
+      : "Gateway service status unknown; if supervised, stop it first.",
+  );
+  for (const hint of renderGatewayServiceStopHints()) {
+    defaultRuntime.error(hint);
+  }
+}