feat(ci): add FFmpeg npm package support with GitHub release fallback

.github/workflows/ci.yml

@@ -198,7 +198,47 @@ jobs:
         if: runner.os == 'Linux'
         run: npx tsx scripts/ci/ci-workflow.ts install-build-tools --os linux
 
-      - name: Download FFmpeg from Release
+      # Try npm packages first (faster, no GitHub API rate limits)
+      # Falls back to GitHub releases if package doesn't exist yet
+      - name: Resolve FFmpeg source
+        id: ffmpeg-source
+        run: |
+          # Determine npm package name based on platform
+          if [[ "${{ matrix.platform }}" == "linux-x64-musl" ]]; then
+            NPM_PKG="@pproenca/ffmpeg-dev-linux-x64-musl"
+          else
+            NPM_PKG="@pproenca/ffmpeg-dev-${{ matrix.platform }}"
+          fi
+
+          echo "npm_package=$NPM_PKG" >> "$GITHUB_OUTPUT"
+
+          # Check if npm package exists
+          if npm view "$NPM_PKG" version > /dev/null 2>&1; then
+            echo "source=npm" >> "$GITHUB_OUTPUT"
+            echo "✓ FFmpeg available from npm: $NPM_PKG"
+          else
+            echo "source=github-release" >> "$GITHUB_OUTPUT"
+            echo "⚠ FFmpeg npm package not found, using GitHub releases"
+          fi
+
+      - name: Install FFmpeg from npm
+        if: steps.ffmpeg-source.outputs.source == 'npm'
+        run: |
+          echo "Installing ${{ steps.ffmpeg-source.outputs.npm_package }}..."
+          npm install --no-save ${{ steps.ffmpeg-source.outputs.npm_package }}
+
+          # Set FFMPEG_ROOT for gyp/ffmpeg-paths.js
+          FFMPEG_ROOT="$(npm root)/${{ steps.ffmpeg-source.outputs.npm_package }}"
+          echo "FFMPEG_ROOT=$FFMPEG_ROOT" >> "$GITHUB_ENV"
+
+          echo "✓ FFmpeg installed from npm"
+          echo "FFMPEG_ROOT=$FFMPEG_ROOT"
+
+          # Verify installation
+          ls -lh "$FFMPEG_ROOT/lib/" | head -5
+
+      - name: Download FFmpeg from GitHub Release (fallback)
+        if: steps.ffmpeg-source.outputs.source == 'github-release'
         uses: dsaltares/fetch-gh-release-asset@aa2ab1243d6e0d5b405b973c89fa4d06a2d0fff7 # v1.1.2
         with:
           repo: ${{ github.repository }}
@@ -211,7 +251,8 @@ jobs:
           target: ffmpeg-${{ matrix.platform }}.tar.gz
           token: ${{ secrets.GITHUB_TOKEN }}
 
-      - name: Extract FFmpeg and Set Environment
+      - name: Extract FFmpeg from GitHub Release (fallback)
+        if: steps.ffmpeg-source.outputs.source == 'github-release'
         run: npx tsx scripts/ci/ci-workflow.ts extract-ffmpeg --archive "ffmpeg-${{ matrix.platform }}.tar.gz" --out ffmpeg-install
 
       - name: Build with prebuildify

CLAUDE.md

@@ -190,5 +190,5 @@ Test GitHub Actions locally:
 
 ```bash
 act -l  # List jobs
-act push -j build-linux-x64 --container-architecture linux/amd64 -W .github/workflows/build-ffmpeg.yml
+act push -j build-native --container-architecture linux/amd64 -W .github/workflows/ci.yml
 ```