feat: resolve the Android store at build time

.claude/commands/e2e-tests-apple.md

@@ -0,0 +1,53 @@
+---
+name: e2e-tests-apple
+description: Run Apple-side device-backed OpenIAP regression on iOS using packages/apple and framework examples. Use when the user asks for iOS e2e tests or the Apple half of a parallel e2e run.
+---
+
+# E2E Tests Apple — iOS
+
+Run this for the Apple half of OpenIAP device regression, alone or in
+parallel with `/e2e-tests-google`. For the full matrix in one run, use
+`/e2e-tests` instead. For a delegated hardware run, use
+`$e2e-matrix-runner-apple`.
+
+`e2e-tests.md` is the authority on what a row means and how to verify one.
+Read it first and follow the sections named below; this file only narrows the
+scope.
+
+## Scope
+
+- `packages/apple` native: `swift build` and `swift test`, plus the
+  xcframework build when iOS native packaging or bindings changed
+  (`## Package-Level Checks`, Apple package).
+- iOS rows: all six frameworks (`react-native-iap`, `expo-iap`,
+  `flutter_inapp_purchase`, `kmp-iap`, `maui-iap`, `godot-iap`).
+- Expo Onside: iOS build-only (`EXPO_IAP_ONSIDE=1` path under
+  `## Expo Checks`).
+- Local (IAPKit) receipt vertical on iOS
+  (`## Local (IAPKit) Receipt Vertical`).
+
+That is the 7 iOS cells plus the Expo Onside build-only cell of the full
+matrix. Report every unavailable row as `BLOCKED` with its exact missing
+prerequisite.
+
+For each row, run the matching iOS sections under `## Expo Checks`,
+`## React Native Checks`, `## Flutter Checks`, `## KMP Checks`,
+`## MAUI Checks`, and `## Godot Checks`, then the iPhone bullet under
+`## Manual Store Flows`.
+
+## Preflight
+
+Run the `## Preflight` block from `e2e-tests.md`, skipping only the
+Android-only probes (`adb`, `vega`/`kepler`).
+
+## Parallel-run rules
+
+- Start the local IAPKit server once and share it with the Android half:
+  the iPhone verifies over the Mac's LAN address, Android over
+  `adb reverse tcp:3100`.
+- Run only one Metro packager at a time across both halves (the RN/Expo
+  debug rows share port 8081); the devices otherwise proceed in parallel.
+
+## Final Report
+
+Use the `## Final Report` matrix in `e2e-tests.md`, iOS rows only.

.claude/commands/e2e-tests-google.md

@@ -0,0 +1,56 @@
+---
+name: e2e-tests-google
+description: Run Android-side device-backed OpenIAP regression across Google Play, Amazon Appstore, Meta Horizon, and VegaOS using packages/google and framework examples. Use when the user asks for Android e2e tests or the Android half of a parallel e2e run.
+---
+
+# E2E Tests Google — Play / Amazon / Horizon / VegaOS
+
+Run this for the Android half of OpenIAP device regression, alone or in
+parallel with `/e2e-tests-apple`. For the full matrix in one run, use
+`/e2e-tests` instead. For a delegated hardware run, use
+`$e2e-matrix-runner-google`.
+
+`e2e-tests.md` is the authority on what a row means and how to verify one.
+Read it first and follow the sections named below; this file only narrows the
+scope.
+
+## Scope
+
+- `packages/google` native: Play, Amazon, and Horizon compile plus tests
+  (`## Package-Level Checks`, Google Android package).
+- Play rows: all six frameworks (`react-native-iap`, `expo-iap`,
+  `flutter_inapp_purchase`, `kmp-iap`, `maui-iap`, `godot-iap`).
+- FireOS/Amazon rows: all six except `godot-iap`, which has no Amazon flavor.
+- Horizon rows: all six except `godot-iap`, which has no Horizon flavor.
+  Horizon is build-only unless the request authorizes a visibly test/sandbox
+  checkout.
+- VegaOS rows: `react-native-iap` and `expo-iap` only.
+- Local (IAPKit) receipt vertical on Android
+  (`## Local (IAPKit) Receipt Vertical`).
+
+That is the 21 Android/Horizon cells plus the 2 VegaOS cells of the full
+matrix. Report the two Godot gaps as `UNSUPPORTED` with the reason, never
+omitted; every other unavailable row is `BLOCKED` with its exact missing
+prerequisite.
+
+For each row, run the matching Android sections under `## Expo Checks`,
+`## React Native Checks`, `## Flutter Checks`, `## KMP Checks`,
+`## MAUI Checks`, and `## Godot Checks`, then the Android platform bullets
+under `## Manual Store Flows` (Play, FireOS, VegaOS, Horizon).
+
+## Preflight
+
+Run the `## Preflight` block from `e2e-tests.md`, skipping only the iOS-only
+probes (`xcrun`, `xcodebuild`).
+
+## Parallel-run rules
+
+- Start the local IAPKit server once and share it with the Apple half:
+  Android verifies over `adb reverse tcp:3100`, the iPhone over the Mac's LAN
+  address.
+- Run only one Metro packager at a time across both halves (the RN/Expo
+  debug rows share port 8081); the devices otherwise proceed in parallel.
+
+## Final Report
+
+Use the `## Final Report` matrix in `e2e-tests.md`, Android rows only.

.claude/commands/e2e-tests.md

@@ -8,6 +8,10 @@ description: Run device-backed OpenIAP regression across native packages and fra
 Run this when a PR or release candidate needs real-device regression across
 OpenIAP native packages and framework examples.
 
+For a parallel run, split the matrix instead: `/e2e-tests-google` takes
+Play, Amazon, Horizon, and VegaOS; `/e2e-tests-apple` takes iOS. Both read
+this file as the row authority.
+
 ## Scope
 
 Use the narrowest scope that satisfies the request, but broaden when native
@@ -482,14 +486,16 @@ FireOS/Amazon Android path:
 
 ```bash
 cd libraries/expo-iap/example
-EXPO_IAP_FIREOS=1 bunx expo prebuild --platform android --clean
+bunx expo prebuild --platform android --clean
 cd android
-variant_report="$(./gradlew :app:dependencyInsight \
+# The build follows the connected device; the inline pin keeps a build-only run
+# exact without leaking into the next row.
+variant_report="$(ORG_GRADLE_PROJECT_openiapStore=amazon ./gradlew :app:dependencyInsight \
   --configuration debugRuntimeClasspath --dependency openiap-google)"
 printf '%s\n' "$variant_report" | grep -F 'Variant amazonDebugRuntimeElements'
 printf '%s\n' "$variant_report" | \
   grep -E 'ProductFlavor:platform[[:space:]]+\| amazon'
-./gradlew :app:assembleDebug
+ORG_GRADLE_PROJECT_openiapStore=amazon ./gradlew :app:assembleDebug
 # Build-only regression can stop here.
 : "${FIREOS_SERIAL:?Set FIREOS_SERIAL to the target FireOS device serial}"
 adb -s "$FIREOS_SERIAL" install -r app/build/outputs/apk/debug/app-debug.apk
@@ -500,14 +506,16 @@ Horizon Android build and optional device path:
 
 ```bash
 cd libraries/expo-iap/example
-EXPO_IAP_HORIZON=1 bunx expo prebuild --platform android --clean
+bunx expo prebuild --platform android --clean
 cd android
-variant_report="$(./gradlew :app:dependencyInsight \
+# The build follows the connected device; the inline pin keeps a build-only run
+# exact without leaking into the next row.
+variant_report="$(ORG_GRADLE_PROJECT_openiapStore=horizon ./gradlew :app:dependencyInsight \
   --configuration debugRuntimeClasspath --dependency openiap-google)"
 printf '%s\n' "$variant_report" | grep -F 'Variant horizonDebugRuntimeElements'
 printf '%s\n' "$variant_report" | \
   grep -E 'ProductFlavor:platform[[:space:]]+\| horizon'
-./gradlew :app:assembleDebug
+ORG_GRADLE_PROJECT_openiapStore=horizon ./gradlew :app:assembleDebug
 # Build-only regression can stop here.
 : "${HORIZON_SERIAL:?Set HORIZON_SERIAL to the target Horizon device serial}"
 adb -s "$HORIZON_SERIAL" install -r app/build/outputs/apk/debug/app-debug.apk
@@ -579,7 +587,7 @@ FireOS/Amazon Android build and launch smoke:
 
 ```bash
 cd libraries/react-native-iap/example/android
-./gradlew :app:assembleDebug -PfireOsEnabled=true
+./gradlew :app:assembleDebug -PopeniapStore=amazon
 # Build-only regression can stop here.
 : "${FIREOS_SERIAL:?Set FIREOS_SERIAL to the target FireOS device serial}"
 adb -s "$FIREOS_SERIAL" install -r app/build/outputs/apk/debug/app-debug.apk
@@ -590,7 +598,7 @@ Horizon Android build-only path:
 
 ```bash
 cd libraries/react-native-iap/example/android
-./gradlew :app:assembleDebug -PhorizonEnabled=true
+./gradlew :app:assembleDebug -PopeniapStore=horizon
 ```
 
 Normal iOS physical-device build and launch smoke:
@@ -666,7 +674,7 @@ FireOS/Amazon Android build and launch smoke:
 
 ```bash
 cd libraries/flutter_inapp_purchase/example/android
-./gradlew :app:assembleDebug -PfireOsEnabled=true
+./gradlew :app:assembleDebug -PopeniapStore=amazon
 # Build-only regression can stop here.
 # Flutter redirects its gradle output to `example/build/app/outputs/flutter-apk/`,
 # so this path is not the `android/app/build/...` layout the other examples use.
@@ -679,7 +687,7 @@ Horizon Android build-only path:
 
 ```bash
 cd libraries/flutter_inapp_purchase/example/android
-./gradlew :app:assembleDebug -PhorizonEnabled=true
+./gradlew :app:assembleDebug -PopeniapStore=horizon
 ```
 
 iOS physical-device build and launch smoke:
@@ -770,101 +778,29 @@ dotnet build src/OpenIap.Maui/OpenIap.Maui.csproj -p:TargetFrameworks=net10.0 --
 dotnet build src/OpenIap.Maui/OpenIap.Maui.csproj -p:TargetFrameworks=net10.0-ios --nologo
 ```
 
-Normal Android / Play build and launch smoke:
+Android build and launch smoke. The library is the same for every store; the
+example build links one, from `OpenIapStore` or, on a Debug build, the device
+`ANDROID_SERIAL` names. Its `openiap: store=... (source=...)` line says which.
 
 ```bash
-# The MAUI-owned Android facade AAR output path is shared, so build it for the
-# requested store immediately before the matching dotnet build. The library
-# build disables ProjectReference rebuilds because the Android binding is built
-# explicitly first.
 cd libraries/maui-iap/android
-../../../packages/google/gradlew :openiap:assembleRelease -PopenIapAndroidStore=play
+../../../packages/google/gradlew :openiap:assembleRelease
 cd ..
-dotnet build-server shutdown || true
-rm -rf \
-  src/OpenIap.Maui.Bindings.Android/bin src/OpenIap.Maui.Bindings.Android/obj \
-  src/OpenIap.Maui/bin src/OpenIap.Maui/obj \
-  example/OpenIap.Maui.Example/bin example/OpenIap.Maui.Example/obj
-dotnet build src/OpenIap.Maui.Bindings.Android/OpenIap.Maui.Bindings.Android.csproj \
-  -p:TargetFrameworks=net10.0-android \
-  -p:OpenIapAndroidStore=play \
-  --nologo
-dotnet build src/OpenIap.Maui/OpenIap.Maui.csproj \
-  -p:TargetFrameworks=net10.0-android \
-  -p:OpenIapAndroidStore=play \
-  -p:BuildProjectReferences=false \
-  --nologo
+: "${ANDROID_SERIAL:?Set ANDROID_SERIAL to the Play, FireOS, or Horizon device}"
 dotnet build example/OpenIap.Maui.Example/OpenIap.Maui.Example.csproj \
-  -f net10.0-android \
-  -p:OpenIapAndroidStore=play \
+  -p:TargetFrameworks=net10.0-android \
   -p:EmbedAssembliesIntoApk=true \
   --nologo
 # Build-only regression can stop here.
-: "${ANDROID_SERIAL:?Set ANDROID_SERIAL to the target Android device serial}"
 adb -s "$ANDROID_SERIAL" uninstall dev.hyo.martie || true
 adb -s "$ANDROID_SERIAL" install --no-incremental -r \
   example/OpenIap.Maui.Example/bin/Debug/net10.0-android/dev.hyo.martie-Signed.apk
 adb -s "$ANDROID_SERIAL" shell monkey -p dev.hyo.martie 1
 ```
 
-FireOS/Amazon Android build and launch smoke:
-
-```bash
-cd libraries/maui-iap/android
-../../../packages/google/gradlew :openiap:assembleRelease -PopenIapAndroidStore=amazon
-cd ..
-dotnet build-server shutdown || true
-rm -rf \
-  src/OpenIap.Maui.Bindings.Android/bin src/OpenIap.Maui.Bindings.Android/obj \
-  src/OpenIap.Maui/bin src/OpenIap.Maui/obj \
-  example/OpenIap.Maui.Example/bin example/OpenIap.Maui.Example/obj
-dotnet build src/OpenIap.Maui.Bindings.Android/OpenIap.Maui.Bindings.Android.csproj \
-  -p:TargetFrameworks=net10.0-android \
-  -p:OpenIapAndroidStore=amazon \
-  --nologo
-dotnet build src/OpenIap.Maui/OpenIap.Maui.csproj \
-  -p:TargetFrameworks=net10.0-android \
-  -p:OpenIapAndroidStore=amazon \
-  -p:BuildProjectReferences=false \
-  --nologo
-dotnet build example/OpenIap.Maui.Example/OpenIap.Maui.Example.csproj \
-  -f net10.0-android \
-  -p:OpenIapAndroidStore=amazon \
-  -p:EmbedAssembliesIntoApk=true \
-  --nologo
-# Build-only regression can stop here.
-: "${FIREOS_SERIAL:?Set FIREOS_SERIAL to the target FireOS device serial}"
-adb -s "$FIREOS_SERIAL" uninstall dev.hyo.martie || true
-adb -s "$FIREOS_SERIAL" install --no-incremental -r \
-  example/OpenIap.Maui.Example/bin/stores/amazon/Debug/net10.0-android/dev.hyo.martie-Signed.apk
-adb -s "$FIREOS_SERIAL" shell monkey -p dev.hyo.martie 1
-```
-
-Horizon Android build-only path:
-
-```bash
-cd libraries/maui-iap/android
-../../../packages/google/gradlew :openiap:assembleRelease -PopenIapAndroidStore=horizon
-cd ..
-dotnet build-server shutdown || true
-rm -rf \
-  src/OpenIap.Maui.Bindings.Android/bin src/OpenIap.Maui.Bindings.Android/obj \
-  src/OpenIap.Maui/bin src/OpenIap.Maui/obj \
-  example/OpenIap.Maui.Example/bin example/OpenIap.Maui.Example/obj
-dotnet build src/OpenIap.Maui.Bindings.Android/OpenIap.Maui.Bindings.Android.csproj \
-  -p:TargetFrameworks=net10.0-android \
-  -p:OpenIapAndroidStore=horizon \
-  --nologo
-dotnet build src/OpenIap.Maui/OpenIap.Maui.csproj \
-  -p:TargetFrameworks=net10.0-android \
-  -p:OpenIapAndroidStore=horizon \
-  -p:BuildProjectReferences=false \
-  --nologo
-dotnet build example/OpenIap.Maui.Example/OpenIap.Maui.Example.csproj \
-  -f net10.0-android \
-  -p:OpenIapAndroidStore=horizon \
-  --nologo
-```
+Run it once per store device. Without a device, pin the store instead:
+`-p:OpenIapStore=horizon`. `bash scripts/verify-store-selection.sh` covers the
+selection rule itself without hardware.
 
 iOS physical-device build and launch smoke:
 
@@ -901,6 +837,11 @@ adb -s "$ANDROID_SERIAL" install -r Example/android/Martie.apk
 adb -s "$ANDROID_SERIAL" shell monkey -p dev.hyo.martie 1
 ```
 
+A headless Godot export runs `adb kill-server` on exit (editor setting
+`export/android/shutdown_adb_on_exit`, on by default). That drops every
+`adb reverse` rule and scrcpy session on every device, so re-create the
+`tcp:3100` rule before verifying, and export before the other Android rows.
+
 iOS build and launch smoke:
 
 ```bash

.claude/commands/verify-all.md

@@ -151,25 +151,18 @@ bun run audit:commerce-evidence || echo "commerce evidence differs from current
 (
   cd libraries/maui-iap
   DOTNET_BUILD_ARGS=(/m:1 /nr:false -p:UseSharedCompilation=false --nologo)
-  for store in play amazon horizon; do
-    dotnet build-server shutdown || true
-    rm -rf \
-      src/OpenIap.Maui.Bindings.Android/bin \
-      src/OpenIap.Maui.Bindings.Android/obj
-    (cd android && ../../../packages/google/gradlew \
-      :openiap:assembleRelease -PopenIapAndroidStore="$store")
-    dotnet build \
-      src/OpenIap.Maui.Bindings.Android/OpenIap.Maui.Bindings.Android.csproj \
-      -p:TargetFrameworks=net10.0-android \
-      -p:OpenIapAndroidStore="$store" \
-      "${DOTNET_BUILD_ARGS[@]}"
-    dotnet build \
-      src/OpenIap.Maui/OpenIap.Maui.csproj \
-      -p:TargetFrameworks=net10.0-android \
-      -p:OpenIapAndroidStore="$store" \
-      -p:BuildProjectReferences=false \
-      "${DOTNET_BUILD_ARGS[@]}"
-  done
+  (cd android && ../../../packages/google/gradlew :openiap:assembleRelease)
+  dotnet build \
+    src/OpenIap.Maui.Bindings.Android/OpenIap.Maui.Bindings.Android.csproj \
+    -p:TargetFrameworks=net10.0-android \
+    "${DOTNET_BUILD_ARGS[@]}"
+  dotnet build \
+    src/OpenIap.Maui/OpenIap.Maui.csproj \
+    -p:TargetFrameworks=net10.0-android \
+    -p:BuildProjectReferences=false \
+    "${DOTNET_BUILD_ARGS[@]}"
+  # The app build picks the store; this checks every rule against a fake adb.
+  bash scripts/verify-store-selection.sh
 )
 
 # MAUI iOS/macCatalyst binding and platform library (requires xcodegen + MAUI workload)

.claude/skills/e2e-matrix-runner-apple/SKILL.md

@@ -0,0 +1,20 @@
+---
+name: e2e-matrix-runner-apple
+description: Run the Apple half of the OpenIAP device matrix — six frameworks plus the native package on iOS — on a physical iPhone and report one row per cell with evidence. Use when asked for iOS e2e or delegated hardware testing.
+---
+
+# E2E Matrix Runner Apple (Claude Code)
+
+The canonical procedure lives in
+`.codex/skills/e2e-matrix-runner-apple/SKILL.md`. Read that file first and
+follow it fully — the narrowed matrix, the parallel-run rules, and its
+references to the full skill's driving techniques and reporting contract are
+all defined there.
+
+## Claude Code notes
+
+- `.claude/commands/e2e-tests-apple.md` scopes this run;
+  `.claude/commands/e2e-tests.md` is the authority on what an individual row
+  means.
+- Prefer the repo's own scripts over ad-hoc commands, and run long builds in the
+  background so the session stays responsive.