React Native: adopt native checkout lifecycle events

[markmur]

Replace raw protocol callbacks with onStart, onUpdate, onComplete, onFail, and onDismiss for checkout sheets and accelerated buttons. Events expose Kit checkout snapshots through the shared schema-aware decoder, and completion keeps observations alive until dismissal or failure.

The latest presentation owns subscriptions across ShopifyCheckout instances. Both native bridges keep closing sessions separate from new requests and bound the wait for dismissal to five seconds. Android also cancels queued presentations after module invalidation. The sample clears completed carts on dismissal or failure.

Pin Swift to 4.0.0-alpha.7 and Android to 4.0.0-alpha.8, update published CocoaPods lockfiles, remove the public protocol handler API, and document the migration. Link opening uses native defaults; explicit link policy is added in the next PR.

Stack

• React Native: add explicit checkout link handling #921
• React Native: adopt native checkout lifecycle events #829
• React Native: isolate presentation subscription cleanup #920
• Protocol: decode checkout snapshots without protocol metadata #919

[markmur]

Three implementation notes for reviewers.

[markmur]

The native SDK needs an immediate link decision, so linkAction is chosen before presentation. onLinkClick is an asynchronous notification; returning a value from JS cannot change the native action.

[markmur]

Completion keeps the subscription alive while the confirmation page remains visible. Dismissal and failure clean up before invoking app code, allowing those callbacks to safely present another checkout.

[markmur]

Kit snapshots omit protocol metadata but still need schema-aware decoding. This converts known fields such as line_items to lineItems while preserving arbitrary extension keys and values.

[github-actions]

Protocol — Coverage Report

Lines	Statements	Branches	Functions
	88.26% (158/179)	86.29% (107/124)	85.71% (30/35)

[github-actions]

React Native — Coverage Report

Lines	Statements	Branches	Functions
	93.98% (297/316)	87.62% (177/202)	100% (77/77)

[github-actions]

Web — Coverage Report

Lines	Statements	Branches	Functions
	95.16% (374/393)	84.32% (199/236)	97.08% (100/103)

[github-actions]

Bundle Size Budgets

Budget	Size	Limits	Result
React Native npm package (gzip)	113.66 KiB (-6.93 KiB)	130 KiB soft / 150 KiB hard	✅ Within budget

Bundle and package size

Web bundle sizes cover shipped runtime JavaScript. Package sizes cover the full published archive, including any source maps, declarations, and documentation it contains.

Platform	Measurement	Compression	Base	Head	Delta
React Native	npm package (.tgz)	gzip	120.6 KiB	113.7 KiB	-6.9 KiB

React Native package files (uncompressed)

These are uncompressed file sizes; they do not sum to the compressed package size above.

File	Base	Head	Delta
node_modules/@shopify/checkout-kit-protocol/src/generated/Models.ts	108.7 KiB	108.7 KiB	0 B
node_modules/@shopify/checkout-kit-protocol/src/generated/Models.d.ts	73.1 KiB	73.1 KiB	0 B
android/src/main/java/com/shopify/reactnative/checkoutkit/ShopifyCheckoutKitModule.java	16.2 KiB	18.2 KiB	+2.0 KiB
ios/ShopifyCheckoutKit.swift	16.1 KiB	15.6 KiB	-535 B
ios/AcceleratedCheckoutButtons.swift	14.1 KiB	14.3 KiB	+255 B
src/index.ts	13.1 KiB	12.6 KiB	-506 B
src/components/AcceleratedCheckoutButtons.tsx	13.0 KiB	6.9 KiB	-6.1 KiB
lib/commonjs/index.js	12.8 KiB	12.3 KiB	-516 B
lib/commonjs/components/AcceleratedCheckoutButtons.js	11.4 KiB	6.8 KiB	-4.7 KiB
src/index.d.ts	11.3 KiB	10.6 KiB	-752 B
lib/module/index.js	10.8 KiB	10.4 KiB	-401 B
lib/commonjs/components/AcceleratedCheckoutButtons.js.map	10.4 KiB	5.8 KiB	-4.6 KiB
lib/module/components/AcceleratedCheckoutButtons.js	10.2 KiB	5.6 KiB	-4.7 KiB
node_modules/@shopify/checkout-kit-protocol/src/generated/ProtocolNotifications.ts	9.5 KiB	9.5 KiB	0 B
lib/module/components/AcceleratedCheckoutButtons.js.map	9.1 KiB	4.5 KiB	-4.7 KiB
lib/module/index.js.map	8.5 KiB	8.5 KiB	-37 B
lib/commonjs/index.js.map	8.3 KiB	8.3 KiB	-17 B
src/present-dispatcher.ts	8.2 KiB	4.0 KiB	-4.2 KiB
node_modules/@shopify/checkout-kit-protocol/src/protocol_codec_runtime.ts	7.9 KiB	7.9 KiB	0 B
node_modules/@shopify/checkout-kit-protocol/src/generated/ProtocolRenameMap.ts	7.8 KiB	7.8 KiB	0 B
…and 126 smaller files

How sizes are measured

Measured from the PR base SHA and PR head SHA. Web bundle rows sum shipped .js, .mjs, and .cjs files under dist/, excluding source maps and declarations. The gzip bundle size sums files compressed individually with gzip -n -9. npm package sizes are gzip-compressed .tgz archives; Android AAR sizes are ZIP archives. Package sizes are not final app binary sizes.

[bitrise]

Bitrise builds

E2E · iOS CI

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

Checkout Kit E2E results

Status	Tags	Target	Platform	OS version tag	Device
✅	launch, checkout-presentation, checkout-completion, buyer-identity	react-native	ios	latest	iPhone 15 iOS 27 Beta
✅	launch, checkout-presentation, checkout-completion, buyer-identity	react-native	android	latest	Google Pixel 9 Android 17.0

[tiagocandido]

iOS E2E is failing on all four React Native flows (launch, present/close, guest, buyer identity), while Android passes. Do you know if that is related to this change?