@onramper/onramper-react-native 1.1.0 → 1.2.0

package/CHANGELOG.md

@@ -2,6 +2,42 @@
 
 All notable changes to this project are documented in this file.
 
+## [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,6 +58,8 @@ 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:

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

@@ -119,11 +119,12 @@ extension OnramperSDK.OnramperDelegate {
 public struct CheckoutFinalizeRequest : Swift.Codable, Swift.Sendable {
   public let headlessCheckoutId: Swift.String
   public let quote: OnramperSDK.QuoteResponse
+  public let encryption: OnramperSDK.EncryptedPayload
   public let onramperTransactionData: OnramperSDK.OnramperTransactionData
   public var requirementCompletions: [OnramperSDK.RequirementCompletion]?
   public var partnerContext: Swift.String?
   #if compiler(>=5.3) && $NonescapableTypes
-  public init(headlessCheckoutId: Swift.String, quote: OnramperSDK.QuoteResponse, onramperTransactionData: OnramperSDK.OnramperTransactionData, requirementCompletions: [OnramperSDK.RequirementCompletion]? = nil, partnerContext: Swift.String? = nil)
+  public init(headlessCheckoutId: Swift.String, quote: OnramperSDK.QuoteResponse, encryption: OnramperSDK.EncryptedPayload, onramperTransactionData: OnramperSDK.OnramperTransactionData, requirementCompletions: [OnramperSDK.RequirementCompletion]? = nil, partnerContext: Swift.String? = nil)
   #endif
   public func encode(to encoder: any Swift.Encoder) throws
   public init(from decoder: any Swift.Decoder) throws
@@ -210,9 +211,10 @@ public struct WalletInfo : Swift.Codable, Swift.Sendable, Swift.Equatable {
 }
 public struct CheckoutIntentResponse : Swift.Codable, Swift.Sendable {
   public let quote: OnramperSDK.QuoteResponse
+  public let encryption: OnramperSDK.EncryptedPayload
   public let headlessCheckoutId: Swift.String
   public let checkoutRequirements: [OnramperSDK.CheckoutRequirement]
-  public init(quote: OnramperSDK.QuoteResponse, headlessCheckoutId: Swift.String, checkoutRequirements: [OnramperSDK.CheckoutRequirement])
+  public init(quote: OnramperSDK.QuoteResponse, encryption: OnramperSDK.EncryptedPayload, headlessCheckoutId: Swift.String, checkoutRequirements: [OnramperSDK.CheckoutRequirement])
   public init(from decoder: any Swift.Decoder) throws
   public func encode(to encoder: any Swift.Encoder) throws
 }
@@ -351,6 +353,27 @@ extension OnramperSDK.CheckoutRequirement : Swift.Codable {
   public init(from decoder: any Swift.Decoder) throws
   public func encode(to encoder: any Swift.Encoder) throws
 }
+public struct EncryptedPayload : Swift.Codable, Swift.Sendable, Swift.Equatable {
+  public let v: Swift.Int
+  public let alg: Swift.String
+  public let iv: Swift.String
+  public let ciphertext: Swift.String
+  public let authTag: Swift.String
+  public init(v: Swift.Int, alg: Swift.String, iv: Swift.String, ciphertext: Swift.String, authTag: Swift.String)
+  public static func == (a: OnramperSDK.EncryptedPayload, b: OnramperSDK.EncryptedPayload) -> Swift.Bool
+  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
@@ -437,7 +460,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/>