@hexar/biometric-identity-sdk-core 1.2.1 → 1.4.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/api/BackendClient.js

@@ -3,8 +3,12 @@
  * Backend API Client for Biometric Identity SDK
  * Communicates with the Python backend for AI-powered validation
  */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.BackendClient = void 0;
+const crypto_1 = __importDefault(require("crypto"));
 const logger_1 = require("../utils/logger");
 /**
  * Client for communicating with the Biometric Identity Backend
@@ -60,7 +64,7 @@ class BackendClient {
         });
     }
     generateSDKSessionId() {
-        return `sdk-${Date.now()}-${Math.random().toString(36).substr(2, 9)}`;
+        return `sdk-${crypto_1.default.randomBytes(16).toString('hex')}`;
     }
     /**
      * Compare faces between document and live capture

package/dist/encryption/index.d.ts

@@ -35,4 +35,4 @@ export declare function encryptImages(images: string[], encryptionKey?: string):
 /**
  * Create integrity signature for data
  */
-export declare function createIntegritySignature(data: any): string;
+export declare function createIntegritySignature(data: any, key: string): string;

package/dist/encryption/index.js

@@ -90,10 +90,10 @@ async function encryptImages(images, encryptionKey) {
 /**
  * Create integrity signature for data
  */
-function createIntegritySignature(data) {
+function createIntegritySignature(data, key) {
     const dataString = JSON.stringify(data);
     return crypto_1.default
-        .createHmac('sha256', 'biometric-identity-sdk')
+        .createHmac('sha256', key)
         .update(dataString)
         .digest('hex');
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hexar/biometric-identity-sdk-core",
-  "version": "1.2.1",
+  "version": "1.4.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/api/BackendClient.ts

@@ -3,12 +3,13 @@
  * Communicates with the Python backend for AI-powered validation
  */
 
-import { 
-  ValidationResult, 
-  VideoResult, 
+import crypto from 'crypto';
+import {
+  ValidationResult,
+  VideoResult,
   LivenessValidationResult,
   DocumentData,
-  BiometricConfig 
+  BiometricConfig
 } from '../types';
 import { logger } from '../utils/logger';
 
@@ -221,7 +222,7 @@ export class BackendClient {
   }
 
   private generateSDKSessionId(): string {
-    return `sdk-${Date.now()}-${Math.random().toString(36).substr(2, 9)}`;
+    return `sdk-${crypto.randomBytes(16).toString('hex')}`;
   }
 
   /**

package/src/encryption/index.ts

@@ -99,10 +99,10 @@ export async function encryptImages(
 /**
  * Create integrity signature for data
  */
-export function createIntegritySignature(data: any): string {
+export function createIntegritySignature(data: any, key: string): string {
   const dataString = JSON.stringify(data);
   return crypto
-    .createHmac('sha256', 'biometric-identity-sdk')
+    .createHmac('sha256', key)
     .update(dataString)
     .digest('hex');
 }