@trustchex/react-native-sdk 1.161.0

package/LICENSE

@@ -0,0 +1,49 @@
+# TRUSTCHEX COMMERCIAL LICENSE
+
+Copyright (c) 2025 Trustchex. All rights reserved.
+
+COMMERCIAL SOFTWARE LICENSE AGREEMENT
+
+This software and associated documentation files (the "Software") are proprietary
+and confidential to Trustchex and are protected by copyright, trade secret, and
+other intellectual property laws.
+
+LICENSE GRANT:
+Subject to the terms and conditions of this license and upon payment of applicable
+license fees, Trustchex grants you a limited, non-exclusive, non-transferable license
+to use the Software solely for the purposes specified in your commercial agreement
+with Trustchex.
+
+RESTRICTIONS:
+You may NOT:
+
+- Modify, adapt, alter, translate, or create derivative works of the Software
+- Reverse engineer, disassemble, decompile, or otherwise attempt to derive the
+  source code of the Software
+- Remove or alter any proprietary notices or labels on the Software
+- Use the Software for any commercial purpose without a valid commercial license
+- Distribute, sublicense, rent, lease, or lend the Software to any third party
+- Use the Software to develop competing products or services
+
+COMMERCIAL USE:
+Commercial use of this Software requires a separate commercial license agreement.
+Contact Trustchex at <info@trustchex.com> for licensing terms and pricing.
+
+OWNERSHIP:
+Trustchex retains all right, title, and interest in and to the Software, including
+all intellectual property rights therein.
+
+DISCLAIMER:
+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 TRUSTCHEX 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.
+
+TERMINATION:
+This license is effective until terminated. Your rights under this license will
+terminate automatically without notice if you fail to comply with any term(s) of
+this license.
+
+For licensing inquiries, contact: <info@trustchex.com>

package/README.md

@@ -0,0 +1,223 @@
+# @trustchex/react-native-sdk
+
+React Native SDK for KYC and identity verification with document scanning, facial recognition, liveness detection, and NFC eID support.
+
+> **⚠️ Commercial License Required** - Contact [info@trustchex.com](mailto:info@trustchex.com) for licensing.
+
+## Features
+
+- 📄 Document scanning (passport, ID cards) with OCR
+- 🔍 MRZ processing for travel documents
+- 📱 NFC eID card reading
+- 👤 Facial recognition and liveness detection
+- 🌐 Multi-language support (English, Turkish)
+- 🎨 Customizable branding
+- 🔗 Deep link support
+
+## Installation
+
+```sh
+npm install @trustchex/react-native-sdk
+```
+
+### Required Dependencies
+
+```sh
+npm install @react-native-community/image-editor@^4.3.0 \
+  @react-navigation/native@^7.1.14 \
+  @react-navigation/native-stack@^7.3.21 \
+  lottie-react-native@^7.2.4 \
+  react-native-compressor@^1.12.0 \
+  react-native-fast-opencv@^0.4.6 \
+  react-native-fs@^2.20.0 \
+  react-native-gesture-handler@^2.27.1 \
+  react-native-get-random-values@^1.11.0 \
+  react-native-nfc-manager@^3.16.2 \
+  react-native-paper@^5.14.5 \
+  react-native-safe-area-context@^5.5.2 \
+  react-native-screens@^4.13.1 \
+  react-native-svg@^15.12.0 \
+  react-native-tts@^4.1.1 \
+  react-native-video@^6.16.1 \
+  react-native-vision-camera@^4.7.1 \
+  react-native-webview@^13.15.0 \
+  react-native-worklets-core@^1.6.2
+```
+
+## Setup
+
+### Babel Configuration (babel.config.js)
+
+```js
+module.exports = {
+  presets: ['module:@react-native/babel-preset'],
+  plugins: [
+    'react-native-worklets-core/plugin',
+    'react-native-paper/babel',
+  ],
+};
+```
+
+### iOS (Info.plist)
+
+```xml
+<!-- Permissions -->
+<key>NSCameraUsageDescription</key>
+<string>Camera access for document scanning and selfie capture</string>
+<key>NSMicrophoneUsageDescription</key>
+<string>Microphone access for video recording during verification</string>
+<key>NFCReaderUsageDescription</key>
+<string>NFC access to read electronic ID cards</string>
+
+<!-- NFC Configuration -->
+<key>com.apple.developer.nfc.readersession.formats</key>
+<array>
+  <string>NDEF</string>
+  <string>TAG</string>
+</array>
+<key>com.apple.developer.nfc.readersession.iso7816.select-identifiers</key>
+<array>
+  <string>A0000002471001</string>
+  <string>E80704007F00070302</string>
+  <string>A000000167455349474E</string>
+  <string>A0000002480100</string>
+  <string>A0000002480200</string>
+  <string>A0000002480300</string>
+  <string>A00000045645444C2D3031</string>
+</array>
+
+<!-- Deep Link (optional) -->
+<key>CFBundleURLTypes</key>
+<array>
+  <dict>
+    <key>CFBundleURLSchemes</key>
+    <array>
+      <string>your-app-scheme</string>
+    </array>
+  </dict>
+</array>
+
+<!-- Portrait Only -->
+<key>UISupportedInterfaceOrientations</key>
+<array>
+  <string>UIInterfaceOrientationPortrait</string>
+</array>
+<key>UISupportedInterfaceOrientations~ipad</key>
+<array>
+  <string>UIInterfaceOrientationPortrait</string>
+</array>
+```
+
+### Android (AndroidManifest.xml)
+
+```xml
+<!-- Permissions -->
+<uses-permission android:name="android.permission.INTERNET" />
+<uses-permission android:name="android.permission.CAMERA" />
+<uses-permission android:name="android.permission.NFC" />
+<uses-permission android:name="android.permission.RECORD_AUDIO" />
+<uses-permission android:name="android.permission.VIBRATE" />
+
+<!-- Hardware -->
+<uses-feature android:name="android.hardware.camera" android:required="true" />
+<uses-feature android:name="android.hardware.nfc" android:required="false" />
+
+<application android:allowBackup="false">
+    <activity
+        android:name=".MainActivity"
+        android:screenOrientation="portrait"
+        android:launchMode="singleTask"
+        android:exported="true">
+
+        <!-- App Launcher -->
+        <intent-filter>
+            <action android:name="android.intent.action.MAIN" />
+            <category android:name="android.intent.category.LAUNCHER" />
+        </intent-filter>
+
+        <!-- NFC -->
+        <intent-filter>
+            <action android:name="android.nfc.action.TECH_DISCOVERED" />
+        </intent-filter>
+
+        <!-- Deep Link (optional) -->
+        <intent-filter>
+            <action android:name="android.intent.action.VIEW" />
+            <category android:name="android.intent.category.DEFAULT" />
+            <category android:name="android.intent.category.BROWSABLE" />
+            <data android:scheme="your-app-scheme" />
+        </intent-filter>
+    </activity>
+</application>
+```
+
+## Usage
+
+### Basic
+
+```tsx
+import Trustchex from '@trustchex/react-native-sdk';
+
+<Trustchex
+  baseUrl="https://your-server.com"
+  sessionId="session-id"
+  onCompleted={() => console.log('Completed')}
+  onError={(error) => console.error(error)}
+/>
+```
+
+### With Branding
+
+```tsx
+<Trustchex
+  baseUrl="https://your-server.com"
+  sessionId="session-id"
+  branding={{
+    logoUrl: 'https://your-logo.png',
+    primaryColor: '#1E3A8A',
+    secondaryColor: '#F3F4F6',
+    tertiaryColor: '#EF4444'
+  }}
+  locale="en" // 'en' | 'tr'
+  onCompleted={() => console.log('Completed')}
+  onError={(error) => console.error(error)}
+/>
+```
+
+### Deep Links
+
+```tsx
+import { handleDeepLink } from '@trustchex/react-native-sdk';
+
+const [baseUrl, sessionId] = handleDeepLink({
+  url: 'scheme://verification-session/abc123/app-url/api.server.com'
+});
+```
+
+## API
+
+| Prop | Type | Description |
+|------|------|-------------|
+| `baseUrl` | `string?` | Server URL |
+| `sessionId` | `string?` | Verification session ID |
+| `branding` | `object?` | Theme colors and logo |
+| `locale` | `'en' \| 'tr'?` | UI language |
+| `onCompleted` | `function?` | Success callback |
+| `onError` | `function?` | Error callback |
+
+## Requirements
+
+- React Native ≥ 0.79.5
+- iOS ≥ 15.6 / Android ≥ API 31
+- **Camera required** for document scanning
+- **NFC optional** for eID cards
+
+## Troubleshooting
+
+- **Camera issues**: Check permissions and device capability
+- **NFC not working**: Enable NFC in device settings (optional feature)
+- **Build errors**: Verify all peer dependencies are installed
+
+## License
+
+Commercial license required. Contact [info@trustchex.com](mailto:info@trustchex.com) for pricing.

package/TrustchexSDK.podspec

@@ -0,0 +1,26 @@
+require "json"
+
+package = JSON.parse(File.read(File.join(__dir__, "package.json")))
+
+Pod::Spec.new do |s|
+  s.name         = "TrustchexSDK"
+  s.version      = package["version"]
+  s.summary      = package["description"]
+  s.homepage     = package["homepage"]
+  s.license      = package["license"]
+  s.authors      = package["author"]
+
+  s.platforms    = { :ios => min_ios_version_supported }
+  s.source       = { :git => "https://github.com/trustchex/trustchex.git", :tag => "#{s.version}" }
+
+  s.source_files = "ios/**/*.{h,m,mm,cpp,swift}"
+  s.private_header_files = "ios/**/*.h"
+
+  # ML Kit dependencies for text recognition
+  s.dependency "GoogleMLKit/TextRecognition"
+  # ML Kit Face Detection dependency
+  s.dependency "GoogleMLKit/FaceDetection"
+  s.dependency "VisionCamera"
+
+  install_modules_dependencies(s)
+end

package/android/build.gradle

@@ -0,0 +1,103 @@
+buildscript {
+  ext.getExtOrDefault = {name ->
+    return rootProject.ext.has(name) ? rootProject.ext.get(name) : project.properties['TrustchexSDK_' + name]
+  }
+
+  repositories {
+    google()
+    mavenCentral()
+  }
+
+  dependencies {
+    classpath "com.android.tools.build:gradle:8.7.2"
+    // noinspection DifferentKotlinGradleVersion
+    classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:${getExtOrDefault('kotlinVersion')}"
+  }
+}
+
+
+apply plugin: "com.android.library"
+apply plugin: "kotlin-android"
+
+apply plugin: "com.facebook.react"
+
+def getExtOrIntegerDefault(name) {
+  return rootProject.ext.has(name) ? rootProject.ext.get(name) : (project.properties["TrustchexSDK_" + name]).toInteger()
+}
+
+android {
+  namespace "com.trustchex.reactnativesdk"
+
+  compileSdkVersion getExtOrIntegerDefault("compileSdkVersion")
+
+  defaultConfig {
+    minSdkVersion getExtOrIntegerDefault("minSdkVersion")
+    targetSdkVersion getExtOrIntegerDefault("targetSdkVersion")
+  }
+
+  buildFeatures {
+    buildConfig true
+  }
+
+  buildTypes {
+    release {
+      minifyEnabled false
+    }
+  }
+
+  lintOptions {
+    disable "GradleCompatible"
+  }
+
+  compileOptions {
+    sourceCompatibility JavaVersion.VERSION_1_8
+    targetCompatibility JavaVersion.VERSION_1_8
+  }
+
+  sourceSets {
+    main {
+      java.srcDirs += [
+        "generated/java",
+        "generated/jni"
+      ]
+    }
+  }
+}
+
+repositories {
+  mavenCentral()
+  google()
+}
+
+def kotlin_version = getExtOrDefault("kotlinVersion")
+
+dependencies {
+  implementation "com.facebook.react:react-android"
+  implementation "org.jetbrains.kotlin:kotlin-stdlib:$kotlin_version"
+
+  // VisionCamera frame processor dependency
+  implementation project(':react-native-vision-camera')
+
+  // CameraX dependencies (required for ImageProxy)
+  implementation "androidx.camera:camera-core:1.4.0"
+  implementation "androidx.camera:camera-camera2:1.4.0"
+  implementation "androidx.camera:camera-lifecycle:1.4.0"
+
+  // Google ML Kit Text Recognition dependencies
+  implementation 'com.google.mlkit:text-recognition:16.0.1'
+
+  // Google ML Kit Face Detection dependency
+  implementation 'com.google.mlkit:face-detection:16.1.7'
+
+  // Google ML Kit Barcode Scanning dependency
+  implementation 'com.google.mlkit:barcode-scanning:17.3.0'
+
+  // Google Play Services dependency for Tasks
+  implementation 'com.google.android.gms:play-services-tasks:18.2.0'
+}
+
+react {
+  jsRootDir = file("../src/")
+  libraryName = "TrustchexSDK"
+  codegenJavaPackageName = "com.trustchex.reactnativesdk"
+}

package/android/gradle.properties

@@ -0,0 +1,5 @@
+TrustchexSDK_kotlinVersion=2.0.21
+TrustchexSDK_minSdkVersion=31
+TrustchexSDK_targetSdkVersion=36
+TrustchexSDK_compileSdkVersion=36
+TrustchexSDK_ndkVersion=27.1.12297006

package/android/src/main/AndroidManifest.xml

@@ -0,0 +1,11 @@
+<manifest xmlns:tools="http://schemas.android.com/tools"
+  xmlns:android="http://schemas.android.com/apk/res/android"
+  package="com.trustchex.reactnativesdk">
+  <uses-permission android:name="android.permission.INTERNET" />
+  <uses-permission android:name="android.permission.CAMERA" />
+  <uses-permission android:name="android.permission.NFC" />
+  <uses-permission android:name="android.permission.RECORD_AUDIO" />
+  <uses-permission android:name="android.permission.VIBRATE" />
+  <uses-feature android:name="android.hardware.camera" android:required="false" />
+  <uses-feature android:name="android.hardware.nfc" android:required="false" />
+</manifest>

package/android/src/main/java/com/trustchex/reactnativesdk/TrustchexSDKModule.kt

@@ -0,0 +1,40 @@
+package com.trustchex.reactnativesdk
+
+import android.view.WindowManager
+import com.facebook.react.bridge.ReactApplicationContext
+import com.facebook.react.bridge.ReactMethod
+import com.facebook.react.bridge.UiThreadUtil
+import com.facebook.react.module.annotations.ReactModule
+
+@ReactModule(name = TrustchexSDKModule.NAME)
+class TrustchexSDKModule(reactContext: ReactApplicationContext) :
+        NativeTrustchexSDKSpec(reactContext) {
+
+  override fun getName(): String {
+    return NAME
+  }
+
+  @ReactMethod
+  override fun enableKeepAwake() {
+    UiThreadUtil.runOnUiThread {
+      val activity = currentActivity
+      activity?.runOnUiThread {
+        activity.window.addFlags(WindowManager.LayoutParams.FLAG_KEEP_SCREEN_ON)
+      }
+    }
+  }
+
+  @ReactMethod
+  override fun disableKeepAwake() {
+    UiThreadUtil.runOnUiThread {
+      val activity = currentActivity
+      activity?.runOnUiThread {
+        activity.window.clearFlags(WindowManager.LayoutParams.FLAG_KEEP_SCREEN_ON)
+      }
+    }
+  }
+
+  companion object {
+    const val NAME = "TrustchexSDK"
+  }
+}

package/android/src/main/java/com/trustchex/reactnativesdk/TrustchexSDKPackage.kt

@@ -0,0 +1,61 @@
+package com.trustchex.reactnativesdk
+
+import com.facebook.react.BaseReactPackage
+import com.facebook.react.bridge.NativeModule
+import com.facebook.react.bridge.ReactApplicationContext
+import com.facebook.react.module.model.ReactModuleInfo
+import com.facebook.react.module.model.ReactModuleInfoProvider
+import com.mrousavy.camera.frameprocessors.FrameProcessorPluginRegistry
+import com.trustchex.reactnativesdk.visioncameraplugins.barcodescanner.BarcodeScannerFrameProcessorPlugin
+import com.trustchex.reactnativesdk.visioncameraplugins.cropper.CropperPlugin
+import com.trustchex.reactnativesdk.visioncameraplugins.facedetector.FaceDetectorFrameProcessorPlugin
+import com.trustchex.reactnativesdk.visioncameraplugins.textrecognition.TextRecognitionFrameProcessorPlugin
+import java.util.HashMap
+
+class TrustchexSDKPackage : BaseReactPackage() {
+  companion object {
+    init {
+      // Register frame processor plugins for text recognition
+      FrameProcessorPluginRegistry.addFrameProcessorPlugin("scanText") { proxy, options ->
+        TextRecognitionFrameProcessorPlugin(proxy, options)
+      }
+      // Register frame processor plugin for face detection
+      FrameProcessorPluginRegistry.addFrameProcessorPlugin("detectFaces") { _, options ->
+        FaceDetectorFrameProcessorPlugin(options)
+      }
+      // Register frame processor plugin for barcode scanning
+      FrameProcessorPluginRegistry.addFrameProcessorPlugin("scanCodes") { proxy, options ->
+        BarcodeScannerFrameProcessorPlugin(proxy, options)
+      }
+      // Register frame processor plugin for image cropping
+      FrameProcessorPluginRegistry.addFrameProcessorPlugin("crop") { proxy, options ->
+        CropperPlugin(proxy, options)
+      }
+    }
+  }
+  override fun getModule(name: String, reactContext: ReactApplicationContext): NativeModule? {
+    return when (name) {
+      TrustchexSDKModule.NAME -> TrustchexSDKModule(reactContext)
+      else -> null
+    }
+  }
+
+  override fun getReactModuleInfoProvider(): ReactModuleInfoProvider {
+    return ReactModuleInfoProvider {
+      val moduleInfos: MutableMap<String, ReactModuleInfo> = HashMap()
+
+      // Main SDK module
+      moduleInfos[TrustchexSDKModule.NAME] =
+              ReactModuleInfo(
+                      TrustchexSDKModule.NAME,
+                      TrustchexSDKModule.NAME,
+                      false, // canOverrideExistingModule
+                      false, // needsEagerInit
+                      false, // isCxxModule
+                      true // isTurboModule
+              )
+
+      moduleInfos
+    }
+  }
+}