@finos_sdk/sdk-ekyc 1.2.9 → 1.3.2

package/src/modules/FinosEKYCModule.ts

@@ -7,7 +7,7 @@ import { OcrConfig } from '../types/ekycOCRType';
 import { LivenessConfig } 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';
 
 /**
  * Finos eKYC SDK Module
@@ -97,7 +97,7 @@ export class FinosEKYCModule {
                 this.isInitialized = true;
                 return 'SDK already initialized (Koin Application started)';
             }
-            
+
             console.error('❌ Failed to initialize Finos eKYC SDK:', error);
             throw new Error(`SDK initialization failed: ${error}`);
         }
@@ -116,7 +116,7 @@ export class FinosEKYCModule {
      */
     public async setTransactionId(transactionId: string): Promise<boolean> {
         this.validateSDKReady();
-        
+
         try {
             console.log('🆔 Setting transaction ID:', transactionId);
             const result = await this.sdk.setTransactionId(transactionId);
@@ -135,7 +135,7 @@ export class FinosEKYCModule {
     public async startNfcScan(config: NfcConfig): Promise<SDKEkycResultStringWithEvent> {
         this.validateSDKReady();
         this.validatePlatform('android', 'NFC scanning is only available on Android');
-        
+
         try {
             console.log('📡 Starting NFC scan...');
             const result = await this.sdk.startNfcScan(config);
@@ -153,7 +153,7 @@ export class FinosEKYCModule {
      */
     public async checkC06(config: C06Config): Promise<SDKEkycResultStringWithEvent> {
         this.validateSDKReady();
-        
+
         try {
             console.log('🏠 Starting C06 residence check...');
             const result = await this.sdk.checkC06(config);
@@ -169,9 +169,9 @@ export class FinosEKYCModule {
      * Start OCR document scanning
      * @param config OCR configuration
      */
-    public async startOCR(config: OcrConfig): Promise<SDKEkycResultStringWithEvent> {
+    public async startOcr(config: OcrConfig): Promise<SDKEkycResultStringWithEvent> {
         this.validateSDKReady();
-        
+
         try {
             console.log('📄 Starting OCR scan...');
             const result = await this.sdk.startOcr(config);
@@ -185,16 +185,33 @@ export class FinosEKYCModule {
 
     /**
      * Start liveness detection
-     * @param config Liveness configuration (includes switchFrontCamera for camera control)
+     * @param config Liveness configuration
+     * @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.activeActionCount - Number of random actions (1-10), only used when customActions is null (default: 2)
+     * @param config.switchFrontCamera - Use front camera (default: false)
      */
     public async startLiveness(config: LivenessConfig): Promise<SDKEkycResultStringWithEvent> {
         this.validateSDKReady();
-        
+
         try {
             console.log('👁️ Starting liveness detection...');
+            if (config.isActiveLiveness !== undefined) {
+                console.log('🔴 Active liveness:', config.isActiveLiveness ? 'ON' : 'OFF');
+            }
+            if (config.customActions && config.customActions.length > 0) {
+                console.log('🎯 Custom actions:', config.customActions.join(', '));
+            } 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);
             return result;
@@ -210,7 +227,7 @@ export class FinosEKYCModule {
      */
     public async startFaceCompare(config: FaceServiceConfig): Promise<SDKEkycResultStringWithEvent> {
         this.validateSDKReady();
-        
+
         try {
             console.log('👤 Starting face comparison...');
             const result = await this.sdk.startFaceCompare(config);
@@ -228,7 +245,7 @@ export class FinosEKYCModule {
      */
     public async extractNfcDataForC06(nfcResultJson: string): Promise<any> {
         this.validateSDKReady();
-        
+
         try {
             console.log('🔍 Extracting NFC data for C06...');
             // Note: This method needs to be implemented in the native module
@@ -303,14 +320,14 @@ export class FinosEKYCModule {
     /**
      * Listen for OCR success events
      */
-    public onOCRSuccess(callback: (data: SDKEkycResultStringWithEvent) => void) {
+    public onOcrSuccess(callback: (data: SDKEkycResultStringWithEvent) => void) {
         return this.sdk.onOcrSuccess(callback);
     }
 
     /**
      * Listen for OCR error events
      */
-    public onOCRError(callback: (error: any) => void) {
+    public onOcrError(callback: (error: any) => void) {
         return this.sdk.onOcrError(callback);
     }
 
@@ -358,7 +375,7 @@ export class FinosEKYCModule {
      */
     public async sendOtp(config: SmsOtpConfig): Promise<SmsOtpResult> {
         this.validateSDKReady();
-        
+
         try {
             console.log('📱 Sending SMS OTP...');
             const result = await this.sdk.sendOtp(config);
@@ -377,7 +394,7 @@ export class FinosEKYCModule {
      */
     public async verifyOtp(config: SmsOtpConfig, otpCode: string): Promise<SmsOtpResult> {
         this.validateSDKReady();
-        
+
         try {
             console.log('🔐 Verifying SMS OTP...');
             const result = await this.sdk.verifyOtp(config, otpCode);
@@ -395,7 +412,7 @@ export class FinosEKYCModule {
      */
     public async resendOtp(config: SmsOtpConfig): Promise<SmsOtpResult> {
         this.validateSDKReady();
-        
+
         try {
             console.log('📱 Resending SMS OTP...');
             const result = await this.sdk.resendOtp(config);
@@ -416,14 +433,6 @@ export class FinosEKYCModule {
         return listener;
     }
 
-    public onSmsOtpVerifySuccess(callback: (data: SmsOtpResult) => void) {
-        const listener = this.sdk.onSmsOtpVerifySuccess(callback);
-        if (!listener) {
-            console.warn('⚠️ onSmsOtpVerifySuccess: Event emitter not ready.');
-        }
-        return listener;
-    }
-
     public onSmsOtpResendSuccess(callback: (data: SmsOtpResult) => void) {
         const listener = this.sdk.onSmsOtpResendSuccess(callback);
         if (!listener) {
@@ -447,7 +456,7 @@ export class FinosEKYCModule {
      */
     public async initializeESign(): Promise<ESignInitResult> {
         this.validateSDKReady();
-        
+
         try {
             console.log('🔐 Initializing eSign SDK...');
             const result = await this.sdk.initializeESign();
@@ -458,41 +467,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
@@ -505,7 +504,7 @@ export class FinosEKYCModule {
         fcmToken?: string
     ): Promise<{ code: string; message: string }> {
         this.validateSDKReady();
-        
+
         try {
             console.log('📱 Registering eSign device...');
             const result = await this.sdk.registerDevice(recoverCode, pinCode, fcmToken);
@@ -527,7 +526,7 @@ export class FinosEKYCModule {
         pageSize: number = 10
     ): Promise<{ certs: ESignCertificate[] }> {
         this.validateSDKReady();
-        
+
         try {
             console.log('📋 Listing eSign certificates...');
             const result = await this.sdk.listCerts(pageNumber, pageSize);
@@ -545,7 +544,7 @@ export class FinosEKYCModule {
      */
     public async verifyCert(serial: string): Promise<{ code: string; message: string }> {
         this.validateSDKReady();
-        
+
         try {
             console.log('✅ Verifying eSign certificate...');
             const result = await this.sdk.verifyCert(serial);
@@ -567,7 +566,7 @@ export class FinosEKYCModule {
         pageSize: number = 10
     ): Promise<{ requests: ESignSignRequest[] }> {
         this.validateSDKReady();
-        
+
         try {
             console.log('📋 Listing eSign sign requests...');
             const result = await this.sdk.listSignRequest(pageNumber, pageSize);
@@ -595,7 +594,7 @@ export class FinosEKYCModule {
         confirm: boolean = true
     ): Promise<{ code: string; message: string }> {
         this.validateSDKReady();
-        
+
         try {
             console.log('✍️ Confirming eSign signature...');
             const result = await this.sdk.confirmSign(signRequestId, pinCode, authId, authData, confirm);
@@ -607,27 +606,7 @@ export class FinosEKYCModule {
         }
     }
 
-    /**
-     * Authenticate with eSign
-     * @param username eSign username
-     * @param password eSign password
-     */
-    public async authenticate(
-        username: string,
-        password: string
-    ): Promise<ESignAuthenticateResult> {
-        this.validateSDKReady();
-        
-        try {
-            console.log('🔐 Authenticating with eSign...');
-            const result = await this.sdk.authenticate(username, password);
-            console.log('✅ eSign authentication successful');
-            return result;
-        } catch (error) {
-            console.error('❌ eSign authentication failed:', error);
-            throw error;
-        }
-    }
+
 
     /**
      * Register remote signing certificate
@@ -635,14 +614,13 @@ export class FinosEKYCModule {
      * @param requestJson JSON request body
      */
     public async registerRemoteSigning(
-        accessToken: string,
         requestJson: string
     ): Promise<{ response: string }> {
         this.validateSDKReady();
-        
+
         try {
             console.log('📝 Registering remote signing certificate...');
-            const result = await this.sdk.registerRemoteSigning(accessToken, requestJson);
+            const result = await this.sdk.registerRemoteSigning(requestJson);
             console.log('✅ Remote signing certificate registered successfully');
             return result;
         } catch (error) {
@@ -657,14 +635,13 @@ export class FinosEKYCModule {
      * @param requestJson JSON request body
      */
     public async signPdf(
-        accessToken: string,
         requestJson: string
     ): Promise<{ response: string }> {
         this.validateSDKReady();
-        
+
         try {
             console.log('📄 Signing PDF document...');
-            const result = await this.sdk.signPdf(accessToken, requestJson);
+            const result = await this.sdk.signPdf(requestJson);
             console.log('✅ PDF document signed successfully');
             return result;
         } catch (error) {
@@ -679,14 +656,13 @@ export class FinosEKYCModule {
      * @param requestJson JSON string containing request data
      */
     public async sendConfirmationDocument(
-        accessToken: string,
         requestJson: string
     ): Promise<{ response: string }> {
         this.validateSDKReady();
-        
+
         try {
             console.log('📧 Sending confirmation document...');
-            const result = await this.sdk.sendConfirmationDocument(accessToken, requestJson);
+            const result = await this.sdk.sendConfirmationDocument(requestJson);
             console.log('✅ Confirmation document sent successfully');
             return result;
         } catch (error) {
@@ -724,9 +700,7 @@ export class FinosEKYCModule {
         return this.sdk.onESignConfirmSignSuccess(callback);
     }
 
-    public onESignAuthenticateSuccess(callback: (data: ESignAuthenticateResult) => void) {
-        return this.sdk.onESignAuthenticateSuccess(callback);
-    }
+
 
     public onESignRegisterRemoteSigningSuccess(callback: (data: { response: string }) => void) {
         return this.sdk.onESignRegisterRemoteSigningSuccess(callback);
@@ -812,7 +786,7 @@ export class FinosEKYCModule {
         }
     ): Promise<any> {
         this.validateSDKReady();
-        
+
         try {
             console.log('🚀 Starting eKYC UI with flow:', flowSDK);
             console.log('🔧 OptionConfig:', optionConfig);
@@ -821,7 +795,7 @@ export class FinosEKYCModule {
             }
             console.log('🔑 AppKeyConfig:', appKeyConfig);
             console.log('🎨 StyleConfig:', styleConfig);
-            
+
             const result = await this.sdk.startEkycUI(
                 appKey,
                 flowSDK,
@@ -880,58 +854,59 @@ const isMethod = (prop: string | symbol): boolean => {
     if (typeof prop !== 'string') return false;
     // Check if it's a known method from the class
     const prototype = FinosEKYCModule.prototype as any;
-    return typeof prototype[prop] === 'function' || 
-           prop.startsWith('on') || 
-           prop === 'initialize' || 
-           prop === 'startEkycUI' ||
-           prop === 'startNfcScan' ||
-           prop === 'checkC06' ||
-           prop === 'startOcr' ||
-           prop === 'startLiveness' ||
-           prop === 'startFaceCompare';
+    return typeof prototype[prop] === 'function' ||
+        prop.startsWith('on') ||
+        prop === 'initialize' ||
+        prop === 'openSessionId' ||
+        prop === 'startEkycUI' ||
+        prop === 'startNfcScan' ||
+        prop === 'checkC06' ||
+        prop === 'startOcr' ||
+        prop === 'startLiveness' ||
+        prop === 'startFaceCompare';
 };
 
 // Create a comprehensive stub object with all methods to prevent undefined errors
 const createFinosEKYCStub = (): FinosEKYCModule => {
     const stub = {} as any;
-    
+
     // Add all event listener methods (on* methods)
     const eventListenerMethods = [
         'onNfcScanStart', 'onNfcScanSuccess', 'onNfcError',
         'onC06Success', 'onC06Error',
-        'onOCRSuccess', 'onOCRError',
+        'onOcrSuccess', 'onOcrError',
         'onLivenessSuccess', 'onLivenessError',
         'onFaceCompareSuccess', 'onFaceCompareError',
         'onSmsOtpSendSuccess', 'onSmsOtpVerifySuccess', 'onSmsOtpResendSuccess', 'onSmsOtpError',
         'onESignInitSuccess', 'onESignOpenSessionSuccess', 'onESignRegisterDeviceSuccess',
         'onESignListCertsSuccess', 'onESignVerifyCertSuccess', 'onESignListSignRequestSuccess',
-        'onESignConfirmSignSuccess', 'onESignAuthenticateSuccess', 'onESignRegisterRemoteSigningSuccess',
+        'onESignConfirmSignSuccess', 'onESignRegisterRemoteSigningSuccess',
         'onESignSignPdfSuccess', 'onESignSendConfirmationDocumentSuccess', 'onESignError'
     ];
-    
+
     eventListenerMethods.forEach(method => {
         stub[method] = (callback?: any) => {
             console.warn(`⚠️ FinosEKYC.${method} called but module is not initialized`);
             return null;
         };
     });
-    
+
     // Add all other methods
     const otherMethods = [
-        'initialize', 'startNfcScan', 'checkC06', 'startOCR', 'startLiveness', 'startFaceCompare',
+        'initialize', 'startNfcScan', 'checkC06', 'startOcr', 'startLiveness', 'startFaceCompare',
         'startEkycUI', 'sendOtp', 'verifyOtp', 'resendOtp', 'initializeESign', 'openSessionId',
         'registerDevice', 'listCerts', 'verifyCert', 'listSignRequest', 'confirmSign',
-        'authenticate', 'registerRemoteSigning', 'signPdf', 'sendConfirmationDocument',
+        'registerRemoteSigning', 'signPdf', 'sendConfirmationDocument',
         'onResume', 'onPause', 'isSDKReady', 'getSDKInfo'
     ];
-    
+
     otherMethods.forEach(method => {
         stub[method] = async (...args: any[]) => {
             console.warn(`⚠️ FinosEKYC.${method} called but module is not initialized`);
             throw new Error(`FinosEKYC.${method} is not available. Module may not be initialized.`);
         };
     });
-    
+
     return stub as FinosEKYCModule;
 };
 
@@ -981,18 +956,18 @@ const createFinosEKYCWrapper = (): FinosEKYCModule => {
     // Always start with stub to ensure all methods exist
     const stub = createFinosEKYCStub();
     const wrapper = { ...stub } as any;
-    
+
     // Try to get real instance and override methods
     try {
         const realInstance = getFinosEKYCInstance();
-        
+
         // Override with real instance methods
         Object.getOwnPropertyNames(Object.getPrototypeOf(realInstance)).forEach(key => {
             if (key !== 'constructor' && typeof (realInstance as any)[key] === 'function') {
                 wrapper[key] = ((realInstance as any)[key]).bind(realInstance);
             }
         });
-        
+
         // Also copy any own properties from real instance
         Object.keys(realInstance).forEach(key => {
             if ((realInstance as any)[key] !== undefined) {
@@ -1003,7 +978,7 @@ const createFinosEKYCWrapper = (): FinosEKYCModule => {
         // If we can't get instance, wrapper already has all stub methods
         // No need to do anything
     }
-    
+
     return wrapper as FinosEKYCModule;
 };
 
@@ -1015,10 +990,11 @@ export type { NfcConfig, NfcError } from '../types/ekycNFCType';
 export type { C06Config } from '../types/ekycC06Type';
 export type { OcrConfig } from '../types/ekycOCRType';
 export type { LivenessConfig } from '../types/ekycLivenessType';
+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 };