Add RN hardcoded buyer identity E2E smoke

kyle-schellen · kyle-schellen · commit 29c2688d4b01 · 2026-06-30T12:25:31.000-03:00
diff --git a/e2e/README.md b/e2e/README.md
@@ -3,9 +3,9 @@
 This directory contains Maestro end-to-end smoke flows for Checkout Kit sample
 apps.
 
-The current runnable suite starts with React Native. It verifies a full guest
-checkout from a seeded cart in the sample app, through Shopify checkout, and
-back to the app after completion.
+The current runnable suite starts with React Native. It verifies full guest and
+hardcoded buyer identity checkouts from seeded carts, through Shopify checkout,
+and back to the app after completion.
 
 ## Run locally
 
@@ -28,20 +28,24 @@ dev rn e2e android
 
 The React Native commands start Metro if needed, build and launch the target
 sample app, then run Maestro. They require the standard storefront `.env` setup,
-but the E2E flow seeds its own cart through the bootstrap deep link; no manual
-sample cart setup is required.
+but the E2E flows seed their own carts through the bootstrap deep link. The
+React Native bootstrap link accepts `buyerIdentityMode`, so guest and hardcoded
+buyer identity scenarios share the same cart setup path. No manual sample cart
+setup is required.
 
 ## Files
 
 - `config.yaml` configures Maestro for shared platform behavior.
 - `flows/` contains reusable Maestro subflows for app setup and checkout steps.
-- `tests/react-native/full-guest-checkout.yaml` composes the React Native guest
+- `tests/react-native/checkout-guest.yaml` composes the React Native guest
   checkout smoke test from those subflows.
+- `tests/react-native/checkout-hardcoded-buyer-identity.yaml` verifies checkout
+  from a bootstrapped cart with hardcoded buyer identity.
 
 ## Scope
 
 This smoke flow is intended to catch regressions in the React Native sample app
-integration surface: cart bootstrap, checkout presentation, checkout
-completion, and return to the sample app. It is not a replacement for
-checkout-web's browser-based coverage or for future native Swift and Android
-sample-app E2E coverage.
+integration surface: cart bootstrap, buyer identity configuration, checkout
+presentation, checkout completion, and return to the sample app. It is not a
+replacement for checkout-web's browser-based coverage or for future native
+Swift and Android sample-app E2E coverage.
diff --git a/e2e/config.yaml b/e2e/config.yaml
@@ -1,5 +1,5 @@
 flows:
-  - tests/**/*.yaml
+  - tests/react-native/*.yaml
 
 platform:
   ios:
diff --git a/e2e/flows/app/bootstrap-cart-from-link.yaml b/e2e/flows/app/bootstrap-cart-from-link.yaml
@@ -9,9 +9,9 @@ appId: ${APP_ID}
 # Reset app data before testing the deep-link cold-start path. The app is
 # stopped so openLink is the launch that seeds the cart.
 - stopApp
-- openLink: "${CART_BOOTSTRAP_LINK}"
+- openLink: "${CART_BOOTSTRAP_BASE_LINK}&buyerIdentityMode=${BUYER_IDENTITY_MODE}"
 - waitForAnimationToEnd
 - extendedWaitUntil:
     visible:
       id: checkout-button
-    timeout: 30000
+    timeout: 10000
diff --git a/e2e/flows/app/dismiss-dev-warning.yaml b/e2e/flows/app/dismiss-dev-warning.yaml
@@ -0,0 +1,9 @@
+appId: ${APP_ID}
+---
+- runFlow:
+    when:
+      visible: "Open debugger to view warnings."
+    commands:
+      - tapOn:
+          point: "92%,92%"
+      - waitForAnimationToEnd
diff --git a/e2e/flows/app/launch.yaml b/e2e/flows/app/launch.yaml
@@ -10,3 +10,4 @@ appId: ${APP_ID}
     visible:
       id: checkout-kit-sample-ready
     timeout: 10000
+- runFlow: dismiss-dev-warning.yaml
diff --git a/e2e/flows/app/select-buyer-identity.yaml b/e2e/flows/app/select-buyer-identity.yaml
@@ -0,0 +1,20 @@
+appId: ${APP_ID}
+---
+- tapOn:
+    id: settings-tab
+- waitForAnimationToEnd
+- runFlow:
+    when:
+      notVisible:
+        id: settings-section-authentication
+    commands:
+      - tapOn:
+          id: settings-tab
+      - waitForAnimationToEnd
+- extendedWaitUntil:
+    visible:
+      id: settings-section-authentication
+    timeout: 10000
+- tapOn:
+    id: "settings-buyer-identity-option-${BUYER_IDENTITY_MODE}"
+- waitForAnimationToEnd
diff --git a/e2e/flows/checkout/present.yaml b/e2e/flows/checkout/present.yaml
@@ -5,5 +5,5 @@ appId: ${APP_ID}
     enabled: true
 - extendedWaitUntil:
     visible:
-      text: "^Email( or mobile phone number)?$"
+      text: "^(Email( or mobile phone number)?|Delivery|Card number)$"
     timeout: 10000
diff --git a/e2e/tests/react-native/checkout-guest.yaml b/e2e/tests/react-native/checkout-guest.yaml
@@ -1,7 +1,10 @@
 appId: ${APP_ID}
-name: React Native full guest checkout
+name: React Native checkout - guest
 
 env:
+  # Sample app buyer identity configuration
+  BUYER_IDENTITY_MODE: "guest"
+
   # Checkout contact fixture
   EMAIL: "maestro.e2e@shopify.com"
   FIRST_NAME: "Maestro"
diff --git a/e2e/tests/react-native/checkout-hardcoded-buyer-identity.yaml b/e2e/tests/react-native/checkout-hardcoded-buyer-identity.yaml
@@ -0,0 +1,20 @@
+appId: ${APP_ID}
+name: React Native checkout - hardcoded buyer identity
+
+env:
+  # Sample app buyer identity configuration
+  BUYER_IDENTITY_MODE: "hardcoded"
+
+  # Checkout payment fixture
+  CARD_NUMBER: "1"
+  CARD_SECURITY_CODE: "123"
+
+  # Accepted successful checkout states for this smoke test.
+  POST_SUBMIT_RESULT_PATTERN: ".*(Thank you|Your order|Order confirmed|confirmation).*"
+---
+- runFlow: ../../flows/app/bootstrap-cart-from-link.yaml
+- runFlow: ../../flows/checkout/present.yaml
+- runFlow: ../../flows/checkout/fill-payment-card.yaml
+- runFlow: ../../flows/checkout/submit.yaml
+- runFlow: ../../flows/checkout/assert-complete.yaml
+- runFlow: ../../flows/checkout/assert-returned-to-empty-cart.yaml
diff --git a/platforms/react-native/sample/src/context/Cart.tsx b/platforms/react-native/sample/src/context/Cart.tsx
@@ -22,10 +22,19 @@ interface Context {
   addingToCart: Set<string>;
   clearCart: () => void;
   addToCart: (variantId: string, quantity?: number) => Promise<void>;
-  seedCart: (variantId: string, quantity?: number) => Promise<void>;
+  seedCart: (
+    variantId: string,
+    quantity?: number,
+    buyerIdentityMode?: BuyerIdentityMode,
+  ) => Promise<void>;
   removeFromCart: (variantId: string) => Promise<void>;
 }
 
+type AddToCartOptions = {
+  forceNewCart?: boolean;
+  buyerIdentityMode?: BuyerIdentityMode;
+};
+
 const defaultCartId = undefined;
 const defaultCheckoutURL = undefined;
 const defaultTotalQuantity = 0;
@@ -114,19 +123,30 @@ export const CartProvider: React.FC<PropsWithChildren> = ({children}) => {
   }, [cartId, fetchCart, setTotalQuantity]);
 
   const addToCart = useCallback(
-    async (variantId: string, quantity = 1, forceNewCart = false) => {
+    async (
+      variantId: string,
+      quantity = 1,
+      {
+        forceNewCart = false,
+        buyerIdentityMode = appConfig.buyerIdentityMode,
+      }: AddToCartOptions = {},
+    ) => {
       if (!Number.isInteger(quantity) || quantity < 1) {
         throw new Error('Cart quantity must be a positive integer');
       }
 
       let id = forceNewCart ? undefined : cartId;
+      const cartAppConfig = {
+        ...appConfig,
+        buyerIdentityMode,
+      };
 
       dispatch({type: 'add', variantId});
 
       try {
         if (
           !id &&
-          appConfig.buyerIdentityMode === BuyerIdentityMode.CustomerAccount &&
+          buyerIdentityMode === BuyerIdentityMode.CustomerAccount &&
           !isAuthenticated
         ) {
           const signInRequiredMessage =
@@ -144,14 +164,11 @@ export const CartProvider: React.FC<PropsWithChildren> = ({children}) => {
 
         if (!id) {
           let customerAccessToken: string | undefined;
-          if (
-            appConfig.buyerIdentityMode === BuyerIdentityMode.CustomerAccount
-          ) {
-            customerAccessToken =
-              (await getValidAccessToken()) ?? undefined;
+          if (buyerIdentityMode === BuyerIdentityMode.CustomerAccount) {
+            customerAccessToken = (await getValidAccessToken()) ?? undefined;
           }
           const cartInput = createBuyerIdentityCartInput(
-            appConfig,
+            cartAppConfig,
             customerAccessToken,
           );
           const cart = await createCart({variables: {input: cartInput}});
@@ -198,8 +215,15 @@ export const CartProvider: React.FC<PropsWithChildren> = ({children}) => {
   );
 
   const seedCart = useCallback(
-    async (variantId: string, quantity = 1) => {
-      await addToCart(variantId, quantity, true);
+    async (
+      variantId: string,
+      quantity = 1,
+      buyerIdentityMode?: BuyerIdentityMode,
+    ) => {
+      await addToCart(variantId, quantity, {
+        forceNewCart: true,
+        buyerIdentityMode,
+      });
     },
     [addToCart],
   );
diff --git a/platforms/react-native/sample/src/hooks/useE2ECartBootstrap.ts b/platforms/react-native/sample/src/hooks/useE2ECartBootstrap.ts
@@ -15,9 +15,7 @@ function errorMessage(error: unknown) {
   return error instanceof Error ? error.message : 'Unknown error';
 }
 
-export function useE2ECartBootstrap({
-  onCartReady,
-}: UseE2ECartBootstrapOptions) {
+export function useE2ECartBootstrap({onCartReady}: UseE2ECartBootstrapOptions) {
   const {seedCart} = useCart();
   const {queries} = useShopify();
   const [fetchProducts] = queries.products;
@@ -52,7 +50,11 @@ export function useE2ECartBootstrap({
           throw new Error('Cart bootstrap product variant was not found');
         }
 
-        await seedCart(variantId, cartBootstrapLink.quantity);
+        await seedCart(
+          variantId,
+          cartBootstrapLink.quantity,
+          cartBootstrapLink.buyerIdentityMode,
+        );
         onCartReady();
       } catch (error) {
         Alert.alert('Cart bootstrap failed', errorMessage(error));
diff --git a/platforms/react-native/sample/src/linking/__tests__/cartBootstrap.test.ts b/platforms/react-native/sample/src/linking/__tests__/cartBootstrap.test.ts
@@ -1,7 +1,5 @@
-import {
-  CART_BOOTSTRAP_ROUTE,
-  parseCartBootstrapLink,
-} from '../cartBootstrap';
+import {CART_BOOTSTRAP_ROUTE, parseCartBootstrapLink} from '../cartBootstrap';
+import {BuyerIdentityMode} from '../../auth/types';
 
 describe('parseCartBootstrapLink', () => {
   it('ignores non-cart-bootstrap URLs', () => {
@@ -58,6 +56,19 @@ describe('parseCartBootstrapLink', () => {
     },
   );
 
+  it.each(['', 'member'])(
+    'rejects invalid buyerIdentityMode %s',
+    buyerIdentityMode => {
+      expect(() =>
+        parseCartBootstrapLink(
+          `${CART_BOOTSTRAP_ROUTE}?productIndex=0&buyerIdentityMode=${buyerIdentityMode}`,
+        ),
+      ).toThrow(
+        'buyerIdentityMode must be guest, hardcoded, or customerAccount',
+      );
+    },
+  );
+
   it('returns a variantId bootstrap link', () => {
     expect(
       parseCartBootstrapLink(
@@ -71,10 +82,13 @@ describe('parseCartBootstrapLink', () => {
 
   it('returns a productIndex bootstrap link with default quantity', () => {
     expect(
-      parseCartBootstrapLink(`${CART_BOOTSTRAP_ROUTE}?productIndex=3`),
+      parseCartBootstrapLink(
+        `${CART_BOOTSTRAP_ROUTE}?productIndex=3&buyerIdentityMode=hardcoded`,
+      ),
     ).toEqual({
       productIndex: 3,
       quantity: 1,
+      buyerIdentityMode: BuyerIdentityMode.Hardcoded,
     });
   });
 
diff --git a/platforms/react-native/sample/src/linking/cartBootstrap.ts b/platforms/react-native/sample/src/linking/cartBootstrap.ts
@@ -1,3 +1,5 @@
+import {BuyerIdentityMode} from '../auth/types';
+
 export const CART_BOOTSTRAP_SCHEME = 'com.shopify.checkoutkit.reactnativedemo:';
 const CART_BOOTSTRAP_HOST = 'cart';
 export const CART_BOOTSTRAP_ROUTE = `${CART_BOOTSTRAP_SCHEME}//cart`;
@@ -8,8 +10,13 @@ export type CartBootstrapLink = {
   variantId?: string;
   productIndex?: number;
   quantity: number;
+  buyerIdentityMode?: BuyerIdentityMode;
 };
 
+function isBuyerIdentityMode(value: string): value is BuyerIdentityMode {
+  return Object.values(BuyerIdentityMode).includes(value as BuyerIdentityMode);
+}
+
 export function parseCartBootstrapLink(url: string): CartBootstrapLink | null {
   if (!url.startsWith(CART_BOOTSTRAP_SCHEME)) {
     return null;
@@ -51,6 +58,8 @@ export function parseCartBootstrapLink(url: string): CartBootstrapLink | null {
   const searchParams = parsedUrl.searchParams;
   const variantId = searchParams.get('variantId')?.trim();
   const productIndexParam = searchParams.get('productIndex')?.trim();
+  const buyerIdentityModeParam = searchParams.get('buyerIdentityMode')?.trim();
+  let buyerIdentityMode: BuyerIdentityMode | undefined;
 
   const quantityParam = searchParams.get('quantity') ?? '1';
   const quantity = Number(quantityParam);
@@ -59,12 +68,25 @@ export function parseCartBootstrapLink(url: string): CartBootstrapLink | null {
     throw new Error('quantity must be a positive integer');
   }
 
+  if (searchParams.has('buyerIdentityMode')) {
+    if (
+      !buyerIdentityModeParam ||
+      !isBuyerIdentityMode(buyerIdentityModeParam)
+    ) {
+      throw new Error(
+        'buyerIdentityMode must be guest, hardcoded, or customerAccount',
+      );
+    }
+
+    buyerIdentityMode = buyerIdentityModeParam;
+  }
+
   if (variantId && productIndexParam) {
     throw new Error('Use variantId or productIndex, not both');
   }
 
   if (variantId) {
-    return {variantId, quantity};
+    return {variantId, quantity, buyerIdentityMode};
   }
 
   if (!productIndexParam) {
@@ -77,5 +99,5 @@ export function parseCartBootstrapLink(url: string): CartBootstrapLink | null {
     throw new Error('productIndex must be a non-negative integer');
   }
 
-  return {productIndex, quantity};
+  return {productIndex, quantity, buyerIdentityMode};
 }
diff --git a/platforms/react-native/scripts/e2e_maestro_android b/platforms/react-native/scripts/e2e_maestro_android
@@ -4,10 +4,11 @@ set -euo pipefail
 
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 ROOT_DIR="$(cd "$SCRIPT_DIR/.." && pwd)"
+REPO_ROOT="$(cd "$ROOT_DIR/../.." && pwd)"
 METRO_LOG="${TMPDIR:-/tmp}/checkout-kit-rn-android-metro.log"
 METRO_PID=""
 APP_ID="com.shopify.checkoutkit.reactnativedemo"
-CART_BOOTSTRAP_LINK="${APP_ID}://cart?productIndex=0&quantity=1"
+CART_BOOTSTRAP_BASE_LINK="${APP_ID}://cart?productIndex=0&quantity=1"
 
 metro_running() {
   curl --silent --fail http://localhost:8081/status | grep -q "packager-status:running"
@@ -52,7 +53,10 @@ fi
 
 wait_for_metro
 pnpm sample android --local --extra-params "--refresh-dependencies"
-maestro --platform android test --config ../../e2e/config.yaml \
-  -e "APP_ID=${APP_ID}" \
-  -e "CART_BOOTSTRAP_LINK=${CART_BOOTSTRAP_LINK}" \
-  ../../e2e/tests/react-native/full-guest-checkout.yaml
+(
+  cd "$REPO_ROOT/e2e"
+  maestro --platform android test --config config.yaml \
+    -e "APP_ID=${APP_ID}" \
+    -e "CART_BOOTSTRAP_BASE_LINK=${CART_BOOTSTRAP_BASE_LINK}" \
+    .
+)
diff --git a/platforms/react-native/scripts/e2e_maestro_ios b/platforms/react-native/scripts/e2e_maestro_ios
