[Docs Site] Add workflow to update api-schemas pinned commit (#21416)

* [Docs Site] Add workflow to update api-schemas pinned commit

* wording

Author: KianNH

.github/workflows/update-api-schemas.yml

@@ -0,0 +1,58 @@
+name: Update api-schemas pinned commit
+
+on:
+  schedule:
+    - cron: "0 0 * * *"
+  workflow_dispatch:
+
+jobs:
+  check-and-update:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+      pull-requests: write
+
+    steps:
+      - name: Checkout docs repository
+        uses: actions/checkout@v4
+
+      - name: Get latest api-schemas commit
+        id: get-commit
+        run: |
+          LATEST_COMMIT=$(curl -s -H "Accept: application/vnd.github.v3+json" \
+            https://api.github.com/repos/cloudflare/api-schemas/commits/main | \
+            jq -r '.sha')
+          echo "latest_commit=$LATEST_COMMIT" >> $GITHUB_OUTPUT
+
+      - name: Check current commit reference
+        id: check-current
+        run: |
+          CURRENT_COMMIT=$(grep 'const COMMIT = ' src/util/api.ts | sed 's/.*"\(.*\)".*/\1/')
+          echo "current_commit=$CURRENT_COMMIT" >> $GITHUB_OUTPUT
+
+      - name: Create PR if needed
+        if: steps.get-commit.outputs.latest_commit != steps.check-current.outputs.current_commit
+        run: |
+          # Create a new branch
+          git config --global user.name 'github-actions[bot]'
+          git config --global user.email 'github-actions[bot]@users.noreply.github.com'
+          BRANCH_NAME="update-api-schemas-$(date +%Y%m%d-%H%M%S)"
+          git checkout -b $BRANCH_NAME
+
+          # Update the commit reference
+          NEW_COMMIT="${{ steps.get-commit.outputs.latest_commit }}"
+          sed -i "s/const COMMIT = \".*\"/const COMMIT = \"$NEW_COMMIT\"/" src/util/api.ts
+
+          # Commit and push changes
+          git add src/util/api.ts
+          git commit -m "[Docs Site] Update pinned api-schemas commit to $NEW_COMMIT"
+          git push origin $BRANCH_NAME
+
+          # Create pull request
+          gh pr create \
+            --title "[Docs Site] Update pinned api-schemas commit" \
+            --body "This PR updates the api-schemas commit reference to the latest version ($NEW_COMMIT)." \
+            --base main \
+            --head $BRANCH_NAME
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

src/util/api.ts

@@ -1,12 +1,14 @@
 import SwaggerParser from "@apidevtools/swagger-parser";
 import type { OpenAPI } from "openapi-types";
 
+const COMMIT = "f6c9d752f31f2e9dea3a9659fefab1b97b6042e9";
+
 let schema: OpenAPI.Document | undefined;
 
 export const getSchema = async () => {
 	if (!schema) {
 		const response = await fetch(
-			"https://gh-code.developers.cloudflare.com/cloudflare/api-schemas/f6c9d752f31f2e9dea3a9659fefab1b97b6042e9/openapi.json",
+			`https://gh-code.developers.cloudflare.com/cloudflare/api-schemas/${COMMIT}/openapi.json`,
 		);
 		const obj = await response.json();