tokens-metric 0.3.3 → 0.3.5

package/dist/core/updater.js

@@ -0,0 +1,65 @@
+import { mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+const CACHE_PATH = () => join(homedir(), '.tokens-metric', 'update-check.json');
+const CACHE_TTL_MS = 24 * 60 * 60 * 1000; // 24 hours
+const REGISTRY_URL = 'https://registry.npmjs.org/tokens-metric/latest';
+function readCache() {
+    try {
+        const raw = readFileSync(CACHE_PATH(), 'utf8');
+        const c = JSON.parse(raw);
+        if (typeof c.checkedAt !== 'number' || typeof c.latestVersion !== 'string')
+            return null;
+        return c;
+    }
+    catch {
+        return null;
+    }
+}
+function writeCache(latestVersion) {
+    try {
+        const dir = join(homedir(), '.tokens-metric');
+        mkdirSync(dir, { recursive: true });
+        writeFileSync(CACHE_PATH(), JSON.stringify({ checkedAt: Date.now(), latestVersion }), 'utf8');
+    }
+    catch {
+        // ignore
+    }
+}
+function isNewer(latest, current) {
+    const parse = (v) => v.replace(/^v/, '').split('.').map(Number);
+    const [lMaj, lMin, lPat] = parse(latest);
+    const [cMaj, cMin, cPat] = parse(current);
+    if (lMaj !== cMaj)
+        return (lMaj ?? 0) > (cMaj ?? 0);
+    if (lMin !== cMin)
+        return (lMin ?? 0) > (cMin ?? 0);
+    return (lPat ?? 0) > (cPat ?? 0);
+}
+/**
+ * Checks npm registry for a newer version. Non-blocking — uses a 24h cache
+ * so most startups skip the network call entirely.
+ *
+ * Returns the latest version string if an update is available, null otherwise.
+ */
+export async function checkForUpdate(currentVersion) {
+    try {
+        const cached = readCache();
+        let latestVersion;
+        if (cached && Date.now() - cached.checkedAt < CACHE_TTL_MS) {
+            latestVersion = cached.latestVersion;
+        }
+        else {
+            const res = await fetch(REGISTRY_URL, { signal: AbortSignal.timeout(5_000) });
+            if (!res.ok)
+                return null;
+            const data = await res.json();
+            latestVersion = data.version;
+            writeCache(latestVersion);
+        }
+        return isNewer(latestVersion, currentVersion) ? latestVersion : null;
+    }
+    catch {
+        return null;
+    }
+}

package/dist/tui/index.js

@@ -11,6 +11,7 @@ import { totalTokens } from '../core/types.js';
 import { anonymizePath } from '../core/privacy.js';
 import { createRequire } from 'node:module';
 import { HELP_TEXT, parseArgs } from '../core/args.js';
+import { checkForUpdate } from '../core/updater.js';
 const require = createRequire(import.meta.url);
 const pkg = require('../../package.json');
 import { bar, sparklineCells } from './bars.js';
@@ -32,6 +33,7 @@ function App() {
     const [now, setNow] = useState(Date.now());
     const [lastTailAt, setLastTailAt] = useState(null);
     const [history, setHistory] = useState(null);
+    const [updateAvailable, setUpdateAvailable] = useState(null);
     const startedAtRef = useRef(Date.now());
     const lastTotalRef = useRef(0);
     // useInput requires raw mode (interactive TTY). Skip it when stdin is piped
@@ -45,6 +47,13 @@ function App() {
                 exit();
         });
     }
+    // Check for newer version on npm — non-blocking, result cached 24h.
+    useEffect(() => {
+        checkForUpdate(pkg.version)
+            .then((v) => { if (v)
+            setUpdateAvailable(v); })
+            .catch(() => undefined);
+    }, []);
     // Historical aggregate over all transcripts. Refreshed on an interval —
     // the live session is already shown in SessionPanel, so minute-grain
     // accuracy on today's bucket is enough and keeps full parses out of the
@@ -125,15 +134,15 @@ function App() {
     const today = countToday(allTranscripts, now);
     const ratePerSec = series.reduce((a, b) => a + b, 0) / SPARK_WIDTH;
     const todaySessions = getTodaySessions(now, transcriptPath);
-    return (_jsxs(Box, { flexDirection: "column", padding: 1, children: [_jsx(Header, { auth: auth, sessionsToday: today.sessions, projectsToday: today.projects, lastTailAt: lastTailAt, startedAt: startedAtRef.current, now: now }), _jsxs(Box, { marginTop: 1, flexDirection: "row", gap: 1, children: [_jsx(SessionPanel, { stats: stats, ratePerSec: ratePerSec, now: now, series: series }), _jsx(BreakdownPanel, { stats: stats })] }), _jsx(Box, { marginTop: 1, children: _jsx(HistoryPanel, { history: history }) }), todaySessions.length > 0 && (_jsx(Box, { marginTop: 1, children: _jsx(TodaySessionsPanel, { sessions: todaySessions, now: now }) })), _jsx(Box, { marginTop: 1, children: _jsx(TranscriptsPanel, { transcripts: transcripts, activePath: transcriptPath, now: now }) }), _jsx(Box, { marginTop: 1, children: _jsxs(Text, { dimColor: true, children: [_jsx(Text, { color: "magenta", children: "q" }), " quit \u00B7", ' ', _jsx(Text, { color: "magenta", children: "live" }), " tail of ~/.claude/projects \u00B7 pricing is", ' ', _jsx(Text, { italic: true, children: "API-equivalent" }), ", not your real bill on a subscription"] }) })] }));
+    return (_jsxs(Box, { flexDirection: "column", padding: 1, children: [_jsx(Header, { auth: auth, sessionsToday: today.sessions, projectsToday: today.projects, lastTailAt: lastTailAt, startedAt: startedAtRef.current, now: now, updateAvailable: updateAvailable }), _jsxs(Box, { marginTop: 1, flexDirection: "row", gap: 1, children: [_jsx(SessionPanel, { stats: stats, ratePerSec: ratePerSec, now: now, series: series }), _jsx(BreakdownPanel, { stats: stats })] }), _jsx(Box, { marginTop: 1, children: _jsx(HistoryPanel, { history: history }) }), todaySessions.length > 0 && (_jsx(Box, { marginTop: 1, children: _jsx(TodaySessionsPanel, { sessions: todaySessions, now: now }) })), _jsx(Box, { marginTop: 1, children: _jsx(TranscriptsPanel, { transcripts: transcripts, activePath: transcriptPath, now: now }) }), _jsx(Box, { marginTop: 1, children: _jsxs(Text, { dimColor: true, children: [_jsx(Text, { color: "magenta", children: "q" }), " quit \u00B7", ' ', _jsx(Text, { color: "magenta", children: "live" }), " tail of ~/.claude/projects \u00B7 pricing is", ' ', _jsx(Text, { italic: true, children: "API-equivalent" }), ", not your real bill on a subscription"] }) })] }));
 }
 // ── Header ───────────────────────────────────────────────────────────────────
-function Header({ auth, sessionsToday, projectsToday, lastTailAt, startedAt, now, }) {
+function Header({ auth, sessionsToday, projectsToday, lastTailAt, startedAt, now, updateAvailable, }) {
     const ok = auth.installed && auth.loggedIn;
     const dot = ok ? 'green' : auth.installed ? 'yellow' : 'red';
     const tailLabel = lastTailAt ? `updated ${timeAgo(now - lastTailAt)} ago` : 'waiting…';
     const tailColor = !lastTailAt ? 'gray' : now - lastTailAt < 10_000 ? 'green' : 'yellow';
-    return (_jsxs(Box, { borderStyle: "round", borderColor: "cyan", paddingX: 1, flexDirection: "column", children: [_jsxs(Box, { children: [_jsx(Text, { bold: true, color: "cyan", children: "\u258C tokens-metric " }), _jsxs(Text, { dimColor: true, children: ["v", pkg.version, " \u2014 real-time Claude Code usage"] })] }), _jsx(Box, { marginTop: 0, children: _jsxs(Text, { children: [_jsx(Text, { color: dot, children: "\u25CF" }), ' ', auth.installed ? 'Claude Code detected' : 'Claude Code NOT detected', _jsx(Text, { dimColor: true, children: '   ·   ' }), _jsx(Text, { children: sessionsToday }), _jsx(Text, { dimColor: true, children: ` ${plural(sessionsToday, 'session', 'sessions')} · ` }), _jsx(Text, { children: projectsToday }), _jsx(Text, { dimColor: true, children: ` ${plural(projectsToday, 'project', 'projects')} today` })] }) }), _jsxs(Box, { children: [_jsx(Text, { dimColor: true, children: "watching ~/.claude/projects \u00B7 " }), _jsx(Text, { color: tailColor, children: tailLabel }), _jsx(Text, { dimColor: true, children: '   ·   uptime ' }), _jsx(Text, { children: timeAgo(now - startedAt) })] })] }));
+    return (_jsxs(Box, { borderStyle: "round", borderColor: "cyan", paddingX: 1, flexDirection: "column", children: [_jsxs(Box, { children: [_jsx(Text, { bold: true, color: "cyan", children: "\u258C tokens-metric " }), _jsxs(Text, { dimColor: true, children: ["v", pkg.version, " \u2014 real-time Claude Code usage"] })] }), _jsx(Box, { marginTop: 0, children: _jsxs(Text, { children: [_jsx(Text, { color: dot, children: "\u25CF" }), ' ', auth.installed ? 'Claude Code detected' : 'Claude Code NOT detected', _jsx(Text, { dimColor: true, children: '   ·   ' }), _jsx(Text, { children: sessionsToday }), _jsx(Text, { dimColor: true, children: ` ${plural(sessionsToday, 'session', 'sessions')} · ` }), _jsx(Text, { children: projectsToday }), _jsx(Text, { dimColor: true, children: ` ${plural(projectsToday, 'project', 'projects')} today` })] }) }), _jsxs(Box, { children: [_jsx(Text, { dimColor: true, children: "watching ~/.claude/projects \u00B7 " }), _jsx(Text, { color: tailColor, children: tailLabel }), _jsx(Text, { dimColor: true, children: '   ·   uptime ' }), _jsx(Text, { children: timeAgo(now - startedAt) })] }), updateAvailable && (_jsxs(Box, { children: [_jsx(Text, { color: "yellow", children: "\u26A1 Update available: " }), _jsxs(Text, { dimColor: true, children: ["v", pkg.version] }), _jsx(Text, { color: "yellow", children: " \u2192 " }), _jsxs(Text, { color: "yellow", bold: true, children: ["v", updateAvailable] }), _jsx(Text, { dimColor: true, children: "   npm install -g tokens-metric" })] }))] }));
 }
 function countToday(transcripts, now) {
     const startOfDay = new Date(now);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tokens-metric",
-  "version": "0.3.3",
+  "version": "0.3.5",
   "description": "Real-time token usage meter for Claude Code — statusline + Ink TUI.",
   "type": "module",
   "bin": {