bavitutor 0.1.1 → 0.1.3

package/README.md

@@ -16,7 +16,14 @@ npx bavitutor
 ```
 
 That's all: it downloads BaviTutor, serves it on <http://localhost:4100> and
-opens your browser. Data stays on your machine in `~/.bavitutor`.
+opens your browser. Data stays on your machine in `~/.bavitutor`. If 4100 is
+taken it moves to the next free port, and if BaviTutor is already running it
+opens that one.
+
+It always runs the newest version: on start it asks npm, and if a newer one is
+out it starts that one instead, through npx or vpx like you did. (vpx inside a
+pnpm project would otherwise reuse its download for a day.) `--no-update` skips
+this.
 
 Requirements: Node 24+, [Vite+](https://viteplus.dev) (`vp`), and a logged-in
 [Claude Code](https://claude.com/claude-code) install (the Claude Agent SDK

package/dist/bavitutor.mjs

@@ -8,7 +8,7 @@ import { createServer } from "node:http";
 import { connect, createServer as createServer$1 } from "node:net";
 import * as NodeCrypto from "node:crypto";
 import * as NFS from "node:fs";
-import { existsSync, mkdirSync, readFileSync } from "node:fs";
+import { existsSync, mkdirSync, readFileSync, rmSync, writeFileSync } from "node:fs";
 import * as OS from "node:os";
 import { homedir, tmpdir } from "node:os";
 import * as Path from "node:path";
@@ -46583,7 +46583,8 @@ const codeByLiteral = {
 const fromLiteral = (literal) => codeByLiteral[literal];
 //#endregion
 //#region package.json
-var version$1 = "0.1.1";
+var name = "bavitutor";
+var version$1 = "0.1.3";
 /**
 * Default Server-Sent Events encoder.
 *
@@ -61758,6 +61759,7 @@ Options:
   --host <host>     interface to listen on (default: ${DEFAULT_HOST}, this machine only)
   --data-dir <dir>  database and settings (default: ~/.bavitutor)
   --no-open         don't open the browser
+  --no-update       don't switch to a newer version from npm
   -v, --version     print the version
   -h, --help        print this help
 
@@ -61780,6 +61782,10 @@ const parseOptions = () => {
 					type: "boolean",
 					default: true
 				},
+				update: {
+					type: "boolean",
+					default: true
+				},
 				version: {
 					type: "boolean",
 					short: "v"
@@ -61926,6 +61932,88 @@ const choosePort = async (requested, isExplicit, host) => {
 	}
 	return fail([`Ports ${requested}-${requested + SPARE_PORTS} are all in use.`, "Pick a free one: bavitutor --port <port>"]);
 };
+/** The version npm calls latest, or undefined when npm doesn't answer quickly. */
+const latestVersion = async () => {
+	if (process.env["NO_UPDATE_NOTIFIER"]) return;
+	try {
+		const response = await fetch(`https://registry.npmjs.org/${name}/latest`, { signal: AbortSignal.timeout(2e3) });
+		const body = await response.json();
+		return response.ok && body !== null && typeof body === "object" && "version" in body && typeof body.version === "string" ? body.version : void 0;
+	} catch {
+		return;
+	}
+};
+const isNewer = (candidate, current) => {
+	const parts = (version) => (version.split("-")[0] ?? "").split(".").map(Number);
+	const [next, now] = [parts(candidate), parts(current)];
+	const difference = [
+		0,
+		1,
+		2
+	].map((i) => (next[i] ?? 0) - (now[i] ?? 0)).find((delta) => delta !== 0);
+	return difference !== void 0 && difference > 0;
+};
+/**
+* How to start another version the way this one was started: npx, and vpx
+* outside a pnpm project, run `npm exec`; vpx inside one runs `pnpm dlx`,
+* which reuses what it downloaded for a day. An exact version is always
+* fetched. Undefined for a global install or a checkout's own build.
+*/
+const relaunchCommand = (version) => {
+	const runner = process.env["npm_execpath"];
+	const spec = `${name}@${version}`;
+	const args = process.argv.slice(2);
+	const runnerArgs = process.env["npm_command"] === "exec" ? [
+		"exec",
+		"--yes",
+		`--package=${spec}`,
+		"--",
+		name,
+		...args
+	] : process.env["npm_command"] === "dlx" ? [
+		"dlx",
+		spec,
+		...args
+	] : void 0;
+	if (!runner || runnerArgs === void 0) return;
+	return /\.[cm]?js$/.test(runner) ? [process.execPath, [runner, ...runnerArgs]] : [runner, runnerArgs];
+};
+/** Set for the newer version, which deletes the file once its code runs. */
+const RELAUNCH_MARKER = "BAVI_RELAUNCH_MARKER";
+/**
+* Runs the newer version in this terminal and resolves with its exit code,
+* or undefined if it never started (say npm can't serve it yet).
+*/
+const runNewer = (command, args) => new Promise((done) => {
+	const marker = join(tmpdir(), `bavitutor-relaunch-${process.pid}`);
+	writeFileSync(marker, "");
+	const waitForChild = () => {};
+	process.on("SIGINT", waitForChild);
+	const finish = (code) => {
+		process.off("SIGINT", waitForChild);
+		const hasStarted = !existsSync(marker);
+		rmSync(marker, { force: true });
+		done(hasStarted ? code : void 0);
+	};
+	const child = spawn(command, args, {
+		stdio: "inherit",
+		env: {
+			...process.env,
+			[RELAUNCH_MARKER]: marker
+		}
+	});
+	child.once("error", () => finish(void 0));
+	child.once("exit", (code) => finish(code ?? 0));
+});
+/** Where starting the newest version wasn't possible, says how to. */
+const sayIfOutdated = (latest) => {
+	if (latest !== void 0 && isNewer(latest, version$1)) {
+		say(`BaviTutor ${latest} is out (this is ${version$1}). To update,`);
+		say(`stop this one and run: npx bavitutor@${latest}`);
+		say(`                   or: vpx bavitutor@${latest}`);
+		say();
+	}
+};
 const openBrowser = (url) => {
 	const [command, args] = process.platform === "win32" ? ["cmd.exe", [
 		"/d",
@@ -61957,6 +62045,23 @@ const main = async () => {
 		say(version$1);
 		return;
 	}
+	const marker = process.env[RELAUNCH_MARKER];
+	if (marker !== void 0) {
+		rmSync(marker, { force: true });
+		delete process.env[RELAUNCH_MARKER];
+	}
+	const latest = options.update && marker === void 0 ? await latestVersion() : void 0;
+	const relaunch = latest !== void 0 && isNewer(latest, version$1) ? relaunchCommand(latest) : void 0;
+	if (latest !== void 0 && relaunch !== void 0) {
+		say(`BaviTutor ${latest} is out, starting it instead of ${version$1}`);
+		const code = await runNewer(...relaunch);
+		if (code !== void 0) {
+			process.exitCode = code;
+			return;
+		}
+		say(`  couldn't start ${latest}, so staying on ${version$1}`);
+		say();
+	}
 	const dataDir = resolve(expandHome(options["data-dir"] ?? join(homedir(), ".bavitutor")));
 	mkdirSync(dataDir, { recursive: true });
 	const envFile = join(dataDir, ".env");
@@ -61997,7 +62102,9 @@ const main = async () => {
 	if (choice.isRunning) {
 		say();
 		say(`BaviTutor is already running at ${urlFor(choice.port)}`);
+		say();
 		if (options.open) openBrowser(urlFor(choice.port));
+		sayIfOutdated(latest);
 		return;
 	}
 	const port = choice.port;
@@ -62009,6 +62116,7 @@ const main = async () => {
 		say(`BaviTutor is running at ${url}  (Ctrl+C to stop)`);
 		say();
 		if (options.open) openBrowser(url);
+		sayIfOutdated(latest);
 	})).pipe(provide(makeServer({
 		port,
 		host,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bavitutor",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "Describe what you want to learn; BaviTutor researches it, maps it and teaches it.",
   "keywords": [
     "claude",