[build-tools] Add eas/deploy function

[gwdp]

Why

Introduce eas/deploy function to streamline export+deploy usual combination within single unit. Includes deploy_json output from eas deploy --json for anything that comes after.

Ref ENG-14737

How

New function with configurable export command, deploy alias, prod and source_maps; environment is passed through when it’s on job metadata.

Test Plan

Local run with the following workflows

✅ Success path

name: deploy-web-custom

on:
  workflow_dispatch: {}
  push:
    branches: ["main"]

jobs:
  deploy_custom:
    name: Deploy web with custom steps
    type: custom
    runs_on: linux-medium
    environment: production
    outputs:
      deploy_json: ${{ steps.deploy.outputs.deploy_json }}
    env:
      APP_VARIANT: production
    steps:
      - uses: eas/checkout
      - uses: eas/use_npm_token
      - uses: eas/install_node_modules
      - uses: eas/deploy
        id: deploy
        with:
          environment: production
          source_maps: false
          export_command: npx expo export --platform web --clear && echo "Custom export command done"
      - run: echo "Deploy output - ${{ steps.deploy.outputs.deploy_json }}"

  read_output:
    name: Read deploy output from another job
    type: custom
    runs_on: linux-medium
    needs: [deploy_custom]
    steps:
      - run: echo "Deploy JSON from previous job - ${{ needs.deploy_custom.outputs.deploy_json }}"

❌ Failure pattern

name: deploy-web-custom-simple-no-setup

on:
  workflow_dispatch: {}

jobs:
  deploy_custom:
    name: Deploy web without setup steps (expected to fail)
    type: custom
    runs_on: linux-medium
    environment: production
    env:
      APP_VARIANT: production
    steps:
      - run: echo "Before eas/deploy - no npm token, or node_modules"
      - uses: eas/checkout
      - uses: eas/deploy
      - run: echo "After eas/deploy stub"

[linear]

ENG-14737 Add `eas/deploy` function group

[codecov]

Codecov Report

❌ Patch coverage is 97.32143% with 3 lines in your changes missing coverage. Please review.
✅ Project coverage is 55.00%. Comparing base (3a70a5d) to head (f3bbb02).

Files with missing lines	Patch %	Lines
...ackages/build-tools/src/common/easBuildInternal.ts	50.00%	2 Missing ⚠️
packages/build-tools/src/utils/easCli.ts	96.00%	1 Missing ⚠️

Additional details and impacted files

@@            Coverage Diff             @@
##             main    #3598      +/-   ##
==========================================
+ Coverage   54.86%   55.00%   +0.15%     
==========================================
  Files         836      839       +3     
  Lines       35901    36000      +99     
  Branches     7492     7509      +17     
==========================================
+ Hits        19694    19800     +106     
+ Misses      16112    16105       -7     
  Partials       95       95              

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

[github-actions]

Subscribed to pull request

File Patterns	Mentions
**/*	@douglowder

Generated by CodeMention

[sjchmiela]

wdyt about making it be a separate function? then the input to this function would be the export_dir and output of eas/[expo_]export would be the dist_dir?

[gwdp]

Great idea, allows a little more space for inputs from the export side. Let me know if you have any additional thoughts around the inputs of export function.

Around the name, not 100% sure if you suggested eas/expo_export, would that be the case? I can see prebuild which similarly, calls expo command, not having the prefix although it would make sense imo. export only could be too broad for people new to EAS, as me?

[sjchmiela]

i wonder if it would be nice if we made eas-cli deploy return different exit codes for different issues and based on that figure out whether it was a system or user error?

I have https://exponent-internal.slack.com/archives/C06EFBQK3B7/p1773417343042269 in my memory

[github-actions]

✅ Thank you for adding the changelog entry!