@hexar/biometric-identity-sdk-core 1.0.5 → 1.0.7

package/dist/api/BackendClient.d.ts

@@ -124,6 +124,7 @@ export interface BackendClientConfig {
 export declare class BackendClient {
     private config;
     private currentSessionId;
+    private sdkSessionId;
     constructor(config: BackendClientConfig);
     /**
      * Check if the backend is available
@@ -137,6 +138,7 @@ export declare class BackendClient {
      * Validate liveness from video frames
      */
     validateLiveness(videoFrames: string[], videoDurationMs: number, challengesCompleted?: string[], deviceInfo?: Record<string, any>): Promise<LivenessResponse>;
+    private generateSDKSessionId;
     /**
      * Compare faces between document and live capture
      */

package/dist/api/BackendClient.js

@@ -11,11 +11,13 @@ exports.BackendClient = void 0;
 class BackendClient {
     constructor(config) {
         this.currentSessionId = null;
+        this.sdkSessionId = null;
         this.config = {
-            apiEndpoint: config.apiEndpoint.replace(/\/$/, ''), // Remove trailing slash
+            apiEndpoint: config.apiEndpoint.replace(/\/$/, ''),
             apiKey: config.apiKey,
             timeout: config.timeout || 60000,
         };
+        this.sdkSessionId = this.generateSDKSessionId();
     }
     /**
      * Check if the backend is available
@@ -48,14 +50,16 @@ class BackendClient {
         if (!this.currentSessionId) {
             throw new Error('No active session. Call generateChallenge() first.');
         }
-        const response = await this.request('/api/v1/liveness/validate', 'POST', {
+        return this.request('/api/v1/liveness/validate', 'POST', {
             session_id: this.currentSessionId,
             video_frames: videoFrames,
             video_duration_ms: videoDurationMs,
             challenges_completed: challengesCompleted,
             device_info: deviceInfo,
         });
-        return response;
+    }
+    generateSDKSessionId() {
+        return `sdk-${Date.now()}-${Math.random().toString(36).substr(2, 9)}`;
     }
     /**
      * Compare faces between document and live capture
@@ -159,6 +163,7 @@ class BackendClient {
      */
     resetSession() {
         this.currentSessionId = null;
+        this.sdkSessionId = this.generateSDKSessionId();
     }
     /**
      * Make HTTP request to backend
@@ -167,13 +172,17 @@ class BackendClient {
         const url = `${this.config.apiEndpoint}${endpoint}`;
         const controller = new AbortController();
         const timeoutId = setTimeout(() => controller.abort(), this.config.timeout);
+        const headers = {
+            'Content-Type': 'application/json',
+            'X-API-Key': this.config.apiKey,
+        };
+        if (this.sdkSessionId) {
+            headers['X-SDK-Session-ID'] = this.sdkSessionId;
+        }
         try {
             const response = await fetch(url, {
                 method,
-                headers: {
-                    'Content-Type': 'application/json',
-                    'X-API-Key': this.config.apiKey,
-                },
+                headers,
                 body: body ? JSON.stringify(body) : undefined,
                 signal: controller.signal,
             });

package/dist/i18n/languages/en.js

@@ -10,6 +10,7 @@ exports.en = {
         continue: 'Continue',
         close: 'Close',
         done: 'Done',
+        grantPermission: 'Grant Permission',
     },
     initialization: {
         initializing: 'Initializing...',
@@ -35,11 +36,13 @@ exports.en = {
             title: 'Front of ID',
             instruction: 'Position the front of your ID within the frame',
             button: 'Capture Front ID',
+            tips: '• Ensure good lighting\n• Avoid glare and shadows\n• Keep document flat and complete',
         },
         backId: {
             title: 'Back of ID',
             instruction: 'Position the back of your ID within the frame',
             button: 'Capture Back ID',
+            tips: '• Ensure good lighting\n• Avoid glare and shadows\n• Keep document flat and complete',
         },
         selfie: {
             title: 'Face Photo',
@@ -50,6 +53,9 @@ exports.en = {
     liveness: {
         title: 'Face Verification',
         preparing: 'Preparing verification...',
+        getReady: 'Get Ready!',
+        countdownMessage: 'You\'ll perform actions.\nFollow the on-screen instructions.',
+        recordingInstructions: 'Keep your face visible and follow the instructions',
         instructions: {
             lookLeft: 'Look to the left',
             lookRight: 'Look to the right',
@@ -60,6 +66,7 @@ exports.en = {
             turnHeadLeft: 'Turn your head to the left',
             turnHeadRight: 'Turn your head to the right',
             stayStill: 'Stay still',
+            openMouth: 'Open your mouth slightly',
         },
         recording: 'Recording...',
         processing: 'Processing video...',
@@ -85,7 +92,10 @@ exports.en = {
         },
     },
     errors: {
-        cameraPermissionDenied: 'Camera permission denied. Please enable camera access in settings.',
+        cameraPermissionDenied: {
+            title: 'Camera Permission Required',
+            message: 'Camera permission denied. Please enable camera access in settings.',
+        },
         cameraNotAvailable: 'Camera not available.',
         faceNotDetected: 'Face not detected. Please position your face clearly.',
         multipleFacesDetected: 'Multiple faces detected. Only one person should be in frame.',
@@ -97,6 +107,10 @@ exports.en = {
         networkError: 'Network error. Please check your connection.',
         timeout: 'Request timeout. Please try again.',
         unknownError: 'An unexpected error occurred.',
+        videoTooShort: {
+            title: 'Recording Too Short',
+            message: 'Video must be at least 8 seconds. Please try again.',
+        },
     },
     badges: {
         secureVerification: 'Secure AI Verification',

package/dist/i18n/languages/es-AR.js

@@ -10,6 +10,7 @@ exports.esAR = {
         continue: 'Continuar',
         close: 'Cerrar',
         done: 'Listo',
+        grantPermission: 'Otorgar Permiso',
     },
     initialization: {
         initializing: 'Iniciando...',
@@ -35,11 +36,13 @@ exports.esAR = {
             title: 'Frente del Documento',
             instruction: 'Posicioná el frente de tu documento dentro del marco',
             button: 'Capturar Frente',
+            tips: '• Asegurate de tener buena iluminación\n• Evitá brillos y sombras\n• Mantené el documento plano y completo',
         },
         backId: {
             title: 'Dorso del Documento',
             instruction: 'Posicioná el dorso de tu documento dentro del marco',
             button: 'Capturar Dorso',
+            tips: '• Asegurate de tener buena iluminación\n• Evitá brillos y sombras\n• Mantené el documento plano y completo',
         },
         selfie: {
             title: 'Foto de Rostro',
@@ -50,6 +53,9 @@ exports.esAR = {
     liveness: {
         title: 'Verificación Facial',
         preparing: 'Preparando verificación...',
+        getReady: '¡Prepárate!',
+        countdownMessage: 'Vas a realizar acciones.\nSeguí las instrucciones en pantalla.',
+        recordingInstructions: 'Mantené tu rostro visible y seguí las instrucciones',
         instructions: {
             lookLeft: 'Mirá a la izquierda',
             lookRight: 'Mirá a la derecha',
@@ -60,6 +66,7 @@ exports.esAR = {
             turnHeadLeft: 'Girá tu cabeza a la izquierda',
             turnHeadRight: 'Girá tu cabeza a la derecha',
             stayStill: 'Quedate quieto',
+            openMouth: 'Abrí la boca ligeramente',
         },
         recording: 'Grabando...',
         processing: 'Procesando video...',
@@ -85,7 +92,10 @@ exports.esAR = {
         },
     },
     errors: {
-        cameraPermissionDenied: 'Permiso de cámara denegado. Habilitá el acceso en configuración.',
+        cameraPermissionDenied: {
+            title: 'Permiso de Cámara Requerido',
+            message: 'Permiso de cámara denegado. Habilitá el acceso en configuración.',
+        },
         cameraNotAvailable: 'Cámara no disponible.',
         faceNotDetected: 'Rostro no detectado. Posicioná tu cara claramente.',
         multipleFacesDetected: 'Múltiples rostros detectados. Solo debe haber una persona.',
@@ -97,6 +107,10 @@ exports.esAR = {
         networkError: 'Error de red. Verificá tu conexión.',
         timeout: 'Tiempo de espera agotado. Intentá nuevamente.',
         unknownError: 'Ocurrió un error inesperado.',
+        videoTooShort: {
+            title: 'Grabación Muy Corta',
+            message: 'El video debe durar al menos 8 segundos. Por favor intentá nuevamente.',
+        },
     },
     badges: {
         secureVerification: 'Verificación Segura con IA',

package/dist/i18n/languages/es.js

@@ -10,6 +10,7 @@ exports.es = {
         continue: 'Continuar',
         close: 'Cerrar',
         done: 'Listo',
+        grantPermission: 'Otorgar Permiso',
     },
     initialization: {
         initializing: 'Iniciando...',
@@ -35,11 +36,13 @@ exports.es = {
             title: 'Frente del Documento',
             instruction: 'Posiciona el frente de tu documento dentro del marco',
             button: 'Capturar Frente',
+            tips: '• Asegura buena iluminación\n• Evita brillos y sombras\n• Mantén el documento plano y completo',
         },
         backId: {
             title: 'Reverso del Documento',
             instruction: 'Posiciona el reverso de tu documento dentro del marco',
             button: 'Capturar Reverso',
+            tips: '• Asegura buena iluminación\n• Evita brillos y sombras\n• Mantén el documento plano y completo',
         },
         selfie: {
             title: 'Foto de Rostro',
@@ -50,6 +53,9 @@ exports.es = {
     liveness: {
         title: 'Verificación Facial',
         preparing: 'Preparando verificación...',
+        getReady: '¡Prepárate!',
+        countdownMessage: 'Realizarás acciones.\nSigue las instrucciones en pantalla.',
+        recordingInstructions: 'Mantén tu rostro visible y sigue las instrucciones',
         instructions: {
             lookLeft: 'Mira a la izquierda',
             lookRight: 'Mira a la derecha',
@@ -60,6 +66,7 @@ exports.es = {
             turnHeadLeft: 'Gira tu cabeza a la izquierda',
             turnHeadRight: 'Gira tu cabeza a la derecha',
             stayStill: 'Permanece quieto',
+            openMouth: 'Abre la boca ligeramente',
         },
         recording: 'Grabando...',
         processing: 'Procesando video...',
@@ -85,7 +92,10 @@ exports.es = {
         },
     },
     errors: {
-        cameraPermissionDenied: 'Permiso de cámara denegado. Habilita el acceso en configuración.',
+        cameraPermissionDenied: {
+            title: 'Permiso de Cámara Requerido',
+            message: 'Permiso de cámara denegado. Habilita el acceso en configuración.',
+        },
         cameraNotAvailable: 'Cámara no disponible.',
         faceNotDetected: 'Rostro no detectado. Posiciona tu cara claramente.',
         multipleFacesDetected: 'Múltiples rostros detectados. Solo debe haber una persona.',
@@ -97,6 +107,10 @@ exports.es = {
         networkError: 'Error de red. Verifica tu conexión.',
         timeout: 'Tiempo de espera agotado. Intenta nuevamente.',
         unknownError: 'Ocurrió un error inesperado.',
+        videoTooShort: {
+            title: 'Grabación Muy Corta',
+            message: 'El video debe durar al menos 8 segundos. Por favor intenta nuevamente.',
+        },
     },
     badges: {
         secureVerification: 'Verificación Segura con IA',

package/dist/i18n/languages/pt-BR.js

@@ -10,6 +10,7 @@ exports.ptBR = {
         continue: 'Continuar',
         close: 'Fechar',
         done: 'Pronto',
+        grantPermission: 'Conceder Permissão',
     },
     initialization: {
         initializing: 'Inicializando...',
@@ -35,11 +36,13 @@ exports.ptBR = {
             title: 'Frente do Documento',
             instruction: 'Posicione a frente do seu documento dentro da moldura',
             button: 'Capturar Frente',
+            tips: '• Garanta boa iluminação\n• Evite brilhos e sombras\n• Mantenha o documento plano e completo',
         },
         backId: {
             title: 'Verso do Documento',
             instruction: 'Posicione o verso do seu documento dentro da moldura',
             button: 'Capturar Verso',
+            tips: '• Garanta boa iluminação\n• Evite brilhos e sombras\n• Mantenha o documento plano e completo',
         },
         selfie: {
             title: 'Foto do Rosto',
@@ -50,6 +53,9 @@ exports.ptBR = {
     liveness: {
         title: 'Verificação Facial',
         preparing: 'Preparando verificação...',
+        getReady: 'Prepare-se!',
+        countdownMessage: 'Você realizará ações.\nSiga as instruções na tela.',
+        recordingInstructions: 'Mantenha seu rosto visível e siga as instruções',
         instructions: {
             lookLeft: 'Olhe para a esquerda',
             lookRight: 'Olhe para a direita',
@@ -60,6 +66,7 @@ exports.ptBR = {
             turnHeadLeft: 'Vire sua cabeça para a esquerda',
             turnHeadRight: 'Vire sua cabeça para a direita',
             stayStill: 'Fique parado',
+            openMouth: 'Abra a boca levemente',
         },
         recording: 'Gravando...',
         processing: 'Processando vídeo...',
@@ -85,7 +92,10 @@ exports.ptBR = {
         },
     },
     errors: {
-        cameraPermissionDenied: 'Permissão de câmera negada. Habilite o acesso nas configurações.',
+        cameraPermissionDenied: {
+            title: 'Permissão de Câmera Necessária',
+            message: 'Permissão de câmera negada. Habilite o acesso nas configurações.',
+        },
         cameraNotAvailable: 'Câmera não disponível.',
         faceNotDetected: 'Rosto não detectado. Posicione seu rosto claramente.',
         multipleFacesDetected: 'Múltiplos rostos detectados. Apenas uma pessoa deve estar no quadro.',
@@ -97,6 +107,10 @@ exports.ptBR = {
         networkError: 'Erro de rede. Verifique sua conexão.',
         timeout: 'Tempo esgotado. Tente novamente.',
         unknownError: 'Ocorreu um erro inesperado.',
+        videoTooShort: {
+            title: 'Gravação Muito Curta',
+            message: 'O vídeo deve durar pelo menos 8 segundos. Por favor, tente novamente.',
+        },
     },
     badges: {
         secureVerification: 'Verificação Segura com IA',

package/dist/i18n/types.d.ts

@@ -8,6 +8,7 @@ export interface LanguageStrings {
         continue: string;
         close: string;
         done: string;
+        grantPermission: string;
     };
     initialization: {
         initializing: string;
@@ -33,11 +34,13 @@ export interface LanguageStrings {
             title: string;
             instruction: string;
             button: string;
+            tips: string;
         };
         backId: {
             title: string;
             instruction: string;
             button: string;
+            tips: string;
         };
         selfie: {
             title: string;
@@ -48,6 +51,9 @@ export interface LanguageStrings {
     liveness: {
         title: string;
         preparing: string;
+        getReady: string;
+        countdownMessage: string;
+        recordingInstructions: string;
         instructions: {
             lookLeft: string;
             lookRight: string;
@@ -58,6 +64,7 @@ export interface LanguageStrings {
             turnHeadLeft: string;
             turnHeadRight: string;
             stayStill: string;
+            openMouth: string;
         };
         recording: string;
         processing: string;
@@ -83,7 +90,10 @@ export interface LanguageStrings {
         };
     };
     errors: {
-        cameraPermissionDenied: string;
+        cameraPermissionDenied: {
+            title: string;
+            message: string;
+        };
         cameraNotAvailable: string;
         faceNotDetected: string;
         multipleFacesDetected: string;
@@ -95,6 +105,10 @@ export interface LanguageStrings {
         networkError: string;
         timeout: string;
         unknownError: string;
+        videoTooShort: {
+            title: string;
+            message: string;
+        };
     };
     badges: {
         secureVerification: string;

package/dist/types/index.d.ts

@@ -171,6 +171,7 @@ export declare enum BiometricErrorCode {
     NETWORK_ERROR = "NETWORK_ERROR",
     MODEL_LOAD_FAILED = "MODEL_LOAD_FAILED",
     ENCRYPTION_FAILED = "ENCRYPTION_FAILED",
+    USER_CANCELLED = "USER_CANCELLED",
     UNKNOWN_ERROR = "UNKNOWN_ERROR"
 }
 export interface FaceEmbedding {

package/dist/types/index.js

@@ -20,6 +20,7 @@ var BiometricErrorCode;
     BiometricErrorCode["NETWORK_ERROR"] = "NETWORK_ERROR";
     BiometricErrorCode["MODEL_LOAD_FAILED"] = "MODEL_LOAD_FAILED";
     BiometricErrorCode["ENCRYPTION_FAILED"] = "ENCRYPTION_FAILED";
+    BiometricErrorCode["USER_CANCELLED"] = "USER_CANCELLED";
     BiometricErrorCode["UNKNOWN_ERROR"] = "UNKNOWN_ERROR";
 })(BiometricErrorCode || (exports.BiometricErrorCode = BiometricErrorCode = {}));
 var SDKStep;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hexar/biometric-identity-sdk-core",
-  "version": "1.0.5",
+  "version": "1.0.7",
   "description": "Core AI engine for biometric identity verification",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/src/api/BackendClient.ts

@@ -134,13 +134,15 @@ export interface BackendClientConfig {
 export class BackendClient {
   private config: Required<BackendClientConfig>;
   private currentSessionId: string | null = null;
+  private sdkSessionId: string | null = null;
 
   constructor(config: BackendClientConfig) {
     this.config = {
-      apiEndpoint: config.apiEndpoint.replace(/\/$/, ''), // Remove trailing slash
+      apiEndpoint: config.apiEndpoint.replace(/\/$/, ''),
       apiKey: config.apiKey,
       timeout: config.timeout || 60000,
     };
+    this.sdkSessionId = this.generateSDKSessionId();
   }
 
   /**
@@ -188,7 +190,7 @@ export class BackendClient {
       throw new Error('No active session. Call generateChallenge() first.');
     }
 
-    const response = await this.request<LivenessResponse>(
+    return this.request<LivenessResponse>(
       '/api/v1/liveness/validate',
       'POST',
       {
@@ -199,8 +201,10 @@ export class BackendClient {
         device_info: deviceInfo,
       }
     );
+  }
 
-    return response;
+  private generateSDKSessionId(): string {
+    return `sdk-${Date.now()}-${Math.random().toString(36).substr(2, 9)}`;
   }
 
   /**
@@ -341,6 +345,7 @@ export class BackendClient {
    */
   resetSession(): void {
     this.currentSessionId = null;
+    this.sdkSessionId = this.generateSDKSessionId();
   }
 
   /**
@@ -356,13 +361,19 @@ export class BackendClient {
     const controller = new AbortController();
     const timeoutId = setTimeout(() => controller.abort(), this.config.timeout);
 
+    const headers: Record<string, string> = {
+      'Content-Type': 'application/json',
+      'X-API-Key': this.config.apiKey,
+    };
+
+    if (this.sdkSessionId) {
+      headers['X-SDK-Session-ID'] = this.sdkSessionId;
+    }
+
     try {
       const response = await fetch(url, {
         method,
-        headers: {
-          'Content-Type': 'application/json',
-          'X-API-Key': this.config.apiKey,
-        },
+        headers,
         body: body ? JSON.stringify(body) : undefined,
         signal: controller.signal as RequestInit['signal'],
       });

package/src/i18n/languages/en.ts

@@ -9,6 +9,7 @@ export const en: LanguageStrings = {
     continue: 'Continue',
     close: 'Close',
     done: 'Done',
+    grantPermission: 'Grant Permission',
   },
   
   initialization: {
@@ -37,11 +38,13 @@ export const en: LanguageStrings = {
       title: 'Front of ID',
       instruction: 'Position the front of your ID within the frame',
       button: 'Capture Front ID',
+      tips: '• Ensure good lighting\n• Avoid glare and shadows\n• Keep document flat and complete',
     },
     backId: {
       title: 'Back of ID',
       instruction: 'Position the back of your ID within the frame',
       button: 'Capture Back ID',
+      tips: '• Ensure good lighting\n• Avoid glare and shadows\n• Keep document flat and complete',
     },
     selfie: {
       title: 'Face Photo',
@@ -53,6 +56,9 @@ export const en: LanguageStrings = {
   liveness: {
     title: 'Face Verification',
     preparing: 'Preparing verification...',
+    getReady: 'Get Ready!',
+    countdownMessage: 'You\'ll perform actions.\nFollow the on-screen instructions.',
+    recordingInstructions: 'Keep your face visible and follow the instructions',
     instructions: {
       lookLeft: 'Look to the left',
       lookRight: 'Look to the right',
@@ -63,6 +69,7 @@ export const en: LanguageStrings = {
       turnHeadLeft: 'Turn your head to the left',
       turnHeadRight: 'Turn your head to the right',
       stayStill: 'Stay still',
+      openMouth: 'Open your mouth slightly',
     },
     recording: 'Recording...',
     processing: 'Processing video...',
@@ -91,7 +98,10 @@ export const en: LanguageStrings = {
   },
   
   errors: {
-    cameraPermissionDenied: 'Camera permission denied. Please enable camera access in settings.',
+    cameraPermissionDenied: {
+      title: 'Camera Permission Required',
+      message: 'Camera permission denied. Please enable camera access in settings.',
+    },
     cameraNotAvailable: 'Camera not available.',
     faceNotDetected: 'Face not detected. Please position your face clearly.',
     multipleFacesDetected: 'Multiple faces detected. Only one person should be in frame.',
@@ -103,6 +113,10 @@ export const en: LanguageStrings = {
     networkError: 'Network error. Please check your connection.',
     timeout: 'Request timeout. Please try again.',
     unknownError: 'An unexpected error occurred.',
+    videoTooShort: {
+      title: 'Recording Too Short',
+      message: 'Video must be at least 8 seconds. Please try again.',
+    },
   },
   
   badges: {

package/src/i18n/languages/es-AR.ts

@@ -9,6 +9,7 @@ export const esAR: LanguageStrings = {
     continue: 'Continuar',
     close: 'Cerrar',
     done: 'Listo',
+    grantPermission: 'Otorgar Permiso',
   },
   
   initialization: {
@@ -37,11 +38,13 @@ export const esAR: LanguageStrings = {
       title: 'Frente del Documento',
       instruction: 'Posicioná el frente de tu documento dentro del marco',
       button: 'Capturar Frente',
+      tips: '• Asegurate de tener buena iluminación\n• Evitá brillos y sombras\n• Mantené el documento plano y completo',
     },
     backId: {
       title: 'Dorso del Documento',
       instruction: 'Posicioná el dorso de tu documento dentro del marco',
       button: 'Capturar Dorso',
+      tips: '• Asegurate de tener buena iluminación\n• Evitá brillos y sombras\n• Mantené el documento plano y completo',
     },
     selfie: {
       title: 'Foto de Rostro',
@@ -53,6 +56,9 @@ export const esAR: LanguageStrings = {
   liveness: {
     title: 'Verificación Facial',
     preparing: 'Preparando verificación...',
+    getReady: '¡Prepárate!',
+    countdownMessage: 'Vas a realizar acciones.\nSeguí las instrucciones en pantalla.',
+    recordingInstructions: 'Mantené tu rostro visible y seguí las instrucciones',
     instructions: {
       lookLeft: 'Mirá a la izquierda',
       lookRight: 'Mirá a la derecha',
@@ -63,6 +69,7 @@ export const esAR: LanguageStrings = {
       turnHeadLeft: 'Girá tu cabeza a la izquierda',
       turnHeadRight: 'Girá tu cabeza a la derecha',
       stayStill: 'Quedate quieto',
+      openMouth: 'Abrí la boca ligeramente',
     },
     recording: 'Grabando...',
     processing: 'Procesando video...',
@@ -91,7 +98,10 @@ export const esAR: LanguageStrings = {
   },
   
   errors: {
-    cameraPermissionDenied: 'Permiso de cámara denegado. Habilitá el acceso en configuración.',
+    cameraPermissionDenied: {
+      title: 'Permiso de Cámara Requerido',
+      message: 'Permiso de cámara denegado. Habilitá el acceso en configuración.',
+    },
     cameraNotAvailable: 'Cámara no disponible.',
     faceNotDetected: 'Rostro no detectado. Posicioná tu cara claramente.',
     multipleFacesDetected: 'Múltiples rostros detectados. Solo debe haber una persona.',
@@ -103,6 +113,10 @@ export const esAR: LanguageStrings = {
     networkError: 'Error de red. Verificá tu conexión.',
     timeout: 'Tiempo de espera agotado. Intentá nuevamente.',
     unknownError: 'Ocurrió un error inesperado.',
+    videoTooShort: {
+      title: 'Grabación Muy Corta',
+      message: 'El video debe durar al menos 8 segundos. Por favor intentá nuevamente.',
+    },
   },
   
   badges: {

package/src/i18n/languages/es.ts

@@ -9,6 +9,7 @@ export const es: LanguageStrings = {
     continue: 'Continuar',
     close: 'Cerrar',
     done: 'Listo',
+    grantPermission: 'Otorgar Permiso',
   },
   
   initialization: {
@@ -37,11 +38,13 @@ export const es: LanguageStrings = {
       title: 'Frente del Documento',
       instruction: 'Posiciona el frente de tu documento dentro del marco',
       button: 'Capturar Frente',
+      tips: '• Asegura buena iluminación\n• Evita brillos y sombras\n• Mantén el documento plano y completo',
     },
     backId: {
       title: 'Reverso del Documento',
       instruction: 'Posiciona el reverso de tu documento dentro del marco',
       button: 'Capturar Reverso',
+      tips: '• Asegura buena iluminación\n• Evita brillos y sombras\n• Mantén el documento plano y completo',
     },
     selfie: {
       title: 'Foto de Rostro',
@@ -53,6 +56,9 @@ export const es: LanguageStrings = {
   liveness: {
     title: 'Verificación Facial',
     preparing: 'Preparando verificación...',
+    getReady: '¡Prepárate!',
+    countdownMessage: 'Realizarás acciones.\nSigue las instrucciones en pantalla.',
+    recordingInstructions: 'Mantén tu rostro visible y sigue las instrucciones',
     instructions: {
       lookLeft: 'Mira a la izquierda',
       lookRight: 'Mira a la derecha',
@@ -63,6 +69,7 @@ export const es: LanguageStrings = {
       turnHeadLeft: 'Gira tu cabeza a la izquierda',
       turnHeadRight: 'Gira tu cabeza a la derecha',
       stayStill: 'Permanece quieto',
+      openMouth: 'Abre la boca ligeramente',
     },
     recording: 'Grabando...',
     processing: 'Procesando video...',
@@ -91,7 +98,10 @@ export const es: LanguageStrings = {
   },
   
   errors: {
-    cameraPermissionDenied: 'Permiso de cámara denegado. Habilita el acceso en configuración.',
+    cameraPermissionDenied: {
+      title: 'Permiso de Cámara Requerido',
+      message: 'Permiso de cámara denegado. Habilita el acceso en configuración.',
+    },
     cameraNotAvailable: 'Cámara no disponible.',
     faceNotDetected: 'Rostro no detectado. Posiciona tu cara claramente.',
     multipleFacesDetected: 'Múltiples rostros detectados. Solo debe haber una persona.',
@@ -103,6 +113,10 @@ export const es: LanguageStrings = {
     networkError: 'Error de red. Verifica tu conexión.',
     timeout: 'Tiempo de espera agotado. Intenta nuevamente.',
     unknownError: 'Ocurrió un error inesperado.',
+    videoTooShort: {
+      title: 'Grabación Muy Corta',
+      message: 'El video debe durar al menos 8 segundos. Por favor intenta nuevamente.',
+    },
   },
   
   badges: {

package/src/i18n/languages/pt-BR.ts

@@ -9,6 +9,7 @@ export const ptBR: LanguageStrings = {
     continue: 'Continuar',
     close: 'Fechar',
     done: 'Pronto',
+    grantPermission: 'Conceder Permissão',
   },
   
   initialization: {
@@ -37,11 +38,13 @@ export const ptBR: LanguageStrings = {
       title: 'Frente do Documento',
       instruction: 'Posicione a frente do seu documento dentro da moldura',
       button: 'Capturar Frente',
+      tips: '• Garanta boa iluminação\n• Evite brilhos e sombras\n• Mantenha o documento plano e completo',
     },
     backId: {
       title: 'Verso do Documento',
       instruction: 'Posicione o verso do seu documento dentro da moldura',
       button: 'Capturar Verso',
+      tips: '• Garanta boa iluminação\n• Evite brilhos e sombras\n• Mantenha o documento plano e completo',
     },
     selfie: {
       title: 'Foto do Rosto',
@@ -53,6 +56,9 @@ export const ptBR: LanguageStrings = {
   liveness: {
     title: 'Verificação Facial',
     preparing: 'Preparando verificação...',
+    getReady: 'Prepare-se!',
+    countdownMessage: 'Você realizará ações.\nSiga as instruções na tela.',
+    recordingInstructions: 'Mantenha seu rosto visível e siga as instruções',
     instructions: {
       lookLeft: 'Olhe para a esquerda',
       lookRight: 'Olhe para a direita',
@@ -63,6 +69,7 @@ export const ptBR: LanguageStrings = {
       turnHeadLeft: 'Vire sua cabeça para a esquerda',
       turnHeadRight: 'Vire sua cabeça para a direita',
       stayStill: 'Fique parado',
+      openMouth: 'Abra a boca levemente',
     },
     recording: 'Gravando...',
     processing: 'Processando vídeo...',
@@ -91,7 +98,10 @@ export const ptBR: LanguageStrings = {
   },
   
   errors: {
-    cameraPermissionDenied: 'Permissão de câmera negada. Habilite o acesso nas configurações.',
+    cameraPermissionDenied: {
+      title: 'Permissão de Câmera Necessária',
+      message: 'Permissão de câmera negada. Habilite o acesso nas configurações.',
+    },
     cameraNotAvailable: 'Câmera não disponível.',
     faceNotDetected: 'Rosto não detectado. Posicione seu rosto claramente.',
     multipleFacesDetected: 'Múltiplos rostos detectados. Apenas uma pessoa deve estar no quadro.',
@@ -103,6 +113,10 @@ export const ptBR: LanguageStrings = {
     networkError: 'Erro de rede. Verifique sua conexão.',
     timeout: 'Tempo esgotado. Tente novamente.',
     unknownError: 'Ocorreu um erro inesperado.',
+    videoTooShort: {
+      title: 'Gravação Muito Curta',
+      message: 'O vídeo deve durar pelo menos 8 segundos. Por favor, tente novamente.',
+    },
   },
   
   badges: {

package/src/i18n/types.ts

@@ -9,6 +9,7 @@ export interface LanguageStrings {
     continue: string;
     close: string;
     done: string;
+    grantPermission: string;
   };
   
   initialization: {
@@ -37,11 +38,13 @@ export interface LanguageStrings {
       title: string;
       instruction: string;
       button: string;
+      tips: string;
     };
     backId: {
       title: string;
       instruction: string;
       button: string;
+      tips: string;
     };
     selfie: {
       title: string;
@@ -53,6 +56,9 @@ export interface LanguageStrings {
   liveness: {
     title: string;
     preparing: string;
+    getReady: string;
+    countdownMessage: string;
+    recordingInstructions: string;
     instructions: {
       lookLeft: string;
       lookRight: string;
@@ -63,6 +69,7 @@ export interface LanguageStrings {
       turnHeadLeft: string;
       turnHeadRight: string;
       stayStill: string;
+      openMouth: string;
     };
     recording: string;
     processing: string;
@@ -91,7 +98,10 @@ export interface LanguageStrings {
   };
   
   errors: {
-    cameraPermissionDenied: string;
+    cameraPermissionDenied: {
+      title: string;
+      message: string;
+    };
     cameraNotAvailable: string;
     faceNotDetected: string;
     multipleFacesDetected: string;
@@ -103,6 +113,10 @@ export interface LanguageStrings {
     networkError: string;
     timeout: string;
     unknownError: string;
+    videoTooShort: {
+      title: string;
+      message: string;
+    };
   };
   
   badges: {

package/src/types/index.ts

@@ -224,6 +224,7 @@ export enum BiometricErrorCode {
   NETWORK_ERROR = 'NETWORK_ERROR',
   MODEL_LOAD_FAILED = 'MODEL_LOAD_FAILED',
   ENCRYPTION_FAILED = 'ENCRYPTION_FAILED',
+  USER_CANCELLED = 'USER_CANCELLED',
   UNKNOWN_ERROR = 'UNKNOWN_ERROR',
 }