@birdybeep/cli 0.1.0 → 0.2.0

package/dist/index.cjs

@@ -205,8 +205,9 @@ async function dispatch(argv, deps) {
     io.errline(`birdybeep ${path}: unknown option "${unknown}".`);
     return EXIT.USAGE;
   }
+  let code;
   try {
-    return await command.run({ args, flags, io });
+    code = await command.run({ args, flags, io });
   } catch (err) {
     if (err instanceof MissingInputError) {
       io.errline(
@@ -217,6 +218,13 @@ async function dispatch(argv, deps) {
     io.errline(`birdybeep ${path}: ${err instanceof Error ? err.message : String(err)}`);
     return EXIT.ERROR;
   }
+  if (deps.notifyUpdate !== void 0) {
+    try {
+      await deps.notifyUpdate({ command: pathParts[0] ?? "", flags, io });
+    } catch {
+    }
+  }
+  return code;
 }
 
 // src/commands/agent.ts
@@ -372,6 +380,12 @@ function resolveApiUrl() {
   if (env !== void 0 && env.length > 0) return env;
   return readCliConfig().apiUrl ?? DEFAULT_API_URL;
 }
+var DEFAULT_REGISTRY_URL = "https://registry.npmjs.org";
+function resolveRegistryUrl() {
+  const env = process.env["npm_config_registry"];
+  if (env !== void 0 && env.length > 0) return env;
+  return DEFAULT_REGISTRY_URL;
+}
 
 // src/diagnostics.ts
 var import_agent_core3 = require("@birdybeep/agent-core");
@@ -662,7 +676,7 @@ async function pairTokenPoll(apiUrl, deviceCode, fetchImpl, machineFingerprint)
 }
 
 // src/version.ts
-var CLI_VERSION = "0.1.0".length > 0 ? "0.1.0" : "0.0.0";
+var CLI_VERSION = "0.2.0".length > 0 ? "0.2.0" : "0.0.0";
 
 // src/commands/pair.ts
 var DEFAULT_POLL_INTERVAL_MS = 2e3;
@@ -999,13 +1013,152 @@ function buildCommands() {
   ];
 }
 
+// src/update-check.ts
+var import_node_fs3 = require("fs");
+var import_node_path2 = require("path");
+var import_agent_core13 = require("@birdybeep/agent-core");
+var PACKAGE_NAME = "@birdybeep/cli";
+var PACKAGE_PATH = "@birdybeep%2Fcli";
+var UPDATE_CACHE_FILE = "update-check.json";
+var DEFAULT_CHECK_INTERVAL_MS = 24 * 60 * 60 * 1e3;
+var DEFAULT_TIMEOUT_MS = 1500;
+var SKIP_COMMANDS = /* @__PURE__ */ new Set(["hook", "report-status"]);
+var SEMVER_RE = /^v?(\d+)\.(\d+)\.(\d+)(?:-([0-9A-Za-z.-]+))?(?:\+[0-9A-Za-z.-]+)?$/;
+function parseSemver(input) {
+  const m = SEMVER_RE.exec(input.trim());
+  if (m === null) return null;
+  return {
+    major: Number(m[1]),
+    minor: Number(m[2]),
+    patch: Number(m[3]),
+    prerelease: m[4] !== void 0 ? m[4].split(".") : []
+  };
+}
+function comparePrerelease(a, b) {
+  if (a.length === 0 && b.length === 0) return 0;
+  if (a.length === 0) return 1;
+  if (b.length === 0) return -1;
+  const len = Math.min(a.length, b.length);
+  for (let i = 0; i < len; i++) {
+    const ai = a[i];
+    const bi = b[i];
+    const aNum = /^\d+$/.test(ai);
+    const bNum = /^\d+$/.test(bi);
+    if (aNum && bNum) {
+      const d = Number(ai) - Number(bi);
+      if (d !== 0) return d < 0 ? -1 : 1;
+    } else if (aNum) {
+      return -1;
+    } else if (bNum) {
+      return 1;
+    } else if (ai !== bi) {
+      return ai < bi ? -1 : 1;
+    }
+  }
+  if (a.length === b.length) return 0;
+  return a.length < b.length ? -1 : 1;
+}
+function compareSemver(a, b) {
+  if (a.major !== b.major) return a.major < b.major ? -1 : 1;
+  if (a.minor !== b.minor) return a.minor < b.minor ? -1 : 1;
+  if (a.patch !== b.patch) return a.patch < b.patch ? -1 : 1;
+  return comparePrerelease(a.prerelease, b.prerelease);
+}
+function isNewer(current, latest) {
+  const cur = parseSemver(current);
+  const lat = parseSemver(latest);
+  return cur !== null && lat !== null && compareSemver(cur, lat) < 0;
+}
+function updateCachePath() {
+  return (0, import_node_path2.join)((0, import_agent_core13.birdyBeepConfigDir)(), UPDATE_CACHE_FILE);
+}
+function readUpdateCache() {
+  try {
+    const parsed = JSON.parse((0, import_node_fs3.readFileSync)(updateCachePath(), "utf8"));
+    if (typeof parsed !== "object" || parsed === null) return null;
+    const { checkedAt, latest } = parsed;
+    if (typeof checkedAt !== "number") return null;
+    if (latest !== null && typeof latest !== "string") return null;
+    return { checkedAt, latest };
+  } catch {
+    return null;
+  }
+}
+function writeUpdateCache(cache) {
+  (0, import_node_fs3.mkdirSync)((0, import_agent_core13.birdyBeepConfigDir)(), { recursive: true, mode: 448 });
+  (0, import_node_fs3.writeFileSync)(updateCachePath(), `${JSON.stringify(cache)}
+`, { mode: 384 });
+}
+async function fetchLatestVersion(registryUrl, fetchImpl, timeoutMs) {
+  const url = `${registryUrl.replace(/\/+$/, "")}/${PACKAGE_PATH}/latest`;
+  const controller = new AbortController();
+  const timer = setTimeout(() => controller.abort(), timeoutMs);
+  if (typeof timer.unref === "function") timer.unref();
+  try {
+    const res = await fetchImpl(url, {
+      headers: { accept: "application/json" },
+      signal: controller.signal
+    });
+    if (!res.ok) throw new Error(`registry responded ${res.status}`);
+    const body = await res.json();
+    if (typeof body.version !== "string" || body.version.length === 0) {
+      throw new Error("registry response had no version");
+    }
+    return body.version;
+  } finally {
+    clearTimeout(timer);
+  }
+}
+function renderNotice(current, latest) {
+  return `a new version of birdybeep is available: ${current} \u2192 ${latest}
+upgrade with: npm install -g ${PACKAGE_NAME}@latest`;
+}
+async function maybeNotifyUpdate(opts) {
+  try {
+    if (opts.command !== void 0 && SKIP_COMMANDS.has(opts.command)) return;
+    if (opts.flags.json || opts.flags.nonInteractive) return;
+    const env = opts.env ?? process.env;
+    if (env["BIRDYBEEP_NO_UPDATE_NOTIFIER"] || env["NO_UPDATE_NOTIFIER"] || env["CI"]) return;
+    const isTTY = opts.isTTY ?? Boolean(process.stderr.isTTY);
+    if (!isTTY) return;
+    const current = opts.currentVersion ?? CLI_VERSION;
+    const now = opts.now ?? Date.now();
+    const intervalMs = opts.intervalMs ?? DEFAULT_CHECK_INTERVAL_MS;
+    const readCache = opts.readCache ?? readUpdateCache;
+    const writeCache = opts.writeCache ?? writeUpdateCache;
+    let cache = readCache();
+    if (cache === null || now - cache.checkedAt >= intervalMs) {
+      let latest = cache?.latest ?? null;
+      try {
+        latest = await fetchLatestVersion(
+          opts.registryUrl ?? resolveRegistryUrl(),
+          opts.fetchImpl ?? fetch,
+          opts.timeoutMs ?? DEFAULT_TIMEOUT_MS
+        );
+      } catch {
+      }
+      cache = { checkedAt: now, latest };
+      try {
+        writeCache(cache);
+      } catch {
+      }
+    }
+    if (cache.latest !== null && isNewer(current, cache.latest)) {
+      opts.io.errline(renderNotice(current, cache.latest));
+    }
+  } catch {
+  }
+}
+
 // src/cli.ts
 function runCli(argv, deps = {}) {
+  const notifyUpdate = deps.updateCheck === false ? void 0 : (ctx) => maybeNotifyUpdate({ ...ctx, ...deps.updateCheck ?? {} });
   return dispatch(argv, {
     version: CLI_VERSION,
     commands: deps.commands ?? buildCommands(),
     stdout: deps.stdout ?? process.stdout,
     stderr: deps.stderr ?? process.stderr,
+    ...notifyUpdate !== void 0 ? { notifyUpdate } : {},
     ...deps.ensureConfig !== void 0 ? { ensureConfig: deps.ensureConfig } : {}
   });
 }