@hexar/biometric-identity-sdk-core 1.3.0 → 1.5.0

package/dist/BiometricIdentitySDK.js

@@ -286,7 +286,7 @@ class BiometricIdentitySDK {
             const MIN_FRAMES = 10; // Minimum frames required for profile picture validation (backend warns if < 10)
             if (validFrames.length < MIN_FRAMES) {
                 logger_1.logger.error(`Insufficient valid frames: ${validFrames.length} < ${MIN_FRAMES}`);
-                throw this.createError(types_1.BiometricErrorCode.UNKNOWN_ERROR, `Insufficient valid video frames: ${validFrames.length} frames available, minimum ${MIN_FRAMES} required`);
+                throw this.createError(types_1.BiometricErrorCode.CAMERA_NOT_AVAILABLE, 'Camera capture failed. Please ensure good lighting and try again.');
             }
             /**
              * Perform backend validation
@@ -379,7 +379,11 @@ class BiometricIdentitySDK {
                     minimumRequired: 10
                 });
             }
-            const MAX_FRAMES = 5; // Reduced to 5 to reduce payload size and processing time
+            // 15 frames gives the backend enough temporal spread to reliably detect
+            // blink (EAR variation) and head movement across the 8-second recording.
+            // The previous value of 5 was too low: at ~0.6 FPS a blink event
+            // (150–300 ms) was statistically unlikely to be captured in any frame.
+            const MAX_FRAMES = 15;
             if (videoFrames.length > MAX_FRAMES) {
                 const step = Math.floor(videoFrames.length / MAX_FRAMES);
                 videoFrames = videoFrames.filter((_, index) => index % step === 0).slice(0, MAX_FRAMES);
@@ -410,10 +414,10 @@ class BiometricIdentitySDK {
                 const compressedFrame = this.fixBase64Padding(await this.compressImage(frame));
                 validFrames.push(compressedFrame);
             }
-            const MIN_FRAMES = 5; // Minimum frames required for validation
+            const MIN_FRAMES = 5;
             if (validFrames.length < MIN_FRAMES) {
                 logger_1.logger.error(`Insufficient valid frames: ${validFrames.length} < ${MIN_FRAMES}`);
-                throw new Error(`Insufficient valid video frames: ${validFrames.length} frames available, minimum ${MIN_FRAMES} required`);
+                throw new Error('Insufficient video frames captured. Please try again.');
             }
             logger_1.logger.info('Sending validation request to backend', {
                 framesCount: validFrames.length,

package/dist/i18n/languages/en.js

@@ -87,6 +87,7 @@ exports.en = {
         almostDone: 'Almost done...',
         validatingDocumentAndFace: 'Validating document and face...',
         validatingFace: 'Validating face...',
+        doNotLockScreen: 'Do not lock your screen',
     },
     result: {
         success: {

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

@@ -87,6 +87,7 @@ exports.esAR = {
         almostDone: 'Ya casi terminamos...',
         validatingDocumentAndFace: 'Validando documento y rostro...',
         validatingFace: 'Validando rostro...',
+        doNotLockScreen: 'No bloquees la pantalla',
     },
     result: {
         success: {

package/dist/i18n/languages/es.js

@@ -87,6 +87,7 @@ exports.es = {
         almostDone: 'Casi terminamos...',
         validatingDocumentAndFace: 'Validando documento y rostro...',
         validatingFace: 'Validando rostro...',
+        doNotLockScreen: 'No bloquees la pantalla',
     },
     result: {
         success: {

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

@@ -87,6 +87,7 @@ exports.ptBR = {
         almostDone: 'Quase pronto...',
         validatingDocumentAndFace: 'Validando documento e rosto...',
         validatingFace: 'Validando rosto...',
+        doNotLockScreen: 'Nao bloqueie a tela',
     },
     result: {
         success: {

package/dist/i18n/types.d.ts

@@ -85,6 +85,7 @@ export interface LanguageStrings {
         almostDone: string;
         validatingDocumentAndFace: string;
         validatingFace: string;
+        doNotLockScreen: string;
     };
     result: {
         success: {

package/package.json

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

package/src/BiometricIdentitySDK.ts

@@ -376,8 +376,8 @@ export class BiometricIdentitySDK {
       if (validFrames.length < MIN_FRAMES) {
         logger.error(`Insufficient valid frames: ${validFrames.length} < ${MIN_FRAMES}`);
         throw this.createError(
-          BiometricErrorCode.UNKNOWN_ERROR,
-          `Insufficient valid video frames: ${validFrames.length} frames available, minimum ${MIN_FRAMES} required`
+          BiometricErrorCode.CAMERA_NOT_AVAILABLE,
+          'Camera capture failed. Please ensure good lighting and try again.'
         );
       }
 
@@ -492,7 +492,11 @@ export class BiometricIdentitySDK {
         });
       }
       
-      const MAX_FRAMES = 5; // Reduced to 5 to reduce payload size and processing time
+      // 15 frames gives the backend enough temporal spread to reliably detect
+      // blink (EAR variation) and head movement across the 8-second recording.
+      // The previous value of 5 was too low: at ~0.6 FPS a blink event
+      // (150–300 ms) was statistically unlikely to be captured in any frame.
+      const MAX_FRAMES = 15;
       if (videoFrames.length > MAX_FRAMES) {
         const step = Math.floor(videoFrames.length / MAX_FRAMES);
         videoFrames = videoFrames.filter((_, index) => index % step === 0).slice(0, MAX_FRAMES);
@@ -501,12 +505,12 @@ export class BiometricIdentitySDK {
           sampledCount: videoFrames.length
         });
       }
-      
+
       const compressedFrontImage = this.fixBase64Padding(await this.compressImage(this.state.frontID.data));
-      const compressedBackImage = this.state.backID?.data 
+      const compressedBackImage = this.state.backID?.data
         ? this.fixBase64Padding(await this.compressImage(this.state.backID.data))
         : undefined;
-      
+
       const validFrames: string[] = [];
       for (let i = 0; i < videoFrames.length; i++) {
         const frame = videoFrames[i];
@@ -514,25 +518,25 @@ export class BiometricIdentitySDK {
           logger.warn(`Skipping invalid frame ${i}: not a string`);
           continue;
         }
-        
+
         if (frame.length < 100) {
           logger.warn(`Skipping invalid frame ${i}: too short (${frame.length} chars), likely a file path`);
           continue;
         }
-        
+
         if (!this.isValidBase64(frame)) {
           logger.warn(`Skipping invalid frame ${i}: not valid base64`);
           continue;
         }
-        
+
         const compressedFrame = this.fixBase64Padding(await this.compressImage(frame));
         validFrames.push(compressedFrame);
       }
 
-      const MIN_FRAMES = 5; // Minimum frames required for validation
+      const MIN_FRAMES = 5;
       if (validFrames.length < MIN_FRAMES) {
         logger.error(`Insufficient valid frames: ${validFrames.length} < ${MIN_FRAMES}`);
-        throw new Error(`Insufficient valid video frames: ${validFrames.length} frames available, minimum ${MIN_FRAMES} required`);
+        throw new Error('Insufficient video frames captured. Please try again.');
       }
 
       logger.info('Sending validation request to backend', {

package/src/i18n/languages/en.ts

@@ -91,6 +91,7 @@ export const en: LanguageStrings = {
     almostDone: 'Almost done...',
     validatingDocumentAndFace: 'Validating document and face...',
     validatingFace: 'Validating face...',
+    doNotLockScreen: 'Do not lock your screen',
   },
   
   result: {

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

@@ -91,6 +91,7 @@ export const esAR: LanguageStrings = {
     almostDone: 'Ya casi terminamos...',
     validatingDocumentAndFace: 'Validando documento y rostro...',
     validatingFace: 'Validando rostro...',
+    doNotLockScreen: 'No bloquees la pantalla',
   },
   
   result: {

package/src/i18n/languages/es.ts

@@ -91,6 +91,7 @@ export const es: LanguageStrings = {
     almostDone: 'Casi terminamos...',
     validatingDocumentAndFace: 'Validando documento y rostro...',
     validatingFace: 'Validando rostro...',
+    doNotLockScreen: 'No bloquees la pantalla',
   },
   
   result: {

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

@@ -91,6 +91,7 @@ export const ptBR: LanguageStrings = {
     almostDone: 'Quase pronto...',
     validatingDocumentAndFace: 'Validando documento e rosto...',
     validatingFace: 'Validando rosto...',
+    doNotLockScreen: 'Nao bloqueie a tela',
   },
   
   result: {

package/src/i18n/types.ts

@@ -91,6 +91,7 @@ export interface LanguageStrings {
     almostDone: string;
     validatingDocumentAndFace: string;
     validatingFace: string;
+    doNotLockScreen: string;
   };
   
   result: {