@tillstack/cli 0.2.2 → 0.3.0

package/dist/update-check.d.ts

@@ -0,0 +1,10 @@
+/** True when `candidate` is a strictly-higher release than `current`. */
+export declare function isNewer(candidate: string, current: string): boolean;
+/**
+ * Print a one-line "update available" notice if npm has a newer release than
+ * `current`. No-op (and no network) when non-interactive, in CI, in --json
+ * mode, when opted out (TILLDEV_NO_UPDATE_CHECK / NO_UPDATE_NOTIFIER), or when
+ * we couldn't determine our own version. Never throws.
+ */
+export declare function notifyUpdate(current: string): Promise<void>;
+//# sourceMappingURL=update-check.d.ts.map

package/dist/update-check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-check.d.ts","sourceRoot":"","sources":["../src/update-check.ts"],"names":[],"mappings":"AA6DA,yEAAyE;AACzE,wBAAgB,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAYnE;AAgBD;;;;;GAKG;AACH,wBAAsB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA0BjE"}

package/dist/update-check.js

@@ -0,0 +1,124 @@
+// Update notifier — tells the user when a newer @tillstack/cli is on npm and
+// how to get it. Deliberately dependency-free (the CLI ships zero runtime deps)
+// and defensive: a broken or slow registry must never disrupt a real command.
+//
+// Cadence: the latest version is cached under ~/.tilldev for a day, so at most
+// one registry round-trip happens per 24h and every other invocation is a
+// synchronous file read. The notice prints to STDERR after the command's own
+// output, so it never corrupts stdout / --json and is invisible when piped.
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+import { mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { c } from './output.js';
+// The registry resolves a dist-tag in the version slot and returns just that
+// version's manifest (small), not the full packument with every version.
+const REGISTRY_LATEST = 'https://registry.npmjs.org/@tillstack%2Fcli/latest';
+const UPGRADE_CMD = 'npm install -g @tillstack/cli@latest';
+const INTERVAL_MS = 24 * 60 * 60 * 1000;
+const FETCH_TIMEOUT_MS = 1200;
+function cacheDir() {
+    return join(homedir(), '.tilldev');
+}
+function cachePath() {
+    return join(cacheDir(), 'update-check.json');
+}
+function readCache() {
+    try {
+        const parsed = JSON.parse(readFileSync(cachePath(), 'utf8'));
+        return { lastCheck: typeof parsed.lastCheck === 'number' ? parsed.lastCheck : 0, latest: parsed.latest };
+    }
+    catch {
+        return { lastCheck: 0 };
+    }
+}
+function writeCache(cache) {
+    try {
+        mkdirSync(cacheDir(), { recursive: true, mode: 0o700 });
+        writeFileSync(cachePath(), JSON.stringify(cache), 'utf8');
+    }
+    catch {
+        /* best-effort: a read-only home must not break the CLI */
+    }
+}
+// Numeric x.y.z comparison. Prerelease/build metadata is dropped — the `latest`
+// dist-tag is a stable release, so comparing release cores is sufficient and
+// avoids nagging about a `-rc` a user is deliberately running.
+function parseVer(v) {
+    const core = v.trim().replace(/^v/, '').split('+')[0]?.split('-')[0] ?? '';
+    if (!core)
+        return null;
+    const parts = core.split('.').map((p) => Number(p));
+    if (!parts.length || parts.some((n) => !Number.isInteger(n) || n < 0))
+        return null;
+    return parts;
+}
+/** True when `candidate` is a strictly-higher release than `current`. */
+export function isNewer(candidate, current) {
+    const a = parseVer(candidate);
+    const b = parseVer(current);
+    if (!a || !b)
+        return false;
+    const len = Math.max(a.length, b.length);
+    for (let i = 0; i < len; i++) {
+        const x = a[i] ?? 0;
+        const y = b[i] ?? 0;
+        if (x > y)
+            return true;
+        if (x < y)
+            return false;
+    }
+    return false;
+}
+async function fetchLatest() {
+    try {
+        const res = await fetch(REGISTRY_LATEST, {
+            signal: AbortSignal.timeout(FETCH_TIMEOUT_MS),
+            headers: { accept: 'application/json' },
+        });
+        if (!res.ok)
+            return undefined;
+        const j = (await res.json());
+        return typeof j.version === 'string' ? j.version : undefined;
+    }
+    catch {
+        return undefined; // offline, DNS, timeout, 5xx — all silent
+    }
+}
+/**
+ * Print a one-line "update available" notice if npm has a newer release than
+ * `current`. No-op (and no network) when non-interactive, in CI, in --json
+ * mode, when opted out (TILLDEV_NO_UPDATE_CHECK / NO_UPDATE_NOTIFIER), or when
+ * we couldn't determine our own version. Never throws.
+ */
+export async function notifyUpdate(current) {
+    try {
+        if (current === '0.0.0')
+            return; // couldn't read our own version — don't guess
+        if (!process.stderr.isTTY)
+            return;
+        if (process.env['CI'])
+            return;
+        if (process.env['TILLDEV_NO_UPDATE_CHECK'] || process.env['NO_UPDATE_NOTIFIER'])
+            return;
+        if (process.argv.slice(2).includes('--json'))
+            return;
+        const cache = readCache();
+        let latest = cache.latest;
+        if (Date.now() - cache.lastCheck > INTERVAL_MS) {
+            const fetched = await fetchLatest();
+            // Stamp the attempt either way: on a registry blip we back off for the
+            // interval rather than adding latency to every subsequent command.
+            writeCache({ lastCheck: Date.now(), latest: fetched ?? cache.latest });
+            latest = fetched ?? cache.latest;
+        }
+        if (!latest || !isNewer(latest, current))
+            return;
+        console.error();
+        console.error(`  ${c.yellow('●')} ${c.bold('Update available')}  ${c.dim(current)} ${c.dim('→')} ${c.green(latest)}`);
+        console.error(`    ${c.dim('run')}  ${c.bold(UPGRADE_CMD)}  ${c.dim('(silence: TILLDEV_NO_UPDATE_CHECK=1)')}`);
+    }
+    catch {
+        /* a broken update check must never disrupt the CLI */
+    }
+}
+//# sourceMappingURL=update-check.js.map

package/dist/update-check.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tillstack/cli",
-  "version": "0.2.2",
+  "version": "0.3.0",
   "description": "TillDev command-line interface — manage TillPulse observability, TillShield edge WAF, TillGate and TillAuth from your terminal (source-map uploads, rules-as-code, and more).",
   "license": "Apache-2.0",
   "type": "module",
@@ -14,6 +14,13 @@
   "engines": {
     "node": ">=20"
   },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx src/index.ts",
+    "typecheck": "tsc --noEmit",
+    "prepack": "tsc",
+    "clean": "rm -rf dist"
+  },
   "devDependencies": {
     "@types/node": "^22.0.0",
     "tsx": "^4.19.2",
@@ -21,12 +28,12 @@
   },
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/tillafrica/tilldev.git",
+    "url": "git+https://git.tilldev.dev/tillafrica/tilldev.git",
     "directory": "apps/cli"
   },
   "homepage": "https://tilldev.dev/docs/tilldev/cli",
   "bugs": {
-    "url": "https://github.com/tillafrica/tilldev/issues"
+    "url": "https://tilldev.dev/docs/tilldev/cli"
   },
   "keywords": [
     "tilldev",
@@ -39,11 +46,5 @@
   ],
   "publishConfig": {
     "access": "public"
-  },
-  "scripts": {
-    "build": "tsc",
-    "dev": "tsx src/index.ts",
-    "typecheck": "tsc --noEmit",
-    "clean": "rm -rf dist"
   }
-}
+}