@finos_sdk/sdk-ekyc 1.3.3 → 1.3.5

package/android/build.gradle

@@ -65,7 +65,7 @@ dependencies {
     implementation 'com.facebook.react:react-android'
 
     // Finos eKYC SDK dependencies from GitHub Packages Maven repository
-    def sdkVersion = "1.3.3.1"
+    def sdkVersion = "1.3.5.1"
     implementation("finos.sdk.ekyc:ekyc:$sdkVersion")
     implementation("finos.sdk.ekyc:ekycui:$sdkVersion")
     implementation("finos.sdk.ekyc:nfc:$sdkVersion")

package/android/src/main/java/finos/sdk/ekyc/EKYCModule.kt

@@ -1,6 +1,9 @@
 package finos.sdk.ekyc
 
 import android.R
+import android.net.Uri
+import android.os.Handler
+import android.os.Looper
 import android.util.Base64
 import android.util.Log
 import com.facebook.react.bridge.Arguments
@@ -42,6 +45,8 @@ import org.json.JSONArray
 import org.json.JSONObject
 import java.io.File
 import java.io.FileOutputStream
+import java.io.FileInputStream
+import java.io.InputStream
 import java.util.Date
 
 @ReactModule(name = EKYCModule.NAME)
@@ -446,48 +451,58 @@ class EKYCModule(reactContext: ReactApplicationContext) : ReactContextBaseJavaMo
     ) {
         Log.d(TAG, "▶️ startFaceCompare() called")
         try {
-            val currentActivity = reactApplicationContext.currentActivity
-            if (currentActivity == null) {
-                Log.e(TAG, "❌ startFaceCompare() failed: Activity not available")
-                promise.reject("NO_ACTIVITY", "Activity not available")
+            // React Native có thể gọi khi currentActivity = null (background / app state).
+            // FaceService không cần Activity, nên không block ở đây.
+            val selfieFile = resolveImageInputToFile(selfieImage, "selfie")
+            val idImageFile = resolveImageInputToFile(idImage, "id")
+
+            if (!selfieFile.exists() || selfieFile.length() <= 0L) {
+                promise.reject("SELFIE_IMAGE_INVALID", "Selfie image is invalid or not found")
                 return
             }
-            val imageFile = File(selfieImage.replace("file://", ""))
-            if (!imageFile.exists()) {
-                promise.reject("FILE_NOT_FOUND", "Image file does not exist")
+            if (!idImageFile.exists() || idImageFile.length() <= 0L) {
+                promise.reject("ID_IMAGE_INVALID", "ID image is invalid or not found")
                 return
             }
-            val idImageFile = base64ToImageFile(idImage)
 
             val faceServiceConfig =
                 FaceServiceConfig(
                     transactionId = transactionId,
-                    selfieImage = imageFile,
+                    selfieImage = selfieFile,
                     idImage = idImageFile
                 )
-            val ekycConfig = EKYCConfigSDK(faceServiceConfig = faceServiceConfig)
-            SdkEkycFaceService.startEkyc(
-                ekycConfigSDK = ekycConfig,
-                callbackSuccess = { event, data ->
-                    Log.d(TAG, "✅ startFaceCompare() success")
-                    val (eventMap, promiseMap) = createSeparateMaps { map ->
-                        map.putString("event", event.name.toString())
-                        map.putString("data", data.toString())
-                    }
-                    sendEvent("onFaceCompareSuccess", eventMap)
-                    promise.resolve(promiseMap)
-                },
-                callbackError = { event, message ->
-                    Log.e(TAG, "❌ startFaceCompare() failed - Event: $event, Message: $message")
-                    val errorMap =
-                        Arguments.createMap().apply {
-                            putString("event", event.name.toString())
-                            putString("message", message?.toString() ?: "Unknown error")
-                        }
-                    sendEvent("onFaceCompareError", errorMap)
-                    promise.reject(event.name.toString(), message?.toString() ?: "Unknown FaceService error")
-                }
+            // FaceService cần appKeyFaceService. Trước đây RN chỉ truyền 1 key string,
+            // nên map key này vào appKeyFaceService (và set appKey luôn để tương thích).
+            val ekycConfig = EKYCConfigSDK(
+                appKey = AppKeyConfig(appKey = appKey, appKeyFaceService = appKey),
+                faceServiceConfig = faceServiceConfig
             )
+
+            // Đảm bảo chạy trên main thread để tránh crash trên một số devices/SDK versions.
+            Handler(Looper.getMainLooper()).post {
+                SdkEkycFaceService.startEkyc(
+                    ekycConfigSDK = ekycConfig,
+                    callbackSuccess = { event, data ->
+                        Log.d(TAG, "✅ startFaceCompare() success")
+                        val (eventMap, promiseMap) = createSeparateMaps { map ->
+                            map.putString("event", event.name.toString())
+                            map.putString("data", data.toString())
+                        }
+                        sendEvent("onFaceCompareSuccess", eventMap)
+                        promise.resolve(promiseMap)
+                    },
+                    callbackError = { event, message ->
+                        Log.e(TAG, "❌ startFaceCompare() failed - Event: $event, Message: $message")
+                        val errorMap =
+                            Arguments.createMap().apply {
+                                putString("event", event.name.toString())
+                                putString("message", message?.toString() ?: "Unknown error")
+                            }
+                        sendEvent("onFaceCompareError", errorMap)
+                        promise.reject(event.name.toString(), message?.toString() ?: "Unknown FaceService error")
+                    }
+                )
+            }
         } catch (e: Exception) {
             Log.e(TAG, "❌ startFaceCompare() exception: ${e.message}", e)
             promise.reject("FACE_COMPARE_ERROR", e.message)
@@ -515,7 +530,56 @@ class EKYCModule(reactContext: ReactApplicationContext) : ReactContextBaseJavaMo
         }
     }
 
-    private fun base64ToImageFile(base64Image: String): File {
+    /**
+     * Resolve input image string to a local file.
+     * - Supports: file path (`/...`), file URI (`file://...`), content URI (`content://...`), base64 (with/without data URI).
+     */
+    private fun resolveImageInputToFile(input: String, prefix: String): File {
+        val value = input.trim()
+        if (value.isEmpty()) {
+            // Return empty file to trigger validation error upstream
+            return File(reactApplicationContext.cacheDir, "empty_${prefix}_${Date().time}.jpg").apply {
+                createNewFile()
+            }
+        }
+
+        // file://...
+        if (value.startsWith("file://")) {
+            val file = File(value.removePrefix("file://"))
+            if (file.exists()) return file
+        }
+
+        // content://...
+        if (value.startsWith("content://")) {
+            val copied = copyContentUriToCacheFile(value, prefix)
+            if (copied != null && copied.exists()) return copied
+        }
+
+        // raw path
+        val rawFile = File(value)
+        if (rawFile.exists()) return rawFile
+
+        // fallback: treat as base64
+        return base64ToImageFile(value, prefix)
+    }
+
+    private fun copyContentUriToCacheFile(uriString: String, prefix: String): File? {
+        return try {
+            val uri = Uri.parse(uriString)
+            val resolver = reactApplicationContext.contentResolver
+            val inputStream: InputStream = resolver.openInputStream(uri) ?: return null
+            val outFile = File(reactApplicationContext.cacheDir, "${prefix}_${Date().time}.jpg")
+            FileOutputStream(outFile).use { out ->
+                inputStream.use { ins -> ins.copyTo(out) }
+            }
+            outFile
+        } catch (e: Exception) {
+            Log.w(TAG, "copyContentUriToCacheFile failed: ${e.message}")
+            null
+        }
+    }
+
+    private fun base64ToImageFile(base64Image: String, prefix: String = "image"): File {
         try {
             // Remove data URI prefix if present (like "data:image/png;base64,")
             var processedBase64 = base64Image
@@ -528,7 +592,7 @@ class EKYCModule(reactContext: ReactApplicationContext) : ReactContextBaseJavaMo
 
             // Create a unique filename with timestamp
             val timestamp = Date().time.toString()
-            val fileName = "image_$timestamp.jpg"
+            val fileName = "${prefix}_$timestamp.jpg"
 
             // Get temporary directory and create file path
             val directory = reactApplicationContext.cacheDir
@@ -540,9 +604,9 @@ class EKYCModule(reactContext: ReactApplicationContext) : ReactContextBaseJavaMo
 
             return imageFile
         } catch (e: Exception) {
-            Log.e("LivenessFragment", "Error converting base64 to image file: ${e.message}", e)
+            Log.e(TAG, "Error converting base64 to image file: ${e.message}", e)
             // In case of error, create an empty file to avoid null returns
-            val errorFile = File(reactApplicationContext.cacheDir, "error_image_${Date().time}.jpg")
+            val errorFile = File(reactApplicationContext.cacheDir, "error_${prefix}_${Date().time}.jpg")
             errorFile.createNewFile()
             return errorFile
         }

package/dist/EKYCModule.js

@@ -221,10 +221,12 @@ class SDKeKYC {
     }
     async startFaceCompare(config) {
         var _a;
-        this.validateConfig(config, ['appKey', 'selfieImage', 'idImage']);
+        // Support both `appKey` and docs' `appKeyFaceService`
+        const normalized = Object.assign(Object.assign({}, config), { appKey: (config.appKeyFaceService || config.appKey) });
+        this.validateConfig(normalized, ['appKey', 'selfieImage', 'idImage']);
         const nativeModule = this.ensureNativeModule();
         try {
-            return await nativeModule.startFaceCompare(config.appKey, (_a = config.transactionId) !== null && _a !== void 0 ? _a : '', config.selfieImage, config.idImage);
+            return await nativeModule.startFaceCompare(normalized.appKey, (_a = normalized.transactionId) !== null && _a !== void 0 ? _a : '', normalized.selfieImage, normalized.idImage);
         }
         catch (error) {
             console.error('Face Compare Error:', error);

package/dist/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@finos_sdk/sdk-ekyc",
-    "version": "1.3.3",
+    "version": "1.3.5",
     "description": "React Native SDK for eKYC - Vietnamese CCCD NFC reading, OCR, Liveness detection, Face matching, and C06, eSign, SmsOTP residence verification",
     "main": "dist/index.js",
     "types": "dist/index.d.ts",
@@ -42,30 +42,11 @@
         "typescript"
     ],
     "scripts": {
-        "android": "npm run build && npm run bundle:android && npx react-native run-android",
-        "bundle:android": "mkdir -p android/app/src/main/assets && curl -s \"http://localhost:8081/index.bundle?platform=android&dev=false&minify=false\" -o android/app/src/main/assets/index.android.bundle || echo \"⚠️ Metro không chạy, bỏ qua bundle\"",
-        "android:log": "npm run build && npm run bundle:android && npx react-native run-android && sleep 8 && npm run log:all",
-        "reload": "npm run log:reload",
-        "ios": "react-native run-ios",
-        "start": "react-native start",
-        "reset": "react-native start --reset-cache",
-        "clean": "cd android && ./gradlew clean && cd ..",
-        "npm-install": "npm install",
+        "clear": "rm -rf node_modules && npm cache clean --force && cd android && ./gradlew clean",
         "build": "npx --package=typescript tsc",
-        "prepare": "npm run build",
-        "publish-sdk-local": "npm pack",
-        "publish-sdk": "npm run build && npm publish --access public",
-        "publish-sdk-version": "npm run build && npm version patch --force && npm publish --access public",
-        "prepublishOnly": "npm run build",
-        "unpublish:1.2.2": "node -e \"if(process.env.CONFIRM_UNPUBLISH==='YES'){process.exit(0)}else{console.error('Set CONFIRM_UNPUBLISH=YES to confirm');process.exit(1)}\" && npm unpublish @finos_sdk/sdk-ekyc@1.2.2",
-        "log:android": "npx react-native log-android",
-        "log:ios": "npx react-native log-ios",
-        "log:sdk": "./watch-sdk-logs.sh",
-        "log:buffer": "./watch-logs-with-buffer.sh",
-        "log:native": "./watch-native-logs.sh",
-        "log:all": "./watch-all-logs.sh",
-        "log:reload": "./reload-and-watch.sh",
-        "log:clear": "adb logcat -c && echo '✅ Logs cleared'"
+        "publish-sdk-local": "npm install && npm run build &&npm pack",
+        "publish-sdk": "npm install && npm run build && npm publish --access public",
+        "publish-sdk-version": "npm run build && npm version patch --force && npm publish --access public"
     },
     "dependencies": {
         "react": "18.3.1",

package/dist/src/modules/FinosEKYCModule.d.ts

@@ -79,7 +79,7 @@ export declare class FinosEKYCModule {
      */
     startLiveness(config: LivenessConfig): Promise<SDKEkycResultStringWithEvent>;
     /**
-     * Start face comparison
+     * Start face comparison (Face Service)
      * @param config Face service configuration
      */
     startFaceCompare(config: FaceServiceConfig): Promise<SDKEkycResultStringWithEvent>;

package/dist/src/modules/FinosEKYCModule.js

@@ -215,19 +215,20 @@ class FinosEKYCModule {
         }
     }
     /**
-     * Start face comparison
+     * Start face comparison (Face Service)
      * @param config Face service configuration
      */
     async startFaceCompare(config) {
         this.validateSDKReady();
+        const normalized = Object.assign(Object.assign({}, config), { appKey: (config.appKeyFaceService || config.appKey) });
         try {
-            console.log('👤 Starting face comparison...');
-            const result = await this.sdk.startFaceCompare(config);
-            console.log('✅ Face comparison completed:', result.event);
+            console.log('👤 Starting face compare...');
+            const result = await this.sdk.startFaceCompare(normalized);
+            console.log('✅ Face compare completed:', result.event);
             return result;
         }
         catch (error) {
-            console.error('❌ Face comparison failed:', error);
+            console.error('❌ Face compare failed:', error);
             throw error;
         }
     }

package/dist/src/modules/FinosESignModule.d.ts

@@ -211,7 +211,7 @@ export declare class FinosESignModule {
     onLivenessSuccess(callback: (data: SDKEkycResultStringWithEvent) => void): import("react-native").EmitterSubscription | null;
     onLivenessError(callback: (error: any) => void): import("react-native").EmitterSubscription | null;
     /**
-     * Start face comparison
+     * Face matching (Face Service)
      * @param config Face service configuration
      */
     startFaceCompare(config: FaceServiceConfig): Promise<SDKEkycResultStringWithEvent>;

package/dist/src/modules/FinosESignModule.js

@@ -408,13 +408,14 @@ class FinosESignModule {
     }
     // ==================== Face Service Methods ====================
     /**
-     * Start face comparison
+     * Face matching (Face Service)
      * @param config Face service configuration
      */
     async startFaceCompare(config) {
         this.validateSDKReady();
+        const normalized = Object.assign(Object.assign({}, config), { appKey: (config.appKeyFaceService || config.appKey) });
         // Pass through to SDK - error handling is done in EKYCModule.ts
-        return await this.sdk.startFaceCompare(config);
+        return await this.sdk.startFaceCompare(normalized);
     }
     // Face Compare Event Listeners
     onFaceCompareSuccess(callback) {

package/dist/src/types/ekycESignType.d.ts

@@ -36,6 +36,14 @@ export interface ESignSignRequest {
     documentName?: string;
     status?: string;
 }
+/**
+ * eSign Sign Request Info
+ */
+export interface ESignSignRequestConfirm {
+    requestId: string;
+    authId?: string;
+    authData?: string;
+}
 /**
  * eSign Error Result
  */

package/dist/src/types/ekycFaceType.d.ts

@@ -13,7 +13,14 @@ export interface FaceVerifyResult {
     toBeReviewed?: string;
 }
 export interface FaceServiceConfig {
+    /**
+     * Backward/forward compatible:
+     * - SDK code uses `appKey`
+     * - Some integration docs use `appKeyFaceService`
+     * Provide either; `startFaceCompare()` will normalize.
+     */
     appKey: string;
+    appKeyFaceService?: string;
     transactionId?: string;
     selfieImage: string;
     idImage: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@finos_sdk/sdk-ekyc",
-  "version": "1.3.3",
+  "version": "1.3.5",
   "description": "React Native SDK for eKYC - Vietnamese CCCD NFC reading, OCR, Liveness detection, Face matching, and C06, eSign, SmsOTP residence verification",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -42,30 +42,11 @@
     "typescript"
   ],
   "scripts": {
-    "android": "npm run build && npm run bundle:android && npx react-native run-android",
-    "bundle:android": "mkdir -p android/app/src/main/assets && curl -s \"http://localhost:8081/index.bundle?platform=android&dev=false&minify=false\" -o android/app/src/main/assets/index.android.bundle || echo \"⚠️ Metro không chạy, bỏ qua bundle\"",
-    "android:log": "npm run build && npm run bundle:android && npx react-native run-android && sleep 8 && npm run log:all",
-    "reload": "npm run log:reload",
-    "ios": "react-native run-ios",
-    "start": "react-native start",
-    "reset": "react-native start --reset-cache",
-    "clean": "cd android && ./gradlew clean && cd ..",
-    "npm-install": "npm install",
+    "clear": "rm -rf node_modules && npm cache clean --force && cd android && ./gradlew clean",
     "build": "npx --package=typescript tsc",
-    "prepare": "npm run build",
-    "publish-sdk-local": "npm pack",
-    "publish-sdk": "npm run build && npm publish --access public",
-    "publish-sdk-version": "npm run build && npm version patch --force && npm publish --access public",
-    "prepublishOnly": "npm run build",
-    "unpublish:1.2.2": "node -e \"if(process.env.CONFIRM_UNPUBLISH==='YES'){process.exit(0)}else{console.error('Set CONFIRM_UNPUBLISH=YES to confirm');process.exit(1)}\" && npm unpublish @finos_sdk/sdk-ekyc@1.2.2",
-    "log:android": "npx react-native log-android",
-    "log:ios": "npx react-native log-ios",
-    "log:sdk": "./watch-sdk-logs.sh",
-    "log:buffer": "./watch-logs-with-buffer.sh",
-    "log:native": "./watch-native-logs.sh",
-    "log:all": "./watch-all-logs.sh",
-    "log:reload": "./reload-and-watch.sh",
-    "log:clear": "adb logcat -c && echo '✅ Logs cleared'"
+    "publish-sdk-local": "npm install && npm run build &&npm pack",
+    "publish-sdk": "npm install && npm run build && npm publish --access public",
+    "publish-sdk-version": "npm run build && npm version patch --force && npm publish --access public"
   },
   "dependencies": {
     "react": "18.3.1",

package/src/modules/FinosEKYCModule.ts

@@ -223,19 +223,24 @@ export class FinosEKYCModule {
     }
 
     /**
-     * Start face comparison
+     * Start face comparison (Face Service)
      * @param config Face service configuration
      */
     public async startFaceCompare(config: FaceServiceConfig): Promise<SDKEkycResultStringWithEvent> {
         this.validateSDKReady();
 
+        const normalized: FaceServiceConfig = {
+            ...config,
+            appKey: (config.appKeyFaceService || config.appKey),
+        };
+
         try {
-            console.log('👤 Starting face comparison...');
-            const result = await this.sdk.startFaceCompare(config);
-            console.log('✅ Face comparison completed:', result.event);
+            console.log('👤 Starting face compare...');
+            const result = await this.sdk.startFaceCompare(normalized);
+            console.log('✅ Face compare completed:', result.event);
             return result;
         } catch (error) {
-            console.error('❌ Face comparison failed:', error);
+            console.error('❌ Face compare failed:', error);
             throw error;
         }
     }

package/src/modules/FinosESignModule.ts

@@ -484,13 +484,17 @@ export class FinosESignModule {
     // ==================== Face Service Methods ====================
 
     /**
-     * Start face comparison
+     * Face matching (Face Service)
      * @param config Face service configuration
      */
     public async startFaceCompare(config: FaceServiceConfig): Promise<SDKEkycResultStringWithEvent> {
         this.validateSDKReady();
+        const normalized: FaceServiceConfig = {
+            ...config,
+            appKey: (config.appKeyFaceService || config.appKey),
+        };
         // Pass through to SDK - error handling is done in EKYCModule.ts
-        return await this.sdk.startFaceCompare(config);
+        return await this.sdk.startFaceCompare(normalized);
     }
 
     // Face Compare Event Listeners

package/src/modules/README.md

@@ -124,7 +124,7 @@ try {
 }
 ```
 
-### Face Comparison
+### Face Comparison (Face Matching)
 
 ```typescript
 import { finosEKYC, FaceServiceConfig } from '@finos_sdk/sdk-ekyc';

package/src/types/ekycESignType.ts

@@ -43,6 +43,15 @@ export interface ESignSignRequest {
   status?: string;
 }
 
+/**
+ * eSign Sign Request Info
+ */
+export interface ESignSignRequestConfirm {
+  requestId: string;
+  authId?: string;
+  authData?: string;
+}
+
 /**
  * eSign Error Result
  */

package/src/types/ekycFaceType.ts

@@ -15,7 +15,14 @@ export interface FaceVerifyResult {
 }
 
 export interface FaceServiceConfig {
+    /**
+     * Backward/forward compatible:
+     * - SDK code uses `appKey`
+     * - Some integration docs use `appKeyFaceService`
+     * Provide either; `startFaceCompare()` will normalize.
+     */
     appKey: string,
+    appKeyFaceService?: string,
     transactionId?: string,
     selfieImage: string,
     idImage: string,