ci: add schema sync check to build and CI

- Generate schemas during `npm run build`
- Add `npm run check:schemas` script to verify generated files are in sync
- Run schema sync check in CI after build to catch uncommitted changes

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <[email protected]>

Author: ochafik

.github/workflows/main.yml

@@ -25,6 +25,7 @@ jobs:
             - run: npm ci
             - run: npm run check
             - run: npm run build
+            - run: npm run check:schemas
 
     test:
         runs-on: ubuntu-latest

package.json

@@ -70,7 +70,7 @@
         "fetch:spec-types": "tsx scripts/fetch-spec-types.ts",
         "generate:schemas": "tsx scripts/generate-schemas.ts && prettier --write \"src/generated/**/*\"",
         "typecheck": "tsgo --noEmit",
-        "build": "npm run build:esm && npm run build:cjs",
+        "build": "npm run generate:schemas && npm run build:esm && npm run build:cjs",
         "build:esm": "mkdir -p dist/esm && echo '{\"type\": \"module\"}' > dist/esm/package.json && tsc -p tsconfig.prod.json",
         "build:esm:w": "npm run build:esm -- -w",
         "build:cjs": "mkdir -p dist/cjs && echo '{\"type\": \"commonjs\"}' > dist/cjs/package.json && tsc -p tsconfig.cjs.json",
@@ -79,7 +79,8 @@
         "prepack": "npm run build:esm && npm run build:cjs",
         "lint": "eslint src/ && prettier --check .",
         "lint:fix": "eslint src/ --fix && prettier --write .",
-        "check": "npm run typecheck && npm run lint",
+        "check": "npm run typecheck && npm run lint && npm run check:schemas",
+        "check:schemas": "tsx scripts/check-schemas-sync.ts",
         "test": "vitest run",
         "test:watch": "vitest",
         "start": "npm run server",

scripts/check-schemas-sync.ts

@@ -0,0 +1,75 @@
+#!/usr/bin/env npx tsx
+/**
+ * Checks if generated schemas are in sync with source types.
+ * Exits with code 1 if regeneration would produce different output.
+ *
+ * Usage:
+ *   npx tsx scripts/check-schemas-sync.ts
+ *   npm run check:schemas
+ */
+
+import { execSync } from "child_process";
+import { readFileSync } from "fs";
+import { join } from "path";
+
+const GENERATED_FILES = [
+  "src/generated/sdk.types.ts",
+  "src/generated/sdk.schemas.ts",
+];
+
+function main(): void {
+  const rootDir = join(import.meta.dirname, "..");
+
+  // Capture current content of generated files
+  const originalContents = new Map<string, string>();
+  for (const file of GENERATED_FILES) {
+    const filePath = join(rootDir, file);
+    try {
+      originalContents.set(file, readFileSync(filePath, "utf-8"));
+    } catch {
+      console.error(`Error: Generated file ${file} does not exist.`);
+      console.error("Run 'npm run generate:schemas' to generate it.");
+      process.exit(1);
+    }
+  }
+
+  // Regenerate schemas
+  console.log("Regenerating schemas to check for drift...");
+  try {
+    execSync("npm run generate:schemas", {
+      cwd: rootDir,
+      stdio: "pipe",
+    });
+  } catch (error) {
+    console.error("Error: Schema generation failed.");
+    console.error((error as Error).message);
+    process.exit(1);
+  }
+
+  // Compare with original content
+  let hasDrift = false;
+  for (const file of GENERATED_FILES) {
+    const filePath = join(rootDir, file);
+    const newContent = readFileSync(filePath, "utf-8");
+    const originalContent = originalContents.get(file)!;
+
+    if (newContent !== originalContent) {
+      console.error(`\n❌ ${file} is out of sync with source types.`);
+      hasDrift = true;
+    } else {
+      console.log(`✓ ${file} is up to date.`);
+    }
+  }
+
+  if (hasDrift) {
+    console.error("\n" + "=".repeat(60));
+    console.error("Generated schemas are out of sync!");
+    console.error("Run 'npm run generate:schemas' and commit the changes.");
+    console.error("=".repeat(60));
+    process.exit(1);
+  }
+
+  console.log("\n✓ All generated schemas are in sync.");
+}
+
+main();