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 <noreply@anthropic.com>

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,72 @@
+#!/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();