test: E2E tests for Android

.changeset/config.json

@@ -22,10 +22,11 @@
     "@callstack/brownfield-example-android-app",
     "@callstack/brownfield-example-ios-app",
     "@callstack/brownfield-example-rn-app",
-    "@callstack/brownfield-example-expo-app-54",
     "@callstack/brownfield-example-expo-app-55",
+    "@callstack/brownfield-example-expo-app-56",
+    "@callstack/brownfield-gradle-plugin-react",
     "@callstack/brownfield-example-shared-tests",
-    "@callstack/brownfield-gradle-plugin-react"
+    "@callstack/brownfield-example-expo-app-57"
   ],
   "___experimentalUnsafeOptions_WILL_CHANGE_IN_PATCH": {
     "onlyUpdatePeerDependentsWhenOutOfRange": true,

.changeset/small-clouds-train.md

@@ -0,0 +1,6 @@
+---
+'@callstack/brownfield-navigation': minor
+'@callstack/brownfield-cli': minor
+---
+
+feat: add support for callback and promise to brownfield navigation

.github/actions/androidapp-road-test/action.yml

@@ -19,6 +19,11 @@ inputs:
     required: false
     default: 'true'
 
+  skip-setup:
+    description: 'Skip yarn install/build when the caller already prepared the monorepo (e.g. Expo preview workflow)'
+    required: false
+    default: 'false'
+
   run-e2e:
     description: 'Run Detox E2E after packaging (uses release APK with embedded JS bundle, no Metro). Ignored when e2e-phase is set.'
     required: false
@@ -71,6 +76,7 @@ runs:
       shell: bash
 
     - name: Setup
+      if: inputs.skip-setup != 'true'
       uses: ./.github/actions/setup
       with:
         restore-turbo-cache: ${{ inputs.restore-turbo-cache }}
@@ -394,6 +400,7 @@ runs:
           cd apps/AndroidApp
           yarn "$ANDROIDAPP_E2E_TEST_SCRIPT"
       env:
+        ANDROIDAPP_VARIANT: ${{ inputs.flavor }}
         ANDROIDAPP_E2E_TEST_SCRIPT: ${{ env.ANDROIDAPP_E2E_TEST_SCRIPT }}
 
     - name: Save Android ccache (after E2E)

.github/actions/appleapp-road-test/action.yml

@@ -25,6 +25,11 @@ inputs:
     required: false
     default: 'true'
 
+  skip-setup:
+    description: 'Skip yarn install/build when the caller already prepared the monorepo (e.g. Expo preview workflow)'
+    required: false
+    default: 'false'
+
 runs:
   using: composite
   steps:
@@ -33,6 +38,7 @@ runs:
       shell: bash
 
     - name: Setup
+      if: inputs.skip-setup != 'true'
       uses: ./.github/actions/setup
       with:
         restore-turbo-cache: ${{ inputs.restore-turbo-cache }}

.github/actions/prepare-android/action.yml

@@ -23,7 +23,7 @@ inputs:
     default: 'false'
 
   gradle-workflow-job-context:
-    description: 'Segment Gradle cache per app/project (e.g. vanilla, expo54). Falls back to github.job when empty.'
+    description: 'Segment Gradle cache per app/project (e.g. vanilla, expo55). Falls back to github.job when empty.'
     required: false
     default: ''
 

.github/actions/setup/action.yml

@@ -19,13 +19,15 @@ runs:
       uses: actions/setup-node@65d868f8d4d85d7d4abb7de0875cde3fcc8798f5 # v6
       with:
         node-version: 'lts/*'
+        check-latest: true
         cache: 'yarn'
 
     - name: Setup Node.js (no cache)
       if: inputs.disable-cache == 'true'
       uses: actions/setup-node@65d868f8d4d85d7d4abb7de0875cde3fcc8798f5 # v6
       with:
         node-version: 'lts/*'
+        check-latest: true
         package-manager-cache: false
 
     - name: Restore Turbo cache

.github/workflows/ci.yml

@@ -22,10 +22,11 @@ jobs:
     outputs:
       packages: ${{ steps.filter.outputs.packages }}
       rnapp: ${{ steps.filter.outputs.rnapp }}
-      expo54: ${{ steps.filter.outputs.expo54 }}
       expo55: ${{ steps.filter.outputs.expo55 }}
+      expo56: ${{ steps.filter.outputs.expo56 }}
       androidapp: ${{ steps.filter.outputs.androidapp }}
       appleapp: ${{ steps.filter.outputs.appleapp }}
+      gradle-plugins: ${{ steps.filter.outputs.gradle-plugins }}
       ci: ${{ steps.filter.outputs.ci }}
     steps:
       - name: Checkout
@@ -41,18 +42,20 @@ jobs:
             rnapp:
               - 'apps/RNApp/**'
               - 'apps/brownfield-example-shared-tests/**'
-            expo54:
-              - 'apps/ExpoApp54/**'
-              - 'apps/brownfield-example-shared-tests/**'
             expo55:
               - 'apps/ExpoApp55/**'
               - 'apps/brownfield-example-shared-tests/**'
+            expo56:
+              - 'apps/ExpoApp56/**'
+              - 'apps/brownfield-example-shared-tests/**'
             androidapp:
               - 'apps/AndroidApp/**'
               - 'apps/brownfield-example-shared-tests/**'
             appleapp:
               - 'apps/AppleApp/**'
               - 'apps/brownfield-example-shared-tests/**'
+            gradle-plugins:
+              - 'gradle-plugins/**'
             ci:
               - '.github/**'
 
@@ -137,17 +140,19 @@ jobs:
     if: |
       always() &&
       (
-        needs.filter.outputs.expo54 == 'true' ||
         needs.filter.outputs.expo55 == 'true' ||
+        needs.filter.outputs.expo56 == 'true' ||
         needs.filter.outputs.androidapp == 'true' ||
         needs.filter.outputs.packages == 'true' ||
+        needs.filter.outputs.gradle-plugins == 'true' ||
         needs.filter.outputs.ci == 'true'
       ) &&
       (needs.build-lint.result == 'success' || needs.build-lint.result == 'skipped')
     strategy:
       matrix:
         include:
-          - version: '54'
+          - version: '55'
+          - version: '56'
 
     steps:
       - name: Checkout
@@ -172,6 +177,7 @@ jobs:
         needs.filter.outputs.expo55 == 'true' ||
         needs.filter.outputs.androidapp == 'true' ||
         needs.filter.outputs.packages == 'true' ||
+        needs.filter.outputs.gradle-plugins == 'true' ||
         needs.filter.outputs.ci == 'true'
       ) &&
       (needs.build-lint.result == 'success' || needs.build-lint.result == 'skipped')
@@ -201,6 +207,7 @@ jobs:
         needs.filter.outputs.expo55 == 'true' ||
         needs.filter.outputs.androidapp == 'true' ||
         needs.filter.outputs.packages == 'true' ||
+        needs.filter.outputs.gradle-plugins == 'true' ||
         needs.filter.outputs.ci == 'true'
       ) &&
       (needs.build-lint.result == 'success' || needs.build-lint.result == 'skipped') &&
@@ -220,6 +227,67 @@ jobs:
           e2e-apk-artifact-name: androidapp-expo55-e2e-apks
           e2e-artifact-name: detox-androidapp-expo55
 
+  android-androidapp-expo56-build:
+    name: Build AndroidApp & Detox APKs (Expo 56)
+    runs-on: ubuntu-latest
+    timeout-minutes: 120
+    needs: [filter, build-lint]
+    if: |
+      always() &&
+      (
+        needs.filter.outputs.expo56 == 'true' ||
+        needs.filter.outputs.androidapp == 'true' ||
+        needs.filter.outputs.packages == 'true' ||
+        needs.filter.outputs.gradle-plugins == 'true' ||
+        needs.filter.outputs.ci == 'true'
+      ) &&
+      (needs.build-lint.result == 'success' || needs.build-lint.result == 'skipped')
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@8e8c483db84b4bee98b60c0593521ed34d9990e8 # v6
+
+      - name: Build Expo 56 AndroidApp Detox APKs
+        uses: ./.github/actions/androidapp-road-test
+        with:
+          flavor: expo56
+          rn-project-path: apps/ExpoApp56
+          rn-project-maven-path: com/callstack/rnbrownfield/demo/expoapp56/brownfieldlib
+          e2e-phase: build
+          e2e-apk-artifact-name: androidapp-expo56-e2e-apks
+          e2e-artifact-name: detox-androidapp-expo56
+
+  android-androidapp-expo56-e2e:
+    name: Detox E2E (AndroidApp - Expo 56)
+    runs-on: ubuntu-latest
+    timeout-minutes: 90
+    needs: [filter, build-lint, android-androidapp-expo56-build]
+    if: |
+      always() &&
+      (
+        needs.filter.outputs.expo56 == 'true' ||
+        needs.filter.outputs.androidapp == 'true' ||
+        needs.filter.outputs.packages == 'true' ||
+        needs.filter.outputs.gradle-plugins == 'true' ||
+        needs.filter.outputs.ci == 'true'
+      ) &&
+      (needs.build-lint.result == 'success' || needs.build-lint.result == 'skipped') &&
+      needs.android-androidapp-expo56-build.result == 'success'
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@8e8c483db84b4bee98b60c0593521ed34d9990e8 # v6
+
+      - name: Run Expo 56 Detox E2E (prebuilt APKs)
+        uses: ./.github/actions/androidapp-road-test
+        with:
+          flavor: expo56
+          rn-project-path: apps/ExpoApp56
+          rn-project-maven-path: com/callstack/rnbrownfield/demo/expoapp56/brownfieldlib
+          e2e-phase: test
+          e2e-apk-artifact-name: androidapp-expo56-e2e-apks
+          e2e-artifact-name: detox-androidapp-expo56
+
   android-androidapp-vanilla:
     name: Android road test & E2E (AndroidApp - Vanilla)
     runs-on: ubuntu-latest
@@ -231,6 +299,7 @@ jobs:
         needs.filter.outputs.rnapp == 'true' ||
         needs.filter.outputs.androidapp == 'true' ||
         needs.filter.outputs.packages == 'true' ||
+        needs.filter.outputs.gradle-plugins == 'true' ||
         needs.filter.outputs.ci == 'true'
       ) &&
       (needs.build-lint.result == 'success' || needs.build-lint.result == 'skipped')
@@ -283,8 +352,8 @@ jobs:
     if: |
       always() &&
       (
-        needs.filter.outputs.expo54 == 'true' ||
         needs.filter.outputs.expo55 == 'true' ||
+        needs.filter.outputs.expo56 == 'true' ||
         needs.filter.outputs.appleapp == 'true' ||
         needs.filter.outputs.packages == 'true' ||
         needs.filter.outputs.ci == 'true'
@@ -293,10 +362,10 @@ jobs:
     strategy:
       matrix:
         include:
-          - version: '54'
-            run-e2e: 'false'
           - version: '55'
             run-e2e: 'true'
+          - version: '56'
+            run-e2e: 'true'
 
     steps:
       - name: Checkout