react-native-usesense 1.0.0

package/android/src/main/java/com/usesense/reactnative/UseSenseModule.kt

@@ -0,0 +1,158 @@
+package com.usesense.reactnative
+
+import com.facebook.react.bridge.*
+import com.facebook.react.modules.core.DeviceEventManagerModule
+import com.usesense.sdk.*
+
+class UseSenseModule(private val reactContext: ReactApplicationContext) :
+    ReactContextBaseJavaModule(reactContext) {
+
+    override fun getName(): String = "UseSenseModule"
+
+    private var eventUnsubscribe: (() -> Unit)? = null
+
+    @ReactMethod
+    fun initialize(configMap: ReadableMap) {
+        val apiKey = configMap.getString("apiKey")
+            ?: throw IllegalArgumentException("apiKey is required")
+
+        val branding = if (configMap.hasKey("branding")) {
+            val b = configMap.getMap("branding")
+            BrandingConfig(
+                logoUrl = b?.getString("logoUrl"),
+                primaryColor = b?.getString("primaryColor") ?: "#4F63F5",
+                buttonRadius = if (b?.hasKey("buttonRadius") == true) b.getInt("buttonRadius") else 12,
+                fontFamily = b?.getString("fontFamily"),
+            )
+        } else null
+
+        val environment = when (configMap.getString("environment")) {
+            "sandbox" -> UseSenseEnvironment.SANDBOX
+            "production" -> UseSenseEnvironment.PRODUCTION
+            else -> UseSenseEnvironment.AUTO
+        }
+
+        val config = UseSenseConfig(
+            apiKey = apiKey,
+            environment = environment,
+            baseUrl = configMap.getString("baseUrl") ?: UseSenseConfig.DEFAULT_BASE_URL,
+            gatewayKey = configMap.getString("gatewayKey"),
+            branding = branding,
+            googleCloudProjectNumber = if (configMap.hasKey("googleCloudProjectNumber"))
+                configMap.getDouble("googleCloudProjectNumber").toLong()
+            else UseSenseConfig.DEFAULT_GOOGLE_CLOUD_PROJECT_NUMBER,
+        )
+
+        val context = reactContext.applicationContext
+        UseSense.initialize(context, config)
+    }
+
+    @ReactMethod
+    fun startVerification(requestMap: ReadableMap, promise: Promise) {
+        val activity = currentActivity
+        if (activity == null) {
+            promise.reject("NO_ACTIVITY", "No current activity available")
+            return
+        }
+
+        val sessionType = when (requestMap.getString("sessionType")) {
+            "authentication" -> SessionType.AUTHENTICATION
+            else -> SessionType.ENROLLMENT
+        }
+
+        val metadata: Map<String, Any>? = if (requestMap.hasKey("metadata")) {
+            requestMap.getMap("metadata")?.toHashMap()
+        } else null
+
+        val request = VerificationRequest(
+            sessionType = sessionType,
+            externalUserId = requestMap.getString("externalUserId"),
+            identityId = requestMap.getString("identityId"),
+            metadata = metadata,
+        )
+
+        UseSense.startVerification(activity, request, object : UseSenseCallback {
+            override fun onSuccess(result: UseSenseResult) {
+                val map = Arguments.createMap().apply {
+                    putString("sessionId", result.sessionId)
+                    putString("sessionType", result.sessionType)
+                    putString("identityId", result.identityId)
+                    putString("decision", result.decision)
+                    putString("timestamp", result.timestamp)
+                    putBoolean("isApproved", result.isApproved)
+                    putBoolean("isRejected", result.isRejected)
+                    putBoolean("isPendingReview", result.isPendingReview)
+                }
+                promise.resolve(map)
+            }
+
+            override fun onError(error: UseSenseError) {
+                val details = Arguments.createMap().apply {
+                    putInt("code", error.code)
+                    putString("serverCode", error.serverCode)
+                    putString("message", error.message)
+                    putBoolean("isRetryable", error.isRetryable)
+                }
+                promise.reject(
+                    error.code.toString(),
+                    error.message,
+                    Exception(error.message),
+                    details,
+                )
+            }
+
+            override fun onCancelled() {
+                promise.reject("CANCELLED", "Verification was cancelled by the user")
+            }
+        })
+    }
+
+    @ReactMethod
+    fun subscribeToEvents() {
+        eventUnsubscribe?.invoke()
+        eventUnsubscribe = UseSense.onEvent { event ->
+            val map = Arguments.createMap().apply {
+                putString("type", event.type.name)
+                putDouble("timestamp", event.timestamp.toDouble())
+                if (event.data != null) {
+                    putMap("data", Arguments.makeNativeMap(event.data as Map<String, Any>))
+                }
+            }
+            sendEvent("UseSenseEvent", map)
+        }
+    }
+
+    @ReactMethod
+    fun unsubscribeFromEvents() {
+        eventUnsubscribe?.invoke()
+        eventUnsubscribe = null
+    }
+
+    @ReactMethod
+    fun reset() {
+        eventUnsubscribe?.invoke()
+        eventUnsubscribe = null
+        UseSense.reset()
+    }
+
+    @ReactMethod
+    fun isInitialized(promise: Promise) {
+        promise.resolve(UseSense.isInitialized)
+    }
+
+    private fun sendEvent(eventName: String, params: WritableMap) {
+        reactContext
+            .getJSModule(DeviceEventManagerModule.RCTDeviceEventEmitter::class.java)
+            .emit(eventName, params)
+    }
+
+    @ReactMethod
+    fun addListener(eventType: String) {
+        // Required for NativeEventEmitter
+    }
+
+    @ReactMethod
+    fun removeListeners(count: Int) {
+        // Required for NativeEventEmitter
+    }
+}

package/android/src/main/java/com/usesense/reactnative/UseSensePackage.kt

@@ -0,0 +1,17 @@
+package com.usesense.reactnative
+
+import com.facebook.react.ReactPackage
+import com.facebook.react.bridge.NativeModule
+import com.facebook.react.bridge.ReactApplicationContext
+import com.facebook.react.uimanager.ViewManager
+
+class UseSensePackage : ReactPackage {
+
+    override fun createNativeModules(reactContext: ReactApplicationContext): List<NativeModule> {
+        return listOf(UseSenseModule(reactContext))
+    }
+
+    override fun createViewManagers(reactContext: ReactApplicationContext): List<ViewManager<*, *>> {
+        return emptyList()
+    }
+}

package/ios/UseSenseModule.m

@@ -0,0 +1,25 @@
+#import <React/RCTBridgeModule.h>
+#import <React/RCTEventEmitter.h>
+
+@interface RCT_EXTERN_MODULE(UseSenseModule, RCTEventEmitter)
+
+RCT_EXTERN_METHOD(initialize:(NSDictionary *)config)
+
+RCT_EXTERN_METHOD(startSession:(NSDictionary *)options
+                  resolver:(RCTPromiseResolveBlock)resolve
+                  rejecter:(RCTPromiseRejectBlock)reject)
+
+RCT_EXTERN_METHOD(cancelSession:(RCTPromiseResolveBlock)resolve
+                  rejecter:(RCTPromiseRejectBlock)reject)
+
+RCT_EXTERN_METHOD(getSessionStatus:(NSString *)sessionId
+                  resolver:(RCTPromiseResolveBlock)resolve
+                  rejecter:(RCTPromiseRejectBlock)reject)
+
+RCT_EXTERN_METHOD(subscribeToEvents)
+
+RCT_EXTERN_METHOD(unsubscribeFromEvents)
+
+RCT_EXTERN_METHOD(getSdkVersion)
+
+@end

package/ios/UseSenseModule.swift

@@ -0,0 +1,148 @@
+import Foundation
+import React
+import UseSenseSDK
+
+@objc(UseSenseModule)
+class UseSenseModule: RCTEventEmitter {
+
+    private var hasListeners = false
+
+    override func supportedEvents() -> [String]! {
+        return ["UseSenseEvent"]
+    }
+
+    override func startObserving() {
+        hasListeners = true
+    }
+
+    override func stopObserving() {
+        hasListeners = false
+    }
+
+    @objc
+    func initialize(_ config: NSDictionary) {
+        guard let apiKey = config["apiKey"] as? String else {
+            return
+        }
+
+        let environment: UseSenseEnvironment = {
+            switch config["environment"] as? String {
+            case "production": return .production
+            case "sandbox": return .sandbox
+            default: return .sandbox
+            }
+        }()
+
+        let useSenseConfig = UseSenseConfig(
+            apiKey: apiKey,
+            environment: environment,
+            organizationId: config["organizationId"] as? String,
+            sessionType: (config["sessionType"] as? String) == "authentication" ? .authentication : .enrollment,
+            challengePolicy: {
+                switch config["challengePolicy"] as? String {
+                case "enhanced": return .enhanced
+                case "adaptive": return .adaptive
+                default: return .standard
+                }
+            }(),
+            enableAudio: config["enableAudio"] as? Bool ?? false,
+            timeout: config["timeout"] as? TimeInterval ?? 60000,
+            metadata: config["metadata"] as? [String: String]
+        )
+
+        UseSense.initialize(config: useSenseConfig)
+    }
+
+    @objc
+    func startSession(_ options: NSDictionary, resolver resolve: @escaping RCTPromiseResolveBlock, rejecter reject: @escaping RCTPromiseRejectBlock) {
+        DispatchQueue.main.async {
+            guard let viewController = RCTPresentedViewController() else {
+                reject("no_view_controller", "No view controller available", nil)
+                return
+            }
+
+            let sessionType: SessionType = (options["sessionType"] as? String) == "authentication" ? .authentication : .enrollment
+            let identityId = options["identityId"] as? String
+
+            UseSense.startSession(
+                from: viewController,
+                sessionType: sessionType,
+                identityId: identityId
+            ) { result in
+                switch result {
+                case .success(let useSenseResult):
+                    let resultDict: [String: Any] = [
+                        "sessionId": useSenseResult.sessionId,
+                        "decision": useSenseResult.decision.rawValue,
+                        "channelTrustScore": useSenseResult.channelTrustScore,
+                        "livenessScore": useSenseResult.livenessScore,
+                        "matchSenseRiskScore": useSenseResult.matchSenseRiskScore,
+                        "presenceConfidence": useSenseResult.presenceConfidence,
+                        "reasons": useSenseResult.reasons,
+                        "ruleTriggered": useSenseResult.ruleTriggered as Any,
+                        "recommendedAction": useSenseResult.recommendedAction as Any,
+                        "sessionSignature": useSenseResult.sessionSignature,
+                    ]
+                    resolve(resultDict)
+
+                case .failure(let error):
+                    reject(error.code, error.message, nil)
+                }
+            }
+        }
+    }
+
+    @objc
+    func cancelSession(_ resolve: @escaping RCTPromiseResolveBlock, rejecter reject: @escaping RCTPromiseRejectBlock) {
+        UseSense.cancelSession()
+        resolve(nil)
+    }
+
+    @objc
+    func getSessionStatus(_ sessionId: String, resolver resolve: @escaping RCTPromiseResolveBlock, rejecter reject: @escaping RCTPromiseRejectBlock) {
+        UseSense.getSessionStatus(sessionId: sessionId) { result in
+            switch result {
+            case .success(let status):
+                var dict: [String: Any] = ["status": status.status]
+                if let r = status.result {
+                    dict["result"] = [
+                        "sessionId": r.sessionId,
+                        "decision": r.decision.rawValue,
+                        "channelTrustScore": r.channelTrustScore,
+                        "livenessScore": r.livenessScore,
+                        "matchSenseRiskScore": r.matchSenseRiskScore,
+                        "presenceConfidence": r.presenceConfidence,
+                        "reasons": r.reasons,
+                        "sessionSignature": r.sessionSignature,
+                    ]
+                }
+                resolve(dict)
+            case .failure(let error):
+                reject(error.code, error.message, nil)
+            }
+        }
+    }
+
+    @objc
+    func subscribeToEvents() {
+        UseSense.onEvent { [weak self] event in
+            guard let self = self, self.hasListeners else { return }
+            self.sendEvent(withName: "UseSenseEvent", body: event.toDictionary())
+        }
+    }
+
+    @objc
+    func unsubscribeFromEvents() {
+        UseSense.removeEventListener()
+    }
+
+    @objc
+    func getSdkVersion() -> String {
+        return UseSense.sdkVersion
+    }
+
+    @objc
+    override static func requiresMainQueueSetup() -> Bool {
+        return false
+    }
+}

package/lib/commonjs/index.js

@@ -0,0 +1,179 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = exports.UseSense = void 0;
+var _reactNative = require("react-native");
+const {
+  UseSenseModule
+} = _reactNative.NativeModules;
+if (!UseSenseModule) {
+  throw new Error('react-native-usesense: NativeModule not found. Make sure you have linked the library correctly.\n' + 'iOS: Run `cd ios && pod install`\n' + 'Android: Rebuild the app after installing the package.');
+}
+
+// ─── Types ───────────────────────────────────────────────────────────
+
+/** Environment for the UseSense API. */
+
+/** Session type for verification. */
+
+/** Challenge policy controlling verification difficulty. */
+
+/** Decision returned by the verification engine. */
+
+/** Processing stage during server-side analysis. */
+
+/**
+ * Configuration for initializing the UseSense plugin.
+ *
+ * @example
+ * ```ts
+ * await UseSense.initialize({
+ *   apiKey: 'your_api_key',
+ *   environment: 'sandbox',
+ * });
+ * ```
+ */
+
+/**
+ * Result returned when a verification session completes.
+ *
+ * **Important:** This result is for UI feedback only.
+ * The definitive verdict arrives at your backend via HMAC-signed webhook.
+ */
+
+/**
+ * Error returned when a verification session fails.
+ */
+
+/**
+ * Events emitted during the verification session lifecycle.
+ */
+
+/** Options for starting a verification session. */
+
+/** Status of a verification session. */
+
+/** Subscription handle returned by {@link UseSense.addListener}. */
+
+// ─── Implementation ──────────────────────────────────────────────────
+
+const eventEmitter = new _reactNative.NativeEventEmitter(UseSenseModule);
+
+/**
+ * UseSense React Native plugin.
+ *
+ * Provides human presence verification by wrapping the native UseSense
+ * iOS and Android SDKs into a single cross-platform API.
+ *
+ * @example
+ * ```ts
+ * import { UseSense } from 'react-native-usesense';
+ *
+ * await UseSense.initialize({ apiKey: 'your_key', environment: 'sandbox' });
+ * const result = await UseSense.startSession({ sessionType: 'enrollment' });
+ * console.log(result.decision);
+ * ```
+ */
+class UseSense {
+  /**
+   * Initialize the UseSense plugin. Must be called once before any other method.
+   *
+   * @param config - Plugin configuration including API key and environment.
+   * @throws {UseSenseError} If the API key is invalid or configuration is malformed.
+   */
+  static async initialize(config) {
+    if (!config.apiKey) {
+      throw {
+        code: 'invalid_config',
+        message: 'apiKey is required'
+      };
+    }
+    return UseSenseModule.initialize({
+      apiKey: config.apiKey,
+      environment: config.environment ?? 'sandbox',
+      organizationId: config.organizationId,
+      sessionType: config.sessionType ?? 'enrollment',
+      identityId: config.identityId,
+      challengePolicy: config.challengePolicy ?? 'standard',
+      enableAudio: config.enableAudio ?? false,
+      timeout: config.timeout ?? 60000,
+      metadata: config.metadata
+    });
+  }
+
+  /**
+   * Start a verification session. Presents a full-screen native camera UI.
+   *
+   * The returned promise resolves when the session completes and the modal
+   * dismisses, or rejects if an error occurs.
+   *
+   * @param options - Optional overrides for session type and identity ID.
+   * @returns The verification result (for UI feedback only).
+   * @throws {UseSenseError} On failure or cancellation.
+   */
+  static async startSession(options) {
+    return UseSenseModule.startSession(options ?? {});
+  }
+
+  /**
+   * Cancel an in-progress verification session.
+   *
+   * The camera UI is dismissed and the `startSession` promise rejects
+   * with a `session_cancelled` error.
+   */
+  static async cancelSession() {
+    return UseSenseModule.cancelSession();
+  }
+
+  /**
+   * Get the status of a verification session by ID.
+   *
+   * @param sessionId - The session ID to query.
+   * @returns The current status and optional result.
+   */
+  static async getSessionStatus(sessionId) {
+    return UseSenseModule.getSessionStatus(sessionId);
+  }
+
+  /**
+   * Subscribe to real-time events during the verification lifecycle.
+   *
+   * Call this before `startSession()` to receive all events.
+   *
+   * @param callback - Function invoked for each event.
+   * @returns A subscription handle with a `remove()` method.
+   *
+   * @example
+   * ```ts
+   * const listener = UseSense.addListener((event) => {
+   *   console.log(event.type);
+   * });
+   * // Later:
+   * listener.remove();
+   * ```
+   */
+  static addListener(callback) {
+    UseSenseModule.subscribeToEvents();
+    const subscription = eventEmitter.addListener('UseSenseEvent', callback);
+    return {
+      remove: () => {
+        subscription.remove();
+        UseSenseModule.unsubscribeFromEvents();
+      }
+    };
+  }
+
+  /**
+   * Get the native SDK version string.
+   *
+   * @returns Version string in semver format (e.g. `"1.0.0"`).
+   */
+  static getSdkVersion() {
+    return UseSenseModule.getSdkVersion();
+  }
+}
+exports.UseSense = UseSense;
+var _default = exports.default = UseSense;
+//# sourceMappingURL=index.js.map

package/lib/commonjs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_reactNative","require","UseSenseModule","NativeModules","Error","eventEmitter","NativeEventEmitter","UseSense","initialize","config","apiKey","code","message","environment","organizationId","sessionType","identityId","challengePolicy","enableAudio","timeout","metadata","startSession","options","cancelSession","getSessionStatus","sessionId","addListener","callback","subscribeToEvents","subscription","remove","unsubscribeFromEvents","getSdkVersion","exports","_default","default"],"sourceRoot":"../../src","sources":["index.ts"],"mappings":";;;;;;AAAA,IAAAA,YAAA,GAAAC,OAAA;AAEA,MAAM;EAAEC;AAAe,CAAC,GAAGC,0BAAa;AAExC,IAAI,CAACD,cAAc,EAAE;EACnB,MAAM,IAAIE,KAAK,CACb,mGAAmG,GACjG,oCAAoC,GACpC,wDACJ,CAAC;AACH;;AAEA;;AAEA;;AAGA;;AAGA;;AAGA;;AAGA;;AAGA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAsBA;AACA;AACA;AACA;AACA;AACA;;AAwBA;AACA;AACA;;AAUA;AACA;AACA;;AASA;;AAQA;;AAQA;;AAMA;;AAEA,MAAMC,YAAY,GAAG,IAAIC,+BAAkB,CAACJ,cAAc,CAAC;;AAE3D;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,MAAMK,QAAQ,CAAC;EACpB;AACF;AACA;AACA;AACA;AACA;EACE,aAAaC,UAAUA,CAACC,MAAsB,EAAiB;IAC7D,IAAI,CAACA,MAAM,CAACC,MAAM,EAAE;MAClB,MAAM;QAAEC,IAAI,EAAE,gBAAgB;QAAEC,OAAO,EAAE;MAAqB,CAAC;IACjE;IACA,OAAOV,cAAc,CAACM,UAAU,CAAC;MAC/BE,MAAM,EAAED,MAAM,CAACC,MAAM;MACrBG,WAAW,EAAEJ,MAAM,CAACI,WAAW,IAAI,SAAS;MAC5CC,cAAc,EAAEL,MAAM,CAACK,cAAc;MACrCC,WAAW,EAAEN,MAAM,CAACM,WAAW,IAAI,YAAY;MAC/CC,UAAU,EAAEP,MAAM,CAACO,UAAU;MAC7BC,eAAe,EAAER,MAAM,CAACQ,eAAe,IAAI,UAAU;MACrDC,WAAW,EAAET,MAAM,CAACS,WAAW,IAAI,KAAK;MACxCC,OAAO,EAAEV,MAAM,CAACU,OAAO,IAAI,KAAK;MAChCC,QAAQ,EAAEX,MAAM,CAACW;IACnB,CAAC,CAAC;EACJ;;EAEA;AACF;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;EACE,aAAaC,YAAYA,CAACC,OAA6B,EAA2B;IAChF,OAAOpB,cAAc,CAACmB,YAAY,CAACC,OAAO,IAAI,CAAC,CAAC,CAAC;EACnD;;EAEA;AACF;AACA;AACA;AACA;AACA;EACE,aAAaC,aAAaA,CAAA,EAAkB;IAC1C,OAAOrB,cAAc,CAACqB,aAAa,CAAC,CAAC;EACvC;;EAEA;AACF;AACA;AACA;AACA;AACA;EACE,aAAaC,gBAAgBA,CAACC,SAAiB,EAA0B;IACvE,OAAOvB,cAAc,CAACsB,gBAAgB,CAACC,SAAS,CAAC;EACnD;;EAEA;AACF;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;EACE,OAAOC,WAAWA,CAACC,QAAwC,EAAwB;IACjFzB,cAAc,CAAC0B,iBAAiB,CAAC,CAAC;IAClC,MAAMC,YAAY,GAAGxB,YAAY,CAACqB,WAAW,CAAC,eAAe,EAAEC,QAAQ,CAAC;IACxE,OAAO;MACLG,MAAM,EAAEA,CAAA,KAAM;QACZD,YAAY,CAACC,MAAM,CAAC,CAAC;QACrB5B,cAAc,CAAC6B,qBAAqB,CAAC,CAAC;MACxC;IACF,CAAC;EACH;;EAEA;AACF;AACA;AACA;AACA;EACE,OAAOC,aAAaA,CAAA,EAAW;IAC7B,OAAO9B,cAAc,CAAC8B,aAAa,CAAC,CAAC;EACvC;AACF;AAACC,OAAA,CAAA1B,QAAA,GAAAA,QAAA;AAAA,IAAA2B,QAAA,GAAAD,OAAA,CAAAE,OAAA,GAEc5B,QAAQ","ignoreList":[]}