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

Author: mikehardy

.github/workflows/publish.yml

@@ -64,3 +64,15 @@ 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
+    with:
+      # No inputs needed as the workflow doesn't take parameters
+      # The workflow will run with its default configuration
+    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