feat: add TypeScript build infrastructure

.github/workflows/validate-scripts.yml

@@ -0,0 +1,29 @@
+name: "Validate Scripts"
+description: "Ensures TypeScript scripts compile and dist/ is committed and up to date"
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+
+permissions:
+  contents: read
+
+jobs:
+  validate:
+    name: "Build & validate dist/"
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+
+      - uses: actions/setup-node@v6
+        with:
+          node-version-file: .nvmrc
+          cache: npm
+
+      - run: npm ci
+
+      - run: npm run build
+
+      - name: "Verify dist/ is up to date"
+        run: git diff --exit-code -- dist/

.gitignore

@@ -0,0 +1 @@
+node_modules/

.nvmrc

@@ -0,0 +1 @@
+24

build.mjs

@@ -0,0 +1,16 @@
+import { execSync } from 'node:child_process';
+import { readdirSync } from 'node:fs';
+
+const entries = readdirSync('src')
+  .filter((f) => f.endsWith('.ts') && f !== 'utils.ts')
+  .map((f) => `src/${f}`);
+
+if (entries.length === 0) {
+  console.log('Nothing to bundle (no entrypoints in src/ besides utils.ts).');
+  process.exit(0);
+}
+
+execSync(
+  `npx esbuild ${entries.join(' ')} --bundle --platform=node --outdir=dist --target=node24`,
+  { stdio: 'inherit' }
+);