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,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';
+
+constGENERATED_FILES=['src/generated/sdk.types.ts','src/generated/sdk.schemas.ts'];
+
+functionmain(): void{
+constrootDir=join(import.meta.dirname,'..');
+
+// Capture current content of generated files
+constoriginalContents=newMap<string,string>();
+for(constfileofGENERATED_FILES){
+constfilePath=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((errorasError).message);
+process.exit(1);
+}
+
+// Compare with original content
+lethasDrift=false;
+for(constfileofGENERATED_FILES){
+constfilePath=join(rootDir,file);
+constnewContent=readFileSync(filePath,'utf-8');
+constoriginalContent=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();