uniweb 0.12.13 → 0.12.14

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "uniweb",
-  "version": "0.12.13",
+  "version": "0.12.14",
   "description": "Create structured Vite + React sites with content/code separation",
   "type": "module",
   "bin": {
@@ -41,9 +41,9 @@
     "js-yaml": "^4.1.0",
     "prompts": "^2.4.2",
     "tar": "^7.0.0",
-    "@uniweb/core": "0.7.11",
+    "@uniweb/runtime": "0.8.13",
     "@uniweb/kit": "0.9.11",
-    "@uniweb/runtime": "0.8.13"
+    "@uniweb/core": "0.7.11"
   },
   "peerDependencies": {
     "@uniweb/build": "0.14.2",

package/src/index.js

@@ -449,14 +449,26 @@ async function main() {
   // Output convention: the version goes to stdout (parseable, scriptable —
   // `version=$(uniweb --version)` should keep working). Any staleness
   // notice goes to stderr, so it shows in interactive terminals but
-  // doesn't pollute captured output. Cache-only — never makes a network
-  // call from this path.
+  // doesn't pollute captured output.
+  //
+  // Two staleness paths split by stdout TTY-ness:
+  //   - TTY (interactive user typed it): fetch the registry with a tight
+  //     timeout. Accuracy matters — a fresh install would otherwise see
+  //     no notice on its first invocation (the cache is empty). Network
+  //     latency is acceptable here, capped at ~1.5s by the abort timeout.
+  //   - Non-TTY (script captured stdout, piped through, etc.): cache-only.
+  //     Scripts must stay fast and offline-safe. The `gh --version` /
+  //     `claude --version` convention.
   if (command === '--version' || command === '-v') {
     console.log(`uniweb ${getCliVersion()}`)
     if (isGlobalInstall()) {
       try {
-        const { maybeNotifyFromCache } = await import('./utils/update-check.js')
-        maybeNotifyFromCache(getCliVersion(), 'soft')
+        const { fetchAndNotifyIfNewer, maybeNotifyFromCache } = await import('./utils/update-check.js')
+        if (process.stdout.isTTY) {
+          await fetchAndNotifyIfNewer(getCliVersion(), { tone: 'soft' })
+        } else {
+          maybeNotifyFromCache(getCliVersion(), 'soft')
+        }
       } catch { /* ignore */ }
     }
     return

package/src/utils/update-check.js

@@ -101,6 +101,47 @@ export function maybeNotifyFromCache(currentVersion, tone = 'eager') {
 // and gets the eager default. Keeps that call site unchanged.
 export const maybeEagerNotification = maybeNotifyFromCache
 
+/**
+ * Fetch the latest version (with a tight timeout) and print a notice if
+ * a newer version is found. Updates the on-disk cache as a side effect
+ * so future cache-only callers benefit too.
+ *
+ * Use this for TTY invocations of `--version` / `-v` where the user is
+ * interactively asking about the version and a brief network wait is
+ * acceptable. Don't use it for non-TTY callers — scripts capturing
+ * stdout (`version=$(uniweb -v)`) need a fast, offline-safe path.
+ *
+ * @param {string} currentVersion
+ * @param {object} [opts]
+ * @param {number} [opts.timeoutMs=1500] Network timeout. Slow / offline
+ *   calls return silently — never block the verb for long.
+ * @param {'eager'|'soft'} [opts.tone='soft'] Notification copy.
+ * @returns {Promise<boolean>} true if a notice was printed.
+ */
+export async function fetchAndNotifyIfNewer(currentVersion, { timeoutMs = 1500, tone = 'soft' } = {}) {
+  const controller = new AbortController()
+  const timer = setTimeout(() => controller.abort(), timeoutMs)
+  let latest = null
+  try {
+    const res = await fetch('https://registry.npmjs.org/uniweb/latest', { signal: controller.signal })
+    if (res.ok) {
+      const data = await res.json()
+      latest = data?.version || null
+    }
+  } catch {
+    // Aborted, network error, parse error — all silent. The verb
+    // shouldn't block on update-check failures.
+  } finally {
+    clearTimeout(timer)
+  }
+  if (!latest) return false
+  // Refresh the cache so other code paths see this fresh result.
+  writeState({ lastCheck: Date.now(), latestVersion: latest })
+  if (compareSemver(latest, currentVersion) <= 0) return false
+  printNotification(currentVersion, latest, tone)
+  return true
+}
+
 /**
  * Start a non-blocking update check.
  *