feat: add API validation script with Zod schemas and CI workflow inte…

.github/workflows/api-validation.yml

@@ -0,0 +1,40 @@
+name: API & Schema Validation
+
+permissions:
+  contents: read
+
+on:
+  push:
+    branches:
+      - main
+  pull_request:
+    branches:
+      - main
+
+concurrency:
+  group: api-validation-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  validate:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@34e114876b0b11c390a56381ad16ebd13914f8d5
+        with:
+          persist-credentials: false
+
+      - name: Setup Node.js
+        uses: actions/setup-node@49933ea5288caeca8642d1e84afbd3f7d6820020
+        with:
+          node-version: 22
+          cache: npm
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Run API & Schema Validation
+        run: npm run validate-api
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

.github/workflows/build-matrix.yml

@@ -0,0 +1,40 @@
+name: Build Matrix CI
+
+on:
+  push:
+    branches:
+      - main
+  pull_request:
+    branches:
+      - main
+
+concurrency:
+  group: build-matrix-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  build:
+    name: Build (Node ${{ matrix.node-version }} on ${{ matrix.os }})
+    runs-on: ${{ matrix.os }}
+
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, windows-latest]
+        node-version: [20, 22]
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: ${{ matrix.node-version }}
+          cache: npm
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Build application
+        run: npm run build

Makefile

@@ -0,0 +1,14 @@
+# Makefile for OrgExplorer API & Schema Validation
+
+.PHONY: install validate-api test
+
+# Install project and development dependencies
+install:
+	npm install
+
+# Run the GraphQL and REST API schema validation script
+validate-api:
+	npm run validate-api
+
+# Alias for validation (useful in generic test runner context)
+test: validate-api

package.json

@@ -6,7 +6,8 @@
   "scripts": {
     "dev": "vite",
     "build": "vite build",
-    "preview": "vite preview"
+    "preview": "vite preview",
+    "validate-api": "node scripts/validate-api.js"
   },
   "dependencies": {
     "@tailwindcss/vite": "^4.3.0",
@@ -19,7 +20,11 @@
     "tailwindcss": "^4.3.0"
   },
   "devDependencies": {
+    "@octokit/graphql-schema": "^15.26.1",
     "@vitejs/plugin-react": "^4.3.1",
-    "vite": "^5.4.6"
+    "dotenv": "^17.4.2",
+    "graphql": "^17.0.2",
+    "vite": "^5.4.6",
+    "zod": "^4.4.3"
   }
 }