@jamiexiongr/panda-hub 0.1.18 → 0.1.20

package/README.md

@@ -2,19 +2,30 @@
 
 Published hub runtime for Panda, including the built web UI.
 
-## Usage
-
-```bash
-panda-hub
-panda-hub tailscareserv
-```
-
-`tailscareserv` and `--tailscale-serve` both enable automatic `tailscale serve` publishing.
-
-When enabled, hub startup will:
-
-- detect whether `tailscale` is available and online
-- run `tailscale serve --bg`
+## Usage
+
+```bash
+panda-hub
+panda-hub tailscareserv
+```
+
+`tailscareserv` and `--tailscale-serve` both enable automatic `tailscale serve` publishing.
+
+Windows service management:
+
+```powershell
+panda-hub service install --name=PandaHub tailscareserv
+panda-hub service status
+panda-hub service restart
+panda-hub service uninstall
+```
+
+`service install` stores the startup args and current `PANDA_*` environment values in the Windows service definition. If you change them later, run `service install` again to update the service.
+
+When enabled, hub startup will:
+
+- detect whether `tailscale` is available and online
+- run `tailscale serve --bg`
 - print the generated Tailscale HTTPS URL in the startup log
 
 ## Environment

package/dist/chunk-72Z5Y3ZR.mjs

@@ -0,0 +1,455 @@
+import {
+  configureTailscaleServe,
+  ensurePandaHubApiKey,
+  printTerminalQr,
+  resolveTailscalePublicationMode,
+  resolveTailscaleServePort,
+  startPandaSessionService
+} from "./chunk-I2346PMO.mjs";
+
+// release/panda-hub/src/index.ts
+import fs from "fs";
+import path2 from "path";
+import { fileURLToPath as fileURLToPath2 } from "url";
+
+// release/panda-hub/package.json
+var package_default = {
+  name: "@jamiexiongr/panda-hub",
+  version: "0.1.20",
+  type: "module",
+  private: false,
+  description: "Panda hub runtime",
+  dependencies: {
+    "@fastify/compress": "^8.3.1",
+    "@fastify/cors": "^10.0.2",
+    "@fastify/websocket": "^11.0.2",
+    fastify: "^5.2.1",
+    "node-windows": "^1.0.0-beta.8",
+    "web-push": "^3.6.7"
+  },
+  bin: {
+    "panda-hub": "./bin/panda-hub.cjs"
+  },
+  exports: {
+    ".": "./dist/index.mjs"
+  },
+  files: [
+    "bin",
+    "dist"
+  ],
+  publishConfig: {
+    access: "public",
+    registry: "https://registry.npmjs.org/"
+  },
+  engines: {
+    node: ">=20.19.0"
+  }
+};
+
+// release/panda-hub/src/service.ts
+import path from "path";
+import { fileURLToPath } from "url";
+
+// release/shared/src/windows-service.ts
+import { spawnSync } from "child_process";
+import { createRequire } from "module";
+var require2 = createRequire(import.meta.url);
+var cachedServiceConstructor = null;
+var WINDOWS_SERVICE_TIMEOUT_MS = 2e4;
+var ensureWindows = () => {
+  if (process.platform !== "win32") {
+    throw new Error("Windows \u670D\u52A1\u7BA1\u7406\u5F53\u524D\u53EA\u652F\u6301 Windows\u3002");
+  }
+};
+var trimToNull = (value) => {
+  const normalized = value?.trim() ?? "";
+  return normalized || null;
+};
+var escapePowerShellString = (value) => value.replace(/'/g, "''");
+var quoteForSc = (value) => value.trim();
+var describeCommandFailure = (output, fallback) => {
+  const normalized = trimToNull(output);
+  return normalized ?? fallback;
+};
+var runPowerShell = (script) => spawnSync("powershell.exe", ["-NoProfile", "-Command", script], {
+  encoding: "utf8",
+  windowsHide: true
+});
+var runSc = (args) => {
+  ensureWindows();
+  const command = ["sc.exe", ...args.map((value) => /[\s"]/u.test(value) ? `"${value.replace(/"/g, '\\"')}"` : value)].join(" ");
+  return spawnSync(process.env.ComSpec ?? "cmd.exe", ["/d", "/s", "/c", command], {
+    encoding: "utf8",
+    windowsHide: true
+  });
+};
+var parseWindowsServiceState = (output) => {
+  const normalized = output.trim().toLowerCase();
+  if (normalized === "__missing__") {
+    return "missing";
+  }
+  if (normalized === "running") {
+    return "running";
+  }
+  if (normalized === "stopped") {
+    return "stopped";
+  }
+  return "unknown";
+};
+var queryWindowsServiceStatus = (name) => {
+  ensureWindows();
+  const result = runPowerShell(
+    [
+      `$service = Get-Service -Name '${escapePowerShellString(name)}' -ErrorAction SilentlyContinue`,
+      `if ($null -eq $service) { '__MISSING__' } else { $service.Status.ToString() }`
+    ].join("; ")
+  );
+  const rawOutput = `${result.stdout ?? ""}
+${result.stderr ?? ""}`.trim();
+  const state = parseWindowsServiceState(rawOutput);
+  return {
+    name,
+    exists: state !== "missing",
+    state,
+    rawOutput
+  };
+};
+var wait = (ms) => new Promise((resolve) => {
+  setTimeout(resolve, ms);
+});
+var waitForWindowsServiceState = async (name, desiredState, timeoutMs = WINDOWS_SERVICE_TIMEOUT_MS) => {
+  const startedAt = Date.now();
+  let latest = queryWindowsServiceStatus(name);
+  while (latest.state !== desiredState && Date.now() - startedAt < timeoutMs) {
+    await wait(750);
+    latest = queryWindowsServiceStatus(name);
+  }
+  return latest;
+};
+var startWindowsService = async (name) => {
+  ensureWindows();
+  const current = queryWindowsServiceStatus(name);
+  if (!current.exists) {
+    throw new Error(`Windows \u670D\u52A1 ${name} \u4E0D\u5B58\u5728\u3002`);
+  }
+  if (current.state === "running") {
+    return current;
+  }
+  const result = runPowerShell(`Start-Service -Name '${escapePowerShellString(name)}' -ErrorAction Stop`);
+  const output = `${result.stdout ?? ""}
+${result.stderr ?? ""}`.trim();
+  const latest = await waitForWindowsServiceState(name, "running");
+  if (latest.state !== "running") {
+    throw new Error(describeCommandFailure(output || latest.rawOutput, `\u542F\u52A8\u670D\u52A1 ${name} \u5931\u8D25\u3002`));
+  }
+  return latest;
+};
+var stopWindowsService = async (name) => {
+  ensureWindows();
+  const current = queryWindowsServiceStatus(name);
+  if (!current.exists || current.state === "stopped") {
+    return current;
+  }
+  const result = runPowerShell(`Stop-Service -Name '${escapePowerShellString(name)}' -Force -ErrorAction Stop`);
+  const output = `${result.stdout ?? ""}
+${result.stderr ?? ""}`.trim();
+  const latest = await waitForWindowsServiceState(name, "stopped");
+  if (latest.state !== "stopped") {
+    throw new Error(describeCommandFailure(output || latest.rawOutput, `\u505C\u6B62\u670D\u52A1 ${name} \u5931\u8D25\u3002`));
+  }
+  return latest;
+};
+var restartWindowsService = async (name) => {
+  await stopWindowsService(name);
+  return await startWindowsService(name);
+};
+var collectServiceEnvironment = (env) => Object.entries(env ?? process.env).filter(([key, value]) => key.startsWith("PANDA_") && typeof value === "string" && value.trim()).map(([name, value]) => ({
+  name,
+  value: value.trim()
+}));
+var getNodeWindowsServiceConstructor = () => {
+  if (cachedServiceConstructor) {
+    return cachedServiceConstructor;
+  }
+  const mod = require2("node-windows");
+  if (!mod.Service) {
+    throw new Error("\u7F3A\u5C11 node-windows \u4F9D\u8D56\uFF0C\u65E0\u6CD5\u6CE8\u518C Windows \u670D\u52A1\u3002");
+  }
+  cachedServiceConstructor = mod.Service;
+  return cachedServiceConstructor;
+};
+var createNodeWindowsService = (definition) => {
+  ensureWindows();
+  const Service = getNodeWindowsServiceConstructor();
+  return new Service({
+    name: definition.name,
+    description: definition.description,
+    script: definition.scriptPath,
+    scriptOptions: trimToNull(definition.scriptOptions) ?? void 0,
+    workingDirectory: trimToNull(definition.workingDirectory) ?? void 0,
+    execPath: trimToNull(definition.execPath) ?? process.execPath,
+    env: collectServiceEnvironment(definition.env)
+  });
+};
+var waitForNodeWindowsAction = async (service, action) => await new Promise((resolve, reject) => {
+  let settled = false;
+  const finish = (error) => {
+    if (settled) {
+      return;
+    }
+    settled = true;
+    if (error) {
+      reject(error);
+      return;
+    }
+    resolve();
+  };
+  const fail = (error) => {
+    finish(error instanceof Error ? error : new Error(String(error)));
+  };
+  service.once(action, () => finish());
+  service.once(action === "install" ? "alreadyinstalled" : "alreadyuninstalled", () => finish());
+  service.once(
+    "invalidinstallation",
+    () => fail(new Error(`Windows \u670D\u52A1 ${service.exists ? "\u5B89\u88C5" : "\u5378\u8F7D"}\u72B6\u6001\u65E0\u6548\u3002`))
+  );
+  service.once("error", fail);
+  try {
+    service[action]();
+  } catch (error) {
+    fail(error);
+  }
+});
+var uninstallWindowsService = async (definition) => {
+  ensureWindows();
+  const current = queryWindowsServiceStatus(definition.name);
+  if (!current.exists) {
+    return current;
+  }
+  if (current.state === "running") {
+    await stopWindowsService(definition.name);
+  }
+  const service = createNodeWindowsService(definition);
+  await waitForNodeWindowsAction(service, "uninstall");
+  return queryWindowsServiceStatus(definition.name);
+};
+var installOrUpdateWindowsService = async (definition, options) => {
+  ensureWindows();
+  const existing = queryWindowsServiceStatus(definition.name);
+  if (existing.exists) {
+    await uninstallWindowsService(definition);
+  }
+  const service = createNodeWindowsService(definition);
+  await waitForNodeWindowsAction(service, "install");
+  runSc(["config", quoteForSc(definition.name), "start=", "auto"]);
+  let started = false;
+  let startError = null;
+  if (options?.start !== false) {
+    try {
+      const startedStatus = await startWindowsService(definition.name);
+      started = startedStatus.state === "running";
+    } catch (error) {
+      startError = error instanceof Error ? error.message : String(error);
+    }
+  }
+  return {
+    status: queryWindowsServiceStatus(definition.name),
+    started,
+    startError
+  };
+};
+
+// release/panda-hub/src/service.ts
+var currentDirectory = path.dirname(fileURLToPath(import.meta.url));
+var packageRoot = path.resolve(currentDirectory, "..");
+var defaultServiceName = "PandaHub";
+var trimToNull2 = (value) => {
+  const normalized = value?.trim() ?? "";
+  return normalized || null;
+};
+var normalizeServiceName = (value) => trimToNull2(value) ?? defaultServiceName;
+var joinScriptOptions = (argv) => argv.map((value) => value.trim()).filter(Boolean).join(" ");
+var buildHubServiceDefinition = (options) => ({
+  name: normalizeServiceName(options?.name),
+  description: "Panda Hub Windows service",
+  scriptPath: path.join(packageRoot, "bin", "panda-hub.cjs"),
+  scriptOptions: trimToNull2(options?.scriptOptions),
+  workingDirectory: packageRoot,
+  env: options?.env ?? process.env
+});
+var parseHubServiceCommand = (argv) => {
+  let action = null;
+  let name = null;
+  let shouldStart = true;
+  const runtimeArgs = [];
+  for (let index = 0; index < argv.length; index += 1) {
+    const candidate = argv[index]?.trim() ?? "";
+    if (!candidate) {
+      continue;
+    }
+    if (!action) {
+      action = candidate.toLowerCase();
+      continue;
+    }
+    const normalized = candidate.toLowerCase();
+    if (normalized === "--name" || normalized === "name" || normalized === "--service-name" || normalized === "service-name") {
+      name = trimToNull2(argv[index + 1]);
+      index += 1;
+      continue;
+    }
+    if (normalized.startsWith("--name=") || normalized.startsWith("name=") || normalized.startsWith("--service-name=") || normalized.startsWith("service-name=")) {
+      name = trimToNull2(candidate.slice(candidate.indexOf("=") + 1));
+      continue;
+    }
+    if (normalized === "--no-start") {
+      shouldStart = false;
+      continue;
+    }
+    runtimeArgs.push(candidate);
+  }
+  return {
+    action: action ?? "status",
+    name,
+    shouldStart,
+    runtimeArgs
+  };
+};
+var manageJamiexiongrHubService = async (options) => {
+  const logger = options?.logger ?? console;
+  const parsed = parseHubServiceCommand(options?.argv ?? []);
+  const action = parsed.action;
+  const definition = buildHubServiceDefinition({
+    name: parsed.name,
+    scriptOptions: joinScriptOptions(parsed.runtimeArgs),
+    env: options?.env
+  });
+  if (action === "install" || action === "update" || action === "upsert" || action === "sync") {
+    const result = await installOrUpdateWindowsService(definition, {
+      start: parsed.shouldStart
+    });
+    if (result.startError) {
+      logger.warn(
+        `Windows \u670D\u52A1 ${definition.name} \u5DF2\u6CE8\u518C\uFF0C\u4F46\u542F\u52A8\u5931\u8D25\uFF1A${result.startError}`
+      );
+      return result;
+    }
+    logger.info(
+      result.started ? `Windows \u670D\u52A1 ${definition.name} \u5DF2\u6CE8\u518C\u5E76\u542F\u52A8\u3002` : `Windows \u670D\u52A1 ${definition.name} \u5DF2\u6CE8\u518C\u3002`
+    );
+    return result;
+  }
+  if (action === "uninstall" || action === "remove" || action === "delete") {
+    const status = await uninstallWindowsService(definition);
+    logger.info(
+      status.exists ? `Windows \u670D\u52A1 ${definition.name} \u5378\u8F7D\u540E\u4ECD\u5B58\u5728\uFF0C\u8BF7\u68C0\u67E5\u7CFB\u7EDF\u670D\u52A1\u7BA1\u7406\u5668\u3002` : `Windows \u670D\u52A1 ${definition.name} \u5DF2\u5378\u8F7D\u3002`
+    );
+    return {
+      status,
+      started: false,
+      startError: null
+    };
+  }
+  if (action === "start") {
+    const status = await startWindowsService(definition.name);
+    logger.info(`Windows \u670D\u52A1 ${definition.name} \u5F53\u524D\u72B6\u6001\uFF1A${status.state}`);
+    return {
+      status,
+      started: status.state === "running",
+      startError: null
+    };
+  }
+  if (action === "stop") {
+    const status = await stopWindowsService(definition.name);
+    logger.info(`Windows \u670D\u52A1 ${definition.name} \u5F53\u524D\u72B6\u6001\uFF1A${status.state}`);
+    return {
+      status,
+      started: false,
+      startError: null
+    };
+  }
+  if (action === "restart") {
+    const status = await restartWindowsService(definition.name);
+    logger.info(`Windows \u670D\u52A1 ${definition.name} \u5F53\u524D\u72B6\u6001\uFF1A${status.state}`);
+    return {
+      status,
+      started: status.state === "running",
+      startError: null
+    };
+  }
+  if (action === "status") {
+    const status = queryWindowsServiceStatus(definition.name);
+    logger.info(
+      status.exists ? `Windows \u670D\u52A1 ${definition.name} \u5F53\u524D\u72B6\u6001\uFF1A${status.state}` : `Windows \u670D\u52A1 ${definition.name} \u5C1A\u672A\u6CE8\u518C\u3002`
+    );
+    return {
+      status,
+      started: status.state === "running",
+      startError: null
+    };
+  }
+  throw new Error(`Unknown hub service action: ${action}`);
+};
+
+// release/panda-hub/src/index.ts
+var currentDirectory2 = path2.dirname(fileURLToPath2(import.meta.url));
+var resolveBundledWebUiDir = () => {
+  const candidates = [
+    path2.resolve(currentDirectory2, "web"),
+    path2.resolve(currentDirectory2, "../dist/web"),
+    path2.resolve(currentDirectory2, "../web")
+  ];
+  return candidates.find((candidate) => fs.existsSync(candidate)) ?? candidates[0];
+};
+var startJamiexiongrHub = async (options) => {
+  const publishMode = options?.tailscalePublicationMode ?? resolveTailscalePublicationMode({
+    envPrefix: "PANDA_HUB"
+  });
+  const port = Number(process.env.PANDA_HUB_PORT ?? 4343);
+  const tailscaleServe = configureTailscaleServe({
+    enabled: publishMode !== "disabled",
+    mode: publishMode === "disabled" ? void 0 : publishMode,
+    serviceName: "panda-hub",
+    localPort: port,
+    servePort: resolveTailscaleServePort({
+      envPrefix: "PANDA_HUB",
+      defaultPort: 443
+    }),
+    logger: console
+  });
+  const hubApiKey = await ensurePandaHubApiKey({
+    configuredApiKey: process.env.PANDA_HUB_API_KEY ?? null,
+    codexHome: process.env.PANDA_CODEX_HOME ?? null,
+    logger: console
+  });
+  if (hubApiKey.apiKey) {
+    process.env.PANDA_HUB_API_KEY = hubApiKey.apiKey;
+  }
+  const webUiDir = resolveBundledWebUiDir();
+  const app = await startPandaSessionService({
+    serviceName: "panda-hub",
+    mode: "hub",
+    port,
+    transport: "hub-routed",
+    version: package_default.version,
+    webUiDir
+  });
+  if (tailscaleServe.active && tailscaleServe.baseUrl) {
+    if (tailscaleServe.mode === "funnel") {
+      console.info(`Panda hub Public HTTPS URL: ${tailscaleServe.baseUrl}`);
+      console.info(`Public PWA install URL: ${tailscaleServe.baseUrl}`);
+    } else {
+      console.info(`Panda hub Tailscale HTTPS URL: ${tailscaleServe.baseUrl}`);
+      console.info(`Agent hub URL env: PANDA_HUB_URL=${tailscaleServe.baseUrl}`);
+    }
+    printTerminalQr(tailscaleServe.baseUrl, {
+      logger: console,
+      label: tailscaleServe.mode === "funnel" ? "Scan this QR code to open the public Panda hub on your phone:" : "Scan this QR code to open Panda hub on your phone:"
+    });
+  }
+  return app;
+};
+
+export {
+  manageJamiexiongrHubService,
+  startJamiexiongrHub
+};