@hexar/biometric-identity-sdk-core 1.7.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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hexar/biometric-identity-sdk-core",
-  "version": "1.7.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
         }