@freecodecamp/universe-cli 0.7.1 → 0.7.2

package/dist/index.cjs

@@ -24621,8 +24621,162 @@ async function update(options, deps = {}) {
   }
 }
 
+// src/lib/update-notifier.ts
+var import_node_fs3 = require("fs");
+var import_promises8 = require("fs/promises");
+var import_node_os2 = require("os");
+var import_node_path9 = require("path");
+var APP_DIR2 = "universe-cli";
+var CACHE_FILE = "update-check.json";
+var PKG_NAME = "@freecodecamp/universe-cli";
+var NPM_LATEST_URL = `https://registry.npmjs.org/${PKG_NAME}/latest`;
+var TTL_MS = 24 * 60 * 60 * 1e3;
+var FETCH_TIMEOUT_MS = 3e3;
+function configBase2() {
+  const xdg = process.env["XDG_CONFIG_HOME"];
+  if (xdg && xdg.length > 0) return xdg;
+  return (0, import_node_path9.join)((0, import_node_os2.homedir)(), ".config");
+}
+function cachePath() {
+  return (0, import_node_path9.join)(configBase2(), APP_DIR2, CACHE_FILE);
+}
+function isDisabled() {
+  const v = process.env["UNIVERSE_NO_UPDATE_CHECK"];
+  return v === "1" || v === "true";
+}
+function parseCache(raw) {
+  let parsed;
+  try {
+    parsed = JSON.parse(raw);
+  } catch {
+    return null;
+  }
+  if (typeof parsed !== "object" || parsed === null || !("latest" in parsed) || !("lastCheck" in parsed)) {
+    return null;
+  }
+  const { latest, lastCheck } = parsed;
+  if (typeof latest !== "string" || typeof lastCheck !== "number") {
+    return null;
+  }
+  return { latest, lastCheck };
+}
+async function readCache() {
+  try {
+    const raw = await (0, import_promises8.readFile)(cachePath(), "utf-8");
+    return parseCache(raw);
+  } catch {
+    return null;
+  }
+}
+function readCacheSync() {
+  try {
+    const raw = (0, import_node_fs3.readFileSync)(cachePath(), "utf-8");
+    return parseCache(raw);
+  } catch {
+    return null;
+  }
+}
+async function writeCache(c2) {
+  const path = cachePath();
+  await (0, import_promises8.mkdir)((0, import_node_path9.dirname)(path), { recursive: true, mode: 448 });
+  await (0, import_promises8.writeFile)(path, JSON.stringify(c2), { mode: 420 });
+}
+async function fetchLatest() {
+  const ctl = new AbortController();
+  const timer = setTimeout(() => ctl.abort(), FETCH_TIMEOUT_MS);
+  try {
+    const res = await fetch(NPM_LATEST_URL, {
+      signal: ctl.signal,
+      headers: { accept: "application/json" }
+    });
+    if (!res.ok) return null;
+    const body = await res.json();
+    return typeof body.version === "string" ? body.version : null;
+  } catch {
+    return null;
+  } finally {
+    clearTimeout(timer);
+  }
+}
+function compareVersions(a, b) {
+  const pa = parseVersion(a);
+  const pb = parseVersion(b);
+  if (pa === null || pb === null) return 0;
+  for (let i = 0; i < 3; i += 1) {
+    const ai = pa[i] ?? 0;
+    const bi = pb[i] ?? 0;
+    if (ai < bi) return -1;
+    if (ai > bi) return 1;
+  }
+  return 0;
+}
+function parseVersion(s) {
+  const core = s.split("-")[0] ?? "";
+  const parts = core.split(".");
+  if (parts.length !== 3) return null;
+  const nums = parts.map((p2) => Number.parseInt(p2, 10));
+  if (nums.some((n) => Number.isNaN(n))) return null;
+  return [nums[0], nums[1], nums[2]];
+}
+async function refreshIfStale(now = Date.now()) {
+  if (isDisabled()) return;
+  const cache = await readCache();
+  if (cache !== null && now - cache.lastCheck < TTL_MS) return;
+  const latest = await fetchLatest();
+  if (latest === null) return;
+  try {
+    await writeCache({ latest, lastCheck: now });
+  } catch {
+  }
+}
+function getNoticeSync(current) {
+  if (isDisabled()) return null;
+  const cache = readCacheSync();
+  if (cache === null) return null;
+  if (compareVersions(current, cache.latest) >= 0) return null;
+  return { current, latest: cache.latest };
+}
+function useColor() {
+  if (process.env["NO_COLOR"] && process.env["NO_COLOR"].length > 0) {
+    return false;
+  }
+  return process.stderr.isTTY === true;
+}
+function paint(s, code, color) {
+  if (!color) return s;
+  return `\x1B[${code}m${s}\x1B[0m`;
+}
+function formatNotice(n, color = useColor()) {
+  const dim = (s) => paint(s, "2", color);
+  const yellow = (s) => paint(s, "33", color);
+  const cyan = (s) => paint(s, "36", color);
+  const bar = dim("\u2502");
+  const lines = [
+    "",
+    bar,
+    `${yellow("\u25B2")}  Update available: ${dim(n.current)} \u2192 ${cyan(n.latest)}`,
+    `${bar}  Run ${cyan(`npm i -g ${PKG_NAME}`)} to upgrade`,
+    dim("\u2514"),
+    ""
+  ];
+  return lines.join("\n");
+}
+function installExitNotice(current) {
+  if (isDisabled()) return;
+  let printed = false;
+  const emit = () => {
+    if (printed) return;
+    printed = true;
+    const n = getNoticeSync(current);
+    if (n === null) return;
+    process.stderr.write(formatNotice(n));
+  };
+  process.on("beforeExit", emit);
+  process.on("exit", emit);
+}
+
 // src/cli.ts
-var version2 = true ? "0.7.1" : "0.0.0";
+var version2 = true ? "0.7.2" : "0.0.0";
 function handleActionError(command, json2, err) {
   const ctx = { json: json2, command };
   const message = err instanceof Error ? err.message : "unknown error";
@@ -24638,6 +24792,8 @@ function findFirstPositional(args) {
   return -1;
 }
 function run(argv = process.argv) {
+  installExitNotice(version2);
+  void refreshIfStale();
   const args = argv.slice(2);
   const firstPosIdx = findFirstPositional(args);
   const namespace = firstPosIdx >= 0 ? args[firstPosIdx] : void 0;

package/dist/index.js

@@ -2130,8 +2130,162 @@ async function update(options, deps = {}) {
   }
 }
 
+// src/lib/update-notifier.ts
+import { readFileSync } from "fs";
+import { mkdir as mkdir2, readFile as readFile6, writeFile as writeFile2 } from "fs/promises";
+import { homedir as homedir2 } from "os";
+import { dirname as dirname2, join as join3 } from "path";
+var APP_DIR2 = "universe-cli";
+var CACHE_FILE = "update-check.json";
+var PKG_NAME = "@freecodecamp/universe-cli";
+var NPM_LATEST_URL = `https://registry.npmjs.org/${PKG_NAME}/latest`;
+var TTL_MS = 24 * 60 * 60 * 1e3;
+var FETCH_TIMEOUT_MS = 3e3;
+function configBase2() {
+  const xdg = process.env["XDG_CONFIG_HOME"];
+  if (xdg && xdg.length > 0) return xdg;
+  return join3(homedir2(), ".config");
+}
+function cachePath() {
+  return join3(configBase2(), APP_DIR2, CACHE_FILE);
+}
+function isDisabled() {
+  const v = process.env["UNIVERSE_NO_UPDATE_CHECK"];
+  return v === "1" || v === "true";
+}
+function parseCache(raw) {
+  let parsed;
+  try {
+    parsed = JSON.parse(raw);
+  } catch {
+    return null;
+  }
+  if (typeof parsed !== "object" || parsed === null || !("latest" in parsed) || !("lastCheck" in parsed)) {
+    return null;
+  }
+  const { latest, lastCheck } = parsed;
+  if (typeof latest !== "string" || typeof lastCheck !== "number") {
+    return null;
+  }
+  return { latest, lastCheck };
+}
+async function readCache() {
+  try {
+    const raw = await readFile6(cachePath(), "utf-8");
+    return parseCache(raw);
+  } catch {
+    return null;
+  }
+}
+function readCacheSync() {
+  try {
+    const raw = readFileSync(cachePath(), "utf-8");
+    return parseCache(raw);
+  } catch {
+    return null;
+  }
+}
+async function writeCache(c) {
+  const path = cachePath();
+  await mkdir2(dirname2(path), { recursive: true, mode: 448 });
+  await writeFile2(path, JSON.stringify(c), { mode: 420 });
+}
+async function fetchLatest() {
+  const ctl = new AbortController();
+  const timer = setTimeout(() => ctl.abort(), FETCH_TIMEOUT_MS);
+  try {
+    const res = await fetch(NPM_LATEST_URL, {
+      signal: ctl.signal,
+      headers: { accept: "application/json" }
+    });
+    if (!res.ok) return null;
+    const body = await res.json();
+    return typeof body.version === "string" ? body.version : null;
+  } catch {
+    return null;
+  } finally {
+    clearTimeout(timer);
+  }
+}
+function compareVersions(a, b) {
+  const pa = parseVersion(a);
+  const pb = parseVersion(b);
+  if (pa === null || pb === null) return 0;
+  for (let i = 0; i < 3; i += 1) {
+    const ai = pa[i] ?? 0;
+    const bi = pb[i] ?? 0;
+    if (ai < bi) return -1;
+    if (ai > bi) return 1;
+  }
+  return 0;
+}
+function parseVersion(s) {
+  const core = s.split("-")[0] ?? "";
+  const parts = core.split(".");
+  if (parts.length !== 3) return null;
+  const nums = parts.map((p) => Number.parseInt(p, 10));
+  if (nums.some((n) => Number.isNaN(n))) return null;
+  return [nums[0], nums[1], nums[2]];
+}
+async function refreshIfStale(now = Date.now()) {
+  if (isDisabled()) return;
+  const cache = await readCache();
+  if (cache !== null && now - cache.lastCheck < TTL_MS) return;
+  const latest = await fetchLatest();
+  if (latest === null) return;
+  try {
+    await writeCache({ latest, lastCheck: now });
+  } catch {
+  }
+}
+function getNoticeSync(current) {
+  if (isDisabled()) return null;
+  const cache = readCacheSync();
+  if (cache === null) return null;
+  if (compareVersions(current, cache.latest) >= 0) return null;
+  return { current, latest: cache.latest };
+}
+function useColor() {
+  if (process.env["NO_COLOR"] && process.env["NO_COLOR"].length > 0) {
+    return false;
+  }
+  return process.stderr.isTTY === true;
+}
+function paint(s, code, color) {
+  if (!color) return s;
+  return `\x1B[${code}m${s}\x1B[0m`;
+}
+function formatNotice(n, color = useColor()) {
+  const dim = (s) => paint(s, "2", color);
+  const yellow = (s) => paint(s, "33", color);
+  const cyan = (s) => paint(s, "36", color);
+  const bar = dim("\u2502");
+  const lines = [
+    "",
+    bar,
+    `${yellow("\u25B2")}  Update available: ${dim(n.current)} \u2192 ${cyan(n.latest)}`,
+    `${bar}  Run ${cyan(`npm i -g ${PKG_NAME}`)} to upgrade`,
+    dim("\u2514"),
+    ""
+  ];
+  return lines.join("\n");
+}
+function installExitNotice(current) {
+  if (isDisabled()) return;
+  let printed = false;
+  const emit = () => {
+    if (printed) return;
+    printed = true;
+    const n = getNoticeSync(current);
+    if (n === null) return;
+    process.stderr.write(formatNotice(n));
+  };
+  process.on("beforeExit", emit);
+  process.on("exit", emit);
+}
+
 // src/cli.ts
-var version = true ? "0.7.1" : "0.0.0";
+var version = true ? "0.7.2" : "0.0.0";
 function handleActionError(command, json, err) {
   const ctx = { json, command };
   const message = err instanceof Error ? err.message : "unknown error";
@@ -2147,6 +2301,8 @@ function findFirstPositional(args) {
   return -1;
 }
 function run(argv = process.argv) {
+  installExitNotice(version);
+  void refreshIfStale();
   const args = argv.slice(2);
   const firstPosIdx = findFirstPositional(args);
   const namespace = firstPosIdx >= 0 ? args[firstPosIdx] : void 0;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@freecodecamp/universe-cli",
-  "version": "0.7.1",
+  "version": "0.7.2",
   "main": "dist/index.js",
   "scripts": {
     "test": "vitest run",