Add the E2E control link parser to all four sample apps

[kieran-osgood-shopify]

What changes are you making?

One core file added for each platform E2EControlLink - parses an incoming deep link into a types argument

The extra changes in react-native are because we already started a host cart and this PR supercedes that pattern with e2e as a root host that handles multiple commands

Why

To keep the end to end test running quickly and without wasting time validating sample app logic as such, which we've opted for a deep link scheme that can prepare some state for us such as cart and products

maestro commands will be something like this rather than a dozen steps to get the cart prepped and move to CartView

- openLink: 'com.shopify.checkout_kit_android_demo://products/1'

How

The shape is <app-scheme>://e2e/<command>?<parameters>, where the scheme is the app id.
This PR adds one parser per platform that turns such a link into a typed command
We use a common e2e host on every command, so one intent-filter and one CFBundleURLScheme cover all of them (if you look at the AndroidManifest we use a single host, rather than having n entries per command.
A malformed control link throws, so a typo in a flow fails the test instead of passing silently.
The parsers accept identical input on all platforms.

Command	Parameters	Effect
reset	none	clear app state
cart	variantId or productIndex, plus quantity and buyerIdentityMode	seed the cart with one line item
signIn	optional email	start sign-in, pre-filled

Note: If you're familiar with maestro you might be wondering why I opted for a reset deep link here, theres a bug in the browserstack integration here, clearState is a command in maestro that achieves it by uninstalling and reinstalling the app, in browserstack it reports a success but fails to reinstall the app, which led to broken tests.

Whats Next

Wiring the parsers into each app is the next PR in the stack.

Before you merge

Important

• I've added tests to support my implementation
• I have read and agree with the Contribution Guidelines
• I have read and agree with the Code of Conduct
• I've updated the relevant platform README (platforms/swift/README.md and/or platforms/android/README.md)

---

Releasing a new Swift version?

• I have bumped the version in ShopifyCheckoutKit.podspec
• I have bumped the version in platforms/swift/Sources/ShopifyCheckoutKit/ShopifyCheckoutKit.swift
• I have updated the SwiftPM/CocoaPods version snippets in platforms/swift/README.md (major version only)

Releasing a new Embedded Checkout Protocol version?

• I have bumped embeddedCheckoutProtocolAndroid in platforms/android/gradle/libs.versions.toml
• I have updated protocol/languages/kotlin/embedded-checkout-protocol/api/embedded-checkout-protocol.api if the public API changed

Releasing a new Android version?

• I have bumped checkoutKitAndroid in platforms/android/gradle/libs.versions.toml
• I have updated the Gradle/Maven version snippets in platforms/android/README.md

Tip

See the Contributing documentation for the full release process per platform.

[kieran-osgood-shopify]

• Promote checkout-guest to run on Swift/Kotlin #561 : 3 dependent PRs (#562 , #580 , #599 )
• Promote cart-hardcoded-buyer-identity test to run on swift/kotlin #560
• feat(e2e): add the present-and-close checkout test on all four targets #559
• Add local maestro runner - Run cart control-link on kotlin/swift #558
• Replace the E2E suite cross product with Maestro tags in CI #557
• feat(e2e): select tests by Maestro tag instead of scenario flags #556
• feat(e2e): add an E2EController to each sample app #555
• Add the E2E control link parser to all four sample apps #554 👈 (View in Graphite)
• Add sample app test seams and run them in CI #553
• main

This stack of pull requests is managed by Graphite. Learn more about stacking.

[github-actions]

React Native — Coverage Report

Lines	Statements	Branches	Functions
	91.64% (307/335)	88.88% (176/198)	100% (81/81)

[github-actions]

Package Size

Platform	Artifact	Base	Head	Delta
React Native	npm tarball	101.6 KiB	101.6 KiB	0 B
Android	release AAR	273.6 KiB	273.6 KiB	0 B

React Native file breakdown

File	Base	Head	Delta
node_modules/@shopify/checkout-kit-protocol/src/generated/Models.ts	85.4 KiB	85.4 KiB	0 B
node_modules/@shopify/checkout-kit-protocol/src/generated/Models.d.ts	53.0 KiB	53.0 KiB	0 B
ios/AcceleratedCheckoutButtons.swift	14.1 KiB	14.1 KiB	0 B
ios/ShopifyCheckoutKit.swift	13.5 KiB	13.5 KiB	0 B
src/components/AcceleratedCheckoutButtons.tsx	13.0 KiB	13.0 KiB	0 B
android/src/main/java/com/shopify/reactnative/checkoutkit/ShopifyCheckoutKitModule.java	12.8 KiB	12.8 KiB	0 B
lib/commonjs/index.js	12.3 KiB	12.3 KiB	0 B
src/index.ts	12.2 KiB	12.2 KiB	0 B
lib/commonjs/components/AcceleratedCheckoutButtons.js	11.4 KiB	11.4 KiB	0 B
lib/commonjs/components/AcceleratedCheckoutButtons.js.map	10.4 KiB	10.4 KiB	0 B
lib/module/components/AcceleratedCheckoutButtons.js	10.2 KiB	10.2 KiB	0 B
lib/module/index.js	10.2 KiB	10.2 KiB	0 B
node_modules/@shopify/checkout-kit-protocol/src/generated/ProtocolNotifications.ts	9.5 KiB	9.5 KiB	0 B
src/index.d.ts	9.1 KiB	9.1 KiB	0 B
lib/module/components/AcceleratedCheckoutButtons.js.map	9.1 KiB	9.1 KiB	0 B
src/present-dispatcher.ts	8.0 KiB	8.0 KiB	0 B
lib/module/index.js.map	7.9 KiB	7.9 KiB	0 B
lib/commonjs/index.js.map	7.7 KiB	7.7 KiB	0 B
node_modules/@shopify/checkout-kit-protocol/src/generated/ProtocolNotifications.d.ts	7.6 KiB	7.6 KiB	0 B
node_modules/@shopify/checkout-kit-protocol/src/generated/ProtocolRenameMap.ts	7.2 KiB	7.2 KiB	0 B
…and 110 smaller files

Android file breakdown

File	Base	Head	Delta
classes.jar	289.5 KiB	289.5 KiB	0 B
res/layout/checkout_view_content.xml	2.3 KiB	2.3 KiB	0 B
res/layout/checkout_sheet_content.xml	2.0 KiB	2.0 KiB	0 B
res/values/values.xml	1.2 KiB	1.2 KiB	0 B
R.txt	1.1 KiB	1.1 KiB	0 B
proguard.txt	798 B	798 B	0 B
AndroidManifest.xml	578 B	578 B	0 B
res/drawable/close.xml	431 B	431 B	0 B
res/menu/checkout_menu.xml	354 B	354 B	0 B
META-INF/com/android/build/gradle/aar-metadata.properties	157 B	157 B	0 B

Measured from the PR base SHA and PR head SHA. The file breakdown shows uncompressed sizes within each package artifact, so individual files do not sum to the compressed artifact total. This comment reports package artifact sizes only; it is not a final app binary-size report.

[bitrise]

Install this build

Open Tophat, select your target device, then click Install. Links open on the Mac running Tophat.

SDK	Install
React Native	Install with Tophat
Swift	Install with Tophat
Kotlin	Install with Tophat

Checkout Kit E2E results

Status	Suite	Target	Platform	OS version tag	Device
✅	tests/shared/launch-smoke.yaml	react-native	ios	latest	iPhone 15 iOS 27 Beta
✅	tests/shared/launch-smoke.yaml	react-native	android	latest	Google Pixel 9 Android 17.0
✅	tests/shared/launch-smoke.yaml	kotlin	android	latest	Google Pixel 9 Android 17.0
✅	tests/shared/launch-smoke.yaml	swift	ios	latest	iPhone 15 iOS 27 Beta

[kyle-schellen]

Just left a small non-blocking question

[kyle-schellen]

Should we reserve null for non-E2E links and throw for malformed E2E URLs instead? Might be stricter than we need today, but it would keep those cases distinct if we need clearer control-link diagnostics later.

If we do want that distinction, it’s probably worth keeping the Android, Swift, and React Native parsers aligned.

[kieran-osgood-shopify]

I think I'll leave it to later if the time comes we need that