@finos_sdk/sdk-ekyc 1.4.5 → 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.5.2"
+    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

@@ -27,6 +27,7 @@ import finos.sdk.core.model.sdk.config.AppKeyConfig
 import finos.sdk.core.model.sdk.config.C06Config
 import finos.sdk.core.model.sdk.config.EKYCConfigSDK
 import finos.sdk.core.model.sdk.config.FaceServiceConfig
+import finos.sdk.core.model.sdk.config.LivenessBackConfirmConfig
 import finos.sdk.core.model.sdk.config.LivenessConfig
 import finos.sdk.core.model.sdk.config.NfcConfig
 import finos.sdk.core.model.sdk.config.OcrConfig
@@ -96,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 {
@@ -235,7 +276,7 @@ class EKYCModule(reactContext: ReactApplicationContext) : ReactContextBaseJavaMo
                             val eventMap =
                                 Arguments.createMap().apply {
                                     putString("event", event.name.toString())
-                                    putString("data", data.toString())
+                                    putString("data", Gson().toJson(data))
                                 }
                             sendEvent("onNfcScanStart", eventMap)
                         }
@@ -260,7 +301,7 @@ class EKYCModule(reactContext: ReactApplicationContext) : ReactContextBaseJavaMo
                             val eventMap =
                                 Arguments.createMap().apply {
                                     putString("event", event.name.toString())
-                                    putString("data", data.toString())
+                                    putString("data", Gson().toJson(data))
                                 }
                             sendEvent("onNfcEvent", eventMap)
                         }
@@ -314,18 +355,19 @@ class EKYCModule(reactContext: ReactApplicationContext) : ReactContextBaseJavaMo
                 ekycConfigSDK = ekycConfig,
                 callbackSuccess = { event, data ->
                     Log.d(TAG, "✅ checkC06() success")
+                    val c06Json = Gson().toJson((data as? SDKEkycResult)?.checkC06Response)
 
                     // Create separate maps for event and promise
                     val eventMap =
                         Arguments.createMap().apply {
                             putString("event", event.name.toString())
-                            putString("data", data.toString())
+                            putString("data", c06Json)
                         }
 
                     val promiseMap =
                         Arguments.createMap().apply {
                             putString("event", event.name.toString())
-                            putString("data", data.toString())
+                            putString("data", c06Json)
                         }
                     sendEvent("onC06Success", eventMap)
                     promise.resolve(promiseMap)
@@ -389,7 +431,7 @@ class EKYCModule(reactContext: ReactApplicationContext) : ReactContextBaseJavaMo
                     Log.d(TAG, "✅ startOcr() success")
                     val (eventMap, promiseMap) = createSeparateMaps { map ->
                         map.putString("event", event.name.toString())
-                        map.putString("data", (data as SDKEkycResult).ocrResponse.toString())
+                        map.putString("data", Gson().toJson((data as SDKEkycResult).ocrResponse))
                     }
                     sendEvent("onOcrSuccess", eventMap)
                     promise.resolve(promiseMap)
@@ -428,6 +470,8 @@ class EKYCModule(reactContext: ReactApplicationContext) : ReactContextBaseJavaMo
         activeActionCount: Int?,
         forceCaptureTimeout: Double?,
         isActiveLivenessColor: Boolean?,
+        isShowBackConfirmation: Boolean?,
+        backConfirmConfigJson: String?,
         promise: Promise
     ) {
         Log.d(TAG, "▶️ startLiveness() called")
@@ -461,6 +505,7 @@ class EKYCModule(reactContext: ReactApplicationContext) : ReactContextBaseJavaMo
                 null
             }
 
+            val backConfirmConfig = parseBackConfirmConfig(backConfirmConfigJson)
             val livenessConfig =
                 LivenessConfig(
                     isActiveLiveness = isActiveLiveness ?: false,
@@ -475,7 +520,9 @@ class EKYCModule(reactContext: ReactApplicationContext) : ReactContextBaseJavaMo
                     activeActionCount = activeActionCount ?: 2,
                     forceCaptureTimeout = (forceCaptureTimeout ?: 0.0).toLong(),
                     selfieImage = imageFile,
-                    transactionId = transactionId
+                    transactionId = transactionId,
+                    isShowBackConfirmation = isShowBackConfirmation ?: false,
+                    backConfirmConfig = backConfirmConfig,
                 )
             val ekycConfig =
                 EKYCConfigSDK(
@@ -486,24 +533,25 @@ class EKYCModule(reactContext: ReactApplicationContext) : ReactContextBaseJavaMo
             eKYCFinOSLiveness.startEkyc(
                 ekycConfigSDK = ekycConfig,
                 callbackSuccess = { event, data ->
-                    // LOG_SUCCESS = internal submit result event (v1.4.5), don't resolve promise
-                    if (event == EKYCEvent.LOG_SUCCESS) {
-                        val logDataStr = data?.customData?.let { Gson().toJson(it) } ?: data?.toString() ?: "null"
-                        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", (data as SDKEkycResult).checkLivenessResponse.toString())
-                    }
-                    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}")
@@ -570,24 +618,21 @@ class EKYCModule(reactContext: ReactApplicationContext) : ReactContextBaseJavaMo
                 eKYCFinOSFaceService.startEkyc(
                     ekycConfigSDK = ekycConfig,
                     callbackSuccess = { event, data ->
-                        // LOG_SUCCESS = internal submit result event (v1.4.5), don't resolve promise
-                        if (event == EKYCEvent.LOG_SUCCESS) {
-                            val logDataStr = data?.customData?.let { Gson().toJson(it) } ?: data?.toString() ?: "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 (eventMap, promiseMap) = createSeparateMaps { map ->
-                            map.putString("event", event.name.toString())
-                            map.putString("data", data.toString())
-                        }
-                        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}")
@@ -783,6 +828,9 @@ class EKYCModule(reactContext: ReactApplicationContext) : ReactContextBaseJavaMo
                 else -> AppIDType.NONE
             }
 
+            val isShowBackConfirmation = extractBooleanValue(optionConfigJson, "isShowBackConfirmation") ?: false
+            val backConfirmConfig = parseBackConfirmConfig(extractObjectJson(optionConfigJson, "backConfirmConfig"))
+
             val livenessConfig = if (finalFlow.contains(SDKType.LIVENESS)) {
                 LivenessConfig(
                     isActiveLiveness = isActiveLiveness,
@@ -790,6 +838,8 @@ class EKYCModule(reactContext: ReactApplicationContext) : ReactContextBaseJavaMo
                     isShowCameraFont = switchFrontCamera,
                     customActions = customActionsList?.takeIf { it.isNotEmpty() },
                     activeActionCount = activeActionCount,
+                    isShowBackConfirmation = isShowBackConfirmation,
+                    backConfirmConfig = backConfirmConfig,
                 )
             } else null
 
@@ -807,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) } ?: data?.toString() ?: "null"
-                        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", data.toString())
-                            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 ->
@@ -853,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)
                 }
             )
@@ -895,32 +959,42 @@ class EKYCModule(reactContext: ReactApplicationContext) : ReactContextBaseJavaMo
     private fun parseOptionConfig(optionConfigJson: String): OptionConfig {
         return try {
             if (optionConfigJson.isBlank() || optionConfigJson == "{}") {
-                // Return default values based on demo OptionConfig.kt
-                OptionConfig(
-                    baseUrl = null,
-                    countMaxRetry = 3,
-                    language = null
-                )
+                OptionConfig()
             } else {
-                // Simple JSON parsing (in real implementation, use proper JSON library)
                 val baseUrl = extractStringValue(optionConfigJson, "baseUrl")
                 val countMaxRetry = extractIntValue(optionConfigJson, "countMaxRetry") ?: 3
                 val language = extractStringValue(optionConfigJson, "language")
+                val networkTimeoutMs = extractLongValue(optionConfigJson, "networkTimeoutMs") ?: 30_000L
 
                 OptionConfig(
                     baseUrl = baseUrl,
                     countMaxRetry = countMaxRetry,
-                    language = language
+                    language = language,
+                    networkTimeoutMs = networkTimeoutMs,
                 )
             }
         } catch (e: Exception) {
             Log.e(TAG, "Error parsing optionConfig: ${e.message}", e)
-            // Return default values
-            OptionConfig(
-                baseUrl = null,
-                countMaxRetry = 3,
-                language = null
+            OptionConfig()
+        }
+    }
+
+    private fun parseBackConfirmConfig(json: String?): LivenessBackConfirmConfig? {
+        if (json.isNullOrBlank() || json == "{}") return null
+        return try {
+            LivenessBackConfirmConfig(
+                titleVi = extractStringValue(json, "titleVi"),
+                titleEn = extractStringValue(json, "titleEn"),
+                bodyVi = extractStringValue(json, "bodyVi"),
+                bodyEn = extractStringValue(json, "bodyEn"),
+                confirmButtonVi = extractStringValue(json, "confirmButtonVi"),
+                confirmButtonEn = extractStringValue(json, "confirmButtonEn"),
+                cancelButtonVi = extractStringValue(json, "cancelButtonVi"),
+                cancelButtonEn = extractStringValue(json, "cancelButtonEn"),
             )
+        } catch (e: Exception) {
+            Log.e(TAG, "Error parsing backConfirmConfig: ${e.message}", e)
+            null
         }
     }
 
@@ -934,6 +1008,16 @@ class EKYCModule(reactContext: ReactApplicationContext) : ReactContextBaseJavaMo
         }
     }
 
+    private fun extractLongValue(json: String, key: String): Long? {
+        return try {
+            val pattern = "\"$key\"\\s*:\\s*(-?\\d+)".toRegex()
+            val match = pattern.find(json)
+            match?.groupValues?.get(1)?.toLong()
+        } catch (e: Exception) {
+            null
+        }
+    }
+
     private fun extractBooleanValue(json: String, key: String): Boolean? {
         return try {
             val pattern = "\"$key\"\\s*:\\s*(true|false)".toRegex()
@@ -1088,6 +1172,17 @@ class EKYCModule(reactContext: ReactApplicationContext) : ReactContextBaseJavaMo
         }
     }
 
+    /** Extract a nested JSON object `{ ... }` for a given key. Returns the raw JSON string or null. */
+    private fun extractObjectJson(json: String, key: String): String? {
+        return try {
+            val obj = JSONObject(json)
+            val nested = obj.optJSONObject(key) ?: return null
+            nested.toString()
+        } catch (e: Exception) {
+            null
+        }
+    }
+
     // ==================== SMS OTP Methods ====================
 
     @ReactMethod
@@ -2115,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;
@@ -148,6 +148,16 @@ declare class SDKeKYC {
         baseUrl?: string;
         countMaxRetry?: number;
         language?: string;
+        networkTimeoutMs?: number;
+        switchFrontCamera?: boolean;
+        isActiveLiveness?: boolean;
+        autoCapture?: boolean;
+        forceCaptureTimeout?: number;
+        customActions?: string[];
+        activeActionCount?: number;
+        appIDType?: string;
+        isShowBackConfirmation?: boolean;
+        backConfirmConfig?: import('./src/types/ekycLivenessType').LivenessBackConfirmConfig;
     }, styleConfig?: {
         textSize?: number;
         textFont?: string;

package/dist/EKYCModule.js

@@ -213,7 +213,10 @@ class SDKeKYC {
         try {
             // Convert SDKFaceDetectStatus enum array to string array
             const customActionsStrings = (_b = (_a = config.customActions) === null || _a === void 0 ? void 0 : _a.map(action => String(action))) !== null && _b !== void 0 ? _b : undefined;
-            return await nativeModule.startLiveness(config.appKey, config.selfieImage, (_c = config.transactionId) !== null && _c !== void 0 ? _c : '', config.isActiveLiveness, config.isShowCameraFont, customActionsStrings, config.activeActionCount, config.forceCaptureTimeout, config.isActiveLivenessColor);
+            const backConfirmConfigJson = config.backConfirmConfig
+                ? JSON.stringify(config.backConfirmConfig)
+                : undefined;
+            return await nativeModule.startLiveness(config.appKey, config.selfieImage, (_c = config.transactionId) !== null && _c !== void 0 ? _c : '', config.isActiveLiveness, config.isShowCameraFont, customActionsStrings, config.activeActionCount, config.forceCaptureTimeout, config.isActiveLivenessColor, config.isShowBackConfirmation, backConfirmConfigJson);
         }
         catch (error) {
             console.error('Liveness Error:', error);

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.5",
+  "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;
     /**
@@ -308,6 +308,8 @@ export declare class FinosEKYCModule {
         baseUrl?: string;
         countMaxRetry?: number;
         language?: string;
+        /** Network timeout in milliseconds (default: 30000). callTimeout = networkTimeoutMs * 2 */
+        networkTimeoutMs?: number;
         switchFrontCamera?: boolean;
         /** LivenessConfig – SDKeKYCActivity (157-169) */
         isActiveLiveness?: boolean;
@@ -318,6 +320,10 @@ export declare class FinosEKYCModule {
         activeActionCount?: number;
         /** AppIDType: NONE | HD_BANK | VIKKI (default: AppIDType.NONE) */
         appIDType?: AppIDType;
+        /** Show confirmation bottom sheet when user presses back in liveness screen (v1.4.6+) */
+        isShowBackConfirmation?: boolean;
+        /** Text config for the back confirmation bottom sheet (v1.4.6+) */
+        backConfirmConfig?: import('../types/ekycLivenessType').LivenessBackConfirmConfig;
     }, styleConfig?: {
         textSize?: number;
         textFont?: string;

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;
     /**
@@ -286,6 +286,8 @@ export declare class FinosESignModule {
         baseUrl?: string;
         countMaxRetry?: number;
         language?: string;
+        /** Network timeout in milliseconds (default: 30000). callTimeout = networkTimeoutMs * 2 */
+        networkTimeoutMs?: number;
         switchFrontCamera?: boolean;
     }, styleConfig?: {
         textSize?: number;

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

@@ -20,6 +20,17 @@ export declare enum SDKFaceDetectStatus {
 export declare const SDK_LIVENESS_ACTIONS: readonly SDKFaceDetectStatus[];
 /** Chuyển customActions enum[] sang string[] khi gửi xuống native. */
 export declare function customActionsToStrings(actions: SDKFaceDetectStatus[]): string[];
+/** Text config for the back-press confirmation bottom sheet (v1.4.6+). All fields optional – fallback to built-in strings. */
+export interface LivenessBackConfirmConfig {
+    titleVi?: string;
+    titleEn?: string;
+    bodyVi?: string;
+    bodyEn?: string;
+    confirmButtonVi?: string;
+    confirmButtonEn?: string;
+    cancelButtonVi?: string;
+    cancelButtonEn?: string;
+}
 export interface LivenessConfig {
     appKey: string;
     transactionId?: string;
@@ -30,6 +41,8 @@ export interface LivenessConfig {
     customActions?: SDKFaceDetectStatus[];
     activeActionCount?: number;
     forceCaptureTimeout?: number;
+    isShowBackConfirmation?: boolean;
+    backConfirmConfig?: LivenessBackConfirmConfig;
 }
 export interface CheckLivenessResponse {
     metadata?: Metadata;
@@ -84,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

@@ -96,14 +96,14 @@ class EKYCModule: RCTEventEmitter {
         callbackSuccess: { event, data in
           switch event {
           case .SCAN_NFC_START:
-            self?.emit("onNfcScanStart", body: ["event": event.description, "data": "\(String(describing: data))"])
+            self?.emit("onNfcScanStart", body: ["event": event.description, "data": (data as? SDKEkycResult)?.nfcResponse ?? "{}"])
           case .SCAN_NFC_SUCCESS:
             let nfcResponse = (data as? SDKEkycResult)?.nfcResponse ?? ""
             let body: [String: Any] = ["event": event.description, "data": nfcResponse]
             self?.emit("onNfcScanSuccess", body: body)
             resolve(body)
           default:
-            self?.emit("onNfcEvent", body: ["event": event.description, "data": "\(String(describing: data))"])
+            self?.emit("onNfcEvent", body: ["event": event.description, "data": (data as? SDKEkycResult)?.nfcResponse ?? "{}"])
           }
         },
         callbackError: { event, errorResult in
@@ -123,7 +123,8 @@ class EKYCModule: RCTEventEmitter {
     let ekycConfig = EKYCConfigSDK(appKey: AppKeyConfig(appKey: appKey), c06Config: c06Config)
     SdkEkycC06.startEkyc(ekycConfigSDK: ekycConfig,
       callbackSuccess: { [weak self] event, data in
-        let body: [String: Any] = ["event": event.description, "data": "\(String(describing: data))"]
+        let c06Response = (data as? SDKEkycResult)?.checkC06Response?.description ?? "{}"
+        let body: [String: Any] = ["event": event.description, "data": c06Response]
         self?.emit("onC06Success", body: body)
         resolve(body)
       },
@@ -183,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)
         },
@@ -210,7 +219,17 @@ class EKYCModule: RCTEventEmitter {
     DispatchQueue.main.async { [weak self] in
       SdkEkycFaceService.startEkyc(ekycConfigSDK: ekycConfig,
         callbackSuccess: { event, data in
-          let body: [String: Any] = ["event": event.description, "data": "\(String(describing: data))"]
+          let faceResponse = (data as? SDKEkycResult)?.checkFaceResponse
+          var faceDict: [String: Any] = [:]
+          if let v = faceResponse?.requestId { faceDict["requestId"] = v }
+          if let r = faceResponse?.result {
+            faceDict["result"] = ["conf": r.conf, "match": r.match, "matchScore": r.matchScore, "toBeReviewed": r.toBeReviewed]
+          }
+          if let v = faceResponse?.status { faceDict["status"] = v }
+          if let v = faceResponse?.statusCode { faceDict["statusCode"] = v }
+          if let v = faceResponse?.error { faceDict["error"] = v }
+          if let v = faceResponse?.type { faceDict["type"] = v }
+          let body: [String: Any] = ["event": event.description, "data": faceDict]
           self?.emit("onFaceCompareSuccess", body: body)
           resolve(body)
         },
@@ -291,7 +310,16 @@ class EKYCModule: RCTEventEmitter {
             return
           }
           let files = result?.ekycStateModel?.eKYCFileModel
-          var body: [String: Any] = ["status": "success", "event": event.description, "data": "\(String(describing: data))", "transactionId": result?.ekycStateModel?.transactionId ?? ""]
+          var dataDict: [String: Any] = [:]
+          if let v = result?.nfcResponse { dataDict["nfcResponse"] = v }
+          if let v = result?.checkC06Response?.description { dataDict["checkC06Response"] = v }
+          if let v = result?.ocrResponse?.description { dataDict["ocrResponse"] = v }
+          if let v = result?.checkLivenessResponse?.description { dataDict["checkLivenessResponse"] = v }
+          if let v = result?.checkFaceResponse?.description { dataDict["checkFaceResponse"] = v }
+          if let v = result?.customData { dataDict["customData"] = v }
+          let dataJson = (try? JSONSerialization.data(withJSONObject: dataDict))
+            .flatMap { String(data: $0, encoding: .utf8) } ?? "{}"
+          var body: [String: Any] = ["status": "success", "event": event.description, "data": dataJson, "transactionId": result?.ekycStateModel?.transactionId ?? ""]
           if let facePath = files?.imageFace { body["imageFacePath"] = facePath.path }
           if let frontPath = files?.imageOcrFront { body["imageOcrFrontPath"] = frontPath.path }
           if let backPath = files?.imageOcrBack { body["imageOcrBackPath"] = backPath.path }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@finos_sdk/sdk-ekyc",
-  "version": "1.4.5",
+  "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);
     }
 
@@ -764,6 +764,8 @@ export class FinosEKYCModule {
             baseUrl?: string;
             countMaxRetry?: number;
             language?: string;
+            /** Network timeout in milliseconds (default: 30000). callTimeout = networkTimeoutMs * 2 */
+            networkTimeoutMs?: number;
             switchFrontCamera?: boolean;
             /** LivenessConfig – SDKeKYCActivity (157-169) */
             isActiveLiveness?: boolean;
@@ -774,6 +776,10 @@ export class FinosEKYCModule {
             activeActionCount?: number;
             /** AppIDType: NONE | HD_BANK | VIKKI (default: AppIDType.NONE) */
             appIDType?: AppIDType;
+            /** Show confirmation bottom sheet when user presses back in liveness screen (v1.4.6+) */
+            isShowBackConfirmation?: boolean;
+            /** Text config for the back confirmation bottom sheet (v1.4.6+) */
+            backConfirmConfig?: import('../types/ekycLivenessType').LivenessBackConfirmConfig;
         },
         styleConfig?: {
             textSize?: number;

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);
     }
 
@@ -634,6 +634,8 @@ export class FinosESignModule {
             baseUrl?: string;
             countMaxRetry?: number;
             language?: string;
+            /** Network timeout in milliseconds (default: 30000). callTimeout = networkTimeoutMs * 2 */
+            networkTimeoutMs?: number;
             switchFrontCamera?: boolean;
         },
         styleConfig?: {

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

@@ -38,11 +38,23 @@ export function customActionsToStrings(actions: SDKFaceDetectStatus[]): string[]
     return actions.map(a => a as string);
 }
 
+/** Text config for the back-press confirmation bottom sheet (v1.4.6+). All fields optional – fallback to built-in strings. */
+export interface LivenessBackConfirmConfig {
+    titleVi?: string;
+    titleEn?: string;
+    bodyVi?: string;
+    bodyEn?: string;
+    confirmButtonVi?: string;
+    confirmButtonEn?: string;
+    cancelButtonVi?: string;
+    cancelButtonEn?: string;
+}
+
 export interface LivenessConfig {
     appKey: string;
     transactionId?: string;
     // old fields usingRandomAction and isStraight removed in 1.3.1
-    // usingRandomAction: boolean; 
+    // usingRandomAction: boolean;
     // isStraight: boolean;
     selfieImage: string;
     // New fields for version 1.3.0
@@ -52,6 +64,9 @@ export interface LivenessConfig {
     customActions?: SDKFaceDetectStatus[];
     activeActionCount?: number;
     forceCaptureTimeout?: number;
+    // New fields for version 1.4.6
+    isShowBackConfirmation?: boolean;
+    backConfirmConfig?: LivenessBackConfirmConfig;
 }
 
 export interface CheckLivenessResponse {
@@ -116,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;
+}