@finos_sdk/sdk-ekyc 1.4.6 → 1.4.7

package/README.md

@@ -5,7 +5,7 @@
 
 React Native SDK for eKYC (electronic Know Your Customer) and eSign. Features include Vietnamese CCCD NFC reading, OCR, Liveness detection, Face matching, C06 residence verification, SMS OTP verification, and Electronic Signature (eSign) capabilities.
 
-**Version**: 1.4.2
+**Version**: 1.4.7
 
 ## Features
 

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.4.6.1"
+    def sdkVersion = "1.4.7"
     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

@@ -97,6 +97,46 @@ class EKYCModule(reactContext: ReactApplicationContext) : ReactContextBaseJavaMo
         return Pair(eventMap, promiseMap)
     }
 
+    /** Recursively convert org.json.JSONObject → WritableMap (preserves key names as-is). */
+    private fun jsonObjectToWritableMap(jsonObject: JSONObject): WritableMap {
+        val map = Arguments.createMap()
+        val keys = jsonObject.keys()
+        while (keys.hasNext()) {
+            val key = keys.next()
+            when (val value = jsonObject.get(key)) {
+                is JSONObject -> map.putMap(key, jsonObjectToWritableMap(value))
+                is JSONArray  -> map.putArray(key, jsonArrayToWritableArray(value))
+                is Boolean    -> map.putBoolean(key, value)
+                is Int        -> map.putInt(key, value)
+                is Long       -> map.putDouble(key, value.toDouble())
+                is Double     -> map.putDouble(key, value)
+                is String     -> map.putString(key, value)
+                JSONObject.NULL -> map.putNull(key)
+                else          -> map.putString(key, value.toString())
+            }
+        }
+        return map
+    }
+
+    /** Recursively convert org.json.JSONArray → WritableArray. */
+    private fun jsonArrayToWritableArray(jsonArray: JSONArray): WritableArray {
+        val array = Arguments.createArray()
+        for (i in 0 until jsonArray.length()) {
+            when (val value = jsonArray.get(i)) {
+                is JSONObject -> array.pushMap(jsonObjectToWritableMap(value))
+                is JSONArray  -> array.pushArray(jsonArrayToWritableArray(value))
+                is Boolean    -> array.pushBoolean(value)
+                is Int        -> array.pushInt(value)
+                is Long       -> array.pushDouble(value.toDouble())
+                is Double     -> array.pushDouble(value)
+                is String     -> array.pushString(value)
+                JSONObject.NULL -> array.pushNull()
+                else          -> array.pushString(value.toString())
+            }
+        }
+        return array
+    }
+
     /** Convert ESignOpenSessionResult to WritableMap for RN. */
     private fun eSignOpenSessionResultToWritableMap(result: ESignModels.ESignOpenSessionResult): WritableMap =
         Arguments.createMap().apply {
@@ -493,24 +533,25 @@ class EKYCModule(reactContext: ReactApplicationContext) : ReactContextBaseJavaMo
             eKYCFinOSLiveness.startEkyc(
                 ekycConfigSDK = ekycConfig,
                 callbackSuccess = { event, data ->
-                    // LOG_SUCCESS = internal submit result event (v1.4.6.1), don't resolve promise
-                    if (event == EKYCEvent.LOG_SUCCESS) {
-                        val logDataStr = data?.customData?.let { Gson().toJson(it) } ?: (data as? SDKEkycResult)?.checkLivenessResponse?.let { Gson().toJson(it) } ?: Gson().toJson(data)
-                        Log.d(TAG, "LOG_SUCCESS [Liveness]: $logDataStr")
-                        val logMap = Arguments.createMap().apply {
-                            putString("event", event.name.toString())
-                            putString("data", logDataStr)
-                        }
-                        sendEvent("onLivenessSuccess", logMap)
-                        return@startEkyc
-                    }
-                    Log.d(TAG, "✅ startLiveness() success")
-                    val (eventMap, promiseMap) = createSeparateMaps { map ->
-                        map.putString("event", event.name.toString())
-                        map.putString("data", Gson().toJson((data as SDKEkycResult).checkLivenessResponse))
-                    }
-                    sendEvent("onLivenessSuccess", eventMap)
-                    promise.resolve(promiseMap)
+                    Log.d(TAG, "🔥 NATIVE CALLBACK (Liveness): event=${event.name}")
+                    val response = (data as? SDKEkycResult)?.checkLivenessResponse
+                    val jsonStr = data?.customData?.let { Gson().toJson(it) } ?: Gson().toJson(response ?: data)
+                    
+                    // Helper to create fresh data map to avoid 'Map already consumed' error
+                    fun createWritableData() = try { jsonObjectToWritableMap(JSONObject(jsonStr)) } catch (e: Exception) { Arguments.createMap() }
+
+                    // Send the event directly to React Native
+                    sendEvent("onLivenessSuccess", Arguments.createMap().apply {
+                        putString("event", event.name)
+                        putMap("data", createWritableData())
+                    })
+
+                    // Always attempt to resolve the promise.
+                    // RN safely ignores subsequent resolves if the native SDK fires multiple events.
+                    promise.resolve(Arguments.createMap().apply { 
+                        putString("event", event.name)
+                        putMap("data", createWritableData()) 
+                    })
                 },
                 callbackError = { event, errorResult ->
                     Log.e(TAG, "❌ startLiveness() failed - Event: $event, Code: ${errorResult.code}, Message: ${errorResult.message}")
@@ -577,40 +618,21 @@ class EKYCModule(reactContext: ReactApplicationContext) : ReactContextBaseJavaMo
                 eKYCFinOSFaceService.startEkyc(
                     ekycConfigSDK = ekycConfig,
                     callbackSuccess = { event, data ->
-                        // LOG_SUCCESS = internal submit result event (v1.4.6.1), don't resolve promise
-                        if (event == EKYCEvent.LOG_SUCCESS) {
-                            val faceResponse = (data as? SDKEkycResult)?.checkFaceResponse
-                            val logDataStr = data?.customData?.let { Gson().toJson(it) } ?: faceResponse?.let { Gson().toJson(it) } ?: "null"
-                            Log.d(TAG, "LOG_SUCCESS [FaceCompare]: $logDataStr")
-                            val logMap = Arguments.createMap().apply {
-                                putString("event", event.name.toString())
-                                putString("data", logDataStr)
-                            }
-                            sendEvent("onFaceCompareSuccess", logMap)
-                            return@startEkyc
-                        }
-                        Log.d(TAG, "✅ startFaceCompare() success")
-                        val faceResponse = (data as? SDKEkycResult)?.checkFaceResponse
-                        val (eventMap, promiseMap) = createSeparateMaps { map ->
-                            map.putString("event", event.name.toString())
-                            val resultMap = Arguments.createMap().apply {
-                                putDouble("conf", faceResponse?.result?.conf?.toString()?.toDoubleOrNull() ?: 0.0)
-                                putString("match", faceResponse?.result?.match?.toString())
-                                putInt("matchScore", faceResponse?.result?.matchScore?.toString()?.toIntOrNull() ?: 0)
-                                putString("toBeReviewed", faceResponse?.result?.toBeReviewed?.toString())
-                            }
-                            val faceMap = Arguments.createMap().apply {
-                                putString("requestId", faceResponse?.requestId?.toString())
-                                putMap("result", resultMap)
-                                putString("status", faceResponse?.status?.toString())
-                                putInt("statusCode", faceResponse?.statusCode?.toString()?.toIntOrNull() ?: 0)
-                                putString("error", faceResponse?.error?.toString())
-                                putString("type", faceResponse?.type?.toString())
-                            }
-                            map.putMap("data", faceMap)
-                        }
-                        sendEvent("onFaceCompareSuccess", eventMap)
-                        promise.resolve(promiseMap)
+                        Log.d(TAG, "🔥 NATIVE CALLBACK (Face Compare): event=${event.name}")
+                        val response = (data as? SDKEkycResult)?.checkFaceResponse
+                        val jsonStr = data?.customData?.let { Gson().toJson(it) } ?: Gson().toJson(response ?: data)
+                        fun createWritableData() = try { jsonObjectToWritableMap(JSONObject(jsonStr)) } catch (e: Exception) { Arguments.createMap() }
+
+                        sendEvent("onFaceCompareSuccess", Arguments.createMap().apply {
+                            putString("event", event.name)
+                            putMap("data", createWritableData())
+                        })
+
+                        // Always attempt to resolve the promise.
+                        promise.resolve(Arguments.createMap().apply {
+                            putString("event", event.name)
+                            putMap("data", createWritableData())
+                        })
                     },
                     callbackError = { event, errorResult ->
                         Log.e(TAG, "❌ startFaceCompare() failed - Event: $event, Code: ${errorResult.code}, Message: ${errorResult.message}")
@@ -835,41 +857,55 @@ class EKYCModule(reactContext: ReactApplicationContext) : ReactContextBaseJavaMo
                 activity = currentActivity,
                 ekycConfigSDK = ekycConfigSDK,
                 callbackSuccess = { event, data ->
-                    // LOG_SUCCESS = internal submit result event (v1.4.5), emit event only, don't resolve promise
-                    if (event == EKYCEvent.LOG_SUCCESS) {
-                        val logDataStr = data?.customData?.let { Gson().toJson(it) } ?: Gson().toJson(data)
-                        Log.d(TAG, "LOG_SUCCESS [EkycUI]: $logDataStr")
-                        sendEvent("onEkycUISuccess", Arguments.createMap().apply {
-                            putString("status", "log")
-                            putString("event", event.name.toString())
-                            putString("data", logDataStr)
-                        })
-                        return@startEkyc
-                    }
-                    Log.d(TAG, "✅ startEkycUI() callback - event=${event.name}")
+                    Log.d(TAG, "🔥 NATIVE CALLBACK (EkycUI): event=${event.name}")
+                    
                     val result = data as? SDKEkycResult
-                    val hasRealData = result?.ekycStateModel != null
-                    // Chỉ resolve promise khi flow hoàn thành có data (SDK_END_SUCCESS); SDK_START_SUCCESS = activity vừa mở, bỏ qua
-                    if (event == EKYCEvent.SDK_START_SUCCESS && !hasRealData) {
-                        Log.d(TAG, "⏳ startEkycUI() SDK_START_SUCCESS – chờ SDK_END_SUCCESS")
-                        sendEvent("onEkycUISuccess", Arguments.createMap().apply {
-                            putString("status", "started")
-                            putString("event", event.name.toString())
-                        })
-                    } else {
+                    val response = result?.ekycStateModel
+                    val jsonStr = data?.customData?.let { Gson().toJson(it) } ?: Gson().toJson(response ?: data)
+                    
+                    // Helper to create fresh data map to avoid 'Map already consumed' error
+                    fun createWritableData() = try { jsonObjectToWritableMap(JSONObject(jsonStr)) } catch (e: Exception) { Arguments.createMap() }
+
+                    val statusStr = when (event) {
+                        EKYCEvent.LOG_SUCCESS -> "log"
+                        EKYCEvent.SDK_START_SUCCESS -> "started"
+                        else -> "success"
+                    }
+
+                    // Send EVERY event directly to React Native Event Listener (Pass-through)
+                    sendEvent("onEkycUISuccess", Arguments.createMap().apply {
+                        putString("status", statusStr)
+                        putString("event", event.name)
+                        
+                        if (event == EKYCEvent.SDK_START_SUCCESS && response == null) {
+                            // Bỏ qua data nếu là SDK_START_SUCCESS (chỉ có event/status) để giống code cũ
+                        } else {
+                            putMap("data", createWritableData())
+                        }
+                        
+                        // Retain the convenient root properties cho backward compatibility
                         val ekycFiles = result?.ekycStateModel?.eKYCFileModel
                         val ekycTransactionId = result?.ekycStateModel?.transactionId ?: ""
-                        val (eventMap, promiseMap) = createSeparateMaps { map ->
-                            map.putString("status", "success")
-                            map.putString("event", event.name.toString())
-                            map.putString("data", Gson().toJson(data))
-                            map.putString("transactionId", ekycTransactionId)
-                            ekycFiles?.imageFace?.absolutePath?.let { map.putString("imageFacePath", it) }
-                            ekycFiles?.imageOcrFront?.absolutePath?.let { map.putString("imageOcrFrontPath", it) }
-                            ekycFiles?.imageOcrBack?.absolutePath?.let { map.putString("imageOcrBackPath", it) }
-                        }
-                        sendEvent("onEkycUISuccess", eventMap)
-                        promise.resolve(promiseMap)
+                        if (ekycTransactionId.isNotEmpty()) putString("transactionId", ekycTransactionId)
+                        ekycFiles?.imageFace?.absolutePath?.let { putString("imageFacePath", it) }
+                        ekycFiles?.imageOcrFront?.absolutePath?.let { putString("imageOcrFrontPath", it) }
+                        ekycFiles?.imageOcrBack?.absolutePath?.let { putString("imageOcrBackPath", it) }
+                    })
+
+                    // IMPORTANT: Chỉ resolve promise ở SDK_END_SUCCESS để `await FinosEKYC.startEkycUI()` không bị kết thúc sớm
+                    if (event == EKYCEvent.SDK_END_SUCCESS) {
+                        promise.resolve(Arguments.createMap().apply { 
+                            putString("status", "success")
+                            putString("event", event.name)
+                            putMap("data", createWritableData()) 
+                            
+                            val ekycFiles = result?.ekycStateModel?.eKYCFileModel
+                            val ekycTransactionId = result?.ekycStateModel?.transactionId ?: ""
+                            if (ekycTransactionId.isNotEmpty()) putString("transactionId", ekycTransactionId)
+                            ekycFiles?.imageFace?.absolutePath?.let { putString("imageFacePath", it) }
+                            ekycFiles?.imageOcrFront?.absolutePath?.let { putString("imageOcrFrontPath", it) }
+                            ekycFiles?.imageOcrBack?.absolutePath?.let { putString("imageOcrBackPath", it) }
+                        })
                     }
                 },
                 callbackError = { event, errorResult ->
@@ -881,14 +917,14 @@ class EKYCModule(reactContext: ReactApplicationContext) : ReactContextBaseJavaMo
                         putString("customMessage", errorResult.message)
                         putString("message", errorResult.message)
                     }
+                    sendEvent("onEkycUIError", errorMap)
+                    
                     val promiseErrorMap = Arguments.createMap().apply {
                         putString("status", "error")
                         putString("event", event.name.toString())
                         putString("customCode", errorResult.code)
                         putString("customMessage", errorResult.message)
-                        putString("message", errorResult.message)
                     }
-                    sendEvent("onEkycUIError", errorMap)
                     promise.reject(event.name.toString(), errorResult.message, null, promiseErrorMap)
                 }
             )
@@ -2174,4 +2210,13 @@ class EKYCModule(reactContext: ReactApplicationContext) : ReactContextBaseJavaMo
         }
     }
 
+    @ReactMethod
+    fun addListener(eventName: String) {
+        // Keep: Required for RN built-in Event Emitter Calls.
+    }
+
+    @ReactMethod
+    fun removeListeners(count: Int) {
+        // Keep: Required for RN built-in Event Emitter Calls.
+    }
 }

package/dist/EKYCModule.d.ts

@@ -3,8 +3,8 @@ import { NfcConfig, NfcError } from './src/types/ekycNFCType';
 import { SDKEkycResultWithEvent, SDKEkycResultStringWithEvent, StartEkycUIResult } from './src/types/ekycType';
 import { C06Config } from './src/types/ekycC06Type';
 import { OcrConfig } from './src/types/ekycOCRType';
-import { LivenessConfig, SDKFaceDetectStatus } from './src/types/ekycLivenessType';
-import { FaceServiceConfig } from './src/types/ekycFaceType';
+import { LivenessConfig, SDKFaceDetectStatus, LivenessSuccessEvent } from './src/types/ekycLivenessType';
+import { FaceServiceConfig, FaceCompareSuccessEvent } from './src/types/ekycFaceType';
 import { SmsOtpConfig, SmsOtpResult, SmsOtpError } from './src/types/ekycSmsOtpType';
 import { ESignInitResult, ESignOpenSessionResult, ESignCertificate, ESignSignRequest, ESignError, AuthorizeInfo, ESignPdfResult, ESignApiResponse } from './src/types/ekycESignType';
 export declare const SDK_VERSION: string;
@@ -29,8 +29,8 @@ declare class SDKeKYC {
     startOcr(config: OcrConfig): Promise<SDKEkycResultStringWithEvent>;
     startNfcScan(config: NfcConfig): Promise<SDKEkycResultStringWithEvent>;
     checkC06(config: C06Config): Promise<SDKEkycResultStringWithEvent>;
-    startLiveness(config: LivenessConfig): Promise<SDKEkycResultStringWithEvent>;
-    startFaceCompare(config: FaceServiceConfig): Promise<SDKEkycResultStringWithEvent>;
+    startLiveness(config: LivenessConfig): Promise<LivenessSuccessEvent>;
+    startFaceCompare(config: FaceServiceConfig): Promise<FaceCompareSuccessEvent>;
     onResume(): void;
     onPause(): void;
     onNfcScanStart(callback: (data: SDKEkycResultWithEvent) => void): EmitterSubscription | null;
@@ -40,9 +40,9 @@ declare class SDKeKYC {
     onC06Error(callback: (error: NfcError) => void): EmitterSubscription | null;
     onOcrSuccess(callback: (data: SDKEkycResultStringWithEvent) => void): EmitterSubscription | null;
     onOcrError(callback: (error: any) => void): EmitterSubscription | null;
-    onLivenessSuccess(callback: (data: SDKEkycResultStringWithEvent) => void): EmitterSubscription | null;
+    onLivenessSuccess(callback: (data: LivenessSuccessEvent) => void): EmitterSubscription | null;
     onLivenessError(callback: (error: any) => void): EmitterSubscription | null;
-    onFaceCompareSuccess(callback: (data: SDKEkycResultWithEvent) => void): EmitterSubscription | null;
+    onFaceCompareSuccess(callback: (data: FaceCompareSuccessEvent) => void): EmitterSubscription | null;
     onFaceCompareError(callback: (error: any) => void): EmitterSubscription | null;
     onEkycUISuccess(callback: (data: any) => void): EmitterSubscription | null;
     onEkycUIError(callback: (error: any) => void): EmitterSubscription | null;

package/dist/index.d.ts

@@ -9,9 +9,9 @@ export { SDKFlowType, SDK_FLOW_OPTIONS, flowToStrings } from './src/types/ekycFl
 export type { NfcConfig, NFCData, NfcInfo } from './src/types/ekycNFCType';
 export type { C06Config } from './src/types/ekycC06Type';
 export type { OcrConfig } from './src/types/ekycOCRType';
-export type { LivenessConfig } from './src/types/ekycLivenessType';
+export type { LivenessConfig, LivenessSuccessEvent, CheckLivenessResponse, Metadata, LivenessCheckResult, Details, QualityChecks, QualityCheck, AgeRange, LiveFace } from './src/types/ekycLivenessType';
 export { SDKFaceDetectStatus, SDK_LIVENESS_ACTIONS, customActionsToStrings } from './src/types/ekycLivenessType';
-export type { FaceServiceConfig } from './src/types/ekycFaceType';
+export type { FaceServiceConfig, FaceCompareSuccessEvent, CheckFaceResponse, FaceVerifyResult } from './src/types/ekycFaceType';
 export { EKYCEvent, EKYCErrorEvent } from './src/types/EKYCEvent';
 export type { SDKEkycResultWithEvent, SDKEkycResultStringWithEvent, StartEkycUIResult, EKYCError } from './src/types/ekycType';
 export { getEkycError, AppIDType } from './src/types/ekycType';

package/dist/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@finos_sdk/sdk-ekyc",
-  "version": "1.4.6",
+  "version": "1.4.7",
   "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",

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

@@ -3,8 +3,8 @@ import { NfcConfig } from '../types/ekycNFCType';
 import { SDKEkycResultWithEvent, SDKEkycResultStringWithEvent, EKYCError, AppIDType } from '../types/ekycType';
 import { C06Config } from '../types/ekycC06Type';
 import { OcrConfig } from '../types/ekycOCRType';
-import { LivenessConfig, SDKFaceDetectStatus } from '../types/ekycLivenessType';
-import { FaceServiceConfig } from '../types/ekycFaceType';
+import { LivenessConfig, SDKFaceDetectStatus, LivenessSuccessEvent } from '../types/ekycLivenessType';
+import { FaceServiceConfig, FaceCompareSuccessEvent } from '../types/ekycFaceType';
 import { SmsOtpConfig, SmsOtpResult } from '../types/ekycSmsOtpType';
 import { ESignInitResult, ESignOpenSessionResult, ESignCertificate, ESignSignRequest, ESignPdfResult, ESignApiResponse } from '../types/ekycESignType';
 import { SDKFlowType } from '../types/ekycFlowType';
@@ -77,12 +77,12 @@ export declare class FinosEKYCModule {
      * @param config.activeActionCount - Number of random actions (1-10), only used when customActions is null (default: 2)
      * @param config.switchFrontCamera - Use front camera (default: false)
      */
-    startLiveness(config: LivenessConfig): Promise<SDKEkycResultStringWithEvent>;
+    startLiveness(config: LivenessConfig): Promise<LivenessSuccessEvent>;
     /**
      * Start face comparison (Face Service)
      * @param config Face service configuration
      */
-    startFaceCompare(config: FaceServiceConfig): Promise<SDKEkycResultStringWithEvent>;
+    startFaceCompare(config: FaceServiceConfig): Promise<FaceCompareSuccessEvent>;
     /**
      * Extract NFC data for C06 verification
      * @param nfcResultJson NFC result JSON string
@@ -134,7 +134,7 @@ export declare class FinosEKYCModule {
     /**
      * Listen for liveness success events
      */
-    onLivenessSuccess(callback: (data: SDKEkycResultStringWithEvent) => void): import("react-native").EmitterSubscription | null;
+    onLivenessSuccess(callback: (data: LivenessSuccessEvent) => void): import("react-native").EmitterSubscription | null;
     /**
      * Listen for liveness error events
      */
@@ -143,7 +143,7 @@ export declare class FinosEKYCModule {
     /**
      * Listen for face compare success events
      */
-    onFaceCompareSuccess(callback: (data: SDKEkycResultWithEvent) => void): import("react-native").EmitterSubscription | null;
+    onFaceCompareSuccess(callback: (data: FaceCompareSuccessEvent) => void): import("react-native").EmitterSubscription | null;
     /** Payload là EKYCError: { event, code, message }. */
     onFaceCompareError(callback: (error: EKYCError) => void): import("react-native").EmitterSubscription | null;
     /**

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

@@ -1,9 +1,9 @@
 import { SDK_VERSION, SDK_NAME } from '../../EKYCModule';
 import { SmsOtpConfig, SmsOtpResult } from '../types/ekycSmsOtpType';
 import { ESignInitResult, ESignOpenSessionResult, ESignCertificate, ESignSignRequest, AuthorizeInfo, ESignPdfResult, ESignApiResponse } from '../types/ekycESignType';
-import { LivenessConfig } from '../types/ekycLivenessType';
-import { FaceServiceConfig } from '../types/ekycFaceType';
-import { SDKEkycResultStringWithEvent, SDKEkycResultWithEvent, EKYCError } from '../types/ekycType';
+import { LivenessConfig, LivenessSuccessEvent } from '../types/ekycLivenessType';
+import { FaceServiceConfig, FaceCompareSuccessEvent } from '../types/ekycFaceType';
+import { EKYCError } from '../types/ekycType';
 /**
  * Finos eSign SDK Module
  *
@@ -255,16 +255,16 @@ export declare class FinosESignModule {
      * @param config.activeActionCount - Number of random actions (1-10), only used when customActions is null (default: 2)
      * @param config.switchFrontCamera - Use front camera (default: false)
      */
-    startLiveness(config: LivenessConfig): Promise<SDKEkycResultStringWithEvent>;
-    onLivenessSuccess(callback: (data: SDKEkycResultStringWithEvent) => void): import("react-native").EmitterSubscription | null;
+    startLiveness(config: LivenessConfig): Promise<LivenessSuccessEvent>;
+    onLivenessSuccess(callback: (data: LivenessSuccessEvent) => void): import("react-native").EmitterSubscription | null;
     /** Payload là EKYCError: { event, code, message }. */
     onLivenessError(callback: (error: EKYCError) => void): import("react-native").EmitterSubscription | null;
     /**
      * Face matching (Face Service)
      * @param config Face service configuration
      */
-    startFaceCompare(config: FaceServiceConfig): Promise<SDKEkycResultStringWithEvent>;
-    onFaceCompareSuccess(callback: (data: SDKEkycResultWithEvent) => void): import("react-native").EmitterSubscription | null;
+    startFaceCompare(config: FaceServiceConfig): Promise<FaceCompareSuccessEvent>;
+    onFaceCompareSuccess(callback: (data: FaceCompareSuccessEvent) => void): import("react-native").EmitterSubscription | null;
     /** Payload là EKYCError: { event, code, message }. */
     onFaceCompareError(callback: (error: EKYCError) => void): import("react-native").EmitterSubscription | null;
     /**

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

@@ -12,6 +12,15 @@ export interface FaceVerifyResult {
     matchScore?: number;
     toBeReviewed?: string;
 }
+/**
+ * Payload emitted by onFaceCompareSuccess listener.
+ * event = "FACE_SUCCESS" | "LOG_SUCCESS"
+ * data  = CheckFaceResponse object (bridge serialises individual fields, not a JSON string)
+ */
+export interface FaceCompareSuccessEvent {
+    event: string;
+    data: CheckFaceResponse;
+}
 export interface FaceServiceConfig {
     /**
      * Backward/forward compatible:

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

@@ -97,3 +97,12 @@ export interface QualityCheck {
 }
 /** Liveness error – dùng chung EKYCError (event, code, message). */
 export type LivenessError = import('./ekycType').EKYCError;
+/**
+ * Payload emitted by onLivenessSuccess listener.
+ * event = "LIVENESS_SUCCESS" | "LOG_SUCCESS"
+ * data  = CheckLivenessResponse object (bridge serialises fields directly, not a JSON string)
+ */
+export interface LivenessSuccessEvent {
+    event: string;
+    data: CheckLivenessResponse;
+}

package/ios/EKYCModule.swift

@@ -184,8 +184,16 @@ class EKYCModule: RCTEventEmitter {
       let ekycConfig = EKYCConfigSDK(appKey: AppKeyConfig(appKey: appKey), sdkType: .liveness, livenessConfig: livenessConfig)
       SdkEkycLiveness.startEkyc(from: vc, ekycConfigSDK: ekycConfig,
         callbackSuccess: { event, data in
-          let livenessResponse = (data as? SDKEkycResult)?.checkLivenessResponse?.description ?? ""
-          let body: [String: Any] = ["event": event.description, "data": livenessResponse]
+          let livenessResponse = (data as? SDKEkycResult)?.checkLivenessResponse
+          let livenessDict: Any
+          if let resp = livenessResponse,
+             let encoded = try? JSONEncoder().encode(resp),
+             let dict = try? JSONSerialization.jsonObject(with: encoded) as? [String: Any] {
+            livenessDict = dict
+          } else {
+            livenessDict = [String: Any]()
+          }
+          let body: [String: Any] = ["event": event.description, "data": livenessDict]
           self?.emit("onLivenessSuccess", body: body)
           resolve(body)
         },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@finos_sdk/sdk-ekyc",
-  "version": "1.4.6",
+  "version": "1.4.7",
   "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",

package/src/modules/FinosEKYCModule.ts

@@ -4,8 +4,8 @@ import { NfcConfig, NfcError } from '../types/ekycNFCType';
 import { SDKEkycResultWithEvent, SDKEkycResultStringWithEvent, EKYCError, getEkycError, AppIDType } from '../types/ekycType';
 import { C06Config } from '../types/ekycC06Type';
 import { OcrConfig, OcrError } from '../types/ekycOCRType';
-import { LivenessConfig, SDKFaceDetectStatus, LivenessError } from '../types/ekycLivenessType';
-import { FaceServiceConfig, FaceCompareError } from '../types/ekycFaceType';
+import { LivenessConfig, SDKFaceDetectStatus, LivenessError, LivenessSuccessEvent } from '../types/ekycLivenessType';
+import { FaceServiceConfig, FaceCompareError, FaceCompareSuccessEvent } from '../types/ekycFaceType';
 import { SmsOtpConfig, SmsOtpResult, SmsOtpError } from '../types/ekycSmsOtpType';
 import { ESignInitResult, ESignOpenSessionResult, ESignCertificate, ESignSignRequest, ESignError, ESignAuthenticateResult, ESignPdfResult, ESignApiResponse } from '../types/ekycESignType';
 import { SDKFlowType, flowToStrings } from '../types/ekycFlowType';
@@ -194,7 +194,7 @@ export class FinosEKYCModule {
      * @param config.activeActionCount - Number of random actions (1-10), only used when customActions is null (default: 2)
      * @param config.switchFrontCamera - Use front camera (default: false)
      */
-    public async startLiveness(config: LivenessConfig): Promise<SDKEkycResultStringWithEvent> {
+    public async startLiveness(config: LivenessConfig): Promise<LivenessSuccessEvent> {
         this.validateSDKReady();
 
         try {
@@ -221,7 +221,7 @@ export class FinosEKYCModule {
      * Start face comparison (Face Service)
      * @param config Face service configuration
      */
-    public async startFaceCompare(config: FaceServiceConfig): Promise<SDKEkycResultStringWithEvent> {
+    public async startFaceCompare(config: FaceServiceConfig): Promise<FaceCompareSuccessEvent> {
         this.validateSDKReady();
 
         const normalized: FaceServiceConfig = {
@@ -337,7 +337,7 @@ export class FinosEKYCModule {
     /**
      * Listen for liveness success events
      */
-    public onLivenessSuccess(callback: (data: SDKEkycResultStringWithEvent) => void) {
+    public onLivenessSuccess(callback: (data: LivenessSuccessEvent) => void) {
         return this.sdk.onLivenessSuccess(callback);
     }
 
@@ -352,7 +352,7 @@ export class FinosEKYCModule {
     /**
      * Listen for face compare success events
      */
-    public onFaceCompareSuccess(callback: (data: SDKEkycResultWithEvent) => void) {
+    public onFaceCompareSuccess(callback: (data: FaceCompareSuccessEvent) => void) {
         return this.sdk.onFaceCompareSuccess(callback);
     }
 

package/src/modules/FinosESignModule.ts

@@ -2,8 +2,8 @@ import { Platform } from 'react-native';
 import sdkEKYC, { SDKeKYC, SDK_VERSION, SDK_NAME } from '../../EKYCModule';
 import { SmsOtpConfig, SmsOtpResult, SmsOtpError } from '../types/ekycSmsOtpType';
 import { ESignInitResult, ESignOpenSessionResult, ESignCertificate, ESignSignRequest, ESignError, ESignAuthenticateResult, AuthorizeInfo, ESignPdfResult, ESignApiResponse } from '../types/ekycESignType';
-import { LivenessConfig, LivenessError } from '../types/ekycLivenessType';
-import { FaceServiceConfig, FaceCompareError } from '../types/ekycFaceType';
+import { LivenessConfig, LivenessError, LivenessSuccessEvent } from '../types/ekycLivenessType';
+import { FaceServiceConfig, FaceCompareError, FaceCompareSuccessEvent } from '../types/ekycFaceType';
 import { SDKEkycResultStringWithEvent, SDKEkycResultWithEvent, EKYCError, getEkycError } from '../types/ekycType';
 
 /**
@@ -565,14 +565,14 @@ export class FinosESignModule {
      * @param config.activeActionCount - Number of random actions (1-10), only used when customActions is null (default: 2)
      * @param config.switchFrontCamera - Use front camera (default: false)
      */
-    public async startLiveness(config: LivenessConfig): Promise<SDKEkycResultStringWithEvent> {
+    public async startLiveness(config: LivenessConfig): Promise<LivenessSuccessEvent> {
         this.validateSDKReady();
         // Pass through to SDK - error handling is done in EKYCModule.ts
         return await this.sdk.startLiveness(config);
     }
 
     // Liveness Event Listeners
-    public onLivenessSuccess(callback: (data: SDKEkycResultStringWithEvent) => void) {
+    public onLivenessSuccess(callback: (data: LivenessSuccessEvent) => void) {
         return this.sdk.onLivenessSuccess(callback);
     }
 
@@ -587,7 +587,7 @@ export class FinosESignModule {
      * Face matching (Face Service)
      * @param config Face service configuration
      */
-    public async startFaceCompare(config: FaceServiceConfig): Promise<SDKEkycResultStringWithEvent> {
+    public async startFaceCompare(config: FaceServiceConfig): Promise<FaceCompareSuccessEvent> {
         this.validateSDKReady();
         const normalized: FaceServiceConfig = {
             ...config,
@@ -598,7 +598,7 @@ export class FinosESignModule {
     }
 
     // Face Compare Event Listeners
-    public onFaceCompareSuccess(callback: (data: SDKEkycResultWithEvent) => void) {
+    public onFaceCompareSuccess(callback: (data: FaceCompareSuccessEvent) => void) {
         return this.sdk.onFaceCompareSuccess(callback);
     }
 

package/src/types/ekycFaceType.ts

@@ -14,6 +14,16 @@ export interface FaceVerifyResult {
     toBeReviewed?: string;
 }
 
+/**
+ * Payload emitted by onFaceCompareSuccess listener.
+ * event = "FACE_SUCCESS" | "LOG_SUCCESS"
+ * data  = CheckFaceResponse object (bridge serialises individual fields, not a JSON string)
+ */
+export interface FaceCompareSuccessEvent {
+    event: string;
+    data: CheckFaceResponse;
+}
+
 export interface FaceServiceConfig {
     /**
      * Backward/forward compatible:

package/src/types/ekycLivenessType.ts

@@ -131,3 +131,13 @@ export interface QualityCheck {
 
 /** Liveness error – dùng chung EKYCError (event, code, message). */
 export type LivenessError = import('./ekycType').EKYCError;
+
+/**
+ * Payload emitted by onLivenessSuccess listener.
+ * event = "LIVENESS_SUCCESS" | "LOG_SUCCESS"
+ * data  = CheckLivenessResponse object (bridge serialises fields directly, not a JSON string)
+ */
+export interface LivenessSuccessEvent {
+    event: string;
+    data: CheckLivenessResponse;
+}