@onramper/onramper-react-native 1.3.0 → 1.4.0

package/CHANGELOG.md

@@ -2,6 +2,96 @@
 
 All notable changes to this project are documented in this file.
 
+## [1.4.0]
+
+Bundles `OnramperSDK@1.4.0` from its published, checksum-verified release.
+
+Most changes in this release come from
+[OnramperSDK for iOS 1.4.0](https://github.com/onramper/onramper-ios/releases/tag/v1.4.0).
+
+### Added
+
+- **Trusted partner login.** If your backend has already verified the user's
+  email, add `user: { email }` to the signed `client-sessions` request. On Buy,
+  the user is signed in to OnramperID without the email OTP:
+  - **Best case:** no login UI at all — the user goes straight to the payment sheet.
+  - **Profile fields missing:** only the OnramperID "additional info" form
+    appears. There is no OTP screen and no "Grant permission" screen.
+  - If an OnramperID account already exists for that email, the user is signed
+    in to it; otherwise one is created with the email marked verified.
+
+  When `user` is sent, the session response also carries
+  `trustedLogin: "bound" | "unavailable"`. Trusted login is enabled per
+  integration — talk to your Onramper contact. Until it is, every session
+  reports `"unavailable"` and sign-in stays the normal OTP flow. It never blocks
+  sign-in: on any failure the normal OnramperID sign-in appears, with no error to
+  handle. No JavaScript API changed. See
+  [Backend session endpoint](docs/BACKEND_SESSION_ENDPOINT.md#trusted-partner-login).
+
+### Changed
+
+- `signOut()` also clears the OnramperID web session (no "continue as" the
+  previous user), closes an open login sheet without reporting an error, and
+  turns trusted login off for that client.
+- When login is needed, the Buy button spins briefly while the SDK checks for a
+  trusted login, then the login sheet appears. With a trusted login, the sheet is
+  already presented but invisible while the button spins (up to ~15s): your
+  screen stays interactive, but it can't present its own modal until the login
+  sheet appears or closes.
+- If the OnramperID page can't load, the login sheet shows **Retry** and
+  **Close** instead of staying blank. If OnramperID ends sign-in with an error,
+  the sheet closes and Buy is tappable again. A stalled sign-in now fails after
+  15 seconds instead of leaving the Buy button spinning.
+- The bare RN demo's Settings screen has a **Trusted partner login** email field
+  that re-mints the demo session with `user.email` and re-creates the client.
+  The Expo demo has the same field under Credentials, applied on the next
+  **Configure + Initialize**.
+
+### Upgrading from 1.3.1
+
+- No existing call sites need to change. Run `pod install` and rebuild the native
+  app after updating the package.
+- **When your app's signed-in user changes:** call `signOut()`, then `destroy()`
+  the client and create and initialize a new `OnramperClient` with a session
+  minted for the new user's `user.email`. Without `signOut()`, an existing
+  OnramperID login on the device wins and the next checkout reuses the previous
+  user's account.
+
+## [1.3.1]
+
+Bundles `OnramperSDK@1.3.1` from its published, checksum-verified release.
+
+### Added
+
+- **Runtime native SDK version.** `OnramperClient.sdkVersion` returns the iOS SDK
+  version actually loaded by the app, as plain semver (for example, `"1.3.1"`).
+  It is synchronous and read-only, and requires no client instance, credentials,
+  or initialization. Use it in diagnostics, analytics, or a support screen.
+
+  ```ts
+  const sdkVersion = OnramperClient.sdkVersion;
+  ```
+
+  This reports the native SDK version, not the React Native package or app
+  version. Do not infer it from the framework bundle's version fields.
+
+### Changed
+
+- The bare RN demo's Settings screen now reads the SDK version from native code
+  instead of inferring it from the JavaScript package version. The Expo demo
+  also shows the native SDK version in its build information.
+- The bare RN demo records TestFlight build number 2 and declares its use of
+  exempt encryption in `Info.plist`, avoiding a repeated encryption questionnaire
+  for future uploads. Already uploaded builds still need their declaration in
+  App Store Connect.
+
+### Upgrading from 1.3.0
+
+- Existing checkout, event, error, and logging APIs are unchanged. No existing
+  call sites need to change; the runtime version property is optional and iOS-only.
+- Run `pod install` and rebuild the native app after updating the package. A
+  JavaScript-only update cannot add the native version getter.
+
 ## [1.3.0]
 
 Bundles the published, checksum-verified `OnramperSDK@1.3.0` for iOS.

package/README.md

@@ -135,6 +135,21 @@ to start again; calling `initialize()` on a destroyed instance does not revive i
 These rules release local prepared views; they do not cancel an already submitted
 payment or guarantee cancellation of a request already sent to the backend.
 
+When your app's signed-in user changes, call `signOut()`, then `destroy()` the
+client and create and initialize a new `OnramperClient` with a session minted for
+the new user. Without `signOut()`, an existing OnramperID login on the device wins
+and the next checkout reuses the previous user's account.
+
+## Trusted partner login
+
+If your backend has already verified the user's email, add `user: { email }` to
+its signed `client-sessions` request. On Buy, the user is signed in to OnramperID
+without the email OTP — with no login UI at all, or only the "additional info"
+form when profile fields are missing. No JavaScript changes are needed; it is
+enabled per integration by Onramper and falls back to the normal OTP sign-in on
+any failure. Available with RN package 1.4.0 or newer. See
+[Backend session endpoint](docs/BACKEND_SESSION_ENDPOINT.md#trusted-partner-login).
+
 ## Diagnostic logs
 
 Pass `logLevel: 'info'` (or `'debug'`) and `logHandler: record => yourStore.append(record)`
@@ -147,6 +162,24 @@ See [debugging](docs/DEBUGGING.md) for the record shape and retention guidance.
 For migration details, including new enum cases and one-time OnramperID sign-in,
 see [1.3.0 release notes](CHANGELOG.md#130).
 
+## Runtime SDK version
+
+Read `OnramperClient.sdkVersion` to identify the native iOS SDK loaded by the app:
+
+```ts
+import { OnramperClient } from '@onramper/onramper-react-native';
+
+const sdkVersion = OnramperClient.sdkVersion; // e.g. "1.3.1"
+```
+
+This is a synchronous, read-only property. It needs no client instance, API key,
+SDK session, or initialization. Use it in diagnostics and support screens;
+read the RN package version separately from its `package.json`. Wrapper-only
+releases can have a different version from their bundled native SDK.
+
+Available on iOS with RN package 1.3.1 or newer. Run `pod install` and rebuild the
+native app after upgrading; a JavaScript-only update cannot add the native getter.
+
 ## Versioning
 
 `@onramper/onramper-react-native@X.Y.Z` always bundles `OnramperSDK@X.Y.Z` (iOS). Wrapper-only patches are published as `X.Y.Z-N` pre-releases (`npm install @onramper/onramper-react-native@next` to opt in).

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

@@ -10,15 +10,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>
 		<dict>
 			<key>BinaryPath</key>
@@ -26,18 +29,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>
 	</array>
 	<key>CFBundlePackageType</key>

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

@@ -621,6 +621,9 @@ public struct OnramperConfiguration : Swift.Sendable {
   public init(apiKey: Swift.String, clientId: Swift.String, environment: OnramperSDK.OnramperConfiguration.Environment = .production, theme: OnramperSDK.OnramperConfiguration.Theme = .system, logLevel: OnramperSDK.LogLevel = .off, logHandler: OnramperSDK.OnramperLogHandler? = nil, isEventLoggingEnabled: Swift.Bool = false, isEventConsoleLoggingEnabled: Swift.Bool = false, sessionExpirationHandler: @escaping @Sendable () async throws -> OnramperSDK.SessionCredentials)
   #endif
 }
+extension OnramperSDK.OnramperClient {
+  nonisolated public static let sdkVersion: Swift.String
+}
 public enum OnramperState : Swift.Sendable {
   case idle
   case initializing