@rulemetric/cli 0.1.1 → 0.2.1

package/dist/lib/version-check.js

@@ -0,0 +1,106 @@
+// CLI version-check banner. Every command kicks off an async fetch to
+// /api/cli/latest-version (cached for an hour) and prints a one-line
+// notice on the next invocation if the cached version is newer than the
+// currently-running CLI.
+//
+// Design notes:
+// - Fire-and-forget: we never block command execution on the network.
+// - Cache: ~/.config/rulemetric/version-check.json, TTL 1h. Stored on disk
+//   so the check survives between CLI invocations (each invocation is a
+//   fresh process — in-memory cache wouldn't help).
+// - "Newer" uses semver-naive numeric comparison split on dots — fine for
+//   our 0.x line; tightening this is a follow-up if/when we adopt semver
+//   pre-releases.
+// - We DO NOT have an `upgrade` command yet; the banner just says "version
+//   X.Y.Z available" and trusts the user to know how they installed.
+import { mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+const CONFIG_DIR = join(homedir(), '.config', 'rulemetric');
+const CACHE_FILE = join(CONFIG_DIR, 'version-check.json');
+const TTL_MS = 60 * 60 * 1000; // 1h
+function readCache() {
+    try {
+        const data = JSON.parse(readFileSync(CACHE_FILE, 'utf-8'));
+        if (typeof data.latest === 'string' && typeof data.fetchedAtMs === 'number') {
+            return data;
+        }
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+function writeCache(entry) {
+    try {
+        mkdirSync(CONFIG_DIR, { recursive: true });
+        writeFileSync(CACHE_FILE, JSON.stringify(entry));
+    }
+    catch {
+        // Best-effort: a write failure just means we'll re-fetch next time.
+    }
+}
+function compareVersions(a, b) {
+    const parse = (v) => v.split('.').map((n) => Number.parseInt(n, 10) || 0);
+    const pa = parse(a);
+    const pb = parse(b);
+    const len = Math.max(pa.length, pb.length);
+    for (let i = 0; i < len; i++) {
+        const ai = pa[i] ?? 0;
+        const bi = pb[i] ?? 0;
+        if (ai < bi)
+            return -1;
+        if (ai > bi)
+            return 1;
+    }
+    return 0;
+}
+function getApiUrl() {
+    const env = process.env.RULEMETRIC_API_URL;
+    if (env)
+        return env.replace(/\/$/, '');
+    return 'https://rulemetric.com';
+}
+/**
+ * Fetches latest version from the API in the background and refreshes the
+ * cache if the entry is missing or older than TTL_MS. Never throws.
+ */
+export function refreshVersionCacheInBackground() {
+    const cached = readCache();
+    if (cached && Date.now() - cached.fetchedAtMs < TTL_MS)
+        return;
+    // Fire-and-forget — explicitly catch every failure mode so an unhandled
+    // rejection can never reach the user. AbortController guards against
+    // hanging connections (3s budget).
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), 3000);
+    globalThis
+        .fetch(`${getApiUrl()}/api/cli/latest-version`, { signal: controller.signal })
+        .then(async (res) => {
+        clearTimeout(timer);
+        if (!res.ok)
+            return;
+        const data = (await res.json());
+        if (typeof data.latest !== 'string')
+            return;
+        writeCache({ latest: data.latest, fetchedAtMs: Date.now() });
+    })
+        .catch(() => {
+        clearTimeout(timer);
+        // Network error, timeout, malformed JSON — silently ignore. Banner
+        // is purely a nicety; we never want it to surface failures.
+    });
+}
+/**
+ * Returns a one-line upgrade banner if a newer version is cached, else null.
+ * Designed to be printed to stderr by the CLI's BaseCommand on launch.
+ */
+export function getUpgradeBanner(currentVersion) {
+    const cached = readCache();
+    if (!cached)
+        return null;
+    if (compareVersions(cached.latest, currentVersion) <= 0)
+        return null;
+    return `RuleMetric ${cached.latest} available — you're on ${currentVersion}.`;
+}
+//# sourceMappingURL=version-check.js.map

package/dist/lib/version-check.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version-check.js","sourceRoot":"","sources":["../../src/lib/version-check.ts"],"names":[],"mappings":"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"}