framepayments-react-native 2.2.0 → 3.0.0

package/FrameReactNative.podspec

@@ -0,0 +1,44 @@
+require 'json'
+
+package = JSON.parse(File.read(File.join(__dir__, 'package.json')))
+
+Pod::Spec.new do |s|
+  s.name         = 'FrameReactNative'
+  s.version      = package['version']
+  s.summary      = package['description']
+  s.homepage     = package['homepage']
+  s.license      = package['license']
+  s.authors      = package['author']
+  s.platforms    = { :ios => '17.0' }
+  s.source       = { :git => package['repository']['url'], :tag => "#{s.version}" }
+  s.source_files = 'ios/**/*.{h,m,mm,swift}'
+  s.requires_arc = true
+
+  # static_framework exposes the pod's generated `FrameReactNative-Swift.h` to
+  # consumers — required so host AppDelegate.mm can `#import <FrameReactNative/FrameReactNative-Swift.h>`
+  # to reach `FramePreloader`.
+  s.static_framework = true
+
+  s.dependency 'React-Core'
+
+  # Autolink Frame-iOS (SPM-only) via RN 0.81+'s Podfile SPM hook. spm.rb injects
+  # XCRemoteSwiftPackageReferences into Pods.xcodeproj at react_native_post_install;
+  # consumers get Frame-iOS + Frame-Onboarding resolved by `pod install` alone.
+  #
+  # The respond_to? guards use `include_private: true` because both helpers are
+  # top-level Ruby `def`s in react_native_pods.rb — i.e. private methods of Object.
+  # The guards exist not for RN-version compatibility (peer dep is >= 0.81) but
+  # because the RN CLI loads this podspec STANDALONE for autolinking discovery,
+  # outside the Podfile's `require 'react_native_pods.rb'` context where the
+  # helpers are defined. Without guards, `npx react-native config` would crash
+  # and return `ios: null`, breaking `use_native_modules!`.
+  if respond_to?(:spm_dependency, true)
+    spm_dependency(s,
+      url: 'https://github.com/Frame-Payments/frame-ios',
+      requirement: { kind: 'upToNextMajorVersion', minimumVersion: package['frameNativeVersions']['ios'] },
+      products: ['Frame-iOS', 'Frame-Onboarding']
+    )
+  end
+
+  install_modules_dependencies(s) if respond_to?(:install_modules_dependencies, true)
+end

package/Package.swift

@@ -0,0 +1,47 @@
+// swift-tools-version: 5.9
+// Distribution paths:
+//   • Pure-SPM consumers: add framepayments-react-native via Swift Package Manager;
+//     frame-ios resolves transitively from this manifest.
+//   • CocoaPods consumers (the common RN setup): the podspec at
+//     ios/FrameReactNative.podspec declares the same frame-ios SPM dependency via
+//     RN 0.81+'s `spm_dependency` Podfile hook, so `pod install` resolves it
+//     automatically — no Xcode "Add Package Dependencies" step required.
+//
+// IMPORTANT: keep the frame-ios version below in sync with
+// package.json:frameNativeVersions.ios. Swift Package manifests cannot read JSON,
+// so this is the one duplicated version pin. See MAINTAINING.md.
+
+import PackageDescription
+
+let package = Package(
+    name: "framepayments-react-native",
+    platforms: [
+        .iOS(.v17)
+    ],
+    products: [
+        .library(
+            name: "framepayments-react-native",
+            targets: ["framepayments-react-native"]
+        )
+    ],
+    dependencies: [
+        .package(
+            url: "https://github.com/Frame-Payments/frame-ios",
+            from: "2.2.2" // Keep in sync with package.json:frameNativeVersions.ios
+        )
+    ],
+    targets: [
+        .target(
+            name: "framepayments-react-native",
+            dependencies: [
+                .product(name: "Frame-iOS", package: "frame-ios"),
+                .product(name: "Frame-Onboarding", package: "frame-ios")
+            ],
+            path: "ios",
+            publicHeadersPath: ".",
+            cSettings: [
+                .headerSearchPath(".")
+            ]
+        )
+    ]
+)

package/README.md

@@ -4,7 +4,7 @@ React Native SDK for [Frame Payments](https://framepayments.com). Bridges the na
 
 ## Requirements
 
-- React Native >= 0.74
+- React Native >= 0.81 (autolinking on iOS depends on RN's `spm_dependency` Podfile hook, which stabilized in 0.81)
 - iOS 17+ / Android 8.0+ (API 26+)
 - A [Frame](https://framepayments.com) account and API key
 
@@ -18,19 +18,13 @@ yarn add framepayments-react-native
 
 ### iOS setup
 
-#### 1. Add the Frame iOS SDK via Swift Package Manager
-
-The React Native SDK's native layer depends on the Frame iOS SDK, which must be added manually via SPM — CocoaPods cannot pull it in automatically.
-
-In Xcode: **File → Add Package Dependencies**, enter:
-
-```
-https://github.com/Frame-Payments/frame-ios
+```bash
+cd ios && pod install && cd ..
 ```
 
-Add the **Frame-iOS** package and select the version you need.
+That's it. `pod install` autolinks the React Native bridge **and** resolves the underlying Frame iOS SDK (Frame-iOS + Frame-Onboarding) via Swift Package Manager — no Xcode "Add Package Dependencies" step required.
 
-#### 2. Preload Frame on the main thread
+#### Preload Frame on the main thread
 
 Add this to your `AppDelegate.m` or `AppDelegate.mm` **before** `[super application:didFinishLaunchingWithOptions:]`:
 
@@ -48,15 +42,11 @@ This prevents the **"Helpers are not supported by the default hub"** crash, whic
 
 > If your app module name isn't the default (i.e., not matching the generated `-Swift.h` header), set `FRAME_SWIFT_HEADER=YourApp-Swift.h` in your target's **Preprocessor Macros** in Xcode build settings.
 
-#### 3. Install pods
-
-```bash
-cd ios && pod install && cd ..
-```
+> Using Swift Package Manager directly instead of CocoaPods? The package's `Package.swift` resolves `frame-ios` transitively, so just add `framepayments-react-native` via **File → Add Package Dependencies** in Xcode.
 
 ### Android setup
 
-No extra steps required. Autolinking handles the native module automatically.
+No extra steps required. Autolinking handles the native module automatically and pulls in `com.framepayments:framesdk*` from Maven Central.
 
 ---
 

package/android/build.gradle

@@ -1,3 +1,5 @@
+import groovy.json.JsonSlurper
+
 apply plugin: 'com.android.library'
 apply plugin: 'kotlin-android'
 apply plugin: 'org.jetbrains.kotlin.plugin.compose'
@@ -6,6 +8,10 @@ def safeExtGet(prop, fallback) {
   rootProject.ext.has(prop) ? rootProject.ext.get(prop) : fallback
 }
 
+// Single source of truth for Frame native SDK versions — see package.json:frameNativeVersions.
+def frameNativeVersions = new JsonSlurper().parse(file("$projectDir/../package.json")).frameNativeVersions
+def frameAndroidVersion = frameNativeVersions.android
+
 android {
   namespace "com.framepayments.reactnativeframe"
   compileSdk safeExtGet('compileSdkVersion', 36)
@@ -31,9 +37,9 @@ android {
 dependencies {
   implementation 'com.facebook.react:react-native:+'
   implementation "org.jetbrains.kotlin:kotlin-stdlib:2.1.0"
-  implementation 'com.framepayments:framesdk:2.0.7'
-  implementation 'com.framepayments:framesdk_ui:2.0.7'
-  implementation 'com.framepayments:framesdk_onboarding:2.0.7'
+  implementation "com.framepayments:framesdk:${frameAndroidVersion}"
+  implementation "com.framepayments:framesdk_ui:${frameAndroidVersion}"
+  implementation "com.framepayments:framesdk_onboarding:${frameAndroidVersion}"
   // Required by FrameGooglePayButton (PaymentsClient, WalletConstants).
   // framesdk_ui declares this as `implementation`, so it is not exposed transitively.
   implementation 'com.google.android.gms:play-services-wallet:19.4.0'

package/android/src/main/java/com/framepayments/reactnativeframe/FrameSDKModule.kt

@@ -7,9 +7,10 @@ import com.facebook.react.bridge.Promise
 import com.facebook.react.bridge.ReactApplicationContext
 import com.facebook.react.bridge.ReactContextBaseJavaModule
 import com.facebook.react.bridge.ReactMethod
+import com.facebook.react.bridge.ReadableArray
+import com.facebook.react.bridge.ReadableMap
 import com.facebook.react.bridge.WritableNativeMap
 import com.framepayments.framesdk.FrameNetworking
-import org.json.JSONObject
 
 class FrameSDKModule(reactContext: ReactApplicationContext) :
   ReactContextBaseJavaModule(reactContext), ActivityEventListener {
@@ -35,7 +36,7 @@ class FrameSDKModule(reactContext: ReactApplicationContext) :
     secretKey: String,
     publishableKey: String,
     debugMode: Boolean,
-    theme: com.facebook.react.bridge.ReadableMap?,
+    theme: ReadableMap?,
     promise: Promise
   ) {
     try {
@@ -69,7 +70,7 @@ class FrameSDKModule(reactContext: ReactApplicationContext) :
   @ReactMethod
   fun presentCart(
     accountId: String?,
-    items: com.facebook.react.bridge.ReadableArray,
+    items: ReadableArray,
     shippingAmountInCents: Double,
     promise: Promise
   ) {
@@ -137,7 +138,7 @@ class FrameSDKModule(reactContext: ReactApplicationContext) :
   @ReactMethod
   fun presentOnboarding(
     accountId: String?,
-    capabilities: com.facebook.react.bridge.ReadableArray,
+    capabilities: ReadableArray,
     googlePayMerchantId: String?,
     promise: Promise
   ) {
@@ -157,7 +158,7 @@ class FrameSDKModule(reactContext: ReactApplicationContext) :
     }
   }
 
-  private fun readableArrayToJson(items: com.facebook.react.bridge.ReadableArray): String? {
+  private fun readableArrayToJson(items: ReadableArray): String? {
     val arr = org.json.JSONArray()
     for (i in 0 until items.size()) {
       val item = items.getMap(i) ?: return null
@@ -171,7 +172,7 @@ class FrameSDKModule(reactContext: ReactApplicationContext) :
     return arr.toString()
   }
 
-  private fun readableArrayToJsonArray(arr: com.facebook.react.bridge.ReadableArray): String {
+  private fun readableArrayToJsonArray(arr: ReadableArray): String {
     val jsonArr = org.json.JSONArray()
     for (i in 0 until arr.size()) {
       arr.getString(i)?.let { jsonArr.put(it) }

package/ios/FramePreloader.h

@@ -0,0 +1,23 @@
+//
+//  FramePreloader.h
+//  FrameReactNative
+//
+//  Public Obj-C interface for the Swift `FramePreloader` class. Lets consumers
+//  reach `+[FramePreloader preloadOnMainThread]` from AppDelegate.mm (or any
+//  .m/.mm file) via `#import "FramePreloader.h"`, without needing modules
+//  enabled in C++ context.
+//
+
+#import <Foundation/Foundation.h>
+
+NS_ASSUME_NONNULL_BEGIN
+
+@interface FramePreloader : NSObject
+
+/// Call from AppDelegate before [super application:didFinishLaunchingWithOptions:].
+/// Forces Frame (and its deps: Evervault, Sift) to load on the main thread.
++ (void)preloadOnMainThread;
+
+@end
+
+NS_ASSUME_NONNULL_END

package/ios/FrameSDKBridge.m

@@ -8,16 +8,16 @@
 #import <React/RCTBridgeModule.h>
 #import "FrameVCHelper.h"
 
-// Import app's Swift header (ObjCFrameSDKBridge, FramePreloader). The example uses FrameExampleTemp.
-// If your app has a different module name, add Preprocessor Macro: FRAME_SWIFT_HEADER="YourApp-Swift.h"
-#if defined(FRAME_SWIFT_HEADER)
-#import FRAME_SWIFT_HEADER
-#elif __has_include("FrameExampleTemp-Swift.h")
-#import "FrameExampleTemp-Swift.h"
-#elif __has_include(<FrameExampleTemp/FrameExampleTemp-Swift.h>)
-#import <FrameExampleTemp/FrameExampleTemp-Swift.h>
+// Import the FrameReactNative pod's auto-generated Swift header so this Obj-C
+// file can reach the Swift `ObjCFrameSDKBridge` class. CocoaPods generates
+// "FrameReactNative-Swift.h" from the pod's Swift sources during the pod's
+// build phase.
+#if __has_include("FrameReactNative-Swift.h")
+#import "FrameReactNative-Swift.h"
+#elif __has_include(<FrameReactNative/FrameReactNative-Swift.h>)
+#import <FrameReactNative/FrameReactNative-Swift.h>
 #else
-#error "Swift header not found. Add FRAME_SWIFT_HEADER=\"YourApp-Swift.h\" to your app target's Preprocessor Macros, or ensure Swift files compile before this file."
+#error "FrameReactNative-Swift.h not found. The Frame React Native pod's Swift code did not generate its module header — check that pod install ran cleanly."
 #endif
 
 @interface FrameSDKModule : NSObject <RCTBridgeModule>

package/ios/FrameSDKBridge.swift

@@ -106,33 +106,30 @@ public class FrameSDKBridge: NSObject {
   // MARK: - Private helpers
 
   private func presentCheckoutOnMain(from top: UIViewController, accountId: String, amount: Int, resolve: @escaping RCTPromiseResolveBlock, reject: @escaping RCTPromiseRejectBlock) {
-    var hosting: CheckoutHostingController!
-    hosting = CheckoutHostingController(rootView: FrameCheckoutView(
+    // Single dismiss delegate guards against double-resolve: the inner checkout
+    // calls `finish(.success)` with the transfer id; bare-dismiss (swipe-down
+    // without completing checkout) calls `finish(.cancel)`.
+    let delegate = CheckoutDismissDelegate(resolve: resolve, reject: reject)
+    let checkoutView = FrameCheckoutView(
       accountId: accountId,
       paymentAmount: amount,
-      checkoutCallback: { [weak hosting] success, transferId in
-        hosting?.didComplete = true
-        top.dismiss(animated: true)
-        DispatchQueue.main.async {
-          if success, let transferId {
-            resolve(transferId)
-          } else {
-            reject("PAYMENT_FAILED", "Checkout did not produce a transfer id", nil)
-          }
+      checkoutCallback: { [weak top, delegate] success, transferId in
+        if success, let transferId {
+          delegate.finish(.success(transferId))
+        } else {
+          delegate.finish(.failure)
         }
+        top?.dismiss(animated: true)
       }
-    ))
-    hosting.onCancel = {
-      DispatchQueue.main.async {
-        reject("USER_CANCELED", "User dismissed checkout without completing payment", nil)
-      }
-    }
+    )
+    let hosting = UIHostingController(rootView: checkoutView)
     hosting.modalPresentationStyle = UIModalPresentationStyle.pageSheet
     if let sheet = hosting.sheetPresentationController {
       sheet.detents = [UISheetPresentationController.Detent.large()]
     }
+    objc_setAssociatedObject(hosting, &checkoutDismissKey, delegate, .OBJC_ASSOCIATION_RETAIN)
     top.present(hosting, animated: true) {
-      hosting.presentationController?.delegate = hosting
+      hosting.presentationController?.delegate = delegate
     }
   }
 
@@ -237,30 +234,44 @@ public class FrameSDKBridge: NSObject {
   }
 }
 
-// MARK: - CheckoutHostingController
+// MARK: - OnboardingHostingController
 
-private final class CheckoutHostingController: UIHostingController<FrameCheckoutView>, UIAdaptivePresentationControllerDelegate {
-  var didComplete = false
-  var onCancel: (() -> Void)?
-  private var cancelled = false
+private final class OnboardingHostingController<V: View>: UIHostingController<V> {}
 
-  func cancel() {
-    guard !didComplete, !cancelled else { return }
-    cancelled = true
-    onCancel?()
-  }
+// MARK: - Delegates
 
-  func presentationControllerDidDismiss(_ presentationController: UIPresentationController) {
-    guard presentationController.presentedViewController === self else { return }
-    cancel()
+private final class CheckoutDismissDelegate: NSObject, UIAdaptivePresentationControllerDelegate {
+  enum Outcome {
+    case success(String)
+    case failure
+    case cancel
   }
-}
 
-// MARK: - OnboardingHostingController
+  private let resolve: RCTPromiseResolveBlock
+  private let reject: RCTPromiseRejectBlock
+  private var didFinish = false
 
-private final class OnboardingHostingController<V: View>: UIHostingController<V> {}
+  init(resolve: @escaping RCTPromiseResolveBlock, reject: @escaping RCTPromiseRejectBlock) {
+    self.resolve = resolve
+    self.reject = reject
+  }
 
-// MARK: - Delegates
+  func finish(_ outcome: Outcome) {
+    guard !didFinish else { return }
+    didFinish = true
+    DispatchQueue.main.async { [resolve, reject] in
+      switch outcome {
+      case .success(let transferId): resolve(transferId)
+      case .failure: reject("PAYMENT_FAILED", "Checkout did not produce a transfer id", nil)
+      case .cancel: reject("USER_CANCELED", "User dismissed checkout without completing payment", nil)
+      }
+    }
+  }
+
+  func presentationControllerDidDismiss(_ presentationController: UIPresentationController) {
+    finish(.cancel)
+  }
+}
 
 private final class CartDismissDelegate: NSObject, UIAdaptivePresentationControllerDelegate {
   enum Outcome {
@@ -319,5 +330,6 @@ private final class OnboardingDismissDelegate: NSObject, UIAdaptivePresentationC
   }
 }
 
+private var checkoutDismissKey: UInt8 = 0
 private var cartDismissKey: UInt8 = 0
 private var onboardingDismissKey: UInt8 = 0

package/lib/native.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"native.d.ts","sourceRoot":"","sources":["../src/native.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EACV,aAAa,EACb,UAAU,EACV,oBAAoB,EACpB,gBAAgB,EAChB,sBAAsB,EACtB,uBAAuB,EACxB,MAAM,SAAS,CAAC;AAiCjB,wBAAgB,UAAU,CAAC,OAAO,EAAE;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;;;;OAKG;IACH,KAAK,CAAC,EAAE,UAAU,CAAC;CACpB,GAAG,OAAO,CAAC,IAAI,CAAC,CAoBhB;AAwBD;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE;IACvC,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;CAChB,GAAG,OAAO,CAAC,MAAM,CAAC,CAQlB;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,aAAa,EAAE,CAAC;IACvB,qBAAqB,EAAE,MAAM,CAAC;CAC/B,GAAG,OAAO,CAAC,MAAM,CAAC,CAYlB;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE;IACzC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,YAAY,CAAC,EAAE,oBAAoB,EAAE,CAAC;IACtC,kBAAkB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,mBAAmB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACrC,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAkB5B;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,MAAM,CAAC,CAoBhF;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC,MAAM,CAAC,CAiBlF"}
+{"version":3,"file":"native.d.ts","sourceRoot":"","sources":["../src/native.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EACV,aAAa,EACb,UAAU,EACV,oBAAoB,EACpB,gBAAgB,EAChB,sBAAsB,EACtB,uBAAuB,EACxB,MAAM,SAAS,CAAC;AAiCjB,wBAAgB,UAAU,CAAC,OAAO,EAAE;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;;;;OAKG;IACH,KAAK,CAAC,EAAE,UAAU,CAAC;CACpB,GAAG,OAAO,CAAC,IAAI,CAAC,CAoBhB;AAwBD;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE;IACvC,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;CAChB,GAAG,OAAO,CAAC,MAAM,CAAC,CAQlB;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,aAAa,EAAE,CAAC;IACvB,qBAAqB,EAAE,MAAM,CAAC;CAC/B,GAAG,OAAO,CAAC,MAAM,CAAC,CAYlB;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE;IACzC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,YAAY,CAAC,EAAE,oBAAoB,EAAE,CAAC;IACtC,kBAAkB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,mBAAmB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACrC,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAkB5B;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,MAAM,CAAC,CAuBhF;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC,MAAM,CAAC,CAoBlF"}

package/lib/native.js

@@ -3,6 +3,14 @@
  */
 import { NativeModules, Platform } from 'react-native';
 import { ErrorCodes } from './errors';
+const LINKING_ERROR = `The package 'framepayments-react-native' doesn't seem to be linked. Make sure you have run 'pod install' (iOS) or rebuilt the app (Android).`;
+const FrameSDK = NativeModules.FrameSDK
+    ? NativeModules.FrameSDK
+    : new Proxy({}, {
+        get() {
+            throw new Error(LINKING_ERROR);
+        },
+    });
 /**
  * Throw a coded error from synchronous JS validation. Mirrors the `code`/`message`
  * shape that native rejections produce so consumers can catch `e.code === 'INVALID_*'`
@@ -15,14 +23,6 @@ function throwCoded(code, message) {
 }
 // theme is iOS-only today: frame-android does not yet have a matching theme API,
 // so the field is accepted on both platforms but ignored on Android until it does.
-const LINKING_ERROR = `The package 'framepayments-react-native' doesn't seem to be linked. Make sure you have run 'pod install' (iOS) or rebuilt the app (Android).`;
-const FrameSDK = NativeModules.FrameSDK
-    ? NativeModules.FrameSDK
-    : new Proxy({}, {
-        get() {
-            throw new Error(LINKING_ERROR);
-        },
-    });
 let isInitialized = false;
 export function initialize(options) {
     if (!options?.secretKey) {
@@ -104,6 +104,9 @@ export function presentOnboarding(options) {
  */
 export function presentApplePay(options) {
     guardInitialized();
+    if (Platform.OS !== 'ios') {
+        throwCoded('PLATFORM_UNSUPPORTED', 'Frame.presentApplePay is iOS-only; use presentGooglePay on Android.');
+    }
     if (!options?.owner || (options.owner.type !== 'customer' && options.owner.type !== 'account')) {
         throwCoded(ErrorCodes.INVALID_OWNER, 'Frame.presentApplePay requires owner: { type: "customer" | "account", id: string }');
     }
@@ -124,6 +127,9 @@ export function presentApplePay(options) {
  */
 export function presentGooglePay(options) {
     guardInitialized();
+    if (Platform.OS !== 'android') {
+        throwCoded('PLATFORM_UNSUPPORTED', 'Frame.presentGooglePay is Android-only; use presentApplePay on iOS.');
+    }
     if (!options?.owner || (options.owner.type !== 'customer' && options.owner.type !== 'account')) {
         throwCoded(ErrorCodes.INVALID_OWNER, 'Frame.presentGooglePay requires owner: { type: "customer" | "account", id: string }');
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "framepayments-react-native",
-  "version": "2.2.0",
+  "version": "3.0.0",
   "description": "React Native SDK for Frame Payments - modal checkout and cart, with API usage via frame-node.",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",
@@ -31,7 +31,11 @@
   "homepage": "https://github.com/Frame-Payments/frame-react-native#readme",
   "peerDependencies": {
     "react": "*",
-    "react-native": ">=0.74.0"
+    "react-native": ">=0.81.0"
+  },
+  "frameNativeVersions": {
+    "ios": "2.2.2",
+    "android": "2.0.8"
   },
   "devDependencies": {
     "@types/jest": "^29.5.0",
@@ -54,6 +58,8 @@
     "lib",
     "ios",
     "android",
+    "FrameReactNative.podspec",
+    "Package.swift",
     "README.md",
     "LICENSE"
   ],

package/src/__tests__/native.test.ts

@@ -224,6 +224,11 @@ describe('presentApplePay', () => {
 });
 
 describe('presentGooglePay', () => {
+  beforeEach(() => {
+    // presentGooglePay is Android-only; tests run on Android except where noted.
+    mockPlatform.OS = 'android';
+  });
+
   it('throws NOT_INITIALIZED if initialize was not called', async () => {
     try {
       await presentGooglePay({ amountCents: 100, owner: { type: 'account', id: 'acct_1' } });

package/src/native.ts

@@ -13,20 +13,6 @@ import type {
 } from './types';
 import { ErrorCodes } from './errors';
 
-/**
- * Throw a coded error from synchronous JS validation. Mirrors the `code`/`message`
- * shape that native rejections produce so consumers can catch `e.code === 'INVALID_*'`
- * uniformly.
- */
-function throwCoded(code: string, message: string): never {
-  const err = new Error(message) as Error & { code: string };
-  err.code = code;
-  throw err;
-}
-
-// theme is iOS-only today: frame-android does not yet have a matching theme API,
-// so the field is accepted on both platforms but ignored on Android until it does.
-
 const LINKING_ERROR =
   `The package 'framepayments-react-native' doesn't seem to be linked. Make sure you have run 'pod install' (iOS) or rebuilt the app (Android).`;
 
@@ -41,6 +27,20 @@ const FrameSDK = NativeModules.FrameSDK
       }
     );
 
+/**
+ * Throw a coded error from synchronous JS validation. Mirrors the `code`/`message`
+ * shape that native rejections produce so consumers can catch `e.code === 'INVALID_*'`
+ * uniformly.
+ */
+function throwCoded(code: string, message: string): never {
+  const err = new Error(message) as Error & { code: string };
+  err.code = code;
+  throw err;
+}
+
+// theme is iOS-only today: frame-android does not yet have a matching theme API,
+// so the field is accepted on both platforms but ignored on Android until it does.
+
 let isInitialized = false;
 
 export function initialize(options: {
@@ -179,6 +179,9 @@ export function presentOnboarding(options: {
  */
 export function presentApplePay(options: PresentApplePayOptions): Promise<string> {
   guardInitialized();
+  if (Platform.OS !== 'ios') {
+    throwCoded('PLATFORM_UNSUPPORTED', 'Frame.presentApplePay is iOS-only; use presentGooglePay on Android.');
+  }
   if (!options?.owner || (options.owner.type !== 'customer' && options.owner.type !== 'account')) {
     throwCoded(ErrorCodes.INVALID_OWNER, 'Frame.presentApplePay requires owner: { type: "customer" | "account", id: string }');
   }
@@ -208,6 +211,9 @@ export function presentApplePay(options: PresentApplePayOptions): Promise<string
  */
 export function presentGooglePay(options: PresentGooglePayOptions): Promise<string> {
   guardInitialized();
+  if (Platform.OS !== 'android') {
+    throwCoded('PLATFORM_UNSUPPORTED', 'Frame.presentGooglePay is Android-only; use presentApplePay on iOS.');
+  }
   if (!options?.owner || (options.owner.type !== 'customer' && options.owner.type !== 'account')) {
     throwCoded(ErrorCodes.INVALID_OWNER, 'Frame.presentGooglePay requires owner: { type: "customer" | "account", id: string }');
   }

package/ios/FrameReactNative.podspec

@@ -1,32 +0,0 @@
-require 'json'
-
-package = JSON.parse(File.read(File.join(__dir__, '..', 'package.json')))
-
-Pod::Spec.new do |s|
-  s.name         = 'FrameReactNative'
-  s.version      = package['version']
-  s.summary      = package['description']
-  s.homepage     = package['homepage']
-  s.license      = package['license']
-  s.authors      = package['author']
-  s.platforms    = { :ios => '17.0' }
-  s.source       = { :git => package['repository']['url'], :tag => "#{s.version}" }
-  s.source_files = '**/*.{h,m,mm,swift}'
-  s.requires_arc = true
-
-  s.dependency 'React-Core'
-
-  # Frame-iOS SDK (Frame + FrameOnboarding) must be available to the app.
-  #
-  # SPM users (RN >= 0.73): add framepayments-react-native via Swift Package Manager.
-  # Frame and FrameOnboarding are declared as dependencies in Package.swift and resolve
-  # automatically — no manual step required.
-  #
-  # CocoaPods users: add frame-ios manually via Xcode:
-  #   File → Add Package Dependencies → https://github.com/Frame-Payments/frame-ios
-  #   Add both the "Frame-iOS" and "Frame-Onboarding" products to your app target.
-  # If Frame-iOS is published as a pod in the future, replace the above with:
-  # s.dependency 'Frame-iOS'
-
-  install_modules_dependencies(s) if respond_to?(:install_modules_dependencies)
-end

package/lib/__tests__/native.test.d.ts

@@ -1,32 +0,0 @@
-/**
- * Unit tests for the native module bridge (initialize, presentCheckout, presentCart).
- * NativeModules.FrameSDK is mocked.
- */
-declare const mockInitialize: jest.Mock<Promise<void>, [_apiKey: string, _debugMode: boolean], any>;
-declare const mockPresentCheckout: jest.Mock<Promise<{
-    id: string;
-    amount: number;
-}>, [_customerId: unknown, _amount: number], any>;
-declare const mockPresentCart: jest.Mock<Promise<{
-    id: string;
-    amount: number;
-}>, [_customerId: unknown, _items: unknown[], _shipping: number], any>;
-declare let initialize: (opts: {
-    apiKey: string;
-    debugMode?: boolean;
-}) => void;
-declare let presentCheckout: (opts: {
-    customerId?: string | null;
-    amount: number;
-}) => Promise<unknown>;
-declare let presentCart: (opts: {
-    customerId?: string | null;
-    items: Array<{
-        id: string;
-        title: string;
-        amountInCents: number;
-        imageUrl: string;
-    }>;
-    shippingAmountInCents: number;
-}) => Promise<unknown>;
-//# sourceMappingURL=native.test.d.ts.map

package/lib/__tests__/native.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"native.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/native.test.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,QAAA,MAAM,cAAc,uEAAuE,CAAC;AAC5F,QAAA,MAAM,mBAAmB;;;iDAAqG,CAAC;AAC/H,QAAA,MAAM,eAAe;;;sEAA0H,CAAC;AAahJ,QAAA,IAAI,UAAU,EAAE,CAAC,IAAI,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,OAAO,CAAA;CAAE,KAAK,IAAI,CAAC;AACxE,QAAA,IAAI,eAAe,EAAE,CAAC,IAAI,EAAE;IAAE,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;AAChG,QAAA,IAAI,WAAW,EAAE,CAAC,IAAI,EAAE;IACtB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,KAAK,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACrF,qBAAqB,EAAE,MAAM,CAAC;CAC/B,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC"}

package/lib/__tests__/native.test.js

@@ -1,101 +0,0 @@
-"use strict";
-/**
- * Unit tests for the native module bridge (initialize, presentCheckout, presentCart).
- * NativeModules.FrameSDK is mocked.
- */
-const mockInitialize = jest.fn((_apiKey, _debugMode) => Promise.resolve());
-const mockPresentCheckout = jest.fn((_customerId, _amount) => Promise.resolve({ id: 'ci_1', amount: 10000 }));
-const mockPresentCart = jest.fn((_customerId, _items, _shipping) => Promise.resolve({ id: 'ci_2', amount: 15000 }));
-jest.mock('react-native', () => ({
-    NativeModules: {
-        FrameSDK: {
-            initialize: mockInitialize,
-            presentCheckout: mockPresentCheckout,
-            presentCart: mockPresentCart,
-        },
-    },
-}));
-// Re-import after mock so we get the mocked NativeModules
-let initialize;
-let presentCheckout;
-let presentCart;
-beforeEach(() => {
-    jest.resetModules();
-    mockInitialize.mockClear();
-    mockPresentCheckout.mockClear();
-    mockPresentCart.mockClear();
-    const native = require('../native');
-    initialize = native.initialize;
-    presentCheckout = native.presentCheckout;
-    presentCart = native.presentCart;
-});
-describe('initialize', () => {
-    it('calls native FrameSDK.initialize with apiKey and debugMode', () => {
-        initialize({ apiKey: 'sk_test_xxx', debugMode: true });
-        expect(mockInitialize).toHaveBeenCalledTimes(1);
-        expect(mockInitialize).toHaveBeenCalledWith('sk_test_xxx', true);
-    });
-    it('defaults debugMode to false', () => {
-        initialize({ apiKey: 'sk_test_yyy' });
-        expect(mockInitialize).toHaveBeenCalledWith('sk_test_yyy', false);
-    });
-    it('throws if apiKey is missing', () => {
-        expect(() => initialize({ apiKey: '' })).toThrow();
-        expect(() => initialize({})).toThrow();
-        expect(mockInitialize).not.toHaveBeenCalled();
-    });
-});
-describe('presentCheckout', () => {
-    it('throws NOT_INITIALIZED if initialize was not called', async () => {
-        try {
-            await presentCheckout({ amount: 10000 });
-            expect(true).toBe(false);
-        }
-        catch (e) {
-            expect(e.code).toBe('NOT_INITIALIZED');
-            expect(e.message).toContain('initialized');
-        }
-        expect(mockPresentCheckout).not.toHaveBeenCalled();
-    });
-    it('calls native presentCheckout with customerId and amount after initialize', async () => {
-        initialize({ apiKey: 'sk_xxx' });
-        const result = await presentCheckout({ customerId: 'cus_1', amount: 10000 });
-        expect(mockPresentCheckout).toHaveBeenCalledWith('cus_1', 10000);
-        expect(result).toEqual({ id: 'ci_1', amount: 10000 });
-    });
-    it('passes null for customerId when not provided', async () => {
-        initialize({ apiKey: 'sk_xxx' });
-        await presentCheckout({ amount: 5000 });
-        expect(mockPresentCheckout).toHaveBeenCalledWith(null, 5000);
-    });
-});
-describe('presentCart', () => {
-    const items = [
-        { id: '1', title: 'Item A', amountInCents: 1000, imageUrl: 'https://example.com/a.jpg' },
-    ];
-    it('throws NOT_INITIALIZED if initialize was not called', async () => {
-        try {
-            await presentCart({ items, shippingAmountInCents: 500 });
-            expect(true).toBe(false);
-        }
-        catch (e) {
-            expect(e.code).toBe('NOT_INITIALIZED');
-        }
-        expect(mockPresentCart).not.toHaveBeenCalled();
-    });
-    it('calls native presentCart with customerId, items, shipping after initialize', async () => {
-        initialize({ apiKey: 'sk_xxx' });
-        const result = await presentCart({
-            customerId: 'cus_2',
-            items,
-            shippingAmountInCents: 500,
-        });
-        expect(mockPresentCart).toHaveBeenCalledWith('cus_2', items, 500);
-        expect(result).toEqual({ id: 'ci_2', amount: 15000 });
-    });
-    it('passes null for customerId when not provided', async () => {
-        initialize({ apiKey: 'sk_xxx' });
-        await presentCart({ items, shippingAmountInCents: 0 });
-        expect(mockPresentCart).toHaveBeenCalledWith(null, items, 0);
-    });
-});

package/lib/components/FrameApplePayButton.d.ts

@@ -1,30 +0,0 @@
-/**
- * <FrameApplePayButton /> — iOS-only React Native view that wraps Frame iOS SDK's
- * native FrameApplePayButton (PassKit + automatic device attestation).
- *
- * On non-iOS platforms this component renders nothing, so consumers can place it
- * unconditionally in their JSX.
- */
-import * as React from 'react';
-import { type NativeSyntheticEvent, type ViewProps } from 'react-native';
-import type { ApplePayButtonStyle, ApplePayButtonType, ApplePayOwner, FrameApplePayResultEvent } from '../types';
-export interface FrameApplePayButtonProps extends ViewProps {
-    /** Payment amount in cents. */
-    amount: number;
-    /** ISO 4217 currency code. Defaults to 'usd'. */
-    currency?: string;
-    /** Customer or account that owns the resulting payment method. */
-    owner: ApplePayOwner;
-    /** Apple Pay merchant ID configured in your Apple Developer account. */
-    merchantId: string;
-    /** When true, the button renders a "Or" divider beneath itself for inline checkout layouts. */
-    addCheckoutDivider?: boolean;
-    /** PassKit button type. Defaults to 'buy'. */
-    buttonType?: ApplePayButtonType;
-    /** PassKit button style. Defaults to 'black'. */
-    buttonStyle?: ApplePayButtonStyle;
-    /** Fired when payment completes, fails, or the button reports an error. */
-    onResult: (event: NativeSyntheticEvent<FrameApplePayResultEvent>) => void;
-}
-export declare const FrameApplePayButton: React.FC<FrameApplePayButtonProps>;
-//# sourceMappingURL=FrameApplePayButton.d.ts.map

package/lib/components/FrameApplePayButton.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"FrameApplePayButton.d.ts","sourceRoot":"","sources":["../../src/components/FrameApplePayButton.tsx"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAIL,KAAK,oBAAoB,EACzB,KAAK,SAAS,EACf,MAAM,cAAc,CAAC;AACtB,OAAO,KAAK,EACV,mBAAmB,EACnB,kBAAkB,EAClB,aAAa,EACb,wBAAwB,EACzB,MAAM,UAAU,CAAC;AAElB,MAAM,WAAW,wBAAyB,SAAQ,SAAS;IACzD,+BAA+B;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,iDAAiD;IACjD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,kEAAkE;IAClE,KAAK,EAAE,aAAa,CAAC;IACrB,wEAAwE;IACxE,UAAU,EAAE,MAAM,CAAC;IACnB,+FAA+F;IAC/F,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,8CAA8C;IAC9C,UAAU,CAAC,EAAE,kBAAkB,CAAC;IAChC,iDAAiD;IACjD,WAAW,CAAC,EAAE,mBAAmB,CAAC;IAClC,2EAA2E;IAC3E,QAAQ,EAAE,CAAC,KAAK,EAAE,oBAAoB,CAAC,wBAAwB,CAAC,KAAK,IAAI,CAAC;CAC3E;AA+BD,eAAO,MAAM,mBAAmB,EAAE,KAAK,CAAC,EAAE,CAAC,wBAAwB,CAclE,CAAC"}

package/lib/components/FrameApplePayButton.js

@@ -1,42 +0,0 @@
-/**
- * <FrameApplePayButton /> — iOS-only React Native view that wraps Frame iOS SDK's
- * native FrameApplePayButton (PassKit + automatic device attestation).
- *
- * On non-iOS platforms this component renders nothing, so consumers can place it
- * unconditionally in their JSX.
- */
-import * as React from 'react';
-import { Platform, StyleSheet, requireNativeComponent, } from 'react-native';
-const NativeFrameApplePayButton = Platform.OS === 'ios'
-    ? requireNativeComponent('FrameApplePayButtonView')
-    : null;
-let warnedAboutOwner = false;
-function warnIfBadOwner(owner) {
-    if (!owner ||
-        (owner.type !== 'customer' && owner.type !== 'account') ||
-        typeof owner.id !== 'string' ||
-        owner.id.length === 0) {
-        if (!warnedAboutOwner) {
-            warnedAboutOwner = true;
-            // eslint-disable-next-line no-console
-            console.warn('[FrameApplePayButton] `owner` must be { type: "customer" | "account", id: string }. The button will not render until a valid owner is provided.');
-        }
-        return false;
-    }
-    return true;
-}
-export const FrameApplePayButton = (props) => {
-    if (Platform.OS !== 'ios' || NativeFrameApplePayButton === null) {
-        return null;
-    }
-    if (!warnIfBadOwner(props.owner)) {
-        return null;
-    }
-    const { style, ...rest } = props;
-    return (<NativeFrameApplePayButton {...rest} style={[styles.button, style]}/>);
-};
-const styles = StyleSheet.create({
-    button: {
-        height: 50,
-    },
-});

package/lib/components/FrameGooglePayButton.d.ts

@@ -1,28 +0,0 @@
-/**
- * <FrameGooglePayButton /> — Android-only React Native view that wraps Frame Android SDK's
- * native FrameGooglePayButton (Google Pay PaymentsClient + readiness check).
- *
- * On non-Android platforms this component renders nothing, so consumers can place it
- * unconditionally in their JSX.
- */
-import * as React from 'react';
-import { type NativeSyntheticEvent, type ViewProps } from 'react-native';
-import type { FrameGooglePayResultEvent } from '../types';
-export interface FrameGooglePayButtonProps extends ViewProps {
-    /** Payment amount in cents. */
-    amountCents: number;
-    /** Optional Frame customer ID to associate the resulting payment method with. */
-    customerId?: string;
-    /** ISO 4217 currency code. Defaults to 'USD'. */
-    currencyCode?: string;
-    /** Optional override for the Google Pay merchant ID. */
-    googlePayMerchantId?: string;
-    /** Fired when payment completes, fails, or the user cancels the Google Pay sheet. */
-    onResult: (event: NativeSyntheticEvent<FrameGooglePayResultEvent>) => void;
-    /** Fired when Google Pay readiness changes (button shows/hides itself accordingly). */
-    onReadinessChanged?: (event: NativeSyntheticEvent<{
-        isReady: boolean;
-    }>) => void;
-}
-export declare const FrameGooglePayButton: React.FC<FrameGooglePayButtonProps>;
-//# sourceMappingURL=FrameGooglePayButton.d.ts.map

package/lib/components/FrameGooglePayButton.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"FrameGooglePayButton.d.ts","sourceRoot":"","sources":["../../src/components/FrameGooglePayButton.tsx"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAIL,KAAK,oBAAoB,EACzB,KAAK,SAAS,EACf,MAAM,cAAc,CAAC;AACtB,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,UAAU,CAAC;AAE1D,MAAM,WAAW,yBAA0B,SAAQ,SAAS;IAC1D,+BAA+B;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,iFAAiF;IACjF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iDAAiD;IACjD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,wDAAwD;IACxD,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,qFAAqF;IACrF,QAAQ,EAAE,CAAC,KAAK,EAAE,oBAAoB,CAAC,yBAAyB,CAAC,KAAK,IAAI,CAAC;IAC3E,uFAAuF;IACvF,kBAAkB,CAAC,EAAE,CAAC,KAAK,EAAE,oBAAoB,CAAC;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC,KAAK,IAAI,CAAC;CAClF;AAOD,eAAO,MAAM,oBAAoB,EAAE,KAAK,CAAC,EAAE,CAAC,yBAAyB,CAWpE,CAAC"}

package/lib/components/FrameGooglePayButton.js

@@ -1,24 +0,0 @@
-/**
- * <FrameGooglePayButton /> — Android-only React Native view that wraps Frame Android SDK's
- * native FrameGooglePayButton (Google Pay PaymentsClient + readiness check).
- *
- * On non-Android platforms this component renders nothing, so consumers can place it
- * unconditionally in their JSX.
- */
-import * as React from 'react';
-import { Platform, StyleSheet, requireNativeComponent, } from 'react-native';
-const NativeFrameGooglePayButton = Platform.OS === 'android'
-    ? requireNativeComponent('FrameGooglePayButtonView')
-    : null;
-export const FrameGooglePayButton = (props) => {
-    if (Platform.OS !== 'android' || NativeFrameGooglePayButton === null) {
-        return null;
-    }
-    const { style, ...rest } = props;
-    return (<NativeFrameGooglePayButton {...rest} style={[styles.button, style]}/>);
-};
-const styles = StyleSheet.create({
-    button: {
-        height: 48,
-    },
-});

package/lib/components/index.d.ts

@@ -1,5 +0,0 @@
-export { FrameApplePayButton } from './FrameApplePayButton';
-export type { FrameApplePayButtonProps } from './FrameApplePayButton';
-export { FrameGooglePayButton } from './FrameGooglePayButton';
-export type { FrameGooglePayButtonProps } from './FrameGooglePayButton';
-//# sourceMappingURL=index.d.ts.map

package/lib/components/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/components/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,YAAY,EAAE,wBAAwB,EAAE,MAAM,uBAAuB,CAAC;AACtE,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,YAAY,EAAE,yBAAyB,EAAE,MAAM,wBAAwB,CAAC"}

package/lib/components/index.js

@@ -1,2 +0,0 @@
-export { FrameApplePayButton } from './FrameApplePayButton';
-export { FrameGooglePayButton } from './FrameGooglePayButton';