fix(version): generate VERSION constant from package.json at build time (#71)

Replaces the hardcoded VERSION literal in src/index.ts (which had drifted
to "0.2.0-alpha.1" while package.json declared "0.3.0-alpha.1") with a
generated src/version.ts produced by scripts/gen-version.mjs.

- Add scripts/gen-version.mjs with a --check mode that exits non-zero
  when src/version.ts is out of sync with package.json
- Wire gen-version into the build script so the file is always fresh
- Add npm run check:version and a CI "version" job that gates the
  alls-green check
- Update the version test to compare against package.json rather than
  a hardcoded string


Closes #42

Co-authored-by: Claude <noreply@anthropic.com>

Author: zeevdr

.github/workflows/ci.yml

@@ -74,6 +74,16 @@ jobs:
           files: coverage/coverage-final.json
           token: ${{ secrets.CODECOV_TOKEN }}
 
+  version:
+    name: Version sync
+    runs-on: ubuntu-latest
+    steps:
+      - *checkout
+      - *setup-node-22
+      - *install
+      - name: Check src/version.ts matches package.json
+        run: npm run check:version
+
   examples:
     name: Examples
     runs-on: ubuntu-latest
@@ -90,7 +100,7 @@ jobs:
   check:
     name: CI check
     if: always()
-    needs: [lint, typecheck, test, examples]
+    needs: [lint, typecheck, test, examples, version]
     runs-on: ubuntu-latest
     steps:
       - uses: re-actors/alls-green@release/v1

package.json

@@ -18,7 +18,9 @@
   ],
   "scripts": {
     "generate": "rm -rf src/generated && buf generate",
-    "build": "tsc",
+    "gen-version": "node scripts/gen-version.mjs",
+    "check:version": "node scripts/gen-version.mjs --check",
+    "build": "node scripts/gen-version.mjs && tsc",
     "lint": "biome check src/ test/",
     "format": "biome format --write src/ test/",
     "typecheck": "tsc --noEmit",

scripts/gen-version.mjs

@@ -0,0 +1,28 @@
+#!/usr/bin/env node
+// Generates src/version.ts from package.json.
+// With --check: exits non-zero if the file is out of sync.
+import { readFileSync, writeFileSync } from "node:fs";
+
+const pkg = JSON.parse(readFileSync("package.json", "utf8"));
+const version = pkg.version;
+
+const content =
+	`// Generated by scripts/gen-version.mjs — do not edit manually.\n` +
+	`export const VERSION = "${version}";\n`;
+
+if (process.argv.includes("--check")) {
+	const existing = readFileSync("src/version.ts", "utf8");
+	if (existing !== content) {
+		const match = existing.match(/VERSION = "([^"]+)"/);
+		console.error(
+			`src/version.ts is out of sync with package.json\n` +
+				`  package.json : ${version}\n` +
+				`  src/version.ts: ${match?.[1] ?? "(unreadable)"}`,
+		);
+		process.exit(1);
+	}
+	console.log(`src/version.ts is in sync with package.json (${version})`);
+} else {
+	writeFileSync("src/version.ts", content);
+	console.log(`Generated src/version.ts with VERSION = "${version}"`);
+}

src/index.ts

@@ -4,7 +4,7 @@
  * @packageDocumentation
  */
 
-export const VERSION = "0.2.0-alpha.1";
+export { VERSION } from "./version.js";
 export const SUPPORTED_SERVER_VERSION = ">=0.8.0,<1.0.0";
 export const PROTO_VERSION = "v1";
 

src/version.ts

@@ -0,0 +1,2 @@
+// Generated by scripts/gen-version.mjs — do not edit manually.
+export const VERSION = "0.3.0-alpha.1";

test/version.test.ts

@@ -1,9 +1,13 @@
+import { createRequire } from "node:module";
 import { describe, expect, it } from "vitest";
 import { PROTO_VERSION, SUPPORTED_SERVER_VERSION, VERSION } from "../src/index.js";
 
+const require = createRequire(import.meta.url);
+const pkg = require("../package.json") as { version: string };
+
 describe("version constants", () => {
-	it("exports SDK version", () => {
-		expect(VERSION).toBe("0.2.0-alpha.1");
+	it("exports SDK version matching package.json", () => {
+		expect(VERSION).toBe(pkg.version);
 	});
 
 	it("exports supported server version range", () => {