@finos_sdk/sdk-ekyc 1.5.2 → 1.5.3

package/android/build.gradle

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

@@ -565,6 +565,28 @@ class EKYCModule(reactContext: ReactApplicationContext) : ReactContextBaseJavaMo
             .emit(eventName, params)
     }
 
+    private fun WritableMap.putCustomData(customData: Map<*, *>?) {
+        customData?.forEach { (key, value) ->
+            val k = key.toString()
+            when (value) {
+                is Boolean -> putBoolean(k, value)
+                is Int     -> putInt(k, value)
+                is Long    -> putInt(k, value.toInt())
+                is Double  -> putDouble(k, value)
+                else -> {
+                    val str = value.toString()
+                    val intVal = str.toIntOrNull()
+                    val boolVal = str.lowercase().toBooleanStrictOrNull()
+                    when {
+                        boolVal != null -> putBoolean(k, boolVal)
+                        intVal != null  -> putInt(k, intVal)
+                        else            -> putString(k, str)
+                    }
+                }
+            }
+        }
+    }
+
     /**
      * Helper function to create separate maps for event and promise to avoid "Map already consumed" error
      * @param builder Lambda function to build the map content
@@ -1891,14 +1913,7 @@ class EKYCModule(reactContext: ReactApplicationContext) : ReactContextBaseJavaMo
                 callbackSuccess = { event, result ->
                     Log.d(TAG, "✅ sendOtp() success")
                     val (eventMap, promiseMap) = createSeparateMaps { map ->
-                        map.putString("event", event.name.toString())
-                        result?.let {
-                            val dataMap = Arguments.createMap()
-                            it.customData?.forEach { (key, value) ->
-                                dataMap.putString(key, value.toString())
-                            }
-                            map.putMap("data", dataMap)
-                        }
+                        map.putCustomData(result?.customData)
                     }
                     sendEvent("onSmsOtpSendSuccess", eventMap)
                     promise.resolve(promiseMap)
@@ -1952,14 +1967,7 @@ class EKYCModule(reactContext: ReactApplicationContext) : ReactContextBaseJavaMo
                 callbackSuccess = { event, result ->
                     Log.d(TAG, "✅ verifyOtp() success")
                     val (eventMap, promiseMap) = createSeparateMaps { map ->
-                        map.putString("event", event.name.toString())
-                        result?.let {
-                            val dataMap = Arguments.createMap()
-                            it.customData?.forEach { (key, value) ->
-                                dataMap.putString(key, value.toString())
-                            }
-                            map.putMap("data", dataMap)
-                        }
+                        map.putCustomData(result?.customData)
                     }
                     sendEvent("onSmsOtpVerifySuccess", eventMap)
                     promise.resolve(promiseMap)
@@ -2011,14 +2019,7 @@ class EKYCModule(reactContext: ReactApplicationContext) : ReactContextBaseJavaMo
                 callbackSuccess = { event, result ->
                     Log.d(TAG, "✅ resendOtp() success")
                     val (eventMap, promiseMap) = createSeparateMaps { map ->
-                        map.putString("event", event.name.toString())
-                        result?.let {
-                            val dataMap = Arguments.createMap()
-                            it.customData?.forEach { (key, value) ->
-                                dataMap.putString(key, value.toString())
-                            }
-                            map.putMap("data", dataMap)
-                        }
+                        map.putCustomData(result?.customData)
                     }
                     sendEvent("onSmsOtpResendSuccess", eventMap)
                     promise.resolve(promiseMap)

package/dist/EKYCModule.d.ts

@@ -5,7 +5,7 @@ import { C06Config } from './src/types/ekycC06Type';
 import { OcrConfig } from './src/types/ekycOCRType';
 import { LivenessConfig, SDKFaceDetectStatus, LivenessSuccessEvent } from './src/types/ekycLivenessType';
 import { FaceServiceConfig, FaceCompareSuccessEvent } from './src/types/ekycFaceType';
-import { SmsOtpConfig, SmsOtpResult, SmsOtpError } from './src/types/ekycSmsOtpType';
+import { SmsOtpConfig, SmsOtpError, SendOtpResponse, VerifyOtpResponse, ResendOtpResponse } from './src/types/ekycSmsOtpType';
 import { ESignInitResult, ESignOpenSessionResult, ESignCertificate, ESignSignRequest, ESignError, AuthorizeInfo, ESignPdfResult, ESignApiResponse } from './src/types/ekycESignType';
 import { ExitConfirmConfig } from './src/types/ekycExitConfirmType';
 export declare const SDK_VERSION: string;
@@ -48,12 +48,12 @@ declare class SDKeKYC {
     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>;
-    resendOtp(config: SmsOtpConfig): Promise<SmsOtpResult>;
-    onSmsOtpSendSuccess(callback: (data: SmsOtpResult) => void): EmitterSubscription | null;
-    onSmsOtpVerifySuccess(callback: (data: SmsOtpResult) => void): EmitterSubscription | null;
-    onSmsOtpResendSuccess(callback: (data: SmsOtpResult) => void): EmitterSubscription | null;
+    sendOtp(config: SmsOtpConfig): Promise<SendOtpResponse>;
+    verifyOtp(config: SmsOtpConfig, otpCode: string): Promise<VerifyOtpResponse>;
+    resendOtp(config: SmsOtpConfig): Promise<ResendOtpResponse>;
+    onSmsOtpSendSuccess(callback: (data: SendOtpResponse) => void): EmitterSubscription | null;
+    onSmsOtpVerifySuccess(callback: (data: VerifyOtpResponse) => void): EmitterSubscription | null;
+    onSmsOtpResendSuccess(callback: (data: ResendOtpResponse) => void): EmitterSubscription | null;
     onSmsOtpError(callback: (error: SmsOtpError) => void): EmitterSubscription | null;
     initializeESign(finosToken?: string | null, isProd?: boolean): Promise<ESignInitResult>;
     getSdkToken(identity: string, name: string, deviceId: string): Promise<string>;

package/dist/dist/package.json

@@ -0,0 +1,86 @@
+{
+    "name": "@finos_sdk/sdk-ekyc",
+    "version": "1.5.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",
+    "files": [
+        "dist",
+        "react-native.config.js",
+        "android/src/main/java",
+        "android/build.gradle",
+        "android/settings.gradle",
+        "android/gradle.properties",
+        "android/gradle/wrapper/**",
+        "android/gradlew",
+        "android/gradlew.bat",
+        "android/consumer-rules.pro",
+        "ios/**",
+        "finos-ekyc-sdk.podspec",
+        "src/**"
+    ],
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/finosvn/finos.ekyc.sdk.git"
+    },
+    "author": "FinOS",
+    "license": "MIT",
+    "bugs": {
+        "url": "https://github.com/finosvn/finos.ekyc.sdk/issues"
+    },
+    "homepage": "https://github.com/finosvn/finos.ekyc.sdk#readme",
+    "keywords": [
+        "react-native",
+        "ekyc",
+        "nfc",
+        "ocr",
+        "liveness",
+        "face-matching",
+        "vietnamese",
+        "cccd",
+        "identity-verification",
+        "finos-sdk",
+        "android",
+        "typescript"
+    ],
+    "scripts": {
+        "clear": "rm -rf node_modules dist package-lock.json && npm cache clean --force && (cd android && ./gradlew clean 2>/dev/null) || true",
+        "npm-install": "npm install",
+        "npm-install-legacy": "npm install --legacy-peer-deps",
+        "build": "tsc && mkdir -p dist && cp package.json dist/",
+        "publish-sdk-local": "npm run build && npm pack",
+        "publish-sdk": "npm run build && npm publish --access public",
+        "publish-sdk-version": "npm run build && npm version patch --force && npm publish --access public"
+    },
+    "peerDependencies": {
+        "react": ">=18.0.0",
+        "react-native": ">=0.70.0"
+    },
+    "dependencies": {
+        "reflect-metadata": "^0.2.1",
+        "tsyringe": "^4.10.0"
+    },
+    "devDependencies": {
+        "@babel/core": "^7.25.2",
+        "@babel/preset-env": "^7.25.3",
+        "@babel/runtime": "^7.25.0",
+        "@react-native-community/cli": "16.0.3",
+        "@react-native/babel-preset": "0.77.0",
+        "@react-native/eslint-config": "0.77.0",
+        "@react-native/metro-config": "0.77.0",
+        "@react-native/typescript-config": "0.77.0",
+        "@types/react": "18.2.6",
+        "@types/react-test-renderer": "18.0.0",
+        "babel-jest": "^29.6.3",
+        "eslint": "^8.19.0",
+        "jest": "^29.6.3",
+        "prettier": "2.8.8",
+        "react": "18.2.0",
+        "react-native": "0.73.0",
+        "react-test-renderer": "18.2.0",
+        "typescript": "^5.0.4"
+    },
+    "engines": {
+        "node": ">=18"
+    }
+}

package/dist/package.json

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

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

@@ -5,7 +5,7 @@ import { C06Config } from '../types/ekycC06Type';
 import { OcrConfig } from '../types/ekycOCRType';
 import { LivenessConfig, SDKFaceDetectStatus, LivenessSuccessEvent } from '../types/ekycLivenessType';
 import { FaceServiceConfig, FaceCompareSuccessEvent } from '../types/ekycFaceType';
-import { SmsOtpConfig, SmsOtpResult } from '../types/ekycSmsOtpType';
+import { SmsOtpConfig, SendOtpResponse, VerifyOtpResponse, ResendOtpResponse } from '../types/ekycSmsOtpType';
 import { ESignInitResult, ESignOpenSessionResult, ESignCertificate, ESignSignRequest, ESignPdfResult, ESignApiResponse } from '../types/ekycESignType';
 import { SDKFlowType } from '../types/ekycFlowType';
 import { ExitConfirmConfig } from '../types/ekycExitConfirmType';
@@ -164,20 +164,20 @@ export declare class FinosEKYCModule {
      * Send SMS OTP
      * @param config SMS OTP configuration
      */
-    sendOtp(config: SmsOtpConfig): Promise<SmsOtpResult>;
+    sendOtp(config: SmsOtpConfig): Promise<SendOtpResponse>;
     /**
      * Verify SMS OTP
      * @param config SMS OTP configuration (must include requestId)
      * @param otpCode OTP code from SMS
      */
-    verifyOtp(config: SmsOtpConfig, otpCode: string): Promise<SmsOtpResult>;
+    verifyOtp(config: SmsOtpConfig, otpCode: string): Promise<VerifyOtpResponse>;
     /**
      * Resend SMS OTP
      * @param config SMS OTP configuration (must include requestId)
      */
-    resendOtp(config: SmsOtpConfig): Promise<SmsOtpResult>;
-    onSmsOtpSendSuccess(callback: (data: SmsOtpResult) => void): import("react-native").EmitterSubscription | null;
-    onSmsOtpResendSuccess(callback: (data: SmsOtpResult) => void): import("react-native").EmitterSubscription | null;
+    resendOtp(config: SmsOtpConfig): Promise<ResendOtpResponse>;
+    onSmsOtpSendSuccess(callback: (data: SendOtpResponse) => void): import("react-native").EmitterSubscription | null;
+    onSmsOtpResendSuccess(callback: (data: ResendOtpResponse) => void): import("react-native").EmitterSubscription | null;
     /** Payload là EKYCError: { event, code, message }. */
     onSmsOtpError(callback: (error: EKYCError) => void): import("react-native").EmitterSubscription | null;
     /**
@@ -375,7 +375,7 @@ export { SDKFaceDetectStatus } from '../types/ekycLivenessType';
 export type { FaceServiceConfig, FaceCompareError } from '../types/ekycFaceType';
 export type { SDKEkycResultWithEvent, SDKEkycResultStringWithEvent, EKYCError } from '../types/ekycType';
 export { getEkycError, AppIDType } from '../types/ekycType';
-export type { SmsOtpConfig, SmsOtpResult, SmsOtpError } from '../types/ekycSmsOtpType';
+export type { SmsOtpConfig, SmsOtpResult, SmsOtpError, SendOtpResponse, VerifyOtpResponse, ResendOtpResponse } from '../types/ekycSmsOtpType';
 export type { ESignInitResult, ESignOpenSessionResult, ESignCertificate, ESignSignRequest, ESignError, ESignAuthenticateResult } from '../types/ekycESignType';
 export { SDK_VERSION, SDK_NAME };
 export default FinosEKYC;

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

@@ -1,5 +1,5 @@
 import { SDK_VERSION, SDK_NAME } from '../../EKYCModule';
-import { SmsOtpConfig, SmsOtpResult } from '../types/ekycSmsOtpType';
+import { SmsOtpConfig, SendOtpResponse, VerifyOtpResponse, ResendOtpResponse } from '../types/ekycSmsOtpType';
 import { ESignInitResult, ESignOpenSessionResult, ESignCertificate, ESignSignRequest, AuthorizeInfo, ESignPdfResult, ESignApiResponse } from '../types/ekycESignType';
 import { LivenessConfig, LivenessSuccessEvent } from '../types/ekycLivenessType';
 import { FaceServiceConfig, FaceCompareSuccessEvent } from '../types/ekycFaceType';
@@ -47,21 +47,21 @@ export declare class FinosESignModule {
      * Send SMS OTP
      * @param config SMS OTP configuration
      */
-    sendOtp(config: SmsOtpConfig): Promise<SmsOtpResult>;
+    sendOtp(config: SmsOtpConfig): Promise<SendOtpResponse>;
     /**
      * Verify SMS OTP
      * @param config SMS OTP configuration (must include requestId)
      * @param otpCode OTP code from SMS
      */
-    verifyOtp(config: SmsOtpConfig, otpCode: string): Promise<SmsOtpResult>;
+    verifyOtp(config: SmsOtpConfig, otpCode: string): Promise<VerifyOtpResponse>;
     /**
      * Resend SMS OTP
      * @param config SMS OTP configuration (must include requestId)
      */
-    resendOtp(config: SmsOtpConfig): Promise<SmsOtpResult>;
-    onSmsOtpSendSuccess(callback: (data: SmsOtpResult) => void): import("react-native").EmitterSubscription | null;
-    onSmsOtpVerifySuccess(callback: (data: SmsOtpResult) => void): import("react-native").EmitterSubscription | null;
-    onSmsOtpResendSuccess(callback: (data: SmsOtpResult) => void): import("react-native").EmitterSubscription | null;
+    resendOtp(config: SmsOtpConfig): Promise<ResendOtpResponse>;
+    onSmsOtpSendSuccess(callback: (data: SendOtpResponse) => void): import("react-native").EmitterSubscription | null;
+    onSmsOtpVerifySuccess(callback: (data: VerifyOtpResponse) => void): import("react-native").EmitterSubscription | null;
+    onSmsOtpResendSuccess(callback: (data: ResendOtpResponse) => void): import("react-native").EmitterSubscription | null;
     /** Payload là EKYCError: { event, code, message }. */
     onSmsOtpError(callback: (error: EKYCError) => void): import("react-native").EmitterSubscription | null;
     /**
@@ -329,7 +329,7 @@ export declare class FinosESignModule {
     private validateSDKReady;
 }
 export declare const FinosESign: FinosESignModule;
-export type { SmsOtpConfig, SmsOtpResult, SmsOtpError } from '../types/ekycSmsOtpType';
+export type { SmsOtpConfig, SmsOtpResult, SmsOtpError, SendOtpResponse, VerifyOtpResponse, ResendOtpResponse } from '../types/ekycSmsOtpType';
 export type { ESignInitResult, ESignOpenSessionResult, ESignCertificate, ESignSignRequest, ESignError, ESignAuthenticateResult, AuthorizeInfo, ESignApiResponse } from '../types/ekycESignType';
 export type { LivenessConfig, LivenessError } from '../types/ekycLivenessType';
 export { SDKFaceDetectStatus } from '../types/ekycLivenessType';

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

@@ -26,16 +26,10 @@ export interface SmsOtpConfig {
 /** SMS OTP error – dùng chung EKYCError (event, code, message). */
 export type SmsOtpError = import('./ekycType').EKYCError;
 /**
- * SMS OTP Success Result
+ * @deprecated Use SendOtpResponse, VerifyOtpResponse, or ResendOtpResponse instead.
  */
 export interface SmsOtpResult {
-    /**
-     * Event type
-     */
     event: string;
-    /**
-     * Response data
-     */
     data?: {
         requestId?: string;
         expiresIn?: string;
@@ -43,3 +37,30 @@ export interface SmsOtpResult {
         [key: string]: any;
     };
 }
+interface BaseOtpResponse {
+    success?: boolean;
+    requestId?: string;
+    expiresIn?: number;
+    resendAfter?: number;
+    error?: string;
+}
+export interface SendOtpResponse extends BaseOtpResponse {
+}
+export interface VerifyOtpResponse {
+    success?: boolean;
+    verified?: boolean;
+    verifiedAt?: string;
+    attemptsRemaining?: number;
+    error?: string;
+}
+export interface ResendOtpResponse extends BaseOtpResponse {
+    attemptsRemaining?: number;
+    statusCode?: number;
+    errorCode?: string;
+    message?: string;
+    retryAfter?: number;
+    retryAt?: string;
+    cooldownSeconds?: number;
+    elapsedSeconds?: number;
+}
+export {};

package/ios/.xcode.env.local

@@ -0,0 +1,2 @@
+export NODE_BINARY=/opt/homebrew/bin/node
+

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@finos_sdk/sdk-ekyc",
-  "version": "1.5.2",
+  "version": "1.5.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

@@ -7,7 +7,7 @@ import { C06Config } from '../types/ekycC06Type';
 import { OcrConfig, OcrError } from '../types/ekycOCRType';
 import { LivenessConfig, SDKFaceDetectStatus, LivenessError, LivenessSuccessEvent } from '../types/ekycLivenessType';
 import { FaceServiceConfig, FaceCompareError, FaceCompareSuccessEvent } from '../types/ekycFaceType';
-import { SmsOtpConfig, SmsOtpResult, SmsOtpError } from '../types/ekycSmsOtpType';
+import { SmsOtpConfig, SmsOtpResult, SmsOtpError, SendOtpResponse, VerifyOtpResponse, ResendOtpResponse } from '../types/ekycSmsOtpType';
 import { ESignInitResult, ESignOpenSessionResult, ESignCertificate, ESignSignRequest, ESignError, ESignAuthenticateResult, ESignPdfResult, ESignApiResponse } from '../types/ekycESignType';
 import { SDKFlowType, flowToStrings } from '../types/ekycFlowType';
 import { ExitConfirmConfig } from '../types/ekycExitConfirmType';
@@ -404,7 +404,7 @@ export class FinosEKYCModule {
      * Send SMS OTP
      * @param config SMS OTP configuration
      */
-    public async sendOtp(config: SmsOtpConfig): Promise<SmsOtpResult> {
+    public async sendOtp(config: SmsOtpConfig): Promise<SendOtpResponse> {
         this.validateSDKReady();
 
         try {
@@ -423,7 +423,7 @@ export class FinosEKYCModule {
      * @param config SMS OTP configuration (must include requestId)
      * @param otpCode OTP code from SMS
      */
-    public async verifyOtp(config: SmsOtpConfig, otpCode: string): Promise<SmsOtpResult> {
+    public async verifyOtp(config: SmsOtpConfig, otpCode: string): Promise<VerifyOtpResponse> {
         this.validateSDKReady();
 
         try {
@@ -441,7 +441,7 @@ export class FinosEKYCModule {
      * Resend SMS OTP
      * @param config SMS OTP configuration (must include requestId)
      */
-    public async resendOtp(config: SmsOtpConfig): Promise<SmsOtpResult> {
+    public async resendOtp(config: SmsOtpConfig): Promise<ResendOtpResponse> {
         this.validateSDKReady();
 
         try {
@@ -456,7 +456,7 @@ export class FinosEKYCModule {
     }
 
     // SMS OTP Event Listeners
-    public onSmsOtpSendSuccess(callback: (data: SmsOtpResult) => void) {
+    public onSmsOtpSendSuccess(callback: (data: SendOtpResponse) => void) {
         const listener = this.sdk.onSmsOtpSendSuccess(callback);
         if (!listener) {
             console.warn('⚠️ onSmsOtpSendSuccess: Event emitter not ready. Make sure SDK is initialized.');
@@ -464,7 +464,7 @@ export class FinosEKYCModule {
         return listener;
     }
 
-    public onSmsOtpResendSuccess(callback: (data: SmsOtpResult) => void) {
+    public onSmsOtpResendSuccess(callback: (data: ResendOtpResponse) => void) {
         const listener = this.sdk.onSmsOtpResendSuccess(callback);
         if (!listener) {
             console.warn('⚠️ onSmsOtpResendSuccess: Event emitter not ready.');
@@ -1049,7 +1049,7 @@ export { SDKFaceDetectStatus } from '../types/ekycLivenessType';
 export type { FaceServiceConfig, FaceCompareError } from '../types/ekycFaceType';
 export type { SDKEkycResultWithEvent, SDKEkycResultStringWithEvent, EKYCError } from '../types/ekycType';
 export { getEkycError, AppIDType } from '../types/ekycType';
-export type { SmsOtpConfig, SmsOtpResult, SmsOtpError } from '../types/ekycSmsOtpType';
+export type { SmsOtpConfig, SmsOtpResult, SmsOtpError, SendOtpResponse, VerifyOtpResponse, ResendOtpResponse } from '../types/ekycSmsOtpType';
 export type { ESignInitResult, ESignOpenSessionResult, ESignCertificate, ESignSignRequest, ESignError, ESignAuthenticateResult } from '../types/ekycESignType';
 
 // Export constants

package/src/modules/FinosESignModule.ts

@@ -1,6 +1,6 @@
 import { Platform } from 'react-native';
 import sdkEKYC, { SDKeKYC, SDK_VERSION, SDK_NAME } from '../../EKYCModule';
-import { SmsOtpConfig, SmsOtpResult, SmsOtpError } from '../types/ekycSmsOtpType';
+import { SmsOtpConfig, SmsOtpResult, SmsOtpError, SendOtpResponse, VerifyOtpResponse, ResendOtpResponse } from '../types/ekycSmsOtpType';
 import { ESignInitResult, ESignOpenSessionResult, ESignCertificate, ESignSignRequest, ESignError, ESignAuthenticateResult, AuthorizeInfo, ESignPdfResult, ESignApiResponse } from '../types/ekycESignType';
 import { LivenessConfig, LivenessError, LivenessSuccessEvent } from '../types/ekycLivenessType';
 import { FaceServiceConfig, FaceCompareError, FaceCompareSuccessEvent } from '../types/ekycFaceType';
@@ -113,7 +113,7 @@ export class FinosESignModule {
      * Send SMS OTP
      * @param config SMS OTP configuration
      */
-    public async sendOtp(config: SmsOtpConfig): Promise<SmsOtpResult> {
+    public async sendOtp(config: SmsOtpConfig): Promise<SendOtpResponse> {
         this.validateSDKReady();
         // Pass through to SDK - error handling is done in EKYCModule.ts
         return await this.sdk.sendOtp(config);
@@ -124,7 +124,7 @@ export class FinosESignModule {
      * @param config SMS OTP configuration (must include requestId)
      * @param otpCode OTP code from SMS
      */
-    public async verifyOtp(config: SmsOtpConfig, otpCode: string): Promise<SmsOtpResult> {
+    public async verifyOtp(config: SmsOtpConfig, otpCode: string): Promise<VerifyOtpResponse> {
         this.validateSDKReady();
         // Pass through to SDK - error handling is done in EKYCModule.ts
         return await this.sdk.verifyOtp(config, otpCode);
@@ -134,14 +134,14 @@ export class FinosESignModule {
      * Resend SMS OTP
      * @param config SMS OTP configuration (must include requestId)
      */
-    public async resendOtp(config: SmsOtpConfig): Promise<SmsOtpResult> {
+    public async resendOtp(config: SmsOtpConfig): Promise<ResendOtpResponse> {
         this.validateSDKReady();
         // Pass through to SDK - error handling is done in EKYCModule.ts
         return await this.sdk.resendOtp(config);
     }
 
     // SMS OTP Event Listeners
-    public onSmsOtpSendSuccess(callback: (data: SmsOtpResult) => void) {
+    public onSmsOtpSendSuccess(callback: (data: SendOtpResponse) => void) {
         const listener = this.sdk.onSmsOtpSendSuccess(callback);
         if (!listener) {
             console.warn('⚠️ onSmsOtpSendSuccess: Event emitter not ready. Make sure SDK is initialized.');
@@ -149,7 +149,7 @@ export class FinosESignModule {
         return listener;
     }
 
-    public onSmsOtpVerifySuccess(callback: (data: SmsOtpResult) => void) {
+    public onSmsOtpVerifySuccess(callback: (data: VerifyOtpResponse) => void) {
         const listener = this.sdk.onSmsOtpVerifySuccess(callback);
         if (!listener) {
             console.warn('⚠️ onSmsOtpVerifySuccess: Event emitter not ready.');
@@ -157,7 +157,7 @@ export class FinosESignModule {
         return listener;
     }
 
-    public onSmsOtpResendSuccess(callback: (data: SmsOtpResult) => void) {
+    public onSmsOtpResendSuccess(callback: (data: ResendOtpResponse) => void) {
         const listener = this.sdk.onSmsOtpResendSuccess(callback);
         if (!listener) {
             console.warn('⚠️ onSmsOtpResendSuccess: Event emitter not ready.');
@@ -892,7 +892,7 @@ const createFinosESignWrapper = (): FinosESignModule => {
 export const FinosESign = createFinosESignWrapper();
 
 // Export types
-export type { SmsOtpConfig, SmsOtpResult, SmsOtpError } from '../types/ekycSmsOtpType';
+export type { SmsOtpConfig, SmsOtpResult, SmsOtpError, SendOtpResponse, VerifyOtpResponse, ResendOtpResponse } from '../types/ekycSmsOtpType';
 export type { ESignInitResult, ESignOpenSessionResult, ESignCertificate, ESignSignRequest, ESignError, ESignAuthenticateResult, AuthorizeInfo, ESignApiResponse } from '../types/ekycESignType';
 export type { LivenessConfig, LivenessError } from '../types/ekycLivenessType';
 export { SDKFaceDetectStatus } from '../types/ekycLivenessType';

package/src/types/ekycSmsOtpType.ts

@@ -32,17 +32,10 @@ export interface SmsOtpConfig {
 export type SmsOtpError = import('./ekycType').EKYCError;
 
 /**
- * SMS OTP Success Result
+ * @deprecated Use SendOtpResponse, VerifyOtpResponse, or ResendOtpResponse instead.
  */
 export interface SmsOtpResult {
-  /**
-   * Event type
-   */
   event: string;
-
-  /**
-   * Response data
-   */
   data?: {
     requestId?: string;
     expiresIn?: string;
@@ -50,3 +43,32 @@ export interface SmsOtpResult {
     [key: string]: any;
   };
 }
+
+interface BaseOtpResponse {
+  success?: boolean;
+  requestId?: string;
+  expiresIn?: number;
+  resendAfter?: number;
+  error?: string;
+}
+
+export interface SendOtpResponse extends BaseOtpResponse {}
+
+export interface VerifyOtpResponse {
+  success?: boolean;
+  verified?: boolean;
+  verifiedAt?: string;
+  attemptsRemaining?: number;
+  error?: string;
+}
+
+export interface ResendOtpResponse extends BaseOtpResponse {
+  attemptsRemaining?: number;
+  statusCode?: number;
+  errorCode?: string;
+  message?: string;
+  retryAfter?: number;
+  retryAt?: string;
+  cooldownSeconds?: number;
+  elapsedSeconds?: number;
+}