(feat) [ONR-511] Migration to Nitro Modules

.github/workflows/ci.yml

@@ -14,7 +14,7 @@ jobs:
         with:
           node-version: '20'
           cache: 'npm'
-      - run: npm ci --legacy-peer-deps
+      - run: npm ci
       - run: npm run lint
       - run: npm run typecheck
       - run: npx jest
@@ -34,6 +34,12 @@ jobs:
         with:
           node-version: '20'
           cache: 'npm'
-      - run: npm ci --legacy-peer-deps
+      - run: npm ci
       - run: npm run fetch-xcframework
+        env:
+          # Cross-repo read of the private onramper/onramper-ios release.
+          # The auto GITHUB_TOKEN is scoped to this repo only, so a
+          # fine-grained PAT (Contents: Read-only on onramper-ios) is required.
+          # Remove this once onramper-ios is public.
+          GH_TOKEN: ${{ secrets.RELEASE_REPO_TOKEN }}
       - run: npm run verify-version

.github/workflows/release.yml

@@ -63,7 +63,7 @@ jobs:
           node -e "const fs=require('fs');const p=JSON.parse(fs.readFileSync('package.json'));p.version=process.env.VERSION;p.onramperSDK={checksum:'PENDING_FETCH'};fs.writeFileSync('package.json',JSON.stringify(p,null,2)+'\n');"
 
       - name: Fetch xcframework + checksum
-        run: npm ci --legacy-peer-deps && npm run fetch-xcframework
+        run: npm ci && npm run fetch-xcframework
 
       - name: Verify checksum recorded
         run: npm run verify-version

.gitignore

@@ -1,6 +1,6 @@
 # Node
 node_modules/
-build/
+lib/
 *.log
 npm-debug.log
 yarn-debug.log
@@ -14,17 +14,17 @@ ios/Pods/
 android/build/
 android/.gradle/
 
-# Example app
-example/node_modules/
-example/ios/Pods/
-example/ios/build/
-example/android/build/
-example/android/.gradle/
-example/android/app/build/
-example/.expo/
-example/.bundle/
-example/vendor/
-example/env.local.ts
+# Expo example app
+example-expo/node_modules/
+example-expo/ios/Pods/
+example-expo/ios/build/
+example-expo/android/build/
+example-expo/android/.gradle/
+example-expo/android/app/build/
+example-expo/.expo/
+example-expo/.bundle/
+example-expo/vendor/
+example-expo/env.local.ts
 
 # Xcode
 *.pbxuser
@@ -67,5 +67,6 @@ jsconfig.json
 # Local secrets
 .env
 .env.local
-example/.env
-example/.env.local
+example-expo/.env
+example-expo/.env.local
+example/env.local.ts

LICENSE

@@ -0,0 +1,21 @@
+The MIT License
+
+Copyright (c) 2026 - Onramper Technologies B.V. (https://onramper.com)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

OnramperReactNative.podspec

@@ -0,0 +1,36 @@
+require 'json'
+
+package = JSON.parse(File.read(File.join(__dir__, 'package.json')))
+
+Pod::Spec.new do |s|
+  s.name           = 'OnramperReactNative'
+  s.version        = package['version']
+  s.summary        = package['description']
+  s.description    = package['description']
+  s.license        = { :type => 'UNLICENSED' }
+  s.author         = package['author']
+  s.homepage       = package['homepage']
+  s.platforms      = { :ios => '16.0' }
+  s.swift_version  = '5.9'
+  s.source         = { :git => "#{package['repository']}.git", :tag => "v#{s.version}" }
+
+  s.pod_target_xcconfig = {
+    'DEFINES_MODULE' => 'YES',
+  }
+
+  # This podspec lives at the package root (not ios/) because nitrogen emits its
+  # generated source globs (nitrogen/generated/**) relative to the podspec's
+  # directory via add_nitrogen_files below. Our own sources are ios/-prefixed.
+  s.source_files        = 'ios/*.swift'
+  s.vendored_frameworks = 'ios/Frameworks/OnramperSDK.xcframework'
+
+  load File.join(__dir__, 'nitrogen', 'generated', 'ios', 'OnramperReactNative+autolinking.rb')
+  add_nitrogen_files(s)
+
+  # Wires up the React Native new-architecture dependencies and header search
+  # paths (React-Core, React-RCTFabric, ReactCommon, Yoga, folly, …). Required
+  # because our Nitro View's generated code includes React Fabric headers, which
+  # transitively include yoga/style/Style.h — without this the pod fails to
+  # compile with "'yoga/style/Style.h' file not found".
+  install_modules_dependencies(s)
+end

README.md

@@ -7,18 +7,20 @@ React Native wrapper for the Onramper iOS SDK.
 ## Install
 
 ```bash
-npm install @onramper/react-native expo-modules-core
+npm install @onramper/react-native react-native-nitro-modules
 cd ios && pod install
 ```
 
-Requires React Native 0.81+, `expo-modules-core` 56+, and iOS deployment target 16.4. Works in bare RN and Expo dev clients (not Expo Go — the package vendors a native binary).
+Requires React Native 0.79+, `react-native-nitro-modules` 0.35+, the **New Architecture**, and an iOS **16.0+** deployment target. Works in **bare React Native (no Expo required)** and **Expo** apps — not Expo Go, since the package vendors a native binary.
 
-If your app doesn't yet use Expo Modules:
+**Expo apps** — add the bundled config plugin to `app.json`, then prebuild:
 
-```bash
-npx install-expo-modules@latest
+```json
+{ "expo": { "plugins": ["@onramper/react-native"] } }
 ```
 
+The plugin applies the required iOS build flag (it does not change your deployment target). Set your app's deployment target to **16.4+** — Expo SDK 56's own minimum (bare RN only needs 16.0). For bare-RN Podfile setup (Xcode 16+/26) and full details, see the [integration guide](docs/INTEGRATION.md).
+
 ## Quick start
 
 ```ts
@@ -100,13 +102,13 @@ Full code list in `src/errors.ts`.
 
 The vendored `OnramperSDK.xcframework` already ships its own `PrivacyInfo.xcprivacy`. Don't add a duplicate.
 
-## Known limitations (v1)
+## Known limitations
 
-- `CheckoutEvent.checkoutCancelled` is not surfaced in this release — the bundled `OnramperSDK@1.0.0` xcframework doesn't include the case. It will be available when the SDK is rebuilt with the case.
-- Native checkout outcomes flow via the module-level event stream (`client.addEventListener(...)`), not per-view event handlers. The view's `onCheckoutCompleted`/`onCheckoutFailed`/`onCheckoutCancelled` props are declared for forward-compat but only `onCheckoutFailed` fires today (for handle-binding errors).
+- Native checkout outcomes are observed via the module-level event stream (`client.addEventListener(...)`); the native checkout button exposes no per-instance callbacks.
 
 ## Troubleshooting
 
 - **`pod install` fails finding the xcframework** — confirm `node_modules/@onramper/react-native/ios/Frameworks/OnramperSDK.xcframework/` exists.
+- **Bare RN build fails with `module map file ... not found` (Xcode 16+/26)** — disable explicit Swift modules in your `Podfile` `post_install` (`SWIFT_ENABLE_EXPLICIT_MODULES = NO`). Expo apps get this automatically via the config plugin. See the [integration guide](docs/INTEGRATION.md).
 - **App Attest errors in simulator** — expected. App Attest only works on real devices. The SDK surfaces this as `attestationFailed`.
 - **Buttons appear but sheets don't open** — the host RN screen must be inside a normal `UIViewController` (the default). Modal-presented screens may need extra care; report an issue with a repro.