@onramper/onramper-react-native 1.1.1 → 1.2.1

package/CHANGELOG.md

@@ -2,6 +2,60 @@
 
 All notable changes to this project are documented in this file.
 
+## [1.2.1]
+
+Bundles `OnramperSDK@1.2.1`.
+
+### Added
+
+- Durable Onramper transaction IDs. `checkoutFinalized.response` now includes the required
+  `onramperTransactionId`, and `OnramperClient.currentTransactionId` mirrors the native
+  published value. Subscribe with `addTransactionIdListener` when UI must react to it.
+- Both example apps display and log the transaction ID at finalization.
+
+### Changed
+
+- No migration is required. The release is additive. Persist `onramperTransactionId` for
+  support, reconciliation, and status lookup instead of per-attempt checkout/intent IDs.
+  Read it before `reset()` or `signOut()`, which clear the current value. TypeScript tests
+  that manually construct a `CheckoutFinalizeResponse` fixture must add the required field.
+
+## [1.2.0]
+
+Bundles `OnramperSDK@1.2.0`.
+
+### Added
+
+- Client-supplied **user-field prefill**. `getCheckoutRequirements()` accepts an optional third argument carrying values you already know about the user, and the OnramperID sign-in and additional-info screens arrive pre-populated instead of blank. New exported type: `OnramperUserPrefill` — `email`, `firstName`, `lastName`, `phoneNumber`, all optional; supply only what you know.
+
+  ```ts
+  const { button, quote } = await client.getCheckoutRequirements(request, style, {
+    firstName: 'Ada',
+    lastName: 'Lovelace',
+    phoneNumber: '+3712345678', // E.164
+  });
+  ```
+
+  Prefill is **best-effort and never blocks sign-in.** If it can't be applied, the login flow opens normally without it. No error surfaces to your app, and there is nothing to handle. Prefill values are never logged at any `logLevel`.
+
+  A prefilled phone number is always a *candidate*: the user still verifies it, and a number already verified on the account takes precedence.
+
+  **Supply `email` only when you are confident** it is the address the user will sign in with. It identifies which account the other values belong to, so it is not merely another prefilled value: when it matches the account that signs in, the remaining values may be applied automatically; when it does not match, the whole prefill is dropped — which is strictly worse than omitting `email`, where the values are still offered to the user for confirmation.
+
+  Prefill is enabled per integration. Talk to your Onramper representative before relying on it — without it enabled, sign-in simply proceeds without prefill.
+
+- Both example apps gained a prefill panel (a send/don't-send switch plus editable fields) so the flow can be exercised on device. `email` and `phoneNumber` start blank deliberately.
+
+### Changed
+
+- `getCheckoutRequirements(request, buttonStyle?)` gains a trailing `prefill?` parameter and is now `getCheckoutRequirements(request, buttonStyle?, prefill?)`. Existing call sites are unaffected; no migration is required. (The Swift SDK places `prefill` before `buttonStyle`, where argument labels keep it non-breaking — JavaScript has no labels, so the wrapper appends it instead.)
+
+## [1.1.1]
+Minor version bundling security enhancements from Onramper iOS SDK v1.1.1
+
+### Changed (breaking)
+- All clients should upgrade to this version. This version includes a new security paradigm for backend communications that is required.
+
 ## [1.1.0]
 
 Bundles `OnramperSDK@1.1.0`. The SDK is pre-adoption, so breaking changes ship within the 1.x line.

package/README.md

@@ -58,11 +58,18 @@ return (
 
 The button renders natively and presents login + payment sheets internally. ToS is rendered inside the button view.
 
+Already know the user? Pass a third `prefill` argument (`email`, `firstName`, `lastName`, `phoneNumber` — all optional) to have the OnramperID screens arrive pre-populated. It's best-effort and never blocks sign-in. See [prefilling known user values](docs/GETTING_STARTED.md#prefilling-known-user-values) — note the caveat on `email` before supplying it.
+
 ## Checkout events
 
 The SwiftUI `OnramperCheckoutButton` does not expose external callback hooks; checkout outcomes flow via the module-level event stream:
 
 ```ts
+const onFinalized = client.addEventListener('checkoutFinalized', ({ response }) => {
+  // Durable transaction identifier: store this for support/reconciliation.
+  persistTransactionId(response.onramperTransactionId);
+});
+
 const unsub = client.addEventListener('completed', (e) => {
   console.log('done:', e.checkoutId);
 });
@@ -72,6 +79,10 @@ const onFailed = client.addEventListener('failed', (e) => {
 });
 ```
 
+`checkoutStarted.intentId` and `completed.checkoutId` identify an attempt, while
+`onramperTransactionId` identifies the transaction and is available before payment rendering.
+`client.currentTransactionId` mirrors the same value; `reset()` clears it.
+
 ## Error handling
 
 All native errors arrive as `OnramperError` with a typed `code`:

package/ios/Frameworks/OnramperSDK.xcframework/Info.plist

@@ -10,18 +10,15 @@
 			<key>DebugSymbolsPath</key>
 			<string>dSYMs</string>
 			<key>LibraryIdentifier</key>
-			<string>ios-arm64_x86_64-simulator</string>
+			<string>ios-arm64</string>
 			<key>LibraryPath</key>
 			<string>OnramperSDK.framework</string>
 			<key>SupportedArchitectures</key>
 			<array>
 				<string>arm64</string>
-				<string>x86_64</string>
 			</array>
 			<key>SupportedPlatform</key>
 			<string>ios</string>
-			<key>SupportedPlatformVariant</key>
-			<string>simulator</string>
 		</dict>
 		<dict>
 			<key>BinaryPath</key>
@@ -29,15 +26,18 @@
 			<key>DebugSymbolsPath</key>
 			<string>dSYMs</string>
 			<key>LibraryIdentifier</key>
-			<string>ios-arm64</string>
+			<string>ios-arm64_x86_64-simulator</string>
 			<key>LibraryPath</key>
 			<string>OnramperSDK.framework</string>
 			<key>SupportedArchitectures</key>
 			<array>
 				<string>arm64</string>
+				<string>x86_64</string>
 			</array>
 			<key>SupportedPlatform</key>
 			<string>ios</string>
+			<key>SupportedPlatformVariant</key>
+			<string>simulator</string>
 		</dict>
 	</array>
 	<key>CFBundlePackageType</key>

package/ios/Frameworks/OnramperSDK.xcframework/ios-arm64/OnramperSDK.framework/Modules/OnramperSDK.swiftmodule/arm64-apple-ios.swiftinterface

@@ -161,8 +161,9 @@ public struct ToSRequirementCompletion : Swift.Codable, Swift.Sendable {
 }
 public struct CheckoutFinalizeResponse : Swift.Codable, Swift.Sendable {
   public let headlessCheckoutId: Swift.String
+  public let onramperTransactionId: Swift.String
   public let headlessCheckoutData: OnramperSDK.HeadlessCheckoutData
-  public init(headlessCheckoutId: Swift.String, headlessCheckoutData: OnramperSDK.HeadlessCheckoutData)
+  public init(headlessCheckoutId: Swift.String, onramperTransactionId: Swift.String, headlessCheckoutData: OnramperSDK.HeadlessCheckoutData)
   public func encode(to encoder: any Swift.Encoder) throws
   public init(from decoder: any Swift.Decoder) throws
 }
@@ -364,6 +365,16 @@ public struct EncryptedPayload : Swift.Codable, Swift.Sendable, Swift.Equatable
   public func encode(to encoder: any Swift.Encoder) throws
   public init(from decoder: any Swift.Decoder) throws
 }
+public struct OnramperUserPrefill : Swift.Sendable, Swift.Equatable {
+  public var email: Swift.String?
+  public var firstName: Swift.String?
+  public var lastName: Swift.String?
+  public var phoneNumber: Swift.String?
+  #if compiler(>=5.3) && $NonescapableTypes
+  public init(email: Swift.String? = nil, firstName: Swift.String? = nil, lastName: Swift.String? = nil, phoneNumber: Swift.String? = nil)
+  #endif
+  public static func == (a: OnramperSDK.OnramperUserPrefill, b: OnramperSDK.OnramperUserPrefill) -> Swift.Bool
+}
 public struct QuoteResponse : Swift.Codable, Swift.Sendable, Swift.Equatable {
   public let quoteId: Swift.String
   public let ramp: Swift.String
@@ -440,6 +451,16 @@ public enum RenderType : Swift.String, Swift.Codable, Swift.Sendable {
     get
   }
   #endif
+  #if compiler(>=5.3) && $NonescapableTypes
+  @Combine.Published @_projectedValueProperty($currentTransactionId) @_Concurrency.MainActor final public var currentTransactionId: Swift.String? {
+    get
+  }
+  #endif
+  #if compiler(>=5.3) && $NonescapableTypes
+  @_Concurrency.MainActor final public var $currentTransactionId: Combine.Published<Swift.String?>.Publisher {
+    get
+  }
+  #endif
   @_Concurrency.MainActor final public let configuration: OnramperSDK.OnramperConfiguration
   @_Concurrency.MainActor weak final public var delegate: (any OnramperSDK.OnramperDelegate)?
   @_Concurrency.MainActor final public var sessionId: Swift.String? {
@@ -450,7 +471,9 @@ public enum RenderType : Swift.String, Swift.Codable, Swift.Sendable {
   }
   @_Concurrency.MainActor convenience public init(configuration: OnramperSDK.OnramperConfiguration)
   @_Concurrency.MainActor final public func initialize(sessionId: Swift.String, sessionToken: Swift.String) async throws
-  @_Concurrency.MainActor final public func getCheckoutRequirements(_ request: OnramperSDK.CheckoutIntentRequest, buttonStyle: OnramperSDK.CheckoutButtonStyle = CheckoutButtonStyle()) async throws -> OnramperSDK.CheckoutRequirementsResult
+  #if compiler(>=5.3) && $NonescapableTypes
+  @_Concurrency.MainActor final public func getCheckoutRequirements(_ request: OnramperSDK.CheckoutIntentRequest, prefill: OnramperSDK.OnramperUserPrefill? = nil, buttonStyle: OnramperSDK.CheckoutButtonStyle = CheckoutButtonStyle()) async throws -> OnramperSDK.CheckoutRequirementsResult
+  #endif
   @_Concurrency.MainActor final public func reset() async
   @_Concurrency.MainActor final public func signOut() async
   public typealias ObjectWillChangePublisher = Combine.ObservableObjectPublisher

package/ios/Frameworks/OnramperSDK.xcframework/ios-arm64/OnramperSDK.framework/OnramperSDK_OnramperSDK.bundle/PrivacyInfo.xcprivacy

@@ -16,6 +16,42 @@
             <key>NSPrivacyCollectedDataTypeTracking</key>
             <false/>
         </dict>
+        <dict>
+            <key>NSPrivacyCollectedDataType</key>
+            <string>NSPrivacyCollectedDataTypeEmailAddress</string>
+            <key>NSPrivacyCollectedDataTypePurposes</key>
+            <array>
+                <string>NSPrivacyCollectedDataTypePurposeAppFunctionality</string>
+            </array>
+            <key>NSPrivacyCollectedDataTypeLinked</key>
+            <true/>
+            <key>NSPrivacyCollectedDataTypeTracking</key>
+            <false/>
+        </dict>
+        <dict>
+            <key>NSPrivacyCollectedDataType</key>
+            <string>NSPrivacyCollectedDataTypeName</string>
+            <key>NSPrivacyCollectedDataTypePurposes</key>
+            <array>
+                <string>NSPrivacyCollectedDataTypePurposeAppFunctionality</string>
+            </array>
+            <key>NSPrivacyCollectedDataTypeLinked</key>
+            <true/>
+            <key>NSPrivacyCollectedDataTypeTracking</key>
+            <false/>
+        </dict>
+        <dict>
+            <key>NSPrivacyCollectedDataType</key>
+            <string>NSPrivacyCollectedDataTypePhoneNumber</string>
+            <key>NSPrivacyCollectedDataTypePurposes</key>
+            <array>
+                <string>NSPrivacyCollectedDataTypePurposeAppFunctionality</string>
+            </array>
+            <key>NSPrivacyCollectedDataTypeLinked</key>
+            <true/>
+            <key>NSPrivacyCollectedDataTypeTracking</key>
+            <false/>
+        </dict>
     </array>
     <key>NSPrivacyAccessedAPITypes</key>
     <array/>

package/ios/Frameworks/OnramperSDK.xcframework/ios-arm64/OnramperSDK.framework/PrivacyInfo.xcprivacy

@@ -16,6 +16,42 @@
             <key>NSPrivacyCollectedDataTypeTracking</key>
             <false/>
         </dict>
+        <dict>
+            <key>NSPrivacyCollectedDataType</key>
+            <string>NSPrivacyCollectedDataTypeEmailAddress</string>
+            <key>NSPrivacyCollectedDataTypePurposes</key>
+            <array>
+                <string>NSPrivacyCollectedDataTypePurposeAppFunctionality</string>
+            </array>
+            <key>NSPrivacyCollectedDataTypeLinked</key>
+            <true/>
+            <key>NSPrivacyCollectedDataTypeTracking</key>
+            <false/>
+        </dict>
+        <dict>
+            <key>NSPrivacyCollectedDataType</key>
+            <string>NSPrivacyCollectedDataTypeName</string>
+            <key>NSPrivacyCollectedDataTypePurposes</key>
+            <array>
+                <string>NSPrivacyCollectedDataTypePurposeAppFunctionality</string>
+            </array>
+            <key>NSPrivacyCollectedDataTypeLinked</key>
+            <true/>
+            <key>NSPrivacyCollectedDataTypeTracking</key>
+            <false/>
+        </dict>
+        <dict>
+            <key>NSPrivacyCollectedDataType</key>
+            <string>NSPrivacyCollectedDataTypePhoneNumber</string>
+            <key>NSPrivacyCollectedDataTypePurposes</key>
+            <array>
+                <string>NSPrivacyCollectedDataTypePurposeAppFunctionality</string>
+            </array>
+            <key>NSPrivacyCollectedDataTypeLinked</key>
+            <true/>
+            <key>NSPrivacyCollectedDataTypeTracking</key>
+            <false/>
+        </dict>
     </array>
     <key>NSPrivacyAccessedAPITypes</key>
     <array/>