fix(docs): workflow to generate+publish API docs, call same on publish

Author: mikehardy

.github/workflows/deploy-api-reference.yml

@@ -0,0 +1,37 @@
+name: Deploy API Reference
+on:
+  workflow_dispatch:
+jobs:
+  deploy-api-reference:
+    name: 'Deploy API Reference'
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      pages: write
+      id-token: write
+    steps:
+      - uses: actions/checkout@v6
+        with:
+          fetch-depth: 0
+      - uses: actions/setup-node@v6
+        with:
+          node-version: lts/*
+          registry-url: 'https://registry.npmjs.org'
+      - name: Install latest NPM
+        run: |
+          npm --version
+          npm install -g npm@latest
+          npm --version
+      - name: Yarn Install
+        uses: nick-fields/retry@v3
+        with:
+          timeout_minutes: 15
+          retry_wait_seconds: 60
+          max_attempts: 3
+          command: yarn
+      - name: Build API reference (TypeDoc)
+        run: yarn reference:api:gh-pages
+      - name: Upload API reference artifact
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: ./apidocs-out

.github/workflows/publish.yml

@@ -64,3 +64,12 @@ jobs:
           # org admin Github Token required for the changelog/tag commit+push
           # to work via an exception to branch protection rules
           GITHUB_TOKEN: ${{ secrets.GH_TOKEN }}
+
+  deploy-api-reference:
+    name: 'Deploy API Reference'
+    needs: publish_npm
+    uses: ./.github/workflows/deploy-api-reference.yml
+    permissions:
+      contents: read
+      pages: write
+      id-token: write

.gitignore

@@ -539,6 +539,7 @@ packages/**/version.js
 packages/**/version.ts
 typedoc.raw.json
 reference/
+apidocs-out/
 tests/ios/Firebase
 tests/ios/resetXcode.sh
 .tmp