@finos_sdk/sdk-ekyc 1.3.1 → 1.3.3

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 { UserEsignModel, ESignInitResult, ESignOpenSessionResult, ESignCertificate, ESignSignRequest, ESignError } from '../types/ekycESignType';
+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)
      */
@@ -171,14 +172,14 @@ export declare class FinosEKYCModule {
      */
     initializeESign(): Promise<ESignInitResult>;
     /**
-     * Open eSign session
-     * @param accessToken JWT access token (optional if using userEsignModel)
-     * @param username Optional username
-     * @param rememberMe Remember session
-     * @param userEsignModel User info for auto token creation (optional if using accessToken)
-     * @param privateKeyFilePath Path to private key file in assets (required if using userEsignModel)
+     * Open eSign Session
+     * @param accessToken Access token (JWT)
+     * @param username Username
+     * @param rememberMe Remember me flag
+     * @param userEsignModel User info model (for auto-token generation)
+     * @param privateKeyFilePath Path to private key file (for auto-token generation)
      */
-    openSessionId(accessToken?: string, username?: string, rememberMe?: boolean, userEsignModel?: UserEsignModel, privateKeyFilePath?: string): Promise<ESignOpenSessionResult>;
+    openSessionId(accessToken: string | null, username: string | null, rememberMe: boolean | null): Promise<ESignOpenSessionResult>;
     /**
      * Register device for eSign
      * @param recoverCode 8-digit recovery code
@@ -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;
@@ -350,6 +358,6 @@ export { SDKFaceDetectStatus } from '../types/ekycLivenessType';
 export type { FaceServiceConfig } from '../types/ekycFaceType';
 export type { SDKEkycResultWithEvent, SDKEkycResultStringWithEvent } from '../types/ekycType';
 export type { SmsOtpConfig, SmsOtpResult, SmsOtpError } from '../types/ekycSmsOtpType';
-export type { UserEsignModel, ESignInitResult, ESignOpenSessionResult, ESignCertificate, ESignSignRequest, ESignError, ESignAuthenticateResult } from '../types/ekycESignType';
+export type { ESignInitResult, ESignOpenSessionResult, ESignCertificate, ESignSignRequest, ESignError, ESignAuthenticateResult } from '../types/ekycESignType';
 export { SDK_VERSION, SDK_NAME };
 export default FinosEKYC;

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)
      */
@@ -435,25 +436,17 @@ class FinosEKYCModule {
         }
     }
     /**
-     * Open eSign session
-     * @param accessToken JWT access token (optional if using userEsignModel)
-     * @param username Optional username
-     * @param rememberMe Remember session
-     * @param userEsignModel User info for auto token creation (optional if using accessToken)
-     * @param privateKeyFilePath Path to private key file in assets (required if using userEsignModel)
+     * Open eSign Session
+     * @param accessToken Access token (JWT)
+     * @param username Username
+     * @param rememberMe Remember me flag
+     * @param userEsignModel User info model (for auto-token generation)
+     * @param privateKeyFilePath Path to private key file (for auto-token generation)
      */
-    async openSessionId(accessToken, username, rememberMe, userEsignModel, privateKeyFilePath) {
+    async openSessionId(accessToken, username, rememberMe) {
         this.validateSDKReady();
-        try {
-            console.log('🔓 Opening eSign session...');
-            const result = await this.sdk.openSessionId(accessToken, username, rememberMe, userEsignModel, privateKeyFilePath);
-            console.log('✅ eSign session opened successfully');
-            return result;
-        }
-        catch (error) {
-            console.error('❌ eSign session open failed:', error);
-            throw error;
-        }
+        // Pass through to SDK - error handling is done in EKYCModule.ts
+        return await this.sdk.openSessionId(accessToken, username, rememberMe);
     }
     /**
      * Register device for eSign
@@ -639,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
@@ -656,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;
         }
@@ -708,6 +701,7 @@ const isMethod = (prop) => {
     return typeof prototype[prop] === 'function' ||
         prop.startsWith('on') ||
         prop === 'initialize' ||
+        prop === 'openSessionId' ||
         prop === 'startEkycUI' ||
         prop === 'startNfcScan' ||
         prop === 'checkC06' ||

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

@@ -1,6 +1,6 @@
 import { SDK_VERSION, SDK_NAME } from '../../EKYCModule';
 import { SmsOtpConfig, SmsOtpResult, SmsOtpError } from '../types/ekycSmsOtpType';
-import { UserEsignModel, ESignInitResult, ESignOpenSessionResult, ESignCertificate, ESignSignRequest, ESignError } from '../types/ekycESignType';
+import { ESignInitResult, ESignOpenSessionResult, ESignCertificate, ESignSignRequest, ESignError } from '../types/ekycESignType';
 import { LivenessConfig } from '../types/ekycLivenessType';
 import { FaceServiceConfig } from '../types/ekycFaceType';
 import { SDKEkycResultStringWithEvent, SDKEkycResultWithEvent } from '../types/ekycType';
@@ -76,14 +76,14 @@ export declare class FinosESignModule {
      */
     getSdkToken(identity: string, name: string, deviceId: string): Promise<string>;
     /**
-     * Open eSign session
-     * @param accessToken JWT access token (optional if using userEsignModel)
-     * @param username Optional username
-     * @param rememberMe Remember session
-     * @param userEsignModel User info for auto token creation (optional if using accessToken)
-     * @param privateKeyFilePath Path to private key file in assets (required if using userEsignModel)
+     * Open eSign Session
+     * @param accessToken Access token (JWT)
+     * @param username Username
+     * @param rememberMe Remember me flag
+     * @param userEsignModel User info model (for auto-token generation)
+     * @param privateKeyFilePath Path to private key file (for auto-token generation)
      */
-    openSessionId(accessToken?: string, username?: string, rememberMe?: boolean, userEsignModel?: UserEsignModel, privateKeyFilePath?: string): Promise<ESignOpenSessionResult>;
+    openSessionId(accessToken: string | null, username: string | null, rememberMe: boolean | null): Promise<ESignOpenSessionResult>;
     /**
      * Register device for eSign
      * @param recoverCode 8-digit recovery code
@@ -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
@@ -266,7 +278,7 @@ export declare class FinosESignModule {
 }
 export declare const FinosESign: FinosESignModule;
 export type { SmsOtpConfig, SmsOtpResult, SmsOtpError } from '../types/ekycSmsOtpType';
-export type { UserEsignModel, ESignInitResult, ESignOpenSessionResult, ESignCertificate, ESignSignRequest, ESignError, ESignAuthenticateResult } from '../types/ekycESignType';
+export type { ESignInitResult, ESignOpenSessionResult, ESignCertificate, ESignSignRequest, ESignError, ESignAuthenticateResult } from '../types/ekycESignType';
 export type { LivenessConfig } from '../types/ekycLivenessType';
 export { SDKFaceDetectStatus } from '../types/ekycLivenessType';
 export type { FaceServiceConfig } from '../types/ekycFaceType';

package/dist/src/modules/FinosESignModule.js

@@ -189,17 +189,17 @@ class FinosESignModule {
         return await this.sdk.getSdkToken(identity, name, deviceId);
     }
     /**
-     * Open eSign session
-     * @param accessToken JWT access token (optional if using userEsignModel)
-     * @param username Optional username
-     * @param rememberMe Remember session
-     * @param userEsignModel User info for auto token creation (optional if using accessToken)
-     * @param privateKeyFilePath Path to private key file in assets (required if using userEsignModel)
+     * Open eSign Session
+     * @param accessToken Access token (JWT)
+     * @param username Username
+     * @param rememberMe Remember me flag
+     * @param userEsignModel User info model (for auto-token generation)
+     * @param privateKeyFilePath Path to private key file (for auto-token generation)
      */
-    async openSessionId(accessToken, username, rememberMe, userEsignModel, privateKeyFilePath) {
+    async openSessionId(accessToken, username, rememberMe) {
         this.validateSDKReady();
         // Pass through to SDK - error handling is done in EKYCModule.ts
-        return await this.sdk.openSessionId(accessToken, username, rememberMe, userEsignModel, privateKeyFilePath);
+        return await this.sdk.openSessionId(accessToken, username, rememberMe);
     }
     /**
      * Register device for eSign
@@ -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) {
@@ -480,16 +497,18 @@ const isMethod = (prop) => {
         prop.startsWith('on') ||
         prop === 'initialize' ||
         prop === 'initializeESign' ||
+        prop === 'getSdkToken' ||
+        prop === 'openSessionId' ||
         prop === 'sendOtp' ||
         prop === 'verifyOtp' ||
         prop === 'resendOtp' ||
-        prop === 'openSessionId' ||
         prop === 'registerDevice' ||
         prop === 'listCerts' ||
         prop === 'verifyCert' ||
         prop === 'listSignRequest' ||
         prop === 'confirmSign' ||
         prop === 'registerRemoteSigning' ||
+        prop === 'registerAndConfirm' ||
         prop === 'signPdf' ||
         prop === 'sendConfirmationDocument' ||
         prop === 'startLiveness' ||
@@ -546,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 => {
@@ -558,9 +577,9 @@ const createFinosESignStub = () => {
     // Add all other methods
     const otherMethods = [
         'initialize', 'startNfcScan', 'checkC06', 'startOcr', 'startLiveness', 'startFaceCompare',
-        'startEkycUI', 'sendOtp', 'verifyOtp', 'resendOtp', 'initializeESign', 'openSessionId',
+        '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/ekycESignType.d.ts

@@ -1,27 +1,12 @@
 /**
- * User Information Model for eSign
+ * eSign Initialize Result
  */
 export interface UserEsignModel {
-    /**
-     * ID card number (CCCD/CMND)
-     */
     cccd: string;
-    /**
-     * User name
-     */
     name: string;
-    /**
-     * Device type (e.g., "Android", "iOS")
-     */
-    device: string;
-    /**
-     * Device ID
-     */
-    deviceId: string;
+    device?: string;
+    deviceId?: string;
 }
-/**
- * eSign Initialize Result
- */
 export interface ESignInitResult {
     code: string;
     message: string;

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.1",
+  "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 { UserEsignModel, ESignInitResult, ESignOpenSessionResult, ESignCertificate, ESignSignRequest, ESignError, ESignAuthenticateResult } from '../types/ekycESignType';
+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)
      */
@@ -467,41 +468,31 @@ export class FinosEKYCModule {
             throw error;
         }
     }
-
     /**
-     * Open eSign session
-     * @param accessToken JWT access token (optional if using userEsignModel)
-     * @param username Optional username
-     * @param rememberMe Remember session
-     * @param userEsignModel User info for auto token creation (optional if using accessToken)
-     * @param privateKeyFilePath Path to private key file in assets (required if using userEsignModel)
+     * Open eSign Session
+     * @param accessToken Access token (JWT)
+     * @param username Username
+     * @param rememberMe Remember me flag
+     * @param userEsignModel User info model (for auto-token generation)
+     * @param privateKeyFilePath Path to private key file (for auto-token generation)
      */
     public async openSessionId(
-        accessToken?: string,
-        username?: string,
-        rememberMe?: boolean,
-        userEsignModel?: UserEsignModel,
-        privateKeyFilePath?: string
+        accessToken: string | null,
+        username: string | null,
+        rememberMe: boolean | null
     ): Promise<ESignOpenSessionResult> {
         this.validateSDKReady();
-
-        try {
-            console.log('🔓 Opening eSign session...');
-            const result = await this.sdk.openSessionId(
-                accessToken,
-                username,
-                rememberMe,
-                userEsignModel,
-                privateKeyFilePath
-            );
-            console.log('✅ eSign session opened successfully');
-            return result;
-        } catch (error) {
-            console.error('❌ eSign session open failed:', error);
-            throw error;
-        }
+        // Pass through to SDK - error handling is done in EKYCModule.ts
+        return await this.sdk.openSessionId(
+            accessToken,
+            username,
+            rememberMe
+        );
     }
 
+
+
+
     /**
      * Register device for eSign
      * @param recoverCode 8-digit recovery code
@@ -731,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
@@ -740,7 +731,7 @@ export class FinosEKYCModule {
      */
     public async startEkycUI(
         appKey: string,
-        flowSDK: string[],
+        flowSDK: SDKFlowType[],
         language: string,
         transactionId: string,
         appKeyConfig: {
@@ -756,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;
@@ -808,7 +806,7 @@ export class FinosEKYCModule {
 
             const result = await this.sdk.startEkycUI(
                 appKey,
-                flowSDK,
+                flowToStrings(flowSDK),
                 language,
                 transactionId,
                 appKeyConfig,
@@ -867,6 +865,7 @@ const isMethod = (prop: string | symbol): boolean => {
     return typeof prototype[prop] === 'function' ||
         prop.startsWith('on') ||
         prop === 'initialize' ||
+        prop === 'openSessionId' ||
         prop === 'startEkycUI' ||
         prop === 'startNfcScan' ||
         prop === 'checkC06' ||
@@ -1003,7 +1002,7 @@ export { SDKFaceDetectStatus } from '../types/ekycLivenessType';
 export type { FaceServiceConfig } from '../types/ekycFaceType';
 export type { SDKEkycResultWithEvent, SDKEkycResultStringWithEvent } from '../types/ekycType';
 export type { SmsOtpConfig, SmsOtpResult, SmsOtpError } from '../types/ekycSmsOtpType';
-export type { UserEsignModel, ESignInitResult, ESignOpenSessionResult, ESignCertificate, ESignSignRequest, ESignError, ESignAuthenticateResult } from '../types/ekycESignType';
+export type { ESignInitResult, ESignOpenSessionResult, ESignCertificate, ESignSignRequest, ESignError, ESignAuthenticateResult } from '../types/ekycESignType';
 
 // Export constants
 export { SDK_VERSION, SDK_NAME };