feat(simulator): expose topic commands

## Summary
- capture local Expo CLI iOS entitlements introspection failures in Sentry before falling back to bundled config resolution
- tag the event with `app_id` from `EAS_BUILD_PROJECT_ID` and the config resolution path
- capture a short fallback message so this is easier to distinguish from generic spawn failures
- include the failed command stdout, stderr, and exit status as Sentry extras

## Why
If `expo config --json --type introspect` fails but the bundled config fallback succeeds, users no longer hit a hard failure. Capturing the original command failure gives us visibility into the remaining fallback cases without breaking builds, and the explicit message makes these events easier to identify.

## Validation

CI should pass.

.codex/environments/environment.toml

@@ -0,0 +1,11 @@
+# THIS IS AUTOGENERATED. DO NOT EDIT MANUALLY
+version = 1
+name = "eas-cli"
+
+[setup]
+script = '''
+mise trust
+mise install
+yarn
+yarn typecheck
+'''

.eslintignore

@@ -1,8 +1,14 @@
 **/build/**
+**/dist/**
+**/coverage/**
+**/fixtures/**
 !packages/eas-cli/src/commands/build/**
 !packages/eas-cli/src/build/**
 
 packages/eas-cli/src/graphql/generated.ts
+packages/eas-cli/schema/**
+packages/eas-cli/graphql.schema.json
+packages/build-tools/schema.graphql
 
 node_modules
-ts-declarations
+ts-declarations

.eslintrc.js

@@ -1,44 +0,0 @@
-module.exports = {
-  root: true,
-  extends: ['universe/node'],
-  plugins: ['async-protect', 'node'],
-  rules: {
-    'no-console': 'warn',
-    'no-constant-condition': ['warn', { checkLoops: false }],
-    'sort-imports': [
-      'warn',
-      {
-        ignoreDeclarationSort: true,
-      },
-    ],
-    curly: 'warn',
-    'import/no-cycle': 'error',
-    'import/no-extraneous-dependencies': [
-      'error',
-      { devDependencies: ['**/__tests__/**/*', '**/__mocks__/**/*'] },
-    ],
-    'import/no-relative-packages': 'error',
-    'no-restricted-imports': [
-      'error',
-      {
-        paths: [
-          {
-            name: 'lodash',
-            message: "Don't use lodash, it's heavy!",
-          },
-        ],
-      },
-    ],
-    'no-underscore-dangle': ['error', { allow: ['__typename'] }],
-    'async-protect/async-suffix': 'error',
-    'node/no-sync': 'error',
-  },
-  overrides: [
-    {
-      files: ['**/__tests__/**/*.ts', '**/__mocks__/**/*.ts'],
-      rules: {
-        'async-protect/async-suffix': 'off',
-      },
-    },
-  ],
-};

.github/actions/setup-mise/action.yml

@@ -0,0 +1,11 @@
+name: setup-mise
+description: Install tools via mise
+
+runs:
+  using: "composite"
+  steps:
+    - uses: jdx/mise-action@146a28175021df8ca24f8ee1828cc2a60f980bd5 # v3.5.1
+      with:
+        install: true
+        cache: true
+        experimental: true

.github/codemention.yml

@@ -3,7 +3,7 @@ commentConfiguration:
   epilogue: 'Generated by [CodeMention](https://github.com/expo/expo/actions/workflows/codemention.yaml)'
 rules:
   - patterns: ['**/*']
-    mentions: ['sjchmiela']
+    mentions: ['douglowder']
   - patterns: ['packages/eas-cli/src/update/**']
     mentions: ['wschurman', 'quinlanj']
   - patterns: ['packages/eas-cli/src/commands/update/**']
@@ -22,3 +22,9 @@ rules:
     mentions: ['kitten', 'kadikraman']
   - patterns: ['packages/eas-cli/src/commands/deploy/**']
     mentions: ['kitten', 'kadikraman']
+  - patterns: ['packages/eas-cli/src/commands/build/**']
+    mentions: ['sjchmiela']
+  - patterns: ['packages/eas-cli/src/build/**']
+    mentions: ['sjchmiela']
+  - patterns: ['packages/eas-cli/src/commands/workflow/**']
+    mentions: ['sjchmiela']

.github/dependabot.yml

@@ -0,0 +1,16 @@
+version: 2
+updates:
+  # Keep SHA-pinned GitHub Actions fresh. Without this, pins never receive
+  # upstream security patches because tag movements no longer reach us.
+  - package-ecosystem: github-actions
+    directories:
+      - /
+      - /.github/actions/setup-mise
+      - /.github/internal-actions/setup-gcloud
+      - /.github/internal-actions/notify-slack-on-fail-or-recover
+    schedule:
+      interval: weekly
+    groups:
+      actions:
+        patterns:
+          - '*'

.github/fixtures/eas-workflow-build-android.yml

@@ -0,0 +1,19 @@
+name: build-android
+on:
+  workflow_dispatch: {}
+
+jobs:
+  build:
+    name: Build Android
+    type: build
+    runs_on: linux-large
+    params:
+      platform: android
+      profile: system-test
+  custom_job:
+    name: Custom Job
+    runs_on: linux-medium-nested-virtualization
+    steps:
+      - name: Echo
+        run: echo "This is a custom job step"
+      - uses: eas/start_android_emulator

.github/internal-actions/notify-slack-on-fail-or-recover/action.yml

@@ -12,7 +12,7 @@ runs:
   using: 'composite'
   steps:
     - name: Get previous workflow run status
-      uses: actions/github-script@v6
+      uses: actions/github-script@d7906e4ad0b1822421a7e6a35d5ca353c962f410 # v6
       id: run-status
       with:
         script: |
@@ -28,7 +28,7 @@ runs:
 
     - name: Send Slack Success Notification
       if: fromJSON(steps.run-status.outputs.result).previous == 'failure' && fromJSON(steps.run-status.outputs.result).current == 'success'
-      uses: rtCamp/action-slack-notify@v2
+      uses: rtCamp/action-slack-notify@e31e87e03dd19038e411e38ae27cbad084a90661 # v2
       env:
         SLACK_CHANNEL: ${{ inputs.channel }}
         SLACK_COLOR: good
@@ -41,7 +41,7 @@ runs:
 
     - name: Send Slack Failure Notification
       if: fromJSON(steps.run-status.outputs.result).current == 'failure'
-      uses: rtCamp/action-slack-notify@v2
+      uses: rtCamp/action-slack-notify@e31e87e03dd19038e411e38ae27cbad084a90661 # v2
       env:
         SLACK_CHANNEL: ${{ inputs.channel }}
         SLACK_COLOR: danger

.github/internal-actions/setup-gcloud/action.yml

@@ -0,0 +1,16 @@
+name: setup-gcloud
+
+runs:
+  using: "composite"
+  steps:
+    - name: Auth gcloud
+      uses: google-github-actions/auth@c200f3691d83b41bf9bbd8638997a462592937ed # v2
+      with:
+        workload_identity_provider: 'projects/321830142373/locations/global/workloadIdentityPools/github/providers/expo'
+        project_id: exponentjs
+
+    - name: Setup gcloud
+      uses: google-github-actions/setup-gcloud@e427ad8a34f8676edf47cf7d7925499adf3eb74f # v2
+      with:
+        version: 548.0.0
+        project_id: exponentjs

.github/workflows/build-and-deploy-worker.yml

@@ -0,0 +1,205 @@
+name: build-and-deploy-worker
+# Assumes main branch always specifies an environment (staging/production).
+# If environment is empty: PR testing build (no upload, no deploy)
+# If environment is set: Build (unless cached on main), upload, and deploy
+
+on:
+  workflow_dispatch:
+    inputs:
+      environment:
+        description: '"staging", "production" or empty'
+        type: string
+        required: true
+  workflow_call:
+    inputs:
+      environment:
+        description: '"staging", "production" or empty'
+        type: string
+        required: true
+
+jobs:
+  build-and-deploy:
+    runs-on: ubuntu-latest
+    permissions:
+      id-token: write
+    steps:
+      - uses: actions/checkout@08eba0b27e820071cde6df949e0beb9ba4906955 # v4
+
+      - uses: ./.github/actions/setup-mise
+
+      - uses: ./.github/internal-actions/setup-gcloud
+
+      - name: Check if worker already exists
+        id: check_worker_exists
+        # Check if tarballs for this SHA already exist
+        # If they do, we can skip building regardless of branch
+        if: inputs.environment != ''
+        run: |
+          for platform in android ios; do
+            GCP_TARBALL="worker-$platform-sha1-$GITHUB_SHA.tar.gz"
+
+            if ! gsutil stat gs://eas-build-worker-tarballs/$GCP_TARBALL; then
+              echo "worker_exists=false" >> "$GITHUB_OUTPUT"
+              exit 0
+            fi
+          done
+
+          echo "worker_exists=true" >> "$GITHUB_OUTPUT"
+
+      - name: Start EAS Workflow to build worker tarballs
+        id: eas_workflow
+        # Build if: PR testing (no env), or deploying but tarballs don't exist
+        if: inputs.environment == '' || steps.check_worker_exists.outputs.worker_exists == 'false'
+        working-directory: packages/worker
+        env:
+          EXPO_TOKEN: ${{ secrets.EXPO_DEV_EXPO_GITHUB_ROBOT_ACCESS_TOKEN }}
+        run: |
+          set -euo pipefail
+
+          # Only upload artifacts from EAS if GHA will upload them to GCS
+          # This avoids unnecessary artifact uploads for PR builds
+          SHOULD_UPLOAD_ARTIFACT="${{ inputs.environment != '' && steps.check_worker_exists.outputs.worker_exists == 'false' }}"
+
+          # Run workflow and capture output (includes run ID)
+          WORKFLOW_OUTPUT=$(npx -y eas-cli@latest workflow:run build-worker.yml \
+            --ref ${{ github.sha }} \
+            --input upload_artifact=$SHOULD_UPLOAD_ARTIFACT \
+            --non-interactive \
+            --no-wait \
+            --json)
+
+          WORKFLOW_RUN_ID=$(echo "$WORKFLOW_OUTPUT" | jq -r '.id')
+          if [ -z "$WORKFLOW_RUN_ID" ] || [ "$WORKFLOW_RUN_ID" = "null" ]; then
+            echo "Error: Could not determine workflow run ID"
+            echo "Workflow output:"
+            echo "$WORKFLOW_OUTPUT" | jq .
+            exit 1
+          fi
+
+          echo "workflow_run_id=$WORKFLOW_RUN_ID" >> "$GITHUB_OUTPUT"
+
+      - name: Wait for EAS workflow and capture artifacts
+        id: eas_artifacts
+        if: inputs.environment == '' || steps.check_worker_exists.outputs.worker_exists == 'false'
+        working-directory: packages/worker
+        env:
+          EXPO_TOKEN: ${{ secrets.EXPO_DEV_EXPO_GITHUB_ROBOT_ACCESS_TOKEN }}
+        run: |
+          set -euo pipefail
+
+          WORKFLOW_RUN_ID="${{ steps.eas_workflow.outputs.workflow_run_id }}"
+          if [ -z "$WORKFLOW_RUN_ID" ]; then
+            echo "Error: Missing workflow run ID"
+            exit 1
+          fi
+
+          SHOULD_UPLOAD_ARTIFACT="${{ inputs.environment != '' && steps.check_worker_exists.outputs.worker_exists == 'false' }}"
+
+          while true; do
+            VIEW_OUTPUT=$(npx -y eas-cli@latest workflow:view "$WORKFLOW_RUN_ID" \
+              --non-interactive \
+              --json)
+            STATUS=$(echo "$VIEW_OUTPUT" | jq -r '.status')
+
+            case "$STATUS" in
+              SUCCESS)
+                break
+                ;;
+              FAILURE)
+                echo "EAS workflow failed."
+                echo "$VIEW_OUTPUT" | jq .
+                exit 1
+                ;;
+              CANCELED)
+                echo "EAS workflow canceled."
+                echo "$VIEW_OUTPUT" | jq .
+                exit 1
+                ;;
+              ACTION_REQUIRED)
+                echo "EAS workflow requires action."
+                echo "$VIEW_OUTPUT" | jq .
+                exit 1
+                ;;
+              NEW|IN_PROGRESS)
+                sleep 7
+                ;;
+              *)
+                echo "Unexpected workflow status: $STATUS"
+                echo "$VIEW_OUTPUT" | jq .
+                exit 1
+                ;;
+            esac
+          done
+
+          # Skip artifact extraction if we didn't request uploads
+          if [ "$SHOULD_UPLOAD_ARTIFACT" == "false" ]; then
+            echo "Skipping artifact download - upload was disabled for this run"
+            exit 0
+          fi
+
+          # Extract artifact download URLs from workflow output
+          # Artifacts are in jobs[].artifacts[] for custom jobs
+          DOWNLOAD_IOS_URL=$(echo "$VIEW_OUTPUT" | jq -r '
+            .jobs[]
+            | .artifacts[]?
+            | select(.name == "worker-ios-tarball")
+            | .downloadUrl
+          ' | head -1)
+
+          DOWNLOAD_ANDROID_URL=$(echo "$VIEW_OUTPUT" | jq -r '
+            .jobs[]
+            | .artifacts[]?
+            | select(.name == "worker-android-tarball")
+            | .downloadUrl
+          ' | head -1)
+
+          if [ -z "$DOWNLOAD_IOS_URL" ] || [ "$DOWNLOAD_IOS_URL" = "null" ]; then
+            echo "Error: Could not find iOS artifact download URL"
+            echo "$VIEW_OUTPUT" | jq .
+            exit 1
+          fi
+
+          if [ -z "$DOWNLOAD_ANDROID_URL" ] || [ "$DOWNLOAD_ANDROID_URL" = "null" ]; then
+            echo "Error: Could not find Android artifact download URL"
+            echo "$VIEW_OUTPUT" | jq .
+            exit 1
+          fi
+
+          # Mask the download URLs
+          echo "::add-mask::$DOWNLOAD_IOS_URL"
+          echo "::add-mask::$DOWNLOAD_ANDROID_URL"
+          echo "download_ios_url=$DOWNLOAD_IOS_URL" >> "$GITHUB_OUTPUT"
+          echo "download_android_url=$DOWNLOAD_ANDROID_URL" >> "$GITHUB_OUTPUT"
+
+      - name: Cancel EAS workflow on GitHub cancellation
+        if: cancelled()
+        working-directory: packages/worker
+        env:
+          EXPO_TOKEN: ${{ secrets.EXPO_DEV_EXPO_GITHUB_ROBOT_ACCESS_TOKEN }}
+        run: |
+          set -euo pipefail
+
+          WORKFLOW_RUN_ID="${{ steps.eas_workflow.outputs.workflow_run_id }}"
+          if [ -n "$WORKFLOW_RUN_ID" ]; then
+            npx -y eas-cli@latest workflow:cancel "$WORKFLOW_RUN_ID" --non-interactive
+          fi
+
+      - name: Upload worker tarballs to GCP
+        # Upload when deploying if we built something new
+        # Don't upload PR builds (no environment) or when using cached tarballs
+        if: inputs.environment != '' && steps.check_worker_exists.outputs.worker_exists == 'false'
+        run: |
+          IOS_GCP_TARBALL="worker-ios-sha1-$GITHUB_SHA.tar.gz"
+          ANDROID_GCP_TARBALL="worker-android-sha1-$GITHUB_SHA.tar.gz"
+          curl -L "${{ steps.eas_artifacts.outputs.download_ios_url }}" | gsutil cp - gs://eas-build-worker-tarballs/$IOS_GCP_TARBALL
+          curl -L "${{ steps.eas_artifacts.outputs.download_android_url }}" | gsutil cp - gs://eas-build-worker-tarballs/$ANDROID_GCP_TARBALL
+
+      - name: Promote worker to ${{ inputs.environment }}
+        if: inputs.environment != ''
+        run: |
+          for platform in android ios; do
+            GCP_TARBALL="worker-$platform-sha1-$GITHUB_SHA.tar.gz"
+            WORKER_STAGING_TARBALL="worker-$platform-${{ inputs.environment }}.tar.gz"
+
+            gsutil cp gs://eas-build-worker-tarballs/$GCP_TARBALL gs://eas-build-worker-tarballs/$WORKER_STAGING_TARBALL
+          done

.github/workflows/changelog.yml

@@ -1,6 +1,7 @@
 name: CHANGELOG.md PR check
 
 on:
+  workflow_dispatch:
   pull_request:
     types:
       - opened
@@ -17,7 +18,7 @@ jobs:
     name: Check CHANGELOG.md updated
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v2
+      - uses: actions/checkout@ee0669bd1cc54295c223e0bb666b733df41de1c5 # v2
       - name: Check if CHANGELOG.md was updated
         id: changelog-updated
         uses: tj-actions/changed-files@b1ba699b304f2083b602164e06a89b868c84f076
@@ -25,11 +26,11 @@ jobs:
           files: CHANGELOG.md
       - name: Fail if CHANGELOG.md was not updated and the "no changelog" label is absent
         if: steps.changelog-updated.outputs.any_changed == 'false' && !contains(github.event.pull_request.labels.*.name, 'no changelog')
-        uses: actions/github-script@v6
+        uses: actions/github-script@d7906e4ad0b1822421a7e6a35d5ca353c962f410 # v6
         with:
           script: |
             core.setFailed('Please add a changelog entry!')
-      - uses: mshick/add-pr-comment@v2.1.0
+      - uses: mshick/add-pr-comment@b8f338c590a895d50bcbfa6c5859251edc8952fc # v2.8.2
         if: always()
         with:
           message-id: changelog-entry-check

.github/workflows/codemention.yml

@@ -1,5 +1,8 @@
 name: codemention
 on:
+  # pull_request_target is required so fork PRs get a write token to post the
+  # mention comment. Safe because there is no checkout — the action only reads
+  # PR metadata via the GitHub API; no fork code is fetched or executed.
   pull_request_target:
     types: [opened, synchronize, ready_for_review]
 jobs:
@@ -9,6 +12,9 @@ jobs:
       contents: read
       pull-requests: write
     steps:
-      - uses: tobyhs/[email protected]
+      # Pinned to a commit SHA (not the v1.4.0 tag) because this runs under
+      # pull_request_target with a write-scoped token — a re-pointed tag from
+      # a compromised upstream account would give the attacker repo write access.
+      - uses: tobyhs/codemention@bb6bfb2c3ff1e6fee7ee37006bbee6d114057225 # v1.4.0
         with:
           githubToken: ${{ secrets.GITHUB_TOKEN }}

.github/workflows/issue-triage.yml

@@ -8,7 +8,7 @@ jobs:
     runs-on: ubuntu-20.04
     if: "${{ contains(github.event.label.name, 'incomplete issue: missing or invalid repro') }}"
     steps:
-      - uses: actions/github-script@v3
+      - uses: actions/github-script@ffc2c79a5b2490bd33e0a41c1de74b877714d736 # v3
         with:
           github-token: ${{ secrets.EXPO_BOT_GITHUB_TOKEN }}
           script: |
@@ -52,7 +52,7 @@ jobs:
     runs-on: ubuntu-20.04
     if: "${{ contains(github.event.label.name, 'incomplete issue: missing info') }}"
     steps:
-      - uses: actions/github-script@v3
+      - uses: actions/github-script@ffc2c79a5b2490bd33e0a41c1de74b877714d736 # v3
         with:
           github-token: ${{ secrets.EXPO_BOT_GITHUB_TOKEN }}
           script: |
@@ -81,7 +81,7 @@ jobs:
     runs-on: ubuntu-20.04
     if: github.event.label.name == 'issue accepted'
     steps:
-      - uses: actions/github-script@v3
+      - uses: actions/github-script@ffc2c79a5b2490bd33e0a41c1de74b877714d736 # v3
         with:
           github-token: ${{ secrets.EXPO_BOT_GITHUB_TOKEN }}
           script: |
@@ -98,7 +98,7 @@ jobs:
     runs-on: ubuntu-20.04
     if: "${{ contains(github.event.label.name, 'invalid issue: question') }}"
     steps:
-      - uses: actions/github-script@v3
+      - uses: actions/github-script@ffc2c79a5b2490bd33e0a41c1de74b877714d736 # v3
         with:
           github-token: ${{ secrets.EXPO_BOT_GITHUB_TOKEN }}
           script: |
@@ -126,7 +126,7 @@ jobs:
     runs-on: ubuntu-20.04
     if: "${{ contains(github.event.label.name, 'invalid issue: feature request') }}"
     steps:
-      - uses: actions/github-script@v3
+      - uses: actions/github-script@ffc2c79a5b2490bd33e0a41c1de74b877714d736 # v3
         with:
           github-token: ${{ secrets.EXPO_BOT_GITHUB_TOKEN }}
           script: |

.github/workflows/move-eas-build-tag.yml

@@ -0,0 +1,64 @@
+on:
+  workflow_dispatch:
+    inputs:
+      staging_only:
+        type: boolean
+        required: true
+        default: false
+        description: "Only move the latest-eas-build-staging tag, not the latest-eas-build tag"
+      version:
+        type: string
+        required: true
+        description: "Version number to move the tag to"
+      dry_run:
+        type: boolean
+        required: true
+        default: true
+        description: "Run the workflow in dry run mode, without making any NPM changes"
+
+name: Move NPM tags used by EAS builds and workflows
+
+jobs:
+  move-tag:
+    name: Move NPM tags used by EAS builds and workflows
+    runs-on: ubuntu-latest
+    env:
+      GITHUB_TOKEN: ${{ secrets.EXPO_BOT_PAT }}
+      NPM_ACCESS_TOKEN: ${{ secrets.NPM_ACCESS_TOKEN }}
+      INPUT_VERSION: ${{ github.event.inputs.version }}
+      INPUT_DRY_RUN: ${{ github.event.inputs.dry_run }}
+      INPUT_STAGING_ONLY: ${{ github.event.inputs.staging_only }}
+    steps:
+      - uses: actions/setup-node@7c12f8017d5436eb855f1ed4399f037a36fbd9e8 # v2
+        with:
+          registry-url: "https://registry.npmjs.org/"
+          scope: "expo"
+          node-version: 22
+      - name: Resolve version (fails if the version does not exist)
+        run: |
+          set -o pipefail
+          npm pack --dry-run eas-cli@$INPUT_VERSION
+      - name: Add latest-eas-build-staging tag
+        run: |
+          cmd="npm dist-tag add eas-cli@$INPUT_VERSION latest-eas-build-staging"
+          if [[ "$INPUT_DRY_RUN" == "true" ]]; then
+            echo "Running in dry run mode, skipping version check"
+            echo "cmd = $cmd"
+            exit 0
+          fi
+          echo //registry.npmjs.org/:_authToken=$NPM_ACCESS_TOKEN > ~/.npmrc
+          $cmd
+      - name: Add latest-eas-build tag
+        run: |
+          cmd="npm dist-tag add eas-cli@$INPUT_VERSION latest-eas-build"
+          if [[ "$INPUT_DRY_RUN" == "true" ]]; then
+            echo "Running in dry run mode, skipping version check"
+            echo "cmd = $cmd"
+            exit 0
+          fi
+          if [[ "$INPUT_STAGING_ONLY" == "true" ]]; then
+            echo "Only moving the staging tag, skipping the production tag"
+            exit 0
+          fi
+          echo //registry.npmjs.org/:_authToken=$NPM_ACCESS_TOKEN > ~/.npmrc
+          $cmd

.github/workflows/release.yml

@@ -1,7 +1,7 @@
 on:
   push:
     tags:
-      - 'v*' # Push events to matching v*, i.e. v1.0, v20.15.10
+      - "v*" # Push events to matching v*, i.e. v1.0, v20.15.10
 
 name: Release workflow
 
@@ -9,197 +9,67 @@ jobs:
   release:
     name: Create a release
     runs-on: ubuntu-latest
+    permissions:
+      contents: write
     outputs:
       upload_url: ${{ steps.create_release.outputs.upload_url }}
     steps:
       - id: create_release
-        uses: actions/create-release@v1
+        uses: actions/create-release@0cb9c9b65d5d1901c1f53e5e66eaf4afd303e70e # v1
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
         with:
           tag_name: ${{ github.ref }}
-          release_name: 'eas-cli@${{ env.EAS_CLI_VERSION }}'
+          release_name: ${{ github.ref }}
           draft: true
-  build-linux:
-    name: Build for Linux
-    runs-on: ubuntu-latest
-    needs: release
-    steps:
-      - uses: actions/checkout@v2
-      - uses: actions/setup-node@v2
-        with:
-          node-version: 20
-      - run: yarn install --frozen-lockfile --check-files
-      - run: yarn build
-      - name: Ensure GraphQL schema and generated code is up-to-date
-        working-directory: ${{ github.workspace }}/packages/eas-cli
-        run: |
-          yarn verify-graphql-code
-      - name: Build tarballs
-        working-directory: ${{ github.workspace }}/packages/eas-cli
-        run: |
-          yarn pretarball-ci
-          yarn oclif pack:tarballs --no-xz --targets linux-x64,linux-arm
-      - id: x64
-        run: echo "filename=$(ls eas-*-x64.tar.gz)" >> $GITHUB_OUTPUT
-        working-directory: ${{ github.workspace }}/packages/eas-cli/dist
-      - id: arm
-        run: echo "filename=$(ls eas-*-arm.tar.gz)" >> $GITHUB_OUTPUT
-        working-directory: ${{ github.workspace }}/packages/eas-cli/dist
-      - name: Upload linux-x64 tarball
-        uses: actions/upload-release-asset@v1
-        env:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-        with:
-          upload_url: ${{ needs.release.outputs.upload_url }}
-          asset_path: packages/eas-cli/dist/${{ steps.x64.outputs.filename }}
-          asset_name: ${{ steps.x64.outputs.filename }}
-          asset_content_type: application/gzip
-      - name: Upload linux-arm tarball
-        uses: actions/upload-release-asset@v1
-        env:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-        with:
-          upload_url: ${{ needs.release.outputs.upload_url }}
-          asset_path: packages/eas-cli/dist/${{ steps.arm.outputs.filename }}
-          asset_name: ${{ steps.arm.outputs.filename }}
-          asset_content_type: application/gzip
-  build-mac:
-    name: Build for macOS
-    # Use macOS to get the correct platform specific dependencies
-    runs-on: macos-latest
-    needs: release
-    steps:
-      - uses: actions/checkout@v2
-      - uses: actions/setup-node@v2
-        with:
-          node-version: 20
-      - run: brew install python-setuptools
-        env:
-          HOMEBREW_NO_AUTO_UPDATE: 1
-      - run: yarn install --frozen-lockfile --check-files
-      - run: yarn build
-      - name: Build tarballs
-        working-directory: ${{ github.workspace }}/packages/eas-cli
-        run: |
-          yarn pretarball-ci
-          yarn oclif pack:tarballs --no-xz --targets darwin-x64,darwin-arm64
-      - id: x64
-        run: echo "filename=$(ls eas-*-x64.tar.gz)" >> $GITHUB_OUTPUT
-        working-directory: ${{ github.workspace }}/packages/eas-cli/dist
-      - id: arm64
-        run: echo "filename=$(ls eas-*-arm64.tar.gz)" >> $GITHUB_OUTPUT
-        working-directory: ${{ github.workspace }}/packages/eas-cli/dist
-      - name: Upload darwin-x64 tarball
-        uses: actions/upload-release-asset@v1
-        env:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-        with:
-          upload_url: ${{ needs.release.outputs.upload_url }}
-          asset_path: packages/eas-cli/dist/${{ steps.x64.outputs.filename }}
-          asset_name: ${{ steps.x64.outputs.filename }}
-          asset_content_type: application/gzip
-      - name: Upload darwin-arm64 tarball
-        uses: actions/upload-release-asset@v1
-        env:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-        with:
-          upload_url: ${{ needs.release.outputs.upload_url }}
-          asset_path: packages/eas-cli/dist/${{ steps.arm64.outputs.filename }}
-          asset_name: ${{ steps.arm64.outputs.filename }}
-          asset_content_type: application/gzip
-  build-windows:
-    name: Build for Windows
-    runs-on: ubuntu-latest
-    needs: release
-    steps:
-      - uses: actions/checkout@v2
-      - uses: actions/setup-node@v2
-        with:
-          node-version: 20
-      - run: yarn install --frozen-lockfile --check-files
-      - run: sudo apt-get install nsis
-      - run: yarn build
-      - run: |
-          yarn pretarball-ci
-          yarn oclif pack:win
-        working-directory: ${{ github.workspace }}/packages/eas-cli
-      - id: x64
-        run: echo "filename=$(ls eas-*-x64.exe)" >> $GITHUB_OUTPUT
-        working-directory: ${{ github.workspace }}/packages/eas-cli/dist/win32
-      - id: x86
-        run: echo "filename=$(ls eas-*-x86.exe)" >> $GITHUB_OUTPUT
-        working-directory: ${{ github.workspace }}/packages/eas-cli/dist/win32
-      - name: Upload x64 installer
-        uses: actions/upload-release-asset@v1
-        env:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-        with:
-          upload_url: ${{ needs.release.outputs.upload_url }}
-          asset_path: packages/eas-cli/dist/win32/${{ steps.x64.outputs.filename }}
-          asset_name: ${{ steps.x64.outputs.filename }}
-          asset_content_type: application/gzip
-      - name: Upload x86 installer
-        uses: actions/upload-release-asset@v1
-        env:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-        with:
-          upload_url: ${{ needs.release.outputs.upload_url }}
-          asset_path: packages/eas-cli/dist/win32/${{ steps.x86.outputs.filename }}
-          asset_name: ${{ steps.x86.outputs.filename }}
-          asset_content_type: application/gzip
   publish-to-npm:
     name: Publish to npm
     runs-on: ubuntu-latest
-    needs: [build-linux, build-mac, build-windows]
+    needs: release
+    permissions:
+      id-token: write
     steps:
-      - uses: actions/checkout@v2
-      - uses: actions/setup-node@v2
-        with:
-          registry-url: 'https://registry.npmjs.org/'
-          scope: 'expo'
-          node-version: 20
+      - uses: actions/checkout@34e114876b0b11c390a56381ad16ebd13914f8d5 # v4
+      - uses: ./.github/actions/setup-mise
       - name: Install dependencies
-        run: yarn install --frozen-lockfile --check-files
+        run: yarn install --immutable
       - name: Build
         run: yarn build
       - name: Publish packages to npm
-        run: yarn lerna publish from-package --yes --no-verify-access
+        run: yarn run -T lerna publish from-package --yes --no-verify-access
+      - name: Add latest-eas-build-staging tag
         env:
           NODE_AUTH_TOKEN: ${{ secrets.NPM_ACCESS_TOKEN }}
-      - name: Add latest-eas-build-staging tag
         run: |
           VERSION=$(cat lerna.json | jq -r .version)
           echo //registry.npmjs.org/:_authToken=$NODE_AUTH_TOKEN > ~/.npmrc
           npm dist-tag add eas-cli@$VERSION latest-eas-build-staging
+      - name: Add latest-eas-build tag
         env:
           NODE_AUTH_TOKEN: ${{ secrets.NPM_ACCESS_TOKEN }}
-      - name: Add latest-eas-build tag
         run: |
           VERSION=$(cat lerna.json | jq -r .version)
           echo //registry.npmjs.org/:_authToken=$NODE_AUTH_TOKEN > ~/.npmrc
           npm dist-tag add eas-cli@$VERSION latest-eas-build
-        env:
-          NODE_AUTH_TOKEN: ${{ secrets.NPM_ACCESS_TOKEN }}
   release-changelog:
     name: Update changelog and publish release
     runs-on: ubuntu-latest
     needs: publish-to-npm
+    permissions:
+      contents: write
     steps:
-      - uses: actions/checkout@v2
+      - uses: actions/checkout@34e114876b0b11c390a56381ad16ebd13914f8d5 # v4
         with:
           token: ${{ secrets.EXPO_BOT_PAT }}
-      - uses: actions/setup-node@v2
-        with:
-          node-version: 20
+      - uses: ./.github/actions/setup-mise
       - name: Install dependencies
         working-directory: ./scripts
-        run: yarn install --frozen-lockfile --check-files
+        run: yarn install --immutable
       - name: Resolve version
         run: echo "EAS_CLI_VERSION=${GITHUB_REF#refs/tags/v}" >> $GITHUB_ENV
       - name: Update changelog
         working-directory: ./scripts
-        run: yarn --silent release-changelog $EAS_CLI_VERSION > /tmp/current-changelog
+        run: yarn release-changelog $EAS_CLI_VERSION > /tmp/current-changelog
       - name: Publish release
         run: gh release edit v$EAS_CLI_VERSION --draft=false -F /tmp/current-changelog
         env:
@@ -211,7 +81,7 @@ jobs:
           git config --global user.email "[email protected]"
           git config --global user.name "Expo CI"
           git add CHANGELOG.md
-          git commit -m "update CHANGELOG.md"
+          git commit --allow-empty -m "update CHANGELOG.md"
           git push
       - name: Prepare changelog for Slack
         run: |
@@ -221,13 +91,13 @@ jobs:
           cat /tmp/changelog.slack.md >> $GITHUB_ENV
           echo 'EOF' >> $GITHUB_ENV
       - name: Slack Notification
-        uses: rtCamp/action-slack-notify@v2
+        uses: rtCamp/action-slack-notify@e31e87e03dd19038e411e38ae27cbad084a90661 # v2
         env:
           SLACK_CHANNEL: eas-cli
           SLACK_COLOR: ${{ job.status }}
           SLACK_ICON: https://github.com/expo-bot.png?size=48
-          SLACK_TITLE: 'Released eas-cli@${{ env.EAS_CLI_VERSION }}'
+          SLACK_TITLE: "Released eas-cli@${{ env.EAS_CLI_VERSION }}"
           SLACK_MESSAGE: ${{ env.SLACK_CHANGELOG }}
-          SLACK_USERNAME: 'EAS CLI CI'
+          SLACK_USERNAME: "EAS CLI CI"
           SLACK_WEBHOOK: ${{ secrets.SLACK_WEBHOOK }}
-          SLACK_FOOTER: ''
+          SLACK_FOOTER: ""

.github/workflows/size.yml

@@ -1,23 +0,0 @@
-name: Size
-on:
-  pull_request:
-    types: [synchronize, opened]
-concurrency:
-  group: size-${{ github.ref }}
-  cancel-in-progress: true
-jobs:
-  compare:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v2
-      - uses: actions/setup-node@v2
-        with:
-          node-version: 20
-      - uses: preactjs/compressed-size-action@v2
-        with:
-          build-script: 'build:tarballs:linux'
-          repo-token: '${{ secrets.GITHUB_TOKEN }}'
-          pattern: './packages/eas-cli/dist/*.tar.gz'
-          compression: 'none'
-          strip-hash: "v\\d+.\\d+.\\d+-\\w+-"
-          clean-script: 'clean'

.github/workflows/stale-issues.yml

@@ -8,7 +8,7 @@ jobs:
   close-issues:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/stale@v4
+      - uses: actions/stale@a20b814fb01b71def3bd6f56e7494d667ddf28da # v4
         with:
           ascending: false
           operations-per-run: 300

.github/workflows/test-graphql.yml

@@ -5,9 +5,6 @@ on:
     branches: [main]
   pull_request:
     branches: [main]
-    paths:
-      - .github/workflows/test-graphql.yml
-      - packages/eas-cli/src/**
   schedule:
     - cron: '0 8 * * *' # 8:00 AM UTC time every day
 
@@ -20,11 +17,9 @@ jobs:
     name: Ensure GraphQL schema and generated code is up-to-date
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v2
-      - name: Setup node
-        uses: actions/setup-node@v2
-        with:
-          node-version: 22
-      - run: yarn install --frozen-lockfile
+      - uses: actions/checkout@ee0669bd1cc54295c223e0bb666b733df41de1c5 # v2
+      - name: Setup tools
+        uses: ./.github/actions/setup-mise
+      - run: yarn install --immutable
       - run: yarn verify-graphql-code
         working-directory: packages/eas-cli

.github/workflows/test-scripts.yml

@@ -21,10 +21,8 @@ jobs:
   test:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v2
-      - name: Setup node
-        uses: actions/setup-node@v2
-        with:
-          node-version: 20
-      - run: yarn install --frozen-lockfile --check-files
+      - uses: actions/checkout@ee0669bd1cc54295c223e0bb666b733df41de1c5 # v2
+      - name: Setup tools
+        uses: ./.github/actions/setup-mise
+      - run: yarn install --immutable
       - run: yarn typecheck

.github/workflows/test.yml

@@ -15,40 +15,63 @@ jobs:
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        node: ['18', '20', '22']
+        node: ['20', '22', '24']
         include:
           - node: '20'
             coverage: true
     name: Test with Node ${{ matrix.node }}
     steps:
-      - uses: actions/checkout@v2
-      - name: Setup node
-        uses: actions/setup-node@v2
-        with:
-          node-version: ${{ matrix.node }}
-      - run: yarn install --frozen-lockfile --check-files
+      - uses: actions/checkout@ee0669bd1cc54295c223e0bb666b733df41de1c5 # v2
+      - name: Setup tools
+        uses: ./.github/actions/setup-mise
+        env:
+          MISE_NODE_VERSION: ${{ matrix.node }}
+      - name: Install dependencies
+        run: yarn install --immutable
+        env:
+          YARN_ENABLE_HARDENED_MODE: ${{ matrix.coverage == true && '1' || '0' }}
       - run: yarn typecheck
       - run: |
           git config --global user.email "[email protected]"
           git config --global user.name "Test"
-      - run: yarn test
-        if: ${{ !matrix.coverage }}
+      - name: Fetch base commit for PR diffing
+        if: ${{ github.event_name == 'pull_request' }}
+        # Lerna needs the base commit to compute affected packages.
+        run: git fetch --no-tags --depth=1 origin ${{ github.event.pull_request.base.sha }}
+      - name: Run tests (affected)
+        # PRs: only run tests for changed packages + dependents.
+        if: ${{ !matrix.coverage && github.event_name == 'pull_request' }}
+        run: yarn run -T lerna run test --since ${{ github.event.pull_request.base.sha }} --include-dependents
         env:
           NODE_OPTIONS: --max-old-space-size=8192
-      - run: yarn test --coverage
+      - name: Run tests (all)
+        # Pushes to main: run all package tests.
+        if: ${{ !matrix.coverage && github.event_name == 'push' }}
+        run: yarn run -T lerna run test
+        env:
+          NODE_OPTIONS: --max-old-space-size=8192
+      - name: Run tests (coverage)
+        # Coverage on PRs and main; per-package reports are uploaded to Codecov.
         if: ${{ matrix.coverage }}
+        run: yarn run -T lerna run test -- --coverage
         env:
           # Oclif seems to cause OOM errors when testing with coverage enabled.
           # Remove this whenever we solved those OOM errors.
           NODE_OPTIONS: --max-old-space-size=8192
-      - run: yarn lint --max-warnings=0
-      - run: yarn install --frozen-lockfile --check-files
+      - run: yarn lint
+      - run: yarn fmt:check
+      - name: Install scripts dependencies
+        if: ${{ matrix.coverage }}
+        run: yarn install --immutable
         working-directory: ./scripts
-      - uses: codecov/codecov-action@v1
+        env:
+          YARN_ENABLE_HARDENED_MODE: ${{ matrix.coverage == true && '1' || '0' }}
+      - uses: codecov/codecov-action@29386c70ef20e286228c72b668a06fd0e8399192 # v1
         if: ${{ matrix.coverage }}
         with:
           token: ${{ secrets.CODECOV_TOKEN }}
-      - run: yarn lint-changelog
+      - if: ${{ matrix.coverage }}
+        run: yarn lint-changelog
 
   notify-slack:
     runs-on: ubuntu-latest
@@ -56,7 +79,7 @@ jobs:
     name: Notify Slack
     if: ${{ github.ref == 'refs/heads/main' && always() }}
     steps:
-      - uses: actions/checkout@v2
+      - uses: actions/checkout@ee0669bd1cc54295c223e0bb666b733df41de1c5 # v2
       - name: Notify Slack
         uses: ./.github/internal-actions/notify-slack-on-fail-or-recover
         with:

.github/workflows/trigger-release.yml

@@ -0,0 +1,46 @@
+on:
+  workflow_dispatch:
+    inputs:
+      version:
+        type: string
+        required: false
+        description: 'Version number for the release'
+      dry_run:
+        type: boolean
+        required: true
+        default: true
+        description: 'Run the release in dry run mode, without pushing any changes'
+
+name: Manually trigger a release
+
+jobs:
+  release:
+    name: Trigger a release
+    runs-on: ubuntu-latest
+    env:
+      GITHUB_TOKEN: ${{ secrets.EXPO_BOT_PAT }}
+      INPUT_VERSION: ${{ github.event.inputs.version }}
+      INPUT_DRY_RUN: ${{ github.event.inputs.dry_run }}
+    steps:
+      - uses: actions/checkout@34e114876b0b11c390a56381ad16ebd13914f8d5 # v4
+        with:
+          ref: main
+          fetch-depth: 0
+          token: ${{ secrets.EXPO_BOT_PAT }}
+      - uses: ./.github/actions/setup-mise
+      - run: |
+          # Lerna will not detect changes correctly without having all tags
+          git fetch --depth=1 origin +refs/tags/*:refs/tags/*
+          # Checkout the main branch
+          git checkout main
+          git config --global user.email "[email protected]"
+          git config --global user.name "Expo CI"
+          yarn install --immutable
+          yarn build
+          if [[ "$INPUT_VERSION" == "" ]]; then
+            echo "Releasing with default version"
+            yarn release
+          else
+            echo "Releasing with version $INPUT_VERSION"
+            yarn release $INPUT_VERSION
+          fi

.github/workflows/upgrade-eas-build-modules.yml

@@ -1,81 +0,0 @@
-name: Open a PR bumping eas-build modules
-
-on: workflow_dispatch
-
-jobs:
-  open-pr:
-    name: Open a PR bumping eas-build modules
-    runs-on: ubuntu-latest
-
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v4
-        with:
-          ref: main
-          token: ${{ secrets.EXPO_BOT_PAT }}
-
-      - name: Setup node
-        uses: actions/setup-node@v2
-        with:
-          node-version: 20
-
-      - run: yarn install --frozen-lockfile
-
-      - name: Configure git
-        run: |
-          git config --global user.email "[email protected]"
-          git config --global user.name "Expo Bot"
-
-      - name: Upgrade eas-build modules
-        run: |
-          for DIR in packages/eas-cli packages/eas-json; do
-            pushd $DIR >/dev/null 2>&1
-              # packages are ordered according to output of `lerna list --toposort`
-              # https://github.com/expo/turtle-v2/pull/568
-              for PACKAGE in "@expo/downloader" "@expo/eas-build-job" "@expo/logger" "@expo/template-file" "@expo/steps" "@expo/turtle-spawn" "@expo/build-tools"; do
-                if grep -q $PACKAGE package.json; then
-                  echo "[$DIR] yarn --exact add $PACKAGE"
-                  yarn add --exact $PACKAGE
-                fi
-              done
-            popd >/dev/null 2>&1
-          done
-
-      - name: Set a branch name
-        id: bump-branch-name
-        run: |
-          HASH="$(echo $RANDOM | md5sum | head -c 10)"
-          BRANCH_NAME="@expo-bot/eas-build-bump-$HASH"
-
-          echo "BRANCH_NAME=$BRANCH_NAME" >> $GITHUB_OUTPUT
-
-      - name: Create a branch, commit, and push
-        run: |
-          BRANCH_NAME="${{ steps.bump-branch-name.outputs.BRANCH_NAME }}"
-
-          git checkout -b $BRANCH_NAME
-          git add .
-          git commit -m "Upgrade eas-build dependencies"
-          git push origin $BRANCH_NAME
-
-      - name: Open a PR to main
-        uses: repo-sync/pull-request@v2
-        id: open-pr
-        with:
-          source_branch: '${{ steps.bump-branch-name.outputs.BRANCH_NAME }}'
-          destination_branch: 'main'
-          pr_title: 'Upgrade eas-build dependencies'
-          pr_body: ':arrow_up: Upgrades [`eas-build`](https://github.com/expo/eas-build) dependencies.'
-          pr_reviewer: 'sjchmiela'
-          github_token: ${{ secrets.EXPO_BOT_PAT }}
-
-      - uses: actions/github-script@v3
-        with:
-          github-token: ${{ secrets.EXPO_BOT_PAT }}
-          script: |
-            github.issues.createComment({
-              issue_number: ${{ steps.open-pr.outputs.pr_number }},
-              owner: context.repo.owner,
-              repo: context.repo.repo,
-              body: "/changelog-entry chore Upgrade [`eas-build`](https://github.com/expo/eas-build) dependencies."
-            })

.github/workflows/worker-system-tests.yml

@@ -0,0 +1,160 @@
+name: system-tests
+
+on:
+  workflow_dispatch: {}
+  workflow_call: {}
+
+jobs:
+  system-tests:
+    runs-on: ubuntu-latest
+    env:
+      EXPO_TOKEN: ${{ secrets.STAGING_EXPO_DEV_EXPO_SERVICES_GITHUB_ROBOT_ACCESS_TOKEN }}
+      EXPO_STAGING: "1"
+    steps:
+      - uses: actions/checkout@08eba0b27e820071cde6df949e0beb9ba4906955 # v4
+
+      - uses: ./.github/actions/setup-mise
+
+      - name: Create test app
+        run: npx -y create-expo-app@latest ${{ runner.temp }}/test-app --template tabs
+
+      - name: Link to EAS project
+        working-directory: ${{ runner.temp }}/test-app
+        run: npx -y eas-cli@latest init --id 6ae8028d-4e6d-4912-8eb2-87d4e6122880 --force --non-interactive
+
+      - name: Add bundle identifiers to app.json
+        working-directory: ${{ runner.temp }}/test-app
+        run: |
+          jq '.expo.ios.bundleIdentifier = "dev.expo.workersystemtests" | .expo.android.package = "dev.expo.workersystemtests"' app.json > app.json.tmp
+          mv app.json.tmp app.json
+
+      - name: Configure EAS Build
+        working-directory: ${{ runner.temp }}/test-app
+        run: npx -y eas-cli@latest build:configure --platform all
+
+      - name: Add system-test profile to eas.json
+        working-directory: ${{ runner.temp }}/test-app
+        run: |
+          jq '.build["system-test"] = { "ios": { "simulator": true }, "android": { "withoutCredentials": true } }' eas.json > eas.json.tmp
+          mv eas.json.tmp eas.json
+
+      - name: Setup EAS workflow
+        working-directory: ${{ runner.temp }}/test-app
+        run: |
+          mkdir -p .eas/workflows
+          cp ${{ github.workspace }}/.github/fixtures/eas-workflow-build-android.yml .eas/workflows/build-android.yml
+
+      - name: Run iOS build and Android workflow concurrently
+        working-directory: ${{ runner.temp }}/test-app
+        run: |
+          set -euo pipefail
+
+          BUILD_JSON=$(npx -y eas-cli@latest build --platform ios --profile system-test --non-interactive --no-wait --json)
+          BUILD_ID=$(echo "$BUILD_JSON" | jq -r 'if type=="array" then .[0].id // .[0].build.id // .[0].buildId else .id // .build.id // .buildId end // empty')
+          if [ -z "$BUILD_ID" ]; then
+            echo "Error: could not determine build ID"
+            echo "$BUILD_JSON" | jq .
+            exit 1
+          fi
+          echo "BUILD_ID=$BUILD_ID" >> "$GITHUB_ENV"
+          echo "Resolved BUILD_ID=$BUILD_ID"
+
+          WORKFLOW_JSON=$(npx -y eas-cli@latest workflow:run build-android.yml --non-interactive --no-wait --json)
+          WORKFLOW_RUN_ID=$(echo "$WORKFLOW_JSON" | jq -r '.id // .workflowRun.id // .workflowRunId // empty')
+          if [ -z "$WORKFLOW_RUN_ID" ]; then
+            echo "Error: could not determine workflow run ID"
+            echo "$WORKFLOW_JSON" | jq .
+            exit 1
+          fi
+          echo "WORKFLOW_RUN_ID=$WORKFLOW_RUN_ID" >> "$GITHUB_ENV"
+          echo "Resolved WORKFLOW_RUN_ID=$WORKFLOW_RUN_ID"
+
+          is_terminal_build_status() {
+            case "$1" in
+              FINISHED|ERRORED|CANCELED) return 0 ;;
+              *) return 1 ;;
+            esac
+          }
+
+          is_terminal_workflow_status() {
+            case "$1" in
+              SUCCESS|FAILURE|CANCELED|ACTION_REQUIRED) return 0 ;;
+              *) return 1 ;;
+            esac
+          }
+
+          BUILD_STATUS=""
+          WORKFLOW_STATUS=""
+          TIMEOUT_SECONDS=1800
+          START_TIME=$(date +%s)
+
+          while true; do
+            ELAPSED=$(( $(date +%s) - START_TIME ))
+            if [ "$ELAPSED" -ge "$TIMEOUT_SECONDS" ]; then
+              echo "Timeout: polling exceeded 30 minutes"
+              exit 1
+            fi
+
+            BUILD_STATUS=$(npx -y eas-cli@latest build:view "$BUILD_ID" --json | jq -r '.status // empty')
+            WORKFLOW_STATUS=$(npx -y eas-cli@latest workflow:view "$WORKFLOW_RUN_ID" --non-interactive --json | jq -r '.status // empty')
+
+            echo "iOS build status: $BUILD_STATUS"
+            echo "Android workflow status: $WORKFLOW_STATUS"
+
+            if is_terminal_build_status "$BUILD_STATUS" && is_terminal_workflow_status "$WORKFLOW_STATUS"; then
+              break
+            fi
+
+            sleep 7
+          done
+
+          EXIT_CODE=0
+
+          if [ "$BUILD_STATUS" != "FINISHED" ]; then
+            echo "Build did not finish successfully: $BUILD_STATUS"
+            EXIT_CODE=1
+          fi
+
+          if [ "$WORKFLOW_STATUS" != "SUCCESS" ]; then
+            echo "Workflow did not finish successfully: $WORKFLOW_STATUS"
+            EXIT_CODE=1
+          fi
+
+          exit "$EXIT_CODE"
+
+      - name: Cancel EAS runs on workflow cancellation
+        if: always() && (cancelled() || failure())
+        working-directory: ${{ runner.temp }}/test-app
+        run: |
+          set -euo pipefail
+
+          if [ -n "${BUILD_ID:-}" ]; then
+            echo "Canceling EAS build: $BUILD_ID"
+            BUILD_CANCEL_OUTPUT=$(npx -y eas-cli@latest build:cancel "$BUILD_ID" --non-interactive 2>&1 || true)
+            if [ -n "$BUILD_CANCEL_OUTPUT" ]; then
+              echo "$BUILD_CANCEL_OUTPUT"
+            else
+              echo "build:cancel produced no output"
+            fi
+            BUILD_STATUS=$(npx -y eas-cli@latest build:view "$BUILD_ID" --json 2>/dev/null | jq -r '.status // empty' || true)
+            if [ -n "$BUILD_STATUS" ]; then
+              echo "Post-cancel build status: $BUILD_STATUS"
+            else
+              echo "Post-cancel build status unavailable"
+            fi
+          fi
+          if [ -n "${WORKFLOW_RUN_ID:-}" ]; then
+            echo "Canceling EAS workflow run: $WORKFLOW_RUN_ID"
+            WORKFLOW_CANCEL_OUTPUT=$(npx -y eas-cli@latest workflow:cancel "$WORKFLOW_RUN_ID" --non-interactive 2>&1 || true)
+            if [ -n "$WORKFLOW_CANCEL_OUTPUT" ]; then
+              echo "$WORKFLOW_CANCEL_OUTPUT"
+            else
+              echo "workflow:cancel produced no output"
+            fi
+            WORKFLOW_STATUS=$(npx -y eas-cli@latest workflow:view "$WORKFLOW_RUN_ID" --non-interactive --json 2>/dev/null | jq -r '.status // empty' || true)
+            if [ -n "$WORKFLOW_STATUS" ]; then
+              echo "Post-cancel workflow status: $WORKFLOW_STATUS"
+            else
+              echo "Post-cancel workflow status unavailable"
+            fi
+          fi

.github/workflows/worker.yml

@@ -0,0 +1,80 @@
+name: worker
+
+on:
+  push:
+    branches: [main]
+    paths:
+      - "packages/worker/**"
+      - "packages/build-tools/**"
+      - "packages/eas-build-job/**"
+      - "packages/steps/**"
+      - "packages/logger/**"
+      - "packages/downloader/**"
+      - "packages/template-file/**"
+      - "packages/turtle-spawn/**"
+      - .github/workflows/worker.yml
+      - .github/workflows/build-and-deploy-worker.yml
+      - yarn.lock
+
+concurrency:
+  group: worker-${{ github.ref }}-${{ github.event_name }}
+  cancel-in-progress: true
+
+jobs:
+  worker-checks:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@08eba0b27e820071cde6df949e0beb9ba4906955 # v4
+
+      - uses: ./.github/actions/setup-mise
+
+      - run: yarn install --immutable
+
+      - run: yarn typecheck
+
+      - name: Run unit tests
+        working-directory: packages/worker
+        run: yarn test:unit
+
+      - name: Run integration tests
+        working-directory: packages/worker
+        run: yarn test:integration
+
+  worker-build:
+    needs:
+      - worker-checks
+    uses: ./.github/workflows/build-and-deploy-worker.yml
+    secrets: inherit
+    with:
+      environment: ${{ github.ref == 'refs/heads/main' && 'staging' || '' }}
+
+  system-tests-staging:
+    if: github.ref == 'refs/heads/main' && !failure() && !cancelled()
+    needs:
+      - worker-build
+      - worker-checks
+    uses: ./.github/workflows/worker-system-tests.yml
+    secrets: inherit
+
+  deploy-worker-production:
+    if: github.ref == 'refs/heads/main' && !failure() && !cancelled()
+    needs:
+      - system-tests-staging
+    uses: ./.github/workflows/build-and-deploy-worker.yml
+    secrets: inherit
+    with:
+      environment: production
+
+  notify-slack:
+    runs-on: ubuntu-latest
+    needs:
+      - deploy-worker-production
+    if: github.ref == 'refs/heads/main' && always() && !cancelled()
+    steps:
+      - uses: actions/checkout@08eba0b27e820071cde6df949e0beb9ba4906955 # v4
+
+      - name: Notify Slack
+        uses: ./.github/internal-actions/notify-slack-on-fail-or-recover
+        with:
+          channel: turtle-bots
+          slack_webhook: ${{ secrets.SLACK_EAS_WORKFLOWS_WEBHOOK }}

.gitignore

@@ -3,17 +3,24 @@ packages/*/build
 packages/eas-cli/dist
 packages/eas-cli/tmp
 scripts/build
+dist
+
+# TypeScript
+**/*.tsbuildinfo
 
 # Code editors
 .idea
 .history
 .vscode
+*.swp
+*.swo
 
 # macOS
 .DS_Store
 
 # Node
 node_modules
+**/.yarn/install-state.gz
 *-debug.log
 *-error.log
 

.oxfmtrc.json

@@ -0,0 +1,22 @@
+{
+  "printWidth": 100,
+  "tabWidth": 2,
+  "singleQuote": true,
+  "bracketSameLine": true,
+  "trailingComma": "es5",
+  "arrowParens": "avoid",
+  "endOfLine": "lf",
+  "ignorePatterns": [
+    ".github",
+    "lerna.json",
+    "**/build/**",
+    "**/dist/**",
+    "**/coverage/**",
+    "**/fixtures/**",
+    "packages/eas-cli/README.md",
+    "packages/eas-cli/schema/**",
+    "packages/eas-cli/graphql.schema.json",
+    "packages/eas-cli/src/graphql/generated.ts",
+    "packages/build-tools/schema.graphql"
+  ]
+}

.oxlintrc.json

@@ -0,0 +1,77 @@
+{
+  "$schema": "./node_modules/oxlint/configuration_schema.json",
+  "categories": {
+    "correctness": "off",
+    "suspicious": "off",
+    "pedantic": "off",
+    "perf": "off",
+    "restriction": "off",
+    "style": "off",
+    "nursery": "off"
+  },
+  "ignorePatterns": [
+    "**/build/**",
+    "**/dist/**",
+    "**/coverage/**",
+    "**/fixtures/**",
+    "**/__fixtures__/**",
+    ".github/**",
+    "packages/eas-cli/schema/**",
+    "packages/eas-cli/graphql.schema.json",
+    "packages/build-tools/schema.graphql"
+  ],
+  "plugins": ["import", "node", "typescript"],
+  "jsPlugins": [
+    {
+      "name": "async-protect",
+      "specifier": "eslint-plugin-async-protect"
+    }
+  ],
+  "rules": {
+    "no-console": "warn",
+    "no-constant-condition": [
+      "warn",
+      {
+        "checkLoops": false
+      }
+    ],
+    "sort-imports": [
+      "warn",
+      {
+        "ignoreDeclarationSort": true
+      }
+    ],
+    "curly": "warn",
+    "default": "off",
+    "named": "off",
+    "namespace": "off",
+    "no-cycle": "error",
+    "no-restricted-imports": [
+      "error",
+      {
+        "paths": [
+          {
+            "name": "lodash",
+            "message": "Don't use lodash, it's heavy!"
+          }
+        ]
+      }
+    ],
+    "no-underscore-dangle": [
+      "error",
+      {
+        "allow": ["__typename"]
+      }
+    ],
+    "async-protect/async-suffix": "error",
+    "node/no-sync": "error"
+  },
+  "overrides": [
+    {
+      "files": ["**/__tests__/**/*.ts", "**/__mocks__/**/*.ts"],
+      "rules": {
+        "async-protect/async-suffix": "off"
+      }
+    }
+  ]
+}

.prettierrc

@@ -1,9 +0,0 @@
-{
-  "printWidth": 100,
-  "tabWidth": 2,
-  "singleQuote": true,
-  "bracketSameLine": true,
-  "trailingComma": "es5",
-  "arrowParens": "avoid",
-  "endOfLine": "auto"
-}

.vscode/settings.json

@@ -1,5 +1,4 @@
 {
-  "eslint.enable": true,
   "search.exclude": {
     "**/node_modules": true,
     "**/bower_components": true,
@@ -7,4 +6,4 @@
     "**/src/**/build/**": false,
     "**/src/build/**": false,
   }
-}
+}

.yarnrc

@@ -1 +0,0 @@
-save-prefix ""

.yarnrc.yml

@@ -0,0 +1,9 @@
+defaultSemverRangePrefix: ''
+nodeLinker: node-modules
+
+npmMinimalAgeGate: 2d
+
+npmPreapprovedPackages:
+  - '@expo/*'
+  - 'eslint-plugin-universe'
+  - 'oxlint-config-universe'

AGENTS.md

@@ -0,0 +1,6 @@
+# AGENTS.md
+
+When working with this repository follow instructions from CLAUDE.md.
+
+- [./CLAUDE.md](./CLAUDE.md)
+- Before committing, run the formatter on modified files.

CHANGELOG.md

@@ -12,6 +12,473 @@ This is the log of notable changes to EAS CLI and related packages.
 
 ### 🧹 Chores
 
+## [19.0.1](https://github.com/expo/eas-cli/releases/tag/v19.0.1) - 2026-05-19
+
+### 🐛 Bug fixes
+
+- [eas-cli] Disable dotenv loading when resolving managed iOS entitlements. ([#3752](https://github.com/expo/eas-cli/pull/3752) by [@sjchmiela](https://github.com/sjchmiela))
+- [eas-cli] Restore the bundled config fallback for managed iOS entitlements introspection. ([#3753](https://github.com/expo/eas-cli/pull/3753) by [@sjchmiela](https://github.com/sjchmiela))
+
+## [19.0.0](https://github.com/expo/eas-cli/releases/tag/v19.0.0) - 2026-05-19
+
+### 🛠 Breaking changes
+
+- [eas-cli] Make browser-based authentication the default for `eas login`. Use `--no-browser` for CLI-based login. ([#3746](https://github.com/expo/eas-cli/pull/3746) by [@byronkarlen](https://github.com/byronkarlen))
+
+### 🎉 New features
+
+- [eas-cli] Allow command `observe:routes` to filter results to specific route names. ([#3744](https://github.com/expo/eas-cli/pull/3744) by [@douglowder](https://github.com/douglowder))
+
+### 🐛 Bug fixes
+
+- [eas-cli] Check that `expo` is resolvable before assuming it's installed ([#3748](https://github.com/expo/eas-cli/pull/3748) by [@kitten](https://github.com/kitten))
+
+### 🧹 Chores
+
+- [worker] Report build phase durations stats. ([#3732](https://github.com/expo/eas-cli/pull/3732) by [@gwdp](https://github.com/gwdp))
+
+## [18.13.1](https://github.com/expo/eas-cli/releases/tag/v18.13.1) - 2026-05-18
+
+### 🎉 New features
+
+- [eas-cli] Send the installed `expo` package version in build metadata. ([#3725](https://github.com/expo/eas-cli/pull/3725) by [@sjchmiela](https://github.com/sjchmiela))
+
+### 🐛 Bug fixes
+
+- [eas-cli] Prevent `npx` invocations that can be unreliable and fail when retrieving entitlements or project configs ([#3282](https://github.com/expo/eas-cli/pull/3282) by [@kitten](https://github.com/kitten))
+
+## [18.13.0](https://github.com/expo/eas-cli/releases/tag/v18.13.0) - 2026-05-14
+
+### 🎉 New features
+
+- [eas-cli] New command `observe:routes` for navigation metrics. ([#3730](https://github.com/expo/eas-cli/pull/3730) by [@douglowder](https://github.com/douglowder))
+
+### 🧹 Chores
+
+- [eas-cli] Refactor observe commands to extract common flag definitions. ([#3731](https://github.com/expo/eas-cli/pull/3731) by [@douglowder](https://github.com/douglowder))
+
+## [18.12.3](https://github.com/expo/eas-cli/releases/tag/v18.12.3) - 2026-05-13
+
+## [18.12.2](https://github.com/expo/eas-cli/releases/tag/v18.12.2) - 2026-05-12
+
+### 🐛 Bug fixes
+
+- [eas-cli] Fix `eas go` to use server-side project setup and support multiple Expo Go SDK versions. ([#3657](https://github.com/expo/eas-cli/pull/3657) by [@gwdp](https://github.com/gwdp))
+
+### 🧹 Chores
+
+- [ci] Audit GitHub Actions workflows: harden `pull_request_target` usage, pin all external actions to commit SHAs, and add Dependabot to refresh them. ([#3718](https://github.com/expo/eas-cli/pull/3718) by [@brentvatne](https://github.com/brentvatne))
+
+## [18.12.1](https://github.com/expo/eas-cli/releases/tag/v18.12.1) - 2026-05-12
+
+## [18.12.0](https://github.com/expo/eas-cli/releases/tag/v18.12.0) - 2026-05-12
+
+### 🎉 New features
+
+- [eas-cli] Automatically save the Convex deployment URL as an EAS environment variable when connecting a Convex project. ([#3685](https://github.com/expo/eas-cli/pull/3685) by [@fiberjw](https://github.com/fiberjw))
+
+### 🐛 Bug fixes
+
+- [build-tools] Update the minimum Expo version required for iOS precompiled modules. ([#3677](https://github.com/expo/eas-cli/pull/3677) by [@sjchmiela](https://github.com/sjchmiela))
+- [eas-cli] recommend that users read the docs after connecting Convex ([#3683](https://github.com/expo/eas-cli/pull/3683) by [@fiberjw](https://github.com/fiberjw))
+
+## [18.11.0](https://github.com/expo/eas-cli/releases/tag/v18.11.0) - 2026-05-05
+
+### 🎉 New features
+
+- [eas-cli] Add `--simulator` to `eas build:dev` and `eas build:run` to select which iOS simulator to install and run builds on. ([#3637](https://github.com/expo/eas-cli/pull/3637) by [@mmichels-brex](https://github.com/mmichels-brex))
+
+### 🐛 Bug fixes
+
+- [eas-cli] Fix Convex team invite output after skipped or unnecessary invitations. ([#3672](https://github.com/expo/eas-cli/pull/3672) by [@fiberjw](https://github.com/fiberjw))
+- Make directories marked as read-only writable when creating a tar, to prevent the cross-filesystem issues when extracting the tar. ([#3489](https://github.com/expo/eas-cli/pull/3489) by [@sswrk](https://github.com/sswrk))
+
+## [18.10.0](https://github.com/expo/eas-cli/releases/tag/v18.10.0) - 2026-05-04
+
+### 🎉 New features
+
+- [eas-cli] Add `eas integrations:convex` commands to manage Convex integrations for EAS projects. ([#3575](https://github.com/expo/eas-cli/pull/3575) by [@fiberjw](https://github.com/fiberjw))
+- [eas-cli] New command `observe:logs` for custom events. ([#3638](https://github.com/expo/eas-cli/pull/3638) by [@douglowder](https://github.com/douglowder))
+
+### 🐛 Bug fixes
+
+- [eas-cli] Create portable project archives on all platforms to normalize cross-platform tar metadata and permissions. ([#3234](https://github.com/expo/eas-cli/pull/3234) by [@sjchmiela](https://github.com/sjchmiela))
+- [eas-cli] Remove hardcoded `builderEnvironment.image` override in `eas build:resign`. ([#3661](https://github.com/expo/eas-cli/pull/3661) by [@hSATAC](https://github.com/hSATAC))
+- [eas-cli] Fix `eas update --json` intermittently failing with JSON parse errors during "Computing project fingerprints" by passing `silent: true` to `@expo/fingerprint` to suppress subprocess stdout pollution. ([#3659](https://github.com/expo/eas-cli/pull/3659) by [@Mookiies](https://github.com/Mookiies))
+
+## [18.9.1](https://github.com/expo/eas-cli/releases/tag/v18.9.1) - 2026-04-30
+
+## [18.9.0](https://github.com/expo/eas-cli/releases/tag/v18.9.0) - 2026-04-30
+
+### 🎉 New features
+
+- [eas-cli] Add `eas integrations:asc` commands to manage App Store Connect integrations for EAS projects. ([#3558](https://github.com/expo/eas-cli/pull/3558) by [@sswrk](https://github.com/sswrk))
+- [eas-cli] Allow `eas build:download` to accept a build ID. ([#3655](https://github.com/expo/eas-cli/pull/3655) by [@douglowder](https://github.com/douglowder))
+- [eas-cli] Add `--id` alias for `--build-id` flag in `eas build:download`. ([#3656](https://github.com/expo/eas-cli/pull/3656) by [@brentvatne](https://github.com/brentvatne))
+
+### 🐛 Bug fixes
+
+- [steps] Fix workflow job context interpolation when a string contains multiple `${{ }}` expressions on the same line (for example a changelog built from two context values). ([#3644](https://github.com/expo/eas-cli/pull/3644) by [@gwdp](https://github.com/gwdp))
+
+## [18.8.1](https://github.com/expo/eas-cli/releases/tag/v18.8.1) - 2026-04-23
+
+## [18.8.0](https://github.com/expo/eas-cli/releases/tag/v18.8.0) - 2026-04-22
+
+### 🎉 New features
+
+- [eas-cli] Support custom params in `observe:events` results. ([#3620](https://github.com/expo/eas-cli/pull/3620) by [@douglowder](https://github.com/douglowder))
+- [build-tools] Add `eas/deploy` function for EAS Hosting web deployments. ([#3598](https://github.com/expo/eas-cli/pull/3598) by [@gwdp](https://github.com/gwdp))
+- [build-tools] Add `eas/export` function for Expo web exports. ([#3598](https://github.com/expo/eas-cli/pull/3598) by [@gwdp](https://github.com/gwdp))
+- [eas-cli] Add `eas update:insights <groupId>` command to display launch, crash, unique-user, and payload-size metrics for an update group. ([#3614](https://github.com/expo/eas-cli/pull/3614) by [@kadikraman](https://github.com/kadikraman))
+- [eas-cli] Add `--insights` flag to `eas update:view <groupId>` to append the same metrics below the existing output. ([#3614](https://github.com/expo/eas-cli/pull/3614) by [@kadikraman](https://github.com/kadikraman))
+- [eas-cli] Add `eas channel:insights --channel <name> --runtime-version <version>` command to display adoption and crash metrics for a channel + runtime version. ([#3614](https://github.com/expo/eas-cli/pull/3614) by [@kadikraman](https://github.com/kadikraman))
+
+### 🐛 Bug fixes
+
+- [eas-cli] Fix `metadata:push` not deleting video previews from App Store Connect when removed from config. ([#3603](https://github.com/expo/eas-cli/pull/3603) by [@EvanBacon](https://github.com/EvanBacon))
+- [eas-cli] Warn and skip unknown preview types in `metadata:push` with a helpful suggestion when the `APP_` screenshot prefix is mistakenly used. ([#3603](https://github.com/expo/eas-cli/pull/3603) by [@EvanBacon](https://github.com/EvanBacon))
+- [eas-cli] Delete all existing previews in a preview set before uploading to avoid Apple's "Too many app previews" error. ([#3603](https://github.com/expo/eas-cli/pull/3603) by [@EvanBacon](https://github.com/EvanBacon))
+- [eas-cli] Fixes for `observe` commands, including an issue for apps with many update IDs. ([#3609](https://github.com/expo/eas-cli/pull/3609) by [@douglowder](https://github.com/douglowder))
+- [eas-cli] Add existing capability identifiers. ([#3615](https://github.com/expo/eas-cli/pull/3615) by [@jakex7](https://github.com/jakex7))
+
+## [18.7.0](https://github.com/expo/eas-cli/releases/tag/v18.7.0) - 2026-04-14
+
+### 🎉 New features
+
+- [build-tools] Add `eas/read_package_json` and `eas/read_app_config` functions ([#3585](https://github.com/expo/eas-cli/pull/3585) by [@gwdp](https://github.com/gwdp))
+- [eas-cli] Add `--skip-bundler` to `eas build:dev` to install and run a development build without starting the local Expo/Metro server. ([#3604](https://github.com/expo/eas-cli/pull/3604) by [@mmichels-brex](https://github.com/mmichels-brex))
+
+## [18.6.0](https://github.com/expo/eas-cli/releases/tag/v18.6.0) - 2026-04-10
+
+### 🎉 New features
+
+- [eas-cli] Add missing Apple metadata attributes for age ratings and content descriptions. ([#3584](https://github.com/expo/eas-cli/pull/3584) by [@EvanBacon](https://github.com/EvanBacon))
+- [eas-cli] Add App Clip metadata support to `metadata:push` and `metadata:pull` (default experience action, per-locale subtitle and header image, App Store review invocation URLs). ([#3590](https://github.com/expo/eas-cli/pull/3590) by [@EvanBacon](https://github.com/EvanBacon))
+- [build-tools] Add `working_directory` input to `eas/build` function group for custom builds. ([#3582](https://github.com/expo/eas-cli/pull/3582) by [@szdziedzic](https://github.com/szdziedzic))
+
+### 🐛 Bug fixes
+
+- [steps] Coerce numeric env values to strings in workflow step configuration. ([#3583](https://github.com/expo/eas-cli/pull/3583) by [@szdziedzic](https://github.com/szdziedzic))
+- [build-tools][eas-cli] Detect iOS Development provisioning profiles and set correct code signing identity instead of treating them as Ad Hoc. ([#3496](https://github.com/expo/eas-cli/pull/3496) by [@qwertey6](https://github.com/qwertey6))
+- [build-tools] Prevent detecting Yarn Modern as Classic based on lockfile ([#3572](https://github.com/expo/eas-cli/pull/3572) by [@kitten](https://github.com/kitten))
+- [build-tools] Early stop `eas/start_android_emulator` when Android emulator host setup is invalid. ([#3580](https://github.com/expo/eas-cli/pull/3580) by [@gwdp](https://github.com/gwdp))
+- [eas-cli] Bump `@expo/apple-utils` to `2.1.18` to fix `metadata:push` failing on `ageRatingDeclarations` due to the removed `gamblingAndContests` attribute. ([#3588](https://github.com/expo/eas-cli/pull/3588) by [@EvanBacon](https://github.com/EvanBacon))
+- [eas-cli] Bump `@expo/apple-utils` to `2.1.19` to fix image and video uploads via `metadata:push` getting stuck in `AWAITING_UPLOAD` state. The asset client was inheriting Bearer token injection from the App Store Connect API client, which caused S3 presigned URL uploads to be silently mishandled by Apple's CDN. Fixes screenshots, previews, and App Clip header image uploads. ([#3590](https://github.com/expo/eas-cli/pull/3590) by [@EvanBacon](https://github.com/EvanBacon))
+- [eas-cli] `metadata:pull` now preserves screenshot, video preview, and App Clip header image entries with placeholder paths when the asset is in an unrendered state, so users can recover broken records by replacing the file or removing the entry instead of having entries silently dropped from `store.config.json`. ([#3590](https://github.com/expo/eas-cli/pull/3590) by [@EvanBacon](https://github.com/EvanBacon))
+- [eas-cli] Surface hosting deployment's asset upload errors sooner ([#3600](https://github.com/expo/eas-cli/pull/3600) by [@kitten](https://github.com/kitten))
+
+## [18.5.0](https://github.com/expo/eas-cli/releases/tag/v18.5.0) - 2026-04-02
+
+### 🎉 New features
+
+- [eas-cli] Add screenshots and previews support to `metadata:push` and `metadata:pull`. ([#3301](https://github.com/expo/eas-cli/pull/3301) by [@EvanBacon](https://github.com/EvanBacon))
+- [eas-cli] Add `--non-interactive` flag to `metadata:push` and `metadata:pull` commands with ASC API Key auth support. ([#3548](https://github.com/expo/eas-cli/pull/3548) by [@EvanBacon](https://github.com/EvanBacon))
+- [eas-cli] Add `observe:metrics`, `observe:events`, and `observe:versions` commands. ([#3401](https://github.com/expo/eas-cli/pull/3401) by [@ubax](https://github.com/ubax)), [@douglowder](https://github.com/douglowder)
+
+### 🐛 Bug fixes
+
+- [eas-cli] Fix workflow:logs for builds using built-in EAS build steps. ([#3523](https://github.com/expo/eas-cli/pull/3523) by [@douglowder](https://github.com/douglowder))
+- [build-tools][worker] Read Expo app config with `expo config` CLI invocation before falling back to `@expo/config` ([#3536](https://github.com/expo/eas-cli/pull/3536) by [@kitten](https://github.com/kitten))
+- Fix `hasIgnoredIosProjectAsync()` always returning `false` for ignored iOS projects. ([#3562](https://github.com/expo/eas-cli/pull/3562) by [@sjchmiela](https://github.com/sjchmiela))
+
+### 🧹 Chores
+
+- Bump apple-utils. ([#3545](https://github.com/expo/eas-cli/pull/3545) by [@quinlanj](https://github.com/quinlanj))
+- [eas-cli][build-tools][worker] Bump `@expo/config` and `@expo/config-plugins`. ([#3527](https://github.com/expo/eas-cli/pull/3527) by [@quinlanj](https://github.com/quinlanj))
+
+## [18.4.0](https://github.com/expo/eas-cli/releases/tag/v18.4.0) - 2026-03-16
+
+### 🎉 New features
+
+- Auto-detect non-interactive mode in CI and non-TTY environments. ([#3486](https://github.com/expo/eas-cli/pull/3486) by [@EvanBacon](https://github.com/EvanBacon))
+- Add `skip-build-if-not-found` flag to `eas build:dev`. ([#3495](https://github.com/expo/eas-cli/pull/3495) by [@mmichels-brex](https://github.com/mmichels-brex))
+
+## [18.3.0](https://github.com/expo/eas-cli/releases/tag/v18.3.0) - 2026-03-10
+
+### 🎉 New features
+
+- Show user email in `eas account:view` output. ([#3485](https://github.com/expo/eas-cli/pull/3485) by [@brentvatne](https://github.com/brentvatne))
+
+## [18.2.0](https://github.com/expo/eas-cli/releases/tag/v18.2.0) - 2026-03-09
+
+### 🎉 New features
+
+- Auto-enable `--non-interactive` when `--json` is passed, so users no longer need to specify both flags. ([#3476](https://github.com/expo/eas-cli/pull/3476) by [@krystofwoldrich](https://github.com/krystofwoldrich))
+- Auto-generate Android keystore in non-interactive mode instead of throwing an error. ([#3477](https://github.com/expo/eas-cli/pull/3477) by [@EvanBacon](https://github.com/EvanBacon))
+- Add `--source-maps` flag to prevent uploading server sourcemaps ([#3478](https://github.com/expo/eas-cli/pull/3478) by [@hassankhan](https://github.com/hassankhan))
+
+### 🐛 Bug fixes
+
+- Check all certificates in provisioning profile during verification instead of only the first one. ([#3484](https://github.com/expo/eas-cli/pull/3484) by [@qwertey6](https://github.com/qwertey6))
+- Provide an override for the new --environment flag requirement in the update command. ([#3442](https://github.com/expo/eas-cli/pull/3442) by [@douglowder](https://github.com/douglowder))
+- Add missing `--include=dev` for `npm install` commands ([#3459](https://github.com/expo/eas-cli/pull/3459) by [@kitten](https://github.com/kitten))
+- Add missing `--production false` for `yarn install` commands for Yarn Classic ([#3459](https://github.com/expo/eas-cli/pull/3459) by [@kitten](https://github.com/kitten))
+
+### 🧹 Chores
+
+- Upgrade `oclif` to v4. ([#3472](https://github.com/expo/eas-cli/pull/3472) by [@sjchmiela](https://github.com/sjchmiela))
+
+## [18.1.0](https://github.com/expo/eas-cli/releases/tag/v18.1.0) - 2026-03-04
+
+### 🎉 New features
+
+- Support YAML anchors and aliases when parsing workflow files. ([#3435](https://github.com/expo/eas-cli/pull/3435) by [@sjchmiela](https://github.com/sjchmiela))
+
+### 🐛 Bug fixes
+
+- Remove --environment flag requirement for update:configure. ([#3440](https://github.com/expo/eas-cli/pull/3440) by [@douglowder](https://github.com/douglowder))
+- Fix login spinner interfering with prompts in `eas go` command when not logged in. ([#3451](https://github.com/expo/eas-cli/pull/3451) by [@byronkarlen](https://github.com/byronkarlen))
+
+## [18.0.6](https://github.com/expo/eas-cli/releases/tag/v18.0.6) - 2026-02-27
+
+## [18.0.5](https://github.com/expo/eas-cli/releases/tag/v18.0.5) - 2026-02-25
+
+### 🛠 Breaking changes
+
+- Require --environment flag for update commands when SDK >= 55. ([#3398](https://github.com/expo/eas-cli/pull/3398) by [@douglowder](https://github.com/douglowder))
+
+## [18.0.4](https://github.com/expo/eas-cli/releases/tag/v18.0.4) - 2026-02-23
+
+### 🐛 Bug fixes
+
+- Revert authorization code flow with PKCE for browser-based login. ([#3422](https://github.com/expo/eas-cli/pull/3422) by [@byronkarlen](https://github.com/byronkarlen))
+
+## [18.0.3](https://github.com/expo/eas-cli/releases/tag/v18.0.3) - 2026-02-20
+
+### 🎉 New features
+
+- Use authorization code flow with PKCE for browser-based login. ([#3398](https://github.com/expo/eas-cli/pull/3398) by [@byronkarlen](https://github.com/byronkarlen))
+
+## [18.0.1](https://github.com/expo/eas-cli/releases/tag/v18.0.1) - 2026-02-12
+
+### 🛠 Breaking changes
+
+- Drop support for Node 18 and Node 19. Require Node 20+. ([#3343](https://github.com/expo/eas-cli/pull/3343) by [@sjchmiela](https://github.com/sjchmiela))
+
+### 🎉 New features
+
+- Add `--browser` flag to `eas login` for browser-based authentication. ([#3312](https://github.com/expo/eas-cli/pull/3312) by [@byronkarlen](https://github.com/byronkarlen))
+
+### 🐛 Bug fixes
+
+- Hide progress bar in build credits warning when usage reaches 100%. ([#3371](https://github.com/expo/eas-cli/pull/3371) by [@mackenco](https://github.com/mackenco))
+
+### 🧹 Chores
+
+- Upgrade `tar` to v7. ([#3327](https://github.com/expo/eas-cli/pull/3327) by [@KarolRzeminski](https://github.com/KarolRzeminski))
+
+## [16.32.0](https://github.com/expo/eas-cli/releases/tag/v16.32.0) - 2026-01-30
+
+### 🎉 New features
+
+- List available options in non-interactive mode errors instead of generic "unable to select" messages, making CLI usable by agents and scripts. ([#3359](https://github.com/expo/eas-cli/pull/3359) by [@EvanBacon](https://github.com/EvanBacon))
+- Hidden beta version of new `eas account:usage` command for viewing account usage and billing estimates. ([#3334](https://github.com/expo/eas-cli/pull/3334) by [@douglowder](https://github.com/douglowder), [@EvanBacon](https://github.com/EvanBacon))
+- Add `--no-bytecode` and `--source-maps [mode]` flags to `eas update`. ([#3339](https://github.com/expo/eas-cli/pull/3339) by [@brentvatne](https://github.com/brentvatne))
+- Add App Clip bundle identifier registration support for multi-target iOS builds. ([#3300](https://github.com/expo/eas-cli/pull/3300) by [@evanbacon](https://github.com/evanbacon))
+- Warn in `eas build` when creating a production build from an app that uses Expo Go for development ([#3073](https://github.com/expo/eas-cli/pull/3073) by [@vonovak](https://github.com/vonovak))
+- Add `--runtime-version` and `--platform` filters to `eas update:list`. ([#3261](https://github.com/expo/eas-cli/pull/3261) by [@HarelSultan](https://github.com/HarelSultan))
+
+### 🐛 Bug fixes
+
+- Fix `--source-maps` flag compatibility with older SDKs that only support it as a boolean flag. ([#3341](https://github.com/expo/eas-cli/pull/3341) by [@brentvatne](https://github.com/brentvatne))
+- Use `--dump-sourcemaps` as fallback when `--source-maps` is not provided to `eas update`, for backwards compatibility. ([8cc324e1](https://github.com/expo/eas-cli/commit/8cc324e1) by [@brentvatne](https://github.com/brentvatne))
+- Fix `metadata:pull` failing for apps with only a live version by falling back to live app version and info. ([#3299](https://github.com/expo/eas-cli/pull/3299) by [@EvanBacon](https://github.com/EvanBacon))
+- eas init should fix and validate project name and slug. ([#3277](https://github.com/expo/eas-cli/pull/3277) by [@douglowder](https://github.com/douglowder))
+
+### 🧹 Chores
+
+- Test with node 24. ([#3270](https://github.com/expo/eas-cli/pull/3270) by [@wschurman](https://github.com/wschurman))
+- Delete channel in background. ([#3278](https://github.com/expo/eas-cli/pull/3278) by [@quinlanj](https://github.com/quinlanj))
+- Add warning to channel:delete. ([#3335](https://github.com/expo/eas-cli/pull/3335) by [@quinlanj](https://github.com/quinlanj))
+
+## [16.28.0](https://github.com/expo/eas-cli/releases/tag/v16.28.0) - 2025-11-20
+
+### 🎉 New features
+
+- `eas:new` sorts organization accounts first in account selection. ([#3256](https://github.com/expo/eas-cli/pull/3256) by [@mackenco](https://github.com/mackenco))
+
+### 🐛 Bug fixes
+
+- Fix `eas:build` bug where overages are checked before config is ready. ([#3260](https://github.com/expo/eas-cli/pull/3260) by [@mackenco](https://github.com/mackenco))
+
+### 🧹 Chores
+
+- Delete branch in background. ([#3258](https://github.com/expo/eas-cli/pull/3258) by [@quinlanj](https://github.com/quinlanj))
+
+## [16.27.0](https://github.com/expo/eas-cli/releases/tag/v16.27.0) - 2025-11-13
+
+### 🎉 New features
+
+- Kick off update patch generation if enabled - this is feature is in preview, don't use it for prod yet please. ([#3250](https://github.com/expo/eas-cli/pull/3250) by [@quinlanj](https://github.com/quinlanj))
+
+### 🐛 Bug fixes
+
+- Fix workflow:status when run ID passed in. ([#3253](https://github.com/expo/eas-cli/pull/3253) by [@douglowder](https://github.com/douglowder))
+- Fix updating file env vars with `env:update --non-interactive`. ([#3249](https://github.com/expo/eas-cli/pull/3249) by [@kadikraman](https://github.com/kadikraman))
+
+### 🧹 Chores
+
+- Fix yarn watch. ([#3251](https://github.com/expo/eas-cli/pull/3251) by [@quinlanj](https://github.com/quinlanj))
+- Remove the **node_modules** installation requirement for `workflow:run` command. ([#3254](https://github.com/expo/eas-cli/pull/3254) by [@kudo](https://github.com/kudo))
+
+## [16.26.0](https://github.com/expo/eas-cli/releases/tag/v16.26.0) - 2025-10-29
+
+### 🎉 New features
+
+- New command `workflow:status`. ([#3242](https://github.com/expo/eas-cli/pull/3242) by [@douglowder](https://github.com/douglowder))
+
+### 🧹 Chores
+
+- `eas:new` cleanup (remove `hidden` tag, fix README error, output cleanup). ([#3243](https://github.com/expo/eas-cli/pull/3243) by [@mackenco](https://github.com/mackenco))
+
+## [16.25.1](https://github.com/expo/eas-cli/releases/tag/v16.25.1) - 2025-10-28
+
+### 🧹 Chores
+
+- Remove preview label from EAS Hosting commands ([#3241](https://github.com/expo/eas-cli/pull/3241) by [@kitten](https://github.com/kitten))
+
+## [16.25.0](https://github.com/expo/eas-cli/releases/tag/v16.25.0) - 2025-10-27
+
+### 🎉 New features
+
+- `eas:new` command changes (project name prompt, output cleanup, additional project files, additional prompts). ([#3235](https://github.com/expo/eas-cli/pull/3235) by [@mackenco](https://github.com/mackenco))
+- `eas:build` command displays a warning when account is near it's build limit. ([#3236](https://github.com/expo/eas-cli/pull/3236) by [@mackenco](https://github.com/mackenco))
+
+### 🐛 Bug fixes
+
+- workflow:run can use --wait and --json together. ([#3239](https://github.com/expo/eas-cli/pull/3239) by [@douglowder](https://github.com/douglowder))
+- Add missing env for local builds with latest plugin. ([#3237](https://github.com/expo/eas-cli/pull/3237) by [@douglowder](https://github.com/douglowder))
+
+### 🧹 Chores
+
+- Document the default values for `track` and `releaseStatus`. ([#3229](https://github.com/expo/eas-cli/pull/3229) by [@kadikraman](https://github.com/kadikraman))
+
+## [16.24.1](https://github.com/expo/eas-cli/releases/tag/v16.24.1) - 2025-10-19
+
+### 🐛 Bug fixes
+
+- Revert change in ora version. ([#3231](https://github.com/expo/eas-cli/pull/3231) by [@douglowder](https://github.com/douglowder))
+
+## [16.24.0](https://github.com/expo/eas-cli/releases/tag/v16.24.0) - 2025-10-19
+
+### 🎉 New features
+
+- workflow:run --wait shows periodic job and step status updates. ([#3227](https://github.com/expo/eas-cli/pull/3227) by [@douglowder](https://github.com/douglowder))
+
+### 🐛 Bug fixes
+
+- workflow:logs should show logs from build and repack jobs. ([#3226](https://github.com/expo/eas-cli/pull/3226) by [@douglowder](https://github.com/douglowder))
+
+## [16.23.1](https://github.com/expo/eas-cli/releases/tag/v16.23.1) - 2025-10-16
+
+### 🐛 Bug fixes
+
+- Multiple bugfixes and small features for the `eas:new` command: handle project name and directory generation more smoothly; support `bun` as a package manager; add `--package-manager` flag with a default to `npm`; ensure workflow files are in the correct location after build; update the generated project's README with the provided package manager; ensure `app.json`'s `scheme` is valid; silence lots of noisy output. ([#3205](https://github.com/expo/eas-cli/pull/3205) by [@mackenco](https://github.com/mackenco))
+
+## [16.23.0](https://github.com/expo/eas-cli/releases/tag/v16.23.0) - 2025-10-14
+
+### 🎉 New features
+
+- Support custom environment variable environments ([#3220](https://github.com/expo/eas-cli/pull/3220) by [@kadikraman](https://github.com/kadikraman))
+- Add --force flag to eas env:push command to bypass confirmation prompts. ([#3135](https://github.com/expo/eas-cli/pull/3135) by [@giorgiofellipe](https://github.com/giorgiofellipe))
+
+## [16.22.0](https://github.com/expo/eas-cli/releases/tag/v16.22.0) - 2025-10-13
+
+### 🎉 New features
+
+- Improvements to workflow:create. ([#3194](https://github.com/expo/eas-cli/pull/3194) by [@douglowder](https://github.com/douglowder))
+
+## [16.21.0](https://github.com/expo/eas-cli/releases/tag/v16.21.0) - 2025-10-13
+
+### 🎉 New features
+
+- Support `_expo/.routes.json` metadata file exported by `@expo/cli` for headers configuration on static deployments ([#3211](https://github.com/expo/eas-cli/pull/3211) by [@kitten](https://github.com/kitten))
+
+### 🧹 Chores
+
+- Add thorough tests for the env commands ([#3217](https://github.com/expo/eas-cli/pull/3217) by [@kadikraman](https://github.com/kadikraman))
+
+## [16.20.4](https://github.com/expo/eas-cli/releases/tag/v16.20.4) - 2025-10-08
+
+### 🎉 New features
+
+- Allow workflow:run to run a workflow from a GitHub ref. ([#3203](https://github.com/expo/eas-cli/pull/3203) by [@douglowder](https://github.com/douglowder))
+
+### 🐛 Bug fixes
+
+- Fix --environment flag in eas exec and pull ([#3216](https://github.com/expo/eas-cli/pull/3216) by [@kadikraman](https://github.com/kadikraman))
+
+## [16.20.3](https://github.com/expo/eas-cli/releases/tag/v16.20.3) - 2025-10-07
+
+### 🐛 Bug fixes
+
+- Fix --environment flag in eas env commands ([#3213](https://github.com/expo/eas-cli/pull/3213) by [@kadikraman](https://github.com/kadikraman))
+
+## [16.20.2](https://github.com/expo/eas-cli/releases/tag/v16.20.2) - 2025-10-07
+
+### 🧹 Chores
+
+- Create an `EnvironmentVariableEnvironment` enum and use it instead of the graphQL Enum ([#3208](https://github.com/expo/eas-cli/pull/3208) by [@kadikraman](https://github.com/kadikraman))
+
+## [16.20.1](https://github.com/expo/eas-cli/releases/tag/v16.20.1) - 2025-10-03
+
+### 🐛 Bug fixes
+
+- skip syncing capabilities with settings if they don't contain the `enabled` attribute ([#3201](https://github.com/expo/eas-cli/pull/3201) by [@vonovak](https://github.com/vonovak))
+
+## [16.20.0](https://github.com/expo/eas-cli/releases/tag/v16.20.0) - 2025-09-30
+
+### 🎉 New features
+
+- Improvements to workflow:validate. ([#3165](https://github.com/expo/eas-cli/pull/3165) by [@douglowder](https://github.com/douglowder))
+- Add `eas:new` command behind `hidden` flag. ([#3196](https://github.com/expo/eas-cli/pull/3196) by [@mackenco](https://github.com/mackenco))
+
+## [16.19.3](https://github.com/expo/eas-cli/releases/tag/v16.19.3) - 2025-09-17
+
+### 🧹 Chores
+
+- Temporarily remove warnings when no compatible build found, need to refine the message. ([#3182](https://github.com/expo/eas-cli/pull/3182) by [@brentvatne](https://github.com/brentvatne))
+
+## [16.19.2](https://github.com/expo/eas-cli/releases/tag/v16.19.2) - 2025-09-15
+
+### 🎉 New features
+
+- Add artifact URLs to workflow:view. ([#3175](https://github.com/expo/eas-cli/pull/3175) by [@douglowder](https://github.com/douglowder))
+
+## [16.19.1](https://github.com/expo/eas-cli/releases/tag/v16.19.1) - 2025-09-12
+
+## [16.19.0](https://github.com/expo/eas-cli/releases/tag/v16.19.0) - 2025-09-12
+
+### 🎉 New features
+
+- Allow any string as Android release `track`, not just the `production`, `internal`, `alpha`, `beta`. ([#3163](https://github.com/expo/eas-cli/pull/3163) by [@sjchmiela](https://github.com/sjchmiela))
+
+## [16.18.1](https://github.com/expo/eas-cli/releases/tag/v16.18.1) - 2025-09-10
+
+### 🎉 New features
+
+- CLI debug log should respect DEBUG=`eas:*`. ([#3162](https://github.com/expo/eas-cli/pull/3162) by [@douglowder](https://github.com/douglowder))
+- Better description for update:rollback. ([#3154](https://github.com/expo/eas-cli/pull/3154) by [@douglowder](https://github.com/douglowder))
+
+## [16.18.0](https://github.com/expo/eas-cli/releases/tag/v16.18.0) - 2025-08-27
+
+### 🎉 New features
+
+- Show fingerprints in build:view and build:list commands. ([#3137](https://github.com/expo/eas-cli/pull/3137) by [@douglowder](https://github.com/douglowder))
+
+### 🐛 Bug fixes
+
+- Make `EXPO_PUBLIC_` env vars plain text, rest sensitive ([#3121](https://github.com/expo/eas-cli/pull/3121) by [@kadikraman](https://github.com/kadikraman))
+
+## [16.17.4](https://github.com/expo/eas-cli/releases/tag/v16.17.4) - 2025-07-31
+
+### 🧹 Chores
+
+- Introduce new release process and workflow. ([#3119](https://github.com/expo/eas-cli/pull/3119) by [@douglowder](https://github.com/douglowder))
+- SSO Login: print browser url ([#3113](https://github.com/expo/eas-cli/pull/3113) by [@BackSlasher](https://github.com/BackSlasher))
+
+## [16.17.2](https://github.com/expo/eas-cli/releases/tag/v16.17.2) - 2025-07-23
+
 ## [16.17.1](https://github.com/expo/eas-cli/releases/tag/v16.17.1) - 2025-07-23
 
 ## [16.17.0](https://github.com/expo/eas-cli/releases/tag/v16.17.0) - 2025-07-18
@@ -1387,7 +1854,6 @@ This is the log of notable changes to EAS CLI and related packages.
 - Add rollback disambiguation command. ([#2004](https://github.com/expo/eas-cli/pull/2004) by [@wschurman](https://github.com/wschurman))
 - Detect devices that fail to be provisioned, list them to the user and show the explanation message with the link to the devices page to check actual status. ([#2011](https://github.com/expo/eas-cli/pull/2011) by [@radoslawkrzemien](https://github.com/radoslawkrzemien))
 - Add info to EAS Update asset upload process about asset counts and limits. ([#2013](https://github.com/expo/eas-cli/pull/2013) by [@wschurman](https://github.com/wschurman))
-- .nvmrc support for setting node version. ([#1954](https://github.com/expo/eas-cli/pull/1954) by [@khamilowicz](https://github.com/khamilowicz))
 
 ### 🐛 Bug fixes
 

CLAUDE.md

@@ -0,0 +1,355 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Monorepo Structure
+
+This is a **Lerna-based monorepo** containing the EAS CLI and all supporting build libraries.
+
+### CLI & Configuration Packages
+
+1. **[packages/eas-cli](./packages/eas-cli/CLAUDE.md)** - The main CLI tool (published as `eas-cli`)
+   - 95+ commands organized by domain (build, submit, update, channel, credentials, etc.)
+   - Built on oclif (Open CLI Framework)
+   - Entry point: `packages/eas-cli/bin/run`
+
+2. **[packages/eas-json](./packages/eas-json/CLAUDE.md)** - EAS configuration parser (published as `@expo/eas-json`)
+   - Validates `eas.json` configuration files using Joi schemas
+   - Manages build, submit, and deploy profiles
+   - Supports JSON5 via golden-fleece
+
+3. **[packages/eas-build-cache-provider](./packages/eas-build-cache-provider/CLAUDE.md)** - Build cache plugin (published as `eas-build-cache-provider`)
+   - Optimizes build caching for Expo CLI
+
+### Build Execution Packages
+
+4. **[packages/eas-build-job](./packages/eas-build-job)** - Build job definitions (published as `@expo/eas-build-job`)
+   - Defines all data structures for build operations (Job, BuildPhase, BuildMode, Platform, Workflow)
+   - Provides type definitions and validation schemas (Zod, Joi)
+   - Contains BuildPhase enum that defines the traditional build pipeline stages
+   - Key exports: `Job`, `BuildPhase`, `BuildMode`, `BuildTrigger`, `Workflow`, `ArchiveSource`
+   - **Foundation that all other build packages depend on**
+
+5. **[packages/build-tools](./packages/build-tools)** - Build execution engine (published as `@expo/build-tools`)
+   - Orchestrates all build operations through `BuildContext<T extends Job>`
+   - Contains platform-specific builders: `androidBuilder()`, `iosBuilder()`, `runCustomBuildAsync()`
+   - Manages build phases, artifact uploading, caching, credentials
+   - Provides functions for custom builds
+   - Integrates with GraphQL API
+
+6. **[packages/steps](./packages/steps)** - Custom build workflow engine (published as `@expo/steps`)
+   - Framework for defining and executing custom build steps
+   - Key abstractions:
+     - `BuildWorkflow`: Orchestrates sequential step execution
+     - `BuildStep`: Individual executable unit with inputs/outputs
+     - `BuildStepGlobalContext`: Manages shared state and interpolation
+     - `BuildStepContext`: Per-step execution context
+   - Supports conditional execution with `if` expressions (using jsep)
+   - Template interpolation: `${{ steps.step-id.outputs.outputName }}`
+   - Parses build configs from YAML/JSON
+
+7. **[packages/local-build-plugin](./packages/local-build-plugin)** - Local build execution (published as `eas-cli-local-build-plugin`)
+   - Allows running EAS builds locally on developer machines
+   - Entry point: `packages/local-build-plugin/src/main.ts`
+   - Sets `EAS_BUILD_RUNNER=local-build-plugin` environment variable
+   - Reuses all build-tools logic for consistency with cloud builds
+
+8. **[packages/worker](./packages/worker/CLAUDE.md)** - Turtle Worker service (private, not published)
+   - Runs on EAS build VMs/pods
+   - WebSocket server for communication with Turtle Launcher
+   - Wraps `@expo/build-tools` to execute actual React Native builds
+
+### Supporting Packages
+
+9. **[packages/logger](./packages/logger)** - Bunyan-based structured logging (published as `@expo/logger`)
+   - Used by all build packages
+
+10. **[packages/downloader](./packages/downloader)** - HTTP file downloading with retry logic (published as `@expo/downloader`)
+
+11. **[packages/turtle-spawn](./packages/turtle-spawn)** - Child process spawning with error handling (published as `@expo/turtle-spawn`)
+
+12. **[packages/template-file](./packages/template-file)** - Lodash-based template string interpolation (published as `@expo/template-file`)
+
+13. **[packages/create-eas-build-function](./packages/create-eas-build-function)** - CLI scaffolding tool for custom build functions (published as `create-eas-build-function`)
+
+14. **[packages/expo-cocoapods-proxy](./packages/expo-cocoapods-proxy)** - Ruby gem for CocoaPods proxy (published as `expo-cocoapods-proxy` gem)
+
+> **Note**: Some packages have their own CLAUDE.md with package-specific guidance. Click the links above to view them.
+
+## Common Development Commands
+
+### Setup
+
+```bash
+yarn install        # Install all dependencies
+yarn build          # Build all packages in the monorepo
+```
+
+### Development
+
+```bash
+yarn start          # Watch mode with parallel builds across all packages
+yarn watch          # Alias for start
+
+# Development with relaxed TypeScript rules (allows unused variables)
+yarn start-allow-unused
+```
+
+### Testing
+
+```bash
+yarn run -T lerna run test               # Run all tests across packages
+yarn run -T lerna run test -- --watch    # Watch mode across packages (heavier)
+#
+# If you use `yarn test`, remember to pass args through two separators:
+# yarn test -- -- --watch
+
+# Run tests for a specific package
+cd packages/eas-cli && yarn test
+cd packages/eas-json && yarn test
+cd packages/worker && yarn test
+cd packages/build-tools && yarn test
+cd packages/steps && yarn test
+```
+
+### Type Checking & Linting
+
+```bash
+yarn typecheck      # TypeScript type check all packages
+yarn lint           # Oxlint across all packages
+yarn fmt:check      # Oxfmt format check
+```
+
+### Running EAS CLI Locally
+
+```bash
+# From repository root:
+yarn eas <command>  # Run via root package script
+
+# Or use the binary directly:
+packages/eas-cli/bin/run <command>
+
+# Recommended: Create an alias for development
+alias easd="$(pwd)/packages/eas-cli/bin/run"
+easd build --help
+```
+
+### Local Build Testing
+
+Set up environment variables for testing local builds:
+
+```bash
+export EAS_LOCAL_BUILD_PLUGIN_PATH=$HOME/expo/eas-cli/bin/eas-cli-local-build-plugin
+export EAS_LOCAL_BUILD_WORKINGDIR=$HOME/expo/eas-build-workingdir
+export EAS_LOCAL_BUILD_SKIP_CLEANUP=1
+export EAS_LOCAL_BUILD_ARTIFACTS_DIR=$HOME/expo/eas-build-workingdir/results
+
+# Then run build with --local flag in eas-cli
+eas build --local
+```
+
+## Build System
+
+Each package has independent TypeScript compilation:
+
+- `eas-cli`: `src/` → `build/`
+- `eas-json`: `src/` → `build/`
+- `eas-build-cache-provider`: `src/` → `build/`
+- `worker`: `src/` → `dist/`
+- `build-tools`: `src/` → `dist/`
+- `eas-build-job`: `src/` → `dist/`
+- `steps`: `src/` → `dist/` (CommonJS only)
+- `local-build-plugin`: `src/` → `dist/`
+- Other packages: `src/` → `dist/`
+
+TypeScript configs:
+
+- `tsconfig.json` - Base configuration (extends @tsconfig/node20)
+- `tsconfig.build.json` - Production builds
+- `tsconfig.allowUnused.json` - Development with relaxed rules
+
+## Key Architectural Patterns
+
+### Build Phases
+
+Most traditional build operations are wrapped in phases for tracking:
+
+```typescript
+await ctx.runBuildPhase(BuildPhase.INSTALL_DEPENDENCIES, async () => {
+  // Phase logic here
+});
+```
+
+Phases can be marked as skipped, warning, or failed for granular reporting.
+
+### Context Objects
+
+- **BuildContext** (`build-tools`): For traditional builds, wraps Job, manages phases/artifacts/caching
+- **CustomBuildContext** (`build-tools`): Implements `ExternalBuildContextProvider`, bridges BuildContext to steps framework, used in custom builds and generic jobs
+- **BuildStepGlobalContext** (`steps`): Manages step outputs, interpolation, shared state
+- **BuildStepContext** (`steps`): Per-step context with working directory and logger
+
+### Custom Build Steps
+
+Steps are defined with:
+
+- `id`: Unique identifier
+- `name`: Display name
+- `run`: Command or function reference
+- `if`: Optional condition (`${{ always() }}`, `${{ success() }}`, etc.)
+- `inputs`: Key-value inputs to the step
+- `outputs`: Named outputs accessible to later steps
+
+Built-in step functions are in `packages/build-tools/src/steps/functions/`
+
+### Conditional Execution
+
+Uses jsep for expression evaluation:
+
+```yaml
+if: ${{ steps.previous_step.outputs.success == 'true' && env.ENVIRONMENT == 'production' }}
+```
+
+### Artifact Management
+
+Artifacts tracked as `ArtifactToUpload`:
+
+- Managed artifacts (APK, IPA, AAB) with specific handling
+- Generic artifacts for any file
+- Upload via `ctx.uploadArtifact()` or `upload-artifact` step
+
+## Package Interdependencies
+
+```
+eas-cli → @expo/eas-json
+       → @expo/build-tools → @expo/eas-build-job
+                           → @expo/steps → @expo/eas-build-job
+                           → @expo/logger
+                           → @expo/turtle-spawn
+                           → @expo/downloader
+                           → @expo/template-file
+
+local-build-plugin → @expo/build-tools → @expo/eas-build-job
+                   → @expo/turtle-spawn
+
+worker → @expo/build-tools
+```
+
+Most packages depend on `@expo/eas-build-job` as the source of truth for types.
+
+## Testing Architecture
+
+- **Framework**: Jest with per-package configuration
+- **Shared base config**: `jest/jest.shared.config.ts`
+- **Test locations**: `__tests__/` directories alongside source files
+- **Mocking**:
+  - File system: `memfs`
+  - HTTP: `nock`
+  - Utilities: `ts-mockito`, `mockdate`
+
+Run a single test file:
+
+```bash
+cd packages/eas-cli && yarn test <path-to-test-file>
+# Example:
+cd packages/eas-cli && yarn test src/project/__tests__/projectUtils-test.ts
+```
+
+## Common Development Scenarios
+
+### Adding a Built-in Step Function
+
+1. Create file in `packages/build-tools/src/steps/functions/yourFunction.ts`
+2. Export `createYourFunctionBuildFunction()` following existing patterns
+3. Add to `getEasFunctions()` in `packages/build-tools/src/steps/functions/easFunctions.ts`
+4. Function receives `BuildStepContext` and input/output maps
+
+### Adding Error Detection
+
+1. Add pattern detection in `packages/build-tools/src/buildErrors/detectError.ts`
+2. Implement resolver for better error messages
+3. Helps users understand and fix build failures
+
+### Working with Platform-Specific Builders
+
+- **Android builder** (`packages/build-tools/src/builders/android.ts`): Gradle-based, handles APK/AAB generation, also see `functionGroups/build.ts`
+- **iOS builder** (`packages/build-tools/src/builders/ios.ts`): Fastlane/Xcode-based, handles IPA generation, also see `functionGroups/build.ts`
+- Both use `runBuilderWithHooksAsync()` which runs build result hooks (on-success, on-error, on-complete) from package.json
+
+### Introducing Breaking Changes to Job API (@expo/eas-build-job)
+
+If you want to introduce breaking changes to the `@expo/eas-build-job` package, contact one of the CODEOWNERS to coordinate changes with EAS build servers and GraphQL API. Describe what changes you want to make and why. After everything is deployed to production, you can introduce a PR that relies on the new implementation.
+
+## Environment Variables
+
+```bash
+# API Configuration
+export EXPO_STAGING=1   # Use staging API (https://staging-api.expo.dev)
+export EXPO_LOCAL=1     # Use local API (http://127.0.0.1:3000)
+
+# Development
+export EAS_NO_VCS=1     # Disable version control checks
+export EXPO_DEBUG=1     # Enable debug logging
+```
+
+## Code Style & Conventions
+
+### Validation
+
+All changes should be validated before committing. At minimum run package-level tests (e.g. `jest-unit`)
+for touched code, then run type checks/linting and format the repo:
+
+```bash
+yarn fmt            # Apply Oxfmt formatting
+yarn typecheck      # Validate TypeScript types
+yarn lint           # Run Oxlint
+yarn fmt:check      # Run Oxfmt format check
+```
+
+### Logging
+
+Use the `Log` module from `@expo/logger`:
+
+```typescript
+import { Log } from '@expo/logger';
+
+Log.log('Info message');
+Log.warn('Warning message');
+Log.error('Error message');
+```
+
+### Pull Request conventions
+
+When creating pull requests, make sure to adhere to [PULL_REQUEST_TEMPLATE](./.github/PULL_REQUEST_TEMPLATE).
+
+### Commit Messages
+
+- When possible, prepend commit messages with `[PACKAGE-BEING-CHANGED]`, e.g. `[steps] Add new step function`
+- Do not use prefixes like `chore:` and `feat:`
+- Commit messages should be concise. Only complex changes should be longer than one line
+- Commit changes in logical groups
+
+## Release Process
+
+1. Update `CHANGELOG.md` in the appropriate package
+2. Version bump is automated based on changelog:
+   - Breaking changes → MAJOR
+   - New features → MINOR
+   - Otherwise → PATCH
+3. GitHub Actions workflow handles release automation
+4. Notifications sent to Slack #eas-cli channel
+
+## Licensing
+
+This repository contains packages under different licenses:
+
+- **MIT License**: `eas-cli`, `@expo/eas-json`, `@expo/eas-build-job`, `eas-build-cache-provider`
+- **BUSL-1.1 (Business Source License)**: `@expo/build-tools`, `@expo/steps`, `@expo/logger`, `@expo/downloader`, `@expo/turtle-spawn`, `@expo/template-file`, `eas-cli-local-build-plugin`
+
+See `LICENSE` (MIT) and `LICENSE-BUSL` (BUSL-1.1) for details.
+
+## Important Notes
+
+- **Node Version**: Requires Node.js (managed via Mise)
+- **Package Manager**: Uses Yarn 4.12.0
+- **Compilation Target**: CommonJS with Node resolution

CONTRIBUTING.md

@@ -1,12 +1,21 @@
 # Development
 
-Set up an alias for the EAS CLI so you can try it in projects all around your computer. The project is compiled on the fly so you don't need to run a build (watch) command.
+## Getting Started
 
-> The only exception is when you just cloned the repository or there have been changes in `packages/eas-json`. In that case, you'll have to run `yarn build` in the root.
+If this is your first time running `eas-cli` locally, make sure you install and build the packages. In the project root, run:
+
+```sh
+yarn install
+yarn build
+```
+
+From there, set up an alias for the EAS CLI so you can try it in projects all around your computer. The project is compiled on the fly so you don't need to run a build (watch) command.
+
+> The only exception is if there have been changes in `packages/eas-json`. In that case, you'll have to run `yarn build` in the root.
 
 Open your `.zshrc` or other config file and add:
 
-```
+```sh
 alias easd="/PATH/TO/eas-cli/bin/run"
 ```
 
@@ -14,7 +23,7 @@ Then use it with `easd` like `easd build`.
 
 If you're making changes to `packages/eas-json` or prefer/need to work with production code, start the build command in watch mode with:
 
-```
+```sh
 yarn start
 ```
 
@@ -33,7 +42,7 @@ If it is easier for you to work with the code locally with compiler options set
 
 you can consider using:
 
-```
+```sh
 yarn start-allow-unused
 ```
 
@@ -56,11 +65,11 @@ For development against staging API:
 
 ## Working on local builds (`eas build --local`)
 
-See https://github.com/expo/eas-build/blob/main/DEVELOPMENT.md for how to set up your environment when making changes to [`eas-cli-local-build-plugin`](https://github.com/expo/eas-build/tree/main/packages/local-build-plugin) and/or [`build-tools`](https://github.com/expo/eas-build/tree/main/packages/build-tools).
+See [`CLAUDE.md`](./CLAUDE.md) for how to set up your environment when making changes to [`eas-cli-local-build-plugin`](./packages/local-build-plugin) and/or [`build-tools`](./packages/build-tools).
 
 ## Testing
 
-Run `yarn test` either in the repository root or in a package directory that you're working on.
+From the repository root, run `yarn run -T lerna run test`. For a single package, run `yarn test` in that package directory.
 
 ## Releasing
 

LICENSE-BUSL

@@ -0,0 +1,100 @@
+Business Source License 1.1
+
+Parameters
+
+Licensor:             650 Industries, Inc.
+Licensed Work:        EAS Build
+                      The Licensed Work is (c) 2021 650 Industries, Inc.
+Additional Use Grant: You may make use of the Licensed Work, provided that you do
+                      not use the Licensed Work for commercial offerings such as
+                      a CI/CD service or application build service that allows
+                      third parties (other than your employees and contractors)
+                      to access the functionality of and directly benefit from the
+                      functionality of the Licensed Work.
+
+Change Date:          2028-04-01
+
+Change License:       MIT
+
+For information about alternative licensing arrangements for the Software,
+please visit: https://expo.dev/pricing/
+
+Notice
+
+The Business Source License (this document, or the "License") is not an Open
+Source license. However, the Licensed Work will eventually be made available
+under an Open Source License, as stated in this License.
+
+License text copyright (c) 2017 MariaDB Corporation Ab, All Rights Reserved.
+"Business Source License" is a trademark of MariaDB Corporation Ab.
+
+-----------------------------------------------------------------------------
+
+Business Source License 1.1
+
+Terms
+
+The Licensor hereby grants you the right to copy, modify, create derivative
+works, redistribute, and make non-production use of the Licensed Work. The
+Licensor may make an Additional Use Grant, above, permitting limited
+production use.
+
+Effective on the Change Date, or the fourth anniversary of the first publicly
+available distribution of a specific version of the Licensed Work under this
+License, whichever comes first, the Licensor hereby grants you rights under
+the terms of the Change License, and the rights granted in the paragraph
+above terminate.
+
+If your use of the Licensed Work does not comply with the requirements
+currently in effect as described in this License, you must purchase a
+commercial license from the Licensor, its affiliated entities, or authorized
+resellers, or you must refrain from using the Licensed Work.
+
+All copies of the original and modified Licensed Work, and derivative works
+of the Licensed Work, are subject to this License. This License applies
+separately for each version of the Licensed Work and the Change Date may vary
+for each version of the Licensed Work released by Licensor.
+
+You must conspicuously display this License on each original or modified copy
+of the Licensed Work. If you receive the Licensed Work in original or
+modified form from a third party, the terms and conditions set forth in this
+License apply to your use of that work.
+
+Any use of the Licensed Work in violation of this License will automatically
+terminate your rights under this License for the current and all other
+versions of the Licensed Work.
+
+This License does not grant you any right in any trademark or logo of
+Licensor or its affiliates (provided that you may use a trademark or logo of
+Licensor as expressly required by this License).
+
+TO THE EXTENT PERMITTED BY APPLICABLE LAW, THE LICENSED WORK IS PROVIDED ON
+AN "AS IS" BASIS. LICENSOR HEREBY DISCLAIMS ALL WARRANTIES AND CONDITIONS,
+EXPRESS OR IMPLIED, INCLUDING (WITHOUT LIMITATION) WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, NON-INFRINGEMENT, AND
+TITLE.
+
+MariaDB hereby grants you permission to use this License’s text to license
+your works, and to refer to it using the trademark "Business Source License",
+as long as you comply with the Covenants of Licensor below.
+
+Covenants of Licensor
+
+In consideration of the right to use this License’s text and the "Business
+Source License" name and trademark, Licensor covenants to MariaDB, and to all
+other recipients of the licensed work to be provided by Licensor:
+
+1. To specify as the Change License the GPL Version 2.0 or any later version,
+   or a license that is compatible with GPL Version 2.0 or a later version,
+   where "compatible" means that software provided under the Change License can
+   be included in a program with software provided under GPL Version 2.0 or a
+   later version. Licensor may specify additional Change Licenses without
+   limitation.
+
+2. To either: (a) specify an additional grant of rights to use that does not
+   impose any additional restriction on the right granted in this License, as
+   the Additional Use Grant; or (b) insert the text "None".
+
+3. To specify a Change Date.
+
+4. Not to modify this License in any other way.

LICENSE-eas-build-job

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2020-present 650 Industries, Inc. (aka Expo)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

RELEASING.md

@@ -1,6 +1,6 @@
 # Releasing EAS CLI
 
-1. Run `yarn release` in the repository root folder. The next version is chosen automatically based on the changelog entries. If you want to use different version, pass the version string as a positional argument to the command, e.g. `yarn release 1.2.3`.
+1. Invoke the GitHub workflow ["Manually trigger a release"](https://github.com/expo/eas-cli/actions/workflows/trigger-release.yml). The next version is chosen automatically based on the changelog entries. If you want to use different version, pass the version string as an input to the workflow, in semver format, e.g. "1.2.3"
 2. That's it! GitHub Actions is going to take care of the rest. Watch the #eas-cli Slack channel for a successful release notification.
 
 ## Choosing the next version

bin/eas-cli-local-build-plugin

@@ -0,0 +1 @@
+../packages/local-build-plugin/bin/run

jest.config.ts

@@ -1,15 +0,0 @@
-import type { Config } from 'jest';
-
-// eslint-disable-next-line import/no-relative-packages
-import easCliConfig from './packages/eas-cli/jest.config';
-// eslint-disable-next-line import/no-relative-packages
-import easJsonConfig from './packages/eas-json/jest.config';
-
-const config: Config = {
-  projects: [easCliConfig, easJsonConfig],
-  testPathIgnorePatterns: ['.*'],
-  watchPlugins: ['jest-watch-typeahead/filename', 'jest-watch-typeahead/testname'],
-  collectCoverageFrom: ['<rootDir>/src/**/*.{ts,tsx,js,jsx}'],
-};
-
-export default config;

jest/jest.config.ts

@@ -1,9 +0,0 @@
-import type { Config } from 'jest';
-
-const config: Config = {
-  preset: 'ts-jest',
-  testEnvironment: 'node',
-  testRegex: '/__tests__/.*(test|spec)\\.[jt]sx?$',
-};
-
-export default config;

jest/jest.shared.config.ts

@@ -0,0 +1,8 @@
+import type { Config } from '@jest/types';
+
+const config: Config.InitialOptions = {
+  preset: 'ts-jest',
+  testEnvironment: 'node',
+};
+
+export default config;

lerna.json

@@ -1,5 +1,5 @@
 {
   "npmClient": "yarn",
-  "version": "16.17.2",
+  "version": "19.0.1",
   "$schema": "node_modules/lerna/schemas/lerna-schema.json"
-}
+}

mise.toml

@@ -0,0 +1,6 @@
+[env]
+_.path = "./tools/bin"
+MISE_NODE_COREPACK = "true"
+
+[tools]
+node = "20.19.4"

package.json

@@ -6,36 +6,33 @@
   ],
   "scripts": {
     "build": "lerna run build",
-    "build:tarballs:linux": "yarn build-for-size-check",
-    "build-for-size-check": "yarn build && yarn workspace eas-cli pretarball-ci && CLI_SIZE_CHECK=1 yarn workspace eas-cli oclif pack:tarballs --no-xz --targets linux-x64",
     "typecheck": "lerna run typecheck",
     "start": "lerna run watch --stream --parallel",
     "start-allow-unused": "lerna run watch-allow-unused --stream --parallel",
     "watch": "yarn start",
     "eas": "packages/eas-cli/bin/run",
-    "lint": "eslint .",
+    "lint": "oxlint --type-aware --import-plugin --tsconfig ./tsconfig.oxlint.json .",
+    "fmt": "oxfmt .",
+    "fmt:check": "oxfmt --check .",
     "lint-changelog": "./scripts/bin/run lint-changelog",
-    "release": "lerna run rebuild && ./scripts/bin/run release",
-    "test": "jest",
-    "clean": "lerna run clean && rm -rf node_modules coverage"
+    "release": "lerna run rebuild --concurrency 1 && ./scripts/bin/run release",
+    "test": "lerna run test",
+    "clean": "lerna run clean && rimraf node_modules coverage"
   },
   "devDependencies": {
     "@types/jest": "29.5.11",
-    "@types/node": "20.11.0",
-    "eslint": "8.56.0",
-    "eslint-config-universe": "13.0.0",
+    "@types/node": "20.14.8",
     "eslint-plugin-async-protect": "3.1.0",
-    "eslint-plugin-node": "11.1.0",
     "jest": "29.7.0",
     "jest-watch-typeahead": "2.2.2",
-    "lerna": "8.2.3",
-    "oclif": "^3.9.0",
-    "prettier": "3.1.1",
+    "lerna": "9.0.3",
+    "oclif": "^4.22.85",
+    "oxfmt": "0.28.0",
+    "oxlint": "1.43.0",
+    "oxlint-tsgolint": "0.11.1",
+    "rimraf": "3.0.2",
     "ts-jest": "29.1.1",
-    "typescript": "5.3.3"
+    "typescript": "5.5.4"
   },
-  "volta": {
-    "node": "20.11.0",
-    "yarn": "1.22.21"
-  }
+  "packageManager": "[email protected]"
 }

packages/build-tools/.gitignore

@@ -0,0 +1,9 @@
+node_modules/
+dist/
+
+.secrets*
+!.secrets.example
+!.secrets.test
+
+src/graphql-env.d.ts
+schema.graphql

packages/build-tools/.oxlintrc.json

@@ -0,0 +1,17 @@
+{
+  "extends": ["../../.oxlintrc.json"],
+  "jsPlugins": [
+    {
+      "name": "async-protect",
+      "specifier": "eslint-plugin-async-protect"
+    }
+  ],
+  "rules": {
+    "async-protect/async-suffix": "off",
+    "no-underscore-dangle": "off",
+    "node/no-sync": "off",
+    "no-console": "off",
+    "no-void": "off",
+    "no-restricted-imports": "off"
+  }
+}

packages/build-tools/README.md

@@ -0,0 +1,7 @@
+# @expo/build-tools
+
+`@expo/build-tools` is the core library for the EAS Build service. It implements the build process for React Native projects and for managed Expo applications.
+
+## Repository
+
+https://github.com/expo/eas-cli/tree/main/packages/build-tools

packages/build-tools/bin/set-env

@@ -0,0 +1,23 @@
+#!/usr/bin/env bash
+
+set -eo pipefail
+
+NAME=$1
+VALUE=$2
+
+if [[ -z "$__EAS_BUILD_ENVS_DIR" ]]; then
+  echo "Set __EAS_BUILD_ENVS_DIR"
+  exit 1
+fi
+
+if [[ -z "$NAME" || -z "$VALUE" ]]; then
+  echo "Usage: set-env NAME VALUE"
+  exit 2
+fi
+
+if [[ "$NAME" == *"="* ]]; then
+  echo "Environment name can't include ="
+  exit 1
+fi
+
+echo -n $VALUE > $__EAS_BUILD_ENVS_DIR/$NAME

packages/build-tools/jest/integration-config.ts

@@ -0,0 +1,13 @@
+import type { Config } from '@jest/types';
+
+import baseConfig from '../../../jest/jest.shared.config';
+
+const config: Config.InitialOptions = {
+  ...baseConfig,
+  rootDir: '../src',
+  testMatch: ['**/__integration-tests__/*.test.ts'],
+  clearMocks: true,
+  setupFilesAfterEnv: ['<rootDir>/../jest/setup-tests.ts'],
+};
+
+export default config;

packages/build-tools/jest/setup-tests.ts

@@ -0,0 +1,20 @@
+import { fs, vol } from 'memfs';
+import os from 'node:os';
+
+if (process.env.NODE_ENV !== 'test') {
+  throw new Error("NODE_ENV environment variable must be set to 'test'.");
+}
+
+// Always mock:
+jest.mock('fs');
+jest.mock('node:fs', () => fs);
+jest.mock('fs/promises');
+jest.mock('node:fs/promises', () => fs.promises);
+jest.mock('node-fetch');
+
+beforeEach(() => {
+  vol.reset();
+  vol.fromNestedJSON({
+    [os.tmpdir()]: {},
+  });
+});

packages/build-tools/jest/unit-config.ts

@@ -0,0 +1,16 @@
+import type { Config } from '@jest/types';
+
+import baseConfig from '../../../jest/jest.shared.config';
+
+const config: Config.InitialOptions = {
+  ...baseConfig,
+  rootDir: '../src',
+  testMatch: [
+    '**/__tests__/*.test.ts',
+    ...(process.platform === 'darwin' ? ['**/__tests__/*.test.ios.ts'] : []),
+  ],
+  clearMocks: true,
+  setupFilesAfterEnv: ['<rootDir>/../jest/setup-tests.ts'],
+};
+
+export default config;

packages/build-tools/package.json

@@ -0,0 +1,102 @@
+{
+  "name": "@expo/build-tools",
+  "version": "19.0.0",
+  "bugs": "https://github.com/expo/eas-cli/issues",
+  "license": "BUSL-1.1",
+  "author": "Expo <[email protected]>",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/expo/eas-cli.git",
+    "directory": "packages/build-tools"
+  },
+  "files": [
+    "dist",
+    "resources",
+    "templates",
+    "bin"
+  ],
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "start": "yarn watch",
+    "prewatch": "yarn gql",
+    "watch": "tsc --watch --preserveWatchOutput",
+    "prebuild": "yarn gql",
+    "build": "tsc",
+    "typecheck": "tsc",
+    "prepack": "rimraf dist \"*.tsbuildinfo\" && yarn gql && tsc -p tsconfig.build.json",
+    "jest-unit": "jest --config jest/unit-config.ts",
+    "jest-integration": "jest --config jest/integration-config.ts",
+    "jest-unit-watch": "jest --config jest/unit-config.ts --watch",
+    "jest-integration-watch": "jest --config jest/integration-config.ts --watch",
+    "clean": "rimraf node_modules dist coverage \"*.tsbuildinfo\"",
+    "gql": "gql.tada generate-schema ${API_SERVER_URL:-https://api.expo.dev}/graphql --output ./schema.graphql && gql.tada generate-output",
+    "gql:local": "API_SERVER_URL=http://api.expo.test yarn gql",
+    "test": "yarn jest-unit"
+  },
+  "dependencies": {
+    "@expo/config": "55.0.10",
+    "@expo/config-plugins": "55.0.7",
+    "@expo/downloader": "19.0.0",
+    "@expo/eas-build-job": "19.0.0",
+    "@expo/env": "^0.4.0",
+    "@expo/logger": "19.0.0",
+    "@expo/package-manager": "1.9.10",
+    "@expo/plist": "^0.2.0",
+    "@expo/results": "^1.0.0",
+    "@expo/spawn-async": "1.7.2",
+    "@expo/steps": "19.0.0",
+    "@expo/template-file": "19.0.0",
+    "@expo/turtle-spawn": "19.0.0",
+    "@expo/xcpretty": "^4.3.1",
+    "@google-cloud/storage": "^7.11.2",
+    "@sentry/node": "7.77.0",
+    "@urql/core": "^6.0.1",
+    "bplist-parser": "0.3.2",
+    "fast-glob": "^3.3.2",
+    "fast-xml-parser": "^4.4.1",
+    "fs-extra": "^11.2.0",
+    "gql.tada": "^1.8.13",
+    "joi": "^17.13.1",
+    "jose": "5.10.0",
+    "lodash": "^4.17.21",
+    "node-fetch": "^2.7.0",
+    "node-forge": "^1.3.1",
+    "node-stream-zip": "1.15.0",
+    "nullthrows": "^1.1.1",
+    "plist": "^3.1.0",
+    "promise-limit": "^2.7.0",
+    "promise-retry": "^2.0.1",
+    "resolve-from": "^5.0.0",
+    "retry": "^0.13.1",
+    "semver": "^7.6.2",
+    "tar": "7.5.7",
+    "uuid": "9.0.1",
+    "yaml": "^2.8.1",
+    "zod": "^4.3.5"
+  },
+  "devDependencies": {
+    "@expo/repack-app": "~0.4.1",
+    "@types/fs-extra": "^11.0.4",
+    "@types/jest": "^29.5.12",
+    "@types/lodash": "^4.17.4",
+    "@types/node": "20.14.2",
+    "@types/node-fetch": "^2.6.11",
+    "@types/node-forge": "^1.3.11",
+    "@types/plist": "^3.0.5",
+    "@types/promise-retry": "^1.1.6",
+    "@types/retry": "^0.12.5",
+    "@types/semver": "^7.5.8",
+    "@types/uuid": "^9.0.8",
+    "bunyan": "^1.8.15",
+    "jest": "^29.7.0",
+    "memfs": "^4.17.1",
+    "nock": "13.4.0",
+    "rimraf": "3.0.2",
+    "ts-jest": "^29.1.4",
+    "ts-mockito": "^2.6.1",
+    "tslib": "^2.6.3",
+    "typescript": "^5.5.4",
+    "uuid": "^9.0.1"
+  }
+}

packages/build-tools/src/__mocks__/@expo/logger.ts

@@ -0,0 +1,25 @@
+import bunyan from 'bunyan';
+
+export function createLogger(): bunyan {
+  const logger = {
+    info: () => {},
+    debug: () => {},
+    error: () => {},
+    warn: () => {},
+    child: _fields => logger,
+  } as bunyan;
+  return logger;
+}
+
+export enum LoggerLevel {
+  TRACE = 'trace',
+  DEBUG = 'debug',
+  INFO = 'info',
+  WARN = 'warn',
+  ERROR = 'error',
+  FATAL = 'fatal',
+}
+
+export enum PipeMode {
+  COMBINED = 'combined',
+}

packages/build-tools/src/__mocks__/fs.ts

@@ -0,0 +1,21 @@
+import { fs } from 'memfs';
+
+const fsRealpath = fs.realpath;
+(fsRealpath as any).native = fsRealpath;
+
+const fsRm = (
+  path: string,
+  options: object,
+  callback: (err: NodeJS.ErrnoException | null) => void
+): void => {
+  fs.promises
+    .rm(path, options)
+    .then(() => {
+      callback(null);
+    })
+    .catch(err => {
+      callback(err);
+    });
+};
+
+module.exports = { ...fs, realpath: fsRealpath, rm: fsRm };

packages/build-tools/src/__mocks__/fs/promises.ts

@@ -0,0 +1,7 @@
+import { fs } from 'memfs';
+
+const fsRm = (path: string, options: object): Promise<void> => {
+  return fs.promises.rm(path, options);
+};
+
+module.exports = { ...fs.promises, rm: fsRm };

packages/build-tools/src/__tests__/context.test.ts

@@ -0,0 +1,205 @@
+import {
+  BuildPhase,
+  BuildPhaseResult,
+  BuildTrigger,
+  Job,
+  Metadata,
+  Platform,
+} from '@expo/eas-build-job';
+import { randomUUID } from 'crypto';
+import fs from 'fs-extra';
+import { vol } from 'memfs';
+
+import { createMockLogger } from './utils/logger';
+import { BuildContext } from '../context';
+import { Datadog } from '../datadog';
+
+jest.mock('fs');
+jest.mock('fs-extra');
+jest.mock('../datadog', () => ({
+  Datadog: {
+    distribution: jest.fn(),
+  },
+}));
+
+const datadogDistributionMock = jest.mocked(Datadog.distribution);
+
+describe('BuildContext', () => {
+  beforeEach(() => {
+    vol.reset();
+    jest.clearAllMocks();
+    (fs.readdir as unknown as jest.Mock).mockResolvedValue([]);
+  });
+
+  it('should merge secrets', async () => {
+    const robotAccessToken = randomUUID();
+    await vol.promises.mkdir('/workingdir/eas-environment-secrets/', { recursive: true });
+
+    const ctx = new BuildContext(
+      {
+        triggeredBy: BuildTrigger.GIT_BASED_INTEGRATION,
+        secrets: {
+          robotAccessToken,
+          environmentSecrets: [
+            {
+              name: 'TEST_SECRET',
+              value: 'test-secret-value',
+            },
+          ],
+        },
+      } as Job,
+      {
+        env: {
+          __API_SERVER_URL: 'http://api.expo.test',
+        },
+        workingdir: '/workingdir',
+        logger: createMockLogger(),
+        logBuffer: { getLogs: () => [], getPhaseLogs: () => [] },
+        uploadArtifact: jest.fn(),
+      }
+    );
+
+    ctx.updateJobInformation({} as Job, {} as Metadata);
+
+    expect(ctx.job.secrets).toEqual({
+      robotAccessToken,
+      environmentSecrets: [
+        {
+          name: 'TEST_SECRET',
+          value: 'test-secret-value',
+        },
+      ],
+    });
+
+    const newRobotAccessToken = randomUUID();
+    ctx.updateJobInformation(
+      {
+        secrets: {
+          robotAccessToken: newRobotAccessToken,
+          environmentSecrets: [
+            {
+              name: 'TEST_SECRET',
+              value: 'new-test-secret-value',
+            },
+            {
+              name: 'TEST_SECRET_2',
+              value: 'test-secret-value-2',
+            },
+          ],
+        },
+      } as Job,
+      {} as Metadata
+    );
+
+    expect(ctx.job.secrets).toEqual({
+      robotAccessToken: newRobotAccessToken,
+      environmentSecrets: [
+        { name: 'TEST_SECRET', value: 'test-secret-value' },
+        { name: 'TEST_SECRET', value: 'new-test-secret-value' },
+        { name: 'TEST_SECRET_2', value: 'test-secret-value-2' },
+      ],
+    });
+  });
+
+  it('should not lose workflowInterpolationContext', async () => {
+    const robotAccessToken = randomUUID();
+    await vol.promises.mkdir('/workingdir/eas-environment-secrets/', { recursive: true });
+
+    const ctx = new BuildContext(
+      {
+        triggeredBy: BuildTrigger.GIT_BASED_INTEGRATION,
+        secrets: {
+          robotAccessToken,
+          environmentSecrets: [
+            {
+              name: 'TEST_SECRET',
+              value: 'test-secret-value',
+            },
+          ],
+        },
+        workflowInterpolationContext: {
+          foo: 'bar',
+        } as any,
+      } as Job,
+      {
+        env: {
+          __API_SERVER_URL: 'http://api.expo.test',
+        },
+        workingdir: '/workingdir',
+        logger: createMockLogger(),
+        logBuffer: { getLogs: () => [], getPhaseLogs: () => [] },
+        uploadArtifact: jest.fn(),
+      }
+    );
+
+    ctx.updateJobInformation({} as Job, {} as Metadata);
+
+    expect(ctx.job.workflowInterpolationContext).toEqual({
+      foo: 'bar',
+    });
+  });
+
+  it('emits build phase duration metrics for successful build phases', async () => {
+    const ctx = createTestBuildContext({ platform: Platform.IOS });
+
+    await ctx.runBuildPhase(BuildPhase.RUN_FASTLANE, async () => {});
+
+    expect(datadogDistributionMock).toHaveBeenCalledWith(
+      'eas.build.phase_duration',
+      expect.any(Number),
+      {
+        build_phase: 'run_fastlane',
+        platform: Platform.IOS,
+        result: BuildPhaseResult.SUCCESS,
+      }
+    );
+  });
+
+  it('emits build phase duration metrics for failed build phases', async () => {
+    const ctx = createTestBuildContext({ platform: Platform.ANDROID });
+
+    await expect(
+      ctx.runBuildPhase(BuildPhase.INSTALL_DEPENDENCIES, async () => {
+        throw new Error('boom');
+      })
+    ).rejects.toThrow();
+
+    expect(datadogDistributionMock).toHaveBeenCalledWith(
+      'eas.build.phase_duration',
+      expect.any(Number),
+      {
+        build_phase: 'install_dependencies',
+        platform: Platform.ANDROID,
+        result: BuildPhaseResult.FAIL,
+      }
+    );
+  });
+
+  it('does not emit build phase duration metrics for non-platform jobs', async () => {
+    const ctx = createTestBuildContext({});
+
+    await ctx.runBuildPhase(BuildPhase.PREPARE_PROJECT, async () => {});
+
+    expect(datadogDistributionMock).not.toHaveBeenCalled();
+  });
+});
+
+function createTestBuildContext({ platform }: { platform?: Platform }): BuildContext {
+  vol.mkdirSync('/workingdir/env', { recursive: true });
+
+  return new BuildContext(
+    {
+      ...(platform ? { platform } : {}),
+      builderEnvironment: { env: {} },
+    } as Job,
+    {
+      env: {
+        __API_SERVER_URL: 'http://api.expo.test',
+      },
+      workingdir: '/workingdir',
+      logger: createMockLogger(),
+      logBuffer: { getLogs: () => [], getPhaseLogs: () => [] },
+      uploadArtifact: jest.fn(),
+    }
+  );
+}

packages/build-tools/src/__tests__/customBuildContext.test.ts

@@ -0,0 +1,160 @@
+import { BuildTrigger, Ios, Metadata } from '@expo/eas-build-job';
+import { StepMetric } from '@expo/steps';
+
+import { createTestIosJob } from './utils/job';
+import { createMockLogger } from './utils/logger';
+import { BuildContext } from '../context';
+import { CustomBuildContext } from '../customBuildContext';
+import { uploadStepMetricsToWwwAsync } from '../utils/stepMetrics';
+
+jest.mock('../utils/stepMetrics');
+const mockUploadStepMetricsToWwwAsync = jest.mocked(uploadStepMetricsToWwwAsync);
+
+describe(CustomBuildContext, () => {
+  it('should not lose workflowInterpolationContext', () => {
+    const contextUploadArtifact = jest.fn();
+    const ctx = new BuildContext(
+      createTestIosJob({
+        triggeredBy: BuildTrigger.GIT_BASED_INTEGRATION,
+        workflowInterpolationContext: {
+          foo: 'bar',
+        } as unknown as Ios.Job['workflowInterpolationContext'],
+      }),
+      {
+        env: {
+          __API_SERVER_URL: 'http://api.expo.test',
+        },
+        logBuffer: { getLogs: () => [], getPhaseLogs: () => [] },
+        logger: createMockLogger(),
+        uploadArtifact: contextUploadArtifact,
+        workingdir: '',
+      }
+    );
+    const customContext = new CustomBuildContext(ctx);
+    expect(customContext.job.workflowInterpolationContext).toStrictEqual({
+      foo: 'bar',
+    });
+    customContext.updateJobInformation({} as Ios.Job, {} as Metadata);
+    expect(customContext.job.workflowInterpolationContext).toStrictEqual({
+      foo: 'bar',
+    });
+  });
+
+  describe('reportStepMetric', () => {
+    const expoApiV2BaseUrl = 'http://exp.test/--/api/v2/';
+    const workflowJobId = 'test-workflow-job-id';
+    const robotAccessToken = 'test-robot-token';
+
+    const sampleMetric: StepMetric = {
+      metricsId: 'eas/checkout',
+      result: 'success',
+      durationMs: 1000,
+      platform: 'linux',
+    };
+
+    function createCustomBuildContext(
+      overrides: {
+        expoApiV2BaseUrl?: string | undefined;
+        includeRobotAccessToken?: boolean;
+        includeWorkflowJobId?: boolean;
+      } = {}
+    ): CustomBuildContext {
+      const job = createTestIosJob();
+      if (overrides.includeRobotAccessToken !== false) {
+        (job.secrets as any).robotAccessToken = robotAccessToken;
+      }
+
+      const env: Record<string, string> = {
+        __API_SERVER_URL: 'http://api.expo.test',
+      };
+      if (overrides.includeWorkflowJobId !== false) {
+        env.__WORKFLOW_JOB_ID = workflowJobId;
+      }
+
+      const ctx = new BuildContext(job, {
+        env,
+        logBuffer: { getLogs: () => [], getPhaseLogs: () => [] },
+        logger: createMockLogger(),
+        uploadArtifact: jest.fn(),
+        workingdir: '/workingdir',
+        expoApiV2BaseUrl:
+          'expoApiV2BaseUrl' in overrides ? overrides.expoApiV2BaseUrl : expoApiV2BaseUrl,
+      });
+
+      return new CustomBuildContext(ctx);
+    }
+
+    beforeEach(() => {
+      jest.clearAllMocks();
+      mockUploadStepMetricsToWwwAsync.mockResolvedValue(undefined);
+    });
+
+    it('calls uploadStepMetricsToWwwAsync when all required fields are present', () => {
+      const customCtx = createCustomBuildContext();
+      customCtx.reportStepMetric(sampleMetric);
+
+      expect(mockUploadStepMetricsToWwwAsync).toHaveBeenCalledTimes(1);
+      expect(mockUploadStepMetricsToWwwAsync).toHaveBeenCalledWith(
+        expect.objectContaining({
+          workflowJobId,
+          robotAccessToken,
+          expoApiV2BaseUrl,
+          stepMetrics: [sampleMetric],
+        })
+      );
+    });
+
+    it('does not call upload when workflowJobId is missing', () => {
+      const customCtx = createCustomBuildContext({ includeWorkflowJobId: false });
+      customCtx.reportStepMetric(sampleMetric);
+
+      expect(mockUploadStepMetricsToWwwAsync).not.toHaveBeenCalled();
+    });
+
+    it('does not call upload when robotAccessToken is missing', () => {
+      const customCtx = createCustomBuildContext({ includeRobotAccessToken: false });
+      customCtx.reportStepMetric(sampleMetric);
+
+      expect(mockUploadStepMetricsToWwwAsync).not.toHaveBeenCalled();
+    });
+
+    it('does not call upload when expoApiV2BaseUrl is missing', () => {
+      const customCtx = createCustomBuildContext({ expoApiV2BaseUrl: undefined });
+      customCtx.reportStepMetric(sampleMetric);
+
+      expect(mockUploadStepMetricsToWwwAsync).not.toHaveBeenCalled();
+    });
+
+    it('drainPendingMetricUploads awaits all pending uploads', async () => {
+      let resolveUpload!: () => void;
+      const uploadPromise = new Promise<void>(resolve => {
+        resolveUpload = resolve;
+      });
+      mockUploadStepMetricsToWwwAsync.mockReturnValue(uploadPromise);
+
+      const customCtx = createCustomBuildContext();
+      customCtx.reportStepMetric(sampleMetric);
+
+      let drained = false;
+      const drainPromise = customCtx.drainPendingMetricUploads().then(() => {
+        drained = true;
+      });
+
+      await new Promise(r => setImmediate(r));
+      expect(drained).toBe(false);
+
+      resolveUpload();
+      await drainPromise;
+      expect(drained).toBe(true);
+    });
+
+    it('drainPendingMetricUploads settles even if an upload rejects', async () => {
+      mockUploadStepMetricsToWwwAsync.mockRejectedValue(new Error('upload failed'));
+
+      const customCtx = createCustomBuildContext();
+      customCtx.reportStepMetric(sampleMetric);
+
+      await expect(customCtx.drainPendingMetricUploads()).resolves.not.toThrow();
+    });
+  });
+});

packages/build-tools/src/__tests__/datadog.test.ts

@@ -0,0 +1,150 @@
+import { Response } from 'node-fetch';
+
+import { Datadog } from '../datadog';
+import { Sentry } from '../sentry';
+import { turtleFetch } from '../utils/turtleFetch';
+
+jest.mock('../sentry', () => ({
+  Sentry: {
+    capture: jest.fn(),
+  },
+}));
+jest.mock('../utils/turtleFetch', () => ({
+  turtleFetch: jest.fn(),
+}));
+
+const turtleFetchMock = jest.mocked(turtleFetch);
+const sentryCaptureMock = jest.mocked(Sentry.capture);
+
+describe('Datadog singleton', () => {
+  beforeEach(() => {
+    jest.clearAllMocks();
+    Datadog.setup(null);
+  });
+
+  it('POSTs distribution metrics to the turtle build metrics endpoint', () => {
+    turtleFetchMock.mockResolvedValueOnce({} as Response);
+
+    Datadog.setup({
+      expoApiV2BaseUrl: 'https://api.expo.test/v2/',
+      turtleBuildId: 'build-id',
+      robotAccessToken: 'token-abc',
+    });
+
+    Datadog.distribution('eas.build.phase_duration', 1234, {
+      build_phase: 'install_dependencies',
+      platform: 'ios',
+      result: 'success',
+    });
+
+    expect(turtleFetchMock).toHaveBeenCalledWith(
+      'https://api.expo.test/v2/turtle-builds/build-id/metrics',
+      'POST',
+      {
+        json: {
+          metrics: [
+            {
+              name: 'eas.build.phase_duration',
+              type: 'distribution',
+              value: 1234,
+              tags: {
+                build_phase: 'install_dependencies',
+                platform: 'ios',
+                result: 'success',
+              },
+            },
+          ],
+        },
+        headers: { Authorization: 'Bearer token-abc' },
+        retries: 2,
+      }
+    );
+  });
+
+  it('is a no-op when setup is null', () => {
+    Datadog.setup(null);
+
+    Datadog.distribution('eas.build.phase_duration', 1);
+
+    expect(turtleFetchMock).not.toHaveBeenCalled();
+  });
+
+  it('swallows upload failures', async () => {
+    turtleFetchMock.mockRejectedValueOnce(new Error('network down'));
+    Datadog.setup({
+      expoApiV2BaseUrl: 'https://api.expo.test/v2/',
+      turtleBuildId: 'build-id',
+      robotAccessToken: 'token-abc',
+    });
+
+    Datadog.distribution('eas.build.phase_duration', 1);
+    await flushPromises();
+
+    expect(turtleFetchMock).toHaveBeenCalled();
+    expect(sentryCaptureMock).toHaveBeenCalledWith(
+      'Failed to report turtle build metric',
+      expect.any(Error),
+      expect.objectContaining({
+        extras: {
+          metrics: [{ name: 'eas.build.phase_duration', type: 'distribution', value: 1, tags: {} }],
+        },
+      })
+    );
+  });
+
+  it('uses the latest setup options', () => {
+    turtleFetchMock.mockResolvedValue({} as Response);
+
+    Datadog.setup({
+      expoApiV2BaseUrl: 'https://api.expo.test/v2/',
+      turtleBuildId: 'first-build-id',
+      robotAccessToken: 'first-token',
+    });
+    Datadog.setup({
+      expoApiV2BaseUrl: 'https://api.expo.test/v2/',
+      turtleBuildId: 'second-build-id',
+      robotAccessToken: 'second-token',
+    });
+
+    Datadog.distribution('eas.build.phase_duration', 1);
+
+    expect(turtleFetchMock).toHaveBeenCalledWith(
+      'https://api.expo.test/v2/turtle-builds/second-build-id/metrics',
+      'POST',
+      expect.objectContaining({
+        headers: { Authorization: 'Bearer second-token' },
+      })
+    );
+  });
+
+  it('flushes pending metric uploads', async () => {
+    let resolveUpload!: (response: Response) => void;
+    turtleFetchMock.mockReturnValueOnce(
+      new Promise<Response>(resolve => {
+        resolveUpload = resolve;
+      })
+    );
+    Datadog.setup({
+      expoApiV2BaseUrl: 'https://api.expo.test/v2/',
+      turtleBuildId: 'build-id',
+      robotAccessToken: 'token-abc',
+    });
+
+    let flushed = false;
+    Datadog.distribution('eas.build.phase_duration', 1);
+    const flushPromise = Datadog.flushAsync().then(() => {
+      flushed = true;
+    });
+    await Promise.resolve();
+    expect(flushed).toBe(false);
+
+    resolveUpload({} as Response);
+    await flushPromise;
+
+    expect(flushed).toBe(true);
+  });
+});
+
+async function flushPromises(): Promise<void> {
+  await new Promise(resolve => setImmediate(resolve));
+}

packages/build-tools/src/__tests__/generic.test.ts

@@ -0,0 +1,128 @@
+import { BuildPhase } from '@expo/eas-build-job';
+import { BuildStepGlobalContext, StepsConfigParser } from '@expo/steps';
+
+import { runGenericJobAsync } from '../generic';
+import { CustomBuildContext } from '../customBuildContext';
+import { uploadJobOutputsToWwwAsync } from '../utils/outputs';
+
+jest.mock('../customBuildContext');
+jest.mock('../utils/outputs');
+jest.mock('../common/projectSources');
+jest.mock('../steps/easFunctions', () => ({ getEasFunctions: jest.fn().mockReturnValue([]) }));
+jest.mock('../steps/easFunctionGroups', () => ({
+  getEasFunctionGroups: jest.fn().mockReturnValue([]),
+}));
+jest.mock('@expo/steps');
+jest.mock('fs/promises');
+
+const mockUploadJobOutputsToWwwAsync = jest.mocked(uploadJobOutputsToWwwAsync);
+
+describe(runGenericJobAsync, () => {
+  const expoApiV2BaseUrl = 'http://exp.test/--/api/v2/';
+
+  let mockDrainPendingMetricUploads: jest.Mock;
+  let mockCtx: any;
+
+  beforeEach(() => {
+    jest.clearAllMocks();
+
+    mockDrainPendingMetricUploads = jest.fn().mockResolvedValue(undefined);
+
+    (CustomBuildContext as unknown as jest.Mock).mockImplementation(() => ({
+      projectSourceDirectory: '/tmp/src',
+      env: { __WORKFLOW_JOB_ID: 'test-workflow-job-id' },
+      drainPendingMetricUploads: mockDrainPendingMetricUploads,
+    }));
+
+    (BuildStepGlobalContext as unknown as jest.Mock).mockImplementation(() => ({
+      env: { __WORKFLOW_JOB_ID: 'test-workflow-job-id' },
+    }));
+
+    mockCtx = {
+      expoApiV2BaseUrl,
+      job: {
+        secrets: { robotAccessToken: 'test-token' },
+        steps: [],
+      },
+      logger: {
+        info: jest.fn(),
+        debug: jest.fn(),
+        warn: jest.fn(),
+        error: jest.fn(),
+        child: jest.fn().mockReturnThis(),
+      },
+      runBuildPhase: jest.fn(async (_phase: BuildPhase, fn: () => Promise<any>) => fn()),
+    };
+
+    mockUploadJobOutputsToWwwAsync.mockResolvedValue(undefined);
+  });
+
+  it('awaits drainPendingMetricUploads in COMPLETE_JOB phase', async () => {
+    const mockWorkflow = { executeAsync: jest.fn().mockResolvedValue(undefined) };
+    (StepsConfigParser as unknown as jest.Mock).mockImplementation(() => ({
+      parseAsync: jest.fn().mockResolvedValue(mockWorkflow),
+    }));
+
+    let resolveDrain!: () => void;
+    mockDrainPendingMetricUploads.mockReturnValue(
+      new Promise<void>(resolve => {
+        resolveDrain = resolve;
+      })
+    );
+
+    let resolved = false;
+    const resultPromise = runGenericJobAsync(mockCtx).then(() => {
+      resolved = true;
+    });
+
+    await new Promise(r => setImmediate(r));
+    expect(resolved).toBe(false);
+
+    resolveDrain();
+    await resultPromise;
+    expect(resolved).toBe(true);
+  });
+
+  it('awaits drainPendingMetricUploads even when outputs upload fails', async () => {
+    const mockWorkflow = { executeAsync: jest.fn().mockResolvedValue(undefined) };
+    (StepsConfigParser as unknown as jest.Mock).mockImplementation(() => ({
+      parseAsync: jest.fn().mockResolvedValue(mockWorkflow),
+    }));
+    mockUploadJobOutputsToWwwAsync.mockRejectedValue(new Error('outputs upload failed'));
+
+    let resolveDrain!: () => void;
+    mockDrainPendingMetricUploads.mockReturnValue(
+      new Promise<void>(resolve => {
+        resolveDrain = resolve;
+      })
+    );
+
+    let rejected = false;
+    const resultPromise = runGenericJobAsync(mockCtx).catch(err => {
+      rejected = true;
+      throw err;
+    });
+
+    await new Promise(r => setImmediate(r));
+    expect(rejected).toBe(false);
+
+    resolveDrain();
+    await expect(resultPromise).rejects.toThrow('outputs upload failed');
+    expect(rejected).toBe(true);
+  });
+
+  it('throws before workflow execution when expoApiV2BaseUrl is missing', async () => {
+    mockCtx.expoApiV2BaseUrl = undefined;
+
+    const mockWorkflow = { executeAsync: jest.fn() };
+    (StepsConfigParser as unknown as jest.Mock).mockImplementation(() => ({
+      parseAsync: jest.fn().mockResolvedValue(mockWorkflow),
+    }));
+
+    await expect(runGenericJobAsync(mockCtx)).rejects.toThrow(
+      'expoApiV2BaseUrl is required for generic jobs'
+    );
+
+    expect(CustomBuildContext).not.toHaveBeenCalled();
+  });
+});

packages/build-tools/src/__tests__/sentry.test.ts

@@ -0,0 +1,256 @@
+import * as sentryNode from '@sentry/node';
+
+import { Sentry } from '../sentry';
+
+jest.mock('@sentry/node');
+
+describe('Sentry singleton', () => {
+  beforeEach(() => {
+    jest.mocked(sentryNode.init).mockReset();
+    jest.mocked(sentryNode.flush).mockReset();
+    jest.mocked(sentryNode.captureException).mockReset();
+    jest.mocked(sentryNode.captureMessage).mockReset();
+    jest.mocked(sentryNode.withScope).mockReset();
+  });
+
+  describe('setup', () => {
+    it('initializes the SDK with dsn + environment when dsn is non-null', () => {
+      Sentry.setup({ dsn: 'https://[email protected]/1', environment: 'production' });
+      expect(sentryNode.init).toHaveBeenCalledWith({
+        dsn: 'https://[email protected]/1',
+        environment: 'production',
+      });
+    });
+
+    it('passes default tags into the SDK init as initialScope', () => {
+      Sentry.setup({
+        dsn: 'https://[email protected]/1',
+        environment: 'production',
+        tags: { service: 'worker:darwin' },
+      });
+      expect(sentryNode.init).toHaveBeenCalledWith({
+        dsn: 'https://[email protected]/1',
+        environment: 'production',
+        initialScope: { tags: { service: 'worker:darwin' } },
+      });
+    });
+
+    it('skips SDK init when dsn is null', () => {
+      Sentry.setup({ dsn: null, environment: 'development' });
+      expect(sentryNode.init).not.toHaveBeenCalled();
+    });
+
+    it('passes the latest initialScope tags when setup is called more than once', () => {
+      Sentry.setup({
+        dsn: 'https://[email protected]/1',
+        environment: 'test',
+        tags: { service: 'first' },
+      });
+      Sentry.setup({
+        dsn: 'https://[email protected]/1',
+        environment: 'test',
+        tags: { service: 'second' },
+      });
+
+      expect(sentryNode.init).toHaveBeenNthCalledWith(
+        2,
+        expect.objectContaining({ initialScope: { tags: { service: 'second' } } })
+      );
+    });
+  });
+
+  describe('capture', () => {
+    it('routes (msg) to captureMessage with msg only', () => {
+      const scope = mockWithScope();
+
+      Sentry.capture('plain message');
+
+      expect(sentryNode.captureMessage).toHaveBeenCalledWith('plain message');
+      expect(sentryNode.captureException).not.toHaveBeenCalled();
+      expect(scope.setExtra).not.toHaveBeenCalled();
+    });
+
+    it('routes (msg, options) and sets per-call tags/extras/level on the scope', () => {
+      const scope = mockWithScope();
+
+      Sentry.capture('something happened', {
+        tags: { phase: 'running-xclogparser' },
+        extras: { buildId: 'abc' },
+        level: 'warning',
+      });
+
+      expect(scope.setTags).toHaveBeenCalledWith({ phase: 'running-xclogparser' });
+      expect(scope.setExtras).toHaveBeenCalledWith({ buildId: 'abc' });
+      expect(scope.setLevel).toHaveBeenCalledWith('warning');
+      expect(sentryNode.captureMessage).toHaveBeenCalledWith('something happened');
+      expect(sentryNode.captureException).not.toHaveBeenCalled();
+    });
+
+    it('routes (msg, err) to captureException and sets msg as `message` extra when distinct from err.message', () => {
+      const scope = mockWithScope();
+      const err = new Error('boom');
+
+      Sentry.capture('something went wrong', err);
+
+      expect(scope.setExtra).toHaveBeenCalledWith('message', 'something went wrong');
+      expect(sentryNode.captureException).toHaveBeenCalledWith(err);
+      expect(sentryNode.captureMessage).not.toHaveBeenCalled();
+    });
+
+    it('routes (msg, err, options) to captureException with per-call tags/extras', () => {
+      const scope = mockWithScope();
+      const err = new Error('spawn ENOENT');
+
+      Sentry.capture('xclogparser failed', err, {
+        tags: { phase: 'running-xclogparser' },
+        extras: { buildId: 'abc' },
+      });
+
+      expect(scope.setTags).toHaveBeenCalledWith({ phase: 'running-xclogparser' });
+      expect(scope.setExtras).toHaveBeenCalledWith({ buildId: 'abc' });
+      expect(scope.setExtra).toHaveBeenCalledWith('message', 'xclogparser failed');
+      expect(sentryNode.captureException).toHaveBeenCalledWith(err);
+    });
+
+    it('does not set the `message` extra when msg equals err.message', () => {
+      const scope = mockWithScope();
+      const err = new Error('build failed');
+
+      Sentry.capture('build failed', err);
+
+      expect(scope.setExtra).not.toHaveBeenCalledWith('message', expect.anything());
+      expect(sentryNode.captureException).toHaveBeenCalledWith(err);
+    });
+
+    it('routes (err) alone to captureException with no scope mutations', () => {
+      const scope = mockWithScope();
+      const err = new Error('boom');
+
+      Sentry.capture(err);
+
+      expect(scope.setTags).not.toHaveBeenCalled();
+      expect(scope.setExtras).not.toHaveBeenCalled();
+      expect(scope.setLevel).not.toHaveBeenCalled();
+      expect(scope.setExtra).not.toHaveBeenCalled();
+      expect(sentryNode.captureException).toHaveBeenCalledWith(err);
+      expect(sentryNode.captureMessage).not.toHaveBeenCalled();
+    });
+
+    it('treats (msg, null) as a no-err call (parity with 3-arg null behavior)', () => {
+      const scope = mockWithScope();
+
+      Sentry.capture('forwarded null', null as unknown as Error);
+
+      expect(scope.setExtra).not.toHaveBeenCalled();
+      expect(sentryNode.captureMessage).toHaveBeenCalledWith('forwarded null');
+      expect(sentryNode.captureException).not.toHaveBeenCalled();
+    });
+
+    it('treats (msg, null, options) as a no-err call', () => {
+      const scope = mockWithScope();
+
+      Sentry.capture('forwarded null with opts', null as unknown as Error, {
+        tags: { phase: 'cleanup' },
+      });
+
+      expect(scope.setTags).toHaveBeenCalledWith({ phase: 'cleanup' });
+      expect(scope.setExtra).not.toHaveBeenCalled();
+      expect(sentryNode.captureMessage).toHaveBeenCalledWith('forwarded null with opts');
+      expect(sentryNode.captureException).not.toHaveBeenCalled();
+    });
+
+    it('treats (msg, undefined, options) as a no-err call (forwarding `Error | undefined` typed vars)', () => {
+      const scope = mockWithScope();
+
+      Sentry.capture('forwarded with no err', undefined, {
+        tags: { phase: 'install-dependencies' },
+        extras: { buildId: 'abc' },
+      });
+
+      expect(scope.setTags).toHaveBeenCalledWith({ phase: 'install-dependencies' });
+      expect(scope.setExtras).toHaveBeenCalledWith({ buildId: 'abc' });
+      expect(scope.setExtra).not.toHaveBeenCalled();
+      expect(sentryNode.captureMessage).toHaveBeenCalledWith('forwarded with no err');
+      expect(sentryNode.captureException).not.toHaveBeenCalled();
+    });
+
+    it('coerces 2-arg primitive thrown value to Error (e.g. `throw "boom"`)', () => {
+      mockWithScope();
+
+      Sentry.capture('caught a string', 'boom' as unknown as Error);
+
+      expect(sentryNode.captureException).toHaveBeenCalledWith(expect.any(Error));
+      const coerced = jest.mocked(sentryNode.captureException).mock.calls[0][0] as Error;
+      expect(coerced.message).toBe('boom');
+      expect(sentryNode.captureMessage).not.toHaveBeenCalled();
+    });
+
+    it('coerces non-Error middle arg to Error when caller passes 3 args (e.g. `catch (err: any)`)', () => {
+      const scope = mockWithScope();
+
+      Sentry.capture('something failed', 'raw string thrown' as unknown as Error, {
+        tags: { phase: 'install-dependencies' },
+        extras: { buildId: 'abc' },
+      });
+
+      expect(scope.setTags).toHaveBeenCalledWith({ phase: 'install-dependencies' });
+      expect(scope.setExtras).toHaveBeenCalledWith({ buildId: 'abc' });
+      expect(scope.setExtra).toHaveBeenCalledWith('message', 'something failed');
+      expect(sentryNode.captureException).toHaveBeenCalledWith(expect.any(Error));
+      const coerced = jest.mocked(sentryNode.captureException).mock.calls[0][0] as Error;
+      expect(coerced.message).toBe('raw string thrown');
+      expect(sentryNode.captureMessage).not.toHaveBeenCalled();
+    });
+
+    it('routes (err, options) to captureException with no message extra', () => {
+      const scope = mockWithScope();
+      const err = new Error('boom');
+
+      Sentry.capture(err, { tags: { phase: 'install-dependencies' }, level: 'warning' });
+
+      expect(scope.setTags).toHaveBeenCalledWith({ phase: 'install-dependencies' });
+      expect(scope.setLevel).toHaveBeenCalledWith('warning');
+      expect(scope.setExtra).not.toHaveBeenCalled();
+      expect(sentryNode.captureException).toHaveBeenCalledWith(err);
+      expect(sentryNode.captureMessage).not.toHaveBeenCalled();
+    });
+  });
+
+  describe('flush', () => {
+    it('forwards the timeout to the SDK and resolves with its result', async () => {
+      jest.mocked(sentryNode.flush).mockResolvedValue(true);
+
+      const result = await Sentry.flush(3000);
+
+      expect(sentryNode.flush).toHaveBeenCalledWith(3000);
+      expect(result).toBe(true);
+    });
+
+    it('defaults the timeout to 2000ms when not specified', async () => {
+      jest.mocked(sentryNode.flush).mockResolvedValue(true);
+
+      await Sentry.flush();
+
+      expect(sentryNode.flush).toHaveBeenCalledWith(2000);
+    });
+  });
+});
+
+function mockWithScope(): {
+  setTags: jest.Mock;
+  setExtras: jest.Mock;
+  setExtra: jest.Mock;
+  setLevel: jest.Mock;
+} {
+  const scope = {
+    setTags: jest.fn(),
+    setExtras: jest.fn(),
+    setExtra: jest.fn(),
+    setLevel: jest.fn(),
+  };
+  jest.mocked(sentryNode.withScope).mockImplementation((cb: any) => {
+    cb(scope as unknown as sentryNode.Scope);
+    return undefined as any;
+  });
+  return scope;
+}

packages/build-tools/src/__tests__/utils/context.ts

@@ -0,0 +1,100 @@
+import { bunyan } from '@expo/logger';
+import {
+  BuildRuntimePlatform,
+  BuildStepContext,
+  BuildStepEnv,
+  BuildStepGlobalContext,
+  ExternalBuildContextProvider,
+} from '@expo/steps';
+import os from 'os';
+import path from 'path';
+import { v4 as uuidv4 } from 'uuid';
+
+import { createMockLogger } from './logger';
+
+export class MockContextProvider implements ExternalBuildContextProvider {
+  private _env: BuildStepEnv = {};
+
+  constructor(
+    public readonly logger: bunyan,
+    public readonly runtimePlatform: BuildRuntimePlatform,
+    public readonly projectSourceDirectory: string,
+    public readonly projectTargetDirectory: string,
+    public readonly defaultWorkingDirectory: string,
+    public readonly buildLogsDirectory: string,
+    public readonly staticContextContent: Record<string, any> = {}
+  ) {}
+  public get env(): BuildStepEnv {
+    return this._env;
+  }
+  public staticContext(): any {
+    return { ...this.staticContextContent };
+  }
+  public updateEnv(env: BuildStepEnv): void {
+    this._env = env;
+  }
+}
+
+interface BuildContextParams {
+  buildId?: string;
+  logger?: bunyan;
+  skipCleanup?: boolean;
+  runtimePlatform?: BuildRuntimePlatform;
+  projectSourceDirectory?: string;
+  projectTargetDirectory?: string;
+  relativeWorkingDirectory?: string;
+  staticContextContent?: Record<string, any>;
+}
+
+export function createStepContextMock({
+  buildId,
+  logger,
+  skipCleanup,
+  runtimePlatform,
+  projectSourceDirectory,
+  projectTargetDirectory,
+  relativeWorkingDirectory,
+  staticContextContent,
+}: BuildContextParams = {}): BuildStepContext {
+  const globalCtx = createGlobalContextMock({
+    buildId,
+    logger,
+    skipCleanup,
+    runtimePlatform,
+    projectSourceDirectory,
+    projectTargetDirectory,
+    relativeWorkingDirectory,
+    staticContextContent,
+  });
+  return new BuildStepContext(globalCtx, {
+    logger: logger ?? createMockLogger(),
+    relativeWorkingDirectory,
+  });
+}
+
+export function createGlobalContextMock({
+  logger,
+  skipCleanup,
+  runtimePlatform,
+  projectSourceDirectory,
+  projectTargetDirectory,
+  relativeWorkingDirectory,
+  staticContextContent,
+}: BuildContextParams = {}): BuildStepGlobalContext {
+  const resolvedProjectTargetDirectory =
+    projectTargetDirectory ?? path.join(os.tmpdir(), 'eas-build', uuidv4());
+  return new BuildStepGlobalContext(
+    new MockContextProvider(
+      logger ?? createMockLogger(),
+      runtimePlatform ?? BuildRuntimePlatform.LINUX,
+      projectSourceDirectory ?? '/non/existent/dir',
+      resolvedProjectTargetDirectory,
+      relativeWorkingDirectory
+        ? path.resolve(resolvedProjectTargetDirectory, relativeWorkingDirectory)
+        : resolvedProjectTargetDirectory,
+      '/non/existent/dir',
+      staticContextContent ?? {}
+    ),
+    skipCleanup ?? false
+  );
+}

packages/build-tools/src/__tests__/utils/job.ts

@@ -0,0 +1,94 @@
+import {
+  Android,
+  ArchiveSourceType,
+  BuildMode,
+  BuildTrigger,
+  Ios,
+  Platform,
+  Workflow,
+} from '@expo/eas-build-job';
+import { randomUUID } from 'crypto';
+
+const androidCredentials: Android.BuildSecrets['buildCredentials'] = {
+  keystore: {
+    dataBase64: 'MjEzNwo=',
+    keystorePassword: 'pass1',
+    keyAlias: 'alias',
+    keyPassword: 'pass2',
+  },
+};
+
+const iosCredentials: Ios.BuildCredentials = {
+  testapp: {
+    provisioningProfileBase64: '',
+    distributionCertificate: {
+      dataBase64: '',
+      password: '',
+    },
+  },
+};
+
+export function createTestAndroidJob({
+  buildCredentials = androidCredentials,
+}: {
+  buildCredentials?: Android.BuildSecrets['buildCredentials'];
+} = {}): Android.Job {
+  return {
+    mode: BuildMode.BUILD,
+    platform: Platform.ANDROID,
+    triggeredBy: BuildTrigger.EAS_CLI,
+    type: Workflow.GENERIC,
+    projectArchive: {
+      type: ArchiveSourceType.URL,
+      url: 'https://turtle-v2-test-fixtures.s3.us-east-2.amazonaws.com/project.tar.gz',
+    },
+    projectRootDirectory: '.',
+    applicationArchivePath: './android/app/build/outputs/apk/release/*.apk',
+    cache: {
+      clear: false,
+      disabled: false,
+      paths: [],
+    },
+    secrets: {
+      buildCredentials,
+    },
+    appId: randomUUID(),
+    initiatingUserId: randomUUID(),
+  };
+}
+
+export function createTestIosJob({
+  buildCredentials = iosCredentials,
+  triggeredBy = BuildTrigger.EAS_CLI,
+  workflowInterpolationContext,
+}: {
+  buildCredentials?: Ios.BuildCredentials;
+  triggeredBy?: Ios.Job['triggeredBy'];
+  workflowInterpolationContext?: Ios.Job['workflowInterpolationContext'];
+} = {}): Ios.Job {
+  return {
+    mode: BuildMode.BUILD,
+    platform: Platform.IOS,
+    triggeredBy,
+    type: Workflow.GENERIC,
+    projectArchive: {
+      type: ArchiveSourceType.URL,
+      url: 'https://turtle-v2-test-fixtures.s3.us-east-2.amazonaws.com/project.tar.gz',
+    },
+    scheme: 'turtlebareproj',
+    buildConfiguration: 'Release',
+    applicationArchivePath: './ios/build/*.ipa',
+    projectRootDirectory: '.',
+    cache: {
+      clear: false,
+      disabled: false,
+      paths: [],
+    },
+    secrets: {
+      buildCredentials,
+    },
+    appId: randomUUID(),
+    initiatingUserId: randomUUID(),
+    workflowInterpolationContext,
+  };
+}

packages/build-tools/src/__tests__/utils/logger.ts

@@ -0,0 +1,12 @@
+import { bunyan } from '@expo/logger';
+
+export function createMockLogger({ logToConsole = false } = {}): bunyan {
+  const logger = {
+    info: jest.fn(logToConsole ? console.info : () => {}),
+    debug: jest.fn(logToConsole ? console.debug : () => {}),
+    error: jest.fn(logToConsole ? console.error : () => {}),
+    warn: jest.fn(logToConsole ? console.warn : () => {}),
+    child: jest.fn().mockImplementation(() => createMockLogger({ logToConsole })),
+  } as unknown as bunyan;
+  return logger;
+}

packages/build-tools/src/android/__tests__/expoUpdates.test.ts

@@ -0,0 +1,147 @@
+import { AndroidConfig } from '@expo/config-plugins';
+import { vol } from 'memfs';
+import path from 'path';
+
+import {
+  AndroidMetadataName,
+  androidGetNativelyDefinedChannelAsync,
+  androidGetNativelyDefinedRuntimeVersionAsync,
+  androidSetChannelNativelyAsync,
+  androidSetRuntimeVersionNativelyAsync,
+} from '../expoUpdates';
+
+jest.mock('fs');
+const originalFs = jest.requireActual('fs');
+
+const channel = 'easupdatechannel';
+const manifestPath = '/app/android/app/src/main/AndroidManifest.xml';
+
+afterEach(() => {
+  vol.reset();
+});
+
+describe(androidSetChannelNativelyAsync, () => {
+  it('sets the channel', async () => {
+    vol.fromJSON(
+      {
+        'android/app/src/main/AndroidManifest.xml': originalFs.readFileSync(
+          path.join(__dirname, 'fixtures/NoMetadataAndroidManifest.xml'),
+          'utf-8'
+        ),
+      },
+      '/app'
+    );
+    const ctx = {
+      getReactNativeProjectDirectory: () => '/app',
+      job: { updates: { channel } },
+      logger: { info: () => {} },
+    };
+
+    await androidSetChannelNativelyAsync(ctx as any);
+
+    const newAndroidManifest = await AndroidConfig.Manifest.readAndroidManifestAsync(manifestPath);
+    const newValue = AndroidConfig.Manifest.getMainApplicationMetaDataValue(
+      newAndroidManifest,
+      AndroidMetadataName.UPDATES_CONFIGURATION_REQUEST_HEADERS_KEY
+    );
+    expect(newValue).toBeDefined();
+    expect(JSON.parse(newValue!)).toEqual({ 'expo-channel-name': channel });
+  });
+});
+
+describe(androidGetNativelyDefinedChannelAsync, () => {
+  it('gets the channel', async () => {
+    vol.fromJSON(
+      {
+        'android/app/src/main/AndroidManifest.xml': originalFs.readFileSync(
+          path.join(__dirname, 'fixtures/AndroidManifestWithChannel.xml'),
+          'utf-8'
+        ),
+      },
+      '/app'
+    );
+    const ctx = {
+      getReactNativeProjectDirectory: () => '/app',
+      logger: { info: () => {} },
+    };
+
+    await expect(androidGetNativelyDefinedChannelAsync(ctx as any)).resolves.toBe('staging-123');
+  });
+});
+
+describe(androidGetNativelyDefinedRuntimeVersionAsync, () => {
+  it('gets the native runtime version', async () => {
+    vol.fromJSON(
+      {
+        'android/app/src/main/AndroidManifest.xml': originalFs.readFileSync(
+          path.join(__dirname, 'fixtures/AndroidManifestWithRuntimeVersion.xml'),
+          'utf-8'
+        ),
+      },
+      '/app'
+    );
+    const ctx = {
+      getReactNativeProjectDirectory: () => '/app',
+      job: {},
+      logger: { info: () => {} },
+    };
+
+    const nativelyDefinedRuntimeVersion = await androidGetNativelyDefinedRuntimeVersionAsync(
+      ctx as any
+    );
+    expect(nativelyDefinedRuntimeVersion).toBe('exampleruntimeversion');
+  });
+});
+
+describe(androidSetRuntimeVersionNativelyAsync, () => {
+  it('sets the runtime version when nothing is set natively', async () => {
+    vol.fromJSON(
+      {
+        'android/app/src/main/AndroidManifest.xml': originalFs.readFileSync(
+          path.join(__dirname, 'fixtures/NoMetadataAndroidManifest.xml'),
+          'utf-8'
+        ),
+      },
+      '/app'
+    );
+    const ctx = {
+      getReactNativeProjectDirectory: () => '/app',
+      job: {},
+      logger: { info: () => {} },
+    };
+
+    await androidSetRuntimeVersionNativelyAsync(ctx as any, '1.2.3');
+
+    const newAndroidManifest = await AndroidConfig.Manifest.readAndroidManifestAsync(manifestPath);
+    const newValue = AndroidConfig.Manifest.getMainApplicationMetaDataValue(
+      newAndroidManifest,
+      AndroidMetadataName.RUNTIME_VERSION
+    );
+    expect(newValue).toBe('1.2.3');
+  });
+  it('updates the runtime version when value is already set natively', async () => {
+    vol.fromJSON(
+      {
+        'android/app/src/main/AndroidManifest.xml': originalFs.readFileSync(
+          path.join(__dirname, 'fixtures/AndroidManifestWithRuntimeVersion.xml'),
+          'utf-8'
+        ),
+      },
+      '/app'
+    );
+    const ctx = {
+      getReactNativeProjectDirectory: () => '/app',
+      job: {},
+      logger: { info: () => {} },
+    };
+
+    await androidSetRuntimeVersionNativelyAsync(ctx as any, '1.2.3');
+
+    const newAndroidManifest = await AndroidConfig.Manifest.readAndroidManifestAsync(manifestPath);
+    const newValue = AndroidConfig.Manifest.getMainApplicationMetaDataValue(
+      newAndroidManifest,
+      AndroidMetadataName.RUNTIME_VERSION
+    );
+    expect(newValue).toBe('1.2.3');
+  });
+});

packages/build-tools/src/android/__tests__/fixtures/AndroidManifestWithChannel.xml

@@ -0,0 +1,14 @@
+<manifest xmlns:android="http://schemas.android.com/apk/res/android" package="com.expo.mycoolapp">
+    <uses-permission android:name="android.permission.INTERNET"/>
+    <application android:name=".MainApplication" android:label="@string/app_name" android:icon="@mipmap/ic_launcher" android:roundIcon="@mipmap/ic_launcher_round" android:allowBackup="true" android:theme="@style/AppTheme">
+        <activity android:name=".MainActivity" android:launchMode="singleTask" android:label="@string/app_name" android:configChanges="keyboard|keyboardHidden|orientation|screenSize" android:windowSoftInputMode="adjustResize">
+            <intent-filter>
+                <action android:name="android.intent.action.MAIN"/>
+                <category android:name="android.intent.category.LAUNCHER"/>
+            </intent-filter>
+        </activity>
+        <activity android:name="com.facebook.react.devsupport.DevSettingsActivity"/>
+        <meta-data android:name="expo.modules.updates.EXPO_RELEASE_CHANNEL" android:value="default"/>
+        <meta-data android:name="expo.modules.updates.UPDATES_CONFIGURATION_REQUEST_HEADERS_KEY"  android:value="{&quot;expo-channel-name&quot;:&quot;staging-123&quot;}"/>
+    </application>
+</manifest>

packages/build-tools/src/android/__tests__/fixtures/AndroidManifestWithClassicReleaseChannel.xml

@@ -0,0 +1,13 @@
+<manifest xmlns:android="http://schemas.android.com/apk/res/android" package="com.expo.mycoolapp">
+    <uses-permission android:name="android.permission.INTERNET"/>
+    <application android:name=".MainApplication" android:label="@string/app_name" android:icon="@mipmap/ic_launcher" android:roundIcon="@mipmap/ic_launcher_round" android:allowBackup="true" android:theme="@style/AppTheme">
+        <activity android:name=".MainActivity" android:launchMode="singleTask" android:label="@string/app_name" android:configChanges="keyboard|keyboardHidden|orientation|screenSize" android:windowSoftInputMode="adjustResize">
+            <intent-filter>
+                <action android:name="android.intent.action.MAIN"/>
+                <category android:name="android.intent.category.LAUNCHER"/>
+            </intent-filter>
+        </activity>
+        <activity android:name="com.facebook.react.devsupport.DevSettingsActivity"/>
+        <meta-data android:name="expo.modules.updates.EXPO_RELEASE_CHANNEL" android:value="example_channel"/>
+    </application>
+</manifest>

packages/build-tools/src/android/__tests__/fixtures/AndroidManifestWithRuntimeVersion.xml

@@ -0,0 +1,14 @@
+<manifest xmlns:android="http://schemas.android.com/apk/res/android" package="com.expo.mycoolapp">
+    <uses-permission android:name="android.permission.INTERNET"/>
+    <application android:name=".MainApplication" android:label="@string/app_name" android:icon="@mipmap/ic_launcher" android:roundIcon="@mipmap/ic_launcher_round" android:allowBackup="true" android:theme="@style/AppTheme">
+        <activity android:name=".MainActivity" android:launchMode="singleTask" android:label="@string/app_name" android:configChanges="keyboard|keyboardHidden|orientation|screenSize" android:windowSoftInputMode="adjustResize">
+            <intent-filter>
+                <action android:name="android.intent.action.MAIN"/>
+                <category android:name="android.intent.category.LAUNCHER"/>
+            </intent-filter>
+        </activity>
+        <activity android:name="com.facebook.react.devsupport.DevSettingsActivity"/>
+        <meta-data android:name="expo.modules.updates.EXPO_RELEASE_CHANNEL" android:value="default"/>
+        <meta-data android:name="expo.modules.updates.EXPO_RUNTIME_VERSION" android:value="exampleruntimeversion"/>
+    </application>
+</manifest>

packages/build-tools/src/android/__tests__/fixtures/NoMetadataAndroidManifest.xml

@@ -0,0 +1,27 @@
+<manifest xmlns:android="http://schemas.android.com/apk/res/android"
+  package="com.expo.mycoolapp">
+
+    <uses-permission android:name="android.permission.INTERNET" />
+
+    <application
+      android:name=".MainApplication"
+      android:label="@string/app_name"
+      android:icon="@mipmap/ic_launcher"
+      android:roundIcon="@mipmap/ic_launcher_round"
+      android:allowBackup="true"
+      android:theme="@style/AppTheme">
+      <activity
+        android:name=".MainActivity"
+        android:launchMode="singleTask"
+        android:label="@string/app_name"
+        android:configChanges="keyboard|keyboardHidden|orientation|screenSize"
+        android:windowSoftInputMode="adjustResize">
+        <intent-filter>
+            <action android:name="android.intent.action.MAIN" />
+            <category android:name="android.intent.category.LAUNCHER" />
+        </intent-filter>
+      </activity>
+      <activity android:name="com.facebook.react.devsupport.DevSettingsActivity" />
+    </application>
+
+</manifest>

packages/build-tools/src/android/credentials.ts

@@ -0,0 +1,40 @@
+import { Android } from '@expo/eas-build-job';
+import fs from 'fs-extra';
+import nullthrows from 'nullthrows';
+import path from 'path';
+import { v4 as uuidv4 } from 'uuid';
+
+import { BuildContext } from '../context';
+
+async function restoreCredentials(ctx: BuildContext<Android.Job>): Promise<void> {
+  const { buildCredentials } = nullthrows(
+    ctx.job.secrets,
+    'Secrets must be defined for non-custom builds'
+  );
+  if (!buildCredentials) {
+    // TODO: sentry (should be detected earlier)
+    throw new Error('secrets are missing in the job object');
+  }
+  ctx.logger.info("Writing secrets to the project's directory");
+  const keystorePath = path.join(ctx.buildDirectory, `keystore-${uuidv4()}`);
+  await fs.writeFile(
+    keystorePath,
+    new Uint8Array(Buffer.from(buildCredentials.keystore.dataBase64, 'base64'))
+  );
+  const credentialsJson = {
+    android: {
+      keystore: {
+        keystorePath,
+        keystorePassword: buildCredentials.keystore.keystorePassword,
+        keyAlias: buildCredentials.keystore.keyAlias,
+        keyPassword: buildCredentials.keystore.keyPassword,
+      },
+    },
+  };
+  await fs.writeFile(
+    path.join(ctx.buildDirectory, 'credentials.json'),
+    JSON.stringify(credentialsJson)
+  );
+}
+
+export { restoreCredentials };

packages/build-tools/src/android/expoUpdates.ts

@@ -0,0 +1,106 @@
+import { AndroidConfig } from '@expo/config-plugins';
+import { BuildJob, Job } from '@expo/eas-build-job';
+import assert from 'assert';
+import fs from 'fs-extra';
+
+import { BuildContext } from '../context';
+
+export enum AndroidMetadataName {
+  UPDATES_CONFIGURATION_REQUEST_HEADERS_KEY = 'expo.modules.updates.UPDATES_CONFIGURATION_REQUEST_HEADERS_KEY',
+  RUNTIME_VERSION = 'expo.modules.updates.EXPO_RUNTIME_VERSION',
+}
+
+export async function androidSetRuntimeVersionNativelyAsync(
+  ctx: BuildContext<Job>,
+  runtimeVersion: string
+): Promise<void> {
+  const manifestPath = await AndroidConfig.Paths.getAndroidManifestAsync(
+    ctx.getReactNativeProjectDirectory()
+  );
+
+  if (!(await fs.pathExists(manifestPath))) {
+    throw new Error(`Couldn't find Android manifest at ${manifestPath}`);
+  }
+
+  const androidManifest = await AndroidConfig.Manifest.readAndroidManifestAsync(manifestPath);
+  const mainApp = AndroidConfig.Manifest.getMainApplicationOrThrow(androidManifest);
+  AndroidConfig.Manifest.addMetaDataItemToMainApplication(
+    mainApp,
+    AndroidMetadataName.RUNTIME_VERSION,
+    runtimeVersion,
+    'value'
+  );
+  await AndroidConfig.Manifest.writeAndroidManifestAsync(manifestPath, androidManifest);
+}
+
+export async function androidSetChannelNativelyAsync(ctx: BuildContext<BuildJob>): Promise<void> {
+  assert(ctx.job.updates?.channel, 'updates.channel must be defined');
+
+  const manifestPath = await AndroidConfig.Paths.getAndroidManifestAsync(
+    ctx.getReactNativeProjectDirectory()
+  );
+
+  if (!(await fs.pathExists(manifestPath))) {
+    throw new Error(`Couldn't find Android manifest at ${manifestPath}`);
+  }
+
+  const androidManifest = await AndroidConfig.Manifest.readAndroidManifestAsync(manifestPath);
+  const mainApp = AndroidConfig.Manifest.getMainApplicationOrThrow(androidManifest);
+  const stringifiedUpdatesRequestHeaders = AndroidConfig.Manifest.getMainApplicationMetaDataValue(
+    androidManifest,
+    AndroidMetadataName.UPDATES_CONFIGURATION_REQUEST_HEADERS_KEY
+  );
+  AndroidConfig.Manifest.addMetaDataItemToMainApplication(
+    mainApp,
+    AndroidMetadataName.UPDATES_CONFIGURATION_REQUEST_HEADERS_KEY,
+    JSON.stringify({
+      ...JSON.parse(stringifiedUpdatesRequestHeaders ?? '{}'),
+      'expo-channel-name': ctx.job.updates.channel,
+    }),
+    'value'
+  );
+  await AndroidConfig.Manifest.writeAndroidManifestAsync(manifestPath, androidManifest);
+}
+
+export async function androidGetNativelyDefinedChannelAsync(
+  ctx: BuildContext<Job>
+): Promise<string | null> {
+  const manifestPath = await AndroidConfig.Paths.getAndroidManifestAsync(
+    ctx.getReactNativeProjectDirectory()
+  );
+
+  if (!(await fs.pathExists(manifestPath))) {
+    return null;
+  }
+
+  const androidManifest = await AndroidConfig.Manifest.readAndroidManifestAsync(manifestPath);
+  const stringifiedUpdatesRequestHeaders = AndroidConfig.Manifest.getMainApplicationMetaDataValue(
+    androidManifest,
+    AndroidMetadataName.UPDATES_CONFIGURATION_REQUEST_HEADERS_KEY
+  );
+  try {
+    const updatesRequestHeaders = JSON.parse(stringifiedUpdatesRequestHeaders ?? '{}');
+    return updatesRequestHeaders['expo-channel-name'] ?? null;
+  } catch (err: any) {
+    throw new Error(
+      `Failed to parse ${AndroidMetadataName.UPDATES_CONFIGURATION_REQUEST_HEADERS_KEY} from AndroidManifest.xml: ${err.message}`
+    );
+  }
+}
+
+export async function androidGetNativelyDefinedRuntimeVersionAsync(
+  ctx: BuildContext<Job>
+): Promise<string | null> {
+  const manifestPath = await AndroidConfig.Paths.getAndroidManifestAsync(
+    ctx.getReactNativeProjectDirectory()
+  );
+  if (!(await fs.pathExists(manifestPath))) {
+    return null;
+  }
+
+  const androidManifest = await AndroidConfig.Manifest.readAndroidManifestAsync(manifestPath);
+  return AndroidConfig.Manifest.getMainApplicationMetaDataValue(
+    androidManifest,
+    AndroidMetadataName.RUNTIME_VERSION
+  );
+}

packages/build-tools/src/android/gradle.ts

@@ -0,0 +1,127 @@
+import { Android, Env, Job, Platform } from '@expo/eas-build-job';
+import { bunyan } from '@expo/logger';
+import spawn, { SpawnPromise, SpawnResult } from '@expo/turtle-spawn';
+import assert from 'assert';
+import fs from 'fs-extra';
+import path from 'path';
+
+import { BuildContext } from '../context';
+import { getParentAndDescendantProcessPidsAsync } from '../utils/processes';
+
+export async function ensureLFLineEndingsInGradlewScript<TJob extends Job>(
+  ctx: BuildContext<TJob>
+): Promise<void> {
+  const gradlewPath = path.join(ctx.getReactNativeProjectDirectory(), 'android', 'gradlew');
+  const gradlewContent = await fs.readFile(gradlewPath, 'utf8');
+  if (gradlewContent.includes('\r')) {
+    ctx.logger.info('Replacing CRLF line endings with LF in gradlew script');
+    await fs.writeFile(gradlewPath, gradlewContent.replace(/\r\n/g, '\n'), 'utf8');
+  }
+}
+
+export async function runGradleCommand(
+  ctx: BuildContext<Job>,
+  {
+    logger,
+    gradleCommand,
+    androidDir,
+    extraEnv,
+  }: { logger: bunyan; gradleCommand: string; androidDir: string; extraEnv?: Env }
+): Promise<void> {
+  logger.info(`Running 'gradlew ${gradleCommand}' in ${androidDir}`);
+  await fs.chmod(path.join(androidDir, 'gradlew'), 0o755);
+  const verboseFlag = ctx.env['EAS_VERBOSE'] === '1' ? '--info' : '';
+
+  const spawnPromise = spawn(
+    'bash',
+    ['-c', `./gradlew ${gradleCommand} --profile ${verboseFlag}`],
+    {
+      cwd: androidDir,
+      logger,
+      lineTransformer: (line?: string) => {
+        if (!line || /^\.+$/.exec(line)) {
+          return null;
+        } else {
+          return line;
+        }
+      },
+      env: {
+        ...ctx.env,
+        ...extraEnv,
+        ...resolveVersionOverridesEnvs(ctx),
+        LC_ALL: 'C.UTF-8',
+      },
+    }
+  );
+  if (ctx.env.EAS_BUILD_RUNNER === 'eas-build' && process.platform === 'linux') {
+    adjustOOMScore(spawnPromise, logger);
+  }
+
+  await spawnPromise;
+}
+
+/**
+ * OOM Killer sometimes kills worker server while build is exceeding memory limits.
+ * `oom_score_adj` is a value between -1000 and 1000 and it defaults to 0.
+ * It defines which process is more likely to get killed (higher value more likely).
+ *
+ * This function sets oom_score_adj for Gradle process and all its child processes.
+ */
+function adjustOOMScore(spawnPromise: SpawnPromise<SpawnResult>, logger: bunyan): void {
+  setTimeout(
+    async () => {
+      try {
+        assert(spawnPromise.child.pid);
+        const pids = await getParentAndDescendantProcessPidsAsync(spawnPromise.child.pid);
+        await Promise.all(
+          pids.map(async (pid: number) => {
+            // Value 800 is just a guess here. It's probably higher than most other
+            // process. I didn't want to set it any higher, because I'm not sure if OOM Killer
+            // can start killing processes when there is still enough memory left.
+            const oomScoreOverride = 800;
+            await fs.writeFile(`/proc/${pid}/oom_score_adj`, `${oomScoreOverride}\n`);
+          })
+        );
+      } catch (err: any) {
+        logger.debug({ err, stderr: err?.stderr }, 'Failed to override oom_score_adj');
+      }
+    },
+    // Wait 20 seconds to make sure all child processes are started
+    20000
+  );
+}
+
+// Version envs should be set at the beginning of the build, but when building
+// from github those values are resolved later.
+function resolveVersionOverridesEnvs(ctx: BuildContext<Job>): Env {
+  const extraEnvs: Env = {};
+  if (
+    ctx.job.platform === Platform.ANDROID &&
+    ctx.job.version?.versionCode &&
+    !ctx.env.EAS_BUILD_ANDROID_VERSION_CODE
+  ) {
+    extraEnvs.EAS_BUILD_ANDROID_VERSION_CODE = ctx.job.version.versionCode;
+  }
+  if (
+    ctx.job.platform === Platform.ANDROID &&
+    ctx.job.version?.versionName &&
+    !ctx.env.EAS_BUILD_ANDROID_VERSION_NAME
+  ) {
+    extraEnvs.EAS_BUILD_ANDROID_VERSION_NAME = ctx.job.version.versionName;
+  }
+  return extraEnvs;
+}
+
+export function resolveGradleCommand(job: Android.Job): string {
+  if (job.gradleCommand) {
+    return job.gradleCommand;
+  } else if (job.developmentClient) {
+    return ':app:assembleDebug';
+  } else if (!job.buildType) {
+    return ':app:bundleRelease';
+  } else if (job.buildType === Android.BuildType.APK) {
+    return ':app:assembleRelease';
+  } else {
+    return ':app:bundleRelease';
+  }
+}

packages/build-tools/src/android/gradleProfile.ts

@@ -0,0 +1,231 @@
+import { XMLParser } from 'fast-xml-parser';
+import fs from 'fs-extra';
+import path from 'path';
+
+export interface GradleProfileTask {
+  path: string;
+  durationMs: number;
+  result: string;
+}
+
+export async function parseGradleProfile(androidDir: string): Promise<GradleProfileTask[]> {
+  const profileDir = path.join(androidDir, 'build', 'reports', 'profile');
+  // Gradle profile may not exist for all builds (e.g. custom, repack
+  // jobs). We should short circuit and not unnecessarily log.
+  if (!(await fs.pathExists(profileDir))) {
+    return [];
+  }
+
+  const files = await fs.readdir(profileDir);
+  const htmlFile = files
+    .filter(f => f.startsWith('profile-') && f.endsWith('.html'))
+    .sort()
+    .pop();
+
+  if (!htmlFile) {
+    throw new Error(`No Gradle profile HTML found in ${profileDir}`);
+  }
+
+  const html = await fs.readFile(path.join(profileDir, htmlFile), 'utf8');
+
+  // Locate the <h2>Task Execution</h2> heading and extract its <table>
+  const headingMatch = html.match(/<h2[^>]*>\s*Task Execution\s*<\/h2>/i);
+  if (!headingMatch || headingMatch.index === undefined) {
+    throw new Error('Could not find Task Execution section in Gradle profile');
+  }
+
+  const sectionStart = headingMatch.index;
+  const tableStart = html.indexOf('<table', sectionStart);
+  const tableEnd = html.indexOf('</table>', tableStart);
+  if (tableStart === -1 || tableEnd === -1) {
+    throw new Error('Could not find task execution table in Gradle profile');
+  }
+
+  const tableHtml = html.slice(tableStart, tableEnd + '</table>'.length);
+  const parser = new XMLParser({
+    ignoreAttributes: true,
+    isArray: name => name === 'tr' || name === 'td',
+    trimValues: true,
+  });
+
+  const parsed = parser.parse(tableHtml);
+  const rows: any[] = parsed?.table?.tbody?.tr ?? parsed?.table?.tr ?? [];
+
+  const tasks: GradleProfileTask[] = [];
+  for (const row of rows) {
+    const cells: unknown[] = row?.td;
+    if (!cells || cells.length < 2) {
+      continue;
+    }
+
+    const taskPath = String(cells[0] ?? '').trim();
+    const durationStr = String(cells[1] ?? '').trim();
+    const result = String(cells[2] ?? '').trim() || 'executed';
+
+    if (!taskPath || !durationStr) {
+      continue;
+    }
+
+    const durationMs = parseDurationToMs(durationStr);
+    tasks.push({ path: taskPath, durationMs, result: result.toLowerCase() });
+  }
+
+  return tasks;
+}
+
+function parseDurationToMs(duration: string): number {
+  // Gradle profile durations can be like "1.234s", "0.045s", "12.5s"
+  const secondsMatch = duration.match(/^([\d.]+)s$/);
+  if (secondsMatch) {
+    return Math.round(parseFloat(secondsMatch[1]) * 1000);
+  }
+  return 0;
+}
+
+function formatSeconds(ms: number): string {
+  const s = ms / 1000;
+  if (s < 0.1) {
+    return `${ms}ms`;
+  }
+  return `${s.toFixed(1)}s`;
+}
+
+export function formatGradleProfileReport(tasks: GradleProfileTask[]): string {
+  // Filter out tasks under 1 second
+  const significantTasks = tasks.filter(t => t.durationMs >= 1000);
+
+  // Separate module totals from individual tasks
+  const moduleTotals = significantTasks.filter(t => t.result === '(total)');
+  const individualTasks = significantTasks.filter(t => t.result !== '(total)');
+
+  // Group individual tasks by their module prefix
+  const moduleChildren = new Map<string, GradleProfileTask[]>();
+  const orphanTasks: GradleProfileTask[] = [];
+
+  for (const task of individualTasks) {
+    const parent = moduleTotals.find(m => task.path.startsWith(m.path + ':'));
+    if (parent) {
+      const children = moduleChildren.get(parent.path) ?? [];
+      children.push(task);
+      moduleChildren.set(parent.path, children);
+    } else {
+      orphanTasks.push(task);
+    }
+  }
+
+  // Sort module totals by duration, sort children within each module
+  const sortedModules = [...moduleTotals].sort((a, b) => b.durationMs - a.durationMs);
+  for (const children of moduleChildren.values()) {
+    children.sort((a, b) => b.durationMs - a.durationMs);
+  }
+  orphanTasks.sort((a, b) => b.durationMs - a.durationMs);
+
+  // Build display rows: [displayName, task]
+  const rows: { displayName: string; task: GradleProfileTask }[] = [];
+
+  for (const mod of sortedModules) {
+    rows.push({ displayName: mod.path, task: mod });
+    const children = moduleChildren.get(mod.path) ?? [];
+    for (let i = 0; i < children.length; i++) {
+      const isLast = i === children.length - 1;
+      const prefix = isLast ? '  └─ ' : '  ├─ ';
+      const shortName = children[i].path.slice(mod.path.length + 1);
+      rows.push({ displayName: prefix + shortName, task: children[i] });
+    }
+  }
+
+  for (const task of orphanTasks) {
+    rows.push({ displayName: task.path, task });
+  }
+
+  // Compute totals from individual tasks only (avoid double-counting)
+  const totalMs = individualTasks.reduce((sum, t) => sum + t.durationMs, 0);
+  const maxMs = totalMs || 1;
+
+  const nameWidth = Math.max(4, ...rows.map(r => r.displayName.length)) + 2;
+  const barMaxWidth = 20;
+
+  const header =
+    '┌─' +
+    '─'.repeat(nameWidth) +
+    '─┬────────────┬──────────┬────────────┬─' +
+    '─'.repeat(barMaxWidth) +
+    '─┐';
+  const divider =
+    '├─' +
+    '─'.repeat(nameWidth) +
+    '─┼────────────┼──────────┼────────────┼─' +
+    '─'.repeat(barMaxWidth) +
+    '─┤';
+  const footer =
+    '└─' +
+    '─'.repeat(nameWidth) +
+    '─┴────────────┴──────────┴────────────┴─' +
+    '─'.repeat(barMaxWidth) +
+    '─┘';
+
+  const taskCount = individualTasks.length;
+  const cachedCount = individualTasks.filter(t => t.result !== 'executed').length;
+  const lines: string[] = [];
+
+  lines.push('Gradle Build — Task Execution Profile');
+  const cachedSuffix = cachedCount > 0 ? ` (${cachedCount} cached/up-to-date)` : '';
+  lines.push(`${taskCount} tasks${cachedSuffix}, total task time: ${formatSeconds(totalMs)}`);
+  lines.push('% Time = share of total task execution time');
+  lines.push('');
+  lines.push(header);
+  lines.push(
+    '│ ' +
+      'Task'.padEnd(nameWidth) +
+      ' │ ' +
+      'Duration'.padStart(10) +
+      ' │ ' +
+      '% Time'.padStart(8) +
+      ' │ ' +
+      'Result'.padEnd(10) +
+      ' │ ' +
+      ' '.repeat(barMaxWidth) +
+      ' │'
+  );
+  lines.push(divider);
+
+  for (const row of rows) {
+    const pct = totalMs === 0 ? 0 : (row.task.durationMs / totalMs) * 100;
+    const barLength = Math.round((row.task.durationMs / maxMs) * barMaxWidth);
+    const bar = '█'.repeat(barLength) + '░'.repeat(barMaxWidth - barLength);
+    const result = row.task.result === '(total)' ? 'total' : row.task.result;
+
+    lines.push(
+      '│ ' +
+        row.displayName.padEnd(nameWidth) +
+        ' │ ' +
+        formatSeconds(row.task.durationMs).padStart(10) +
+        ' │ ' +
+        `${pct.toFixed(1)}%`.padStart(8) +
+        ' │ ' +
+        result.padEnd(10) +
+        ' │ ' +
+        bar +
+        ' │'
+    );
+  }
+
+  lines.push(divider);
+  lines.push(
+    '│ ' +
+      'TOTAL'.padEnd(nameWidth) +
+      ' │ ' +
+      formatSeconds(totalMs).padStart(10) +
+      ' │ ' +
+      '100.0%'.padStart(8) +
+      ' │ ' +
+      ' '.repeat(10) +
+      ' │ ' +
+      ' '.repeat(barMaxWidth) +
+      ' │'
+  );
+  lines.push(footer);
+  lines.push('');
+
+  return lines.join('\n');
+}

packages/build-tools/src/buildErrors/__tests__/detectError.test.ts

@@ -0,0 +1,312 @@
+import { BuildMode, BuildPhase, Job, Platform, errors } from '@expo/eas-build-job';
+import { vol } from 'memfs';
+import path from 'path';
+
+import { resolveBuildPhaseErrorAsync } from '../detectError';
+
+jest.mock('fs');
+const originalFs = jest.requireActual('fs');
+
+afterEach(() => {
+  vol.reset();
+});
+
+describe(resolveBuildPhaseErrorAsync, () => {
+  it('detects log for corrupted npm package', async () => {
+    const fakeError = new Error();
+    const err = await resolveBuildPhaseErrorAsync(
+      fakeError,
+      [
+        '[stderr] WARN tarball tarball data for @typescript-eslint/[email protected] (sha512-cozo/GbwixVR0sgfHItz3t1yXu521yn71Wj6PlYCFA3WPhy51CUPkifFKfBis91bDclGmAY45hhaAXVjdn4new==) seems to be corrupted. Trying again.',
+      ],
+      {
+        job: { platform: Platform.ANDROID } as Job,
+        phase: BuildPhase.INSTALL_DEPENDENCIES,
+        env: {},
+      },
+      '/fake/path'
+    );
+    expect(err.errorCode).toBe(errors.ErrorCode.UNKNOWN_ERROR);
+    expect(err.message).toBe(
+      'Unknown error. See logs of the Install dependencies build phase for more information.'
+    );
+    expect(err.trackingCode).toBe('NPM_CORRUPTED_PACKAGE');
+    expect(err.metadata).toEqual({
+      packageName: '@typescript-eslint/[email protected]',
+    });
+  });
+
+  it('detects log for invalid bundler and reports it to user', async () => {
+    const fakeError = new Error();
+    const err = await resolveBuildPhaseErrorAsync(
+      fakeError,
+      [
+        "/System/Library/Frameworks/Ruby.framework/Versions/2.6/usr/lib/ruby/2.6.0/rubygems/dependency.rb:313:in `to_specs': Could not find 'bundler' (2.2.3) required by your /Users/expo/project/build/ios/Gemfile.lock. (Gem::MissingSpecVersionError)",
+      ],
+      {
+        job: { platform: Platform.IOS } as Job,
+        phase: BuildPhase.RUN_FASTLANE,
+        env: {},
+      },
+      '/fake/path'
+    );
+    expect(err.errorCode).toBe('EAS_BUILD_UNSUPPORTED_BUNDLER_VERSION_ERROR');
+    expect(err.message).toBe(
+      'Your project requires a different version of the Ruby "bundler" program than the version installed in this EAS Build environment. You can specify which version of "bundler" to install by specifying the version under "build"→[buildProfileName]→"ios"→"bundler" in eas.json.'
+    );
+    expect(err.trackingCode).toBeUndefined();
+    expect(err.metadata).toBeUndefined();
+  });
+
+  it('does not detect errors if they show up in different build phase', async () => {
+    const fakeError = new Error();
+    const err = await resolveBuildPhaseErrorAsync(
+      fakeError,
+      [
+        "/System/Library/Frameworks/Ruby.framework/Versions/2.6/usr/lib/ruby/2.6.0/rubygems/dependency.rb:313:in `to_specs': Could not find 'bundler' (2.2.3) required by your /Users/expo/project/build/ios/Gemfile.lock. (Gem::MissingSpecVersionError)",
+      ],
+      {
+        job: { platform: Platform.IOS } as Job,
+        phase: BuildPhase.INSTALL_DEPENDENCIES, // it should be in RUN_FASTLANE
+        env: {},
+      },
+      '/fake/path'
+    );
+    expect(err.errorCode).toBe(errors.ErrorCode.UNKNOWN_ERROR);
+    expect(err.message).toBe(
+      'Unknown error. See logs of the Install dependencies build phase for more information.'
+    );
+    expect(err.trackingCode).toBeUndefined();
+  });
+
+  it('detects npm cache error if cache is enabled', async () => {
+    const mockEnv = {
+      EAS_BUILD_NPM_CACHE_URL: 'https://dominik.sokal.pl/npm/cache',
+    };
+
+    const fakeError = new Error();
+    const err = await resolveBuildPhaseErrorAsync(
+      fakeError,
+      [`Blah blah Error ... ${mockEnv.EAS_BUILD_NPM_CACHE_URL}`],
+      {
+        job: { platform: Platform.ANDROID } as Job,
+        phase: BuildPhase.INSTALL_DEPENDENCIES,
+        env: mockEnv,
+      },
+      '/fake/path'
+    );
+    expect(err.errorCode).toBe(errors.ErrorCode.UNKNOWN_ERROR);
+    expect(err.message).toBe(
+      'Unknown error. See logs of the Install dependencies build phase for more information.'
+    );
+    expect(err.trackingCode).toBe('NPM_CACHE_ERROR');
+  });
+
+  it('does not detect npm cache error if cache is disabled', async () => {
+    const mockEnv = {
+      EAS_BUILD_NPM_CACHE_URL: 'https://dominik.sokal.pl/npm/cache',
+    };
+
+    const fakeError = new Error();
+    const err = await resolveBuildPhaseErrorAsync(
+      fakeError,
+      [`Blah blah Error ... ${mockEnv.EAS_BUILD_NPM_CACHE_URL}`],
+      {
+        job: { platform: Platform.ANDROID } as Job,
+        phase: BuildPhase.INSTALL_DEPENDENCIES,
+        env: {},
+      },
+      '/fake/path'
+    );
+    expect(err.errorCode).toBe(errors.ErrorCode.UNKNOWN_ERROR);
+    expect(err.message).toBe(
+      'Unknown error. See logs of the Install dependencies build phase for more information.'
+    );
+    expect(err.trackingCode).toBeUndefined();
+  });
+
+  it('detects xcode line error', async () => {
+    vol.fromJSON({
+      '/path/to/xcodelogs.log': originalFs.readFileSync(
+        path.resolve('./src/buildErrors/__tests__/fixtures/xcode.log'),
+        'utf-8'
+      ),
+    });
+
+    const fakeError = new Error();
+    const err = await resolveBuildPhaseErrorAsync(
+      fakeError,
+      [''],
+      {
+        job: { platform: Platform.IOS } as Job,
+        phase: BuildPhase.RUN_FASTLANE,
+        env: {},
+      },
+      '/path/to/'
+    );
+    expect(err.errorCode).toBe('XCODE_RESOURCE_BUNDLE_CODE_SIGNING_ERROR');
+    expect(err.trackingCode).toBeUndefined();
+  });
+
+  it('detects minimum deployment target error correctly', async () => {
+    const fakeError = new Error();
+    const err = await resolveBuildPhaseErrorAsync(
+      fakeError,
+      [
+        'CocoaPods could not find compatible versions for pod "react-native-google-maps":16  In Podfile:17    react-native-google-maps (from `/Users/expo/workingdir/build/node_modules/react-native-maps`)18Specs satisfying the `react-native-google-maps (from `/Users/expo/workingdir/build/node_modules/react-native-maps`)` dependency were found, but they required a higher minimum deployment target.19Error: Compatible versions of some pods could not be resolved.',
+      ],
+      {
+        job: { platform: Platform.IOS } as Job,
+        phase: BuildPhase.INSTALL_PODS,
+        env: {},
+      },
+      '/fake/path'
+    );
+    expect(err.errorCode).toBe('EAS_BUILD_HIGHER_MINIMUM_DEPLOYMENT_TARGET_ERROR');
+    expect(err.trackingCode).toBeUndefined();
+  });
+
+  it('detects provisioning profile mismatch error correctly', async () => {
+    const fakeError = new Error();
+    const err = await resolveBuildPhaseErrorAsync(
+      fakeError,
+      [
+        `No provisioning profile for application: '_floatsignTemp/Payload/EcoBatteryPREVIEW.app' with bundle identifier 'com.ecobattery.ecobattery-preview'`,
+      ],
+      {
+        job: { platform: Platform.IOS, mode: BuildMode.RESIGN } as Job,
+        phase: BuildPhase.RUN_FASTLANE,
+        env: {},
+      },
+      '/fake/path'
+    );
+    expect(err.errorCode).toBe('EAS_BUILD_RESIGN_PROVISIONING_PROFILE_MISMATCH_ERROR');
+    expect(err.trackingCode).toBeUndefined();
+  });
+
+  it('detects generic "Run Fastlane" error for resign correctly', async () => {
+    const fakeError = new Error();
+    const err = await resolveBuildPhaseErrorAsync(
+      fakeError,
+      [`other error`],
+      {
+        job: { platform: Platform.IOS, mode: BuildMode.RESIGN } as Job,
+        phase: BuildPhase.RUN_FASTLANE,
+        env: {},
+      },
+      '/fake/path'
+    );
+    expect(err.errorCode).toBe('EAS_BUILD_UNKNOWN_FASTLANE_RESIGN_ERROR');
+    expect(err.trackingCode).toBeUndefined();
+  });
+
+  it('detects build error in "Run Fastlane" phase correctly', async () => {
+    const fakeError = new Error();
+    const err = await resolveBuildPhaseErrorAsync(
+      fakeError,
+      [`some build error`],
+      {
+        job: { platform: Platform.IOS, mode: BuildMode.BUILD } as Job,
+        phase: BuildPhase.RUN_FASTLANE,
+        env: {},
+      },
+      '/fake/path'
+    );
+    expect(err.errorCode).toBe('EAS_BUILD_UNKNOWN_FASTLANE_ERROR');
+    expect(err.trackingCode).toBeUndefined();
+  });
+
+  it('detects provisioning profile mismatch error correctly', async () => {
+    const xcodeLogs = `Intermediates.noindex/Pods.build/Release-iphonesimulator/Yoga.build/Objects-normal/arm64/82b82416624d2658e5098eb0a28c15c5-common-args.resp
+-target arm64-apple-ios15.0-simulator '-std=gnu++14' '-stdlib=libc++' -fmodules '-fmodules-cache-path=/Users/expo/workingdir/build/packages/apps/NFLNetwork/ios/build/ModuleCache.noindex' '-fmodule-name=yoga' -fpascal-strings -Os -fno-common '-DPOD_CONFIGURATION_RELEASE=1' '-DCOCOAPODS=1' -isysroot /Applications/Xcode.app/Contents/Developer/Platforms/iPhoneSimulator.platform/Developer/SDKs/iPhoneSimulator18.1.sdk -g -iquote /Users/expo/workingdir/build/packages/apps/NFLNetwork/ios/build/Build/Intermediates.noindex/Pods.build/Release-iphonesimulator/Yoga.build/Yoga-generated-files.hmap -I/Users/expo/workingdir/build/packages/apps/NFLNetwork/ios/build/Build/Intermediates.noindex/Pods.build/Release-iphonesimulator/Yoga.build/Yoga-own-target-headers.hmap -I/Users/expo/workingdir/build/packages/apps/NFLNetwork/ios/build/Build/Intermediates.noindex/Pods.build/Release-iphonesimulator/Yoga.build/Yoga-all-non-framework-target-headers.hmap -ivfsoverlay /Users/expo/workingdir/build/packages/apps/NFLNetwork/ios/build/Build/Intermediates.noindex/Pods.build/Release-iphonesimulator/Pods-8699adb1dd336b26511df848a716bd42-VFS-iphonesimulator/all-product-headers.yaml -iquote /Users/expo/workingdir/build/packages/apps/NFLNetwork/ios/build/Build/Intermediates.noindex/Pods.build/Release-iphonesimulator/Yoga.build/Yoga-project-headers.hmap -I/Users/expo/workingdir/build/packages/apps/NFLNetwork/ios/build/Build/Products/Release-iphonesimulator/Yoga/include -I/Users/expo/workingdir/build/packages/apps/NFLNetwork/ios/Pods/Headers/Private -I/Users/expo/workingdir/build/packages/apps/NFLNetwork/ios/Pods/Headers/Private/Yoga -I/Users/expo/workingdir/build/packages/apps/NFLNetwork/ios/Pods/Headers/Public -I/Users/expo/workingdir/build/packages/apps/NFLNetwork/ios/Pods/Headers/Public/Yoga -I/Users/expo/workingdir/build/packages/apps/NFLNetwork/ios/build/Build/Intermediates.noindex/Pods.build/Release-iphonesimulator/Yoga.build/DerivedSources-normal/arm64 -I/Users/expo/workingdir/build/packages/apps/NFLNetwork/ios/build/Build/Intermediates.noindex/Pods.build/Release-iphonesimulator/Yoga.build/DerivedSources/arm64 -I/Users/expo/workingdir/build/packages/apps/NFLNetwork/ios/build/Build/Intermediates.noindex/Pods.build/Release-iphonesimulator/Yoga.build/DerivedSources -F/Users/expo/workingdir/build/packages/apps/NFLNetwork/ios/build/Build/Products/Release-iphonesimulator/Yoga
+MkDir /Users/expo/workingdir/build/packages/apps/NFLNetwork/ios/build/Build/Products/Release-iphonesimulator/expo-dev-menu/EXDevMenu.bundle (in target 'expo-dev-menu-EXDevMenu' from project 'Pods')
+    cd /Users/expo/workingdir/build/packages/apps/NFLNetwork/ios/Pods
+    /bin/mkdir -p /Users/expo/workingdir/build/packages/apps/NFLNetwork/ios/build/Build/Products/Release-iphonesimulator/expo-dev-menu/EXDevMenu.bundle
+
+MkDir /Users/expo/workingdir/build/packages/apps/NFLNetwork/ios/build/Build/Products/Release-iphonesimulator/expo-dev-launcher/EXDevLauncher.bundle (in target 'expo-dev-launcher-EXDevLauncher' from project 'Pods')
+    cd /Users/expo/workingdir/build/packages/apps/NFLNetwork/ios/Pods
+    /bin/mkdir -p /Users/expo/workingdir/build/packages/apps/NFLNetwork/ios/build/Build/Products/Release-iphonesimulator/expo-dev-launcher/EXDevLauncher.bundle
+
+ProcessXCFramework /Users/expo/workingdir/build/packages/video/ios/Vendor/dependency/ProgrammaticAccessLibrary.xcframework /Users/expo/workingdir/build/packages/apps/NFLNetwork/ios/build/Build/Products/Release-iphonesimulator/ProgrammaticAccessLibrary.framework ios simulator
+    cd /Users/expo/workingdir/build/packages/apps/NFLNetwork/ios
+    builtin-process-xcframework --xcframework /Users/expo/workingdir/build/packages/video/ios/Vendor/dependency/ProgrammaticAccessLibrary.xcframework --platform ios --environment simulator --target-path /Users/expo/workingdir/build/packages/apps/NFLNetwork/ios/build/Build/Products/Release-iphonesimulator
+/Users/expo/workingdir/build/packages/video/ios/Vendor/dependency/ProgrammaticAccessLibrary.xcframework:1:1: error: The signature of “ProgrammaticAccessLibrary.xcframework” cannot be verified.
+    note: A sealed resource is missing or invalid
+    note: /Users/expo/workingdir/build/packages/video/ios/Vendor/dependency/ProgrammaticAccessLibrary.xcframework: a sealed resource is missing or invalid
+file modified: /Users/expo/workingdir/build/packages/video/ios/Vendor/dependency/ProgrammaticAccessLibrary.xcframework/ios-arm64_x86_64-simulator/ProgrammaticAccessLibrary.framework/ProgrammaticAccessLibrary
+file modified: /Users/expo/workingdir/build/packages/video/ios/Vendor/dependency/ProgrammaticAccessLibrary.xcframework/ios-arm64/ProgrammaticAccessLibrary.framework/ProgrammaticAccessLibrary
+error: Some other error
+log
+log
+log
+error: The last one
+log
+note`;
+
+    vol.fromJSON({
+      '/path/to/xcode.log': xcodeLogs,
+    });
+
+    const fakeError = new Error();
+    const err = await resolveBuildPhaseErrorAsync(
+      fakeError,
+      [`some logs`],
+      {
+        job: { platform: Platform.IOS, mode: BuildMode.BUILD } as Job,
+        phase: BuildPhase.RUN_FASTLANE,
+        env: {},
+      },
+      '/path/to'
+    );
+    expect(err.errorCode).toBe('XCODE_BUILD_ERROR');
+    expect(err.trackingCode).toBeUndefined();
+    expect(err.message)
+      .toBe(`The "Run fastlane" step failed because of an error in the Xcode build process. We automatically detected following errors in your Xcode build logs:
+- The signature of “ProgrammaticAccessLibrary.xcframework” cannot be verified.
+- Some other error
+- The last one
+Refer to "Xcode Logs" below for additional, more detailed logs.`);
+  });
+
+  it('detects MAVEN_CACHE_ERROR correctly', async () => {
+    const err = await resolveBuildPhaseErrorAsync(
+      new Error(),
+      [`https://szymon.pl/maven/cache`],
+      {
+        job: { platform: Platform.ANDROID, mode: BuildMode.BUILD } as Job,
+        phase: BuildPhase.RUN_GRADLEW,
+        env: {
+          EAS_BUILD_MAVEN_CACHE_URL: 'https://szymon.pl/maven/cache',
+        },
+      },
+      '/fake/path'
+    );
+
+    expect(err.errorCode).toBe('EAS_BUILD_UNKNOWN_GRADLE_ERROR');
+    expect(err.trackingCode).toBe('MAVEN_CACHE_ERROR');
+    expect(err.message).toBe(
+      `Gradle build failed with unknown error. See logs for the "Run gradlew" phase for more information.`
+    );
+  });
+
+  it('does not throw MAVEN_CACHE_ERROR if "Could not find BlurView-version-2.0.3.jar" log is present', async () => {
+    const err = await resolveBuildPhaseErrorAsync(
+      new Error(),
+      [`Could not find BlurView-version-2.0.3.jar sth sthelse https://szymon.pl/maven/cache`],
+      {
+        job: { platform: Platform.ANDROID, mode: BuildMode.BUILD } as Job,
+        phase: BuildPhase.RUN_GRADLEW,
+        env: {
+          EAS_BUILD_MAVEN_CACHE_URL: 'https://szymon.pl/maven/cache',
+        },
+      },
+      '/fake/path'
+    );
+
+    expect(err.errorCode).toBe('EAS_BUILD_UNKNOWN_GRADLE_ERROR');
+    expect(err.trackingCode).toBeUndefined();
+    expect(err.message).toBe(
+      `Gradle build failed with unknown error. See logs for the "Run gradlew" phase for more information.`
+    );
+  });
+});

packages/build-tools/src/buildErrors/__tests__/fixtures/xcode.log

@@ -0,0 +1 @@
+/Users/expo/workingdir/build/managed/ios/Pods/Pods.xcodeproj: error: Signing for "EXConstants-EXConstants" requires a development team. Select a development team in the Signing & Capabilities editor. (in target 'EXConstants-EXConstants' from project 'Pods')

packages/build-tools/src/buildErrors/buildErrorHandlers.ts

@@ -0,0 +1,364 @@
+import { BuildPhase, Platform } from '@expo/eas-build-job';
+import escapeRegExp from 'lodash/escapeRegExp';
+
+import { ErrorContext, ErrorHandler } from './errors.types';
+
+export class TrackedBuildError extends Error {
+  constructor(
+    public errorCode: string,
+    public message: string,
+    public metadata?: Record<string, unknown>
+  ) {
+    super(message);
+  }
+}
+
+export const buildErrorHandlers: ErrorHandler<TrackedBuildError>[] = [
+  {
+    platform: Platform.IOS,
+    phase: BuildPhase.INSTALL_PODS,
+    // example log:
+    // CDN: trunk URL couldn't be downloaded: https://cdn.jsdelivr.net/cocoa/Specs/2/a/e/MultiplatformBleAdapter/0.0.3/MultiplatformBleAdapter.podspec.json Response: 429 429: Too Many Requests
+    regexp: /CDN: trunk URL couldn't be downloaded.* Response: 429 429: Too Many Requests/,
+    createError: () =>
+      new TrackedBuildError('COCOAPODS_TO_MANY_REQUEST', 'cocoapods: too many requests'),
+  },
+  {
+    phase: BuildPhase.INSTALL_DEPENDENCIES,
+    // Host key verification failed.
+    // fatal: Could not read from remote repository.
+    regexp: /Host key verification failed\.\nfatal: Could not read from remote repository/,
+    createError: () => new TrackedBuildError('NPM_INSTALL_SSH_AUTHENTICATION', 'Missing ssh key.'),
+  },
+  {
+    phase: BuildPhase.INSTALL_DEPENDENCIES,
+    // error [email protected]: The engine "node" is incompatible with this module. Expected version "14". Got "16.13.2"
+    // error Found incompatible module.
+    regexp: /The engine "node" is incompatible with this module\. Expected version/,
+    createError: () =>
+      new TrackedBuildError('NODE_ENGINE_INCOMPATIBLE', 'node: Incompatible engine field.'),
+  },
+  {
+    phase: BuildPhase.INSTALL_DEPENDENCIES,
+    // error An unexpected error occurred: "https://registry.yarnpkg.com/@react-native/normalize-color/-/normalize-color-2.0.0.tgz: Request failed \"500 Internal Server Error\"".
+    // or
+    // error An unexpected error occurred: "https://registry.yarnpkg.com/request/-/request-2.88.2.tgz: Request failed \"503 Service Unavailable\"".
+    regexp: /An unexpected error occurred: "https:\/\/registry.yarnpkg.com\/.*Request failed \\"5/,
+    createError: () => new TrackedBuildError('YARN_REGISTRY_5XX_RESPONSE', 'yarn: 5xx response.'),
+  },
+  {
+    phase: BuildPhase.PREBUILD,
+    // Input is required, but Expo CLI is in non-interactive mode
+    // or
+    // CommandError: Input is required, but 'npx expo' is in non-interactive mode.
+    regexp: /Input is required, but .* is in non-interactive mode/,
+    createError: () =>
+      new TrackedBuildError(
+        'EXPO_CLI_INPUT_REQUIRED_ERROR',
+        `expo-cli: Input required in non-interactive mode.`
+      ),
+  },
+  {
+    platform: Platform.IOS,
+    phase: BuildPhase.PREBUILD,
+    // [03:03:05] [ios.infoPlist]: withIosInfoPlistBaseMod: GoogleService-Info.plist is empty
+    regexp: /withIosInfoPlistBaseMod: GoogleService-Info\.plist is empty/,
+    createError: () =>
+      new TrackedBuildError(
+        'EXPO_CLI_EMPTY_GOOGLE_SERVICES_PLIST_ERROR',
+        `expo-cli: Empty GoogleService-Info.plist.`
+      ),
+  },
+  {
+    platform: Platform.IOS,
+    phase: BuildPhase.PREBUILD,
+    // [01:52:04] [ios.xcodeproj]: withIosXcodeprojBaseMod: Path to GoogleService-Info.plist is not defined. Please specify the `expo.ios.googleServicesFile` field in app.json.
+    regexp: /withIosXcodeprojBaseMod: Path to GoogleService-Info\.plist is not defined/,
+    createError: () =>
+      new TrackedBuildError(
+        'EXPO_CLI_NOT_DEFINED_GOOGLE_SERVICES_PLIST_ERROR',
+        `expo-cli: Path to GoogleService-Info.plist is not defined.`
+      ),
+  },
+  {
+    phase: BuildPhase.PREBUILD,
+    // Error: [android.dangerous]: withAndroidDangerousBaseMod: ENOENT: no such file or directory, open './assets/adaptive-icon.png'
+    //     at Object.openSync (node:fs:585:3)
+    //     at readFileSync (node:fs:453:35)
+    //     at calculateHash (/home/expo/workingdir/build/node_modules/@expo/image-utils/build/Cache.js:14:91)
+    //     at createCacheKey (/home/expo/workingdir/build/node_modules/@expo/image-utils/build/Cache.js:19:18)
+    //     at Object.createCacheKeyWithDirectoryAsync (/home/expo/workingdir/build/node_modules/@expo/image-utils/build/Cache.js:24:33)
+    //     at generateImageAsync (/home/expo/workingdir/build/node_modules/@expo/image-utils/build/Image.js:151:34)
+    //     at async generateIconAsync (/home/expo/workingdir/build/node_modules/@expo/prebuild-config/build/plugins/icons/withAndroidIcons.js:369:11)
+    //     at async /home/expo/workingdir/build/node_modules/@expo/prebuild-config/build/plugins/icons/withAndroidIcons.js:310:21
+    //     at async Promise.all (index 0)
+    //     at async generateMultiLayerImageAsync (/home/expo/workingdir/build/node_modules/@expo/prebuild-config/build/plugins/icons/withAndroidIcons.js:306:3)
+    //     or
+    // Error: [ios.dangerous]: withIosDangerousBaseMod: ENOENT: no such file or directory, open './assets/images/app_icon_staging.png'
+    //     at Object.openSync (fs.js:497:3)
+    //     at readFileSync (fs.js:393:35)
+    //     at calculateHash (/Users/expo/workingdir/build/node_modules/@expo/image-utils/build/Cache.js:14:91)
+    //     at createCacheKey (/Users/expo/workingdir/build/node_modules/@expo/image-utils/build/Cache.js:19:18)
+    //     at Object.createCacheKeyWithDirectoryAsync (/Users/expo/workingdir/build/node_modules/@expo/image-utils/build/Cache.js:24:33)
+    //     at generateImageAsync (/Users/expo/workingdir/build/node_modules/@expo/image-utils/build/Image.js:151:34)
+    //     at async setIconsAsync (/Users/expo/workingdir/build/node_modules/@expo/prebuild-config/build/plugins/icons/withIosIcons.js:169:15)
+    //     at async /Users/expo/workingdir/build/node_modules/@expo/prebuild-config/build/plugins/icons/withIosIcons.js:71:5
+    //     at async action (/Users/expo/workingdir/build/node_modules/@expo/config-plugins/build/plugins/withMod.js:235:23)
+    //     at async interceptingMod (/Users/expo/workingdir/build/node_modules/@expo/config-plugins/build/plugins/withMod.js:126:21)
+    regexp:
+      /ENOENT: no such file or directory[\s\S]*prebuild-config\/build\/plugins\/icons\/with(Android|Ios)Icons\.js/,
+    createError: () => new TrackedBuildError('EXPO_CLI_MISSING_ICON', 'expo-cli: Missing icon.'),
+  },
+  {
+    phase: BuildPhase.PREBUILD,
+    // Cannot determine which native SDK version your project uses because the module `expo` is not installed. Please install it with `yarn add expo` and try again.
+    regexp:
+      /Cannot determine which native SDK version your project uses because the module `expo` is not installed/,
+    createError: () =>
+      new TrackedBuildError('EXPO_CLI_EXPO_PACKAGE_MISSING', 'expo-cli: "expo" package missing.'),
+  },
+  {
+    phase: BuildPhase.INSTALL_PODS,
+    // The Swift pod `FirebaseCoreInternal` depends upon `GoogleUtilities`, which does not define modules. To opt into those targets generating module maps (which is necessary to import them from Swift when building as static
+    regexp: /The Swift pod .* depends upon .* which does not define modules/,
+    createError: () =>
+      new TrackedBuildError(
+        'SWIFT_POD_INCOMPATIBLE_DEPENDENCY',
+        'pod: Swift pod depends on a pod that does not define modules.'
+      ),
+  },
+  {
+    platform: Platform.IOS,
+    phase: BuildPhase.INSTALL_PODS,
+    // Adding spec repo `24-repository-cocoapods-proxy` with CDN `http://10.254.24.7:8081/repository/cocoapods-proxy/`
+    // [!] No podspec exists at path `/Users/expo/.cocoapods/repos/24-repository-cocoapods-proxy/Specs/1/9/2/libwebp/1.2.0/libwebp.podspec.json`.
+    regexp: /Adding spec repo .* with CDN .*\n\s*\[!\] No podspec exists at path `(.*)`/,
+    // Some pods are hosted on git registries that are not supported e.g. chromium.googlesource.com
+    createError: (match: RegExpMatchArray) =>
+      new TrackedBuildError(
+        'COCOAPODS_CACHE_INCOMPATIBLE_REPO_ERROR',
+        `cocoapods: Missing podspec ${match[1]}.`
+      ),
+  },
+  {
+    platform: Platform.IOS,
+    phase: BuildPhase.INSTALL_PODS,
+    // [!] Invalid `Podfile` file: 783: unexpected token at 'info Run CLI with --verbose flag for more details.
+    regexp:
+      /\[!\] Invalid `Podfile` file: .* unexpected token at 'info Run CLI with --verbose flag for more details./,
+    createError: () =>
+      new TrackedBuildError('NODE_ENV_PRODUCTION_DEFINED', 'npm: NODE_ENV=production was defined.'),
+  },
+  ...[BuildPhase.INSTALL_DEPENDENCIES, BuildPhase.PREBUILD].map(phase => ({
+    phase,
+    // example log:
+    // [stderr] WARN tarball tarball data for @typescript-eslint/[email protected] (sha512-cozo/GbwixVR0sgfHItz3t1yXu521yn71Wj6PlYCFA3WPhy51CUPkifFKfBis91bDclGmAY45hhaAXVjdn4new==) seems to be corrupted. Trying again.
+    regexp: /tarball tarball data for ([^ ]*) .* seems to be corrupted. Trying again/,
+    createError: (match: RegExpMatchArray) =>
+      new TrackedBuildError('NPM_CORRUPTED_PACKAGE', `npm: corrupted package ${match[1]}`, {
+        packageName: match[1],
+      }),
+  })),
+  ...[BuildPhase.INSTALL_DEPENDENCIES, BuildPhase.PREBUILD].map(phase => ({
+    phase,
+    regexp: ({ env }: ErrorContext) =>
+      env.EAS_BUILD_NPM_CACHE_URL
+        ? new RegExp(escapeRegExp(env.EAS_BUILD_NPM_CACHE_URL))
+        : undefined,
+    createError: () => new TrackedBuildError('NPM_CACHE_ERROR', `npm: cache error`),
+  })),
+  {
+    platform: Platform.IOS,
+    phase: BuildPhase.INSTALL_PODS,
+    regexp: ({ env }: ErrorContext) =>
+      env.EAS_BUILD_COCOAPODS_CACHE_URL ? /Error installing/ : undefined,
+    createError: () =>
+      new TrackedBuildError(
+        'COCOAPODS_CACHE_INSTALLING_POD_ERROR',
+        `cocoapods: error installing a pod using internal cache instance`
+      ),
+  },
+  {
+    platform: Platform.IOS,
+    phase: BuildPhase.INSTALL_PODS,
+    regexp: ({ env }: ErrorContext) =>
+      env.EAS_BUILD_COCOAPODS_CACHE_URL ? /No podspec exists at path/ : undefined,
+    createError: () =>
+      new TrackedBuildError(
+        'COCOAPODS_CACHE_NO_PODSPEC_EXISTS_AT_PATH_ERROR',
+        `cocoapods: error fetching a podspec through internal cache instance`
+      ),
+  },
+  {
+    platform: Platform.IOS,
+    phase: BuildPhase.INSTALL_PODS,
+    regexp: ({ env }: ErrorContext) =>
+      env.EAS_BUILD_COCOAPODS_CACHE_URL
+        ? new RegExp(escapeRegExp(env.EAS_BUILD_COCOAPODS_CACHE_URL))
+        : undefined,
+    createError: () => new TrackedBuildError('COCOAPODS_CACHE_ERROR', `cocoapods: cache error`),
+  },
+  {
+    phase: BuildPhase.INSTALL_PODS,
+    // [!] Invalid `Podfile` file: uninitialized constant Pod::Podfile::FlipperConfiguration.
+    regexp: /\[!\] Invalid `Podfile` file/,
+    createError: () => new TrackedBuildError('INVALID_PODFILE', 'pod: Invalid Podfile file.'),
+  },
+  {
+    phase: BuildPhase.INSTALL_DEPENDENCIES,
+    // info There appears to be trouble with your network connection. Retrying...
+    regexp: /info There appears to be trouble with your network connection. Retrying/,
+    createError: () =>
+      new TrackedBuildError(
+        'YARN_INSTALL_TROUBLE_WITH_NETWORK_CONNECTION',
+        'yarn: There appears to be trouble with your network connection'
+      ),
+  },
+  {
+    phase: BuildPhase.RUN_GRADLEW,
+    platform: Platform.ANDROID,
+    // Android Gradle plugin requires Java 11 to run. You are currently using Java 1.8
+    regexp: /Android Gradle plugin requires Java .* to run. You are currently using Java/,
+    createError: () =>
+      new TrackedBuildError('INCOMPATIBLE_JAVA_VERSION', 'gradle: Incompatible java version.'),
+  },
+  {
+    phase: BuildPhase.RUN_GRADLEW,
+    platform: Platform.ANDROID,
+    // /home/expo/workingdir/build/android/app/src/main/AndroidManifest.xml:27:9-33:20 Error:
+    //  	android:exported needs to be explicitly specified for element <activity#androidx.test.core.app.InstrumentationActivityInvoker$EmptyActivity>. Apps targeting Android 12 and higher are required to specify an explicit value for `android:exported` when the corresponding component has an intent filter defined. See https://developer.android.com/guide/topics/manifest/activity-element#exported for details.
+    regexp:
+      /Apps targeting Android 12 and higher are required to specify an explicit value for `android:exported`/,
+    createError: () =>
+      new TrackedBuildError(
+        'REQUIRE_EXPLICIT_EXPORTED_ANDROID_12',
+        'Apps targeting Android 12 and higher are required to specify an explicit value for `android:exported`.'
+      ),
+  },
+  {
+    phase: BuildPhase.RUN_GRADLEW,
+    platform: Platform.ANDROID,
+    // > A failure occurred while executing com.android.build.gradle.internal.res.Aapt2CompileRunnable
+    //   > Android resource compilation failed
+    //     ERROR:/home/expo/workingdir/build/android/app/src/main/res/mipmap-mdpi/ic_launcher.png: AAPT: error: failed to read PNG signature: file does not start with PNG signature.
+    regexp: /AAPT: error: failed to read PNG signature: file does not start with PNG signature/,
+    createError: () =>
+      new TrackedBuildError('INVALID_PNG_SIGNATURE', 'gradle: Invalid PNG signature.'),
+  },
+  {
+    phase: BuildPhase.RUN_GRADLEW,
+    platform: Platform.ANDROID,
+    // Execution failed for task ':app:processReleaseGoogleServices'.
+    // > Malformed root json
+    regexp: /Execution failed for task ':app:process.*GoogleServices'.*\s.*Malformed root json/,
+    createError: () =>
+      new TrackedBuildError(
+        'GRADLE_MALFORMED_GOOGLE_SERVICES_JSON',
+        'gradle: Malformed google-services.json.'
+      ),
+  },
+  {
+    phase: BuildPhase.RUN_GRADLEW,
+    platform: Platform.ANDROID,
+    // Execution failed for task ':app:processDebugGoogleServices'.
+    // > Missing project_info object
+    regexp:
+      /Execution failed for task ':app:process.*GoogleServices'.*\s.*Missing project_info object/,
+    createError: () =>
+      new TrackedBuildError(
+        'GRADLE_MALFORMED_GOOGLE_SERVICES_JSON',
+        'gradle: Missing project_info object.'
+      ),
+  },
+  {
+    phase: BuildPhase.RUN_GRADLEW,
+    platform: Platform.ANDROID,
+    // Execution failed for task ':app:bundleReleaseJsAndAssets'.
+    // > Process 'command 'node'' finished with non-zero exit value 1
+    regexp:
+      /Execution failed for task ':app:bundleReleaseJsAndAssets'.*\s.*Process 'command 'node'' finished with non-zero exit value/,
+    createError: () =>
+      new TrackedBuildError(
+        'GRADLE_BUILD_BUNDLER_ERROR',
+        "gradle: ':app:bundleReleaseJsAndAssets' failed."
+      ),
+  },
+  {
+    platform: Platform.ANDROID,
+    phase: BuildPhase.RUN_GRADLEW,
+    //    > Could not resolve org.jetbrains.kotlin:kotlin-annotation-processing-gradle:1.5.10.
+    //      Required by:
+    //          project :expo-updates
+    //       > Could not resolve org.jetbrains.kotlin:kotlin-annotation-processing-gradle:1.5.10.
+    //          > Could not get resource 'https://lsdkfjsdlkjf.com/android/releases/org/jetbrains/kotlin/kotlin-annotation-processing-gradle/1.5.10/kotlin-annotation-processing-gradle-1.5.10.pom'.
+    //             > Could not HEAD 'https://slkdfjldskjfl.com/android/releases/org/jetbrains/kotlin/kotlin-annotation-processing-gradle/1.5.10/kotlin-annotation-processing-gradle-1.5.10.pom'.
+    //                > Connect to sdlkfjsdlkf.com:443 [slkdfjdslk.com/38.178.101.5] failed: connect timed out
+    regexp: /Could not get resource.*\n.*Could not HEAD 'https/,
+    createError: () =>
+      new TrackedBuildError('MAVEN_REGISTRY_CONNECTION_ERROR', `maven: registry connection error`),
+  },
+  {
+    platform: Platform.ANDROID,
+    phase: BuildPhase.RUN_GRADLEW,
+    regexp: ({ env }: ErrorContext) =>
+      env.EAS_BUILD_MAVEN_CACHE_URL
+        ? // The BlurView 2.0.3 jar was removed from jitpack.io
+          // and it caused false positive MAVEN_CACHE_ERROR errors being reported.
+          new RegExp(
+            `^(?!.*Could not find BlurView-version-2\\.0\\.3\\.jar).*${escapeRegExp(
+              env.EAS_BUILD_MAVEN_CACHE_URL
+            )}`
+          )
+        : undefined,
+    createError: () => new TrackedBuildError('MAVEN_CACHE_ERROR', `maven: cache error`),
+  },
+  {
+    phase: BuildPhase.RUN_FASTLANE,
+    platform: Platform.IOS,
+    // error: exportArchive: exportOptionsPlist error for key "iCloudContainerEnvironment": expected one of {Development, Production}, but no value was provided
+    regexp: /exportArchive: exportOptionsPlist error for key "iCloudContainerEnvironment"/,
+    createError: () =>
+      new TrackedBuildError(
+        'MISSING_ICLOUD_CONTAINER_ENVIRONMENT',
+        'fastlane: Missing iCloudContainerEnvironment in exportOptionsPlist.'
+      ),
+  },
+  {
+    phase: BuildPhase.RUN_FASTLANE,
+    platform: Platform.IOS,
+    // The following build commands failed:
+    //	PhaseScriptExecution [CP-User]\ Generate\ app.manifest\ for\ expo-updates /Users/expo/Library/Developer/Xcode/DerivedData/Kenkohub-eqseedlxbgrzjqagscbclhbtstwh/Build/Intermediates.noindex/ArchiveIntermediates/Kenkohub/IntermediateBuildFilesPath/Pods.build/Release-iphoneos/EXUpdates.build/Script-BB6B5FD28815C045A20B2E5E3FEEBD6E.sh (in target 'EXUpdates' from project 'Pods')
+    regexp:
+      /The following build commands failed.*\s.*\[CP-User\]\\ Generate\\ app\.manifest\\ for\\ expo-updates/,
+    createError: () =>
+      new TrackedBuildError(
+        'XCODE_BUILD_UPDATES_PHASE_SCRIPT',
+        'fastlane: Generating app.manifest for expo-updates failed.'
+      ),
+  },
+  {
+    phase: BuildPhase.RUN_FASTLANE,
+    platform: Platform.IOS,
+    // The following build commands failed:
+    // 	CompileC /Users/expo/Library/Developer/Xcode/DerivedData/Docent-amxxhphjfdtkpxecgidgzvwvnvtc/Build/Intermediates.noindex/ArchiveIntermediates/Docent/IntermediateBuildFilesPath/Pods.build/Release-iphoneos/Flipper-Folly.build/Objects-normal/arm64/SSLErrors.o /Users/expo/workingdir/build/ios/Pods/Flipper-Folly/folly/io/async/ssl/SSLErrors.cpp normal arm64 c++ com.apple.compilers.llvm.clang.1_0.compiler (in target 'Flipper-Folly' from project 'Pods')
+    regexp: /in target 'Flipper-Folly' from project 'Pods'/,
+    createError: () =>
+      new TrackedBuildError(
+        'FLIPPER_FOLLY_COMPILE_ERROR',
+        'fastlane: Flipper-Folly compile error.'
+      ),
+  },
+  {
+    phase: BuildPhase.RUN_FASTLANE,
+    platform: Platform.IOS,
+    // The following build commands failed:
+    //	PhaseScriptExecution Bundle\ React\ Native\ code\ and\ images /Users/expo/Library/Developer/Xcode/DerivedData/cnaxwpahkhcjluhigkcwrturapmm/Build/Intermediates.noindex/ArchiveIntermediates/Test/IntermediateBuildFilesPath/Test.build/Release-iphoneos/Test.build/Script-00DD1BFF151E006B06BC.sh (in target 'Test' from project 'Test')
+    regexp:
+      /The following build commands failed.*\s.*PhaseScriptExecution Bundle\\ React\\ Native\\ code\\ and\\ images \/Users\/expo/,
+    createError: () =>
+      new TrackedBuildError(
+        'XCODE_BUILD_BUNDLER_ERROR',
+        'fastlane: Bundle React Native code and images failed.'
+      ),
+  },
+];

packages/build-tools/src/buildErrors/detectError.ts

@@ -0,0 +1,92 @@
+import { BuildPhase, errors } from '@expo/eas-build-job';
+import fs from 'fs-extra';
+
+import { buildErrorHandlers } from './buildErrorHandlers';
+import { ErrorContext, ErrorHandler, XCODE_BUILD_PHASE } from './errors.types';
+import { userErrorHandlers } from './userErrorHandlers';
+import { findXcodeBuildLogsPathAsync } from '../ios/xcodeBuildLogs';
+
+async function maybeReadXcodeBuildLogs(
+  phase: BuildPhase,
+  buildLogsDirectory: string
+): Promise<string | undefined> {
+  if (phase !== BuildPhase.RUN_FASTLANE) {
+    return;
+  }
+
+  try {
+    const xcodeBuildLogsPath = await findXcodeBuildLogsPathAsync(buildLogsDirectory);
+
+    if (!xcodeBuildLogsPath) {
+      return;
+    }
+
+    return await fs.readFile(xcodeBuildLogsPath, 'utf-8');
+  } catch {
+    return undefined;
+  }
+}
+
+function resolveError<TError extends Error>(
+  errorHandlers: ErrorHandler<TError>[],
+  logLines: string[],
+  errorContext: ErrorContext,
+  xcodeBuildLogs?: string
+): TError | undefined {
+  const { job, phase } = errorContext;
+  const { platform } = job;
+  const logs = logLines.join('\n');
+  const handlers = errorHandlers
+    .filter(handler => handler.platform === platform || !handler.platform)
+    .filter(
+      handler =>
+        (handler.phase === XCODE_BUILD_PHASE && phase === BuildPhase.RUN_FASTLANE) ||
+        handler.phase === phase ||
+        !handler.phase
+    )
+    .filter(handler => ('mode' in job && handler.mode === job.mode) || !handler.mode);
+
+  for (const handler of handlers) {
+    const regexp =
+      typeof handler.regexp === 'function' ? handler.regexp(errorContext) : handler.regexp;
+    if (!regexp) {
+      continue;
+    }
+    const match =
+      handler.phase === XCODE_BUILD_PHASE ? xcodeBuildLogs?.match(regexp) : logs.match(regexp);
+
+    if (match) {
+      return handler.createError(match, errorContext);
+    }
+  }
+  return undefined;
+}
+
+export async function resolveBuildPhaseErrorAsync(
+  error: any,
+  logLines: string[],
+  errorContext: ErrorContext,
+  buildLogsDirectory: string
+): Promise<errors.ExpoError> {
+  const { phase } = errorContext;
+  if (error instanceof errors.ExpoError) {
+    error.buildPhase ??= phase;
+    return error;
+  }
+  const xcodeBuildLogs = await maybeReadXcodeBuildLogs(phase, buildLogsDirectory);
+  const userError =
+    resolveError(userErrorHandlers, logLines, errorContext, xcodeBuildLogs) ??
+    new errors.UnknownError(errorContext.phase);
+  const buildError = resolveError(buildErrorHandlers, logLines, errorContext, xcodeBuildLogs);
+
+  const trackingCode =
+    buildError && buildError.errorCode !== userError.errorCode ? buildError.errorCode : undefined;
+
+  return new errors.UserError(userError.errorCode, userError.message, {
+    trackingCode,
+    docsUrl: userError.docsUrl,
+    buildPhase: phase,
+    metadata: buildError?.metadata,
+    cause: error,
+  });
+}

packages/build-tools/src/buildErrors/errors.types.ts

@@ -0,0 +1,17 @@
+import { BuildMode, BuildPhase, Env, Job, Platform } from '@expo/eas-build-job';
+
+export interface ErrorContext<TJob extends Job = Job> {
+  phase: BuildPhase;
+  job: TJob;
+  env: Env;
+}
+
+export const XCODE_BUILD_PHASE = 'XCODE_BUILD';
+
+export interface ErrorHandler<T extends Error> {
+  regexp: RegExp | ((ctx: ErrorContext) => RegExp | undefined);
+  platform?: Platform;
+  phase?: BuildPhase | typeof XCODE_BUILD_PHASE;
+  mode?: BuildMode;
+  createError: (matchResult: RegExpMatchArray, errCtx: ErrorContext) => T | undefined;
+}

packages/build-tools/src/buildErrors/userErrorHandlers.ts

@@ -0,0 +1,317 @@
+import { BuildMode, BuildPhase, Platform, Workflow, errors } from '@expo/eas-build-job';
+
+import { ErrorHandler, XCODE_BUILD_PHASE } from './errors.types';
+
+import UserError = errors.UserError;
+
+export const userErrorHandlers: ErrorHandler<UserError>[] = [
+  {
+    platform: Platform.IOS,
+    phase: BuildPhase.INSTALL_PODS,
+    regexp: /requires CocoaPods version/,
+    // example log:
+    // [!] `React` requires CocoaPods version `>= 1.10.1`, which is not satisfied by your current version, `1.10.0`.
+    createError: () =>
+      new UserError(
+        'EAS_BUILD_UNSUPPORTED_COCOAPODS_VERSION_ERROR',
+        `Your project requires a newer version of CocoaPods. You can update it in the build profile in eas.json by either:
+- changing the current version under key "cocoapods"
+- switching to an image that supports that version under key "image"`,
+        { docsUrl: 'https://docs.expo.dev/build-reference/eas-json/' }
+      ),
+  },
+  {
+    platform: Platform.IOS,
+    phase: BuildPhase.RUN_FASTLANE,
+    regexp: /Could not find 'bundler' (.*) required by your/,
+    // example log:
+    // /System/Library/Frameworks/Ruby.framework/Versions/2.6/usr/lib/ruby/2.6.0/rubygems/dependency.rb:313:in `to_specs': Could not find 'bundler' (2.2.3) required by your /Users/expo/project/build/ios/Gemfile.lock. (Gem::MissingSpecVersionError)
+    createError: () =>
+      new UserError(
+        'EAS_BUILD_UNSUPPORTED_BUNDLER_VERSION_ERROR',
+        `Your project requires a different version of the Ruby "bundler" program than the version installed in this EAS Build environment. You can specify which version of "bundler" to install by specifying the version under "build"→[buildProfileName]→"ios"→"bundler" in eas.json.`,
+        { docsUrl: 'https://docs.expo.dev/build-reference/eas-json/' }
+      ),
+  },
+  {
+    platform: Platform.ANDROID,
+    phase: BuildPhase.RUN_GRADLEW,
+    // example log:
+    // > Failed to read key keyalias from store "/build/workingdir/build/generic/keystore-5787e6af-3002-4cb7-8a57-3e73d13313c2.jks": Invalid keystore format
+    regexp: /Invalid keystore format/,
+    createError: () =>
+      new UserError(
+        'EAS_BUILD_INVALID_KEYSTORE_FORMAT_ERROR',
+        'The keystore used in this build is malformed or it has an unsupported type. Make sure you provided the correct file.'
+      ),
+  },
+  {
+    platform: Platform.ANDROID,
+    phase: BuildPhase.RUN_GRADLEW,
+    // example log:
+    // > Failed to read key keyalias from store "/build/workingdir/build/generic/keystore-286069a8-4bb9-48a6-add9-acf6b58ea06d.jks": null
+    regexp: /Failed to read key[^\n]+from store/,
+    createError: () =>
+      new UserError(
+        'EAS_BUILD_INVALID_KEYSTORE_ALIAS_ERROR',
+        'The alias specified for this keystore does not exist. Make sure you specified the correct value.'
+      ),
+  },
+  {
+    platform: Platform.ANDROID,
+    phase: BuildPhase.PREBUILD,
+    // example log:
+    // [15:42:05] Error: Cannot copy google-services.json from /build/workingdir/build/managed/abc to /build/workingdir/build/managed/android/app/google-services.json
+    // or
+    // [11:17:29] [android.dangerous]: withAndroidDangerousBaseMod: Cannot copy google-services.json from /home/expo/workingdir/build/test/test-google-services.json to /home/expo/workingdir/build/android/app/google-services.json. Please make sure the source and destination paths exist.
+    // [11:17:29] Error: [android.dangerous]: withAndroidDangerousBaseMod: Cannot copy google-services.json from /home/expo/workingdir/build/test/test-google-services.json to /home/expo/workingdir/build/android/app/google-services.json. Please make sure the source and destination paths exist.
+    regexp: /Cannot copy google-services\.json/,
+    createError: () =>
+      new UserError(
+        'EAS_BUILD_MISSING_GOOGLE_SERVICES_JSON_ERROR',
+        '"google-services.json" is missing, make sure that the file exists. Remember that EAS Build only uploads the files tracked by git. Use EAS environment variables to provide EAS Build with the file.',
+        { docsUrl: 'https://docs.expo.dev/eas/environment-variables/#file-environment-variables' }
+      ),
+  },
+  {
+    platform: Platform.ANDROID,
+    phase: BuildPhase.RUN_GRADLEW,
+    // Execution failed for task ':app:processReleaseGoogleServices'.
+    // > File google-services.json is missing. The Google Services Plugin cannot function without it.
+    //    Searched Location:
+    regexp:
+      /File google-services\.json is missing\. The Google Services Plugin cannot function without it/,
+    createError: () =>
+      new UserError(
+        'EAS_BUILD_MISSING_GOOGLE_SERVICES_JSON_ERROR',
+        '"google-services.json" is missing, make sure that the file exists. Remember that EAS Build only uploads the files tracked by git. Use EAS environment variables to provide EAS Build with the file.',
+        { docsUrl: 'https://docs.expo.dev/eas/environment-variables/#file-environment-variables' }
+      ),
+  },
+  {
+    platform: Platform.IOS,
+    phase: BuildPhase.PREBUILD,
+    // example log:
+    // [08:44:18] ENOENT: no such file or directory, copyfile '/Users/expo/workingdir/build/managed/abc' -> '/Users/expo/workingdir/build/managed/ios/testapp/GoogleService-Info.plist'
+    regexp: /ENOENT: no such file or directory, copyfile .*GoogleService-Info.plist/,
+    createError: () =>
+      new UserError(
+        'EAS_BUILD_MISSING_GOOGLE_SERVICES_PLIST_ERROR',
+        '"GoogleService-Info.plist" is missing, make sure that the file exists. Remember that EAS Build only uploads the files tracked by git. Use EAS environment variables to provide EAS Build with the file.',
+        { docsUrl: 'https://docs.expo.dev/eas/environment-variables/#file-environment-variables' }
+      ),
+  },
+  {
+    platform: Platform.IOS,
+    phase: BuildPhase.INSTALL_PODS,
+    // example log:
+    // [!] CocoaPods could not find compatible versions for pod "react-native-google-maps"
+    // In Podfile:
+    // react-native-google-maps (from `/Users/expo/workingdir/build/node_modules/react-native-maps`)
+    // Specs satisfying the `react-native-google-maps (from `/Users/expo/workingdir/build/node_modules/react-native-maps`)` dependency were found, but they required a higher minimum deployment target.
+    // Error: Compatible versions of some pods could not be resolved.
+    regexp:
+      /Specs satisfying the `(.*)` dependency were found, but they required a higher minimum deployment target/,
+    createError: (_, { job }) => {
+      return new UserError(
+        'EAS_BUILD_HIGHER_MINIMUM_DEPLOYMENT_TARGET_ERROR',
+        `Some pods require a higher minimum deployment target.
+${
+  'type' in job && job.type === Workflow.MANAGED
+    ? 'You can use the expo-build-properties config plugin (https://docs.expo.dev/versions/latest/sdk/build-properties/) to override the default native build properties and set a different minimum deployment target.'
+    : 'You need to manually update the minimum deployment target in your project to resolve this issue.'
+}
+`
+      );
+    },
+  },
+  {
+    platform: Platform.IOS,
+    phase: BuildPhase.INSTALL_PODS,
+    // example log:
+    // [!] CocoaPods could not find compatible versions for pod "Firebase/Core":
+    //   In snapshot (Podfile.lock):
+    //     Firebase/Core (= 6.14.0)
+    //   In Podfile:
+    //     EXFirebaseCore (from `../node_modules/expo-firebase-core/ios`) was resolved to 3.0.0, which depends on
+    //       Firebase/Core (= 7.7.0)
+    // You have either:
+    //  * out-of-date source repos which you can update with `pod repo update` or with `pod install --repo-update`.
+    //  * changed the constraints of dependency `Firebase/Core` inside your development pod `EXFirebaseCore`.
+    //    You should run `pod update Firebase/Core` to apply changes you've made.
+    regexp: /CocoaPods could not find compatible versions for pod /,
+    createError: () => {
+      return new UserError(
+        'EAS_BUILD_INCOMPATIBLE_PODS_ERROR',
+        `Compatible versions of some pods could not be resolved.
+You are seeing this error because either:
+  - Some of the pods used in your project depend on different versions of the same pod. See logs for more information.
+  - If you are caching Podfile.lock using "cache" field in eas.json, then versions there might not match required values in Podspecs of some installed libraries. To fix this, you can re-run build command with "--clear-cache" option, or select "Clear cache and retry build" on the build page.
+`
+      );
+    },
+  },
+  {
+    phase: BuildPhase.INSTALL_DEPENDENCIES,
+    // example log:
+    // [stderr] npm ERR! Fix the upstream dependency conflict, or retry
+    // [stderr] npm ERR! this command with --force, or --legacy-peer-deps
+    // [stderr] npm ERR! to accept an incorrect (and potentially broken) dependency resolution.
+    regexp:
+      /Fix the upstream dependency conflict, or retry.*\s.*this command with --force, or --legacy-peer-deps/,
+    createError: (matchResult: RegExpMatchArray) => {
+      if (matchResult.length >= 2) {
+        return new UserError(
+          'EAS_BUILD_NPM_CONFLICTING_PEER_DEPENDENCIES',
+          `Some of your peer dependencies are not compatible. The recommended approach is to fix your dependencies by resolving any conflicts listed by "npm install". As a temporary workaround you can:
+- Add ".npmrc" file with "legacy-peer-deps=true" and commit that to your repo.
+- Delete package-lock.json and use yarn instead. It does not enforce peer dependencies.
+- Downgrade to older version of npm on EAS Build, by adding "npm install -g npm@version" in "eas-build-pre-install" script in package.json.`
+        );
+      }
+      return undefined;
+    },
+  },
+  {
+    phase: BuildPhase.INSTALL_DEPENDENCIES,
+    // example log:
+    // [stderr] error https://github.com/expo/react-native/archive/sdk-41.0.0.tar.gz: Integrity check failed for "react-native" (computed integrity doesn't match our records, got "sha512-3jHI2YufrJi7eIABRf/DN/I2yOkmIZ0vAyezTz+PAUJiEs4v//5LLojWEU+W53AZsnuaEMcl/4fVy4bd+OuUbA== sha1-o9QuQTXIkc8VozXPaZIullB9a40=")
+    regexp: /Integrity check failed for "(.*)" \(computed integrity doesn't match our records, got/,
+    createError: (matchResult: RegExpMatchArray) => {
+      if (matchResult.length >= 2) {
+        return new UserError(
+          'EAS_BUILD_YARN_LOCK_CHECKSUM_ERROR',
+          `Checksum for package "${matchResult[1]}" does not match value in registry. To fix that:
+- run "yarn cache clean"
+- remove yarn.lock (or only the section for that package)
+- run "yarn install --force"`
+        );
+      }
+      return undefined;
+    },
+  },
+  {
+    phase: BuildPhase.INSTALL_DEPENDENCIES,
+    // example log:
+    // yarn install v1.22.17
+    // [1/4] Resolving packages...
+    // [2/4] Fetching packages...
+    // [1/4] Resolving packages...
+    // [2/4] Fetching packages...
+    // [stderr] error https://registry.yarnpkg.com/jest-util/-/jest-util-26.6.2.tgz: Extracting tar content of undefined failed, the file appears to be corrupt: "ENOENT: no such file or directory, chmod '/Users/expo/Library/Caches/Yarn/v6/npm-jest-util-26.6.2-907535dbe4d5a6cb4c47ac9b926f6af29576cbc1-integrity/node_modules/jest-util/build/pluralize.d.ts'"
+    regexp:
+      /\[1\/4\] Resolving packages...\s*\[2\/4\] Fetching packages...\s*\[1\/4\] Resolving packages...\s*\[2\/4\] Fetching packages.../,
+    createError: (matchResult: RegExpMatchArray) => {
+      if (matchResult) {
+        return new UserError(
+          'EAS_BUILD_YARN_MULTIPLE_INSTANCES_ERROR',
+          `One of project dependencies is starting new install process while the main one is still in progress, which might result in corrupted packages. Most likely the reason for error is "prepare" script in git-referenced dependency of your project. Learn more: https://github.com/yarnpkg/yarn/issues/7212#issuecomment-493720324`
+        );
+      }
+      return undefined;
+    },
+  },
+  {
+    platform: Platform.IOS,
+    phase: XCODE_BUILD_PHASE,
+    // Prepare packages
+    // Computing target dependency graph and provisioning inputs
+    // Create build description
+    // Build description signature: 33a5c28977280822abe5e7bd7fe02529
+    // Build description path: /Users/expo/Library/Developer/Xcode/DerivedData/testapp-fazozgerxcvvfifkipojsjftgyih/Build/Intermediates.noindex/ArchiveIntermediates/testapp/IntermediateBuildFilesPath/XCBuildData/33a5c28977280822abe5e7bd7fe02529-desc.xcbuild
+    // note: Building targets in dependency order
+    // /Users/expo/workingdir/build/managed/ios/Pods/Pods.xcodeproj: error: Signing for "EXConstants-EXConstants" requires a development team. Select a development team in the Signing & Capabilities editor. (in target 'EXConstants-EXConstants' from project 'Pods')
+    // /Users/expo/workingdir/build/managed/ios/Pods/Pods.xcodeproj: error: Signing for "React-Core-AccessibilityResources" requires a development team. Select a development team in the Signing & Capabilities editor. (in target 'React-Core-AccessibilityResources' from project 'Pods')
+    // warning: Run script build phase '[CP-User] Generate app.manifest for expo-updates' will be run during every build because it does not specify any outputs. To address this warning, either add output dependencies to the script phase, or configure it to run in every build by unchecking "Based on dependency analysis" in the script phase. (in target 'EXUpdates' from project 'Pods')
+    // warning: Run script build phase 'Start Packager' will be run during every build because it does not specify any outputs. To address this warning, either add output dependencies to the script phase, or configure it to run in every build by unchecking "Based on dependency analysis" in the script phase. (in target 'testapp' from project 'testapp')
+    // warning: Run script build phase 'Bundle React Native code and images' will be run during every build because it does not specify any outputs. To address this warning, either add output dependencies to the script phase, or configure it to run in every build by unchecking "Based on dependency analysis" in the script phase. (in target 'testapp' from project 'testapp')
+    // warning: Run script build phase '[CP-User] Generate app.config for prebuilt Constants.manifest' will be run during every build because it does not specify any outputs. To address this warning, either add output dependencies to the script phase, or configure it to run in every build by unchecking "Based on dependency analysis" in the script phase. (in target 'EXConstants' from project 'Pods')
+    // /Users/expo/workingdir/build/managed/ios/Pods/Pods.xcodeproj: error: Signing for "EXUpdates-EXUpdates" requires a development team. Select a development team in the Signing & Capabilities editor. (in target 'EXUpdates-EXUpdates' from project 'Pods')
+    regexp: /error: Signing for "[a-zA-Z-0-9_]+" requires a development team/,
+    createError: (_, { job }) =>
+      'type' in job && job.type === Workflow.MANAGED
+        ? new UserError(
+            'XCODE_RESOURCE_BUNDLE_CODE_SIGNING_ERROR',
+            `Starting from Xcode 14, resource bundles are signed by default, which requires setting the development team for each resource bundle target.
+To resolve this issue, downgrade to an older Xcode version using the "image" field in eas.json, or upgrade to SDK 46 or higher.`,
+            {
+              docsUrl:
+                'https://docs.expo.dev/build-reference/infrastructure/#ios-build-server-configurations',
+            }
+          )
+        : new UserError(
+            'XCODE_RESOURCE_BUNDLE_CODE_SIGNING_ERROR',
+            `Starting from Xcode 14, resource bundles are signed by default, which requires setting the development team for each resource bundle target.
+To resolve this issue, downgrade to an older Xcode version using the "image" field in eas.json, or turn off signing resource bundles in your Podfile: https://expo.fyi/r/disable-bundle-resource-signing`,
+            {
+              docsUrl:
+                'https://docs.expo.dev/build-reference/infrastructure/#ios-build-server-configurations',
+            }
+          ),
+  },
+  {
+    platform: Platform.ANDROID,
+    phase: BuildPhase.RUN_GRADLEW,
+    regexp: /.*/,
+    createError: () =>
+      new UserError(
+        errors.ErrorCode.UNKNOWN_GRADLE_ERROR,
+        'Gradle build failed with unknown error. See logs for the "Run gradlew" phase for more information.'
+      ),
+  },
+  {
+    platform: Platform.IOS,
+    phase: BuildPhase.RUN_FASTLANE,
+    mode: BuildMode.RESIGN,
+    regexp: /No provisioning profile for application: '(.+)' with bundle identifier '(.+)'/,
+    createError: () =>
+      new UserError(
+        'EAS_BUILD_RESIGN_PROVISIONING_PROFILE_MISMATCH_ERROR',
+        `The bundle identifier in provisioning profile used to resign the app does not match the bundle identifier of the app selected to be resigned. See logs above for more information.`
+      ),
+  },
+  {
+    platform: Platform.IOS,
+    phase: BuildPhase.RUN_FASTLANE,
+    mode: BuildMode.RESIGN,
+    regexp: /.*/,
+    createError: () =>
+      new UserError(
+        errors.ErrorCode.UNKNOWN_FASTLANE_RESIGN_ERROR,
+        `The "Run fastlane" step failed with an unknown error.`
+      ),
+  },
+  {
+    platform: Platform.IOS,
+    phase: XCODE_BUILD_PHASE,
+    // MkDir /Users/expo/workingdir/build/packages/apps/NFLNetwork/ios/build/Build/Products/Release-iphonesimulator/expo-dev-launcher/EXDevLauncher.bundle (in target 'expo-dev-launcher-EXDevLauncher' from project 'Pods')
+    // cd /Users/expo/workingdir/build/packages/apps/NFLNetwork/ios/Pods
+    // /bin/mkdir -p /Users/expo/workingdir/build/packages/apps/NFLNetwork/ios/build/Build/Products/Release-iphonesimulator/expo-dev-launcher/EXDevLauncher.bundle
+    // ProcessXCFramework /Users/expo/workingdir/build/packages/video/ios/Vendor/dependency/ProgrammaticAccessLibrary.xcframework /Users/expo/workingdir/build/packages/apps/NFLNetwork/ios/build/Build/Products/Release-iphonesimulator/ProgrammaticAccessLibrary.framework ios simulator
+    // cd /Users/expo/workingdir/build/packages/apps/NFLNetwork/ios
+    // builtin-process-xcframework --xcframework /Users/expo/workingdir/build/packages/video/ios/Vendor/dependency/ProgrammaticAccessLibrary.xcframework --platform ios --environment simulator --target-path /Users/expo/workingdir/build/packages/apps/NFLNetwork/ios/build/Build/Products/Release-iphonesimulator
+    // /Users/expo/workingdir/build/packages/video/ios/Vendor/dependency/ProgrammaticAccessLibrary.xcframework:1:1: error: The signature of “ProgrammaticAccessLibrary.xcframework” cannot be verified.
+    // note: A sealed resource is missing or invalid
+    // note: /Users/expo/workingdir/build/packages/video/ios/Vendor/dependency/ProgrammaticAccessLibrary.xcframework: a sealed resource is missing or invalid
+    // file modified: /Users/expo/workingdir/build/packages/video/ios/Vendor/dependency/ProgrammaticAccessLibrary.xcframework/ios-arm64_x86_64-simulator/ProgrammaticAccessLibrary.framework/ProgrammaticAccessLibrary
+    // file modified: /Users/expo/workingdir/build/packages/video/ios/Vendor/dependency/ProgrammaticAccessLibrary.xcframework/ios-arm64/ProgrammaticAccessLibrary.framework/ProgrammaticAccessLibrary
+    regexp: /error: .+/g,
+    createError: matchResult =>
+      new UserError(
+        'XCODE_BUILD_ERROR',
+        `The "Run fastlane" step failed because of an error in the Xcode build process. We automatically detected following errors in your Xcode build logs:\n${matchResult
+          .map(match => `- ${match.replace('error: ', '')}`)
+          .join('\n')}\nRefer to "Xcode Logs" below for additional, more detailed logs.`
+      ),
+  },
+  {
+    platform: Platform.IOS,
+    phase: BuildPhase.RUN_FASTLANE,
+    regexp: /.*/,
+    createError: () =>
+      new UserError(
+        errors.ErrorCode.UNKNOWN_FASTLANE_ERROR,
+        `The "Run fastlane" step failed with an unknown error. Refer to "Xcode Logs" below for additional, more detailed logs.`
+      ),
+  },
+];

packages/build-tools/src/builders/__tests__/android.test.ts

@@ -0,0 +1,266 @@
+import { Android, BuildPhase, BuildPhaseResult } from '@expo/eas-build-job';
+import { vol } from 'memfs';
+
+import { createTestAndroidJob } from '../../__tests__/utils/job';
+import { createMockLogger } from '../../__tests__/utils/logger';
+import { BuildContext } from '../../context';
+import { restoreCredentials } from '../../android/credentials';
+import androidBuilder from '../android';
+import { runBuilderWithHooksAsync } from '../common';
+import {
+  injectConfigureVersionGradleConfig,
+  injectCredentialsGradleConfig,
+} from '../../steps/utils/android/gradleConfig';
+
+jest.mock('../common', () => ({
+  runBuilderWithHooksAsync: jest.fn(async (ctx, buildFn) => {
+    await buildFn(ctx);
+    return ctx.artifacts;
+  }),
+}));
+jest.mock('../custom', () => ({
+  runCustomBuildAsync: jest.fn(),
+}));
+jest.mock('../../android/credentials');
+jest.mock('../../android/gradle', () => ({
+  ensureLFLineEndingsInGradlewScript: jest.fn(),
+  resolveGradleCommand: jest.fn(() => ':app:bundleRelease'),
+  runGradleCommand: jest.fn(),
+}));
+jest.mock('../../common/eagerBundle', () => ({
+  eagerBundleAsync: jest.fn(),
+  shouldUseEagerBundle: jest.fn(() => false),
+}));
+jest.mock('../../common/prebuild', () => ({
+  prebuildAsync: jest.fn(),
+}));
+jest.mock('../../common/setup', () => ({
+  setupAsync: jest.fn(),
+}));
+jest.mock('../../steps/functions/restoreBuildCache', () => ({
+  cacheStatsAsync: jest.fn(),
+  restoreCcacheAsync: jest.fn(),
+}));
+jest.mock('../../steps/functions/saveBuildCache', () => ({
+  saveCcacheAsync: jest.fn(),
+}));
+jest.mock('../../steps/utils/android/gradleConfig', () => ({
+  ...jest.requireActual('../../steps/utils/android/gradleConfig'),
+  injectConfigureVersionGradleConfig: jest.fn(),
+  injectCredentialsGradleConfig: jest.fn(),
+}));
+jest.mock('../../utils/artifacts', () => ({
+  uploadApplicationArchive: jest.fn(),
+}));
+jest.mock('../../utils/expoUpdates', () => ({
+  configureExpoUpdatesIfInstalledAsync: jest.fn(),
+  resolveRuntimeVersionForExpoUpdatesIfConfiguredAsync: jest.fn(async () => null),
+}));
+jest.mock('../../utils/hooks', () => ({
+  Hook: {
+    POST_INSTALL: 'POST_INSTALL',
+    PRE_UPLOAD_ARTIFACTS: 'PRE_UPLOAD_ARTIFACTS',
+  },
+  runHookIfPresent: jest.fn(),
+}));
+jest.mock('../../utils/prepareBuildExecutable', () => ({
+  prepareExecutableAsync: jest.fn(),
+}));
+
+describe(androidBuilder, () => {
+  beforeEach(() => {
+    vol.fromJSON(
+      {
+        '/workingdir/env/.gitkeep': '',
+        '/workingdir/build/package.json': JSON.stringify({
+          name: 'test-app',
+          version: '1.0.0',
+        }),
+      },
+      '/'
+    );
+  });
+
+  it('injects Android version config without build credentials', async () => {
+    const job: Android.Job = {
+      ...createTestAndroidJob(),
+      secrets: {
+        buildCredentials: undefined,
+      },
+      version: {
+        versionCode: '42',
+        versionName: '1.2.3',
+      },
+    };
+    const ctx = new BuildContext(job, {
+      workingdir: '/workingdir',
+      logBuffer: { getLogs: () => [], getPhaseLogs: () => [] },
+      logger: createMockLogger(),
+      env: {
+        __API_SERVER_URL: 'http://api.expo.test',
+      },
+      uploadArtifact: jest.fn(),
+    });
+
+    await androidBuilder(ctx);
+
+    expect(injectConfigureVersionGradleConfig).toHaveBeenCalledWith(
+      expect.anything(),
+      '/workingdir/build',
+      {
+        versionCode: '42',
+        versionName: '1.2.3',
+      }
+    );
+    expect(injectCredentialsGradleConfig).not.toHaveBeenCalled();
+    expect(restoreCredentials).not.toHaveBeenCalled();
+  });
+
+  it('injects Android credentials config when build credentials are present', async () => {
+    const ctx = new BuildContext(createTestAndroidJob(), {
+      workingdir: '/workingdir',
+      logBuffer: { getLogs: () => [], getPhaseLogs: () => [] },
+      logger: createMockLogger(),
+      env: {
+        __API_SERVER_URL: 'http://api.expo.test',
+      },
+      uploadArtifact: jest.fn(),
+    });
+
+    await androidBuilder(ctx);
+
+    expect(injectCredentialsGradleConfig).toHaveBeenCalledWith(
+      expect.anything(),
+      '/workingdir/build'
+    );
+    expect(restoreCredentials).toHaveBeenCalledWith(ctx);
+    expect(injectConfigureVersionGradleConfig).not.toHaveBeenCalled();
+  });
+
+  it('marks the configure Android version phase as warning for legacy eas-build.gradle', async () => {
+    const reportBuildPhaseStats = jest.fn();
+    const job: Android.Job = {
+      ...createTestAndroidJob(),
+      secrets: {
+        buildCredentials: undefined,
+      },
+      version: {
+        versionCode: '42',
+        versionName: '1.2.3',
+      },
+    };
+    const ctx = new BuildContext(job, {
+      workingdir: '/workingdir',
+      logBuffer: { getLogs: () => [], getPhaseLogs: () => [] },
+      logger: createMockLogger(),
+      env: {
+        __API_SERVER_URL: 'http://api.expo.test',
+      },
+      uploadArtifact: jest.fn(),
+      reportBuildPhaseStats,
+    });
+    vol.mkdirSync('/workingdir/build/android/app', { recursive: true });
+    vol.writeFileSync('/workingdir/build/android/app/eas-build.gradle', '// Legacy content');
+
+    await androidBuilder(ctx);
+
+    expect(reportBuildPhaseStats).toHaveBeenCalledWith(
+      expect.objectContaining({
+        buildPhase: BuildPhase.CONFIGURE_ANDROID_VERSION,
+        result: BuildPhaseResult.WARNING,
+      })
+    );
+  });
+
+  it('marks the prepare credentials phase as warning for legacy eas-build.gradle', async () => {
+    const reportBuildPhaseStats = jest.fn();
+    const ctx = new BuildContext(createTestAndroidJob(), {
+      workingdir: '/workingdir',
+      logBuffer: { getLogs: () => [], getPhaseLogs: () => [] },
+      logger: createMockLogger(),
+      env: {
+        __API_SERVER_URL: 'http://api.expo.test',
+      },
+      uploadArtifact: jest.fn(),
+      reportBuildPhaseStats,
+    });
+    vol.mkdirSync('/workingdir/build/android/app', { recursive: true });
+    vol.writeFileSync('/workingdir/build/android/app/eas-build.gradle', '// Legacy content');
+
+    await androidBuilder(ctx);
+
+    expect(reportBuildPhaseStats).toHaveBeenCalledWith(
+      expect.objectContaining({
+        buildPhase: BuildPhase.PREPARE_CREDENTIALS,
+        result: BuildPhaseResult.WARNING,
+      })
+    );
+  });
+
+  it('injects credentials and version config when both are configured', async () => {
+    const reportBuildPhaseStats = jest.fn();
+    const job: Android.Job = {
+      ...createTestAndroidJob(),
+      version: {
+        versionCode: '42',
+        versionName: '1.2.3',
+      },
+    };
+    const ctx = new BuildContext(job, {
+      workingdir: '/workingdir',
+      logBuffer: { getLogs: () => [], getPhaseLogs: () => [] },
+      logger: createMockLogger(),
+      env: {
+        __API_SERVER_URL: 'http://api.expo.test',
+      },
+      uploadArtifact: jest.fn(),
+      reportBuildPhaseStats,
+    });
+    vol.mkdirSync('/workingdir/build/android/app', { recursive: true });
+    vol.writeFileSync('/workingdir/build/android/app/eas-build.gradle', '// Legacy content');
+
+    await androidBuilder(ctx);
+
+    expect(injectCredentialsGradleConfig).toHaveBeenCalledWith(
+      expect.anything(),
+      '/workingdir/build'
+    );
+    expect(restoreCredentials).toHaveBeenCalledWith(ctx);
+    expect(injectConfigureVersionGradleConfig).toHaveBeenCalledWith(
+      expect.anything(),
+      '/workingdir/build',
+      {
+        versionCode: '42',
+        versionName: '1.2.3',
+      }
+    );
+    expect(reportBuildPhaseStats).toHaveBeenCalledWith(
+      expect.objectContaining({
+        buildPhase: BuildPhase.PREPARE_CREDENTIALS,
+        result: BuildPhaseResult.WARNING,
+      })
+    );
+    expect(reportBuildPhaseStats).toHaveBeenCalledWith(
+      expect.objectContaining({
+        buildPhase: BuildPhase.CONFIGURE_ANDROID_VERSION,
+        result: BuildPhaseResult.WARNING,
+      })
+    );
+  });
+
+  it('runs the builder through hooks', async () => {
+    const ctx = new BuildContext(createTestAndroidJob(), {
+      workingdir: '/workingdir',
+      logBuffer: { getLogs: () => [], getPhaseLogs: () => [] },
+      logger: createMockLogger(),
+      env: {
+        __API_SERVER_URL: 'http://api.expo.test',
+      },
+      uploadArtifact: jest.fn(),
+    });
+
+    await androidBuilder(ctx);
+
+    expect(runBuilderWithHooksAsync).toHaveBeenCalledWith(ctx, expect.any(Function));
+  });
+});

packages/build-tools/src/builders/__tests__/custom.test.ts

@@ -0,0 +1,135 @@
+import { BuildJob } from '@expo/eas-build-job';
+import { BuildWorkflow } from '@expo/steps';
+import { vol } from 'memfs';
+
+import { createTestIosJob } from '../../__tests__/utils/job';
+import { createMockLogger } from '../../__tests__/utils/logger';
+import { prepareProjectSourcesAsync } from '../../common/projectSources';
+import { BuildContext } from '../../context';
+import { CustomBuildContext } from '../../customBuildContext';
+import { findAndUploadXcodeBuildLogsAsync } from '../../ios/xcodeBuildLogs';
+import { runCustomBuildAsync } from '../custom';
+
+jest.mock('../../common/projectSources');
+jest.mock('../../ios/xcodeBuildLogs');
+
+const findAndUploadXcodeBuildLogsAsyncMock = jest.mocked(findAndUploadXcodeBuildLogsAsync);
+
+describe(runCustomBuildAsync, () => {
+  let ctx: BuildContext<BuildJob>;
+
+  beforeEach(() => {
+    const job = createTestIosJob();
+
+    jest.mocked(prepareProjectSourcesAsync).mockImplementation(async () => {
+      vol.mkdirSync('/workingdir/env', { recursive: true });
+      vol.mkdirSync('/workingdir/temporary-custom-build', { recursive: true });
+      vol.fromJSON(
+        {
+          'test.yaml': `
+          build:
+            steps:
+              - eas/checkout
+          `,
+        },
+        '/workingdir/temporary-custom-build'
+      );
+      return { handled: true };
+    });
+
+    ctx = new BuildContext(
+      {
+        ...job,
+        customBuildConfig: {
+          path: 'test.yaml',
+        },
+      },
+      {
+        workingdir: '/workingdir',
+        logBuffer: { getLogs: () => [], getPhaseLogs: () => [] },
+        logger: createMockLogger(),
+        env: {
+          __API_SERVER_URL: 'http://api.expo.test',
+        },
+        uploadArtifact: jest.fn(),
+      }
+    );
+  });
+
+  it('calls findAndUploadXcodeBuildLogsAsync in an iOS job if its artifacts is empty', async () => {
+    await runCustomBuildAsync(ctx);
+    expect(findAndUploadXcodeBuildLogsAsyncMock).toHaveBeenCalled();
+  });
+
+  it('does not call findAndUploadXcodeBuildLogsAsync in an iOS job if artifacts is already present', async () => {
+    ctx.artifacts.XCODE_BUILD_LOGS = 'uploaded';
+    await runCustomBuildAsync(ctx);
+    expect(findAndUploadXcodeBuildLogsAsyncMock).not.toHaveBeenCalled();
+  });
+
+  it('retries checking out the project', async () => {
+    jest.mocked(prepareProjectSourcesAsync).mockImplementationOnce(async () => {
+      throw new Error('Failed to clone repository');
+    });
+
+    await runCustomBuildAsync(ctx);
+
+    expect(prepareProjectSourcesAsync).toHaveBeenCalledTimes(2);
+  });
+
+  it('awaits drainPendingMetricUploads after workflow execution', async () => {
+    let resolveDrain!: () => void;
+    const drainSpy = jest
+      .spyOn(CustomBuildContext.prototype, 'drainPendingMetricUploads')
+      .mockReturnValue(
+        new Promise<void>(resolve => {
+          resolveDrain = resolve;
+        })
+      );
+
+    let resolved = false;
+    const resultPromise = runCustomBuildAsync(ctx).then(() => {
+      resolved = true;
+    });
+
+    await new Promise(r => setImmediate(r));
+    expect(resolved).toBe(false);
+
+    resolveDrain();
+    await resultPromise;
+    expect(resolved).toBe(true);
+
+    drainSpy.mockRestore();
+  });
+
+  it('awaits drainPendingMetricUploads even when workflow throws', async () => {
+    let resolveDrain!: () => void;
+    const drainSpy = jest
+      .spyOn(CustomBuildContext.prototype, 'drainPendingMetricUploads')
+      .mockReturnValue(
+        new Promise<void>(resolve => {
+          resolveDrain = resolve;
+        })
+      );
+
+    const executeSpy = jest
+      .spyOn(BuildWorkflow.prototype, 'executeAsync')
+      .mockRejectedValue(new Error('workflow failed'));
+
+    let rejected = false;
+    const resultPromise = runCustomBuildAsync(ctx).catch(err => {
+      rejected = true;
+      throw err;
+    });
+
+    await new Promise(r => setImmediate(r));
+    expect(rejected).toBe(false);
+
+    resolveDrain();
+    await expect(resultPromise).rejects.toThrow('workflow failed');
+    expect(rejected).toBe(true);
+
+    drainSpy.mockRestore();
+    executeSpy.mockRestore();
+  });
+});

packages/build-tools/src/builders/android.ts

@@ -0,0 +1,224 @@
+import { Android, BuildMode, BuildPhase, Workflow } from '@expo/eas-build-job';
+import nullthrows from 'nullthrows';
+import path from 'path';
+
+import { runBuilderWithHooksAsync } from './common';
+import { runCustomBuildAsync } from './custom';
+import { restoreCredentials } from '../android/credentials';
+import {
+  ensureLFLineEndingsInGradlewScript,
+  resolveGradleCommand,
+  runGradleCommand,
+} from '../android/gradle';
+import { eagerBundleAsync, shouldUseEagerBundle } from '../common/eagerBundle';
+import { prebuildAsync } from '../common/prebuild';
+import { setupAsync } from '../common/setup';
+import { Artifacts, BuildContext, SkipNativeBuildError } from '../context';
+import {
+  cacheStatsAsync,
+  restoreCcacheAsync,
+  restoreGradleCacheAsync,
+} from '../steps/functions/restoreBuildCache';
+import { saveCcacheAsync, saveGradleCacheAsync } from '../steps/functions/saveBuildCache';
+import {
+  injectConfigureVersionGradleConfig,
+  injectCredentialsGradleConfig,
+  warnIfLegacyEasBuildGradleExists,
+} from '../steps/utils/android/gradleConfig';
+import { uploadApplicationArchive } from '../utils/artifacts';
+import {
+  configureExpoUpdatesIfInstalledAsync,
+  resolveRuntimeVersionForExpoUpdatesIfConfiguredAsync,
+} from '../utils/expoUpdates';
+import { Hook, runHookIfPresent } from '../utils/hooks';
+import { prepareExecutableAsync } from '../utils/prepareBuildExecutable';
+
+export default async function androidBuilder(ctx: BuildContext<Android.Job>): Promise<Artifacts> {
+  if (ctx.job.mode === BuildMode.BUILD) {
+    await prepareExecutableAsync(ctx);
+    return await runBuilderWithHooksAsync(ctx, buildAsync);
+  } else if (ctx.job.mode === BuildMode.RESIGN) {
+    throw new Error('Not implemented');
+  } else if (ctx.job.mode === BuildMode.CUSTOM || ctx.job.mode === BuildMode.REPACK) {
+    return await runCustomBuildAsync(ctx);
+  } else {
+    throw new Error('Not implemented');
+  }
+}
+
+async function buildAsync(ctx: BuildContext<Android.Job>): Promise<void> {
+  await setupAsync(ctx);
+  const evictUsedBefore = new Date();
+  const workingDirectory = ctx.getReactNativeProjectDirectory();
+  const hasNativeCode = ctx.job.type === Workflow.GENERIC;
+
+  if (hasNativeCode) {
+    await ctx.runBuildPhase(BuildPhase.FIX_GRADLEW, async () => {
+      await ensureLFLineEndingsInGradlewScript(ctx);
+    });
+  }
+
+  await ctx.runBuildPhase(BuildPhase.PREBUILD, async () => {
+    if (hasNativeCode) {
+      ctx.markBuildPhaseSkipped();
+      ctx.logger.info(
+        'Skipped running "expo prebuild" because the "android" directory already exists. Learn more about the build process: https://docs.expo.dev/build-reference/android-builds/'
+      );
+      return;
+    }
+    await prebuildAsync(ctx, {
+      logger: ctx.logger,
+      workingDir: ctx.getReactNativeProjectDirectory(),
+    });
+  });
+
+  await ctx.runBuildPhase(BuildPhase.RESTORE_CACHE, async () => {
+    if (ctx.isLocal) {
+      ctx.logger.info('Local builds do not support restoring cache');
+      return;
+    }
+    await ctx.cacheManager?.restoreCache(ctx);
+    await restoreCcacheAsync({
+      logger: ctx.logger,
+      workingDirectory,
+      platform: ctx.job.platform,
+      env: ctx.env,
+      secrets: ctx.job.secrets,
+    });
+    await restoreGradleCacheAsync({
+      logger: ctx.logger,
+      workingDirectory,
+      env: ctx.env,
+      secrets: ctx.job.secrets,
+    });
+  });
+
+  await ctx.runBuildPhase(BuildPhase.POST_INSTALL_HOOK, async () => {
+    await runHookIfPresent(ctx, Hook.POST_INSTALL);
+  });
+
+  const resolvedExpoUpdatesRuntimeVersion = await ctx.runBuildPhase(
+    BuildPhase.CALCULATE_EXPO_UPDATES_RUNTIME_VERSION,
+    async () => {
+      return await resolveRuntimeVersionForExpoUpdatesIfConfiguredAsync({
+        cwd: ctx.getReactNativeProjectDirectory(),
+        logger: ctx.logger,
+        appConfig: await ctx.appConfig,
+        platform: ctx.job.platform,
+        workflow: ctx.job.type,
+        env: ctx.env,
+      });
+    }
+  );
+
+  if (
+    nullthrows(ctx.job.secrets, 'Secrets must be defined for non-custom builds').buildCredentials
+  ) {
+    await ctx.runBuildPhase(BuildPhase.PREPARE_CREDENTIALS, async () => {
+      await warnIfLegacyEasBuildGradleExists(ctx);
+      await restoreCredentials(ctx);
+      await injectCredentialsGradleConfig(ctx.logger, ctx.getReactNativeProjectDirectory());
+    });
+  }
+
+  if (ctx.job.version?.versionCode || ctx.job.version?.versionName) {
+    await ctx.runBuildPhase(BuildPhase.CONFIGURE_ANDROID_VERSION, async () => {
+      await warnIfLegacyEasBuildGradleExists(ctx);
+      await injectConfigureVersionGradleConfig(ctx.logger, ctx.getReactNativeProjectDirectory(), {
+        versionCode: ctx.job.version?.versionCode,
+        versionName: ctx.job.version?.versionName,
+      });
+    });
+  }
+
+  await ctx.runBuildPhase(BuildPhase.CONFIGURE_EXPO_UPDATES, async () => {
+    await configureExpoUpdatesIfInstalledAsync(ctx, {
+      resolvedRuntimeVersion: resolvedExpoUpdatesRuntimeVersion?.runtimeVersion ?? null,
+      resolvedFingerprintSources: resolvedExpoUpdatesRuntimeVersion?.fingerprintSources ?? null,
+    });
+  });
+
+  if (ctx.skipNativeBuild) {
+    throw new SkipNativeBuildError('Skipping Gradle build');
+  }
+
+  if (!ctx.env.EAS_BUILD_DISABLE_BUNDLE_JAVASCRIPT_STEP && shouldUseEagerBundle(ctx.metadata)) {
+    await ctx.runBuildPhase(BuildPhase.EAGER_BUNDLE, async () => {
+      await eagerBundleAsync({
+        platform: ctx.job.platform,
+        workingDir: ctx.getReactNativeProjectDirectory(),
+        logger: ctx.logger,
+        env: {
+          ...ctx.env,
+          ...(resolvedExpoUpdatesRuntimeVersion?.runtimeVersion
+            ? {
+                EXPO_UPDATES_FINGERPRINT_OVERRIDE:
+                  resolvedExpoUpdatesRuntimeVersion?.runtimeVersion,
+                EXPO_UPDATES_WORKFLOW_OVERRIDE: ctx.job.type,
+              }
+            : null),
+        },
+        packageManager: ctx.packageManager,
+      });
+    });
+  }
+
+  await ctx.runBuildPhase(BuildPhase.RUN_GRADLEW, async () => {
+    const gradleCommand = resolveGradleCommand(ctx.job);
+    await runGradleCommand(ctx, {
+      logger: ctx.logger,
+      gradleCommand,
+      androidDir: path.join(ctx.getReactNativeProjectDirectory(), 'android'),
+      ...(resolvedExpoUpdatesRuntimeVersion?.runtimeVersion
+        ? {
+            extraEnv: {
+              EXPO_UPDATES_FINGERPRINT_OVERRIDE: resolvedExpoUpdatesRuntimeVersion.runtimeVersion,
+              EXPO_UPDATES_WORKFLOW_OVERRIDE: ctx.job.type,
+            },
+          }
+        : null),
+    });
+  });
+
+  await ctx.runBuildPhase(BuildPhase.PRE_UPLOAD_ARTIFACTS_HOOK, async () => {
+    await runHookIfPresent(ctx, Hook.PRE_UPLOAD_ARTIFACTS);
+  });
+
+  await ctx.runBuildPhase(BuildPhase.UPLOAD_APPLICATION_ARCHIVE, async () => {
+    await uploadApplicationArchive(ctx, {
+      patternOrPath: ctx.job.applicationArchivePath ?? 'android/app/build/outputs/**/*.{apk,aab}',
+      rootDir: ctx.getReactNativeProjectDirectory(),
+      logger: ctx.logger,
+    });
+  });
+
+  await ctx.runBuildPhase(BuildPhase.SAVE_CACHE, async () => {
+    if (ctx.isLocal) {
+      ctx.logger.info('Local builds do not support saving cache.');
+      return;
+    }
+    await ctx.cacheManager?.saveCache(ctx);
+    await saveCcacheAsync({
+      logger: ctx.logger,
+      workingDirectory,
+      platform: ctx.job.platform,
+      evictUsedBefore,
+      env: ctx.env,
+      secrets: ctx.job.secrets,
+    });
+    await saveGradleCacheAsync({
+      logger: ctx.logger,
+      workingDirectory,
+      env: ctx.env,
+      secrets: ctx.job.secrets,
+    });
+  });
+
+  await ctx.runBuildPhase(BuildPhase.CACHE_STATS, async () => {
+    await cacheStatsAsync({
+      logger: ctx.logger,
+      env: ctx.env,
+      secrets: ctx.job.secrets,
+    });
+  });
+}

packages/build-tools/src/builders/common.ts

@@ -0,0 +1,52 @@
+import { BuildJob, BuildPhase, Ios, Platform } from '@expo/eas-build-job';
+
+import { Artifacts, BuildContext } from '../context';
+import { findAndUploadXcodeBuildLogsAsync } from '../ios/xcodeBuildLogs';
+import { maybeFindAndUploadBuildArtifacts } from '../utils/artifacts';
+import { Hook, runHookIfPresent } from '../utils/hooks';
+
+export async function runBuilderWithHooksAsync<T extends BuildJob>(
+  ctx: BuildContext<T>,
+  builderAsync: (ctx: BuildContext<T>) => Promise<void>
+): Promise<Artifacts> {
+  try {
+    let buildSuccess = true;
+    try {
+      await builderAsync(ctx);
+      await ctx.runBuildPhase(BuildPhase.ON_BUILD_SUCCESS_HOOK, async () => {
+        await runHookIfPresent(ctx, Hook.ON_BUILD_SUCCESS);
+      });
+    } catch (err: any) {
+      buildSuccess = false;
+      await ctx.runBuildPhase(BuildPhase.ON_BUILD_ERROR_HOOK, async () => {
+        await runHookIfPresent(ctx, Hook.ON_BUILD_ERROR);
+      });
+      throw err;
+    } finally {
+      await ctx.runBuildPhase(BuildPhase.ON_BUILD_COMPLETE_HOOK, async () => {
+        await runHookIfPresent(ctx, Hook.ON_BUILD_COMPLETE, {
+          extraEnvs: {
+            EAS_BUILD_STATUS: buildSuccess ? 'finished' : 'errored',
+          },
+        });
+      });
+
+      if (ctx.job.platform === Platform.IOS) {
+        await findAndUploadXcodeBuildLogsAsync(ctx as BuildContext<Ios.Job>, {
+          logger: ctx.logger,
+        });
+      }
+
+      await ctx.runBuildPhase(BuildPhase.UPLOAD_BUILD_ARTIFACTS, async () => {
+        await maybeFindAndUploadBuildArtifacts(ctx, {
+          logger: ctx.logger,
+        });
+      });
+    }
+  } catch (err: any) {
+    err.artifacts = ctx.artifacts;
+    throw err;
+  }
+
+  return ctx.artifacts;
+}

packages/build-tools/src/builders/custom.ts

@@ -0,0 +1,105 @@
+import { BuildJob, BuildPhase, BuildTrigger, Ios, Platform } from '@expo/eas-build-job';
+import { BuildConfigParser, BuildStepGlobalContext, StepsConfigParser, errors } from '@expo/steps';
+import assert from 'assert';
+import fs from 'fs/promises';
+import nullthrows from 'nullthrows';
+import path from 'path';
+
+import { resolveEnvFromBuildProfileAsync } from '../common/easBuildInternal';
+import { prepareProjectSourcesAsync } from '../common/projectSources';
+import { Artifacts, BuildContext } from '../context';
+import { CustomBuildContext } from '../customBuildContext';
+import { findAndUploadXcodeBuildLogsAsync } from '../ios/xcodeBuildLogs';
+import { getEasFunctionGroups } from '../steps/easFunctionGroups';
+import { getEasFunctions } from '../steps/easFunctions';
+import { retryAsync } from '../utils/retry';
+
+export async function runCustomBuildAsync(ctx: BuildContext<BuildJob>): Promise<Artifacts> {
+  const customBuildCtx = new CustomBuildContext(ctx);
+
+  await ctx.runBuildPhase(BuildPhase.PREPARE_PROJECT, async () => {
+    await retryAsync(
+      async () => {
+        await fs.rm(customBuildCtx.projectSourceDirectory, { recursive: true, force: true });
+        await fs.mkdir(customBuildCtx.projectSourceDirectory, { recursive: true });
+
+        await prepareProjectSourcesAsync(ctx, customBuildCtx.projectSourceDirectory);
+      },
+      {
+        retryOptions: {
+          retries: 3,
+          retryIntervalMs: 1_000,
+        },
+      }
+    );
+  });
+
+  if (ctx.job.triggeredBy === BuildTrigger.GIT_BASED_INTEGRATION) {
+    // We need to setup envs from eas.json
+    const env = await resolveEnvFromBuildProfileAsync(ctx, {
+      cwd: path.join(customBuildCtx.projectSourceDirectory, ctx.job.projectRootDirectory ?? '.'),
+    });
+    ctx.updateEnv(env);
+    customBuildCtx.updateEnv(ctx.env);
+  }
+
+  assert(
+    'steps' in ctx.job || 'customBuildConfig' in ctx.job,
+    'Steps or custom build config path are required in custom jobs'
+  );
+
+  const globalContext = new BuildStepGlobalContext(customBuildCtx, false);
+  const easFunctions = getEasFunctions(customBuildCtx);
+  const easFunctionGroups = getEasFunctionGroups(customBuildCtx);
+  const parser = ctx.job.steps
+    ? new StepsConfigParser(globalContext, {
+        externalFunctions: easFunctions,
+        externalFunctionGroups: easFunctionGroups,
+        steps: ctx.job.steps,
+      })
+    : new BuildConfigParser(globalContext, {
+        externalFunctions: easFunctions,
+        externalFunctionGroups: easFunctionGroups,
+        configPath: path.join(
+          ctx.getReactNativeProjectDirectory(customBuildCtx.projectSourceDirectory),
+          nullthrows(
+            ctx.job.customBuildConfig?.path,
+            'Steps or custom build config path are required in custom jobs'
+          )
+        ),
+      });
+  const workflow = await ctx.runBuildPhase(BuildPhase.PARSE_CUSTOM_WORKFLOW_CONFIG, async () => {
+    try {
+      return await parser.parseAsync();
+    } catch (parseError: any) {
+      ctx.logger.error('Failed to parse the custom build config file.');
+      if (parseError instanceof errors.BuildWorkflowError) {
+        for (const err of parseError.errors) {
+          ctx.logger.error({ err });
+        }
+      }
+      throw parseError;
+    }
+  });
+  try {
+    try {
+      await workflow.executeAsync();
+    } finally {
+      if (!ctx.artifacts.XCODE_BUILD_LOGS && ctx.job.platform === Platform.IOS) {
+        try {
+          await findAndUploadXcodeBuildLogsAsync(ctx as BuildContext<Ios.Job>, {
+            logger: ctx.logger,
+          });
+        } catch {
+          // do nothing, it's a non-breaking error.
+        }
+      }
+      await customBuildCtx.drainPendingMetricUploads();
+    }
+  } catch (err: any) {
+    err.artifacts = ctx.artifacts;
+    throw err;
+  }
+
+  return ctx.artifacts;
+}

packages/build-tools/src/builders/index.ts

@@ -0,0 +1,4 @@
+import androidBuilder from './android';
+import iosBuilder from './ios';
+
+export { androidBuilder, iosBuilder };

packages/build-tools/src/builders/ios.ts

@@ -0,0 +1,351 @@
+import { IOSConfig } from '@expo/config-plugins';
+import { BuildMode, BuildPhase, Ios, ManagedArtifactType, Workflow } from '@expo/eas-build-job';
+import plist from '@expo/plist';
+import fs from 'fs-extra';
+import nullthrows from 'nullthrows';
+
+import { runBuilderWithHooksAsync } from './common';
+import { runCustomBuildAsync } from './custom';
+import { eagerBundleAsync, shouldUseEagerBundle } from '../common/eagerBundle';
+import { prebuildAsync } from '../common/prebuild';
+import { setupAsync } from '../common/setup';
+import { Artifacts, BuildContext } from '../context';
+import { configureXcodeProject } from '../ios/configure';
+import CredentialsManager from '../ios/credentials/manager';
+import { runFastlaneGym, runFastlaneResign } from '../ios/fastlane';
+import { installPods } from '../ios/pod';
+import { downloadApplicationArchiveAsync } from '../ios/resign';
+import { resolveArtifactPath, resolveBuildConfiguration, resolveScheme } from '../ios/resolve';
+import { Sentry } from '../sentry';
+import { parseAndReportXcactivitylog } from '../steps/utils/ios/xcactivitylog';
+import { cacheStatsAsync, restoreCcacheAsync } from '../steps/functions/restoreBuildCache';
+import { saveCcacheAsync } from '../steps/functions/saveBuildCache';
+import { uploadApplicationArchive } from '../utils/artifacts';
+import {
+  configureExpoUpdatesIfInstalledAsync,
+  resolveRuntimeVersionForExpoUpdatesIfConfiguredAsync,
+} from '../utils/expoUpdates';
+import { Hook, runHookIfPresent } from '../utils/hooks';
+import { prepareExecutableAsync } from '../utils/prepareBuildExecutable';
+import { getParentAndDescendantProcessPidsAsync } from '../utils/processes';
+
+const INSTALL_PODS_WARN_TIMEOUT_MS = 15 * 60 * 1000; // 15 minutes
+const INSTALL_PODS_KILL_TIMEOUT_MS = 30 * 60 * 1000; // 30 minutes
+
+class InstallPodsTimeoutError extends Error {}
+
+export default async function iosBuilder(ctx: BuildContext<Ios.Job>): Promise<Artifacts> {
+  if (ctx.job.mode === BuildMode.BUILD) {
+    await prepareExecutableAsync(ctx);
+    return await runBuilderWithHooksAsync(ctx, buildAsync);
+  } else if (ctx.job.mode === BuildMode.RESIGN) {
+    return await resignAsync(ctx);
+  } else if (ctx.job.mode === BuildMode.CUSTOM || ctx.job.mode === BuildMode.REPACK) {
+    return await runCustomBuildAsync(ctx);
+  } else {
+    throw new Error('Not implemented');
+  }
+}
+
+async function buildAsync(ctx: BuildContext<Ios.Job>): Promise<void> {
+  await setupAsync(ctx);
+  const hasNativeCode = ctx.job.type === Workflow.GENERIC;
+  const evictUsedBefore = new Date();
+  const credentialsManager = new CredentialsManager(ctx);
+  const workingDirectory = ctx.getReactNativeProjectDirectory();
+  let fastlaneResult: { derivedDataPath: string; workspacePath: string } | undefined;
+  try {
+    const credentials = await ctx.runBuildPhase(BuildPhase.PREPARE_CREDENTIALS, async () => {
+      return await credentialsManager.prepare();
+    });
+
+    await ctx.runBuildPhase(BuildPhase.PREBUILD, async () => {
+      if (hasNativeCode) {
+        ctx.markBuildPhaseSkipped();
+        ctx.logger.info(
+          'Skipped running "expo prebuild" because the "ios" directory already exists. Learn more about the build process: https://docs.expo.dev/build-reference/ios-builds/'
+        );
+        return;
+      }
+      const extraEnvs: Record<string, string> = credentials?.teamId
+        ? { APPLE_TEAM_ID: credentials.teamId }
+        : {};
+      await prebuildAsync(ctx, {
+        logger: ctx.logger,
+        workingDir: ctx.getReactNativeProjectDirectory(),
+        options: { extraEnvs },
+      });
+    });
+
+    await ctx.runBuildPhase(BuildPhase.RESTORE_CACHE, async () => {
+      if (ctx.isLocal) {
+        ctx.logger.info('Local builds do not support restoring cache');
+        return;
+      }
+      await ctx.cacheManager?.restoreCache(ctx);
+      await restoreCcacheAsync({
+        logger: ctx.logger,
+        workingDirectory,
+        platform: ctx.job.platform,
+        env: ctx.env,
+        secrets: ctx.job.secrets,
+      });
+    });
+
+    await ctx.runBuildPhase(BuildPhase.INSTALL_PODS, async () => {
+      await runInstallPodsAsync(ctx);
+    });
+
+    await ctx.runBuildPhase(BuildPhase.POST_INSTALL_HOOK, async () => {
+      await runHookIfPresent(ctx, Hook.POST_INSTALL);
+    });
+
+    const resolvedExpoUpdatesRuntimeVersion = await ctx.runBuildPhase(
+      BuildPhase.CALCULATE_EXPO_UPDATES_RUNTIME_VERSION,
+      async () => {
+        return await resolveRuntimeVersionForExpoUpdatesIfConfiguredAsync({
+          cwd: ctx.getReactNativeProjectDirectory(),
+          logger: ctx.logger,
+          appConfig: await ctx.appConfig,
+          platform: ctx.job.platform,
+          workflow: ctx.job.type,
+          env: ctx.env,
+        });
+      }
+    );
+
+    const buildConfiguration = resolveBuildConfiguration(ctx);
+    if (credentials) {
+      await ctx.runBuildPhase(BuildPhase.CONFIGURE_XCODE_PROJECT, async () => {
+        await configureXcodeProject(ctx, { credentials, buildConfiguration });
+      });
+    }
+
+    await ctx.runBuildPhase(BuildPhase.CONFIGURE_EXPO_UPDATES, async () => {
+      await configureExpoUpdatesIfInstalledAsync(ctx, {
+        resolvedRuntimeVersion: resolvedExpoUpdatesRuntimeVersion?.runtimeVersion ?? null,
+        resolvedFingerprintSources: resolvedExpoUpdatesRuntimeVersion?.fingerprintSources ?? null,
+      });
+    });
+
+    if (!ctx.env.EAS_BUILD_DISABLE_BUNDLE_JAVASCRIPT_STEP && shouldUseEagerBundle(ctx.metadata)) {
+      await ctx.runBuildPhase(BuildPhase.EAGER_BUNDLE, async () => {
+        await eagerBundleAsync({
+          platform: ctx.job.platform,
+          workingDir: ctx.getReactNativeProjectDirectory(),
+          logger: ctx.logger,
+          env: {
+            ...ctx.env,
+            ...(resolvedExpoUpdatesRuntimeVersion?.runtimeVersion
+              ? {
+                  EXPO_UPDATES_FINGERPRINT_OVERRIDE:
+                    resolvedExpoUpdatesRuntimeVersion?.runtimeVersion,
+                  EXPO_UPDATES_WORKFLOW_OVERRIDE: ctx.job.type,
+                }
+              : null),
+          },
+          packageManager: ctx.packageManager,
+        });
+      });
+    }
+
+    fastlaneResult = await ctx.runBuildPhase(BuildPhase.RUN_FASTLANE, async () => {
+      const scheme = resolveScheme(ctx);
+      const entitlements = await readEntitlementsAsync(ctx, { scheme, buildConfiguration });
+      return await runFastlaneGym(ctx, {
+        credentials,
+        scheme,
+        buildConfiguration,
+        entitlements,
+        ...(resolvedExpoUpdatesRuntimeVersion?.runtimeVersion
+          ? {
+              extraEnv: {
+                EXPO_UPDATES_FINGERPRINT_OVERRIDE:
+                  resolvedExpoUpdatesRuntimeVersion?.runtimeVersion,
+                EXPO_UPDATES_WORKFLOW_OVERRIDE: ctx.job.type,
+              },
+            }
+          : null),
+      });
+    });
+  } finally {
+    await ctx.runBuildPhase(BuildPhase.CLEAN_UP_CREDENTIALS, async () => {
+      await credentialsManager.cleanUp();
+    });
+  }
+
+  await ctx.runBuildPhase(BuildPhase.PARSE_XCACTIVITYLOG, async () => {
+    if (ctx.isLocal) {
+      ctx.logger.info('Local builds skip build performance analysis.');
+      return;
+    }
+    try {
+      const { derivedDataPath, workspacePath } = nullthrows(fastlaneResult);
+      await parseAndReportXcactivitylog({
+        derivedDataPath,
+        workspacePath,
+        logger: ctx.logger,
+        proxyBaseUrl: ctx.env.EAS_BUILD_COCOAPODS_CACHE_URL,
+        env: ctx.env,
+      });
+    } catch (err: any) {
+      Sentry.capture('Failed to parse xcactivitylog', err);
+      ctx.markBuildPhaseSkipped();
+    }
+  });
+
+  await ctx.runBuildPhase(BuildPhase.PRE_UPLOAD_ARTIFACTS_HOOK, async () => {
+    await runHookIfPresent(ctx, Hook.PRE_UPLOAD_ARTIFACTS);
+  });
+
+  await ctx.runBuildPhase(BuildPhase.UPLOAD_APPLICATION_ARCHIVE, async () => {
+    await uploadApplicationArchive(ctx, {
+      patternOrPath: resolveArtifactPath(ctx),
+      rootDir: ctx.getReactNativeProjectDirectory(),
+      logger: ctx.logger,
+    });
+  });
+
+  await ctx.runBuildPhase(BuildPhase.SAVE_CACHE, async () => {
+    if (ctx.isLocal) {
+      ctx.logger.info('Local builds do not support saving cache.');
+      return;
+    }
+    await ctx.cacheManager?.saveCache(ctx);
+    await saveCcacheAsync({
+      logger: ctx.logger,
+      workingDirectory,
+      platform: ctx.job.platform,
+      evictUsedBefore,
+      env: ctx.env,
+      secrets: ctx.job.secrets,
+    });
+  });
+
+  await ctx.runBuildPhase(BuildPhase.CACHE_STATS, async () => {
+    await cacheStatsAsync({
+      logger: ctx.logger,
+      env: ctx.env,
+      secrets: ctx.job.secrets,
+    });
+  });
+}
+
+async function readEntitlementsAsync(
+  ctx: BuildContext<Ios.Job>,
+  { scheme, buildConfiguration }: { scheme: string; buildConfiguration: string }
+): Promise<object | null> {
+  try {
+    const applicationTargetName =
+      await IOSConfig.BuildScheme.getApplicationTargetNameForSchemeAsync(
+        ctx.getReactNativeProjectDirectory(),
+        scheme
+      );
+    const entitlementsPath = IOSConfig.Entitlements.getEntitlementsPath(
+      ctx.getReactNativeProjectDirectory(),
+      {
+        buildConfiguration,
+        targetName: applicationTargetName,
+      }
+    );
+    if (!entitlementsPath) {
+      return null;
+    }
+    const entitlementsRaw = await fs.readFile(entitlementsPath, 'utf8');
+    return plist.parse(entitlementsRaw);
+  } catch (err) {
+    ctx.logger.warn({ err }, 'Failed to read entitlements');
+    ctx.markBuildPhaseHasWarnings();
+    return null;
+  }
+}
+
+async function resignAsync(ctx: BuildContext<Ios.Job>): Promise<Artifacts> {
+  const applicationArchivePath = await ctx.runBuildPhase(
+    BuildPhase.DOWNLOAD_APPLICATION_ARCHIVE,
+    async () => {
+      return await downloadApplicationArchiveAsync(ctx);
+    }
+  );
+
+  const credentialsManager = new CredentialsManager(ctx);
+  try {
+    const credentials = await ctx.runBuildPhase(BuildPhase.PREPARE_CREDENTIALS, async () => {
+      return await credentialsManager.prepare();
+    });
+
+    await ctx.runBuildPhase(BuildPhase.RUN_FASTLANE, async () => {
+      await runFastlaneResign(ctx, {
+        credentials: nullthrows(credentials),
+        ipaPath: applicationArchivePath,
+      });
+    });
+  } finally {
+    await ctx.runBuildPhase(BuildPhase.CLEAN_UP_CREDENTIALS, async () => {
+      await credentialsManager.cleanUp();
+    });
+  }
+
+  await ctx.runBuildPhase(BuildPhase.UPLOAD_APPLICATION_ARCHIVE, async () => {
+    ctx.logger.info(`Application archive: ${applicationArchivePath}`);
+    await ctx.uploadArtifact({
+      artifact: {
+        type: ManagedArtifactType.APPLICATION_ARCHIVE,
+        paths: [applicationArchivePath],
+      },
+      logger: ctx.logger,
+    });
+  });
+
+  return ctx.artifacts;
+}
+
+async function runInstallPodsAsync(ctx: BuildContext<Ios.Job>): Promise<void> {
+  let warnTimeout: NodeJS.Timeout | undefined;
+  let killTimeout: NodeJS.Timeout | undefined;
+  let timedOutToKill: boolean = false;
+  try {
+    const installPodsSpawnPromise = (
+      await installPods(ctx, {
+        infoCallbackFn: () => {
+          warnTimeout?.refresh();
+          killTimeout?.refresh();
+        },
+      })
+    ).spawnPromise;
+    warnTimeout = setTimeout(() => {
+      ctx.logger.warn(
+        '"Install pods" phase takes longer then expected and it did not produce any logs in the past 15 minutes'
+      );
+    }, INSTALL_PODS_WARN_TIMEOUT_MS);
+
+    killTimeout = setTimeout(async () => {
+      timedOutToKill = true;
+      ctx.logger.error(
+        '"Install pods" phase takes a very long time and it did not produce any logs in the past 30 minutes. Most likely an unexpected error happened which caused the process to hang and it will be terminated'
+      );
+      const ppid = nullthrows(installPodsSpawnPromise.child.pid);
+      const pids = await getParentAndDescendantProcessPidsAsync(ppid);
+      pids.forEach(pid => {
+        process.kill(pid);
+      });
+      ctx.reportError?.('"Install pods" phase takes a very long time', undefined, {
+        extras: { buildId: ctx.env.EAS_BUILD_ID },
+      });
+    }, INSTALL_PODS_KILL_TIMEOUT_MS);
+
+    await installPodsSpawnPromise;
+  } catch (err: any) {
+    if (timedOutToKill) {
+      throw new InstallPodsTimeoutError('"Install pods" phase was inactive for over 30 minutes');
+    }
+    throw err;
+  } finally {
+    if (warnTimeout) {
+      clearTimeout(warnTimeout);
+    }
+    if (killTimeout) {
+      clearTimeout(killTimeout);
+    }
+  }
+}

packages/build-tools/src/common/__tests__/easBuildInternal.test.ts

@@ -0,0 +1,72 @@
+import { BuildJob } from '@expo/eas-build-job';
+import spawn from '@expo/turtle-spawn';
+
+import { resolveEnvFromBuildProfileAsync, runEasBuildInternalAsync } from '../easBuildInternal';
+import { resolveEasCommandPrefixAndEnvAsync } from '../../utils/easCli';
+
+jest.mock('@expo/turtle-spawn', () => ({
+  __esModule: true,
+  default: jest.fn(),
+}));
+jest.mock('../../utils/easCli', () => ({
+  ...jest.requireActual('../../utils/easCli'),
+  resolveEasCommandPrefixAndEnvAsync: jest.fn(),
+}));
+
+describe('easBuildInternal', () => {
+  beforeEach(() => {
+    jest.resetAllMocks();
+    jest.mocked(resolveEasCommandPrefixAndEnvAsync).mockResolvedValue({
+      cmd: 'npx',
+      args: ['-y', 'eas-cli@latest'],
+      extraEnv: {},
+    });
+  });
+
+  it('calls resolveEasCommandPrefixAndEnvAsync in runEasBuildInternalAsync', async () => {
+    const logger = {
+      info: jest.fn(),
+      warn: jest.fn(),
+      error: jest.fn(),
+      child: jest.fn(),
+    } as any;
+
+    const job = {
+      platform: 'android',
+      secrets: { robotAccessToken: 'token' },
+    } as unknown as BuildJob;
+
+    await expect(
+      runEasBuildInternalAsync({
+        job,
+        logger,
+        env: {},
+        cwd: '/tmp/project',
+      })
+    ).rejects.toThrow('build profile is missing in a build from git-based integration.');
+
+    expect(resolveEasCommandPrefixAndEnvAsync).toHaveBeenCalledWith();
+    expect(spawn).not.toHaveBeenCalled();
+  });
+
+  it('calls resolveEasCommandPrefixAndEnvAsync in resolveEnvFromBuildProfileAsync', async () => {
+    const logger = {
+      info: jest.fn(),
+      warn: jest.fn(),
+      error: jest.fn(),
+      child: jest.fn(),
+    } as any;
+    const ctx = {
+      logger,
+      env: {},
+      job: { platform: 'ios' },
+    } as any;
+
+    await expect(resolveEnvFromBuildProfileAsync(ctx, { cwd: '/tmp/project' })).rejects.toThrow(
+      'build profile is missing in a build from git-based integration.'
+    );
+
+    expect(resolveEasCommandPrefixAndEnvAsync).toHaveBeenCalledWith();
+    expect(spawn).not.toHaveBeenCalled();
+  });
+});

packages/build-tools/src/common/__tests__/projectSources.test.ts

@@ -0,0 +1,575 @@
+import {
+  ArchiveSourceType,
+  BuildMode,
+  BuildTrigger,
+  Job,
+  Platform,
+  Workflow,
+} from '@expo/eas-build-job';
+import { randomBytes, randomUUID } from 'crypto';
+import { vol } from 'memfs';
+import fetch, { Response } from 'node-fetch';
+import { setTimeout } from 'timers/promises';
+
+import { createMockLogger } from '../../__tests__/utils/logger';
+import { BuildContext } from '../../context';
+import { shallowCloneRepositoryAsync } from '../git';
+import { prepareProjectSourcesAsync } from '../projectSources';
+
+jest.mock('@expo/turtle-spawn');
+jest.mock('node-fetch');
+jest.mock('../git');
+jest.mock('@expo/downloader');
+jest.mock('@urql/core');
+
+describe('projectSources', () => {
+  it('should use the refreshed repository URL', async () => {
+    const robotAccessToken = randomUUID();
+    const buildId = randomUUID();
+    await vol.promises.mkdir('/workingdir/environment-secrets/', { recursive: true });
+
+    const gitCommitHash = randomBytes(20).toString('hex');
+
+    const ctx = new BuildContext(
+      {
+        triggeredBy: BuildTrigger.GIT_BASED_INTEGRATION,
+        type: Workflow.MANAGED,
+        mode: BuildMode.BUILD,
+        initiatingUserId: randomUUID(),
+        appId: randomUUID(),
+        projectArchive: {
+          type: ArchiveSourceType.GIT,
+          repositoryUrl: 'https://x-access-token:[email protected]/expo/eas-cli.git',
+          gitRef: 'refs/heads/main',
+          gitCommitHash,
+        },
+        platform: Platform.IOS,
+        secrets: {
+          robotAccessToken,
+          environmentSecrets: [],
+        },
+      } as Job,
+      {
+        env: {
+          __API_SERVER_URL: 'https://api.expo.dev',
+          EXPO_TOKEN: robotAccessToken,
+          EAS_BUILD_ID: buildId,
+          EAS_BUILD_RUNNER: 'eas-build',
+        },
+        workingdir: '/workingdir',
+        logger: createMockLogger(),
+        logBuffer: { getLogs: () => [], getPhaseLogs: () => [] },
+        uploadArtifact: jest.fn(),
+      }
+    );
+    const fetchMock = jest.mocked(fetch);
+    fetchMock.mockImplementation(
+      async () =>
+        ({
+          ok: true,
+          json: async () => ({
+            data: {
+              gitRef: 'refs/heads/main',
+              gitCommitHash,
+              repositoryUrl: 'https://x-access-token:[email protected]/expo/eas-cli.git',
+              type: ArchiveSourceType.GIT,
+            },
+          }),
+        }) as Response
+    );
+
+    await prepareProjectSourcesAsync(ctx, ctx.buildDirectory);
+    expect(shallowCloneRepositoryAsync).toHaveBeenCalledWith(
+      expect.objectContaining({
+        archiveSource: {
+          ...ctx.job.projectArchive,
+          repositoryUrl: 'https://x-access-token:[email protected]/expo/eas-cli.git',
+        },
+      })
+    );
+  });
+
+  it('should fallback to the original repository URL if the refresh fails', async () => {
+    const robotAccessToken = randomUUID();
+    const buildId = randomUUID();
+    await vol.promises.mkdir('/workingdir/environment-secrets/', { recursive: true });
+
+    const ctx = new BuildContext(
+      {
+        triggeredBy: BuildTrigger.GIT_BASED_INTEGRATION,
+        type: Workflow.MANAGED,
+        mode: BuildMode.BUILD,
+        initiatingUserId: randomUUID(),
+        appId: randomUUID(),
+        projectArchive: {
+          type: ArchiveSourceType.GIT,
+          repositoryUrl: 'https://x-access-token:[email protected]/expo/eas-cli.git',
+          gitRef: 'refs/heads/main',
+          gitCommitHash: randomBytes(20).toString('hex'),
+        },
+        platform: Platform.IOS,
+        secrets: {
+          robotAccessToken,
+          environmentSecrets: [],
+        },
+      } as Job,
+      {
+        env: {
+          __API_SERVER_URL: 'https://api.expo.dev',
+          EXPO_TOKEN: robotAccessToken,
+          EAS_BUILD_ID: buildId,
+          EAS_BUILD_RUNNER: 'eas-build',
+        },
+        workingdir: '/workingdir',
+        logger: createMockLogger(),
+        logBuffer: { getLogs: () => [], getPhaseLogs: () => [] },
+        uploadArtifact: jest.fn(),
+      }
+    );
+    const fetchMock = jest.mocked(fetch);
+    fetchMock.mockImplementation(
+      async () =>
+        ({
+          ok: false,
+          text: async () => 'Failed to generate repository URL',
+        }) as Response
+    );
+
+    await prepareProjectSourcesAsync(ctx, ctx.buildDirectory);
+    expect(shallowCloneRepositoryAsync).toHaveBeenLastCalledWith(
+      expect.objectContaining({
+        archiveSource: {
+          ...ctx.job.projectArchive,
+          repositoryUrl: 'https://x-access-token:[email protected]/expo/eas-cli.git',
+        },
+      })
+    );
+    fetchMock.mockImplementation(
+      async () =>
+        ({
+          ok: false,
+          json: async () => ({
+            // repositoryUrl is the right key
+            repository_url: 'https://x-access-token:[email protected]/expo/eas-cli.git',
+          }),
+        }) as Response
+    );
+
+    await prepareProjectSourcesAsync(ctx, ctx.buildDirectory);
+    expect(shallowCloneRepositoryAsync).toHaveBeenLastCalledWith(
+      expect.objectContaining({
+        archiveSource: {
+          ...ctx.job.projectArchive,
+          repositoryUrl: 'https://x-access-token:[email protected]/expo/eas-cli.git',
+        },
+      })
+    );
+
+    fetchMock.mockImplementation(
+      async () =>
+        ({
+          ok: false,
+          json: () => Promise.reject(new Error('Failed to generate repository URL')),
+        }) as Response
+    );
+
+    await prepareProjectSourcesAsync(ctx, ctx.buildDirectory);
+    expect(shallowCloneRepositoryAsync).toHaveBeenLastCalledWith(
+      expect.objectContaining({
+        archiveSource: {
+          ...ctx.job.projectArchive,
+          repositoryUrl: 'https://x-access-token:[email protected]/expo/eas-cli.git',
+        },
+      })
+    );
+
+    expect(shallowCloneRepositoryAsync).toHaveBeenCalledTimes(3);
+  }, 15_000);
+
+  it('should retry fetching the repository URL', async () => {
+    const robotAccessToken = randomUUID();
+    const buildId = randomUUID();
+    await vol.promises.mkdir('/workingdir/environment-secrets/', { recursive: true });
+
+    const gitCommitHash = randomBytes(20).toString('hex');
+
+    const ctx = new BuildContext(
+      {
+        triggeredBy: BuildTrigger.GIT_BASED_INTEGRATION,
+        type: Workflow.MANAGED,
+        mode: BuildMode.BUILD,
+        initiatingUserId: randomUUID(),
+        appId: randomUUID(),
+        projectArchive: {
+          type: ArchiveSourceType.GIT,
+          repositoryUrl: 'https://x-access-token:[email protected]/expo/eas-cli.git',
+          gitRef: 'refs/heads/main',
+          gitCommitHash,
+        },
+        platform: Platform.IOS,
+        secrets: {
+          robotAccessToken,
+          environmentSecrets: [],
+        },
+      } as Job,
+      {
+        env: {
+          __API_SERVER_URL: 'https://api.expo.dev',
+          EXPO_TOKEN: robotAccessToken,
+          EAS_BUILD_ID: buildId,
+          EAS_BUILD_RUNNER: 'eas-build',
+        },
+        workingdir: '/workingdir',
+        logger: createMockLogger(),
+        logBuffer: { getLogs: () => [], getPhaseLogs: () => [] },
+        uploadArtifact: jest.fn(),
+      }
+    );
+    const fetchMock = jest.mocked(fetch);
+    fetchMock.mockImplementationOnce(
+      async () =>
+        ({
+          ok: false,
+          text: async () => 'Failed to generate repository URL',
+        }) as Response
+    );
+    fetchMock.mockImplementationOnce(
+      async () =>
+        ({
+          ok: true,
+          json: async () => ({
+            data: {
+              repositoryUrl: 'https://x-access-token:[email protected]/expo/eas-cli.git',
+              gitRef: 'refs/heads/main',
+              gitCommitHash,
+              type: ArchiveSourceType.GIT,
+            },
+          }),
+        }) as Response
+    );
+
+    await prepareProjectSourcesAsync(ctx, ctx.buildDirectory);
+    expect(shallowCloneRepositoryAsync).toHaveBeenLastCalledWith(
+      expect.objectContaining({
+        archiveSource: {
+          ...ctx.job.projectArchive,
+          repositoryUrl: 'https://x-access-token:[email protected]/expo/eas-cli.git',
+        },
+      })
+    );
+  }, 15_000);
+
+  it(`should fallback to the original repository URL if we're missing some config`, async () => {
+    const robotAccessToken = randomUUID();
+    await vol.promises.mkdir('/workingdir/environment-secrets/', { recursive: true });
+    const logger = createMockLogger();
+
+    const ctx = new BuildContext(
+      {
+        triggeredBy: BuildTrigger.GIT_BASED_INTEGRATION,
+        type: Workflow.MANAGED,
+        mode: BuildMode.BUILD,
+        initiatingUserId: randomUUID(),
+        appId: randomUUID(),
+        projectArchive: {
+          type: ArchiveSourceType.GIT,
+          repositoryUrl: 'https://x-access-token:[email protected]/expo/eas-cli.git',
+          gitRef: 'refs/heads/main',
+          gitCommitHash: randomBytes(20).toString('hex'),
+        },
+        platform: Platform.IOS,
+        secrets: {
+          robotAccessToken,
+          environmentSecrets: [],
+        },
+      } as Job,
+      {
+        env: {
+          __API_SERVER_URL: 'https://api.expo.dev',
+          EXPO_TOKEN: robotAccessToken,
+          EAS_BUILD_RUNNER: 'eas-build',
+          // EAS_BUILD_ID: buildId,
+        },
+        workingdir: '/workingdir',
+        logger,
+        logBuffer: { getLogs: () => [], getPhaseLogs: () => [] },
+        uploadArtifact: jest.fn(),
+      }
+    );
+
+    await prepareProjectSourcesAsync(ctx, ctx.buildDirectory);
+
+    expect(logger.error).toHaveBeenCalledWith(
+      { err: expect.any(Error) },
+      'Failed to refresh project archive, falling back to the original one'
+    );
+  });
+
+  describe('uploadProjectMetadataAsFireAndForget', () => {
+    beforeEach(() => {
+      jest.clearAllMocks();
+    });
+
+    it('should upload project metadata for build job with URL archive type', async () => {
+      const robotAccessToken = randomUUID();
+      const buildId = randomUUID();
+      const bucketKey = `test-bucket-key-${randomUUID()}`;
+      await vol.promises.mkdir('/workingdir/build', { recursive: true });
+      await vol.promises.writeFile('/workingdir/build/package.json', '{}');
+      await vol.promises.writeFile('/workingdir/build/README.md', 'Hello, world!');
+
+      const mockGraphqlMutation = jest.fn();
+      mockGraphqlMutation
+        .mockReturnValueOnce({
+          toPromise: () =>
+            Promise.resolve({
+              data: {
+                uploadSession: {
+                  createUploadSession: {
+                    url: 'https://storage.example.com/upload',
+                    bucketKey,
+                    headers: { 'x-custom-header': 'value' },
+                  },
+                },
+              },
+            }),
+        })
+        .mockReturnValueOnce({
+          toPromise: () =>
+            Promise.resolve({
+              data: {
+                build: {
+                  updateBuildMetadata: {
+                    id: buildId,
+                  },
+                },
+              },
+            }),
+        });
+
+      const ctx = new BuildContext(
+        {
+          triggeredBy: BuildTrigger.EAS_CLI,
+          type: Workflow.MANAGED,
+          mode: BuildMode.BUILD,
+          initiatingUserId: randomUUID(),
+          appId: randomUUID(),
+          projectArchive: {
+            type: ArchiveSourceType.URL,
+            url: 'https://example.com/project.tar.gz',
+          },
+          platform: Platform.IOS,
+          secrets: {
+            robotAccessToken,
+            environmentSecrets: [],
+          },
+        } as Job,
+        {
+          env: {
+            __API_SERVER_URL: 'https://api.expo.dev',
+            EXPO_TOKEN: robotAccessToken,
+            EAS_BUILD_ID: buildId,
+            EAS_BUILD_RUNNER: 'eas-build',
+          },
+          workingdir: '/workingdir',
+          logger: createMockLogger(),
+          logBuffer: { getLogs: () => [], getPhaseLogs: () => [] },
+          uploadArtifact: jest.fn(),
+        }
+      );
+
+      ctx.graphqlClient.mutation = mockGraphqlMutation as any;
+
+      const fetchMock = jest.mocked(fetch);
+      fetchMock.mockImplementation(async () => ({ ok: true }) as Response);
+
+      // Call prepareProjectSourcesAsync and don't await metadata upload
+      await prepareProjectSourcesAsync(ctx, ctx.buildDirectory);
+
+      // Wait for the fire-and-forget async operation to complete
+      await setTimeout(1000);
+
+      // Verify the upload session was created
+      expect(mockGraphqlMutation).toHaveBeenNthCalledWith(
+        1,
+        expect.anything(),
+        expect.objectContaining({})
+      );
+
+      // Verify metadata was uploaded to storage
+      expect(fetchMock).toHaveBeenCalledWith(
+        'https://storage.example.com/upload',
+        expect.objectContaining({
+          method: 'PUT',
+          headers: { 'x-custom-header': 'value' },
+          body: '{"archiveContent":["project/README.md","project/package.json"]}',
+        })
+      );
+
+      // Verify build metadata was updated
+      expect(mockGraphqlMutation).toHaveBeenNthCalledWith(
+        2,
+        expect.anything(),
+        expect.objectContaining({
+          buildId,
+          projectMetadataFile: {
+            type: 'GCS',
+            bucketKey,
+          },
+        })
+      );
+    });
+
+    it('should not await the metadata upload (fire-and-forget)', async () => {
+      const robotAccessToken = randomUUID();
+      const buildId = randomUUID();
+      await vol.promises.mkdir('/workingdir/build', { recursive: true });
+      await vol.promises.writeFile('/workingdir/build/app.json', '{}');
+
+      let uploadCompleted = false;
+      const mockGraphqlMutation = jest.fn();
+      mockGraphqlMutation
+        .mockReturnValueOnce({
+          toPromise: async () => {
+            // Simulate a slow upload
+            await setTimeout(100);
+            uploadCompleted = true;
+            return {
+              data: {
+                uploadSession: {
+                  createUploadSession: {
+                    url: 'https://storage.example.com/upload',
+                    bucketKey: 'test-key',
+                    headers: {},
+                  },
+                },
+              },
+            };
+          },
+        })
+        .mockReturnValueOnce({
+          toPromise: () =>
+            Promise.resolve({
+              data: {
+                build: {
+                  updateBuildMetadata: {
+                    id: buildId,
+                  },
+                },
+              },
+            }),
+        });
+
+      const ctx = new BuildContext(
+        {
+          triggeredBy: BuildTrigger.EAS_CLI,
+          type: Workflow.MANAGED,
+          mode: BuildMode.BUILD,
+          initiatingUserId: randomUUID(),
+          appId: randomUUID(),
+          projectArchive: {
+            type: ArchiveSourceType.URL,
+            url: 'https://example.com/project.tar.gz',
+          },
+          platform: Platform.IOS,
+          secrets: {
+            robotAccessToken,
+            environmentSecrets: [],
+          },
+        } as Job,
+        {
+          env: {
+            __API_SERVER_URL: 'https://api.expo.dev',
+            EXPO_TOKEN: robotAccessToken,
+            EAS_BUILD_ID: buildId,
+            EAS_BUILD_RUNNER: 'eas-build',
+          },
+          workingdir: '/workingdir',
+          logger: createMockLogger(),
+          logBuffer: { getLogs: () => [], getPhaseLogs: () => [] },
+          uploadArtifact: jest.fn(),
+        }
+      );
+
+      ctx.graphqlClient.mutation = mockGraphqlMutation as any;
+
+      const fetchMock = jest.mocked(fetch);
+      fetchMock.mockResolvedValue({ ok: true } as Response);
+
+      const startTime = Date.now();
+      await prepareProjectSourcesAsync(ctx, ctx.buildDirectory);
+      const endTime = Date.now();
+
+      // prepareProjectSourcesAsync should complete quickly without waiting for upload
+      expect(endTime - startTime).toBeLessThan(50);
+      // Upload should not be completed yet
+      expect(uploadCompleted).toBe(false);
+
+      // Wait for the fire-and-forget operation to complete
+      await setTimeout(150);
+
+      // Now the upload should be completed
+      expect(uploadCompleted).toBe(true);
+    });
+
+    it('should handle upload errors gracefully without failing the build', async () => {
+      const robotAccessToken = randomUUID();
+      const buildId = randomUUID();
+      await vol.promises.mkdir('/workingdir/build', { recursive: true });
+      await vol.promises.writeFile('/workingdir/build/index.js', 'console.log("test");');
+
+      const mockGraphqlMutation = jest.fn();
+      mockGraphqlMutation.mockReturnValue({
+        toPromise: () => Promise.reject(new Error('Upload failed')),
+      });
+
+      const logger = createMockLogger();
+      const ctx = new BuildContext(
+        {
+          triggeredBy: BuildTrigger.GIT_BASED_INTEGRATION,
+          type: Workflow.MANAGED,
+          mode: BuildMode.BUILD,
+          initiatingUserId: randomUUID(),
+          appId: randomUUID(),
+          projectArchive: {
+            type: ArchiveSourceType.URL,
+            url: 'https://example.com/project.tar.gz',
+          },
+          platform: Platform.IOS,
+          secrets: {
+            robotAccessToken,
+            environmentSecrets: [],
+          },
+        } as Job,
+        {
+          env: {
+            __API_SERVER_URL: 'https://api.expo.dev',
+            EXPO_TOKEN: robotAccessToken,
+            EAS_BUILD_ID: buildId,
+            EAS_BUILD_RUNNER: 'eas-build',
+          },
+          workingdir: '/workingdir',
+          logger,
+          logBuffer: { getLogs: () => [], getPhaseLogs: () => [] },
+          uploadArtifact: jest.fn(),
+        }
+      );
+
+      ctx.graphqlClient.mutation = mockGraphqlMutation as any;
+
+      const fetchMock = jest.mocked(fetch);
+      fetchMock.mockResolvedValue({ ok: true } as Response);
+
+      // Should not throw even though upload will fail
+      await expect(prepareProjectSourcesAsync(ctx, ctx.buildDirectory)).resolves.not.toThrow();
+
+      // Wait for the fire-and-forget operation to complete
+      await setTimeout(100);
+
+      // Verify that a warning was logged
+      expect(logger.warn).toHaveBeenCalledWith(
+        expect.stringContaining('Failed to upload project metadata')
+      );
+    });
+  });
+});

packages/build-tools/src/common/eagerBundle.ts

@@ -0,0 +1,38 @@
+import { Metadata, Platform } from '@expo/eas-build-job';
+import { bunyan } from '@expo/logger';
+import semver from 'semver';
+
+import { PackageManager } from '../utils/packageManager';
+import { runExpoCliCommand } from '../utils/project';
+
+export async function eagerBundleAsync({
+  platform,
+  workingDir,
+  logger,
+  env,
+  packageManager,
+}: {
+  platform: Platform;
+  workingDir: string;
+  logger: bunyan;
+  env: Record<string, string | undefined>;
+  packageManager: PackageManager;
+}): Promise<void> {
+  await runExpoCliCommand({
+    args: ['export:embed', '--eager', '--platform', platform, '--dev', 'false'],
+    options: {
+      cwd: workingDir,
+      logger,
+      env,
+    },
+    packageManager,
+  });
+}
+
+export function shouldUseEagerBundle(metadata: Metadata | null | undefined): boolean {
+  return Boolean(
+    !metadata?.developmentClient &&
+    metadata?.sdkVersion &&
+    semver.satisfies(metadata?.sdkVersion, '>=52')
+  );
+}

packages/build-tools/src/common/easBuildInternal.ts

@@ -0,0 +1,159 @@
+import { BuildJob, Env, Metadata, sanitizeBuildJob, sanitizeMetadata } from '@expo/eas-build-job';
+import { PipeMode, bunyan } from '@expo/logger';
+import { BuildStepEnv } from '@expo/steps';
+import spawn from '@expo/turtle-spawn';
+import assert from 'assert';
+import Joi from 'joi';
+import nullthrows from 'nullthrows';
+
+import { BuildContext } from '../context';
+import { resolveEasCommandPrefixAndEnvAsync } from '../utils/easCli';
+
+const EasBuildInternalResultSchema = Joi.object<{ job: object; metadata: object }>({
+  job: Joi.object().unknown(),
+  metadata: Joi.object().unknown(),
+});
+
+export async function runEasBuildInternalAsync<TJob extends BuildJob>({
+  job,
+  logger,
+  env,
+  cwd,
+  projectRootOverride,
+}: {
+  job: TJob;
+  logger: bunyan;
+  env: BuildStepEnv;
+  cwd: string;
+  projectRootOverride?: string;
+}): Promise<{
+  newJob: TJob;
+  newMetadata: Metadata;
+}> {
+  const { cmd, args, extraEnv } = await resolveEasCommandPrefixAndEnvAsync();
+  const { buildProfile, githubTriggerOptions } = job;
+  assert(buildProfile, 'build profile is missing in a build from git-based integration.');
+
+  const autoSubmitArgs = [];
+  if (githubTriggerOptions?.submitProfile) {
+    autoSubmitArgs.push('--auto-submit-with-profile');
+    autoSubmitArgs.push(githubTriggerOptions.submitProfile);
+  } else if (githubTriggerOptions?.autoSubmit) {
+    autoSubmitArgs.push('--auto-submit');
+  }
+
+  try {
+    const result = await spawn(
+      cmd,
+      [
+        ...args,
+        'build:internal',
+        '--platform',
+        job.platform,
+        '--profile',
+        buildProfile,
+        ...autoSubmitArgs,
+      ],
+      {
+        cwd,
+        env: {
+          ...env,
+          EXPO_TOKEN: nullthrows(job.secrets, 'Secrets must be defined for non-custom builds')
+            .robotAccessToken,
+          ...extraEnv,
+          EAS_PROJECT_ROOT: projectRootOverride,
+        },
+        logger,
+        // This prevents printing stdout with job secrets and credentials to logs.
+        mode: PipeMode.STDERR_ONLY_AS_STDOUT,
+      }
+    );
+
+    const stdout = result.stdout.toString();
+    const parsed = JSON.parse(stdout);
+    return validateEasBuildInternalResult({
+      result: parsed,
+      oldJob: job,
+    });
+  } catch (err: any) {
+    throw new Error('Failed to run eas build:internal');
+  }
+}
+
+export async function resolveEnvFromBuildProfileAsync<TJob extends BuildJob>(
+  ctx: BuildContext<TJob>,
+  { cwd }: { cwd: string }
+): Promise<Env> {
+  const { cmd, args, extraEnv } = await resolveEasCommandPrefixAndEnvAsync();
+  const { buildProfile } = ctx.job;
+  assert(buildProfile, 'build profile is missing in a build from git-based integration.');
+  let spawnResult;
+  try {
+    spawnResult = await spawn(
+      cmd,
+      [
+        ...args,
+        'config',
+        '--platform',
+        ctx.job.platform,
+        '--profile',
+        buildProfile,
+        '--non-interactive',
+        '--json',
+        '--eas-json-only',
+      ],
+      {
+        cwd,
+        env: { ...ctx.env, ...extraEnv },
+      }
+    );
+  } catch (err: any) {
+    ctx.logger.error(`Failed to the read build profile ${buildProfile} from eas.json.`);
+    ctx.logger.error(err.stderr?.toString());
+    throw Error(`Failed to read the build profile ${buildProfile} from eas.json.`);
+  }
+  const stdout = spawnResult.stdout.toString();
+  const parsed = JSON.parse(stdout);
+  const env = validateEnvs(parsed.buildProfile);
+  return env;
+}
+
+function validateEasBuildInternalResult<TJob extends BuildJob>({
+  oldJob,
+  result,
+}: {
+  oldJob: TJob;
+  result: any;
+}): { newJob: TJob; newMetadata: Metadata } {
+  const { value, error } = EasBuildInternalResultSchema.validate(result, {
+    stripUnknown: true,
+    convert: true,
+    abortEarly: false,
+  });
+  if (error) {
+    throw error;
+  }
+  const newJob = sanitizeBuildJob({
+    ...value.job,
+    // We want to retain values that we have set on the job.
+    appId: oldJob.appId,
+    initiatingUserId: oldJob.initiatingUserId,
+  }) as TJob;
+  assert(newJob.platform === oldJob.platform, 'eas-cli returned a job for a wrong platform');
+  const newMetadata = sanitizeMetadata(value.metadata);
+  return { newJob, newMetadata };
+}
+
+function validateEnvs(result: any): Env {
+  const { value, error } = Joi.object({
+    env: Joi.object().pattern(Joi.string(), Joi.string()),
+  }).validate(result, {
+    stripUnknown: true,
+    convert: true,
+    abortEarly: false,
+  });
+  if (error) {
+    throw error;
+  }
+  return value?.env;
+}

packages/build-tools/src/common/fastlane.ts

@@ -0,0 +1,7 @@
+export const COMMON_FASTLANE_ENV = {
+  FASTLANE_DISABLE_COLORS: '1',
+  FASTLANE_SKIP_UPDATE_CHECK: '1',
+  SKIP_SLOW_FASTLANE_WARNING: 'true',
+  FASTLANE_HIDE_TIMESTAMP: 'true',
+  LC_ALL: 'en_US.UTF-8',
+};

packages/build-tools/src/common/git.ts

@@ -0,0 +1,98 @@
+import { ArchiveSource, ArchiveSourceType } from '@expo/eas-build-job';
+import { bunyan } from '@expo/logger';
+import spawn from '@expo/turtle-spawn';
+
+export async function shallowCloneRepositoryAsync({
+  logger,
+  archiveSource,
+  destinationDirectory,
+}: {
+  logger: bunyan;
+  archiveSource: ArchiveSource & { type: ArchiveSourceType.GIT };
+  destinationDirectory: string;
+}): Promise<void> {
+  const { repositoryUrl } = archiveSource;
+  try {
+    await spawn('git', ['init'], { cwd: destinationDirectory });
+    await spawn('git', ['remote', 'add', 'origin', repositoryUrl], { cwd: destinationDirectory });
+
+    const { gitRef, gitCommitHash } = archiveSource;
+
+    await spawn('git', ['fetch', 'origin', '--depth', '1', '--no-tags', gitCommitHash], {
+      cwd: destinationDirectory,
+    });
+
+    await spawn('git', ['checkout', gitCommitHash], { cwd: destinationDirectory });
+
+    // If we have a gitRef, we try to add it to the repo.
+    if (gitRef) {
+      const { name, type } = getStrippedBranchOrTagName(gitRef);
+      switch (type) {
+        // If the gitRef is for a tag, we add a lightweight tag to current commit.
+        case 'tag': {
+          await spawn('git', ['tag', name], { cwd: destinationDirectory });
+          break;
+        }
+        // gitRef for a branch may come as:
+        // - qualified ref (e.g. refs/heads/feature/add-icon), detected as "branch" for a push,
+        // - unqualified ref (e.g. feature/add-icon), detected as "other" for a pull request.
+        case 'branch':
+        case 'other': {
+          await spawn('git', ['checkout', '-b', name], { cwd: destinationDirectory });
+          break;
+        }
+      }
+    }
+  } catch (err: any) {
+    const sanitizedUrl = getSanitizedGitUrl(repositoryUrl);
+    if (sanitizedUrl) {
+      logger.error(`Failed to clone git repository: ${sanitizedUrl}.`);
+    } else {
+      logger.error('Failed to clone git repository.');
+    }
+    logger.error(err.stderr);
+    throw err;
+  }
+}
+
+function getSanitizedGitUrl(maybeGitUrl: string): string | null {
+  try {
+    const url = new URL(maybeGitUrl);
+    if (url.password) {
+      url.password = '*******';
+    }
+    return url.toString();
+  } catch {
+    return null;
+  }
+}
+
+function getStrippedBranchOrTagName(ref: string): {
+  name: string;
+  type: 'branch' | 'tag' | 'other';
+} {
+  const branchRegex = /(\/?refs)?\/?heads\/(.+)/;
+  const branchMatch = ref.match(branchRegex);
+
+  if (branchMatch) {
+    return {
+      name: branchMatch[2],
+      type: 'branch',
+    };
+  }
+
+  const tagRegex = /(\/?refs)?\/?tags\/(.+)/;
+  const tagMatch = ref.match(tagRegex);
+
+  if (tagMatch) {
+    return {
+      name: tagMatch[2],
+      type: 'tag',
+    };
+  }
+
+  return {
+    name: ref,
+    type: 'other',
+  };
+}

packages/build-tools/src/common/installDependencies.ts

@@ -0,0 +1,89 @@
+import { Job } from '@expo/eas-build-job';
+import spawn, { SpawnOptions, SpawnPromise, SpawnResult } from '@expo/turtle-spawn';
+import path from 'path';
+
+import { BuildContext } from '../context';
+import { PackageManager, findPackagerRootDir } from '../utils/packageManager';
+import { isUsingModernYarnVersion } from '../utils/project';
+
+export async function installDependenciesAsync({
+  packageManager,
+  env,
+  logger,
+  infoCallbackFn,
+  cwd,
+  useFrozenLockfile,
+}: {
+  packageManager: PackageManager;
+  env: Record<string, string | undefined>;
+  cwd: string;
+  logger: Exclude<SpawnOptions['logger'], undefined>;
+  infoCallbackFn?: SpawnOptions['infoCallbackFn'];
+  useFrozenLockfile: boolean;
+}): Promise<{ spawnPromise: SpawnPromise<SpawnResult> }> {
+  let args: string[];
+  switch (packageManager) {
+    case PackageManager.NPM: {
+      args = useFrozenLockfile ? ['ci'] : ['install'];
+      args.push('--include=dev');
+      break;
+    }
+    case PackageManager.PNPM: {
+      args = ['install', useFrozenLockfile ? '--frozen-lockfile' : '--no-frozen-lockfile'];
+      break;
+    }
+    case PackageManager.YARN: {
+      const isModernYarnVersion = await isUsingModernYarnVersion(cwd);
+      if (isModernYarnVersion) {
+        if (env['EAS_YARN_FOCUS_WORKSPACE']) {
+          args = ['workspaces', 'focus', env['EAS_YARN_FOCUS_WORKSPACE']];
+        } else {
+          args = [
+            'install',
+            '--inline-builds',
+            useFrozenLockfile ? '--immutable' : '--no-immutable',
+          ];
+        }
+      } else {
+        args = [
+          'install',
+          ...(useFrozenLockfile ? ['--frozen-lockfile'] : []),
+          '--production',
+          'false',
+        ];
+      }
+      break;
+    }
+    case PackageManager.BUN:
+      args = ['install', ...(useFrozenLockfile ? ['--frozen-lockfile'] : [])];
+      break;
+    default:
+      throw new Error(`Unsupported package manager: ${packageManager}`);
+  }
+  if (env['EAS_VERBOSE'] === '1') {
+    args = [...args, '--verbose'];
+  }
+  logger.info(`Running "${packageManager} ${args.join(' ')}" in ${cwd} directory`);
+  return {
+    spawnPromise: spawn(packageManager, args, {
+      cwd,
+      logger,
+      infoCallbackFn,
+      env,
+    }),
+  };
+}
+
+export function resolvePackagerDir(ctx: BuildContext<Job>): string {
+  const packagerRunDir = findPackagerRootDir(ctx.getReactNativeProjectDirectory());
+  if (packagerRunDir !== ctx.getReactNativeProjectDirectory()) {
+    const relativeReactNativeProjectDirectory = path.relative(
+      ctx.buildDirectory,
+      ctx.getReactNativeProjectDirectory()
+    );
+    ctx.logger.info(
+      `We detected that '${relativeReactNativeProjectDirectory}' is a ${ctx.packageManager} workspace`
+    );
+  }
+  return packagerRunDir;
+}

packages/build-tools/src/common/prebuild.ts

@@ -0,0 +1,66 @@
+import { BuildJob } from '@expo/eas-build-job';
+import { bunyan } from '@expo/logger';
+import { SpawnOptions } from '@expo/turtle-spawn';
+
+import { installDependenciesAsync, resolvePackagerDir } from './installDependencies';
+import { BuildContext } from '../context';
+import { runExpoCliCommand } from '../utils/project';
+
+export interface PrebuildOptions {
+  extraEnvs?: Record<string, string>;
+}
+
+export async function prebuildAsync<TJob extends BuildJob>(
+  ctx: BuildContext<TJob>,
+  { logger, workingDir, options }: { logger: bunyan; workingDir: string; options?: PrebuildOptions }
+): Promise<void> {
+  const spawnOptions: SpawnOptions = {
+    cwd: workingDir,
+    logger,
+    env: {
+      EXPO_IMAGE_UTILS_NO_SHARP: '1',
+      ...options?.extraEnvs,
+      ...ctx.env,
+    },
+  };
+
+  const prebuildCommandArgs = getPrebuildCommandArgs(ctx);
+  await runExpoCliCommand({
+    args: prebuildCommandArgs,
+    options: spawnOptions,
+    packageManager: ctx.packageManager,
+  });
+  const installDependenciesSpawnPromise = (
+    await installDependenciesAsync({
+      packageManager: ctx.packageManager,
+      env: ctx.env,
+      logger,
+      cwd: resolvePackagerDir(ctx),
+      // prebuild sometimes modifies package.json, so we don't want to use frozen lockfile
+      useFrozenLockfile: false,
+    })
+  ).spawnPromise;
+  await installDependenciesSpawnPromise;
+}
+
+function getPrebuildCommandArgs<TJob extends BuildJob>(ctx: BuildContext<TJob>): string[] {
+  let prebuildCommand =
+    ctx.job.experimental?.prebuildCommand ?? `prebuild --no-install --platform ${ctx.job.platform}`;
+  if (!prebuildCommand.match(/(?:--platform| -p)/)) {
+    prebuildCommand = `${prebuildCommand} --platform ${ctx.job.platform}`;
+  }
+  const npxCommandPrefix = 'npx ';
+  const expoCommandPrefix = 'expo ';
+  const expoCliCommandPrefix = 'expo-cli ';
+  if (prebuildCommand.startsWith(npxCommandPrefix)) {
+    prebuildCommand = prebuildCommand.substring(npxCommandPrefix.length).trim();
+  }
+  if (prebuildCommand.startsWith(expoCommandPrefix)) {
+    prebuildCommand = prebuildCommand.substring(expoCommandPrefix.length).trim();
+  }
+  if (prebuildCommand.startsWith(expoCliCommandPrefix)) {
+    prebuildCommand = prebuildCommand.substring(expoCliCommandPrefix.length).trim();
+  }
+
+  return prebuildCommand.split(' ');
+}

packages/build-tools/src/common/projectSources.ts

@@ -0,0 +1,296 @@
+import downloadFile from '@expo/downloader';
+import { ArchiveSource, ArchiveSourceSchemaZ, ArchiveSourceType, Job } from '@expo/eas-build-job';
+import { bunyan } from '@expo/logger';
+import { asyncResult } from '@expo/results';
+import spawn from '@expo/turtle-spawn';
+import fs from 'fs/promises';
+import { graphql } from 'gql.tada';
+import fetch from 'node-fetch';
+import nullthrows from 'nullthrows';
+import path from 'path';
+import { z } from 'zod';
+
+import { shallowCloneRepositoryAsync } from './git';
+import { BuildContext } from '../context';
+import { turtleFetch } from '../utils/turtleFetch';
+
+export async function prepareProjectSourcesAsync<TJob extends Job>(
+  ctx: BuildContext<TJob>,
+  destinationDirectory: string
+): // Return type required to make switch exhaustive.
+Promise<{ handled: boolean }> {
+  let projectArchive: ArchiveSource = ctx.job.projectArchive;
+  if (ctx.isLocal) {
+    console.warn('Local build, skipping project archive refresh');
+  } else {
+    const projectArchiveResult = await asyncResult(fetchProjectArchiveSourceAsync(ctx));
+
+    if (!projectArchiveResult.ok) {
+      ctx.logger.error(
+        { err: projectArchiveResult.reason },
+        'Failed to refresh project archive, falling back to the original one'
+      );
+    }
+
+    projectArchive = projectArchiveResult.value ?? ctx.job.projectArchive;
+  }
+
+  switch (projectArchive.type) {
+    case ArchiveSourceType.R2:
+    case ArchiveSourceType.GCS: {
+      throw new Error('Remote project sources should be resolved earlier to URL');
+    }
+
+    case ArchiveSourceType.PATH: {
+      await prepareProjectSourcesLocallyAsync(ctx, projectArchive.path, destinationDirectory); // used in eas build --local
+      return { handled: true };
+    }
+
+    case ArchiveSourceType.NONE: {
+      // May be used in no-sources jobs like submission jobs.
+      return { handled: true };
+    }
+
+    case ArchiveSourceType.URL: {
+      await downloadAndUnpackProjectFromTarGzAsync(ctx, projectArchive.url, destinationDirectory);
+
+      uploadProjectMetadataAsFireAndForget(ctx, { projectDirectory: destinationDirectory });
+
+      return { handled: true };
+    }
+
+    case ArchiveSourceType.GIT: {
+      await shallowCloneRepositoryAsync({
+        logger: ctx.logger,
+        archiveSource: projectArchive,
+        destinationDirectory,
+      });
+
+      uploadProjectMetadataAsFireAndForget(ctx, { projectDirectory: destinationDirectory });
+
+      return { handled: true };
+    }
+  }
+}
+
+export async function downloadAndUnpackProjectFromTarGzAsync<TJob extends Job>(
+  ctx: BuildContext<TJob>,
+  projectArchiveUrl: string,
+  destinationDirectory: string
+): Promise<void> {
+  const projectTarball = path.join(ctx.workingdir, 'project.tar.gz');
+  try {
+    await downloadFile(projectArchiveUrl, projectTarball, { retry: 3 });
+  } catch (err: any) {
+    ctx.reportError?.('Failed to download project archive', err, {
+      extras: { buildId: ctx.env.EAS_BUILD_ID },
+    });
+    throw err;
+  }
+
+  await unpackTarGzAsync({
+    destination: destinationDirectory,
+    source: projectTarball,
+    logger: ctx.logger,
+  });
+}
+
+async function prepareProjectSourcesLocallyAsync<TJob extends Job>(
+  ctx: BuildContext<TJob>,
+  projectArchivePath: string,
+  destinationDirectory: string
+): Promise<void> {
+  const projectTarball = path.join(ctx.workingdir, 'project.tar.gz');
+  await fs.copyFile(projectArchivePath, projectTarball);
+
+  await unpackTarGzAsync({
+    destination: destinationDirectory,
+    source: projectTarball,
+    logger: ctx.logger,
+  });
+}
+
+async function unpackTarGzAsync({
+  logger,
+  source,
+  destination,
+}: {
+  logger: bunyan;
+  source: string;
+  destination: string;
+}): Promise<void> {
+  await spawn('tar', ['-C', destination, '--strip-components', '1', '-zxf', source], {
+    logger,
+  });
+}
+
+function uploadProjectMetadataAsFireAndForget(
+  ctx: BuildContext<Job>,
+  { projectDirectory }: { projectDirectory: string }
+): void {
+  void (async () => {
+    const uploadResult = await asyncResult(uploadProjectMetadataAsync(ctx, { projectDirectory }));
+    if (!uploadResult.ok) {
+      ctx.logger.warn(`Failed to upload project metadata: ${uploadResult.reason}`);
+    }
+  })();
+}
+
+async function uploadProjectMetadataAsync(
+  ctx: BuildContext<Job>,
+  { projectDirectory }: { projectDirectory: string }
+): Promise<void> {
+  if (!ctx.job.platform) {
+    // Not a build job, skip.
+    return;
+  } else if (
+    ctx.job.projectArchive.type === ArchiveSourceType.GCS &&
+    ctx.job.projectArchive.metadataLocation
+  ) {
+    // Build already has project metadata, skip.
+    return;
+  }
+
+  const files: string[] = [];
+
+  const directoriesToScan: { dir: string; relativePath: string }[] = [
+    { dir: projectDirectory, relativePath: '' },
+  ];
+
+  while (directoriesToScan.length > 0) {
+    const { dir, relativePath } = directoriesToScan.shift()!;
+
+    if (relativePath === '.git') {
+      // Do not include whole `.git` directory in the archive, just that it exists.
+      files.push('.git/...');
+      continue;
+    }
+
+    const entries = await fs.readdir(dir, { withFileTypes: true });
+
+    for (const entry of entries) {
+      const fullPath = path.join(dir, entry.name);
+      const relativeFilePath = path.join(relativePath, entry.name);
+
+      if (entry.isDirectory()) {
+        directoriesToScan.push({ dir: fullPath, relativePath: relativeFilePath });
+      } else {
+        files.push(relativeFilePath);
+      }
+    }
+  }
+  const sortedFiles = files
+    .map(
+      // Prepend entries with "project/"
+      f => path.join('project', f)
+    )
+    .sort(); // Sort for consistent ordering
+
+  const result = await ctx.graphqlClient
+    .mutation(
+      graphql(`
+        mutation {
+          uploadSession {
+            createUploadSession(type: EAS_BUILD_GCS_PROJECT_METADATA)
+          }
+        }
+      `),
+      {}
+    )
+    .toPromise();
+
+  if (result.error) {
+    throw result.error;
+  }
+
+  const uploadSession = result.data!.uploadSession.createUploadSession as {
+    url: string;
+    bucketKey: string;
+    headers: Record<string, string>;
+  };
+
+  await fetch(uploadSession.url, {
+    method: 'PUT',
+    body: JSON.stringify({ archiveContent: sortedFiles }),
+    headers: uploadSession.headers,
+  });
+
+  const updateMetadataResult = await ctx.graphqlClient
+    .mutation(
+      graphql(`
+        mutation UpdateTurtleBuildMetadataMutation(
+          $buildId: ID!
+          $projectMetadataFile: ProjectMetadataFileInput!
+        ) {
+          build {
+            updateBuildMetadata(
+              buildId: $buildId
+              metadata: { projectMetadataFile: $projectMetadataFile }
+            ) {
+              id
+            }
+          }
+        }
+      `),
+      {
+        buildId: ctx.env.EAS_BUILD_ID,
+        projectMetadataFile: {
+          type: 'GCS',
+          bucketKey: uploadSession.bucketKey,
+        },
+      }
+    )
+    .toPromise();
+
+  if (updateMetadataResult.error) {
+    throw updateMetadataResult.error;
+  }
+}
+
+async function fetchProjectArchiveSourceAsync(ctx: BuildContext<Job>): Promise<ArchiveSource> {
+  const taskId = nullthrows(ctx.env.EAS_BUILD_ID, 'EAS_BUILD_ID is not set');
+  const expoApiServerURL = nullthrows(ctx.env.__API_SERVER_URL, '__API_SERVER_URL is not set');
+  const robotAccessToken = nullthrows(
+    ctx.job.secrets?.robotAccessToken,
+    'robot access token is not set'
+  );
+
+  const response = await turtleFetch(
+    new URL(
+      ctx.job.platform
+        ? `/v2/turtle-builds/${taskId}/download-project-archive`
+        : `/v2/turtle-job-runs/${taskId}/download-project-archive`,
+      expoApiServerURL
+    ).toString(),
+    'POST',
+    {
+      headers: {
+        Authorization: `Bearer ${robotAccessToken}`,
+      },
+      timeout: 20000,
+      retries: 3,
+      logger: ctx.logger,
+    }
+  );
+
+  if (!response.ok) {
+    const textResult = await asyncResult(response.text());
+    throw new Error(`Unexpected response from server (${response.status}): ${textResult.value}`);
+  }
+
+  const jsonResult = await asyncResult(response.json());
+  if (!jsonResult.ok) {
+    throw new Error(
+      `Expected JSON response from server (${response.status}): ${jsonResult.reason}`
+    );
+  }
+
+  const dataResult = z.object({ data: ArchiveSourceSchemaZ }).safeParse(jsonResult.value);
+  if (!dataResult.success) {
+    throw new Error(
+      `Unexpected data from server (${response.status}): ${z.prettifyError(dataResult.error)}`
+    );
+  }
+
+  return dataResult.data.data;
+}

packages/build-tools/src/common/setup.ts

@@ -0,0 +1,296 @@
+import { ExpoConfig } from '@expo/config';
+import {
+  BuildJob,
+  BuildPhase,
+  BuildTrigger,
+  Ios,
+  Job,
+  Platform,
+  UserError,
+} from '@expo/eas-build-job';
+import spawn, { SpawnResult } from '@expo/turtle-spawn';
+import fs from 'fs-extra';
+import nullthrows from 'nullthrows';
+import path from 'path';
+
+import { resolveEnvFromBuildProfileAsync, runEasBuildInternalAsync } from './easBuildInternal';
+import { installDependenciesAsync, resolvePackagerDir } from './installDependencies';
+import { prepareProjectSourcesAsync } from './projectSources';
+import { BuildContext } from '../context';
+import { deleteXcodeEnvLocalIfExistsAsync } from '../ios/xcodeEnv';
+import { Hook, runHookIfPresent } from '../utils/hooks';
+import { setUpNpmrcAsync } from '../utils/npmrc';
+import {
+  getPackageVersionFromPackageJson,
+  isAtLeastNpm7Async,
+  shouldUseFrozenLockfile,
+} from '../utils/packageManager';
+import { getParentAndDescendantProcessPidsAsync } from '../utils/processes';
+import { readAndLogPackageJson, readEasJsonContents } from '../utils/project';
+import { retryAsync } from '../utils/retry';
+
+const MAX_EXPO_DOCTOR_TIMEOUT_MS = 30 * 1000;
+const INSTALL_DEPENDENCIES_WARN_TIMEOUT_MS = 15 * 60 * 1000;
+const INSTALL_DEPENDENCIES_KILL_TIMEOUT_MS = 30 * 60 * 1000;
+
+class DoctorTimeoutError extends Error {}
+class InstallDependenciesTimeoutError extends Error {}
+
+export async function setupAsync<TJob extends BuildJob>(ctx: BuildContext<TJob>): Promise<void> {
+  await ctx.runBuildPhase(BuildPhase.PREPARE_PROJECT, async () => {
+    await retryAsync(
+      async () => {
+        await fs.rm(ctx.buildDirectory, { recursive: true, force: true });
+        await fs.mkdir(ctx.buildDirectory, { recursive: true });
+
+        await prepareProjectSourcesAsync(ctx, ctx.buildDirectory);
+      },
+      {
+        retryOptions: {
+          retries: 3,
+          retryIntervalMs: 1_000,
+        },
+      }
+    );
+
+    await setUpNpmrcAsync(ctx, ctx.logger);
+    if (ctx.job.platform === Platform.IOS && ctx.env.EAS_BUILD_RUNNER === 'eas-build') {
+      await deleteXcodeEnvLocalIfExistsAsync(ctx as BuildContext<Ios.Job>);
+    }
+    if (ctx.job.triggeredBy === BuildTrigger.GIT_BASED_INTEGRATION) {
+      // We need to setup envs from eas.json before
+      // eas-build-pre-install hook is called.
+      const env = await resolveEnvFromBuildProfileAsync(ctx, {
+        cwd: ctx.getReactNativeProjectDirectory(),
+      });
+      ctx.updateEnv(env);
+    }
+  });
+
+  await ctx.runBuildPhase(BuildPhase.PRE_INSTALL_HOOK, async () => {
+    await runHookIfPresent(ctx, Hook.PRE_INSTALL);
+  });
+
+  await ctx.runBuildPhase(BuildPhase.READ_EAS_JSON, async () => {
+    try {
+      const easJsonContents = readEasJsonContents(ctx.getReactNativeProjectDirectory());
+      ctx.logger.info('Using eas.json:');
+      ctx.logger.info(easJsonContents);
+    } catch (err) {
+      ctx.logger.error({ err }, `Failed to read eas.json.`);
+    }
+  });
+
+  const packageJson = await ctx.runBuildPhase(BuildPhase.READ_PACKAGE_JSON, async () => {
+    return readAndLogPackageJson(ctx.logger, ctx.getReactNativeProjectDirectory());
+  });
+
+  await ctx.runBuildPhase(BuildPhase.INSTALL_DEPENDENCIES, async () => {
+    const expoVersion =
+      ctx.metadata?.sdkVersion ??
+      getPackageVersionFromPackageJson({
+        packageJson,
+        packageName: 'expo',
+      });
+
+    const reactNativeVersion =
+      ctx.metadata?.reactNativeVersion ??
+      getPackageVersionFromPackageJson({
+        packageJson,
+        packageName: 'react-native',
+      });
+
+    await runInstallDependenciesAsync(ctx, {
+      useFrozenLockfile: shouldUseFrozenLockfile({
+        env: ctx.env,
+        sdkVersion: expoVersion,
+        reactNativeVersion,
+      }),
+    });
+  });
+
+  await ctx.runBuildPhase(BuildPhase.READ_APP_CONFIG, async () => {
+    const appConfig = await ctx.appConfig;
+    ctx.logger.info('Using app configuration:');
+    ctx.logger.info(JSON.stringify(appConfig, null, 2));
+    await validateAppConfigAsync(ctx, appConfig);
+  });
+
+  if (ctx.job.triggeredBy === BuildTrigger.GIT_BASED_INTEGRATION) {
+    await ctx.runBuildPhase(BuildPhase.EAS_BUILD_INTERNAL, async () => {
+      const appConfig = await ctx.appConfig;
+      if (!appConfig.ios?.bundleIdentifier && ctx.job.platform === Platform.IOS) {
+        throw new Error(
+          'The "ios.bundleIdentifier" is required to be set in app config for builds triggered by GitHub integration. Learn more: https://docs.expo.dev/versions/latest/config/app/#bundleidentifier.'
+        );
+      }
+      if (!appConfig.android?.package && ctx.job.platform === Platform.ANDROID) {
+        throw new Error(
+          'The "android.package" is required to be set in app config for builds triggered by GitHub integration. Learn more: https://docs.expo.dev/versions/latest/config/app/#package.'
+        );
+      }
+      const { newJob, newMetadata } = await runEasBuildInternalAsync({
+        job: ctx.job,
+        env: ctx.env,
+        logger: ctx.logger,
+        cwd: ctx.getReactNativeProjectDirectory(),
+        projectRootOverride: ctx.env.EAS_NO_VCS ? ctx.buildDirectory : undefined,
+      });
+      ctx.updateJobInformation(newJob, newMetadata);
+    });
+  }
+
+  const hasExpoPackage = !!packageJson.dependencies?.expo;
+  if (!ctx.env.EAS_BUILD_DISABLE_EXPO_DOCTOR_STEP && hasExpoPackage) {
+    await ctx.runBuildPhase(BuildPhase.RUN_EXPO_DOCTOR, async () => {
+      try {
+        await runExpoDoctor(ctx);
+      } catch (err) {
+        if (err instanceof DoctorTimeoutError) {
+          ctx.logger.error(err.message);
+        } else {
+          ctx.logger.error({ err }, 'Command "expo doctor" failed.');
+        }
+        ctx.markBuildPhaseHasWarnings();
+      }
+    });
+  }
+}
+
+async function runExpoDoctor<TJob extends Job>(ctx: BuildContext<TJob>): Promise<SpawnResult> {
+  ctx.logger.info('Running "expo doctor"');
+  let timeout: NodeJS.Timeout | undefined;
+  let timedOut = false;
+  const isAtLeastNpm7 = await isAtLeastNpm7Async();
+  try {
+    const argsPrefix = isAtLeastNpm7 ? ['-y'] : [];
+    const promise = spawn('npx', [...argsPrefix, 'expo-doctor'], {
+      cwd: ctx.getReactNativeProjectDirectory(),
+      logger: ctx.logger,
+      env: ctx.env,
+    });
+    timeout = setTimeout(async () => {
+      timedOut = true;
+      const ppid = nullthrows(promise.child.pid);
+      const pids = await getParentAndDescendantProcessPidsAsync(ppid);
+      pids.forEach(pid => {
+        process.kill(pid);
+      });
+      ctx.reportError?.(`"expo doctor" timed out`, undefined, {
+        extras: { buildId: ctx.env.EAS_BUILD_ID },
+      });
+    }, MAX_EXPO_DOCTOR_TIMEOUT_MS);
+    return await promise;
+  } catch (err: any) {
+    if (timedOut) {
+      throw new DoctorTimeoutError('"expo doctor" timed out, skipping...');
+    }
+    throw err;
+  } finally {
+    if (timeout) {
+      clearTimeout(timeout);
+    }
+  }
+}
+
+async function runInstallDependenciesAsync<TJob extends Job>(
+  ctx: BuildContext<TJob>,
+  {
+    useFrozenLockfile,
+  }: {
+    useFrozenLockfile: boolean;
+  }
+): Promise<void> {
+  let warnTimeout: NodeJS.Timeout | undefined;
+  let killTimeout: NodeJS.Timeout | undefined;
+  let killTimedOut: boolean = false;
+  try {
+    const installDependenciesSpawnPromise = (
+      await installDependenciesAsync({
+        packageManager: ctx.packageManager,
+        env: ctx.env,
+        logger: ctx.logger,
+        infoCallbackFn: () => {
+          if (warnTimeout) {
+            warnTimeout.refresh();
+          }
+          if (killTimeout) {
+            killTimeout.refresh();
+          }
+        },
+        cwd: resolvePackagerDir(ctx),
+        useFrozenLockfile,
+      })
+    ).spawnPromise;
+
+    warnTimeout = setTimeout(() => {
+      ctx.logger.warn(
+        '"Install dependencies" phase takes longer then expected and it did not produce any logs in the past 15 minutes. Consider evaluating your package.json file for possible issues with dependencies'
+      );
+    }, INSTALL_DEPENDENCIES_WARN_TIMEOUT_MS);
+
+    killTimeout = setTimeout(async () => {
+      killTimedOut = true;
+      ctx.logger.error(
+        '"Install dependencies" phase takes a very long time and it did not produce any logs in the past 30 minutes. Most likely an unexpected error happened with your dependencies which caused the process to hang and it will be terminated'
+      );
+      const ppid = nullthrows(installDependenciesSpawnPromise.child.pid);
+      const pids = await getParentAndDescendantProcessPidsAsync(ppid);
+      pids.forEach(pid => {
+        process.kill(pid);
+      });
+      ctx.reportError?.('"Install dependencies" phase takes a very long time', undefined, {
+        extras: { buildId: ctx.env.EAS_BUILD_ID },
+      });
+    }, INSTALL_DEPENDENCIES_KILL_TIMEOUT_MS);
+
+    await installDependenciesSpawnPromise;
+  } catch (err: any) {
+    if (killTimedOut) {
+      throw new InstallDependenciesTimeoutError(
+        '"Install dependencies" phase was inactive for over 30 minutes. Please evaluate your package.json file'
+      );
+    }
+    throw err;
+  } finally {
+    if (warnTimeout) {
+      clearTimeout(warnTimeout);
+    }
+    if (killTimeout) {
+      clearTimeout(killTimeout);
+    }
+  }
+}
+
+async function validateAppConfigAsync(
+  ctx: BuildContext<Job>,
+  appConfig: ExpoConfig
+): Promise<void> {
+  if (
+    appConfig?.extra?.eas?.projectId &&
+    ctx.env.EAS_BUILD_PROJECT_ID &&
+    appConfig.extra.eas.projectId !== ctx.env.EAS_BUILD_PROJECT_ID
+  ) {
+    const isUsingDynamicConfig =
+      (await fs.pathExists(path.join(ctx.getReactNativeProjectDirectory(), 'app.config.ts'))) ||
+      (await fs.pathExists(path.join(ctx.getReactNativeProjectDirectory(), 'app.config.js')));
+    const isGitHubBuild = ctx.job.triggeredBy === BuildTrigger.GIT_BASED_INTEGRATION;
+    let extraMessage = '';
+    if (isGitHubBuild && isUsingDynamicConfig) {
+      extraMessage =
+        'Make sure you connected your GitHub repository to the correct Expo project and if you are using environment variables to switch between projects in app.config.js/app.config.ts remember to set those variables in eas.json too. ';
+    } else if (isGitHubBuild) {
+      extraMessage = 'Make sure you connected your GitHub repository to the correct Expo project. ';
+    } else if (isUsingDynamicConfig) {
+      extraMessage =
+        'If you are using environment variables to switch between projects in app.config.js/app.config.ts, make sure those variables are also set inside EAS Build. You can do that using "env" field in eas.json or EAS environment variables. ';
+    }
+    throw new UserError(
+      'EAS_BUILD_PROJECT_ID_MISMATCH',
+      `The value of the "extra.eas.projectId" field (${appConfig.extra.eas.projectId}) in the app config does not match the current project id (${ctx.env.EAS_BUILD_PROJECT_ID}). ${extraMessage}Learn more: https://expo.fyi/eas-config-mismatch.`
+    );
+  } else if (ctx.env.EAS_BUILD_PROJECT_ID && !appConfig?.extra?.eas?.projectId) {
+    ctx.logger.error(`The "extra.eas.projectId" field is missing from your app config.`);
+    ctx.markBuildPhaseHasWarnings();
+  }
+}

packages/build-tools/src/context.ts

@@ -0,0 +1,423 @@
+import { ExpoConfig } from '@expo/config';
+import {
+  BuildPhase,
+  BuildPhaseResult,
+  BuildPhaseStats,
+  Env,
+  EnvironmentSecretType,
+  GenericArtifactType,
+  Job,
+  LogMarker,
+  ManagedArtifactType,
+  Metadata,
+  errors,
+  isGenericArtifact,
+} from '@expo/eas-build-job';
+import { BuildTrigger } from '@expo/eas-build-job/dist/common';
+import { bunyan } from '@expo/logger';
+import { Client, fetchExchange } from '@urql/core';
+import fs from 'fs-extra';
+import path from 'path';
+
+import { resolveBuildPhaseErrorAsync } from './buildErrors/detectError';
+import { Datadog } from './datadog';
+import { readAppConfig } from './utils/appConfig';
+import { createTemporaryEnvironmentSecretFile } from './utils/environmentSecrets';
+import { PackageManager, resolvePackageManager } from './utils/packageManager';
+
+export type Artifacts = Partial<Record<ManagedArtifactType, string>>;
+
+export interface CacheManager {
+  saveCache(ctx: BuildContext<Job>): Promise<void>;
+  restoreCache(ctx: BuildContext<Job>): Promise<void>;
+}
+
+export interface LogBuffer {
+  getLogs(): string[];
+  getPhaseLogs(buildPhase: string): string[];
+}
+
+export type ArtifactToUpload =
+  | {
+      type: ManagedArtifactType;
+      paths: string[];
+    }
+  | {
+      type: GenericArtifactType;
+      name: string;
+      paths: string[];
+    };
+
+export interface BuildContextOptions {
+  workingdir: string;
+  logger: bunyan;
+  logBuffer: LogBuffer;
+  env: Env;
+  cacheManager?: CacheManager;
+  uploadArtifact: (spec: { artifact: ArtifactToUpload; logger: bunyan }) => Promise<
+    /** Workflow Artifact ID */
+    | { artifactId: string | null; filename?: never }
+    /** This remains from the time we relied on Launcher to rename the GCS object. */
+    | { artifactId?: never; filename: string | null }
+  >;
+  reportError?: (
+    msg: string,
+    err?: Error,
+    options?: { tags?: Record<string, string>; extras?: Record<string, string> }
+  ) => void;
+  reportBuildPhaseStats?: (stats: BuildPhaseStats) => void;
+  skipNativeBuild?: boolean;
+  metadata?: Metadata;
+  expoApiV2BaseUrl?: string;
+}
+
+export class SkipNativeBuildError extends Error {}
+
+export class BuildContext<TJob extends Job = Job> {
+  public readonly workingdir: string;
+  public logger: bunyan;
+  public readonly logBuffer: LogBuffer;
+  public readonly cacheManager?: CacheManager;
+  public readonly reportError?: (
+    msg: string,
+    err?: Error,
+    options?: { tags?: Record<string, string>; extras?: Record<string, string> }
+  ) => void;
+  public readonly skipNativeBuild?: boolean;
+  public readonly expoApiV2BaseUrl?: string;
+  public artifacts: Artifacts = {};
+
+  private readonly _isLocal: boolean;
+
+  private _env: Env;
+  private _job: TJob;
+  private _metadata?: Metadata;
+  private readonly defaultLogger: bunyan;
+  private readonly _uploadArtifact: BuildContextOptions['uploadArtifact'];
+  private buildPhase?: BuildPhase;
+  private buildPhaseSkipped = false;
+  private buildPhaseHasWarnings = false;
+  private _appConfig?: Promise<ExpoConfig>;
+  private readonly reportBuildPhaseStats?: (stats: BuildPhaseStats) => void;
+  public readonly graphqlClient: Client;
+
+  constructor(job: TJob, options: BuildContextOptions) {
+    this.workingdir = options.workingdir;
+    this.defaultLogger = options.logger;
+    this.logger = this.defaultLogger;
+    this.logBuffer = options.logBuffer;
+    this.cacheManager = options.cacheManager;
+    this._uploadArtifact = options.uploadArtifact;
+    this.reportError = options.reportError;
+
+    this._job = job;
+    this._metadata = options.metadata;
+    this.skipNativeBuild = options.skipNativeBuild;
+    this.expoApiV2BaseUrl = options.expoApiV2BaseUrl;
+    this.reportBuildPhaseStats = options.reportBuildPhaseStats;
+
+    const environmentSecrets = this.getEnvironmentSecrets(job);
+    this._env = {
+      ...options.env,
+      ...job?.builderEnvironment?.env,
+      ...environmentSecrets,
+      __EAS_BUILD_ENVS_DIR: this.buildEnvsDirectory,
+    };
+
+    this._env.PATH = this._env.PATH
+      ? [this.buildExecutablesDirectory, this._env.PATH].join(':')
+      : this.buildExecutablesDirectory;
+
+    this._isLocal = this._env.EAS_BUILD_RUNNER !== 'eas-build';
+
+    this.graphqlClient = new Client({
+      url: new URL('graphql', this.env.__API_SERVER_URL).toString(),
+      exchanges: [fetchExchange],
+      preferGetMethod: false,
+      fetchOptions: {
+        headers: {
+          Authorization: `Bearer ${job.secrets?.robotAccessToken}`,
+        },
+      },
+    });
+  }
+
+  public get job(): TJob {
+    return this._job;
+  }
+  public get metadata(): Metadata | undefined {
+    return this._metadata;
+  }
+  public get env(): Env {
+    return this._env;
+  }
+  public get buildDirectory(): string {
+    return path.join(this.workingdir, 'build');
+  }
+  public get buildLogsDirectory(): string {
+    return path.join(this.workingdir, 'logs');
+  }
+  public get isLocal(): boolean {
+    return this._isLocal;
+  }
+  /**
+   * Directory used to store executables used during regular (non-custom) builds.
+   */
+  public get buildExecutablesDirectory(): string {
+    return path.join(this.workingdir, 'bin');
+  }
+  /**
+   * Directory used to store env variables registered in the current build step.
+   * All values stored here will be available in the next build phase as env variables.
+   */
+  public get buildEnvsDirectory(): string {
+    return path.join(this.workingdir, 'env');
+  }
+  public get packageManager(): PackageManager {
+    return resolvePackageManager(this.getReactNativeProjectDirectory(), {
+      env: this.env,
+    });
+  }
+  public get appConfig(): Promise<ExpoConfig> {
+    if (!this._appConfig) {
+      this._appConfig = readAppConfig({
+        projectDir: this.getReactNativeProjectDirectory(),
+        env: this.env,
+        logger: this.logger,
+        sdkVersion: this.metadata?.sdkVersion,
+      }).then(config => config.exp);
+    }
+    return this._appConfig;
+  }
+
+  public async runBuildPhase<T>(
+    buildPhase: BuildPhase,
+    phase: () => Promise<T>,
+    {
+      doNotMarkStart = false,
+      doNotMarkEnd = false,
+    }: {
+      doNotMarkStart?: boolean;
+      doNotMarkEnd?: boolean;
+    } = {}
+  ): Promise<T> {
+    let startTimestamp = Date.now();
+    try {
+      this.setBuildPhase(buildPhase, { doNotMarkStart });
+      startTimestamp = Date.now();
+      const result = await phase();
+      const durationMs = Date.now() - startTimestamp;
+      const buildPhaseResult: BuildPhaseResult = this.buildPhaseSkipped
+        ? BuildPhaseResult.SKIPPED
+        : this.buildPhaseHasWarnings
+          ? BuildPhaseResult.WARNING
+          : BuildPhaseResult.SUCCESS;
+      await this.endCurrentBuildPhaseAsync({ result: buildPhaseResult, doNotMarkEnd, durationMs });
+      return result;
+    } catch (err: any) {
+      const durationMs = Date.now() - startTimestamp;
+      const resolvedError = await this.handleBuildPhaseErrorAsync(err, buildPhase);
+      await this.endCurrentBuildPhaseAsync({ result: BuildPhaseResult.FAIL, durationMs });
+      throw resolvedError;
+    }
+  }
+
+  public markBuildPhaseSkipped(): void {
+    this.buildPhaseSkipped = true;
+  }
+
+  public markBuildPhaseHasWarnings(): void {
+    this.buildPhaseHasWarnings = true;
+  }
+
+  public async uploadArtifact({
+    artifact,
+    logger,
+  }: {
+    artifact: ArtifactToUpload;
+    logger: bunyan;
+  }): Promise<{ artifactId: string | null }> {
+    const result = await this._uploadArtifact({ artifact, logger });
+    if (result.filename && !isGenericArtifact(artifact)) {
+      this.artifacts[artifact.type] = result.filename;
+    }
+    return { artifactId: result.artifactId ?? null };
+  }
+
+  public updateEnv(env: Env): void {
+    if (this._job.triggeredBy !== BuildTrigger.GIT_BASED_INTEGRATION) {
+      throw new Error(
+        'Updating environment variables is only allowed when build was triggered by a git-based integration.'
+      );
+    }
+    this._env = {
+      ...env,
+      ...this._env,
+      __EAS_BUILD_ENVS_DIR: this.buildEnvsDirectory,
+    };
+    this._env.PATH = this._env.PATH
+      ? [this.buildExecutablesDirectory, this._env.PATH].join(':')
+      : this.buildExecutablesDirectory;
+  }
+
+  public updateJobInformation(job: TJob, metadata: Metadata): void {
+    if (this._job.triggeredBy !== BuildTrigger.GIT_BASED_INTEGRATION) {
+      throw new Error(
+        'Updating job information is only allowed when build was triggered by a git-based integration.'
+      );
+    }
+    this._job = {
+      ...this._job,
+      ...job,
+      workflowInterpolationContext:
+        job.workflowInterpolationContext ?? this.job.workflowInterpolationContext,
+      triggeredBy: this._job.triggeredBy,
+      secrets: {
+        ...this.job.secrets,
+        ...job.secrets,
+        robotAccessToken: job.secrets?.robotAccessToken ?? this.job.secrets?.robotAccessToken,
+        environmentSecrets: [
+          // Latter secrets override former ones.
+          ...(this.job.secrets?.environmentSecrets ?? []),
+          ...(job.secrets?.environmentSecrets ?? []),
+        ],
+      },
+      ...(this._job.platform ? { expoBuildUrl: this._job.expoBuildUrl } : null),
+    };
+    this._metadata = metadata;
+  }
+
+  private async handleBuildPhaseErrorAsync(
+    err: any,
+    buildPhase: BuildPhase
+  ): Promise<errors.ExpoError> {
+    const buildError = await resolveBuildPhaseErrorAsync(
+      err,
+      this.logBuffer.getPhaseLogs(buildPhase),
+      {
+        job: this.job,
+        phase: buildPhase,
+        env: this.env,
+      },
+      this.buildLogsDirectory
+    );
+    if (buildError.errorCode === errors.ErrorCode.UNKNOWN_ERROR) {
+      // leaving message empty, website will display err.stack which already includes err.message
+      this.logger.error({ err }, '');
+    } else {
+      this.logger.error(`Error: ${buildError.message}`);
+    }
+    return buildError;
+  }
+
+  public getReactNativeProjectDirectory(baseDirectory = this.buildDirectory): string {
+    if (!this.job.platform) {
+      return path.join(
+        baseDirectory,
+        // NOTE: We may want to add projectRootDirectory to generic jobs in the future.
+        this.job.builderEnvironment.env.__EXPO_RELATIVE_BASE_DIRECTORY || '.'
+      );
+    }
+
+    return path.join(baseDirectory, this.job.projectRootDirectory ?? '.');
+  }
+
+  private setBuildPhase(buildPhase: BuildPhase, { doNotMarkStart = false } = {}): void {
+    if (this.buildPhase) {
+      if (this.buildPhase === buildPhase) {
+        return;
+      } else {
+        this.logger.info(
+          { marker: LogMarker.END_PHASE, result: BuildPhaseResult.UNKNOWN },
+          `End phase: ${this.buildPhase}`
+        );
+        this.logger = this.defaultLogger;
+      }
+    }
+    this.buildPhase = buildPhase;
+    this.logger = this.defaultLogger.child({ phase: buildPhase });
+    if (!doNotMarkStart) {
+      this.logger.info({ marker: LogMarker.START_PHASE }, `Start phase: ${this.buildPhase}`);
+    }
+  }
+
+  private async endCurrentBuildPhaseAsync({
+    result,
+    doNotMarkEnd = false,
+    durationMs,
+  }: {
+    result: BuildPhaseResult;
+    doNotMarkEnd?: boolean;
+    durationMs: number;
+  }): Promise<void> {
+    if (!this.buildPhase) {
+      return;
+    }
+    await this.collectAndUpdateEnvVariablesAsync();
+
+    this.reportBuildPhaseStats?.({ buildPhase: this.buildPhase, result, durationMs });
+    if (this.job.platform) {
+      Datadog.distribution('eas.build.phase_duration', durationMs, {
+        build_phase: this.buildPhase.toLowerCase(),
+        platform: this.job.platform,
+        result,
+      });
+    }
+
+    if (!doNotMarkEnd) {
+      this.logger.info(
+        { marker: LogMarker.END_PHASE, result, durationMs },
+        `End phase: ${this.buildPhase}`
+      );
+    }
+    this.logger = this.defaultLogger;
+    this.buildPhase = undefined;
+    this.buildPhaseSkipped = false;
+    this.buildPhaseHasWarnings = false;
+  }
+
+  private async collectAndUpdateEnvVariablesAsync(): Promise<void> {
+    const filenames = await fs.readdir(this.buildEnvsDirectory);
+
+    const entries = await Promise.all(
+      filenames.map(async basename => {
+        const rawContents = await fs.readFile(
+          path.join(this.buildEnvsDirectory, basename),
+          'utf-8'
+        );
+        return [basename, rawContents];
+      })
+    );
+    await Promise.all(
+      filenames.map(async basename => {
+        await fs.remove(path.join(this.buildEnvsDirectory, basename));
+      })
+    );
+    this._env = {
+      ...this._env,
+      ...Object.fromEntries(entries),
+    };
+  }
+
+  private getEnvironmentSecrets(job: TJob): Record<string, string> {
+    if (!job?.secrets?.environmentSecrets) {
+      return {};
+    }
+
+    const environmentSecretsDirectory = path.join(this.workingdir, 'eas-environment-secrets');
+
+    const environmentSecrets: Record<string, string> = {};
+    for (const { name, type, value } of job.secrets.environmentSecrets) {
+      if (type === EnvironmentSecretType.STRING) {
+        environmentSecrets[name] = value;
+      } else {
+        environmentSecrets[name] = createTemporaryEnvironmentSecretFile({
+          secretsDir: environmentSecretsDirectory,
+          name,
+          contents_base64: value,
+        });
+      }
+    }
+    return environmentSecrets;
+  }
+}

packages/build-tools/src/customBuildContext.ts

@@ -0,0 +1,171 @@
+import {
+  BuildJob,
+  BuildPhase,
+  BuildTrigger,
+  Env,
+  Job,
+  Metadata,
+  Platform,
+  StaticJobInterpolationContext,
+} from '@expo/eas-build-job';
+import { bunyan } from '@expo/logger';
+import { BuildRuntimePlatform, ExternalBuildContextProvider, StepMetric } from '@expo/steps';
+import { Client } from '@urql/core';
+import assert from 'assert';
+import path from 'path';
+
+import { ArtifactToUpload, BuildContext } from './context';
+import { uploadStepMetricsToWwwAsync } from './utils/stepMetrics';
+
+const platformToBuildRuntimePlatform: Record<Platform, BuildRuntimePlatform> = {
+  [Platform.ANDROID]: BuildRuntimePlatform.LINUX,
+  [Platform.IOS]: BuildRuntimePlatform.DARWIN,
+};
+
+export interface BuilderRuntimeApi {
+  uploadArtifact: (spec: { artifact: ArtifactToUpload; logger: bunyan }) => Promise<{
+    artifactId: string | null;
+  }>;
+}
+
+export class CustomBuildContext<TJob extends Job = Job> implements ExternalBuildContextProvider {
+  /*
+   * Directory that contains project sources before eas/checkout.
+   */
+  public readonly projectSourceDirectory: string;
+
+  /*
+   * Directory where build is executed. eas/checkout will copy sources here.
+   */
+  public readonly projectTargetDirectory: string;
+
+  /*
+   * Directory where all build steps will be executed unless configured otherwise.
+   */
+  public readonly defaultWorkingDirectory: string;
+
+  /*
+   * Directory where build logs will be stored unless configure otherwise.
+   */
+  public readonly buildLogsDirectory: string;
+
+  /**
+   * Time of the start of the build.
+   */
+  public readonly startTime: Date;
+
+  public readonly logger: bunyan;
+  public readonly graphqlClient: Client;
+  public readonly runtimeApi: BuilderRuntimeApi;
+  public job: TJob;
+  public metadata?: Metadata;
+
+  private _env: Env;
+  private readonly expoApiV2BaseUrl?: string;
+  private readonly pendingMetricUploads: Promise<void>[] = [];
+
+  constructor(buildCtx: BuildContext<TJob>) {
+    this._env = buildCtx.env;
+    this.job = buildCtx.job;
+    this.metadata = buildCtx.metadata;
+
+    this.logger = buildCtx.logger.child({ phase: BuildPhase.CUSTOM });
+    this.graphqlClient = buildCtx.graphqlClient;
+    this.projectSourceDirectory = path.join(buildCtx.workingdir, 'temporary-custom-build');
+    this.projectTargetDirectory = path.join(buildCtx.workingdir, 'build');
+    this.defaultWorkingDirectory = buildCtx.getReactNativeProjectDirectory();
+    this.buildLogsDirectory = path.join(buildCtx.workingdir, 'logs');
+    this.runtimeApi = {
+      uploadArtifact: (...args) => buildCtx['uploadArtifact'](...args),
+    };
+    this.expoApiV2BaseUrl = buildCtx.expoApiV2BaseUrl;
+    this.startTime = new Date();
+  }
+
+  public hasBuildJob(): this is CustomBuildContext<BuildJob> {
+    return Boolean(this.job.platform);
+  }
+
+  public get runtimePlatform(): BuildRuntimePlatform {
+    // Generic jobs are not per-platform.
+    if (!this.job.platform) {
+      assert(
+        process.platform === 'linux' || process.platform === 'darwin',
+        `Invalid platform, expected linux or darwin, got: ${process.platform}`
+      );
+      return {
+        linux: BuildRuntimePlatform.LINUX,
+        darwin: BuildRuntimePlatform.DARWIN,
+      }[process.platform];
+    }
+
+    return platformToBuildRuntimePlatform[this.job.platform];
+  }
+
+  public get env(): Env {
+    return this._env;
+  }
+
+  // We omit steps, because CustomBuildContext does not have steps.
+  public staticContext(): Omit<StaticJobInterpolationContext, 'steps'> {
+    return {
+      ...this.job.workflowInterpolationContext,
+      expoApiServerURL: this.env.__API_SERVER_URL,
+      job: this.job,
+      metadata: this.metadata ?? null,
+    };
+  }
+
+  public updateEnv(env: Env): void {
+    this._env = env;
+  }
+
+  public updateJobInformation(job: TJob, metadata: Metadata): void {
+    if (this.job.triggeredBy !== BuildTrigger.GIT_BASED_INTEGRATION) {
+      throw new Error(
+        'Updating job information is only allowed when build was triggered by a git-based integration.'
+      );
+    }
+    this.job = {
+      ...this.job,
+      ...job,
+      workflowInterpolationContext:
+        job.workflowInterpolationContext ?? this.job.workflowInterpolationContext,
+      triggeredBy: this.job.triggeredBy,
+      secrets: {
+        ...this.job.secrets,
+        ...job.secrets,
+        robotAccessToken: job.secrets?.robotAccessToken ?? this.job.secrets?.robotAccessToken,
+        environmentSecrets: [
+          // Latter secrets override former ones.
+          ...(this.job.secrets?.environmentSecrets ?? []),
+          ...(job.secrets?.environmentSecrets ?? []),
+        ],
+      },
+      ...(this.job.platform ? { expoBuildUrl: this.job.expoBuildUrl } : null),
+    };
+    this.metadata = metadata;
+  }
+
+  public reportStepMetric(metric: StepMetric): void {
+    const workflowJobId = this._env.__WORKFLOW_JOB_ID;
+    const robotAccessToken = this.job.secrets?.robotAccessToken;
+
+    if (!workflowJobId || !robotAccessToken || !this.expoApiV2BaseUrl) {
+      return;
+    }
+
+    const p = uploadStepMetricsToWwwAsync({
+      workflowJobId,
+      robotAccessToken,
+      expoApiV2BaseUrl: this.expoApiV2BaseUrl,
+      stepMetrics: [metric],
+      logger: this.logger,
+    });
+    this.pendingMetricUploads.push(p);
+  }
+
+  public async drainPendingMetricUploads(): Promise<void> {
+    await Promise.allSettled(this.pendingMetricUploads);
+  }
+}

packages/build-tools/src/datadog.ts

@@ -0,0 +1,54 @@
+import { Sentry } from './sentry';
+import { turtleFetch } from './utils/turtleFetch';
+
+type DatadogSetupOptions = {
+  expoApiV2BaseUrl: string;
+  turtleBuildId: string;
+  robotAccessToken: string;
+};
+
+let setupOptions: DatadogSetupOptions | null = null;
+let pendingMetricUploads: Promise<unknown>[] = [];
+
+export const Datadog = {
+  setup(opts: DatadogSetupOptions | null): void {
+    setupOptions = opts;
+  },
+
+  distribution(name: string, value: number, tags: Record<string, string> = {}): void {
+    if (!setupOptions) {
+      return;
+    }
+    const { expoApiV2BaseUrl, turtleBuildId, robotAccessToken } = setupOptions;
+    const metrics = [
+      {
+        name,
+        type: 'distribution' as const,
+        value,
+        tags,
+      },
+    ];
+
+    const uploadPromise = turtleFetch(
+      new URL(`turtle-builds/${turtleBuildId}/metrics`, expoApiV2BaseUrl).toString(),
+      'POST',
+      {
+        json: { metrics },
+        headers: {
+          Authorization: `Bearer ${robotAccessToken}`,
+        },
+        retries: 2,
+      }
+    ).catch(err => {
+      Sentry.capture('Failed to report turtle build metric', err, {
+        extras: { metrics },
+      });
+    });
+
+    pendingMetricUploads.push(uploadPromise);
+  },
+
+  async flushAsync(): Promise<void> {
+    await Promise.allSettled(pendingMetricUploads);
+  },
+};

packages/build-tools/src/gcs/LoggerStream.ts

@@ -0,0 +1,237 @@
+import { bunyan } from '@expo/logger';
+import assert from 'assert';
+import { randomUUID } from 'crypto';
+import fs from 'fs-extra';
+import os from 'os';
+import path from 'path';
+import { Readable, Writable, pipeline } from 'stream';
+import { promisify } from 'util';
+import zlib from 'zlib';
+
+import GCS from './client';
+
+type PromiseResolveFn = (value?: void | PromiseLike<void> | undefined) => void;
+
+const pipe = promisify(pipeline);
+
+class GCSLoggerStream extends Writable {
+  public writable = true;
+  private readonly logger: bunyan;
+  private readonly uploadMethod?: GCSLoggerStream.UploadMethod;
+  private readonly options: GCSLoggerStream.Options;
+  private readonly temporaryLogsPath: string;
+  private readonly temporaryCompressedLogsPath: string;
+  private readonly compress: string | null;
+  private fileHandle?: number;
+  private uploadingPromise?: Promise<void>;
+  private hasChangesToUpload = false;
+  private flushInterval?: NodeJS.Timeout;
+  private buffer: string[] = [];
+  private writePromise?: Promise<any>;
+  private cleanUpCalled: boolean = false;
+
+  constructor({ logger, uploadMethod, options }: GCSLoggerStream.Config) {
+    super();
+    this.logger = logger;
+    this.uploadMethod = uploadMethod;
+    this.options = options;
+    this.compress = options?.compress ?? this.findNormalizedHeader('contentencoding');
+    this.temporaryLogsPath = path.join(os.tmpdir(), `logs-${randomUUID()}`);
+    this.temporaryCompressedLogsPath = `${this.temporaryLogsPath}.compressed`;
+  }
+
+  private findNormalizedHeader(name: string): string | null {
+    if (!this.uploadMethod || 'client' in this.uploadMethod) {
+      return null;
+    }
+
+    const normalizedName = name.toLowerCase().replace('-', '');
+    const fields = this.uploadMethod.signedUrl.headers;
+    for (const key in fields) {
+      if (key.toLowerCase().replace('-', '') === normalizedName) {
+        return fields[key];
+      }
+    }
+
+    return null;
+  }
+
+  public async init(): Promise<string> {
+    this.fileHandle = await fs.open(this.temporaryLogsPath, 'w+', 0o660);
+    this.flushInterval = setInterval(() => this.flush(), this.options.uploadIntervalMs);
+    return (await this.flush(true)) as string;
+  }
+
+  public async cleanUp(): Promise<void> {
+    if (this.cleanUpCalled) {
+      this.logger.info('Cleanup already called');
+      return;
+    }
+    this.cleanUpCalled = true;
+    if (!this.fileHandle) {
+      throw new Error('You have to init the stream first!');
+    }
+    if (this.flushInterval) {
+      clearInterval(this.flushInterval);
+      this.flushInterval = undefined;
+    }
+
+    await this.safeWriteToFile(true);
+    await fs.close(this.fileHandle);
+    this.fileHandle = undefined;
+
+    await this.flush(true);
+
+    await fs.remove(this.temporaryLogsPath);
+    await fs.remove(this.temporaryCompressedLogsPath);
+    this.logger.info('Cleaning up GCS log stream');
+  }
+
+  public write(rec: any): boolean {
+    if (!this.fileHandle) {
+      return true;
+    }
+    const logLine = `${JSON.stringify(rec)}\n`;
+    this.buffer.push(logLine);
+    void this.safeWriteToFile();
+    return true;
+  }
+
+  private async safeWriteToFile(force = false): Promise<void> {
+    if (this.writePromise && force) {
+      await this.writePromise;
+      await this.safeWriteToFile(force);
+      return;
+    }
+
+    if (!this.fileHandle || Boolean(this.writePromise) || this.buffer.length === 0) {
+      return;
+    }
+
+    const buffer = this.buffer.slice();
+    try {
+      this.writePromise = fs.write(this.fileHandle, buffer.join(''));
+      await this.writePromise;
+      this.buffer = this.buffer.slice(buffer.length);
+      this.hasChangesToUpload = true;
+    } catch (err) {
+      this.logger.error({ err, origin: 'gcs-logger' }, 'Failed to write logs to file');
+    } finally {
+      this.writePromise = undefined;
+    }
+  }
+
+  private async flush(force = false): Promise<string | void> {
+    if (force || this.hasChangesToUpload) {
+      if (this.uploadingPromise) {
+        await this.uploadingPromise;
+        return await this.flush(force);
+      }
+      return await this.flushInternal();
+    }
+  }
+
+  private async flushInternal(): Promise<string | void> {
+    await this.safeWriteToFile();
+
+    let resolveFn: PromiseResolveFn;
+    this.hasChangesToUpload = false;
+    this.uploadingPromise = new Promise(res => {
+      resolveFn = res;
+    });
+    return await this.upload()
+      .then(result => {
+        return result;
+      })
+      .catch(err => {
+        this.logger.error({ err }, 'Failed to upload logs file to GCS');
+      })
+      .then(result => {
+        this.uploadingPromise = undefined;
+        resolveFn();
+        return result;
+      });
+  }
+
+  private async upload(): Promise<string | void> {
+    if (!this.uploadMethod) {
+      return;
+    }
+
+    const { size } = await fs.stat(this.temporaryLogsPath);
+    const srcGeneratorAsync = async (): Promise<Readable> => {
+      return await this.createCompressedStream(
+        fs.createReadStream(this.temporaryLogsPath, { end: size })
+      );
+    };
+
+    if ('signedUrl' in this.uploadMethod) {
+      return await GCS.uploadWithSignedUrl({
+        signedUrl: this.uploadMethod.signedUrl,
+        srcGeneratorAsync,
+      });
+    }
+
+    const { Location } = await this.uploadMethod.client.uploadFile({
+      key: this.uploadMethod.key,
+      src: await srcGeneratorAsync(),
+      streamOptions: {
+        metadata: {
+          contentType: 'text/plain;charset=utf-8',
+          ...(this.compress !== null ? { contentEncoding: this.compress } : {}),
+          customTime: this.uploadMethod.customTime,
+        },
+      },
+    });
+    return Location;
+  }
+
+  private async createCompressedStream(src: Readable): Promise<Readable> {
+    if (!this.compress) {
+      return src;
+    }
+
+    const dst = fs.createWriteStream(this.temporaryCompressedLogsPath);
+
+    const encoder =
+      this.compress === 'gzip'
+        ? zlib.createGzip()
+        : this.compress === 'br'
+          ? zlib.createBrotliCompress({
+              params: {
+                [zlib.constants.BROTLI_PARAM_QUALITY]: 0,
+              },
+            })
+          : null;
+
+    assert(encoder, `unknown encoder ${encoder}`);
+    await pipe(src, encoder, dst);
+
+    const { size } = await fs.stat(this.temporaryCompressedLogsPath);
+    return fs.createReadStream(this.temporaryCompressedLogsPath, { end: size });
+  }
+}
+
+namespace GCSLoggerStream {
+  export enum CompressionMethod {
+    GZIP = 'gzip',
+    BR = 'br',
+  }
+
+  export interface Options {
+    uploadIntervalMs: number;
+    compress?: CompressionMethod;
+  }
+
+  export type UploadMethod =
+    | { client: GCS; key: string; customTime: Date | null }
+    | { signedUrl: GCS.SignedUrl };
+
+  export interface Config {
+    logger: bunyan;
+    uploadMethod?: UploadMethod;
+    options: Options;
+  }
+}
+
+export default GCSLoggerStream;