nukebase 2.0.4 → 2.0.5

package/bin/nukebase.js

@@ -8,6 +8,19 @@
 const args = require('../lib/args').parse(process.argv.slice(2));
 const { version } = require('../package.json');
 
+// "nukebase X is available": checked once a day while the command runs, printed
+// when the command finishes. 'exit' covers both kinds of command: project
+// commands end with process.exit, account commands end by themselves.
+// Not after --version, whose output scripts read.
+if (!(args.has('version') && !args.command)) {
+  const updates = require('../lib/update-check');
+  updates.scheduleCheck();
+  process.on('exit', () => {
+    const line = updates.notice(version);
+    if (line) console.error(line);
+  });
+}
+
 const ACCOUNT_COMMANDS = ['login', 'logout', 'accounts', 'use', 'whoami', 'create', 'link'];
 const PROJECT_COMMANDS = [
   'push', 'pull', 'update', 'rollback', 'restorepoints', 'restore-points', 'backup', 'env',

package/lib/update-check.js

@@ -0,0 +1,73 @@
+// "A newer nukebase is available" notice.
+//
+// A global install never updates itself, and while one is installed even
+// `npx nukebase` keeps running it. So once a day, while a command runs, the
+// CLI asks the npm registry for the latest version (one small request, 1.5 s
+// at most) and saves it next to the credentials. When the command finishes it
+// prints one line if that version is newer than the one running.
+//
+// Off when NUKEBASE_NO_UPDATE_CHECK or CI is set.
+
+const fs = require('fs');
+const path = require('path');
+const { FILE: CREDENTIALS_FILE } = require('./credentials');
+
+const CACHE = path.join(path.dirname(CREDENTIALS_FILE), 'update-check.json');
+const CHECK_EVERY_MS = 24 * 60 * 60 * 1000;
+const REGISTRY_URL = 'https://registry.npmjs.org/nukebase/latest';
+
+const disabled = () => !!(process.env.NUKEBASE_NO_UPDATE_CHECK || process.env.CI);
+
+function readCache() {
+  try { return JSON.parse(fs.readFileSync(CACHE, 'utf8')); } catch { return {}; }
+}
+
+// "2.0.10" > "2.0.9"; pre-release tags are ignored.
+function isNewer(a, b) {
+  const pa = String(a).split('-')[0].split('.').map(Number);
+  const pb = String(b).split('-')[0].split('.').map(Number);
+  for (let i = 0; i < 3; i++) {
+    if ((pa[i] || 0) !== (pb[i] || 0)) return (pa[i] || 0) > (pb[i] || 0);
+  }
+  return false;
+}
+
+// Ask the registry, if a day has passed since the last time. Runs alongside
+// the command; a command that exits first simply checks again next time.
+// Never throws.
+function scheduleCheck() {
+  if (disabled()) return;
+  if (Date.now() - (readCache().checkedAt || 0) < CHECK_EVERY_MS) return;
+  runCheck().catch(() => {});
+}
+
+// The notice for the version running now, or null.
+function notice(current) {
+  if (disabled()) return null;
+  const { latest } = readCache();
+  if (!latest || !isNewer(latest, current)) return null;
+  // Run through npx (from npm's cache), or installed globally?
+  const viaNpx = __dirname.split(path.sep).includes('_npx');
+  const how = viaNpx
+    ? 'Run it with: npx nukebase@latest <command>'
+    : 'Update with: npm i -g nukebase@latest';
+  return `\nnukebase ${latest} is available (you have ${current}). ${how}`;
+}
+
+// One request to the registry; the answer is saved for a day.
+async function runCheck() {
+  let latest = null;
+  try {
+    const r = await fetch(REGISTRY_URL, { signal: AbortSignal.timeout(1500) });
+    if (r.ok) latest = (await r.json()).version || null;
+  } catch {}
+  try {
+    fs.mkdirSync(path.dirname(CACHE), { recursive: true });
+    // Record the attempt even when it failed, so an offline machine doesn't
+    // re-check on every command; keep the last known version.
+    const prev = readCache();
+    fs.writeFileSync(CACHE, JSON.stringify({ checkedAt: Date.now(), latest: latest || prev.latest || null }) + '\n');
+  } catch {}
+}
+
+module.exports = { scheduleCheck, notice, isNewer };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nukebase",
-  "version": "2.0.4",
+  "version": "2.0.5",
   "description": "NukeBase CLI: create, deploy and manage NukeBase projects",
   "bin": {
     "nukebase": "bin/nukebase.js"