@hexar/biometric-identity-sdk-core 1.6.0 → 1.8.0

package/dist/BiometricIdentitySDK.js

@@ -287,10 +287,10 @@ class BiometricIdentitySDK {
                 const compressedFrame = this.fixBase64Padding(await this.compressImage(frame));
                 validFrames.push(compressedFrame);
             }
-            const MIN_FRAMES = 10; // Minimum frames required for profile picture validation (backend warns if < 10)
+            const MIN_FRAMES = 5;
             if (validFrames.length < MIN_FRAMES) {
                 logger_1.logger.error(`Insufficient valid frames: ${validFrames.length} < ${MIN_FRAMES}`);
-                throw this.createError(types_1.BiometricErrorCode.CAMERA_NOT_AVAILABLE, 'Camera capture failed. Please ensure good lighting and try again.');
+                throw this.createError(types_1.BiometricErrorCode.LIVENESS_CHECK_FAILED, 'Not enough valid video frames captured. Please try again.');
             }
             /**
              * Perform backend validation
@@ -456,14 +456,40 @@ class BiometricIdentitySDK {
                 errorData: error?.errorData,
                 errorStack: error?.stack?.substring(0, 500)
             });
-            // Handle timeout specifically with better error message
+            // Categorise the error properly instead of lumping everything as NETWORK_ERROR
             const isTimeout = error?.message?.includes('timeout') || error?.message?.includes('Request timeout') || error?.message?.includes('AbortError');
-            const errorMessage = isTimeout
-                ? 'La validación está tomando demasiado tiempo. Por favor, verifica tu conexión e intenta nuevamente.'
-                : (error?.message || (error?.status ? `Backend request failed with status ${error.status}` : 'Backend validation failed'));
-            const errorToThrow = this.createError(types_1.BiometricErrorCode.NETWORK_ERROR, errorMessage, {
-                status: isTimeout ? 504 : error?.status,
-                statusText: isTimeout ? 'Gateway Timeout' : error?.statusText,
+            const isNetwork = error?.message?.includes('Network request failed') || error?.message?.includes('Failed to fetch') || error?.message?.includes('NETWORK_ERROR');
+            let errorCode;
+            let errorMessage;
+            let status;
+            let statusText;
+            if (isTimeout) {
+                errorCode = types_1.BiometricErrorCode.VALIDATION_TIMEOUT;
+                errorMessage = 'La validación está tomando demasiado tiempo. Por favor, intenta nuevamente.';
+                status = 504;
+                statusText = 'Gateway Timeout';
+            }
+            else if (isNetwork) {
+                errorCode = types_1.BiometricErrorCode.NETWORK_ERROR;
+                errorMessage = error?.message || 'Network error';
+                status = error?.status;
+                statusText = error?.statusText;
+            }
+            else if (error?.message?.includes('liveness') || error?.message?.includes('Liveness')) {
+                errorCode = types_1.BiometricErrorCode.LIVENESS_CHECK_FAILED;
+                errorMessage = error?.message || 'Liveness check failed';
+                status = error?.status;
+                statusText = error?.statusText;
+            }
+            else {
+                errorCode = types_1.BiometricErrorCode.UNKNOWN_ERROR;
+                errorMessage = error?.message || (error?.status ? `Backend request failed with status ${error.status}` : 'Backend validation failed');
+                status = error?.status;
+                statusText = error?.statusText;
+            }
+            const errorToThrow = this.createError(errorCode, errorMessage, {
+                status,
+                statusText,
                 errorData: error?.errorData,
                 originalError: error?.message
             });

package/dist/i18n/languages/en.js

@@ -117,6 +117,8 @@ exports.en = {
         networkError: 'Network error. Please check your connection.',
         timeout: 'Request timeout. Please try again.',
         unknownError: 'An unexpected error occurred.',
+        systemBusy: 'Service temporarily unavailable',
+        systemBusyMessage: 'Our system is currently processing other requests. Please try again in a few moments.',
         videoTooShort: {
             title: 'Recording Too Short',
             message: 'Video must be at least 8 seconds. Please try again.',

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

@@ -117,6 +117,8 @@ exports.esAR = {
         networkError: 'Error de red. Verificá tu conexión.',
         timeout: 'Tiempo de espera agotado. Intentá nuevamente.',
         unknownError: 'Ocurrió un error inesperado.',
+        systemBusy: 'Servicio temporalmente no disponible',
+        systemBusyMessage: 'Nuestro sistema está procesando otras solicitudes en este momento. Por favor, intentá nuevamente en unos instantes.',
         videoTooShort: {
             title: 'Grabación Muy Corta',
             message: 'El video debe durar al menos 8 segundos. Por favor intentá nuevamente.',

package/dist/i18n/languages/es.js

@@ -117,6 +117,8 @@ exports.es = {
         networkError: 'Error de red. Verifica tu conexión.',
         timeout: 'Tiempo de espera agotado. Intenta nuevamente.',
         unknownError: 'Ocurrió un error inesperado.',
+        systemBusy: 'Servicio temporalmente no disponible',
+        systemBusyMessage: 'Nuestro sistema está procesando otras solicitudes en este momento. Por favor, intenta nuevamente en unos instantes.',
         videoTooShort: {
             title: 'Grabación Muy Corta',
             message: 'El video debe durar al menos 8 segundos. Por favor intenta nuevamente.',

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

@@ -117,6 +117,8 @@ exports.ptBR = {
         networkError: 'Erro de rede. Verifique sua conexão.',
         timeout: 'Tempo esgotado. Tente novamente.',
         unknownError: 'Ocorreu um erro inesperado.',
+        systemBusy: 'Serviço temporariamente indisponível',
+        systemBusyMessage: 'Nosso sistema está processando outras solicitações no momento. Por favor, tente novamente em alguns instantes.',
         videoTooShort: {
             title: 'Gravação Muito Curta',
             message: 'O vídeo deve durar pelo menos 8 segundos. Por favor, tente novamente.',

package/dist/i18n/types.d.ts

@@ -115,6 +115,8 @@ export interface LanguageStrings {
         networkError: string;
         timeout: string;
         unknownError: string;
+        systemBusy: string;
+        systemBusyMessage: string;
         videoTooShort: {
             title: string;
             message: string;

package/package.json

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

package/src/BiometricIdentitySDK.ts

@@ -376,12 +376,12 @@ export class BiometricIdentitySDK {
         validFrames.push(compressedFrame);
       }
 
-      const MIN_FRAMES = 10; // Minimum frames required for profile picture validation (backend warns if < 10)
+      const MIN_FRAMES = 5;
       if (validFrames.length < MIN_FRAMES) {
         logger.error(`Insufficient valid frames: ${validFrames.length} < ${MIN_FRAMES}`);
         throw this.createError(
-          BiometricErrorCode.CAMERA_NOT_AVAILABLE,
-          'Camera capture failed. Please ensure good lighting and try again.'
+          BiometricErrorCode.LIVENESS_CHECK_FAILED,
+          'Not enough valid video frames captured. Please try again.'
         );
       }
 
@@ -579,19 +579,43 @@ export class BiometricIdentitySDK {
         errorStack: error?.stack?.substring(0, 500)
       });
       
-      // Handle timeout specifically with better error message
+      // Categorise the error properly instead of lumping everything as NETWORK_ERROR
       const isTimeout = error?.message?.includes('timeout') || error?.message?.includes('Request timeout') || error?.message?.includes('AbortError');
-      
-      const errorMessage = isTimeout
-        ? 'La validación está tomando demasiado tiempo. Por favor, verifica tu conexión e intenta nuevamente.'
-        : (error?.message || (error?.status ? `Backend request failed with status ${error.status}` : 'Backend validation failed'));
-      
+      const isNetwork = error?.message?.includes('Network request failed') || error?.message?.includes('Failed to fetch') || error?.message?.includes('NETWORK_ERROR');
+
+      let errorCode: BiometricErrorCode;
+      let errorMessage: string;
+      let status: number | undefined;
+      let statusText: string | undefined;
+
+      if (isTimeout) {
+        errorCode = BiometricErrorCode.VALIDATION_TIMEOUT;
+        errorMessage = 'La validación está tomando demasiado tiempo. Por favor, intenta nuevamente.';
+        status = 504;
+        statusText = 'Gateway Timeout';
+      } else if (isNetwork) {
+        errorCode = BiometricErrorCode.NETWORK_ERROR;
+        errorMessage = error?.message || 'Network error';
+        status = error?.status;
+        statusText = error?.statusText;
+      } else if (error?.message?.includes('liveness') || error?.message?.includes('Liveness')) {
+        errorCode = BiometricErrorCode.LIVENESS_CHECK_FAILED;
+        errorMessage = error?.message || 'Liveness check failed';
+        status = error?.status;
+        statusText = error?.statusText;
+      } else {
+        errorCode = BiometricErrorCode.UNKNOWN_ERROR;
+        errorMessage = error?.message || (error?.status ? `Backend request failed with status ${error.status}` : 'Backend validation failed');
+        status = error?.status;
+        statusText = error?.statusText;
+      }
+
       const errorToThrow = this.createError(
-        BiometricErrorCode.NETWORK_ERROR,
+        errorCode,
         errorMessage,
         {
-          status: isTimeout ? 504 : error?.status,
-          statusText: isTimeout ? 'Gateway Timeout' : error?.statusText,
+          status,
+          statusText,
           errorData: error?.errorData,
           originalError: error?.message
         }

package/src/i18n/languages/en.ts

@@ -124,6 +124,8 @@ export const en: LanguageStrings = {
     networkError: 'Network error. Please check your connection.',
     timeout: 'Request timeout. Please try again.',
     unknownError: 'An unexpected error occurred.',
+    systemBusy: 'Service temporarily unavailable',
+    systemBusyMessage: 'Our system is currently processing other requests. Please try again in a few moments.',
     videoTooShort: {
       title: 'Recording Too Short',
       message: 'Video must be at least 8 seconds. Please try again.',

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

@@ -124,6 +124,8 @@ export const esAR: LanguageStrings = {
     networkError: 'Error de red. Verificá tu conexión.',
     timeout: 'Tiempo de espera agotado. Intentá nuevamente.',
     unknownError: 'Ocurrió un error inesperado.',
+    systemBusy: 'Servicio temporalmente no disponible',
+    systemBusyMessage: 'Nuestro sistema está procesando otras solicitudes en este momento. Por favor, intentá nuevamente en unos instantes.',
     videoTooShort: {
       title: 'Grabación Muy Corta',
       message: 'El video debe durar al menos 8 segundos. Por favor intentá nuevamente.',

package/src/i18n/languages/es.ts

@@ -124,6 +124,8 @@ export const es: LanguageStrings = {
     networkError: 'Error de red. Verifica tu conexión.',
     timeout: 'Tiempo de espera agotado. Intenta nuevamente.',
     unknownError: 'Ocurrió un error inesperado.',
+    systemBusy: 'Servicio temporalmente no disponible',
+    systemBusyMessage: 'Nuestro sistema está procesando otras solicitudes en este momento. Por favor, intenta nuevamente en unos instantes.',
     videoTooShort: {
       title: 'Grabación Muy Corta',
       message: 'El video debe durar al menos 8 segundos. Por favor intenta nuevamente.',

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

@@ -124,6 +124,8 @@ export const ptBR: LanguageStrings = {
     networkError: 'Erro de rede. Verifique sua conexão.',
     timeout: 'Tempo esgotado. Tente novamente.',
     unknownError: 'Ocorreu um erro inesperado.',
+    systemBusy: 'Serviço temporariamente indisponível',
+    systemBusyMessage: 'Nosso sistema está processando outras solicitações no momento. Por favor, tente novamente em alguns instantes.',
     videoTooShort: {
       title: 'Gravação Muito Curta',
       message: 'O vídeo deve durar pelo menos 8 segundos. Por favor, tente novamente.',

package/src/i18n/types.ts

@@ -123,6 +123,8 @@ export interface LanguageStrings {
     networkError: string;
     timeout: string;
     unknownError: string;
+    systemBusy: string;
+    systemBusyMessage: string;
     videoTooShort: {
       title: string;
       message: string;