@nsure-ai/react-native-client-sdk

Official React Native SDK wrapper for nSure (Android & iOS)

Easily integrate the nSure SDK into your React Native applications using this unified npm package.

Prerequisites

• React Native 0.78+

Installation

Using npm:

npm install @nsure-ai/react-native-client-sdk
npx pod-install

Usage

Step 1: Initialize nSure SDK

Call initialize with your App ID, Partner ID, and optionally a configBaseUrl parameter (can be null) to override the default configuration endpoint:

import NSure from '@nsure-ai/react-native-client-sdk';

// Basic initialization
await NSure.initialize('YOUR_APP_ID', 'OPTIONAL_PARTNER_ID');

// Optionally specify a custom configuration base URL (can be null)
await NSure.initialize('YOUR_APP_ID', 'OPTIONAL_PARTNER_ID', 'https://custom-config-url.com');

Note:

• On Android: appId, partnerId, and optional configBaseUrl (can be null) are passed into the native SDK.
• On iOS: appId, partnerId, and optional configBaseUrl (can be null) are passed into the native SDK.

Step 2: Retrieve Device ID

Once initialized, get the device ID:

const deviceId = await NSure.getDeviceId();

This deviceId must be sent to your server to identify sessions.

Step 3: Pass Device ID to Your Server

Include the deviceId in your API requests under sessionInfo:

{
  "sessionInfo": {
    "deviceId": "DEVICE_ID_FROM_SDK"
  }
}

Step 4: (Optional) Check SDK Version

At any time you can read the nSure SDK version:

const sdkVersion = await NSure.getVersion();
console.log('nSure SDK Version:', sdkVersion);

Native Dependencies

Android (Gradle) - (Handled Automatically)

Your app does not need any manual changes. This package automatically adds:

implementation 'com.github.nsure-ai:android-sdk:1.3.12'
implementation 'com.fingerprint.android:pro:2.8.0'

AndroidManifest.xml - Add screen-capture permission

In your AndroidManifest.xml, add:

<uses-permission android:name="android.permission.DETECT_SCREEN_CAPTURE" />

This permission is required for nSure to detect when the user takes a screenshot.

iOS (CocoaPods) - (Handled Automatically)

CocoaPods integration is driven by nsure.podspec. After installing:

npx pod-install

the nSure iOS SDK (nSure pod) is pulled via CocoaPods and the framework is embedded automatically.

iOS — New Architecture

This package supports both Old Architecture (Bridge) and New Architecture (TurboModules) on both iOS and Android. No special configuration is needed — the correct code path is selected automatically at build time.

Troubleshooting

• Native Module "NSureSDK" is null • Make sure you've rebuilt your app (npx react-native run-android / run-ios) • Clear Metro cache: npx react-native start --reset-cache • Confirm @nsure-ai/react-native-client-sdk appears in npx react-native config

• TurboModule argument errors If you see "expected X arguments," ensure you're on RN 0.78+ and using the latest version of this package, which uses Promise‐based bridges.

• App crashes with EXC_BAD_ACCESS or performVoidMethodInvocation Ensure you are using version 1.4.0+ which supports both Old and New Architecture. If on an older version, upgrade or disable New Architecture.

Happy coding! 🚀