@hexar/biometric-identity-sdk-core 1.0.20 → 1.1.0

package/dist/BiometricIdentitySDK.d.ts

@@ -62,6 +62,22 @@ export declare class BiometricIdentitySDK {
         duration?: number;
         instructions?: string[];
     }): Promise<VideoResult>;
+    /**
+     * Validate profile picture with liveness detection
+     * Uses backend AI for validation
+     */
+    validateProfilePicture(params: {
+        sessionId: string;
+        videoFrames: string[];
+        videoDurationMs: number;
+        challengesCompleted?: string[];
+    }): Promise<{
+        isValid: boolean;
+        profilePicture: string;
+        livenessScore: number;
+        faceDetected: boolean;
+        warnings: string[];
+    }>;
     /**
      * Validate identity using all collected data
      * Uses backend AI for validation

package/dist/BiometricIdentitySDK.js

@@ -234,6 +234,47 @@ class BiometricIdentitySDK {
             throw error;
         }
     }
+    /**
+     * Validate profile picture with liveness detection
+     * Uses backend AI for validation
+     */
+    async validateProfilePicture(params) {
+        try {
+            if (!this.isBackendAvailable) {
+                throw this.createError(types_1.BiometricErrorCode.NETWORK_ERROR, 'Backend not available. Cannot perform validation.');
+            }
+            if (!params.videoFrames || params.videoFrames.length === 0) {
+                throw this.createError(types_1.BiometricErrorCode.UNKNOWN_ERROR, 'No video frames provided for validation.');
+            }
+            this.updateState({
+                isLoading: true,
+                currentStep: types_1.SDKStep.VALIDATING,
+                progress: 75
+            });
+            // Perform backend validation
+            const response = await this.backendClient.validateProfilePicture({
+                sessionId: params.sessionId,
+                videoFrames: params.videoFrames,
+                videoDurationMs: params.videoDurationMs,
+                challengesCompleted: params.challengesCompleted,
+            });
+            this.updateState({
+                progress: 100,
+                isLoading: false,
+            });
+            return {
+                isValid: response.is_valid,
+                profilePicture: response.profile_picture,
+                livenessScore: response.liveness_score,
+                faceDetected: response.face_detected,
+                warnings: response.warnings || [],
+            };
+        }
+        catch (error) {
+            this.handleError(error);
+            throw error;
+        }
+    }
     /**
      * Validate identity using all collected data
      * Uses backend AI for validation

package/dist/api/BackendClient.d.ts

@@ -110,6 +110,21 @@ export interface FullValidationResponse {
     timestamp: string;
     transaction_id: string;
 }
+export interface ProfilePictureValidationResponse {
+    success: boolean;
+    is_valid: boolean;
+    liveness_score: number;
+    profile_picture: string;
+    face_detected: boolean;
+    checks: Array<{
+        name: string;
+        passed: boolean;
+        score: number;
+        details?: string;
+    }>;
+    warnings: string[];
+    session_id?: string;
+}
 export interface BackendClientConfig {
     /** Backend API URL */
     apiEndpoint: string;
@@ -160,6 +175,15 @@ export declare class BackendClient {
         countryCode?: string;
         deviceInfo?: Record<string, any>;
     }): Promise<FullValidationResponse>;
+    /**
+     * Validate profile picture with liveness detection
+     */
+    validateProfilePicture(params: {
+        sessionId: string;
+        videoFrames: string[];
+        videoDurationMs: number;
+        challengesCompleted?: string[];
+    }): Promise<ProfilePictureValidationResponse>;
     /**
      * Convert backend response to SDK ValidationResult format
      */

package/dist/api/BackendClient.js

@@ -116,6 +116,27 @@ class BackendClient {
         });
         return this.request('/api/v1/validate', 'POST', requestBody);
     }
+    /**
+     * Validate profile picture with liveness detection
+     */
+    async validateProfilePicture(params) {
+        if (!this.currentSessionId && params.sessionId) {
+            this.currentSessionId = params.sessionId;
+        }
+        const requestBody = {
+            session_id: this.currentSessionId || params.sessionId,
+            video_frames: params.videoFrames,
+            video_duration_ms: params.videoDurationMs,
+            challenges_completed: params.challengesCompleted || [],
+        };
+        logger_1.logger.info('Profile picture validation request', {
+            hasSessionId: !!this.currentSessionId,
+            sessionId: this.currentSessionId || params.sessionId,
+            videoFramesCount: params.videoFrames.length,
+            videoDurationMs: params.videoDurationMs,
+        });
+        return this.request('/api/v1/profile/validate-face', 'POST', requestBody);
+    }
     /**
      * Convert backend response to SDK ValidationResult format
      */

package/dist/i18n/languages/en.js

@@ -79,6 +79,7 @@ exports.en = {
         checkingLiveness: 'Verifying liveness...',
         matchingFaces: 'Matching faces...',
         almostDone: 'Almost done...',
+        validatingDocumentAndFace: 'Validating document and face...',
     },
     result: {
         success: {

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

@@ -79,6 +79,7 @@ exports.esAR = {
         checkingLiveness: 'Verificando prueba de vida...',
         matchingFaces: 'Comparando rostros...',
         almostDone: 'Ya casi terminamos...',
+        validatingDocumentAndFace: 'Validando documento y rostro...',
     },
     result: {
         success: {

package/dist/i18n/languages/es.js

@@ -79,6 +79,7 @@ exports.es = {
         checkingLiveness: 'Verificando prueba de vida...',
         matchingFaces: 'Comparando rostros...',
         almostDone: 'Casi terminamos...',
+        validatingDocumentAndFace: 'Validando documento y rostro...',
     },
     result: {
         success: {

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

@@ -79,6 +79,7 @@ exports.ptBR = {
         checkingLiveness: 'Verificando prova de vida...',
         matchingFaces: 'Comparando rostos...',
         almostDone: 'Quase pronto...',
+        validatingDocumentAndFace: 'Validando documento e rosto...',
     },
     result: {
         success: {

package/dist/i18n/types.d.ts

@@ -77,6 +77,7 @@ export interface LanguageStrings {
         checkingLiveness: string;
         matchingFaces: string;
         almostDone: string;
+        validatingDocumentAndFace: string;
     };
     result: {
         success: {

package/package.json

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

package/src/BiometricIdentitySDK.ts

@@ -298,6 +298,69 @@ export class BiometricIdentitySDK {
     }
   }
 
+  /**
+   * Validate profile picture with liveness detection
+   * Uses backend AI for validation
+   */
+  async validateProfilePicture(params: {
+    sessionId: string;
+    videoFrames: string[];
+    videoDurationMs: number;
+    challengesCompleted?: string[];
+  }): Promise<{
+    isValid: boolean;
+    profilePicture: string;
+    livenessScore: number;
+    faceDetected: boolean;
+    warnings: string[];
+  }> {
+    try {
+      if (!this.isBackendAvailable) {
+        throw this.createError(
+          BiometricErrorCode.NETWORK_ERROR,
+          'Backend not available. Cannot perform validation.'
+        );
+      }
+
+      if (!params.videoFrames || params.videoFrames.length === 0) {
+        throw this.createError(
+          BiometricErrorCode.UNKNOWN_ERROR,
+          'No video frames provided for validation.'
+        );
+      }
+
+      this.updateState({ 
+        isLoading: true, 
+        currentStep: SDKStep.VALIDATING,
+        progress: 75 
+      });
+
+      // Perform backend validation
+      const response = await this.backendClient.validateProfilePicture({
+        sessionId: params.sessionId,
+        videoFrames: params.videoFrames,
+        videoDurationMs: params.videoDurationMs,
+        challengesCompleted: params.challengesCompleted,
+      });
+
+      this.updateState({ 
+        progress: 100,
+        isLoading: false,
+      });
+
+      return {
+        isValid: response.is_valid,
+        profilePicture: response.profile_picture,
+        livenessScore: response.liveness_score,
+        faceDetected: response.face_detected,
+        warnings: response.warnings || [],
+      };
+    } catch (error) {
+      this.handleError(error);
+      throw error;
+    }
+  }
+
   /**
    * Validate identity using all collected data
    * Uses backend AI for validation

package/src/api/BackendClient.ts

@@ -120,6 +120,22 @@ export interface FullValidationResponse {
   transaction_id: string;
 }
 
+export interface ProfilePictureValidationResponse {
+  success: boolean;
+  is_valid: boolean;
+  liveness_score: number;
+  profile_picture: string;
+  face_detected: boolean;
+  checks: Array<{
+    name: string;
+    passed: boolean;
+    score: number;
+    details?: string;
+  }>;
+  warnings: string[];
+  session_id?: string;
+}
+
 export interface BackendClientConfig {
   /** Backend API URL */
   apiEndpoint: string;
@@ -297,6 +313,40 @@ export class BackendClient {
     );
   }
 
+  /**
+   * Validate profile picture with liveness detection
+   */
+  async validateProfilePicture(params: {
+    sessionId: string;
+    videoFrames: string[];
+    videoDurationMs: number;
+    challengesCompleted?: string[];
+  }): Promise<ProfilePictureValidationResponse> {
+    if (!this.currentSessionId && params.sessionId) {
+      this.currentSessionId = params.sessionId;
+    }
+
+    const requestBody = {
+      session_id: this.currentSessionId || params.sessionId,
+      video_frames: params.videoFrames,
+      video_duration_ms: params.videoDurationMs,
+      challenges_completed: params.challengesCompleted || [],
+    };
+
+    logger.info('Profile picture validation request', {
+      hasSessionId: !!this.currentSessionId,
+      sessionId: this.currentSessionId || params.sessionId,
+      videoFramesCount: params.videoFrames.length,
+      videoDurationMs: params.videoDurationMs,
+    });
+
+    return this.request<ProfilePictureValidationResponse>(
+      '/api/v1/profile/validate-face',
+      'POST',
+      requestBody
+    );
+  }
+
   /**
    * Convert backend response to SDK ValidationResult format
    */

package/src/i18n/languages/en.ts

@@ -83,6 +83,7 @@ export const en: LanguageStrings = {
     checkingLiveness: 'Verifying liveness...',
     matchingFaces: 'Matching faces...',
     almostDone: 'Almost done...',
+    validatingDocumentAndFace: 'Validating document and face...',
   },
   
   result: {

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

@@ -83,6 +83,7 @@ export const esAR: LanguageStrings = {
     checkingLiveness: 'Verificando prueba de vida...',
     matchingFaces: 'Comparando rostros...',
     almostDone: 'Ya casi terminamos...',
+    validatingDocumentAndFace: 'Validando documento y rostro...',
   },
   
   result: {

package/src/i18n/languages/es.ts

@@ -83,6 +83,7 @@ export const es: LanguageStrings = {
     checkingLiveness: 'Verificando prueba de vida...',
     matchingFaces: 'Comparando rostros...',
     almostDone: 'Casi terminamos...',
+    validatingDocumentAndFace: 'Validando documento y rostro...',
   },
   
   result: {

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

@@ -83,6 +83,7 @@ export const ptBR: LanguageStrings = {
     checkingLiveness: 'Verificando prova de vida...',
     matchingFaces: 'Comparando rostos...',
     almostDone: 'Quase pronto...',
+    validatingDocumentAndFace: 'Validando documento e rosto...',
   },
   
   result: {

package/src/i18n/types.ts

@@ -83,6 +83,7 @@ export interface LanguageStrings {
     checkingLiveness: string;
     matchingFaces: string;
     almostDone: string;
+    validatingDocumentAndFace: string;
   };
   
   result: {