@finos_sdk/sdk-ekyc 1.4.2 → 1.4.5

package/dist/src/types/ekycType.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getEkycError = exports.AppIDType = void 0;
+exports.AppIDType = void 0;
+exports.getEkycError = getEkycError;
 /**
  * AppIDType – loại app ID truyền vào SDK.
  * Map native: Android AppIDType.NONE / AppIDType.HD_BANK / AppIDType.VIKKI,
@@ -11,7 +12,7 @@ var AppIDType;
     AppIDType["NONE"] = "NONE";
     AppIDType["HD_BANK"] = "HD_BANK";
     AppIDType["VIKKI"] = "VIKKI";
-})(AppIDType = exports.AppIDType || (exports.AppIDType = {}));
+})(AppIDType || (exports.AppIDType = AppIDType = {}));
 /**
  * Parse chuỗi lỗi cũ từ native (trước khi gửi object): "CustomError(customCode=109, customMessage=Lỗi Face compare...)"
  * Giúp app vẫn lấy được customCode/customMessage khi dùng bản native chưa có userInfo.
@@ -55,4 +56,3 @@ function getEkycError(error) {
         message,
     };
 }
-exports.getEkycError = getEkycError;

package/dist/src/utils/utils.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.parseNfcResponse = void 0;
+exports.parseNfcResponse = parseNfcResponse;
 // Utility function to parse NFC response string to NFCData
 function parseNfcResponse(nfcResponseStr) {
     var _a, _b, _c, _d, _e, _f;
@@ -41,5 +41,4 @@ function parseNfcResponse(nfcResponseStr) {
         return null;
     }
 }
-exports.parseNfcResponse = parseNfcResponse;
 ;

package/ios/EKYCModule.swift

@@ -161,8 +161,8 @@ class EKYCModule: RCTEventEmitter {
 
   // MARK: - Liveness
 
-  @objc(startLiveness:selfieImage:transactionId:switchFrontCamera:useActiveLiveness:autoCapture:isShowCameraFont:customActionsArray:activeActionCount:forceCaptureTimeout:resolver:rejecter:)
-  func startLiveness(_ appKey: String, selfieImage: String, transactionId: String, switchFrontCamera: Bool, useActiveLiveness: Bool, autoCapture: Bool, isShowCameraFont: Bool, customActionsArray: [String]?, activeActionCount: Int, forceCaptureTimeout: Double, resolver resolve: @escaping RCTPromiseResolveBlock, rejecter reject: @escaping RCTPromiseRejectBlock) {
+  @objc(startLiveness:selfieImage:transactionId:isActiveLiveness:isShowCameraFont:customActionsArray:activeActionCount:forceCaptureTimeout:isActiveLivenessColor:resolver:rejecter:)
+  func startLiveness(_ appKey: String, selfieImage: String, transactionId: String, isActiveLiveness: Bool, isShowCameraFont: Bool, customActionsArray: [String]?, activeActionCount: Int, forceCaptureTimeout: Double, isActiveLivenessColor: Bool, resolver resolve: @escaping RCTPromiseResolveBlock, rejecter reject: @escaping RCTPromiseRejectBlock) {
     DispatchQueue.main.async { [weak self] in
       guard let vc = self?.rootVC else { reject("NO_VC", "No root view controller", nil); return }
       guard let selfieUIImage = self?.resolveImageInput(selfieImage) else {
@@ -172,8 +172,9 @@ class EKYCModule: RCTEventEmitter {
         switch $0 { case "LEFT": return .left; case "RIGHT": return .right; case "STRAIGHT": return .straight; default: return nil }
       }
       let livenessConfig = LivenessConfig(
-        isActiveLiveness: useActiveLiveness, autoCapture: autoCapture,
-        isShowCameraFont: isShowCameraFont || switchFrontCamera,
+        isActiveLiveness: isActiveLiveness,
+        isActiveLivenessColor: isActiveLivenessColor,
+        isShowCameraFont: isShowCameraFont,
         customActions: customActions?.isEmpty == false ? customActions : nil,
         activeActionCount: activeActionCount > 0 ? activeActionCount : 2,
         forceCaptureTimeout: Int64(forceCaptureTimeout * 1000),

package/ios/EKYCModuleBridge.m

@@ -47,14 +47,14 @@ RCT_EXTERN_METHOD(startOcr : (NSString *)appKey idImage : (
 // MARK: - Liveness
 RCT_EXTERN_METHOD(
     startLiveness : (NSString *)appKey selfieImage : (NSString *)selfieImage
-        transactionId : (NSString *)transactionId switchFrontCamera : (
-            BOOL)switchFrontCamera useActiveLiveness : (BOOL)useActiveLiveness
-            autoCapture : (BOOL)autoCapture isShowCameraFont : (
-                BOOL)isShowCameraFont customActionsArray : (NSArray *)
-                customActionsArray activeActionCount : (NSInteger)
-                    activeActionCount forceCaptureTimeout : (double)
-                        forceCaptureTimeout resolver : (RCTPromiseResolveBlock)
-                            resolve rejecter : (RCTPromiseRejectBlock)reject)
+        transactionId : (NSString *)transactionId isActiveLiveness : (BOOL)
+            isActiveLiveness isShowCameraFont : (BOOL)isShowCameraFont
+            customActionsArray : (NSArray *)customActionsArray
+            activeActionCount : (NSInteger)activeActionCount
+            forceCaptureTimeout : (double)forceCaptureTimeout
+            isActiveLivenessColor : (BOOL)isActiveLivenessColor
+            resolver : (RCTPromiseResolveBlock)resolve
+            rejecter : (RCTPromiseRejectBlock)reject)
 
 // MARK: - FaceCompare
 RCT_EXTERN_METHOD(startFaceCompare : (NSString *)appKey transactionId : (

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@finos_sdk/sdk-ekyc",
-  "version": "1.4.2",
+  "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",
@@ -83,4 +83,4 @@
   "engines": {
     "node": ">=18"
   }
-}
+}

package/src/modules/FinosEKYCModule.ts

@@ -207,11 +207,6 @@ export class FinosEKYCModule {
             } else if (config.activeActionCount !== undefined) {
                 console.log('🎲 Random actions count:', config.activeActionCount);
             }
-            if (config.switchFrontCamera !== undefined) {
-                console.log('📷 Front camera setting:', config.switchFrontCamera ? 'ON' : 'OFF');
-            }
-
-
 
             const result = await this.sdk.startLiveness(config);
             console.log('✅ Liveness detection completed:', result.event);
@@ -366,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/EKYCErrorResult.ts

@@ -150,6 +150,44 @@ export const ESIGN_INVALID_LICENSE_CODE = def('611', 'Mã license không đượ
 export const ESIGN_INVALID_RECOVERY_CODE = def('612', 'Mã recovery không được để trống (8 chữ số)', 'Recovery code cannot be empty (8 digits required)');
 export const ESIGN_INVALID_PIN_CODE = def('613', 'Mã PIN không được để trống (6 chữ số)', 'PIN code cannot be empty (6 digits required)');
 
+// ========================================
+// ESIGN VALIDATION ERRORS (614 -> 649)
+// ========================================
+export const ESIGN_MISSING_NAME = def('614', 'Thiếu tên người dùng', 'User name is required');
+export const ESIGN_MISSING_DEVICE_ID = def('615', 'Thiếu Device ID', 'Device ID is required');
+export const ESIGN_INVALID_REQUEST_JSON = def('616', 'Request JSON không hợp lệ (không parse được)', 'Request JSON is invalid (cannot parse)');
+export const ESIGN_MISSING_PIN_CODE = def('617', 'Thiếu mã PIN', 'PIN code is required');
+export const ESIGN_MISSING_USER_PIN = def('618', 'Thiếu mã PIN người dùng', 'User PIN is required');
+export const ESIGN_INVALID_PAGE_PARAMS = def('619', 'pageNumber và pageSize phải lớn hơn 0', 'pageNumber and pageSize must be greater than 0');
+export const ESIGN_INVALID_QUANTITY = def('620', 'Số lượng (quantity) phải lớn hơn 0', 'Quantity must be greater than 0');
+export const ESIGN_INVALID_TIME = def('621', 'Thời gian (time) phải lớn hơn 0', 'Time must be greater than 0');
+export const ESIGN_INVALID_PIN_FORMAT = def('622', 'Mã PIN phải đúng 6 chữ số', 'PIN code must be exactly 6 digits');
+export const ESIGN_INVALID_RECOVERY_FORMAT = def('623', 'Mã recovery phải đúng 8 chữ số', 'Recovery code must be exactly 8 digits');
+export const ESIGN_MISSING_USER_INFO = def('624', 'Thiếu object userInfo trong request JSON', 'userInfo object is required in request JSON');
+export const ESIGN_MISSING_FIELD_IDENTITY = def('625', 'Thiếu userInfo.identity trong request JSON', 'userInfo.identity is required in request JSON');
+export const ESIGN_MISSING_FIELD_SOD = def('626', 'Thiếu userInfo.sod trong request JSON', 'userInfo.sod is required in request JSON');
+export const ESIGN_MISSING_FIELD_REGISTER_DATE = def('627', 'Thiếu userInfo.registerDate trong request JSON', 'userInfo.registerDate is required in request JSON');
+export const ESIGN_MISSING_FIELD_EXPIRED_DATE = def('628', 'Thiếu userInfo.expiredDate trong request JSON', 'userInfo.expiredDate is required in request JSON');
+export const ESIGN_MISSING_SIGNING_CONTENTS = def('629', 'Thiếu signingRequestContents trong request JSON', 'signingRequestContents is required in request JSON');
+export const ESIGN_MISSING_FIELD_DATA = def('630', 'Thiếu data (PDF base64) trong signingRequestContents', 'data (PDF base64) is required in signingRequestContents');
+export const ESIGN_MISSING_TOKEN_INFO = def('631', 'Thiếu tokenInfo trong request JSON', 'tokenInfo object is required in request JSON');
+export const ESIGN_MISSING_FIELD_USERNAME = def('632', 'Thiếu tokenInfo.username trong request JSON', 'tokenInfo.username is required in request JSON');
+export const ESIGN_MISSING_FIELD_SERIAL_TOKEN = def('633', 'Thiếu tokenInfo.serial trong request JSON', 'tokenInfo.serial is required in request JSON');
+export const ESIGN_MISSING_FIELD_SESSION_ID = def('634', 'Thiếu sessionId trong request JSON', 'sessionId is required in request JSON');
+export const ESIGN_MISSING_FIELD_NAME = def('635', 'Thiếu userInfo.name trong request JSON', 'userInfo.name is required in request JSON');
+export const ESIGN_MISSING_FIELD_ADDRESS = def('636', 'Thiếu userInfo.address trong request JSON', 'userInfo.address is required in request JSON');
+export const ESIGN_MISSING_FIELD_SIGNATURE = def('637', 'Thiếu userInfo.signature trong request JSON', 'userInfo.signature is required in request JSON');
+export const ESIGN_MISSING_EMAIL_OR_PHONE = def('638', 'Phải có ít nhất email hoặc phone trong request JSON', 'At least email or phone is required in request JSON');
+export const ESIGN_MISSING_POLICY_AGREEMENT = def('639', 'Thiếu policyAgreement trong request JSON', 'policyAgreement object is required in request JSON');
+export const ESIGN_MISSING_FIELD_POLICY_STATUS = def('640', 'Thiếu policyAgreement.policyStatus trong request JSON', 'policyAgreement.policyStatus is required in request JSON');
+export const ESIGN_MISSING_FIELD_ACCEPT_TIME = def('641', 'Thiếu policyAgreement.acceptTime trong request JSON', 'policyAgreement.acceptTime is required in request JSON');
+export const ESIGN_MISSING_FIELD_DEVICE = def('642', 'Thiếu policyAgreement.device trong request JSON', 'policyAgreement.device is required in request JSON');
+export const ESIGN_MISSING_SIGN_POSITIONS = def('645', 'Thiếu signPositions trong signingRequestContents (API multiple positions)', 'signPositions array is required in signingRequestContents');
+export const ESIGN_MISSING_SIGN_POSITION_LOCATION = def('646', 'Thiếu location trong signPositions', 'location object is required in each signPosition');
+export const ESIGN_MISSING_FIELD_DOCUMENT_NAME = def('647', 'Thiếu documentName trong signingRequestContents', 'documentName is required in signingRequestContents');
+export const ESIGN_INVALID_REGISTER_DATE_FORMAT = def('648', 'userInfo.registerDate phải đúng định dạng dd/MM/yyyy', 'userInfo.registerDate must be in dd/MM/yyyy format');
+export const ESIGN_INVALID_EXPIRED_DATE_FORMAT = def('649', 'userInfo.expiredDate phải đúng định dạng dd/MM/yyyy', 'userInfo.expiredDate must be in dd/MM/yyyy format');
+
 // ========================================
 // Predefined list & code map (companion object)
 // ========================================
@@ -179,6 +217,19 @@ const PREDEFINED_ERRORS: EKYCErrorResultLike[] = [
   ESIGN_INVALID_USER_ACCOUNT, ESIGN_SESSION_INVALID_REGISTER, ESIGN_INVALID_RECOVERY_OR_PIN,
   ESIGN_SESSION_INVALID_LIST_CERT, ESIGN_AUTH_EXISTS, ESIGN_INVALID_SIGN_COUNT_OR_TIME,
   ESIGN_INVALID_CERT_FOR_AUTH, ESIGN_AUTH_REQUEST_EXISTS,
+  ESIGN_MISSING_NAME, ESIGN_MISSING_DEVICE_ID, ESIGN_INVALID_REQUEST_JSON,
+  ESIGN_MISSING_PIN_CODE, ESIGN_MISSING_USER_PIN, ESIGN_INVALID_PAGE_PARAMS,
+  ESIGN_INVALID_QUANTITY, ESIGN_INVALID_TIME, ESIGN_INVALID_PIN_FORMAT, ESIGN_INVALID_RECOVERY_FORMAT,
+  ESIGN_MISSING_USER_INFO, ESIGN_MISSING_FIELD_IDENTITY, ESIGN_MISSING_FIELD_SOD,
+  ESIGN_MISSING_FIELD_REGISTER_DATE, ESIGN_MISSING_FIELD_EXPIRED_DATE,
+  ESIGN_MISSING_SIGNING_CONTENTS, ESIGN_MISSING_FIELD_DATA, ESIGN_MISSING_TOKEN_INFO,
+  ESIGN_MISSING_FIELD_USERNAME, ESIGN_MISSING_FIELD_SERIAL_TOKEN, ESIGN_MISSING_FIELD_SESSION_ID,
+  ESIGN_MISSING_FIELD_NAME, ESIGN_MISSING_FIELD_ADDRESS, ESIGN_MISSING_FIELD_SIGNATURE,
+  ESIGN_MISSING_EMAIL_OR_PHONE, ESIGN_MISSING_POLICY_AGREEMENT,
+  ESIGN_MISSING_FIELD_POLICY_STATUS, ESIGN_MISSING_FIELD_ACCEPT_TIME, ESIGN_MISSING_FIELD_DEVICE,
+  ESIGN_MISSING_SIGN_POSITIONS, ESIGN_MISSING_SIGN_POSITION_LOCATION,
+  ESIGN_MISSING_FIELD_DOCUMENT_NAME,
+  ESIGN_INVALID_REGISTER_DATE_FORMAT, ESIGN_INVALID_EXPIRED_DATE_FORMAT,
   USER_CANCEL,
 ];
 

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

package/src/types/ekycLivenessType.ts

@@ -45,10 +45,9 @@ export interface LivenessConfig {
     // usingRandomAction: boolean; 
     // isStraight: boolean;
     selfieImage: string;
-    switchFrontCamera?: boolean;
     // New fields for version 1.3.0
     isActiveLiveness?: boolean;
-    autoCapture?: boolean;
+    isActiveLivenessColor?: boolean;
     isShowCameraFont?: boolean;
     customActions?: SDKFaceDetectStatus[];
     activeActionCount?: number;