feat: update maestro tests to match iOS V2 paywall flow and add confirm_purchase utility

Update purchase_through_paywall.yaml to assert Paywall V2, tap Yearly/Continue
(matching purchases-ios), and add utils/confirm_purchase.yaml with conditional
flows for iOS (app_store) and Android (test_store) purchase confirmation.

Made-with: Cursor

Author: ajpallares

e2e-tests/maestro/e2e_tests/purchase_through_paywall.yaml

@@ -1,8 +1,9 @@
-# This flow tests the purchase through paywall flow.
-# It navigates to the purchase screen, verifies initial entitlements,
-# presents the paywall, makes a purchase, and verifies entitlements update.
+# This flow requires passing the MAESTRO_STORE environment variable.
+#  app_store for iOS, test_store for Android.
+# Example:
+# maestro test -e MAESTRO_STORE=app_store purchase_through_paywall.yaml
 
-appId: com.revenuecat.maestro.e2e
+appId: com.revenuecat.automatedsdktests
 name: Purchase through paywall
 
 ---
@@ -22,22 +23,18 @@ name: Purchase through paywall
 - assertVisible: "Present Paywall"
 - tapOn:
     text: "Present Paywall"
-# Wait for paywall to load
-- extendedWaitUntil:
-    visible: "Subscribe"
-    timeout: 30000
+- assertVisible: "Paywall V2"
+- takeScreenshot: "purchase_through_paywall - Paywall"
 - tapOn:
-    text: "Subscribe"
-# Handle StoreKit purchase confirmation on iOS simulator
-- extendedWaitUntil:
-    visible: "OK"
-    timeout: 15000
-- waitForAnimationToEnd
+    text: "Yearly"
 - tapOn:
-    text: "OK"
-# Verify entitlements updated after purchase
+    text: "Continue"
+- runFlow:
+    file: ../utils/confirm_purchase.yaml
+    env:
+      SCREENSHOT_PREFIX: purchase_through_paywall
 - extendedWaitUntil:
     visible: "Entitlements: pro"
     timeout: 15000
 - assertVisible: "Entitlements: pro"
-- takeScreenshot: "purchase_through_paywall_completed"
+- takeScreenshot: "purchase_through_paywall - completed"

e2e-tests/maestro/utils/confirm_purchase.yaml

@@ -0,0 +1,42 @@
+# This flow requires passing some parameters:
+#  MAESTRO_STORE environment variable. app_store or test_store.
+#  SCREENSHOT_PREFIX environment variable. Used to prefix the screenshot name.
+# Example:
+# maestro test -e MAESTRO_STORE=app_store -e SCREENSHOT_PREFIX=purchase_through_paywall confirm_purchase.yaml
+
+appId: com.revenuecat.automatedsdktests
+name: Confirm purchase - handles both IAP Sheet and Test Store Purchase Alert
+env:
+  MAESTRO_STORE: ${MAESTRO_STORE || 'app_store'}
+
+---
+# Validate MAESTRO_STORE parameter - fail if invalid
+- assertTrue:
+    condition: ${MAESTRO_STORE == 'app_store' || MAESTRO_STORE == 'test_store'}
+    label: "MAESTRO_STORE is set to ${MAESTRO_STORE}, but expected app_store or test_store"
+
+# Handle Test Store Purchase Alert flow (Android)
+- runFlow:
+    when:
+      true: ${MAESTRO_STORE == 'test_store'}
+    commands:
+      - takeScreenshot: "${SCREENSHOT_PREFIX} - Test Store Purchase Alert"
+      - assertVisible: "Test purchase"
+      - tapOn:
+          text: "Test valid purchase"
+
+# Handle regular IAP Sheet flow (iOS)
+- runFlow:
+    when:
+      true: ${MAESTRO_STORE == 'app_store'}
+    commands:
+      - takeScreenshot: "${SCREENSHOT_PREFIX} - IAP Sheet"
+      - tapOn:
+          text: "Subscribe"
+      - takeScreenshot: "${SCREENSHOT_PREFIX} - IAP Confirmation"
+      - extendedWaitUntil:
+          visible: "OK"
+          timeout: 15000
+      - waitForAnimationToEnd
+      - tapOn:
+          text: "OK"