@synqa/cli 1.1.0 → 1.2.0

package/dist/update.js

@@ -0,0 +1,71 @@
+// Update check and /update. The check is one short, silent GET to the npm registry; the update
+// runs npm itself (no shell string on POSIX; npm.cmd through a shell on Windows).
+import { spawn } from "node:child_process";
+import { homedir } from "node:os";
+                                          
+
+export const REGISTRY_URL = "https://registry.npmjs.org/@synqa/cli/latest";
+export const PACKAGE_SPEC = "@synqa/cli@latest";
+
+// "1.2.0" -> [1, 2, 0]; anything that is not a plain x.y.z (with an optional -pre part) is undefined.
+export function parseVersion(v        )                       {
+  const m = /^v?(\d+)\.(\d+)\.(\d+)(?:-[0-9A-Za-z.-]+)?(?:\+[0-9A-Za-z.-]+)?$/.exec(v.trim());
+  return m ? [Number(m[1]), Number(m[2]), Number(m[3])] : undefined;
+}
+
+// Numeric, not textual: 1.10.0 is newer than 1.9.0. Returns <0, 0 or >0; undefined if either is unparseable.
+export function compareVersions(a        , b        )                     {
+  const x = parseVersion(a);
+  const y = parseVersion(b);
+  if (!x || !y) return undefined;
+  for (let i = 0; i < 3; i++) {
+    const d = (x[i]          ) - (y[i]          );
+    if (d !== 0) return d;
+  }
+  return 0;
+}
+
+export const isNewer = (latest        , current        )          => (compareVersions(latest, current) ?? 0) > 0;
+
+// The latest published version if it is newer than `current`, else undefined. Every failure
+// (offline, slow, odd answer) is silent.
+export async function checkForUpdate(current        , fetchFn            = fetch, timeoutMs = 1500)                              {
+  const ac = new AbortController();
+  const timer = setTimeout(() => ac.abort(), timeoutMs);
+  (timer                          ).unref?.();
+  try {
+    const res = await fetchFn(REGISTRY_URL, { headers: { accept: "application/json" }, signal: ac.signal });
+    if (!res.ok) return undefined;
+    const body = (await res.json())                         ;
+    const latest = typeof body.version === "string" ? body.version : "";
+    return isNewer(latest, current) ? latest : undefined;
+  } catch {
+    return undefined;
+  } finally {
+    clearTimeout(timer);
+  }
+}
+
+// How /update runs npm. POSIX: spawn("npm", [...]) with no shell. Windows: npm is npm.cmd, which
+// Node can only start through a shell.
+export function updateCommand(platform         = process.platform)                                                   {
+  return { file: platform === "win32" ? "npm.cmd" : "npm", args: ["install", "-g", PACKAGE_SPEC], shell: platform === "win32" };
+}
+
+export function runUpdate(platform         = process.platform, spawnFn               = spawn)                  {
+  const c = updateCommand(platform);
+  return new Promise((resolve) => {
+    try {
+      const child = spawnFn(c.file, c.args, {
+        stdio: "inherit", shell: c.shell,
+        // Never the workspace: npm must not pick up a project's .npmrc or a planted npm.cmd.
+        cwd: homedir(),
+        ...(platform === "win32" ? { env: { ...process.env, NoDefaultCurrentDirectoryInExePath: "1" } } : {}),
+      });
+      child.on("error", () => resolve(1));
+      child.on("close", (code               ) => resolve(code ?? 1));
+    } catch {
+      resolve(1);
+    }
+  });
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@synqa/cli",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "description": "Synqa terminal coding agent",
   "type": "module",
   "bin": {