add update check

Author: emilwidlund

package.json

@@ -1,6 +1,6 @@
 {
   "name": "polar-cli",
-  "version": "1.1.1",
+  "version": "1.2.1",
   "description": "",
   "bin": "bin/cli.js",
   "type": "module",

src/cli.ts

@@ -7,6 +7,7 @@ import { update } from "./commands/update";
 import * as Migration from "./services/migration/migrate";
 import * as OAuth from "./services/oauth";
 import * as Polar from "./services/polar";
+import { showUpdateNotice, checkForUpdateInBackground } from "./services/update-check";
 import { VERSION } from "./version";
 
 const mainCommand = Command.make("polar").pipe(
@@ -30,4 +31,7 @@ const services = Layer.mergeAll(
   BunContext.layer
 );
 
+showUpdateNotice();
+checkForUpdateInBackground();
+
 cli(process.argv).pipe(Effect.provide(services), BunRuntime.runMain);

src/services/update-check.ts

@@ -0,0 +1,84 @@
+import { existsSync, readFileSync, mkdirSync } from "fs";
+import { writeFile } from "fs/promises";
+import { homedir } from "os";
+import { join } from "path";
+import { VERSION } from "../version";
+
+const REPO = "polarsource/cli";
+const STATE_DIR = join(homedir(), ".polar");
+const STATE_FILE = join(STATE_DIR, "update-check.json");
+const CHECK_INTERVAL_MS = 24 * 60 * 60 * 1000; // 24 hours
+
+interface UpdateCheckState {
+	lastChecked: string;
+	latestVersion: string;
+}
+
+export function showUpdateNotice(): void {
+	try {
+		if (!existsSync(STATE_FILE)) return;
+
+		const raw = readFileSync(STATE_FILE, "utf-8");
+		const state: UpdateCheckState = JSON.parse(raw);
+
+		if (!state.latestVersion || state.latestVersion === VERSION) return;
+
+		const dim = "\x1b[2m";
+		const cyan = "\x1b[36m";
+		const bold = "\x1b[1m";
+		const reset = "\x1b[0m";
+
+		process.stderr.write(
+			`\n  ${dim}Update available:${reset} ${dim}${VERSION}${reset} ${dim}→${reset} ${bold}${cyan}${state.latestVersion}${reset}\n` +
+				`  ${dim}Run${reset} ${cyan}polar update${reset} ${dim}to update${reset}\n\n`,
+		);
+	} catch {
+		// Silently ignore any errors
+	}
+}
+
+export function checkForUpdateInBackground(): void {
+	try {
+		let shouldCheck = true;
+
+		if (existsSync(STATE_FILE)) {
+			try {
+				const raw = readFileSync(STATE_FILE, "utf-8");
+				const state: UpdateCheckState = JSON.parse(raw);
+				const lastChecked = new Date(state.lastChecked).getTime();
+				if (Date.now() - lastChecked < CHECK_INTERVAL_MS) {
+					shouldCheck = false;
+				}
+			} catch {
+				// Corrupt file — re-check
+			}
+		}
+
+		if (!shouldCheck) return;
+
+		fetch(`https://api.github.com/repos/${REPO}/releases/latest`)
+			.then((res) => {
+				if (!res.ok) throw new Error(`HTTP ${res.status}`);
+				return res.json();
+			})
+			.then((data: { tag_name?: string }) => {
+				if (!data.tag_name) return;
+
+				if (!existsSync(STATE_DIR)) {
+					mkdirSync(STATE_DIR, { recursive: true });
+				}
+
+				const state: UpdateCheckState = {
+					lastChecked: new Date().toISOString(),
+					latestVersion: data.tag_name,
+				};
+
+				return writeFile(STATE_FILE, JSON.stringify(state, null, 2));
+			})
+			.catch(() => {
+				// Silently ignore all errors
+			});
+	} catch {
+		// Silently ignore any errors
+	}
+}

src/version.ts

@@ -1 +1 @@
-export const VERSION = "v1.1.1";
+export const VERSION = "v1.2.0";