notoken-core 1.0.0 → 1.1.0

package/dist/index.d.ts

@@ -44,6 +44,7 @@ export { formatExplain } from "./utils/explain.js";
 export { formatParsedCommand } from "./utils/output.js";
 export { Spinner, withSpinner, progressBar } from "./utils/spinner.js";
 export { createBackup, rollback, listBackups, cleanExpiredBackups, formatBackupList } from "./utils/autoBackup.js";
+export { checkForUpdate, checkForUpdateSync, runUpdate, formatUpdateBanner, type UpdateInfo } from "./utils/updater.js";
 export { logFailure, loadFailures, clearFailures } from "./utils/logger.js";
 export { logUncertainty, loadUncertaintyLog, getUncertaintySummary } from "./nlp/uncertainty.js";
 export { recordHistory, loadHistory, getRecentHistory, searchHistory } from "./context/history.js";

package/dist/index.js

@@ -56,6 +56,8 @@ export { formatParsedCommand } from "./utils/output.js";
 export { Spinner, withSpinner, progressBar } from "./utils/spinner.js";
 // ── Auto-backup ──
 export { createBackup, rollback, listBackups, cleanExpiredBackups, formatBackupList } from "./utils/autoBackup.js";
+// ── Updates ──
+export { checkForUpdate, checkForUpdateSync, runUpdate, formatUpdateBanner } from "./utils/updater.js";
 // ── Logging ──
 export { logFailure, loadFailures, clearFailures } from "./utils/logger.js";
 export { logUncertainty, loadUncertaintyLog, getUncertaintySummary } from "./nlp/uncertainty.js";

package/dist/utils/updater.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Update checker.
+ *
+ * Checks notoken.sh/api/version (primary) or npm registry (fallback)
+ * for the latest version. Caches result for 1 hour.
+ *
+ * Used by both CLI (startup banner) and desktop app (badge).
+ */
+export interface UpdateInfo {
+    current: string;
+    latest: string;
+    updateAvailable: boolean;
+    checkedAt: string;
+}
+/**
+ * Check for updates. Returns cached result if fresh.
+ * Non-blocking — never throws, returns null on failure.
+ */
+export declare function checkForUpdate(): Promise<UpdateInfo | null>;
+/**
+ * Synchronous check — reads cache only, no network.
+ * Use this for startup banner (non-blocking).
+ */
+export declare function checkForUpdateSync(): UpdateInfo | null;
+/**
+ * Run the actual update.
+ */
+export declare function runUpdate(): string;
+/**
+ * Format update banner for terminal.
+ */
+export declare function formatUpdateBanner(info: UpdateInfo): string;

package/dist/utils/updater.js

@@ -0,0 +1,157 @@
+/**
+ * Update checker.
+ *
+ * Checks notoken.sh/api/version (primary) or npm registry (fallback)
+ * for the latest version. Caches result for 1 hour.
+ *
+ * Used by both CLI (startup banner) and desktop app (badge).
+ */
+import { existsSync, readFileSync, writeFileSync, mkdirSync } from "node:fs";
+import { resolve } from "node:path";
+import { execSync } from "node:child_process";
+import { USER_HOME } from "./paths.js";
+const CACHE_FILE = resolve(USER_HOME, ".update-check.json");
+const CACHE_TTL = 3600_000; // 1 hour
+const CURRENT_VERSION = getInstalledVersion();
+/**
+ * Check for updates. Returns cached result if fresh.
+ * Non-blocking — never throws, returns null on failure.
+ */
+export async function checkForUpdate() {
+    try {
+        // Check cache first
+        const cached = readCache();
+        if (cached)
+            return cached;
+        // Fetch latest version
+        const latest = await fetchLatestVersion();
+        if (!latest)
+            return null;
+        const info = {
+            current: CURRENT_VERSION,
+            latest,
+            updateAvailable: isNewer(latest, CURRENT_VERSION),
+            checkedAt: new Date().toISOString(),
+        };
+        writeCache(info);
+        return info;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Synchronous check — reads cache only, no network.
+ * Use this for startup banner (non-blocking).
+ */
+export function checkForUpdateSync() {
+    return readCache();
+}
+/**
+ * Run the actual update.
+ */
+export function runUpdate() {
+    try {
+        const result = execSync("npm install -g notoken@latest", {
+            encoding: "utf-8",
+            timeout: 120_000,
+            stdio: ["pipe", "pipe", "pipe"],
+        });
+        // Clear cache so next check picks up new version
+        clearCache();
+        return result;
+    }
+    catch (err) {
+        throw new Error(`Update failed: ${err instanceof Error ? err.message : err}`);
+    }
+}
+/**
+ * Format update banner for terminal.
+ */
+export function formatUpdateBanner(info) {
+    if (!info.updateAvailable)
+        return "";
+    return `\x1b[33m⬆ Update available: ${info.current} → ${info.latest}\x1b[0m \x1b[2m(notoken update)\x1b[0m`;
+}
+// ─── Internals ──────────────────────────────────────────────────────────────
+async function fetchLatestVersion() {
+    // Try notoken.sh API first
+    try {
+        const response = await fetch("https://notoken.sh/api/version", { signal: AbortSignal.timeout(5000) });
+        if (response.ok) {
+            const data = (await response.json());
+            if (data.version)
+                return data.version;
+        }
+    }
+    catch { }
+    // Fallback: npm registry
+    try {
+        const response = await fetch("https://registry.npmjs.org/notoken/latest", { signal: AbortSignal.timeout(5000) });
+        if (response.ok) {
+            const data = (await response.json());
+            if (data.version)
+                return data.version;
+        }
+    }
+    catch { }
+    // Fallback: npm CLI
+    try {
+        const result = execSync("npm view notoken version", { encoding: "utf-8", timeout: 10_000, stdio: ["pipe", "pipe", "pipe"] });
+        return result.trim() || null;
+    }
+    catch { }
+    return null;
+}
+function getInstalledVersion() {
+    try {
+        // Read from our own package.json
+        const pkg = JSON.parse(execSync("npm list -g notoken --json --depth=0 2>/dev/null", { encoding: "utf-8", timeout: 5000 }));
+        return pkg.dependencies?.notoken?.version ?? "0.0.0";
+    }
+    catch {
+        return "0.0.0";
+    }
+}
+function isNewer(latest, current) {
+    const l = latest.split(".").map(Number);
+    const c = current.split(".").map(Number);
+    for (let i = 0; i < 3; i++) {
+        if ((l[i] ?? 0) > (c[i] ?? 0))
+            return true;
+        if ((l[i] ?? 0) < (c[i] ?? 0))
+            return false;
+    }
+    return false;
+}
+function readCache() {
+    try {
+        if (!existsSync(CACHE_FILE))
+            return null;
+        const raw = JSON.parse(readFileSync(CACHE_FILE, "utf-8"));
+        const age = Date.now() - new Date(raw.checkedAt).getTime();
+        if (age > CACHE_TTL)
+            return null;
+        // Refresh current version in case user updated
+        raw.current = CURRENT_VERSION;
+        raw.updateAvailable = isNewer(raw.latest, CURRENT_VERSION);
+        return raw;
+    }
+    catch {
+        return null;
+    }
+}
+function writeCache(info) {
+    try {
+        mkdirSync(USER_HOME, { recursive: true });
+        writeFileSync(CACHE_FILE, JSON.stringify(info));
+    }
+    catch { }
+}
+function clearCache() {
+    try {
+        if (existsSync(CACHE_FILE))
+            writeFileSync(CACHE_FILE, "{}");
+    }
+    catch { }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "notoken-core",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "Shared engine for notoken — NLP parsing, execution, detection, analysis",
   "type": "module",
   "license": "MIT",
@@ -16,7 +16,10 @@
   "exports": {
     ".": "./dist/index.js"
   },
-  "files": ["dist/", "config/"],
+  "files": [
+    "dist/",
+    "config/"
+  ],
   "scripts": {
     "build": "tsc",
     "test": "vitest run"