@spencer-kit/coder-studio 0.4.0 → 0.4.1

package/dist/esm/update-worker.mjs

@@ -0,0 +1,156 @@
+// @spencer-kit/coder-studio - ESM bundle
+
+// packages/cli/src/update-worker.ts
+import { spawn } from "node:child_process";
+import { createWriteStream } from "node:fs";
+import { mkdir } from "node:fs/promises";
+import { dirname } from "node:path";
+async function writeState(filePath, value) {
+  await mkdir(dirname(filePath), { recursive: true });
+  await import("node:fs/promises").then(
+    ({ writeFile }) => writeFile(filePath, JSON.stringify(value, null, 2) + "\n", "utf-8")
+  );
+}
+function parseJsonArray(value, fallback) {
+  if (!value) {
+    return fallback;
+  }
+  try {
+    const parsed = JSON.parse(value);
+    if (Array.isArray(parsed) && parsed.every((item) => typeof item === "string")) {
+      return parsed;
+    }
+  } catch {
+  }
+  return fallback;
+}
+function readEnv(env = process.env) {
+  const stateFilePath = env.CODER_STUDIO_UPDATE_STATE_PATH;
+  const logFilePath = env.CODER_STUDIO_UPDATE_LOG_PATH;
+  const packageName = env.CODER_STUDIO_UPDATE_PACKAGE_NAME;
+  const targetVersion = env.CODER_STUDIO_UPDATE_TARGET_VERSION;
+  const cliCommand = env.CODER_STUDIO_UPDATE_CLI_COMMAND;
+  const currentVersion = env.CODER_STUDIO_UPDATE_CURRENT_VERSION;
+  if (!stateFilePath || !logFilePath || !packageName || !targetVersion || !cliCommand || !currentVersion) {
+    throw new Error("Missing detached update worker environment");
+  }
+  return {
+    stateFilePath,
+    logFilePath,
+    packageName,
+    targetVersion,
+    cliCommand,
+    currentVersion,
+    npmCommand: env.CODER_STUDIO_UPDATE_NPM_COMMAND || "npm",
+    restartArgs: parseJsonArray(env.CODER_STUDIO_UPDATE_RESTART_ARGS, ["serve", "--restart"]),
+    installArgsPrefix: parseJsonArray(env.CODER_STUDIO_UPDATE_INSTALL_ARGS_PREFIX, [
+      "install",
+      "-g"
+    ])
+  };
+}
+function buildManualCommand(input) {
+  return [
+    `${input.npmCommand} ${[...input.installArgsPrefix, `${input.packageName}@${input.targetVersion}`].join(" ")}`,
+    `${input.cliCommand} ${input.restartArgs.join(" ")}`
+  ].join("\n");
+}
+function runCommand(command, args, options) {
+  return new Promise((resolve, reject) => {
+    const child = spawn(command, args, {
+      stdio: options?.stdio === "ignore" ? "ignore" : "pipe",
+      env: process.env
+    });
+    if (options?.logStream && child.stdout) {
+      child.stdout.pipe(options.logStream, { end: false });
+    }
+    if (options?.logStream && child.stderr) {
+      child.stderr.pipe(options.logStream, { end: false });
+    }
+    child.on("error", reject);
+    child.on("exit", (code) => {
+      if (code === 0) {
+        resolve();
+        return;
+      }
+      reject(new Error(`${command} exited with code ${code ?? 1}`));
+    });
+  });
+}
+async function runUpdateWorker(input = readEnv(), deps) {
+  const now = deps?.now ?? Date.now;
+  await mkdir(dirname(input.logFilePath), { recursive: true });
+  const logStream = createWriteStream(input.logFilePath, { flags: "a" });
+  const execute = deps?.runCommand ?? runCommand;
+  try {
+    await execute(
+      input.npmCommand,
+      [...input.installArgsPrefix, `${input.packageName}@${input.targetVersion}`],
+      { logStream }
+    );
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    const permissionRelated = /EACCES|EPERM|permission|not permitted/i.test(message) || /requires elevated privileges/i.test(message);
+    await writeState(input.stateFilePath, {
+      version: 1,
+      currentVersion: input.currentVersion,
+      latestVersion: input.targetVersion,
+      availability: "update_available",
+      updateStatus: permissionRelated ? "manual_required" : "failed",
+      lastCheckedAt: now(),
+      targetVersion: input.targetVersion,
+      startedAt: now(),
+      finishedAt: now(),
+      requiresManualStep: permissionRelated,
+      manualCommand: permissionRelated ? buildManualCommand(input) : null,
+      errorSummary: message
+    });
+    logStream.end();
+    return;
+  }
+  await writeState(input.stateFilePath, {
+    version: 1,
+    currentVersion: input.currentVersion,
+    latestVersion: input.targetVersion,
+    availability: "update_available",
+    updateStatus: "restarting",
+    lastCheckedAt: now(),
+    targetVersion: input.targetVersion,
+    startedAt: now(),
+    finishedAt: null,
+    requiresManualStep: false,
+    manualCommand: null,
+    errorSummary: null
+  });
+  try {
+    await execute(input.cliCommand, input.restartArgs, { logStream });
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    await writeState(input.stateFilePath, {
+      version: 1,
+      currentVersion: input.currentVersion,
+      latestVersion: input.targetVersion,
+      availability: "update_available",
+      updateStatus: "failed",
+      lastCheckedAt: now(),
+      targetVersion: input.targetVersion,
+      startedAt: now(),
+      finishedAt: now(),
+      requiresManualStep: true,
+      manualCommand: `${input.cliCommand} ${input.restartArgs.join(" ")}`,
+      errorSummary: `new version installed but service restart failed: ${message}`
+    });
+  } finally {
+    logStream.end();
+  }
+}
+if (process.env.CODER_STUDIO_UPDATE_STATE_PATH) {
+  void runUpdateWorker().catch((error) => {
+    console.error("[update-worker]", error);
+    process.exitCode = 1;
+  });
+}
+export {
+  runUpdateWorker
+};
+//# sourceMappingURL=update-worker.mjs.map

package/dist/esm/update-worker.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/update-worker.ts"],
+  "sourcesContent": ["import { spawn } from \"node:child_process\";\nimport { createWriteStream } from \"node:fs\";\nimport { mkdir } from \"node:fs/promises\";\nimport { dirname } from \"node:path\";\n\ninterface UpdateStateSnapshot {\n  version: 1;\n  currentVersion: string;\n  latestVersion: string | null;\n  availability: \"unknown\" | \"up_to_date\" | \"update_available\" | \"check_failed\";\n  updateStatus:\n    | \"idle\"\n    | \"checking\"\n    | \"installing\"\n    | \"restarting\"\n    | \"succeeded\"\n    | \"failed\"\n    | \"manual_required\";\n  lastCheckedAt: number | null;\n  targetVersion: string | null;\n  startedAt: number | null;\n  finishedAt: number | null;\n  requiresManualStep: boolean;\n  manualCommand: string | null;\n  errorSummary: string | null;\n}\n\ninterface WorkerEnv {\n  stateFilePath: string;\n  logFilePath: string;\n  packageName: string;\n  targetVersion: string;\n  cliCommand: string;\n  currentVersion: string;\n  npmCommand: string;\n  restartArgs: string[];\n  installArgsPrefix: string[];\n}\n\nasync function writeState(filePath: string, value: UpdateStateSnapshot): Promise<void> {\n  await mkdir(dirname(filePath), { recursive: true });\n  await import(\"node:fs/promises\").then(({ writeFile }) =>\n    writeFile(filePath, JSON.stringify(value, null, 2) + \"\\n\", \"utf-8\")\n  );\n}\n\nfunction parseJsonArray(value: string | undefined, fallback: string[]): string[] {\n  if (!value) {\n    return fallback;\n  }\n  try {\n    const parsed = JSON.parse(value) as unknown;\n    if (Array.isArray(parsed) && parsed.every((item) => typeof item === \"string\")) {\n      return parsed;\n    }\n  } catch {}\n  return fallback;\n}\n\nfunction readEnv(env = process.env): WorkerEnv {\n  const stateFilePath = env.CODER_STUDIO_UPDATE_STATE_PATH;\n  const logFilePath = env.CODER_STUDIO_UPDATE_LOG_PATH;\n  const packageName = env.CODER_STUDIO_UPDATE_PACKAGE_NAME;\n  const targetVersion = env.CODER_STUDIO_UPDATE_TARGET_VERSION;\n  const cliCommand = env.CODER_STUDIO_UPDATE_CLI_COMMAND;\n  const currentVersion = env.CODER_STUDIO_UPDATE_CURRENT_VERSION;\n  if (\n    !stateFilePath ||\n    !logFilePath ||\n    !packageName ||\n    !targetVersion ||\n    !cliCommand ||\n    !currentVersion\n  ) {\n    throw new Error(\"Missing detached update worker environment\");\n  }\n  return {\n    stateFilePath,\n    logFilePath,\n    packageName,\n    targetVersion,\n    cliCommand,\n    currentVersion,\n    npmCommand: env.CODER_STUDIO_UPDATE_NPM_COMMAND || \"npm\",\n    restartArgs: parseJsonArray(env.CODER_STUDIO_UPDATE_RESTART_ARGS, [\"serve\", \"--restart\"]),\n    installArgsPrefix: parseJsonArray(env.CODER_STUDIO_UPDATE_INSTALL_ARGS_PREFIX, [\n      \"install\",\n      \"-g\",\n    ]),\n  };\n}\n\nfunction buildManualCommand(input: WorkerEnv): string {\n  return [\n    `${input.npmCommand} ${[...input.installArgsPrefix, `${input.packageName}@${input.targetVersion}`].join(\" \")}`,\n    `${input.cliCommand} ${input.restartArgs.join(\" \")}`,\n  ].join(\"\\n\");\n}\n\nfunction runCommand(\n  command: string,\n  args: string[],\n  options?: { stdio?: \"ignore\" | \"pipe\"; logStream?: NodeJS.WritableStream }\n): Promise<void> {\n  return new Promise((resolve, reject) => {\n    const child = spawn(command, args, {\n      stdio: options?.stdio === \"ignore\" ? \"ignore\" : \"pipe\",\n      env: process.env,\n    });\n\n    if (options?.logStream && child.stdout) {\n      child.stdout.pipe(options.logStream, { end: false });\n    }\n    if (options?.logStream && child.stderr) {\n      child.stderr.pipe(options.logStream, { end: false });\n    }\n\n    child.on(\"error\", reject);\n    child.on(\"exit\", (code) => {\n      if (code === 0) {\n        resolve();\n        return;\n      }\n      reject(new Error(`${command} exited with code ${code ?? 1}`));\n    });\n  });\n}\n\nexport async function runUpdateWorker(\n  input = readEnv(),\n  deps?: {\n    runCommand?: typeof runCommand;\n    now?: () => number;\n  }\n): Promise<void> {\n  const now = deps?.now ?? Date.now;\n  await mkdir(dirname(input.logFilePath), { recursive: true });\n  const logStream = createWriteStream(input.logFilePath, { flags: \"a\" });\n  const execute = deps?.runCommand ?? runCommand;\n\n  try {\n    await execute(\n      input.npmCommand,\n      [...input.installArgsPrefix, `${input.packageName}@${input.targetVersion}`],\n      { logStream }\n    );\n  } catch (error) {\n    const message = error instanceof Error ? error.message : String(error);\n    const permissionRelated =\n      /EACCES|EPERM|permission|not permitted/i.test(message) ||\n      /requires elevated privileges/i.test(message);\n    await writeState(input.stateFilePath, {\n      version: 1,\n      currentVersion: input.currentVersion,\n      latestVersion: input.targetVersion,\n      availability: \"update_available\",\n      updateStatus: permissionRelated ? \"manual_required\" : \"failed\",\n      lastCheckedAt: now(),\n      targetVersion: input.targetVersion,\n      startedAt: now(),\n      finishedAt: now(),\n      requiresManualStep: permissionRelated,\n      manualCommand: permissionRelated ? buildManualCommand(input) : null,\n      errorSummary: message,\n    });\n    logStream.end();\n    return;\n  }\n\n  await writeState(input.stateFilePath, {\n    version: 1,\n    currentVersion: input.currentVersion,\n    latestVersion: input.targetVersion,\n    availability: \"update_available\",\n    updateStatus: \"restarting\",\n    lastCheckedAt: now(),\n    targetVersion: input.targetVersion,\n    startedAt: now(),\n    finishedAt: null,\n    requiresManualStep: false,\n    manualCommand: null,\n    errorSummary: null,\n  });\n\n  try {\n    await execute(input.cliCommand, input.restartArgs, { logStream });\n  } catch (error) {\n    const message = error instanceof Error ? error.message : String(error);\n    await writeState(input.stateFilePath, {\n      version: 1,\n      currentVersion: input.currentVersion,\n      latestVersion: input.targetVersion,\n      availability: \"update_available\",\n      updateStatus: \"failed\",\n      lastCheckedAt: now(),\n      targetVersion: input.targetVersion,\n      startedAt: now(),\n      finishedAt: now(),\n      requiresManualStep: true,\n      manualCommand: `${input.cliCommand} ${input.restartArgs.join(\" \")}`,\n      errorSummary: `new version installed but service restart failed: ${message}`,\n    });\n  } finally {\n    logStream.end();\n  }\n}\n\nif (process.env.CODER_STUDIO_UPDATE_STATE_PATH) {\n  void runUpdateWorker().catch((error) => {\n    console.error(\"[update-worker]\", error);\n    process.exitCode = 1;\n  });\n}\n"],
+  "mappings": "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",
+  "names": []
+}