chore: update main branch

.github/workflows/build.yml

@@ -47,8 +47,13 @@ jobs:
             pub-${{ matrix.dart-version }}-
             pub-
 
-      - name: Install dependencies
-        run: dart pub get && cd example && dart pub get && cd -
+      - name: Install Melos
+        run: dart pub global activate melos
+        working-directory: .
+
+      - name: Bootstrap workspace
+        run: melos bootstrap
+        working-directory: .
 
       - name: Check format
         run: dart format --set-exit-if-changed .
@@ -70,10 +75,15 @@ jobs:
         working-directory: packages/dart_firebase_admin
 
     steps:
-      - uses: actions/checkout@v3.1.0
+      - uses: actions/checkout@v4
         with:
           fetch-depth: 2
 
+      - uses: actions/setup-java@v4
+        with:
+          java-version: '21'
+          distribution: 'temurin'
+
       - uses: actions/setup-node@v4
 
       - uses: subosito/flutter-action@v2.7.1
@@ -102,30 +112,82 @@ jobs:
           echo "$HOME/.pub-cache/bin" >> $GITHUB_PATH
           echo "PUB_CACHE=$HOME/.pub-cache" >> $GITHUB_ENV
 
+      - name: Install Melos
+        run: dart pub global activate melos
+        working-directory: .
+
+      - name: Bootstrap workspace
+        run: melos bootstrap
+        working-directory: .
+
       - name: Install Firebase CLI
         run: npm install -g firebase-tools
 
-      - name: Install dependencies
-        run: dart pub get && cd example && dart pub get && cd -
+      - name: Run dart_firebase_admin tests with coverage
+        run: ${{ github.workspace }}/scripts/coverage.sh
+
+      - name: Run google_cloud_firestore tests with coverage
+        run: ${{ github.workspace }}/scripts/firestore-coverage.sh
 
-      - name: Setup gcloud credentials
+      - name: Merge coverage reports
         run: |
-          mkdir -p $HOME/.config/gcloud
-          echo '${{ secrets.CREDS }}' > $HOME/.config/gcloud/application_default_credentials.json
-
-      - name: Run tests with coverage
-        run: ${{ github.workspace }}/scripts/coverage.sh
+          # Save individual package coverage files before merging
+          cp coverage.lcov coverage_admin.lcov
+          cp ../google_cloud_firestore/coverage.lcov coverage_firestore.lcov
+
+          # Merge coverage reports from all packages (relative to packages/dart_firebase_admin)
+          # Only merge files that exist
+          COVERAGE_FILES=""
+          [ -f coverage.lcov ] && COVERAGE_FILES="$COVERAGE_FILES coverage.lcov"
+          [ -f ../google_cloud_firestore/coverage.lcov ] && COVERAGE_FILES="$COVERAGE_FILES ../google_cloud_firestore/coverage.lcov"
+
+          if [ -n "$COVERAGE_FILES" ]; then
+            cat $COVERAGE_FILES > merged_coverage.lcov
+            mv merged_coverage.lcov coverage.lcov
+          else
+            echo "No coverage files found!"
+            exit 1
+          fi
 
       - name: Check coverage threshold and generate report
         if: matrix.dart-version == 'stable'
         id: coverage
         run: |
-          dart pub global activate coverage
-
-          # Generate coverage report
-          dart pub global run coverage:format_coverage --lcov --in=coverage --out=coverage.lcov --packages=.dart_tool/package_config.json --report-on=lib
-
-          # Calculate total coverage
+          # Calculate coverage for each package
+          calculate_coverage() {
+            local file=$1
+            if [ -f "$file" ]; then
+              local total=$(grep -E "^LF:" "$file" | awk -F: '{sum+=$2} END {print sum}')
+              local hit=$(grep -E "^LH:" "$file" | awk -F: '{sum+=$2} END {print sum}')
+              if [ "$total" -gt 0 ]; then
+                local pct=$(awk "BEGIN {printf \"%.2f\", ($hit/$total)*100}")
+                echo "$pct|$hit|$total"
+              else
+                echo "0.00|0|0"
+              fi
+            else
+              echo "0.00|0|0"
+            fi
+          }
+
+          # Get individual package coverage from saved copies
+          ADMIN_COV=$(calculate_coverage "coverage_admin.lcov")
+          FIRESTORE_COV=$(calculate_coverage "coverage_firestore.lcov")
+          STORAGE_COV=$(calculate_coverage "coverage_storage.lcov")
+
+          ADMIN_PCT=$(echo $ADMIN_COV | cut -d'|' -f1)
+          ADMIN_HIT=$(echo $ADMIN_COV | cut -d'|' -f2)
+          ADMIN_TOTAL=$(echo $ADMIN_COV | cut -d'|' -f3)
+
+          FIRESTORE_PCT=$(echo $FIRESTORE_COV | cut -d'|' -f1)
+          FIRESTORE_HIT=$(echo $FIRESTORE_COV | cut -d'|' -f2)
+          FIRESTORE_TOTAL=$(echo $FIRESTORE_COV | cut -d'|' -f3)
+
+          STORAGE_PCT=$(echo $STORAGE_COV | cut -d'|' -f1)
+          STORAGE_HIT=$(echo $STORAGE_COV | cut -d'|' -f2)
+          STORAGE_TOTAL=$(echo $STORAGE_COV | cut -d'|' -f3)
+
+          # Calculate total coverage from merged file
           TOTAL_LINES=$(grep -E "^(DA|LF):" coverage.lcov | grep "^LF:" | awk -F: '{sum+=$2} END {print sum}')
           HIT_LINES=$(grep -E "^(DA|LH):" coverage.lcov | grep "^LH:" | awk -F: '{sum+=$2} END {print sum}')
 
@@ -135,11 +197,21 @@ jobs:
             COVERAGE_PCT="0.00"
           fi
 
+          # Output for GitHub Actions
           echo "coverage=${COVERAGE_PCT}" >> $GITHUB_OUTPUT
           echo "total_lines=${TOTAL_LINES}" >> $GITHUB_OUTPUT
           echo "hit_lines=${HIT_LINES}" >> $GITHUB_OUTPUT
 
-          echo "Coverage: ${COVERAGE_PCT}% (${HIT_LINES}/${TOTAL_LINES} lines)"
+          echo "admin_coverage=${ADMIN_PCT}" >> $GITHUB_OUTPUT
+          echo "firestore_coverage=${FIRESTORE_PCT}" >> $GITHUB_OUTPUT
+          echo "storage_coverage=${STORAGE_PCT}" >> $GITHUB_OUTPUT
+
+          # Console output
+          echo "=== Coverage Report ==="
+          echo "dart_firebase_admin: ${ADMIN_PCT}% (${ADMIN_HIT}/${ADMIN_TOTAL} lines)"
+          echo "google_cloud_firestore: ${FIRESTORE_PCT}% (${FIRESTORE_HIT}/${FIRESTORE_TOTAL} lines)"
+          echo "----------------------"
+          echo "Total: ${COVERAGE_PCT}% (${HIT_LINES}/${TOTAL_LINES} lines)"
 
           # Check threshold
           if (( $(echo "$COVERAGE_PCT < 40" | bc -l) )); then
@@ -150,22 +222,31 @@ jobs:
           fi
 
       - name: Comment coverage on PR
-        if: matrix.dart-version == 'stable' && github.event_name == 'pull_request'
+        if: matrix.dart-version == 'stable' && github.event_name == 'pull_request' && github.event.pull_request.head.repo.fork == false
         uses: actions/github-script@v6
         with:
           script: |
             const coverage = '${{ steps.coverage.outputs.coverage }}';
             const status = '${{ steps.coverage.outputs.status }}';
             const hitLines = '${{ steps.coverage.outputs.hit_lines }}';
             const totalLines = '${{ steps.coverage.outputs.total_lines }}';
+            const adminCov = '${{ steps.coverage.outputs.admin_coverage }}';
+            const firestoreCov = '${{ steps.coverage.outputs.firestore_coverage }}';
+            const storageCov = '${{ steps.coverage.outputs.storage_coverage }}';
 
             const body = `## Coverage Report
 
             ${status}
 
-            **Coverage:** ${coverage}%
+            **Total Coverage:** ${coverage}%
             **Lines Covered:** ${hitLines}/${totalLines}
 
+            ### Package Breakdown
+            | Package | Coverage |
+            |---------|----------|
+            | dart_firebase_admin | ${adminCov}% |
+            | google_cloud_firestore | ${firestoreCov}% |
+
             _Minimum threshold: 40%_`;
 
             // Find existing comment
@@ -207,10 +288,74 @@ jobs:
           flags: unittests
           fail_ci_if_error: false
 
+  test-integration:
+    name: Test - Integration (Dart ${{ matrix.dart-version }})
+    runs-on: ubuntu-latest
+    # Skip for fork PRs — secrets are not available
+    if: github.event_name != 'pull_request' || github.event.pull_request.head.repo.fork == false
+    permissions:
+      contents: 'read'
+      id-token: 'write'
+
+    strategy:
+      fail-fast: false
+      matrix:
+        dart-version: [stable, beta]
+
+    defaults:
+      run:
+        working-directory: packages/dart_firebase_admin
+
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 2
+
+      - uses: subosito/flutter-action@v2.7.1
+        with:
+          channel: ${{ matrix.dart-version }}
+
+      - name: Authenticate to Google Cloud/Firebase
+        uses: google-github-actions/auth@v2
+        with:
+          workload_identity_provider: '${{ secrets.WORKLOAD_IDENTITY_PROVIDER }}'
+          service_account: '${{ secrets.SERVICE_ACCOUNT }}'
+
+      - name: Cache pub dependencies
+        uses: actions/cache@v3
+        with:
+          path: ~/.pub-cache
+          key: pub-${{ matrix.dart-version }}-${{ hashFiles('**/pubspec.lock') }}
+          restore-keys: |
+            pub-${{ matrix.dart-version }}-
+            pub-
+
+      - name: Add pub cache bin to PATH
+        run: |
+          echo "$HOME/.pub-cache/bin" >> $GITHUB_PATH
+          echo "PUB_CACHE=$HOME/.pub-cache" >> $GITHUB_ENV
+
+      - name: Install Melos
+        run: dart pub global activate melos
+        working-directory: .
+
+      - name: Bootstrap workspace
+        run: melos bootstrap
+        working-directory: .
+
+      - name: Run integration tests
+        run: dart test test/app/firebase_app_prod_test.dart --concurrency=1
+
   build:
     name: Build verification (Dart ${{ matrix.dart-version }})
     runs-on: ubuntu-latest
-    needs: [lint, test]
+    needs: [lint, test, test-integration]
+    # Run even if test-integration was skipped (fork PRs), but not if lint or test failed
+    if: |
+      always() &&
+      needs.lint.result == 'success' &&
+      needs.test.result == 'success' &&
+      (needs.test-integration.result == 'success' || needs.test-integration.result == 'skipped')
 
     strategy:
       fail-fast: false
@@ -237,8 +382,13 @@ jobs:
             pub-${{ matrix.dart-version }}-
             pub-
 
-      - name: Install dependencies
-        run: dart pub get && cd example && dart pub get && cd -
+      - name: Install Melos
+        run: dart pub global activate melos
+        working-directory: .
+
+      - name: Bootstrap workspace
+        run: melos bootstrap
+        working-directory: .
 
       - name: Verify package
         run: dart pub publish --dry-run

.github/workflows/docs.yml

@@ -0,0 +1,68 @@
+name: Deploy Documentation
+
+on:
+  push:
+    branches:
+      - next
+  pull_request:
+  workflow_dispatch:
+
+# Sets permissions of the GITHUB_TOKEN to allow deployment to GitHub Pages
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+# Allow only one concurrent deployment
+concurrency:
+  group: "pages"
+  cancel-in-progress: false
+
+jobs:
+  build:
+    name: Build Documentation
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v3
+
+      - uses: subosito/flutter-action@v2
+        with:
+          channel: stable
+
+      - name: Cache pub dependencies
+        uses: actions/cache@v3
+        with:
+          path: ~/.pub-cache
+          key: pub-docs-${{ hashFiles('**/pubspec.lock') }}
+          restore-keys: |
+            pub-docs-
+            pub-
+
+      - name: Install Melos
+        run: dart pub global activate melos
+
+      - name: Bootstrap workspace
+        run: melos bootstrap
+
+      - name: Generate documentation
+        run: melos run docs --no-select
+
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: doc
+
+  deploy:
+    name: Deploy to GitHub Pages
+    if: github.event_name == 'push' || github.event_name == 'workflow_dispatch'
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    runs-on: ubuntu-latest
+    needs: build
+
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4

.gitignore

@@ -1,12 +1,14 @@
 firebase-debug.log
 ui-debug.log
 firestore-debug.log
+coverage.lcov
 
 node_modules
 packages/dart_firebase_admin/test/client/package-lock.json
 
 build
 coverage
+doc/api
 
 .DS_Store
 .atom/
@@ -32,4 +34,4 @@ pubspec.lock
 
 service-account.json
 
-**/pubspec_overrides.yaml
+**/pubspec_overrides.yaml

all_lint_rules.yaml

@@ -219,5 +219,4 @@ linter:
     - use_string_in_part_of_directives
     - use_super_parameters
     - use_test_throws_matchers
-    - use_to_and_as_if_applicable
     - void_checks

analysis_options.yaml

@@ -1,5 +1,7 @@
 include: all_lint_rules.yaml
 analyzer:
+  exclude:
+    - packages/dart_firebase_admin/example_server_app/**
   language:
     strict-casts: true
     strict-inference: true