@finos_sdk/sdk-ekyc 1.4.4 → 1.4.5

package/android/build.gradle

@@ -65,7 +65,7 @@ dependencies {
     implementation 'com.facebook.react:react-android'
 
     // Finos eKYC SDK dependencies from GitHub Packages Maven repository
-    def sdkVersion = "1.4.4"
+    def sdkVersion = "1.4.5.2"
     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

@@ -2,6 +2,7 @@ package finos.sdk.ekyc
 
 import android.R
 import android.net.Uri
+import com.google.gson.Gson
 import android.os.Handler
 import android.os.Looper
 import android.util.Base64
@@ -108,6 +109,7 @@ class EKYCModule(reactContext: ReactApplicationContext) : ReactContextBaseJavaMo
         Arguments.createMap().apply {
             putInt("status", result.status)
             putString("msg", result.msg)
+            result.errorCode?.let { putString("errorCode", it) }
             result.data?.let { d ->
                 putMap("data", Arguments.createMap().apply {
                     d.sessionId?.let { putString("sessionId", it) }
@@ -130,6 +132,7 @@ class EKYCModule(reactContext: ReactApplicationContext) : ReactContextBaseJavaMo
         Arguments.createMap().apply {
             putInt("status", result.status)
             putString("msg", result.msg)
+            result.errorCode?.let { putString("errorCode", it) }
             result.data?.let { d ->
                 putMap("data", Arguments.createMap().apply {
                     putString("transactionId", d.transactionId)
@@ -483,6 +486,17 @@ 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())
@@ -556,6 +570,17 @@ 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())
@@ -782,6 +807,17 @@ 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}")
                     val result = data as? SDKEkycResult
                     val hasRealData = result?.ekycStateModel != null

package/dist/EKYCModule.d.ts

@@ -44,6 +44,8 @@ declare class SDKeKYC {
     onLivenessError(callback: (error: any) => void): EmitterSubscription | null;
     onFaceCompareSuccess(callback: (data: SDKEkycResultWithEvent) => void): EmitterSubscription | null;
     onFaceCompareError(callback: (error: any) => void): EmitterSubscription | null;
+    onEkycUISuccess(callback: (data: any) => void): EmitterSubscription | null;
+    onEkycUIError(callback: (error: any) => void): EmitterSubscription | null;
     removeAllListeners(): void;
     sendOtp(config: SmsOtpConfig): Promise<SmsOtpResult>;
     verifyOtp(config: SmsOtpConfig, otpCode: string): Promise<SmsOtpResult>;

package/dist/EKYCModule.js

@@ -420,6 +420,38 @@ class SDKeKYC {
             return null;
         }
     }
+    onEkycUISuccess(callback) {
+        try {
+            const emitter = this.ensureEventEmitter();
+            if (!emitter) {
+                console.error('❌ Event emitter not available for onEkycUISuccess');
+                return null;
+            }
+            const listener = emitter.addListener('onEkycUISuccess', callback);
+            this.listeners.push(listener);
+            return listener;
+        }
+        catch (error) {
+            console.error('Failed to add onEkycUISuccess listener:', error);
+            return null;
+        }
+    }
+    onEkycUIError(callback) {
+        try {
+            const emitter = this.ensureEventEmitter();
+            if (!emitter) {
+                console.error('❌ Event emitter not available for onEkycUIError');
+                return null;
+            }
+            const listener = emitter.addListener('onEkycUIError', callback);
+            this.listeners.push(listener);
+            return listener;
+        }
+        catch (error) {
+            console.error('Failed to add onEkycUIError listener:', error);
+            return null;
+        }
+    }
     removeAllListeners() {
         this.listeners.forEach(listener => listener.remove());
         this.listeners = [];

package/dist/index.d.ts

@@ -12,6 +12,7 @@ export type { OcrConfig } from './src/types/ekycOCRType';
 export type { LivenessConfig } from './src/types/ekycLivenessType';
 export { SDKFaceDetectStatus, SDK_LIVENESS_ACTIONS, customActionsToStrings } from './src/types/ekycLivenessType';
 export type { FaceServiceConfig } 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';
 export type { NfcError } from './src/types/ekycNFCType';

package/dist/index.js

@@ -33,9 +33,9 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.OCR_FAKE_PORTRAIT_DETECTED_CMND = exports.OCR_FAKE_CHARACTERS_DETECTED_CMND = exports.OCR_USE_NEW_ID_DOCUMENT_2 = exports.OCR_USE_NEW_ID_DOCUMENT_1 = exports.OCR_FAKE_MRZ = exports.OCR_INVALID_GENDER_CODE = exports.OCR_INVALID_ID_CARD = exports.OCR_GLARE_ID_CARD = exports.OCR_BLURRY_ID_CARD = exports.OCR_CUT_CORNER_ID_CARD = exports.OCR_CANNOT_RECOGNIZE_PORTRAIT = exports.OCR_ID_CARD_FROM_OTHER_DEVICE = exports.OCR_NOT_ORIGINAL_ID_CARD = exports.OCR_MISSING_ID_CARD_PART = exports.OCR_CANNOT_GET_ISSUE_PLACE = exports.OCR_CANNOT_GET_GENDER = exports.OCR_CANNOT_GET_HOMETOWN = exports.OCR_CANNOT_GET_RESIDENCE = exports.OCR_CANNOT_GET_ISSUE_DATE = exports.OCR_CANNOT_GET_EXPIRY_DATE = exports.OCR_CANNOT_GET_BIRTH_YEAR = exports.OCR_CANNOT_GET_NAME = exports.OCR_CANNOT_GET_ID_NUMBER = exports.OCR_WRONG_ID_CARD_SIDE = exports.OCR_UNRECOGNIZED_ID_CARD = exports.SDK_MISS_KEY = exports.ERROR_UNKNOWN = exports.SDK_START_ERROR = exports.SDK_START_FLOW_ERROR = exports.getMessage = exports.getErrorResultFromDetails = exports.createCustom = exports.fromCode = exports.getLocalizedMessage = exports.parseNfcResponse = exports.AuthorizationStatus = exports.AppIDType = exports.getEkycError = 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;
-exports.ESIGN_INVALID_RECOVERY_OR_PIN = exports.ESIGN_SESSION_INVALID_REGISTER = exports.ESIGN_INVALID_USER_ACCOUNT = exports.ESIGN_APP_LIMITED = exports.ESIGN_DEVICE_NOT_INIT = exports.ESIGN_INVALID_LICENSE_CONTENT = exports.ESIGN_INVALID_LICENSE = exports.ESIGN_DEVICE_ALREADY_INIT = exports.ESIGN_SESSION_INVALID = exports.FETCH_HISTORY_ERROR = exports.QRCODE_ERROR = exports.SMS_OTP_RATE_LIMIT = exports.SMS_OTP_NOT_FOUND = exports.SMS_OTP_MAX_ATTEMPTS = exports.SMS_OTP_INVALID_PHONE = exports.SMS_OTP_ERROR = exports.NFC_CHIP_AUTH_FAILED = exports.NFC_USER_CANCEL = exports.NFC_UNKNOWN_ERROR = exports.NFC_IO_ERROR = exports.NFC_INVALID_MRZ_KEY = exports.NFC_CONNECTION_LOST = exports.NFC_MUTUAL_AUTH_FAILED = exports.C06_ERROR = exports.SCAN_NFC_ENABLE = exports.SCAN_NFC_CHECK = exports.SCAN_NFC_ERROR = exports.HEAD_IS_TURNED_IN_SELFIE = exports.NUDITY_DETECTED_IN_SELFIE = exports.READING_GLASSES_DETECTED_IN_SELFIE = exports.EYEWEAR_DETECTED_IN_SELFIE = exports.FACE_OCCLUDED_IN_SELFIE = exports.FACE_IS_BLURRED = exports.MASK_PRESENT_IN_SELFIE = exports.EYES_CLOSED_IN_SELFIE = exports.MULTIPLE_FACES_IN_SELFIE = exports.LIVENESS_FAIL = exports.LIVENESS_ERROR = exports.FACE_ERROR = exports.FACE_HAT_ERROR = exports.OCR_ERROR = exports.OCR_FONT_BACK_NOT_MATCH = exports.OCR_PHOTOCOPY_ID_CARD = exports.OCR_FAKE_PORTRAIT_DETECTED = exports.OCR_FAKE_CHARACTERS_DETECTED_2 = exports.OCR_FAKE_CHARACTERS_DETECTED_1 = exports.OCR_UNKNOWN_ID_NUMBER_LENGTH = exports.OCR_MODIFIED_BIRTH_DATE_DETECTED_CMND = exports.OCR_MODIFIED_SYMBOL_DETECTED_CMND = exports.OCR_FAKE_BIRTH_DATE_DETECTED_CMND = void 0;
-exports.SDK_NAME = exports.SDK_VERSION = exports.USER_CANCEL = exports.ESIGN_INVALID_PIN_CODE = exports.ESIGN_INVALID_RECOVERY_CODE = exports.ESIGN_INVALID_LICENSE_CODE = exports.ESIGN_INVALID_CONTEXT = exports.ESIGN_MISSING_REQUEST_ID = exports.ESIGN_MISSING_SERIAL = exports.ESIGN_MISSING_IDENTITY = exports.ESIGN_MISSING_ACCESS_TOKEN = exports.ESIGN_NO_SESSION_ID = exports.ESIGN_MISSING_CONFIRMATION_DOC = exports.ESIGN_MISSING_REQUEST_JSON = exports.ESIGN_MISSING_CCCD = exports.ESIGN_MISSING_TOKEN = exports.ESIGN_ERROR_UNKNOWN = exports.ESIGN_AUTH_REQUEST_EXISTS = exports.ESIGN_INVALID_CERT_FOR_AUTH = exports.ESIGN_INVALID_SIGN_COUNT_OR_TIME = exports.ESIGN_AUTH_EXISTS = exports.ESIGN_SESSION_INVALID_LIST_CERT = void 0;
+exports.OCR_USE_NEW_ID_DOCUMENT_2 = exports.OCR_USE_NEW_ID_DOCUMENT_1 = exports.OCR_FAKE_MRZ = exports.OCR_INVALID_GENDER_CODE = exports.OCR_INVALID_ID_CARD = exports.OCR_GLARE_ID_CARD = exports.OCR_BLURRY_ID_CARD = exports.OCR_CUT_CORNER_ID_CARD = exports.OCR_CANNOT_RECOGNIZE_PORTRAIT = exports.OCR_ID_CARD_FROM_OTHER_DEVICE = exports.OCR_NOT_ORIGINAL_ID_CARD = exports.OCR_MISSING_ID_CARD_PART = exports.OCR_CANNOT_GET_ISSUE_PLACE = exports.OCR_CANNOT_GET_GENDER = exports.OCR_CANNOT_GET_HOMETOWN = exports.OCR_CANNOT_GET_RESIDENCE = exports.OCR_CANNOT_GET_ISSUE_DATE = exports.OCR_CANNOT_GET_EXPIRY_DATE = exports.OCR_CANNOT_GET_BIRTH_YEAR = exports.OCR_CANNOT_GET_NAME = exports.OCR_CANNOT_GET_ID_NUMBER = exports.OCR_WRONG_ID_CARD_SIDE = exports.OCR_UNRECOGNIZED_ID_CARD = exports.SDK_MISS_KEY = exports.ERROR_UNKNOWN = exports.SDK_START_ERROR = exports.SDK_START_FLOW_ERROR = exports.getMessage = exports.getErrorResultFromDetails = exports.createCustom = exports.fromCode = exports.getLocalizedMessage = exports.parseNfcResponse = exports.AuthorizationStatus = exports.AppIDType = exports.getEkycError = exports.EKYCErrorEvent = exports.EKYCEvent = 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;
+exports.ESIGN_INVALID_USER_ACCOUNT = exports.ESIGN_APP_LIMITED = exports.ESIGN_DEVICE_NOT_INIT = exports.ESIGN_INVALID_LICENSE_CONTENT = exports.ESIGN_INVALID_LICENSE = exports.ESIGN_DEVICE_ALREADY_INIT = exports.ESIGN_SESSION_INVALID = exports.FETCH_HISTORY_ERROR = exports.QRCODE_ERROR = exports.SMS_OTP_RATE_LIMIT = exports.SMS_OTP_NOT_FOUND = exports.SMS_OTP_MAX_ATTEMPTS = exports.SMS_OTP_INVALID_PHONE = exports.SMS_OTP_ERROR = exports.NFC_CHIP_AUTH_FAILED = exports.NFC_USER_CANCEL = exports.NFC_UNKNOWN_ERROR = exports.NFC_IO_ERROR = exports.NFC_INVALID_MRZ_KEY = exports.NFC_CONNECTION_LOST = exports.NFC_MUTUAL_AUTH_FAILED = exports.C06_ERROR = exports.SCAN_NFC_ENABLE = exports.SCAN_NFC_CHECK = exports.SCAN_NFC_ERROR = exports.HEAD_IS_TURNED_IN_SELFIE = exports.NUDITY_DETECTED_IN_SELFIE = exports.READING_GLASSES_DETECTED_IN_SELFIE = exports.EYEWEAR_DETECTED_IN_SELFIE = exports.FACE_OCCLUDED_IN_SELFIE = exports.FACE_IS_BLURRED = exports.MASK_PRESENT_IN_SELFIE = exports.EYES_CLOSED_IN_SELFIE = exports.MULTIPLE_FACES_IN_SELFIE = exports.LIVENESS_FAIL = exports.LIVENESS_ERROR = exports.FACE_ERROR = exports.FACE_HAT_ERROR = exports.OCR_ERROR = exports.OCR_FONT_BACK_NOT_MATCH = exports.OCR_PHOTOCOPY_ID_CARD = exports.OCR_FAKE_PORTRAIT_DETECTED = exports.OCR_FAKE_CHARACTERS_DETECTED_2 = exports.OCR_FAKE_CHARACTERS_DETECTED_1 = exports.OCR_UNKNOWN_ID_NUMBER_LENGTH = exports.OCR_MODIFIED_BIRTH_DATE_DETECTED_CMND = exports.OCR_MODIFIED_SYMBOL_DETECTED_CMND = exports.OCR_FAKE_BIRTH_DATE_DETECTED_CMND = exports.OCR_FAKE_PORTRAIT_DETECTED_CMND = exports.OCR_FAKE_CHARACTERS_DETECTED_CMND = void 0;
+exports.SDK_NAME = exports.SDK_VERSION = exports.USER_CANCEL = exports.ESIGN_INVALID_PIN_CODE = exports.ESIGN_INVALID_RECOVERY_CODE = exports.ESIGN_INVALID_LICENSE_CODE = exports.ESIGN_INVALID_CONTEXT = exports.ESIGN_MISSING_REQUEST_ID = exports.ESIGN_MISSING_SERIAL = exports.ESIGN_MISSING_IDENTITY = exports.ESIGN_MISSING_ACCESS_TOKEN = exports.ESIGN_NO_SESSION_ID = exports.ESIGN_MISSING_CONFIRMATION_DOC = exports.ESIGN_MISSING_REQUEST_JSON = exports.ESIGN_MISSING_CCCD = exports.ESIGN_MISSING_TOKEN = exports.ESIGN_ERROR_UNKNOWN = exports.ESIGN_AUTH_REQUEST_EXISTS = exports.ESIGN_INVALID_CERT_FOR_AUTH = exports.ESIGN_INVALID_SIGN_COUNT_OR_TIME = exports.ESIGN_AUTH_EXISTS = exports.ESIGN_SESSION_INVALID_LIST_CERT = exports.ESIGN_INVALID_RECOVERY_OR_PIN = exports.ESIGN_SESSION_INVALID_REGISTER = 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; } });
@@ -59,6 +59,10 @@ 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 event enums (port of Android EKYCEvent.kt & EKYCErrorEvent.kt)
+var EKYCEvent_1 = require("./src/types/EKYCEvent");
+Object.defineProperty(exports, "EKYCEvent", { enumerable: true, get: function () { return EKYCEvent_1.EKYCEvent; } });
+Object.defineProperty(exports, "EKYCErrorEvent", { enumerable: true, get: function () { return EKYCEvent_1.EKYCErrorEvent; } });
 var ekycType_1 = require("./src/types/ekycType");
 Object.defineProperty(exports, "getEkycError", { enumerable: true, get: function () { return ekycType_1.getEkycError; } });
 Object.defineProperty(exports, "AppIDType", { enumerable: true, get: function () { return ekycType_1.AppIDType; } });

package/dist/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@finos_sdk/sdk-ekyc",
-  "version": "1.4.4",
+  "version": "1.4.5",
   "description": "React Native SDK for eKYC - Vietnamese CCCD NFC reading, OCR, Liveness detection, Face matching, and C06, eSign, SmsOTP residence verification",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

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

@@ -146,6 +146,14 @@ export declare class FinosEKYCModule {
     onFaceCompareSuccess(callback: (data: SDKEkycResultWithEvent) => void): import("react-native").EmitterSubscription | null;
     /** Payload là EKYCError: { event, code, message }. */
     onFaceCompareError(callback: (error: EKYCError) => void): import("react-native").EmitterSubscription | null;
+    /**
+     * Listen for eKYC UI success events (including LOG_SUCCESS from Liveness/FaceService submit)
+     */
+    onEkycUISuccess(callback: (data: any) => void): import("react-native").EmitterSubscription | null;
+    /**
+     * Listen for eKYC UI error events
+     */
+    onEkycUIError(callback: (error: any) => void): import("react-native").EmitterSubscription | null;
     /**
      * Remove all event listeners
      */

package/dist/src/modules/FinosEKYCModule.js

@@ -345,6 +345,18 @@ class FinosEKYCModule {
     onFaceCompareError(callback) {
         return this.sdk.onFaceCompareError(callback);
     }
+    /**
+     * Listen for eKYC UI success events (including LOG_SUCCESS from Liveness/FaceService submit)
+     */
+    onEkycUISuccess(callback) {
+        return this.sdk.onEkycUISuccess(callback);
+    }
+    /**
+     * Listen for eKYC UI error events
+     */
+    onEkycUIError(callback) {
+        return this.sdk.onEkycUIError(callback);
+    }
     /**
      * Remove all event listeners
      */

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

@@ -0,0 +1,60 @@
+/**
+ * React Native port of EkycNativeAndroid EKYCEvent.kt
+ * Enum các sự kiện SDK trả về qua callback, đồng bộ 1:1 với Android enum.
+ *
+ * @see EkycNativeAndroid/Module/SDKCore/src/main/java/finos/sdk/core/define/EKYCEvent.kt
+ */
+/**
+ * EKYCEvent – tên event trả về từ native callback success.
+ * Giá trị string map chính xác với Android enum name.
+ */
+export declare enum EKYCEvent {
+    /** SDK khởi tạo thành công, activity/flow vừa mở. */
+    SDK_START_SUCCESS = "SDK_START_SUCCESS",
+    /** SDK flow hoàn thành, có data kết quả. */
+    SDK_END_SUCCESS = "SDK_END_SUCCESS",
+    /** Bắt đầu quét NFC (đang chờ thẻ). */
+    SCAN_NFC_START = "SCAN_NFC_START",
+    /** Quét NFC thành công, có dữ liệu thẻ. */
+    SCAN_NFC_SUCCESS = "SCAN_NFC_SUCCESS",
+    /** Xác minh C06 thành công. */
+    C06_SUCCESS = "C06_SUCCESS",
+    /** Liveness detection thành công. */
+    LIVENESS_SUCCESS = "LIVENESS_SUCCESS",
+    /** Face detection đang xử lý (progress). */
+    FACE_PROGRESS = "FACE_PROGRESS",
+    /** Face compare thành công. */
+    FACE_SUCCESS = "FACE_SUCCESS",
+    /** OCR xử lý thành công. */
+    OCR_SUCCESS = "OCR_SUCCESS",
+    /** QR Code quét thành công. */
+    QRCODE_SUCCESS = "QRCODE_SUCCESS",
+    /** Lấy lịch sử giao dịch thành công. */
+    FETCH_LATEST_TRANSACTION_SUCCESS = "FETCH_LATEST_TRANSACTION_SUCCESS",
+    /** Gửi SMS OTP thành công. */
+    SMS_OTP_SEND_SUCCESS = "SMS_OTP_SEND_SUCCESS",
+    /** Xác minh SMS OTP thành công. */
+    SMS_OTP_VERIFY_SUCCESS = "SMS_OTP_VERIFY_SUCCESS",
+    /** Gửi lại SMS OTP thành công. */
+    SMS_OTP_RESEND_SUCCESS = "SMS_OTP_RESEND_SUCCESS",
+    /** Kết quả NFC/Liveness/FaceService đã submit lên server thành công (v1.4.5). */
+    LOG_SUCCESS = "LOG_SUCCESS"
+}
+/**
+ * EKYCErrorEvent – tên event trả về từ native callback error.
+ * Đồng bộ với Android enum EKYCErrorEvent.
+ *
+ * @see EkycNativeAndroid/Module/SDKCore/src/main/java/finos/sdk/core/define/EKYCErrorEvent.kt
+ */
+export declare enum EKYCErrorEvent {
+    SDK_START_ERROR = "SDK_START_ERROR",
+    OCR_ERROR = "OCR_ERROR",
+    LIVENESS_ERROR = "LIVENESS_ERROR",
+    FACE_ERROR = "FACE_ERROR",
+    NFC_ERROR = "NFC_ERROR",
+    C06_ERROR = "C06_ERROR",
+    SDK_DETAIL = "SDK_DETAIL",
+    SMS_OTP_ERROR = "SMS_OTP_ERROR",
+    ESIGN_ERROR = "ESIGN_ERROR",
+    USER_CANCEL = "USER_CANCEL"
+}

package/dist/src/types/EKYCEvent.js

@@ -0,0 +1,65 @@
+"use strict";
+/**
+ * React Native port of EkycNativeAndroid EKYCEvent.kt
+ * Enum các sự kiện SDK trả về qua callback, đồng bộ 1:1 với Android enum.
+ *
+ * @see EkycNativeAndroid/Module/SDKCore/src/main/java/finos/sdk/core/define/EKYCEvent.kt
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EKYCErrorEvent = exports.EKYCEvent = void 0;
+/**
+ * EKYCEvent – tên event trả về từ native callback success.
+ * Giá trị string map chính xác với Android enum name.
+ */
+var EKYCEvent;
+(function (EKYCEvent) {
+    /** SDK khởi tạo thành công, activity/flow vừa mở. */
+    EKYCEvent["SDK_START_SUCCESS"] = "SDK_START_SUCCESS";
+    /** SDK flow hoàn thành, có data kết quả. */
+    EKYCEvent["SDK_END_SUCCESS"] = "SDK_END_SUCCESS";
+    /** Bắt đầu quét NFC (đang chờ thẻ). */
+    EKYCEvent["SCAN_NFC_START"] = "SCAN_NFC_START";
+    /** Quét NFC thành công, có dữ liệu thẻ. */
+    EKYCEvent["SCAN_NFC_SUCCESS"] = "SCAN_NFC_SUCCESS";
+    /** Xác minh C06 thành công. */
+    EKYCEvent["C06_SUCCESS"] = "C06_SUCCESS";
+    /** Liveness detection thành công. */
+    EKYCEvent["LIVENESS_SUCCESS"] = "LIVENESS_SUCCESS";
+    /** Face detection đang xử lý (progress). */
+    EKYCEvent["FACE_PROGRESS"] = "FACE_PROGRESS";
+    /** Face compare thành công. */
+    EKYCEvent["FACE_SUCCESS"] = "FACE_SUCCESS";
+    /** OCR xử lý thành công. */
+    EKYCEvent["OCR_SUCCESS"] = "OCR_SUCCESS";
+    /** QR Code quét thành công. */
+    EKYCEvent["QRCODE_SUCCESS"] = "QRCODE_SUCCESS";
+    /** Lấy lịch sử giao dịch thành công. */
+    EKYCEvent["FETCH_LATEST_TRANSACTION_SUCCESS"] = "FETCH_LATEST_TRANSACTION_SUCCESS";
+    /** Gửi SMS OTP thành công. */
+    EKYCEvent["SMS_OTP_SEND_SUCCESS"] = "SMS_OTP_SEND_SUCCESS";
+    /** Xác minh SMS OTP thành công. */
+    EKYCEvent["SMS_OTP_VERIFY_SUCCESS"] = "SMS_OTP_VERIFY_SUCCESS";
+    /** Gửi lại SMS OTP thành công. */
+    EKYCEvent["SMS_OTP_RESEND_SUCCESS"] = "SMS_OTP_RESEND_SUCCESS";
+    /** Kết quả NFC/Liveness/FaceService đã submit lên server thành công (v1.4.5). */
+    EKYCEvent["LOG_SUCCESS"] = "LOG_SUCCESS";
+})(EKYCEvent || (exports.EKYCEvent = EKYCEvent = {}));
+/**
+ * EKYCErrorEvent – tên event trả về từ native callback error.
+ * Đồng bộ với Android enum EKYCErrorEvent.
+ *
+ * @see EkycNativeAndroid/Module/SDKCore/src/main/java/finos/sdk/core/define/EKYCErrorEvent.kt
+ */
+var EKYCErrorEvent;
+(function (EKYCErrorEvent) {
+    EKYCErrorEvent["SDK_START_ERROR"] = "SDK_START_ERROR";
+    EKYCErrorEvent["OCR_ERROR"] = "OCR_ERROR";
+    EKYCErrorEvent["LIVENESS_ERROR"] = "LIVENESS_ERROR";
+    EKYCErrorEvent["FACE_ERROR"] = "FACE_ERROR";
+    EKYCErrorEvent["NFC_ERROR"] = "NFC_ERROR";
+    EKYCErrorEvent["C06_ERROR"] = "C06_ERROR";
+    EKYCErrorEvent["SDK_DETAIL"] = "SDK_DETAIL";
+    EKYCErrorEvent["SMS_OTP_ERROR"] = "SMS_OTP_ERROR";
+    EKYCErrorEvent["ESIGN_ERROR"] = "ESIGN_ERROR";
+    EKYCErrorEvent["USER_CANCEL"] = "USER_CANCEL";
+})(EKYCErrorEvent || (exports.EKYCErrorEvent = EKYCErrorEvent = {}));

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

@@ -56,6 +56,7 @@ export interface ESignSignRequestConfirm {
 export interface ESignApiResponse {
     status: number;
     msg: string;
+    errorCode?: string;
     data?: {
         sessionId?: string;
         [key: string]: any;
@@ -69,6 +70,7 @@ export interface ESignApiResponse {
 export interface ESignPdfResult {
     status: number;
     msg: string;
+    errorCode?: string;
     data?: {
         transactionId: string;
         [key: string]: any;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@finos_sdk/sdk-ekyc",
-  "version": "1.4.4",
+  "version": "1.4.5",
   "description": "React Native SDK for eKYC - Vietnamese CCCD NFC reading, OCR, Liveness detection, Face matching, and C06, eSign, SmsOTP residence verification",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/src/modules/FinosEKYCModule.ts

@@ -361,6 +361,20 @@ export class FinosEKYCModule {
         return this.sdk.onFaceCompareError(callback);
     }
 
+    /**
+     * Listen for eKYC UI success events (including LOG_SUCCESS from Liveness/FaceService submit)
+     */
+    public onEkycUISuccess(callback: (data: any) => void) {
+        return this.sdk.onEkycUISuccess(callback);
+    }
+
+    /**
+     * Listen for eKYC UI error events
+     */
+    public onEkycUIError(callback: (error: any) => void) {
+        return this.sdk.onEkycUIError(callback);
+    }
+
     /**
      * Remove all event listeners
      */

package/src/types/EKYCEvent.ts

@@ -0,0 +1,76 @@
+/**
+ * React Native port of EkycNativeAndroid EKYCEvent.kt
+ * Enum các sự kiện SDK trả về qua callback, đồng bộ 1:1 với Android enum.
+ *
+ * @see EkycNativeAndroid/Module/SDKCore/src/main/java/finos/sdk/core/define/EKYCEvent.kt
+ */
+
+/**
+ * EKYCEvent – tên event trả về từ native callback success.
+ * Giá trị string map chính xác với Android enum name.
+ */
+export enum EKYCEvent {
+  /** SDK khởi tạo thành công, activity/flow vừa mở. */
+  SDK_START_SUCCESS = 'SDK_START_SUCCESS',
+
+  /** SDK flow hoàn thành, có data kết quả. */
+  SDK_END_SUCCESS = 'SDK_END_SUCCESS',
+
+  /** Bắt đầu quét NFC (đang chờ thẻ). */
+  SCAN_NFC_START = 'SCAN_NFC_START',
+
+  /** Quét NFC thành công, có dữ liệu thẻ. */
+  SCAN_NFC_SUCCESS = 'SCAN_NFC_SUCCESS',
+
+  /** Xác minh C06 thành công. */
+  C06_SUCCESS = 'C06_SUCCESS',
+
+  /** Liveness detection thành công. */
+  LIVENESS_SUCCESS = 'LIVENESS_SUCCESS',
+
+  /** Face detection đang xử lý (progress). */
+  FACE_PROGRESS = 'FACE_PROGRESS',
+
+  /** Face compare thành công. */
+  FACE_SUCCESS = 'FACE_SUCCESS',
+
+  /** OCR xử lý thành công. */
+  OCR_SUCCESS = 'OCR_SUCCESS',
+
+  /** QR Code quét thành công. */
+  QRCODE_SUCCESS = 'QRCODE_SUCCESS',
+
+  /** Lấy lịch sử giao dịch thành công. */
+  FETCH_LATEST_TRANSACTION_SUCCESS = 'FETCH_LATEST_TRANSACTION_SUCCESS',
+
+  /** Gửi SMS OTP thành công. */
+  SMS_OTP_SEND_SUCCESS = 'SMS_OTP_SEND_SUCCESS',
+
+  /** Xác minh SMS OTP thành công. */
+  SMS_OTP_VERIFY_SUCCESS = 'SMS_OTP_VERIFY_SUCCESS',
+
+  /** Gửi lại SMS OTP thành công. */
+  SMS_OTP_RESEND_SUCCESS = 'SMS_OTP_RESEND_SUCCESS',
+
+  /** Kết quả NFC/Liveness/FaceService đã submit lên server thành công (v1.4.5). */
+  LOG_SUCCESS = 'LOG_SUCCESS',
+}
+
+/**
+ * EKYCErrorEvent – tên event trả về từ native callback error.
+ * Đồng bộ với Android enum EKYCErrorEvent.
+ *
+ * @see EkycNativeAndroid/Module/SDKCore/src/main/java/finos/sdk/core/define/EKYCErrorEvent.kt
+ */
+export enum EKYCErrorEvent {
+  SDK_START_ERROR = 'SDK_START_ERROR',
+  OCR_ERROR = 'OCR_ERROR',
+  LIVENESS_ERROR = 'LIVENESS_ERROR',
+  FACE_ERROR = 'FACE_ERROR',
+  NFC_ERROR = 'NFC_ERROR',
+  C06_ERROR = 'C06_ERROR',
+  SDK_DETAIL = 'SDK_DETAIL',
+  SMS_OTP_ERROR = 'SMS_OTP_ERROR',
+  ESIGN_ERROR = 'ESIGN_ERROR',
+  USER_CANCEL = 'USER_CANCEL',
+}

package/src/types/ekycESignType.ts

@@ -64,6 +64,7 @@ export interface ESignSignRequestConfirm {
 export interface ESignApiResponse {
   status: number;
   msg: string;
+  errorCode?: string;
   data?: {
     sessionId?: string;
     [key: string]: any;
@@ -78,6 +79,7 @@ export interface ESignApiResponse {
 export interface ESignPdfResult {
   status: number;
   msg: string;
+  errorCode?: string;
   data?: {
     transactionId: string;
     [key: string]: any; // Cho phép các field động khác