@finos_sdk/sdk-ekyc 1.3.2 → 1.3.3

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.2"
+    def sdkVersion = "1.3.3.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

@@ -38,6 +38,7 @@ import finos.sdk.smsotp.SdkSmsOtpService
 import finos.sdk.core.model.sdk.config.SmsOtpConfig
 import vn.softdreams.easyca.sdk.SdkeSign
 
+import org.json.JSONArray
 import org.json.JSONObject
 import java.io.File
 import java.io.FileOutputStream
@@ -102,8 +103,20 @@ class EKYCModule(reactContext: ReactApplicationContext) : ReactContextBaseJavaMo
                 promise.resolve(true)
             }
         } catch (e: Exception) {
-            Log.e(TAG, "❌ initSdkEkyc() failed: ${e.message}", e)
-            promise.reject("INIT_ERROR", "Failed to initialize SDK EKYC: ${e.message}")
+            val msg = e.message?.lowercase() ?: ""
+            // SDK đã được khởi tạo (Koin/DI already started) → coi là thành công, cho icon pass xanh / text xanh
+            if (msg.contains("already been started") || msg.contains("already started") || msg.contains("already initialized")) {
+                Log.d(TAG, "✅ initSdkEkyc() – SDK đã khởi tạo, trả success (không coi là lỗi)")
+                val params = Arguments.createMap().apply {
+                    putString("status", "success")
+                    putString("message", "SDK EKYC already initialized")
+                }
+                sendEvent("EKYCInitEvent", params)
+                promise.resolve(true)
+            } else {
+                Log.e(TAG, "❌ initSdkEkyc() failed: ${e.message}", e)
+                promise.reject("INIT_ERROR", "Failed to initialize SDK EKYC: ${e.message}")
+            }
         }
     }
 
@@ -535,6 +548,20 @@ class EKYCModule(reactContext: ReactApplicationContext) : ReactContextBaseJavaMo
         }
     }
 
+    /**
+     * Convert File to base64 string for passing to React Native.
+     * Mirrors Android SDK: data?.ekycStateModel?.eKYCFileModel?.imageFace
+     */
+    private fun fileToBase64(file: File?): String? {
+        if (file == null || !file.exists()) return null
+        return try {
+            Base64.encodeToString(file.readBytes(), Base64.NO_WRAP)
+        } catch (e: Exception) {
+            Log.e(TAG, "fileToBase64 error: ${e.message}", e)
+            null
+        }
+    }
+
     @ReactMethod
     fun startEkycUI(
         appKey: String,
@@ -574,15 +601,26 @@ class EKYCModule(reactContext: ReactApplicationContext) : ReactContextBaseJavaMo
             // Parse StyleConfig JSON from React Native
             val styleConfig = parseStyleConfig(styleConfigJson)
 
-            // Extract switchFrontCamera from optionConfigJson
+            // LivenessConfig theo SDKeKYCActivity (157-169): isActiveLiveness, autoCapture, forceCaptureTimeout, isShowCameraFont, customActions, activeActionCount
             val switchFrontCamera = extractBooleanValue(optionConfigJson, "switchFrontCamera") ?: false
+            val isActiveLiveness = extractBooleanValue(optionConfigJson, "isActiveLiveness") ?: true
+            val autoCapture = extractBooleanValue(optionConfigJson, "autoCapture") ?: true
+            val forceCaptureTimeoutSec = extractIntValue(optionConfigJson, "forceCaptureTimeout") ?: 30
+            val customActionsList = parseCustomActionsFromJson(optionConfigJson)
+            val activeActionCount = extractIntValue(optionConfigJson, "activeActionCount") ?: customActionsList?.size ?: 2
 
-            // Create LivenessConfig if LIVENESS is in the flow and switchFrontCamera is set
-            val livenessConfig = if (finalFlow.contains(SDKType.LIVENESS) && switchFrontCamera) {
-                LivenessConfig(isShowCameraFont = true)
+            val livenessConfig = if (finalFlow.contains(SDKType.LIVENESS)) {
+                LivenessConfig(
+                    isActiveLiveness = isActiveLiveness,
+                    autoCapture = autoCapture,
+                    forceCaptureTimeout = (forceCaptureTimeoutSec * 1000L).coerceAtLeast(0),
+                    isShowCameraFont = switchFrontCamera,
+                    customActions = customActionsList?.takeIf { it.isNotEmpty() },
+                    activeActionCount = activeActionCount,
+                )
             } else null
 
-            // Create EKYCConfigSDK like MainActivity.kt
+            // Create EKYCConfigSDK like SDKeKYCActivity / MainActivity.kt
             val ekycConfigSDK = EKYCConfigSDK(
                 appKey = appKeyConfig,
                 optionConfig = optionConfig.copy(language = if (language == "en") "en" else "vi"),
@@ -596,14 +634,31 @@ class EKYCModule(reactContext: ReactApplicationContext) : ReactContextBaseJavaMo
                 activity = currentActivity,
                 ekycConfigSDK = ekycConfigSDK,
                 callbackSuccess = { event, data ->
-                    Log.d(TAG, "✅ startEkycUI() success")
-                    val (eventMap, promiseMap) = createSeparateMaps { map ->
-                        map.putString("status", "success")
-                        map.putString("event", event.name.toString())
-                        map.putString("data", data.toString())
+                    Log.d(TAG, "✅ startEkycUI() callback - 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 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)
                     }
-                    sendEvent("onEkycUISuccess", eventMap)
-                    promise.resolve(promiseMap)
                 },
                 callbackError = { event, errorResult ->
                     Log.e(TAG, "❌ startEkycUI() failed - Event: $event, Message: ${errorResult.message}")
@@ -703,6 +758,37 @@ class EKYCModule(reactContext: ReactApplicationContext) : ReactContextBaseJavaMo
         }
     }
 
+    /** Parse customActions array from optionConfig JSON. Maps như SDKeKYCActivity getSelectedCustomActions. */
+    private fun parseCustomActionsFromJson(optionConfigJson: String): List<SDKFaceDetectStatus>? {
+        return try {
+            val obj = JSONObject(optionConfigJson)
+            val arr = obj.optJSONArray("customActions") ?: return null
+            if (arr.length() == 0) return null
+            val actions = mutableListOf<SDKFaceDetectStatus>()
+            for (i in 0 until arr.length()) {
+                val s = arr.optString(i, "")
+                when (s) {
+                    "LEFT" -> actions.add(SDKFaceDetectStatus.LEFT)
+                    "RIGHT" -> actions.add(SDKFaceDetectStatus.RIGHT)
+                    "UP" -> actions.add(SDKFaceDetectStatus.UP)
+                    "DOWN" -> actions.add(SDKFaceDetectStatus.DOWN)
+                    "SMILE" -> actions.add(SDKFaceDetectStatus.SMILE)
+                    "BLINK" -> actions.add(SDKFaceDetectStatus.BLINK)
+                    "TILT_LEFT" -> actions.add(SDKFaceDetectStatus.TILT_LEFT)
+                    "TILT_RIGHT" -> actions.add(SDKFaceDetectStatus.TILT_RIGHT)
+                    "WINK_LEFT" -> actions.add(SDKFaceDetectStatus.WINK_LEFT)
+                    "WINK_RIGHT" -> actions.add(SDKFaceDetectStatus.WINK_RIGHT)
+                    "STRAIGHT" -> actions.add(SDKFaceDetectStatus.STRAIGHT)
+                    else -> if (s.isNotEmpty()) Log.w(TAG, "parseCustomActionsFromJson: unknown action=$s")
+                }
+            }
+            if (actions.isNotEmpty()) actions else null
+        } catch (e: Exception) {
+            Log.w(TAG, "parseCustomActionsFromJson: ${e.message}")
+            null
+        }
+    }
+
     private fun parseAppKeyConfig(appKeyConfigJson: String): AppKeyConfig {
         return try {
             if (appKeyConfigJson.isBlank() || appKeyConfigJson == "{}") {
@@ -1019,14 +1105,26 @@ class EKYCModule(reactContext: ReactApplicationContext) : ReactContextBaseJavaMo
                     promise.resolve(promiseMap)
                 },
                 callbackError = { event, error ->
-                    Log.e(TAG, "❌ initializeESign() failed - Event: $event, Message: ${error.message}")
-                    val errorMap = Arguments.createMap().apply {
-                        putString("event", event.name.toString())
-                        putString("message", error.message ?: "")
-                        putString("code", error.code.toString())
+                    val msg = (error.message ?: "").lowercase()
+                    // eSign đã được khởi tạo → coi là thành công, cho icon pass xanh / text xanh
+                    if (msg.contains("đã được khởi tạo") || msg.contains("already") || msg.contains("already initialized")) {
+                        Log.d(TAG, "✅ initializeESign() – eSign đã khởi tạo, trả success (không coi là lỗi)")
+                        val (eventMap, promiseMap) = createSeparateMaps { map ->
+                            map.putString("code", "0")
+                            map.putString("message", "eSign already initialized")
+                        }
+                        sendEvent("onESignInitSuccess", eventMap)
+                        promise.resolve(promiseMap)
+                    } else {
+                        Log.e(TAG, "❌ initializeESign() failed - Event: $event, Message: ${error.message}")
+                        val errorMap = Arguments.createMap().apply {
+                            putString("event", event.name.toString())
+                            putString("message", error.message ?: "")
+                            putString("code", error.code.toString())
+                        }
+                        sendEvent("onESignError", errorMap)
+                        promise.reject(event.name.toString(), error.message ?: "Unknown Error")
                     }
-                    sendEvent("onESignError", errorMap)
-                    promise.reject(event.name.toString(), error.message ?: "Unknown Error")
                 }
             )
         } catch (e: Exception) {
@@ -1053,9 +1151,14 @@ class EKYCModule(reactContext: ReactApplicationContext) : ReactContextBaseJavaMo
                     promise.resolve(token)
                 },
                 callbackError = { event, error ->
-                    Log.e(TAG, "❌ getSdkToken() failed: $error")
-                    // error might be String or Object, toString() covers both
-                    promise.reject("GET_SDK_TOKEN_ERROR", error.toString())
+                    Log.e(TAG, "❌ getSdkToken() failed - Event: $event, Message: ${error.message}")
+                    val errorMap = Arguments.createMap().apply {
+                        putString("event", event.name.toString())
+                        putString("message", error.message ?: "")
+                        putString("code", error.code.toString())
+                    }
+                    sendEvent("onESignError", errorMap)
+                    promise.reject(event.name.toString(), error.message ?: "Get SDK Token failed")
                 }
             )
         } catch (e: Exception) {
@@ -1420,26 +1523,14 @@ class EKYCModule(reactContext: ReactApplicationContext) : ReactContextBaseJavaMo
                 callbackError = { event, error ->
                     val errorMessage = error.message ?: ""
                     val errorCode = error.code.toString()
-                    
-                    // Check if message contains "thành công" or code == "0" -> treat as success
-                    if (errorMessage.contains("thành công", ignoreCase = true) || errorCode == "0") {
-                        Log.d(TAG, "✅ registerRemoteSigning() success (async operation) - Message: $errorMessage")
-                        val (eventMap, promiseMap) = createSeparateMaps { map ->
-                            map.putString("response", "{\"status\":1,\"msg\":\"$errorMessage\"}")
-                            map.putString("message", errorMessage)
-                        }
-                        sendEvent("onESignRegisterRemoteSigningSuccess", eventMap)
-                        promise.resolve(promiseMap)
-                    } else {
-                        Log.e(TAG, "❌ registerRemoteSigning() failed - Event: $event, Message: $errorMessage")
-                        val errorMap = Arguments.createMap().apply {
-                            putString("event", event.name.toString())
-                            putString("message", errorMessage)
-                            putString("code", errorCode)
-                        }
-                        sendEvent("onESignError", errorMap)
-                        promise.reject(event.name.toString(), errorMessage)
+                    Log.e(TAG, "❌ registerRemoteSigning() failed - Event: $event, Message: $errorMessage")
+                    val errorMap = Arguments.createMap().apply {
+                        putString("event", event.name.toString())
+                        putString("message", errorMessage)
+                        putString("code", errorCode)
                     }
+                    sendEvent("onESignError", errorMap)
+                    promise.reject(event.name.toString(), errorMessage)
                 }
             )
         } catch (e: Exception) {
@@ -1448,6 +1539,48 @@ class EKYCModule(reactContext: ReactApplicationContext) : ReactContextBaseJavaMo
         }
     }
 
+    /**
+     * Composite API: Register Remote Signing + Send Confirmation Document
+     * Align với SdkeSignImpl.registerAndConfirm: gọi registerRemoteSigning -> parse sessionId -> sendConfirmationDocument
+     */
+    @ReactMethod
+    fun registerAndConfirm(
+        requestJson: String,
+        confirmationDocBase64: String,
+        promise: Promise
+    ) {
+        Log.d(TAG, "▶️ registerAndConfirm() called")
+        try {
+            SdkeSign.registerAndConfirm(
+                requestJson = requestJson,
+                confirmationDocBase64 = confirmationDocBase64,
+                callbackSuccess = { rawResponse ->
+                    Log.d(TAG, "✅ registerAndConfirm() success")
+                    val (eventMap, promiseMap) = createSeparateMaps { map ->
+                        map.putString("response", rawResponse)
+                    }
+                    sendEvent("onESignRegisterAndConfirmSuccess", eventMap)
+                    promise.resolve(promiseMap)
+                },
+                callbackError = { event, error ->
+                    val errorMessage = error.message ?: ""
+                    val errorCode = error.code.toString()
+                    Log.e(TAG, "❌ registerAndConfirm() failed - Event: $event, Message: $errorMessage")
+                    val errorMap = Arguments.createMap().apply {
+                        putString("event", event.name.toString())
+                        putString("message", errorMessage)
+                        putString("code", errorCode)
+                    }
+                    sendEvent("onESignError", errorMap)
+                    promise.reject(event.name.toString(), errorMessage)
+                }
+            )
+        } catch (e: Exception) {
+            Log.e(TAG, "❌ registerAndConfirm() exception: ${e.message}", e)
+            promise.reject("ESIGN_EXCEPTION", e.message, e)
+        }
+    }
+
     @ReactMethod
     fun signPdf(
         requestJson: String,
@@ -1514,25 +1647,13 @@ class EKYCModule(reactContext: ReactApplicationContext) : ReactContextBaseJavaMo
                 callbackError = { event, error ->
                     val errorMessage = error.message ?: ""
                     val errorCode = error.code.toString()
-                    
-                    // Check if message contains "thành công" or code == "0" -> treat as success
-                    if (errorMessage.contains("thành công", ignoreCase = true) || errorCode == "0") {
-                        Log.d(TAG, "✅ sendConfirmationDocument() success (async operation) - Message: $errorMessage")
-                        val (eventMap, promiseMap) = createSeparateMaps { map ->
-                            map.putString("response", "{\"status\":1,\"msg\":\"$errorMessage\"}")
-                            map.putString("message", errorMessage)
-                        }
-                        sendEvent("onESignSendConfirmationDocumentSuccess", eventMap)
-                        promise.resolve(promiseMap)
-                    } else {
-                        val errorMap = Arguments.createMap().apply {
-                            putString("event", event.name.toString())
-                            putString("message", errorMessage)
-                            putString("code", errorCode)
-                        }
-                        sendEvent("onESignError", errorMap)
-                        promise.reject(event.name.toString(), errorMessage)
+                    val errorMap = Arguments.createMap().apply {
+                        putString("event", event.name.toString())
+                        putString("message", errorMessage)
+                        putString("code", errorCode)
                     }
+                    sendEvent("onESignError", errorMap)
+                    promise.reject(event.name.toString(), errorMessage)
                 }
             )
         } catch (e: Exception) {

package/dist/EKYCModule.d.ts

@@ -1,6 +1,6 @@
 import { EmitterSubscription } from 'react-native';
 import { NfcConfig, NfcError } from './src/types/ekycNFCType';
-import { SDKEkycResultWithEvent, SDKEkycResultStringWithEvent } from './src/types/ekycType';
+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';
@@ -82,6 +82,13 @@ declare class SDKeKYC {
     sendConfirmationDocument(requestJson: string): Promise<{
         response: string;
     }>;
+    /**
+     * Composite API: Register Remote Signing + Send Confirmation Document
+     * Align với SdkeSignImpl.registerAndConfirm
+     */
+    registerAndConfirm(requestJson: string, confirmationDocBase64: string): Promise<{
+        response: string;
+    }>;
     onESignInitSuccess(callback: (data: ESignInitResult) => void): EmitterSubscription | null;
     onESignOpenSessionSuccess(callback: (data: ESignOpenSessionResult) => void): EmitterSubscription | null;
     onESignRegisterDeviceSuccess(callback: (data: {
@@ -111,7 +118,15 @@ declare class SDKeKYC {
     onESignSendConfirmationDocumentSuccess(callback: (data: {
         response: string;
     }) => void): EmitterSubscription | null;
+    onESignRegisterAndConfirmSuccess(callback: (data: {
+        response: string;
+    }) => void): EmitterSubscription | null;
     onESignError(callback: (error: ESignError) => void): EmitterSubscription | null;
+    /**
+     * Start eKYC UI flow. On success, result contains the same data as Android:
+     * data.ekycStateModel.eKYCFileModel.imageFace → result.imageFace (base64),
+     * result.imageFacePath (file path), result.imageOcrFront / imageOcrBack, result.transactionId.
+     */
     startEkycUI(appKey: string, flowSDK: string[], language: string, transactionId: string, appKeyConfig: {
         appKey: string;
         appKeyNfc: string;
@@ -159,7 +174,7 @@ declare class SDKeKYC {
             textFont?: string;
             textColor?: number;
         };
-    }): Promise<any>;
+    }): Promise<StartEkycUIResult>;
 }
 declare const sdkEKYC: SDKeKYC;
 export { SDKeKYC };

package/dist/EKYCModule.js

@@ -700,6 +700,21 @@ class SDKeKYC {
             throw error;
         }
     }
+    /**
+     * Composite API: Register Remote Signing + Send Confirmation Document
+     * Align với SdkeSignImpl.registerAndConfirm
+     */
+    async registerAndConfirm(requestJson, confirmationDocBase64) {
+        const nativeModule = this.ensureNativeModule();
+        try {
+            const result = await nativeModule.registerAndConfirm(requestJson, confirmationDocBase64);
+            return result;
+        }
+        catch (error) {
+            console.error('eSign Register And Confirm Error:', error);
+            throw error;
+        }
+    }
     // eSign Event Listeners
     onESignInitSuccess(callback) {
         try {
@@ -861,6 +876,22 @@ class SDKeKYC {
             return null;
         }
     }
+    onESignRegisterAndConfirmSuccess(callback) {
+        try {
+            const emitter = this.ensureEventEmitter();
+            if (!emitter) {
+                console.error('❌ Event emitter not available for onESignRegisterAndConfirmSuccess');
+                return null;
+            }
+            const listener = emitter.addListener('onESignRegisterAndConfirmSuccess', callback);
+            this.listeners.push(listener);
+            return listener;
+        }
+        catch (error) {
+            console.error('Failed to add onESignRegisterAndConfirmSuccess listener:', error);
+            return null;
+        }
+    }
     onESignError(callback) {
         try {
             const emitter = this.ensureEventEmitter();
@@ -877,7 +908,11 @@ class SDKeKYC {
             return null;
         }
     }
-    // SdkEkycUI method
+    /**
+     * Start eKYC UI flow. On success, result contains the same data as Android:
+     * data.ekycStateModel.eKYCFileModel.imageFace → result.imageFace (base64),
+     * result.imageFacePath (file path), result.imageOcrFront / imageOcrBack, result.transactionId.
+     */
     async startEkycUI(appKey, flowSDK, language, transactionId, appKeyConfig, optionConfig, styleConfig) {
         if (!this.isInitialized) {
             throw new Error('SDK is not initialized. Please call initSdkEkyc() first.');
@@ -892,7 +927,7 @@ class SDKeKYC {
             const appKeyConfigJson = JSON.stringify(appKeyConfig);
             const styleConfigJson = styleConfig ? JSON.stringify(styleConfig) : '{}';
             const nativeModule = this.ensureNativeModule();
-            const result = await nativeModule.startEkycUI(appKey, flowSDKJson, language, transactionId, optionConfigJson, appKeyConfigJson, styleConfigJson);
+            const result = (await nativeModule.startEkycUI(appKey, flowSDKJson, language, transactionId, optionConfigJson, appKeyConfigJson, styleConfigJson));
             console.log('✅ SdkEkycUI started successfully');
             return result;
         }

package/dist/index.d.ts

@@ -5,13 +5,14 @@ export default sdkEKYC;
 export { sdkEKYC, SDKeKYC };
 export { FinosEKYC, FinosEKYCModule };
 export { FinosESign, FinosESignModule };
+export { SDKFlowType, SDK_FLOW_OPTIONS, flowToStrings } from './src/types/ekycFlowType';
 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 { SDKFaceDetectStatus } from './src/types/ekycLivenessType';
+export { SDKFaceDetectStatus, SDK_LIVENESS_ACTIONS, customActionsToStrings } from './src/types/ekycLivenessType';
 export type { FaceServiceConfig } from './src/types/ekycFaceType';
-export type { SDKEkycResultWithEvent, SDKEkycResultStringWithEvent } from './src/types/ekycType';
+export type { SDKEkycResultWithEvent, SDKEkycResultStringWithEvent, StartEkycUIResult } from './src/types/ekycType';
 export type { NfcError } from './src/types/ekycNFCType';
 export type { SDKTransactionResponse } from './src/types/ekycTransactionType';
 export type { SmsOtpConfig, SmsOtpResult, SmsOtpError } from './src/types/ekycSmsOtpType';

package/dist/index.js

@@ -23,7 +23,7 @@ var __importStar = (this && this.__importStar) || function (mod) {
     return result;
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.SDK_NAME = exports.SDK_VERSION = exports.parseNfcResponse = exports.SDKFaceDetectStatus = exports.FinosESignModule = exports.FinosESign = exports.FinosEKYCModule = exports.FinosEKYC = exports.SDKeKYC = exports.sdkEKYC = void 0;
+exports.SDK_NAME = exports.SDK_VERSION = exports.parseNfcResponse = exports.customActionsToStrings = exports.SDK_LIVENESS_ACTIONS = exports.SDKFaceDetectStatus = exports.flowToStrings = exports.SDK_FLOW_OPTIONS = exports.SDKFlowType = exports.FinosESignModule = exports.FinosESign = exports.FinosEKYCModule = exports.FinosEKYC = exports.SDKeKYC = exports.sdkEKYC = void 0;
 const EKYCModule_1 = __importStar(require("./EKYCModule"));
 exports.sdkEKYC = EKYCModule_1.default;
 Object.defineProperty(exports, "SDKeKYC", { enumerable: true, get: function () { return EKYCModule_1.SDKeKYC; } });
@@ -38,8 +38,15 @@ Object.defineProperty(exports, "FinosESignModule", { enumerable: true, get: func
 console.log('✅ SDK modules loaded successfully');
 // Export main SDK instance and class (legacy)
 exports.default = EKYCModule_1.default;
+// Flow type enum – bên sử dụng truyền enum vào startEkycUI(flowSDK: SDKFlowType[])
+var ekycFlowType_1 = require("./src/types/ekycFlowType");
+Object.defineProperty(exports, "SDKFlowType", { enumerable: true, get: function () { return ekycFlowType_1.SDKFlowType; } });
+Object.defineProperty(exports, "SDK_FLOW_OPTIONS", { enumerable: true, get: function () { return ekycFlowType_1.SDK_FLOW_OPTIONS; } });
+Object.defineProperty(exports, "flowToStrings", { enumerable: true, get: function () { return ekycFlowType_1.flowToStrings; } });
 var ekycLivenessType_1 = require("./src/types/ekycLivenessType");
 Object.defineProperty(exports, "SDKFaceDetectStatus", { enumerable: true, get: function () { return ekycLivenessType_1.SDKFaceDetectStatus; } });
+Object.defineProperty(exports, "SDK_LIVENESS_ACTIONS", { enumerable: true, get: function () { return ekycLivenessType_1.SDK_LIVENESS_ACTIONS; } });
+Object.defineProperty(exports, "customActionsToStrings", { enumerable: true, get: function () { return ekycLivenessType_1.customActionsToStrings; } });
 // Export utility functions
 var utils_1 = require("./src/utils/utils");
 Object.defineProperty(exports, "parseNfcResponse", { enumerable: true, get: function () { return utils_1.parseNfcResponse; } });

package/dist/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@finos_sdk/sdk-ekyc",
-    "version": "1.3.2",
+    "version": "1.3.3",
     "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,10 +3,11 @@ import { NfcConfig, NfcError } from '../types/ekycNFCType';
 import { SDKEkycResultWithEvent, SDKEkycResultStringWithEvent } from '../types/ekycType';
 import { C06Config } from '../types/ekycC06Type';
 import { OcrConfig } from '../types/ekycOCRType';
-import { LivenessConfig } from '../types/ekycLivenessType';
+import { LivenessConfig, SDKFaceDetectStatus } from '../types/ekycLivenessType';
 import { FaceServiceConfig } from '../types/ekycFaceType';
 import { SmsOtpConfig, SmsOtpResult, SmsOtpError } from '../types/ekycSmsOtpType';
 import { ESignInitResult, ESignOpenSessionResult, ESignCertificate, ESignSignRequest, ESignError } from '../types/ekycESignType';
+import { SDKFlowType } from '../types/ekycFlowType';
 /**
  * Finos eKYC SDK Module
  *
@@ -72,7 +73,7 @@ export declare class FinosEKYCModule {
      * @param config.isActiveLiveness - Enable active liveness detection (default: false)
      * @param config.autoCapture - Enable auto capture (default: true)
      * @param config.isShowCameraFont - Show camera font (default: true)
-     * @param config.customActions - Custom actions array (LEFT, RIGHT, STRAIGHT). If provided, uses these actions instead of random
+     * @param config.customActions - SDKFaceDetectStatus[] enum (LEFT, RIGHT, SMILE, BLINK, ...). Bên sử dụng truyền enum thay vì string
      * @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)
      */
@@ -282,14 +283,14 @@ export declare class FinosEKYCModule {
     /**
      * Start eKYC UI with flow (like MainActivity.kt)
      * @param appKey Main app key
-     * @param flowSDK Array of SDK types
+     * @param flowSDK Array of SDKFlowType enum (OCR, NFC, LIVENESS) – bên sử dụng truyền enum
      * @param language Language code (vi/en)
      * @param transactionId Transaction ID
      * @param appKeyConfig Optional app key configuration
      * @param optionConfig Optional configuration settings (includes switchFrontCamera for camera control)
      * @param styleConfig Optional style configuration
      */
-    startEkycUI(appKey: string, flowSDK: string[], language: string, transactionId: string, appKeyConfig: {
+    startEkycUI(appKey: string, flowSDK: SDKFlowType[], language: string, transactionId: string, appKeyConfig: {
         appKey: string;
         appKeyNfc: string;
         appKeyOcr: string;
@@ -301,6 +302,13 @@ export declare class FinosEKYCModule {
         countMaxRetry?: number;
         language?: string;
         switchFrontCamera?: boolean;
+        /** LivenessConfig – SDKeKYCActivity (157-169) */
+        isActiveLiveness?: boolean;
+        autoCapture?: boolean;
+        forceCaptureTimeout?: number;
+        /** Bên sử dụng truyền enum – SDKFaceDetectStatus[] thay vì string[] */
+        customActions?: SDKFaceDetectStatus[];
+        activeActionCount?: number;
     }, styleConfig?: {
         textSize?: number;
         textFont?: string;

package/dist/src/modules/FinosEKYCModule.js

@@ -28,6 +28,7 @@ const react_native_1 = require("react-native");
 const EKYCModule_1 = __importStar(require("../../EKYCModule"));
 Object.defineProperty(exports, "SDK_VERSION", { enumerable: true, get: function () { return EKYCModule_1.SDK_VERSION; } });
 Object.defineProperty(exports, "SDK_NAME", { enumerable: true, get: function () { return EKYCModule_1.SDK_NAME; } });
+const ekycFlowType_1 = require("../types/ekycFlowType");
 /**
  * Finos eKYC SDK Module
  *
@@ -184,7 +185,7 @@ class FinosEKYCModule {
      * @param config.isActiveLiveness - Enable active liveness detection (default: false)
      * @param config.autoCapture - Enable auto capture (default: true)
      * @param config.isShowCameraFont - Show camera font (default: true)
-     * @param config.customActions - Custom actions array (LEFT, RIGHT, STRAIGHT). If provided, uses these actions instead of random
+     * @param config.customActions - SDKFaceDetectStatus[] enum (LEFT, RIGHT, SMILE, BLINK, ...). Bên sử dụng truyền enum thay vì string
      * @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)
      */
@@ -631,7 +632,7 @@ class FinosEKYCModule {
     /**
      * Start eKYC UI with flow (like MainActivity.kt)
      * @param appKey Main app key
-     * @param flowSDK Array of SDK types
+     * @param flowSDK Array of SDKFlowType enum (OCR, NFC, LIVENESS) – bên sử dụng truyền enum
      * @param language Language code (vi/en)
      * @param transactionId Transaction ID
      * @param appKeyConfig Optional app key configuration
@@ -648,7 +649,7 @@ class FinosEKYCModule {
             }
             console.log('🔑 AppKeyConfig:', appKeyConfig);
             console.log('🎨 StyleConfig:', styleConfig);
-            const result = await this.sdk.startEkycUI(appKey, flowSDK, language, transactionId, appKeyConfig, optionConfig, styleConfig);
+            const result = await this.sdk.startEkycUI(appKey, (0, ekycFlowType_1.flowToStrings)(flowSDK), language, transactionId, appKeyConfig, optionConfig, styleConfig);
             console.log('✅ eKYC UI started successfully');
             return result;
         }

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

@@ -151,6 +151,15 @@ export declare class FinosESignModule {
     sendConfirmationDocument(requestJson: string): Promise<{
         response: string;
     }>;
+    /**
+     * Composite API: Register Remote Signing + Send Confirmation Document
+     * Align với SdkeSignImpl.registerAndConfirm
+     * @param requestJson JSON request body for registerRemoteSigning
+     * @param confirmationDocBase64 PDF base64 for acceptanceDocs
+     */
+    registerAndConfirm(requestJson: string, confirmationDocBase64: string): Promise<{
+        response: string;
+    }>;
     /**
      * Remove all event listeners
      */
@@ -184,6 +193,9 @@ export declare class FinosESignModule {
     onESignSendConfirmationDocumentSuccess(callback: (data: {
         response: string;
     }) => void): import("react-native").EmitterSubscription | null;
+    onESignRegisterAndConfirmSuccess(callback: (data: {
+        response: string;
+    }) => void): import("react-native").EmitterSubscription | null;
     onESignError(callback: (error: ESignError) => void): import("react-native").EmitterSubscription | null;
     /**
      * Start liveness detection

package/dist/src/modules/FinosESignModule.js

@@ -281,6 +281,16 @@ class FinosESignModule {
         // Pass through to SDK - error handling is done in EKYCModule.ts
         return await this.sdk.sendConfirmationDocument(requestJson);
     }
+    /**
+     * Composite API: Register Remote Signing + Send Confirmation Document
+     * Align với SdkeSignImpl.registerAndConfirm
+     * @param requestJson JSON request body for registerRemoteSigning
+     * @param confirmationDocBase64 PDF base64 for acceptanceDocs
+     */
+    async registerAndConfirm(requestJson, confirmationDocBase64) {
+        this.validateSDKReady();
+        return await this.sdk.registerAndConfirm(requestJson, confirmationDocBase64);
+    }
     /**
      * Remove all event listeners
      */
@@ -359,6 +369,13 @@ class FinosESignModule {
         }
         return listener;
     }
+    onESignRegisterAndConfirmSuccess(callback) {
+        const listener = this.sdk.onESignRegisterAndConfirmSuccess(callback);
+        if (!listener) {
+            console.warn('⚠️ onESignRegisterAndConfirmSuccess: Event emitter not ready.');
+        }
+        return listener;
+    }
     onESignError(callback) {
         const listener = this.sdk.onESignError(callback);
         if (!listener) {
@@ -491,6 +508,7 @@ const isMethod = (prop) => {
         prop === 'listSignRequest' ||
         prop === 'confirmSign' ||
         prop === 'registerRemoteSigning' ||
+        prop === 'registerAndConfirm' ||
         prop === 'signPdf' ||
         prop === 'sendConfirmationDocument' ||
         prop === 'startLiveness' ||
@@ -547,7 +565,7 @@ const createFinosESignStub = () => {
         'onESignInitSuccess', 'onESignOpenSessionSuccess', 'onESignRegisterDeviceSuccess',
         'onESignListCertsSuccess', 'onESignVerifyCertSuccess', 'onESignListSignRequestSuccess',
         'onESignConfirmSignSuccess', 'onESignRegisterRemoteSigningSuccess',
-        'onESignSignPdfSuccess', 'onESignSendConfirmationDocumentSuccess', 'onESignError',
+        'onESignSignPdfSuccess', 'onESignSendConfirmationDocumentSuccess', 'onESignRegisterAndConfirmSuccess', 'onESignError',
         'onLivenessSuccess', 'onLivenessError', 'onFaceCompareSuccess', 'onFaceCompareError'
     ];
     eventListenerMethods.forEach(method => {
@@ -561,7 +579,7 @@ const createFinosESignStub = () => {
         'initialize', 'startNfcScan', 'checkC06', 'startOcr', 'startLiveness', 'startFaceCompare',
         'startEkycUI', 'sendOtp', 'verifyOtp', 'resendOtp', 'initializeESign', 'getSdkToken', 'openSessionId',
         'registerDevice', 'listCerts', 'verifyCert', 'listSignRequest', 'confirmSign',
-        'registerRemoteSigning', 'signPdf', 'sendConfirmationDocument',
+        'registerRemoteSigning', 'registerAndConfirm', 'signPdf', 'sendConfirmationDocument',
         'onResume', 'onPause', 'isSDKReady', 'getSDKInfo'
     ];
     otherMethods.forEach(method => {

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

@@ -0,0 +1,17 @@
+/**
+ * Các bước trong flow eKYC – map với Android SDKType (OCR, NFC, LIVENESS).
+ * Bên sử dụng truyền enum vào SDK thay vì string.
+ *
+ * @example
+ * import { FinosEKYC, SDKFlowType } from '@finos_sdk/sdk-ekyc';
+ * await FinosEKYC.startEkycUI(appKey, [SDKFlowType.OCR, SDKFlowType.NFC, SDKFlowType.LIVENESS], ...);
+ */
+export declare enum SDKFlowType {
+    OCR = "OCR",
+    NFC = "NFC",
+    LIVENESS = "LIVENESS"
+}
+/** Mảng đầy đủ các bước (dùng cho picker / default flow). */
+export declare const SDK_FLOW_OPTIONS: readonly SDKFlowType[];
+/** Chuyển flow enum[] sang string[] khi gửi xuống native (giá trị enum đã là 'OCR'|'NFC'|'LIVENESS'). */
+export declare function flowToStrings(flow: SDKFlowType[]): string[];

package/dist/src/types/ekycFlowType.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.flowToStrings = exports.SDK_FLOW_OPTIONS = exports.SDKFlowType = void 0;
+/**
+ * Các bước trong flow eKYC – map với Android SDKType (OCR, NFC, LIVENESS).
+ * Bên sử dụng truyền enum vào SDK thay vì string.
+ *
+ * @example
+ * import { FinosEKYC, SDKFlowType } from '@finos_sdk/sdk-ekyc';
+ * await FinosEKYC.startEkycUI(appKey, [SDKFlowType.OCR, SDKFlowType.NFC, SDKFlowType.LIVENESS], ...);
+ */
+var SDKFlowType;
+(function (SDKFlowType) {
+    SDKFlowType["OCR"] = "OCR";
+    SDKFlowType["NFC"] = "NFC";
+    SDKFlowType["LIVENESS"] = "LIVENESS";
+})(SDKFlowType = exports.SDKFlowType || (exports.SDKFlowType = {}));
+/** Mảng đầy đủ các bước (dùng cho picker / default flow). */
+exports.SDK_FLOW_OPTIONS = [
+    SDKFlowType.OCR,
+    SDKFlowType.NFC,
+    SDKFlowType.LIVENESS,
+];
+/** Chuyển flow enum[] sang string[] khi gửi xuống native (giá trị enum đã là 'OCR'|'NFC'|'LIVENESS'). */
+function flowToStrings(flow) {
+    return flow.map(f => f);
+}
+exports.flowToStrings = flowToStrings;

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

@@ -1,9 +1,25 @@
 import { CheckSummaryResponse } from "./ekycOCRType";
+/**
+ * Custom actions cho liveness – map Android SDKFaceDetectStatus.
+ * Bên sử dụng truyền enum vào optionConfig.customActions thay vì string.
+ */
 export declare enum SDKFaceDetectStatus {
     LEFT = "LEFT",
     RIGHT = "RIGHT",
+    UP = "UP",
+    DOWN = "DOWN",
+    SMILE = "SMILE",
+    BLINK = "BLINK",
+    TILT_LEFT = "TILT_LEFT",
+    TILT_RIGHT = "TILT_RIGHT",
+    WINK_LEFT = "WINK_LEFT",
+    WINK_RIGHT = "WINK_RIGHT",
     STRAIGHT = "STRAIGHT"
 }
+/** Mảng đầy đủ các action (trừ STRAIGHT thường được SDK tự thêm cuối) – dùng cho picker / default. */
+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[];
 export interface LivenessConfig {
     appKey: string;
     transactionId?: string;

package/dist/src/types/ekycLivenessType.js

@@ -1,9 +1,40 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.SDKFaceDetectStatus = void 0;
+exports.customActionsToStrings = exports.SDK_LIVENESS_ACTIONS = exports.SDKFaceDetectStatus = void 0;
+/**
+ * Custom actions cho liveness – map Android SDKFaceDetectStatus.
+ * Bên sử dụng truyền enum vào optionConfig.customActions thay vì string.
+ */
 var SDKFaceDetectStatus;
 (function (SDKFaceDetectStatus) {
     SDKFaceDetectStatus["LEFT"] = "LEFT";
     SDKFaceDetectStatus["RIGHT"] = "RIGHT";
+    SDKFaceDetectStatus["UP"] = "UP";
+    SDKFaceDetectStatus["DOWN"] = "DOWN";
+    SDKFaceDetectStatus["SMILE"] = "SMILE";
+    SDKFaceDetectStatus["BLINK"] = "BLINK";
+    SDKFaceDetectStatus["TILT_LEFT"] = "TILT_LEFT";
+    SDKFaceDetectStatus["TILT_RIGHT"] = "TILT_RIGHT";
+    SDKFaceDetectStatus["WINK_LEFT"] = "WINK_LEFT";
+    SDKFaceDetectStatus["WINK_RIGHT"] = "WINK_RIGHT";
     SDKFaceDetectStatus["STRAIGHT"] = "STRAIGHT";
 })(SDKFaceDetectStatus = exports.SDKFaceDetectStatus || (exports.SDKFaceDetectStatus = {}));
+/** Mảng đầy đủ các action (trừ STRAIGHT thường được SDK tự thêm cuối) – dùng cho picker / default. */
+exports.SDK_LIVENESS_ACTIONS = [
+    SDKFaceDetectStatus.LEFT,
+    SDKFaceDetectStatus.RIGHT,
+    SDKFaceDetectStatus.UP,
+    SDKFaceDetectStatus.DOWN,
+    SDKFaceDetectStatus.SMILE,
+    SDKFaceDetectStatus.BLINK,
+    SDKFaceDetectStatus.TILT_LEFT,
+    SDKFaceDetectStatus.TILT_RIGHT,
+    SDKFaceDetectStatus.WINK_LEFT,
+    SDKFaceDetectStatus.WINK_RIGHT,
+    SDKFaceDetectStatus.STRAIGHT,
+];
+/** Chuyển customActions enum[] sang string[] khi gửi xuống native. */
+function customActionsToStrings(actions) {
+    return actions.map(a => a);
+}
+exports.customActionsToStrings = customActionsToStrings;

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

@@ -20,3 +20,33 @@ export interface SDKEkycResultStringWithEvent {
     data: string;
     event: string;
 }
+/**
+ * Result from startEkycUI() – maps Android SDK data.ekycStateModel.eKYCFileModel.
+ * Use the same shape as Android: data?.ekycStateModel?.eKYCFileModel?.imageFace.
+ *
+ * @example
+ * const result = await sdkEKYC.startEkycUI(...);
+ * const selfieBase64 = result?.imageFace;      // base64 selfie (liveness/face)
+ * const frontBase64 = result?.imageOcrFront;   // base64 CCCD/CMND mặt trước
+ * const backBase64 = result?.imageOcrBack;     // base64 CCCD/CMND mặt sau
+ * const selfiePath = result?.imageFacePath;    // file path (e.g. for FormData)
+ * const transactionId = result?.transactionId;
+ */
+export interface StartEkycUIResult {
+    status: 'success';
+    event: string;
+    data?: string;
+    transactionId?: string;
+    /** Base64 selfie (liveness) – same as Android data.ekycStateModel.eKYCFileModel.imageFace */
+    imageFace?: string;
+    /** Base64 OCR front – same as Android eKYCFileModel.imageOcrFront */
+    imageOcrFront?: string;
+    /** Base64 OCR back – same as Android eKYCFileModel.imageOcrBack */
+    imageOcrBack?: string;
+    /** Absolute path to selfie file (e.g. for react-native-fs / FormData) */
+    imageFacePath?: string;
+    /** Absolute path to OCR front image file */
+    imageOcrFrontPath?: string;
+    /** Absolute path to OCR back image file */
+    imageOcrBackPath?: string;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@finos_sdk/sdk-ekyc",
-  "version": "1.3.2",
+  "version": "1.3.3",
   "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,10 +4,11 @@ import { NfcConfig, NfcError } from '../types/ekycNFCType';
 import { SDKEkycResultWithEvent, SDKEkycResultStringWithEvent } from '../types/ekycType';
 import { C06Config } from '../types/ekycC06Type';
 import { OcrConfig } from '../types/ekycOCRType';
-import { LivenessConfig } from '../types/ekycLivenessType';
+import { LivenessConfig, SDKFaceDetectStatus } from '../types/ekycLivenessType';
 import { FaceServiceConfig } from '../types/ekycFaceType';
 import { SmsOtpConfig, SmsOtpResult, SmsOtpError } from '../types/ekycSmsOtpType';
 import { ESignInitResult, ESignOpenSessionResult, ESignCertificate, ESignSignRequest, ESignError, ESignAuthenticateResult } from '../types/ekycESignType';
+import { SDKFlowType, flowToStrings } from '../types/ekycFlowType';
 
 /**
  * Finos eKYC SDK Module
@@ -189,7 +190,7 @@ export class FinosEKYCModule {
      * @param config.isActiveLiveness - Enable active liveness detection (default: false)
      * @param config.autoCapture - Enable auto capture (default: true)
      * @param config.isShowCameraFont - Show camera font (default: true)
-     * @param config.customActions - Custom actions array (LEFT, RIGHT, STRAIGHT). If provided, uses these actions instead of random
+     * @param config.customActions - SDKFaceDetectStatus[] enum (LEFT, RIGHT, SMILE, BLINK, ...). Bên sử dụng truyền enum thay vì string
      * @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)
      */
@@ -721,7 +722,7 @@ export class FinosEKYCModule {
     /**
      * Start eKYC UI with flow (like MainActivity.kt)
      * @param appKey Main app key
-     * @param flowSDK Array of SDK types
+     * @param flowSDK Array of SDKFlowType enum (OCR, NFC, LIVENESS) – bên sử dụng truyền enum
      * @param language Language code (vi/en)
      * @param transactionId Transaction ID
      * @param appKeyConfig Optional app key configuration
@@ -730,7 +731,7 @@ export class FinosEKYCModule {
      */
     public async startEkycUI(
         appKey: string,
-        flowSDK: string[],
+        flowSDK: SDKFlowType[],
         language: string,
         transactionId: string,
         appKeyConfig: {
@@ -746,6 +747,13 @@ export class FinosEKYCModule {
             countMaxRetry?: number;
             language?: string;
             switchFrontCamera?: boolean;
+            /** LivenessConfig – SDKeKYCActivity (157-169) */
+            isActiveLiveness?: boolean;
+            autoCapture?: boolean;
+            forceCaptureTimeout?: number; // seconds, native uses ms
+            /** Bên sử dụng truyền enum – SDKFaceDetectStatus[] thay vì string[] */
+            customActions?: SDKFaceDetectStatus[];
+            activeActionCount?: number;
         },
         styleConfig?: {
             textSize?: number;
@@ -798,7 +806,7 @@ export class FinosEKYCModule {
 
             const result = await this.sdk.startEkycUI(
                 appKey,
-                flowSDK,
+                flowToStrings(flowSDK),
                 language,
                 transactionId,
                 appKeyConfig,

package/src/modules/FinosESignModule.ts

@@ -333,6 +333,20 @@ export class FinosESignModule {
         return await this.sdk.sendConfirmationDocument(requestJson);
     }
 
+    /**
+     * Composite API: Register Remote Signing + Send Confirmation Document
+     * Align với SdkeSignImpl.registerAndConfirm
+     * @param requestJson JSON request body for registerRemoteSigning
+     * @param confirmationDocBase64 PDF base64 for acceptanceDocs
+     */
+    public async registerAndConfirm(
+        requestJson: string,
+        confirmationDocBase64: string
+    ): Promise<{ response: string }> {
+        this.validateSDKReady();
+        return await this.sdk.registerAndConfirm(requestJson, confirmationDocBase64);
+    }
+
     /**
      * Remove all event listeners
      */
@@ -424,6 +438,14 @@ export class FinosESignModule {
         return listener;
     }
 
+    public onESignRegisterAndConfirmSuccess(callback: (data: { response: string }) => void) {
+        const listener = this.sdk.onESignRegisterAndConfirmSuccess(callback);
+        if (!listener) {
+            console.warn('⚠️ onESignRegisterAndConfirmSuccess: Event emitter not ready.');
+        }
+        return listener;
+    }
+
     public onESignError(callback: (error: ESignError) => void) {
         const listener = this.sdk.onESignError(callback);
         if (!listener) {
@@ -633,6 +655,7 @@ const isMethod = (prop: string | symbol): boolean => {
         prop === 'listSignRequest' ||
         prop === 'confirmSign' ||
         prop === 'registerRemoteSigning' ||
+        prop === 'registerAndConfirm' ||
         prop === 'signPdf' ||
         prop === 'sendConfirmationDocument' ||
         prop === 'startLiveness' ||
@@ -689,8 +712,8 @@ const createFinosESignStub = (): FinosESignModule => {
         'onSmsOtpSendSuccess', 'onSmsOtpVerifySuccess', 'onSmsOtpResendSuccess', 'onSmsOtpError',
         'onESignInitSuccess', 'onESignOpenSessionSuccess', 'onESignRegisterDeviceSuccess',
         'onESignListCertsSuccess', 'onESignVerifyCertSuccess', 'onESignListSignRequestSuccess',
-        'onESignConfirmSignSuccess', 'onESignRegisterRemoteSigningSuccess',
-        'onESignSignPdfSuccess', 'onESignSendConfirmationDocumentSuccess', 'onESignError',
+        'onESignConfirmSignSuccess',         'onESignRegisterRemoteSigningSuccess',
+        'onESignSignPdfSuccess', 'onESignSendConfirmationDocumentSuccess', 'onESignRegisterAndConfirmSuccess', 'onESignError',
         'onLivenessSuccess', 'onLivenessError', 'onFaceCompareSuccess', 'onFaceCompareError'
     ];
 
@@ -706,7 +729,7 @@ const createFinosESignStub = (): FinosESignModule => {
         'initialize', 'startNfcScan', 'checkC06', 'startOcr', 'startLiveness', 'startFaceCompare',
         'startEkycUI', 'sendOtp', 'verifyOtp', 'resendOtp', 'initializeESign', 'getSdkToken', 'openSessionId',
         'registerDevice', 'listCerts', 'verifyCert', 'listSignRequest', 'confirmSign',
-        'registerRemoteSigning', 'signPdf', 'sendConfirmationDocument',
+        'registerRemoteSigning', 'registerAndConfirm', 'signPdf', 'sendConfirmationDocument',
         'onResume', 'onPause', 'isSDKReady', 'getSDKInfo'
     ];
 

package/src/types/ekycFlowType.ts

@@ -0,0 +1,25 @@
+/**
+ * Các bước trong flow eKYC – map với Android SDKType (OCR, NFC, LIVENESS).
+ * Bên sử dụng truyền enum vào SDK thay vì string.
+ *
+ * @example
+ * import { FinosEKYC, SDKFlowType } from '@finos_sdk/sdk-ekyc';
+ * await FinosEKYC.startEkycUI(appKey, [SDKFlowType.OCR, SDKFlowType.NFC, SDKFlowType.LIVENESS], ...);
+ */
+export enum SDKFlowType {
+  OCR = 'OCR',
+  NFC = 'NFC',
+  LIVENESS = 'LIVENESS',
+}
+
+/** Mảng đầy đủ các bước (dùng cho picker / default flow). */
+export const SDK_FLOW_OPTIONS: readonly SDKFlowType[] = [
+  SDKFlowType.OCR,
+  SDKFlowType.NFC,
+  SDKFlowType.LIVENESS,
+] as const;
+
+/** Chuyển flow enum[] sang string[] khi gửi xuống native (giá trị enum đã là 'OCR'|'NFC'|'LIVENESS'). */
+export function flowToStrings(flow: SDKFlowType[]): string[] {
+  return flow.map(f => f as string);
+}

package/src/types/ekycLivenessType.ts

@@ -1,9 +1,41 @@
 import { CheckSummaryResponse } from "./ekycOCRType";
 
+/**
+ * Custom actions cho liveness – map Android SDKFaceDetectStatus.
+ * Bên sử dụng truyền enum vào optionConfig.customActions thay vì string.
+ */
 export enum SDKFaceDetectStatus {
     LEFT = "LEFT",
     RIGHT = "RIGHT",
-    STRAIGHT = "STRAIGHT"
+    UP = "UP",
+    DOWN = "DOWN",
+    SMILE = "SMILE",
+    BLINK = "BLINK",
+    TILT_LEFT = "TILT_LEFT",
+    TILT_RIGHT = "TILT_RIGHT",
+    WINK_LEFT = "WINK_LEFT",
+    WINK_RIGHT = "WINK_RIGHT",
+    STRAIGHT = "STRAIGHT",
+}
+
+/** Mảng đầy đủ các action (trừ STRAIGHT thường được SDK tự thêm cuối) – dùng cho picker / default. */
+export const SDK_LIVENESS_ACTIONS: readonly SDKFaceDetectStatus[] = [
+    SDKFaceDetectStatus.LEFT,
+    SDKFaceDetectStatus.RIGHT,
+    SDKFaceDetectStatus.UP,
+    SDKFaceDetectStatus.DOWN,
+    SDKFaceDetectStatus.SMILE,
+    SDKFaceDetectStatus.BLINK,
+    SDKFaceDetectStatus.TILT_LEFT,
+    SDKFaceDetectStatus.TILT_RIGHT,
+    SDKFaceDetectStatus.WINK_LEFT,
+    SDKFaceDetectStatus.WINK_RIGHT,
+    SDKFaceDetectStatus.STRAIGHT,
+] as const;
+
+/** Chuyển customActions enum[] sang string[] khi gửi xuống native. */
+export function customActionsToStrings(actions: SDKFaceDetectStatus[]): string[] {
+    return actions.map(a => a as string);
 }
 
 export interface LivenessConfig {

package/src/types/ekycType.ts

@@ -22,4 +22,35 @@ export interface SDKEkycResultWithEvent {
 export interface SDKEkycResultStringWithEvent {
     data: string;
     event: string;
+}
+
+/**
+ * Result from startEkycUI() – maps Android SDK data.ekycStateModel.eKYCFileModel.
+ * Use the same shape as Android: data?.ekycStateModel?.eKYCFileModel?.imageFace.
+ *
+ * @example
+ * const result = await sdkEKYC.startEkycUI(...);
+ * const selfieBase64 = result?.imageFace;      // base64 selfie (liveness/face)
+ * const frontBase64 = result?.imageOcrFront;   // base64 CCCD/CMND mặt trước
+ * const backBase64 = result?.imageOcrBack;     // base64 CCCD/CMND mặt sau
+ * const selfiePath = result?.imageFacePath;    // file path (e.g. for FormData)
+ * const transactionId = result?.transactionId;
+ */
+export interface StartEkycUIResult {
+    status: 'success';
+    event: string;
+    data?: string;
+    transactionId?: string;
+    /** Base64 selfie (liveness) – same as Android data.ekycStateModel.eKYCFileModel.imageFace */
+    imageFace?: string;
+    /** Base64 OCR front – same as Android eKYCFileModel.imageOcrFront */
+    imageOcrFront?: string;
+    /** Base64 OCR back – same as Android eKYCFileModel.imageOcrBack */
+    imageOcrBack?: string;
+    /** Absolute path to selfie file (e.g. for react-native-fs / FormData) */
+    imageFacePath?: string;
+    /** Absolute path to OCR front image file */
+    imageOcrFrontPath?: string;
+    /** Absolute path to OCR back image file */
+    imageOcrBackPath?: string;
 }