@onramper/onramper-react-native 1.2.0 → 1.2.2-1

package/CHANGELOG.md

@@ -2,6 +2,57 @@
 
 All notable changes to this project are documented in this file.
 
+## [1.2.2-1]
+
+Wrapper-only change; still bundles `OnramperSDK@1.2.2`.
+
+### Fixed
+
+- The native checkout button no longer draws over neighbouring views. It reports its content height
+  (for example when ToS text appears under the Buy button) and sizes itself to match, and clips any
+  overflow as a backstop.
+- A checkout button given an intent that has expired or was already used now shows nothing, instead of
+  keeping the previous quote's button on screen.
+
+### Changed
+
+- No public TypeScript type changes. Containers around `button` no longer need a `minHeight`.
+- `button` is now an element of a small sizing wrapper rather than the native view itself, and it
+  manages its own `style`. Style passed with `cloneElement(button, { style })` is no longer applied;
+  style the containing `View` instead.
+- The bare example app is now a demo app: environment switching, automatic SDK initialization,
+  currency / payment / country selection, and a settings sheet.
+
+## [1.2.2]
+
+Bundles `OnramperSDK@1.2.2`.
+
+### Fixed
+
+- Fixed authentication handling during SDK session initialization and refresh.
+
+### Changed
+
+- No public React Native API changes or migration are required.
+
+## [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`.

package/README.md

@@ -56,7 +56,7 @@ return (
 );
 ```
 
-The button renders natively and presents login + payment sheets internally. ToS is rendered inside the button view.
+The button renders natively and presents login + payment sheets internally. ToS is rendered inside the button view, and the button sizes its own height to fit it — don't give its container a fixed height.
 
 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.
 
@@ -65,6 +65,11 @@ Already know the user? Pass a third `prefill` argument (`email`, `firstName`, `l
 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);
 });
@@ -74,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/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
 }
@@ -450,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? {