add a job to build & upload the docmodel

Author: phryneas

.github/workflows/docmodel.yml

@@ -0,0 +1,30 @@
+name: Generate Documentation Model
+
+on:
+  push:
+
+jobs:
+  docmodel:
+    name: Generate Documentation Model
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout repo
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: ">=23.6.0"
+
+      - name: Install dependencies (with cache)
+        uses: bahmutov/npm-install@v1
+
+      - name: Generate documentation model
+        run: npm run docmodel
+
+      - name: Upload documentation model artifact
+        uses: actions/upload-artifact@v4
+        with:
+          name: client-api-documentation
+          path: docs/public/client.api.json
+          retention-days: 30

config/apiExtractor.ts

@@ -85,6 +85,9 @@ try {
     );
 
     await buildReport("@apollo/client", entryPointFile, "docModel");
+    if (process.exitCode === 50) {
+      process.exitCode = 0; // if there were only warnings, we still want to exit with 0
+    }
   }
 
   if (parsed.values.generate?.includes("apiReport")) {
@@ -164,6 +167,7 @@ async function buildReport(
   if (extractorResult.succeeded) {
     console.log(`✅ API Extractor completed successfully`);
   } else {
+    process.exitCode = extractorResult.errorCount === 0 ? 50 : 1;
     console.error(
       `❗ API Extractor completed with ${extractorResult.errorCount} errors` +
         ` and ${extractorResult.warningCount} warnings`
@@ -180,6 +184,5 @@ async function buildReport(
         }
       );
     }
-    process.exitCode = 1;
   }
 }