test: guard zod export parity

Author: kvz

docs/todo.md

@@ -66,4 +66,4 @@
 - [x] Add runtime parity fixtures by copying proven Assembly Instructions from `~/code/content` (stepParsing fixtures)
 - [x] Add a sync-v4 regression fixture to verify `.passthrough()` → `.catchall(z.unknown())` and `z.record(...)` key injection
 - [ ] Add runtime parity coverage for `assemblyStatus` (ok/error/busy) once stable samples are selected
-- [ ] Add a CI guard that `@transloadit/zod` exports list stays in sync with `packages/node/src/alphalib/types`
+- [x] Add a CI guard that `@transloadit/zod` exports list stays in sync with `packages/node/src/alphalib/types`

packages/zod/package.json

@@ -34,7 +34,7 @@
     "sync:v4": "node scripts/sync-v4.ts",
     "sync": "yarn sync:v3 && yarn sync:v4",
     "build": "yarn sync && tsc --build tsconfig.build.json",
-    "check": "yarn sync && tsc --build tsconfig.build.json && tsc --noEmit --project tsconfig.test.json && node test/runtime-parity.test.ts"
+    "check": "yarn sync && tsc --build tsconfig.build.json && tsc --noEmit --project tsconfig.test.json && node test/exports-sync.test.ts && node test/runtime-parity.test.ts"
   },
   "dependencies": {
     "zod": "^4.0.0"

packages/zod/test/exports-sync.test.ts

@@ -0,0 +1,46 @@
+import assert from 'node:assert/strict'
+import { readdir, readFile } from 'node:fs/promises'
+import { dirname, resolve } from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+const filePath = fileURLToPath(import.meta.url)
+const zodRoot = resolve(dirname(filePath), '..')
+const typesRoot = resolve(zodRoot, '../node/src/alphalib/types')
+
+const normalize = (items: string[]): string[] => [...new Set(items)].sort()
+
+const listTypeModules = async (): Promise<string[]> => {
+  const entries = await readdir(typesRoot, { withFileTypes: true })
+  const modules = entries
+    .filter((entry) => entry.isFile() && entry.name.endsWith('.ts'))
+    .map((entry) => entry.name.replace(/\.ts$/, ''))
+  modules.push('robots/_index')
+  return normalize(modules)
+}
+
+const readIndexModules = async (indexPath: string): Promise<string[]> => {
+  const contents = await readFile(indexPath, 'utf8')
+  const modules = contents
+    .split('\n')
+    .map((line) => line.match(/export \* from ['"]\.\/(.+?)\.(?:ts|js)['"]/))
+    .filter((match): match is RegExpMatchArray => Boolean(match))
+    .map((match) => match[1])
+  return normalize(modules)
+}
+
+const expected = await listTypeModules()
+const v3Index = await readIndexModules(resolve(zodRoot, 'src/v3/index.ts'))
+const v4Index = await readIndexModules(resolve(zodRoot, 'src/v4/index.ts'))
+
+assert.deepEqual(
+  v3Index,
+  expected,
+  'zod v3 index exports must match packages/node/src/alphalib/types',
+)
+assert.deepEqual(
+  v4Index,
+  expected,
+  'zod v4 index exports must match packages/node/src/alphalib/types',
+)
+
+console.log('zod exports: ok')