react-native-trustdevice 1.1.5 → 2.0.0

package/Package.swift

@@ -0,0 +1,35 @@
+// swift-tools-version: 6.0
+
+import PackageDescription
+
+// React Native 0.88 links this package from
+// ios/build/generated/autolinking/libs/ReactNativeTrustDevice. These relative
+// paths point to the React Native packages generated by `react-native spm`.
+let package = Package(
+    name: "ReactNativeTrustDevice",
+    platforms: [.iOS("15.1")],
+    products: [
+        .library(name: "ReactNativeTrustDevice", targets: ["ReactNativeTrustDevice"]),
+    ],
+    dependencies: [
+        .package(name: "ReactNative", path: "../../../../xcframeworks"),
+        .package(name: "React-GeneratedCode", path: "../../../ios"),
+        .package(url: "https://github.com/trustdecision/trustdevice-pro-ios.git", from: "5.3.3"),
+    ],
+    targets: [
+        .target(
+            name: "ReactNativeTrustDevice",
+            dependencies: [
+                .product(name: "ReactHeaders", package: "ReactNative"),
+                .product(name: "ReactNativeHeaders", package: "ReactNative"),
+                .product(name: "ReactNativeDependenciesHeaders", package: "ReactNative"),
+                .product(name: "ReactAppHeaders", package: "React-GeneratedCode"),
+                .product(name: "TrustDecisionPro", package: "trustdevice-pro-ios"),
+            ],
+            path: "ios",
+            sources: ["TrustDevice.m", "TrustDeviceSe.m"],
+            publicHeadersPath: ".",
+            linkerSettings: [.unsafeFlags(["-Xlinker", "-ObjC"]) ]
+        ),
+    ]
+)

package/README.md

@@ -20,7 +20,7 @@ Please note that when integrating SDK products provided by the TrustDecision in
 
 |                           | Android                              | iOS                |
 | ------------------------- | ------------------------------------ | :----------------- |
-| Supported System Versions | Android 5.0 and above                | iOS 9.0 and above  |
+| Supported System Versions | Android 5.0 and above                | iOS 17.6 and above with the RN 0.88 SPM example (check the native SDK minimum for your own app) |
 | Supported Architectures   | armeabi-v7a, arm64-v8a, x86 | armv7,arm64,x86_64 |
 
 # Integrate
@@ -32,7 +32,80 @@ Please note that when integrating SDK products provided by the TrustDecision in
 Please execute in your react native project root directory
 
 ```shell
-  npm install --save @trustdecision/react-native-trustdevice@1.1.5
+  npm install --save react-native-trustdevice
+```
+
+### iOS (React Native 0.88.1, Swift Package Manager)
+
+The plugin contains a `Package.swift` that links the React Native bridge to
+`TrustDecisionPro` (5.3.3 or later). `TDBehavior` is not included by default.
+In an RN 0.88.1
+SPM app, install the npm package, then run the RN SPM migration in the host app:
+
+```shell
+npx react-native spm add --deintegrate
+```
+
+Open the generated Xcode project and build the app. The RN SPM autolinker
+discovers this plugin's `Package.swift`; customers do not need to add a second
+Swift package for the bridge manually. The fingerprint SDK is declared
+in the bridge manifest. Run `npx react-native spm update` after changing native
+dependencies. RN 0.88's SPM integration is experimental; use Xcode and Node
+versions supported by RN 0.88.1 (Node 22.13+).
+
+The example app keeps a comment-only `ios/Podfile` solely because CLI 20.2
+uses that filename to detect an iOS project. It is not a CocoaPods integration.
+
+The legacy `react-native-trustdevice.podspec` remains for existing CocoaPods
+hosts. Do not link the SDK through both CocoaPods and SPM in the same target.
+The native CocoaPods distribution is no longer maintained, so new iOS projects
+should use the SPM path above.
+
+### iOS behavior collection (optional)
+
+Only if your app calls `start`, `stop`, or `collect`, add
+`https://github.com/trustdecision/TDBehavior_spm` in Xcode via **File > Add
+Package Dependencies...**. Select **Exact Version** `1.5.2` and add the
+`TDBehavior` product to the host App target. Do not add it to the plugin's
+`Package.swift` or link it a second time through CocoaPods. Fingerprint APIs
+such as `getBlackBoxAsync` and `getDeviceInfoAsync` do not require this package.
+
+### Android behavior collection dependency
+
+The plugin does not bundle the Android behavior collection SDK. If behavior
+collection is required, add the following dependency to the host application's
+`android/app/build.gradle`:
+
+```gradle
+dependencies {
+    implementation 'com.trustdecision.android:behavior:1.5.1'
+}
+```
+
+Then rebuild the native application. Adding or removing this dependency cannot
+be applied through Metro hot reload.
+
+### Device information and verification UI
+
+`TrustDevice` is the enterprise module (the package's default export), and
+`TrustDeviceSe` is the standard module (named export). Both expose
+`getDeviceInfo()` and `getDeviceInfoAsync()` as Promise methods returning
+`blackBox`, `fpVersion`, `anonymousId`, `deviceRiskScore`, `sealedResult`, and
+`apiStatus: {code, message}`. The standard iOS SDK has only a callback API, so
+both methods use that asynchronous native call. Call them after initialization.
+
+```javascript
+import TrustDevice, {TrustDeviceSe} from 'react-native-trustdevice';
+
+const info = await TrustDevice.getDeviceInfoAsync();
+// For a standard-edition integration:
+// const info = await TrustDeviceSe.getDeviceInfoAsync();
+
+const captcha = await TrustDevice.showCaptcha();
+// captcha.function is onSuccess or onFailed; onReady is emitted as
+// a TrustDeviceCaptcha event (TrustDeviceSeCaptcha for the standard module).
+const liveness = await TrustDevice.showLiveness({license: 'YOUR_LICENSE'});
+// liveness.function is onSuccess or onFailed.
 ```
 
 ### AndroidManifest.xml
@@ -99,6 +172,24 @@ Declare the following permissions in the AndroidManifest.xml file under the appl
   async function getBlackBoxAsync();
 ```
 
+## Behavior collection
+
+Initialize the SDK before starting collection. There must be a real user
+interaction such as typing, tapping, or scrolling between `start` and
+`collect`; otherwise `collect` may return code `104`.
+
+```tsx
+await TrustDevice.start();
+
+const result = await TrustDevice.collect();
+// result: {code: number, payload: string, msg: string}
+
+await TrustDevice.stop();
+```
+
+`collect` returns and clears the currently buffered behavior data. `stop`
+stops collection and clears any uncollected data.
+
 ## Best Practices
 
 1. Get TrustDevice Module
@@ -176,4 +267,4 @@ Declare the following permissions in the AndroidManifest.xml file under the appl
 | runningTasks       | Whether collecting running tasks, default allowed                                                                             | Android | options["runningTasks"] = true       |
 | sensor             | Whether collecting sensor information, default allowed                                                                        | Android | options["sensor"] = true             |
 | readPhone          | Whether collecting READ _PHONE_ STATE permission-related information, default allowed                                         | Android | options["readPhone"] = true          |
-| installPackageList | Whether collecting application list information, default allowed                                                              | Android | options["installPackageList"] = true |
+| installPackageList | Whether collecting application list information, default allowed                                                              | Android | options["installPackageList"] = true |

package/android/build.gradle

@@ -25,4 +25,3 @@ dependencies {
     implementation 'com.facebook.react:react-native:+'
     implementation 'com.trustdecision.android:mobrisk:+'
 }
-  

package/android/src/main/java/com/trustdevice/TrustdeviceModule.java

@@ -17,6 +17,10 @@ import java.util.HashMap;
 import com.trustdecision.mobrisk.TDRisk;
 import com.trustdecision.mobrisk.TDRiskCallback;
 import com.trustdecision.mobrisk.TDAPISignResult;
+import com.trustdecision.mobrisk.TDBehaviorResult;
+import com.trustdecision.mobrisk.TDDeviceInfo;
+import com.trustdecision.mobrisk.TDDeviceInfoCallbackAdapter;
+import com.trustdecision.mobrisk.TDDeviceAPIStatus;
 
 public class TrustdeviceModule extends ReactContextBaseJavaModule {
     private final ReactApplicationContext reactContext;
@@ -34,11 +38,18 @@ public class TrustdeviceModule extends ReactContextBaseJavaModule {
 
     @ReactMethod
     public void initWithOptions(ReadableMap readableMap, Promise promise) {
-        if (readableMap != null) {
+        if (readableMap == null) {
+            promise.reject("initWithOptions Error", "options must not be null");
+            return;
+        }
+
+        try {
             HashMap<String, Object> options = readableMap.toHashMap();
             TDRisk.Builder builder = TDUniRiskUtils.mapToBuilder(options);
             TDRisk.initWithOptions(this.reactContext.getApplicationContext(), builder);
             promise.resolve(null);
+        } catch (Exception e) {
+            promise.reject("initWithOptions Error", e);
         }
     }
 
@@ -66,6 +77,69 @@ public class TrustdeviceModule extends ReactContextBaseJavaModule {
         }
     }
 
+    private WritableMap deviceInfoResult(TDDeviceInfo info) {
+        WritableMap result = Arguments.createMap();
+        TDDeviceAPIStatus status = info.getApiStatus();
+        int code = status == null ? -1 : status.getCode();
+        String message = status == null ? "SDK returned no API status" : status.getMessage();
+        WritableMap apiStatus = Arguments.createMap();
+        apiStatus.putInt("code", code);
+        apiStatus.putString("message", message);
+        result.putString("blackBox", info.getBlackBox());
+        result.putString("fpVersion", info.getFpVersion());
+        result.putString("anonymousId", info.getAnonymousId());
+        result.putInt("deviceRiskScore", info.getDeviceRiskScore());
+        result.putString("sealedResult", info.getSealedResult());
+        result.putMap("apiStatus", apiStatus);
+        result.putInt("code", code);
+        result.putString("msg", message);
+        return result;
+    }
+
+    @ReactMethod
+    public void getDeviceInfo(Promise promise) {
+        new Thread(() -> {
+            try {
+                TDDeviceInfo info = TDRisk.getDeviceInfo();
+                if (info == null) {
+                    promise.reject("device_info_unavailable", "SDK returned null device info");
+                } else {
+                    promise.resolve(deviceInfoResult(info));
+                }
+            } catch (Exception e) {
+                promise.reject("getDeviceInfo Error", e);
+            }
+        }, "TrustDevice-getDeviceInfo").start();
+    }
+
+    @ReactMethod
+    public void getDeviceInfoAsync(Promise promise) {
+        try {
+            TDRisk.getDeviceInfo(new TDDeviceInfoCallbackAdapter() {
+                @Override
+                public void onResult(TDDeviceInfo info) {
+                    if (info == null) {
+                        promise.reject("device_info_unavailable", "SDK returned null device info");
+                    } else {
+                        promise.resolve(deviceInfoResult(info));
+                    }
+                }
+            });
+        } catch (Exception e) {
+            promise.reject("getDeviceInfoAsync Error", e);
+        }
+    }
+
+    @ReactMethod
+    public void showCaptcha(Promise promise) {
+        TrustdeviceUiBridge.showCaptcha(reactContext, "TrustDeviceCaptcha", promise);
+    }
+
+    @ReactMethod
+    public void showLiveness(ReadableMap options, Promise promise) {
+        TrustdeviceUiBridge.showLiveness(reactContext, options, promise);
+    }
+
     @ReactMethod
     public void sign(String path, Promise promise) {
         try {
@@ -83,9 +157,43 @@ public class TrustdeviceModule extends ReactContextBaseJavaModule {
         }
     }
 
+    @ReactMethod
+    public void start(Promise promise) {
+        try {
+            TDRisk.start();
+            promise.resolve(null);
+        } catch (Exception e) {
+            promise.reject("behaviorStart Error", e);
+        }
+    }
+
+    @ReactMethod
+    public void stop(Promise promise) {
+        try {
+            TDRisk.stop();
+            promise.resolve(null);
+        } catch (Exception e) {
+            promise.reject("behaviorStop Error", e);
+        }
+    }
+
+    @ReactMethod
+    public void collect(Promise promise) {
+        try {
+            TDBehaviorResult behaviorResult = TDRisk.collect();
+            WritableMap resultMap = Arguments.createMap();
+            resultMap.putInt("code", behaviorResult.code());
+            resultMap.putString("payload", behaviorResult.payload());
+            resultMap.putString("msg", behaviorResult.msg());
+            promise.resolve(resultMap);
+        } catch (Exception e) {
+            promise.reject("behaviorCollect Error", e);
+        }
+    }
+
     @ReactMethod
     public void getSDKVersion(Promise promise) {
         String sdkVersion = TDRisk.getSDKVersion();
         promise.resolve(sdkVersion);
     }
-}
+}

package/android/src/main/java/com/trustdevice/TrustdeviceSeModule.java

@@ -38,11 +38,17 @@ public class TrustdeviceSeModule extends ReactContextBaseJavaModule {
 
     @ReactMethod
     public void initWithOptions(ReadableMap readableMap, Promise promise) {
-        if (readableMap != null) {
+        if (readableMap == null) {
+            promise.reject("initWithOptions Error", "options must not be null");
+            return;
+        }
+        try {
             HashMap<String, Object> options = readableMap.toHashMap();
             TDDeviceManager.Builder builder = TDUniRiskUtils.mapToBuilderSe(options);
             TDDeviceManager.initWithOptions(this.reactContext.getApplicationContext(), builder);
             promise.resolve(null);
+        } catch (Exception e) {
+            promise.reject("initWithOptions Error", e);
         }
     }
 
@@ -79,18 +85,20 @@ public class TrustdeviceSeModule extends ReactContextBaseJavaModule {
                     // deviceRiskScore: 设备风险分数
                     // apiStatus: API状态信息
                     // sealedResult: 密封结果
-                    int code = apiStatus.getCode();
-                    
-                    // 创建 WritableMap 来返回结构化数据
                     WritableMap resultMap = Arguments.createMap();
-                    
-                    resultMap.putInt("code", apiStatus.getCode());
+                    int code = apiStatus == null ? -1 : apiStatus.getCode();
+                    String message = apiStatus == null ? "SDK returned no API status" : apiStatus.getMessage();
+                    WritableMap statusMap = Arguments.createMap();
+                    statusMap.putInt("code", code);
+                    statusMap.putString("message", message);
+                    resultMap.putInt("code", code);
                     resultMap.putString("fpVersion", fpVersion);
                     resultMap.putString("blackBox", blackBox);
                     resultMap.putString("anonymousId", anonymousId);
                     resultMap.putInt("deviceRiskScore", deviceRiskScore);
                     resultMap.putString("sealedResult", sealedResult);
-                    resultMap.putString("msg", apiStatus.getMessage());
+                    resultMap.putMap("apiStatus", statusMap);
+                    resultMap.putString("msg", message);
 
                     promise.resolve(resultMap);   
                 }
@@ -101,6 +109,21 @@ public class TrustdeviceSeModule extends ReactContextBaseJavaModule {
         }
     }
 
+    @ReactMethod
+    public void getDeviceInfoAsync(Promise promise) {
+        getDeviceInfo(promise);
+    }
+
+    @ReactMethod
+    public void showCaptcha(Promise promise) {
+        TrustdeviceUiBridge.showCaptcha(reactContext, "TrustDeviceSeCaptcha", promise);
+    }
+
+    @ReactMethod
+    public void showLiveness(ReadableMap options, Promise promise) {
+        TrustdeviceUiBridge.showLiveness(reactContext, options, promise);
+    }
+
     @ReactMethod
     public void sign(String path, Promise promise) {
         try {
@@ -120,7 +143,7 @@ public class TrustdeviceSeModule extends ReactContextBaseJavaModule {
 
     @ReactMethod
     public void getSDKVersion(Promise promise) {
-        String sdkVersion = TDRisk.getSDKVersion();
+        String sdkVersion = TDDeviceManager.getSDKVersion();
         promise.resolve(sdkVersion);
     }
-}
+}

package/android/src/main/java/com/trustdevice/TrustdeviceUiBridge.java

@@ -0,0 +1,125 @@
+package com.trustdevice;
+
+import android.app.Activity;
+
+import com.facebook.react.bridge.Arguments;
+import com.facebook.react.bridge.Promise;
+import com.facebook.react.bridge.ReactApplicationContext;
+import com.facebook.react.bridge.ReadableMap;
+import com.facebook.react.bridge.UiThreadUtil;
+import com.facebook.react.bridge.WritableMap;
+import com.facebook.react.modules.core.DeviceEventManagerModule;
+import com.trustdecision.mobrisk.TDRisk;
+import com.trustdecision.mobrisk.TDRiskCaptchaCallback;
+import com.trustdecision.mobrisk.TDRiskLivenessCallback;
+
+import org.json.JSONObject;
+
+import java.util.Iterator;
+
+final class TrustdeviceUiBridge {
+    private TrustdeviceUiBridge() {}
+
+    static void showCaptcha(ReactApplicationContext context, String eventName, Promise promise) {
+        UiThreadUtil.runOnUiThread(() -> {
+            Activity activity = context.getCurrentActivity();
+            if (activity == null) {
+                promise.reject("captcha_no_activity", "No active Activity");
+                return;
+            }
+            try {
+                TDRisk.showCaptcha(activity, new TDRiskCaptchaCallback() {
+                    @Override
+                    public void onReady() {
+                        WritableMap ready = Arguments.createMap();
+                        ready.putString("function", "onReady");
+                        context.getJSModule(DeviceEventManagerModule.RCTDeviceEventEmitter.class)
+                            .emit(eventName, ready);
+                    }
+
+                    @Override
+                    public void onSuccess(String token) {
+                        WritableMap result = Arguments.createMap();
+                        result.putString("function", "onSuccess");
+                        result.putString("token", token);
+                        promise.resolve(result);
+                    }
+
+                    @Override
+                    public void onFailed(int code, String message) {
+                        WritableMap result = Arguments.createMap();
+                        result.putString("function", "onFailed");
+                        result.putInt("errorCode", code);
+                        result.putString("errorMsg", message);
+                        promise.resolve(result);
+                    }
+                });
+            } catch (Exception e) {
+                promise.reject("showCaptcha Error", e);
+            }
+        });
+    }
+
+    static void showLiveness(ReactApplicationContext context, ReadableMap options, Promise promise) {
+        UiThreadUtil.runOnUiThread(() -> {
+            Activity activity = context.getCurrentActivity();
+            if (activity == null) {
+                promise.reject("liveness_no_activity", "No active Activity");
+                return;
+            }
+            String license = options != null && options.hasKey("license") && !options.isNull("license")
+                ? options.getString("license") : null;
+            try {
+                TDRisk.showLiveness(activity, license, new TDRiskLivenessCallback() {
+                    @Override
+                    public void onSuccess(String json) {
+                        WritableMap result = jsonResult(json);
+                        result.putString("function", "onSuccess");
+                        promise.resolve(result);
+                    }
+
+                    @Override
+                    public void onError(String errorCode, String errorMsg, String sequenceId) {
+                        WritableMap result = Arguments.createMap();
+                        result.putString("function", "onFailed");
+                        try {
+                            result.putInt("code", Integer.parseInt(errorCode));
+                        } catch (NumberFormatException ignored) {
+                            result.putString("code", errorCode);
+                        }
+                        result.putString("message", errorMsg);
+                        result.putString("sequence_id", sequenceId);
+                        result.putString("liveness_id", "");
+                        promise.resolve(result);
+                    }
+                });
+            } catch (Exception e) {
+                promise.reject("showLiveness Error", e);
+            }
+        });
+    }
+
+    private static WritableMap jsonResult(String json) {
+        WritableMap result = Arguments.createMap();
+        try {
+            JSONObject object = new JSONObject(json);
+            Iterator<String> keys = object.keys();
+            while (keys.hasNext()) {
+                String key = keys.next();
+                Object value = object.opt(key);
+                if (value instanceof Boolean) {
+                    result.putBoolean(key, (Boolean) value);
+                } else if (value instanceof Number) {
+                    result.putDouble(key, ((Number) value).doubleValue());
+                } else if (value == JSONObject.NULL) {
+                    result.putNull(key);
+                } else if (value != null) {
+                    result.putString(key, String.valueOf(value));
+                }
+            }
+        } catch (Exception ignored) {
+            result.putString("raw", json);
+        }
+        return result;
+    }
+}

package/index.d.ts

@@ -1,4 +1,67 @@
+export interface TDSignResult {
+  code: number;
+  sign: string;
+  msg: string;
+}
 
-/// <reference types="react-scripts">
+export interface TDBehaviorResult {
+  code: number;
+  payload: string;
+  msg: string;
+}
 
-declare module 'react-native-trustdevice';
+export interface TDDeviceInfoResult {
+  blackBox: string;
+  fpVersion: string;
+  anonymousId: string;
+  deviceRiskScore: number;
+  sealedResult: string;
+  apiStatus: {code: number; message: string};
+  code: number;
+  msg: string;
+}
+
+export type TDCaptchaResult =
+  | {function: 'onSuccess'; token: string}
+  | {function: 'onFailed'; errorCode: number; errorMsg: string};
+
+export interface TDLivenessResult {
+  function: 'onSuccess' | 'onFailed';
+  code?: number | string;
+  message?: string;
+  sequence_id?: string;
+  liveness_id?: string;
+  image?: string;
+  [key: string]: unknown;
+}
+
+export interface TrustDeviceModule {
+  initWithOptions(options: Record<string, unknown>): Promise<void> | void;
+  getSDKVersion(): Promise<string>;
+  getBlackBox(): Promise<string>;
+  getBlackBoxAsync(): Promise<string>;
+  getDeviceInfo(): Promise<TDDeviceInfoResult>;
+  getDeviceInfoAsync(): Promise<TDDeviceInfoResult>;
+  sign(path: string): Promise<TDSignResult>;
+  showCaptcha(): Promise<TDCaptchaResult>;
+  showLiveness(options: {license?: string; showStyle?: 'present' | 'push'}): Promise<TDLivenessResult>;
+  start(): Promise<void>;
+  stop(): Promise<void>;
+  collect(): Promise<TDBehaviorResult>;
+}
+
+export interface TrustDeviceSeModule {
+  initWithOptions(options: Record<string, unknown>): Promise<void> | void;
+  getSDKVersion(): Promise<string>;
+  getDeviceInfo(): Promise<TDDeviceInfoResult>;
+  getDeviceInfoAsync(): Promise<TDDeviceInfoResult>;
+  sign(path: string): Promise<TDSignResult>;
+  showCaptcha(): Promise<TDCaptchaResult>;
+  showLiveness(options: {license?: string; showStyle?: 'present' | 'push'}): Promise<TDLivenessResult>;
+}
+
+declare const TrustDevice: TrustDeviceModule;
+
+export {TrustDevice};
+export const TrustDeviceSe: TrustDeviceSeModule;
+export default TrustDevice;

package/index.js

@@ -1,4 +1,11 @@
-const TrustDevice = require('./src/TrustDevice');
-export { TrustDevice };
-export default TrustDevice;
-module.exports = TrustDevice;
+// Platform files are transpiled as ES modules by Metro, while older published
+// versions of this package were consumed as CommonJS. Normalize the platform
+// export once and preserve all existing public import styles.
+const platformModule = require('./src/TrustDevice');
+const TrustDevice = platformModule.default || platformModule;
+const TrustDeviceSe = platformModule.TrustDeviceSe;
+
+module.exports = TrustDevice;
+module.exports.default = TrustDevice;
+module.exports.TrustDevice = TrustDevice;
+module.exports.TrustDeviceSe = TrustDeviceSe;

package/ios/TrustDevice.h

@@ -6,11 +6,11 @@
 //
 
 #import <Foundation/Foundation.h>
-#import <React/RCTBridgeModule.h>
+#import <React/RCTEventEmitter.h>
 
 NS_ASSUME_NONNULL_BEGIN
 
-@interface TrustDevice : NSObject <RCTBridgeModule>
+@interface TrustDevice : RCTEventEmitter <RCTBridgeModule>
 
 @end