@hexar/biometric-identity-sdk-core 1.0.8 → 1.0.10

package/dist/BiometricIdentitySDK.js

@@ -8,6 +8,7 @@ exports.BiometricIdentitySDK = void 0;
 const types_1 = require("./types");
 const BackendClient_1 = require("./api/BackendClient");
 const i18n_1 = require("./i18n");
+const logger_1 = require("./utils/logger");
 const API_ENDPOINT = 'https://biometry.hexar.com.ar';
 class BiometricIdentitySDK {
     constructor(config) {
@@ -43,7 +44,7 @@ class BiometricIdentitySDK {
      */
     static configure(apiKey, options) {
         if (BiometricIdentitySDK.instance) {
-            console.warn('SDK already initialized');
+            logger_1.logger.warn('SDK already initialized');
             return;
         }
         const language = options?.language || 'en';
@@ -74,21 +75,17 @@ class BiometricIdentitySDK {
      */
     async initialize() {
         try {
-            console.log('Initializing Biometric Identity SDK...');
             this.updateState({ isLoading: true, progress: 0 });
             // Check backend availability
-            console.log('Checking backend availability...');
             this.isBackendAvailable = await this.backendClient.healthCheck();
             if (!this.isBackendAvailable) {
                 throw this.createError(types_1.BiometricErrorCode.NETWORK_ERROR, 'Backend server is not available. Please check your API endpoint configuration and try again.');
             }
-            console.log('✓ Backend is available - ready for validation');
             this.updateState({
                 isLoading: false,
                 progress: 0,
                 currentStep: types_1.SDKStep.CAPTURE_FRONT_ID
             });
-            console.log('SDK initialized successfully');
         }
         catch (error) {
             throw this.createError(types_1.BiometricErrorCode.MODEL_LOAD_FAILED, 'Failed to initialize SDK: Backend not available', error);
@@ -104,7 +101,6 @@ class BiometricIdentitySDK {
         }
         try {
             const challenge = await this.backendClient.generateChallenge(challengeType);
-            console.log(`Generated challenge with ${challenge.challenges.length} actions`);
             return challenge;
         }
         catch (error) {
@@ -156,7 +152,6 @@ class BiometricIdentitySDK {
                 isLoading: false,
                 currentStep: types_1.SDKStep.CAPTURE_BACK_ID
             });
-            console.log('Front ID uploaded successfully');
         }
         catch (error) {
             this.handleError(error);
@@ -177,7 +172,6 @@ class BiometricIdentitySDK {
                 isLoading: false,
                 currentStep: types_1.SDKStep.RECORD_LIVENESS
             });
-            console.log('Back ID uploaded successfully');
         }
         catch (error) {
             this.handleError(error);
@@ -195,7 +189,6 @@ class BiometricIdentitySDK {
                 progress: 75,
                 isLoading: false,
             });
-            console.log('Video recording stored successfully');
         }
         catch (error) {
             this.handleError(error);
@@ -221,7 +214,6 @@ class BiometricIdentitySDK {
                 progress: 75,
                 isLoading: false,
             });
-            console.log('Video liveness recorded successfully');
             return videoResult;
         }
         catch (error) {
@@ -254,7 +246,6 @@ class BiometricIdentitySDK {
                 isLoading: false,
                 currentStep: types_1.SDKStep.RESULT
             });
-            console.log('Validation completed successfully');
             return validationResult;
         }
         catch (error) {
@@ -269,13 +260,24 @@ class BiometricIdentitySDK {
         if (!this.state.frontID || !this.state.videoData) {
             throw new Error('Required data not available');
         }
-        console.log('Validating with backend API...');
         this.updateState({ progress: 80 });
         try {
+            // Limit and sample video frames to prevent payload size issues
+            // Take max 30 frames, sampling evenly across the video
+            let videoFrames = this.state.videoData.frames;
+            if (videoFrames.length === 0) {
+                throw new Error('No video frames available for validation');
+            }
+            // Sample frames if we have too many (max 30 frames to keep payload reasonable)
+            const MAX_FRAMES = 30;
+            if (videoFrames.length > MAX_FRAMES) {
+                const step = Math.floor(videoFrames.length / MAX_FRAMES);
+                videoFrames = videoFrames.filter((_, index) => index % step === 0).slice(0, MAX_FRAMES);
+            }
             const response = await this.backendClient.fullValidation({
                 frontIdImage: this.state.frontID.data,
                 backIdImage: this.state.backID?.data,
-                videoFrames: this.state.videoData.frames,
+                videoFrames: videoFrames,
                 videoDurationMs: this.state.videoData.duration,
                 challengesCompleted: this.state.videoData.challengesCompleted || [],
             });
@@ -387,7 +389,7 @@ class BiometricIdentitySDK {
      */
     dispose() {
         // No local resources to clean up
-        console.log('SDK disposed');
+        logger_1.logger.info('SDK disposed');
     }
 }
 exports.BiometricIdentitySDK = BiometricIdentitySDK;

package/dist/ai-models/FaceDetector.js

@@ -7,6 +7,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.FaceDetector = void 0;
 exports.calculateFaceDistance = calculateFaceDistance;
 exports.calculateFaceSimilarity = calculateFaceSimilarity;
+const logger_1 = require("../utils/logger");
 class FaceDetector {
     constructor(modelPath) {
         this.modelPath = modelPath;
@@ -21,11 +22,11 @@ class FaceDetector {
         try {
             // In a real implementation, this would load the actual ONNX model
             // For now, we'll create a mock implementation
-            console.log('Loading face detection model...');
+            logger_1.logger.info('Loading face detection model...');
             // Simulate model loading
             await new Promise(resolve => setTimeout(resolve, 500));
             this.isModelLoaded = true;
-            console.log('Face detection model loaded successfully');
+            logger_1.logger.info('Face detection model loaded successfully');
         }
         catch (error) {
             throw new Error(`Failed to load face detection model: ${error}`);

package/dist/ai-models/LivenessDetector.js

@@ -6,6 +6,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.LivenessDetector = void 0;
 const FaceDetector_1 = require("./FaceDetector");
+const logger_1 = require("../utils/logger");
 class LivenessDetector {
     constructor(modelPath) {
         this.modelPath = modelPath;
@@ -19,13 +20,13 @@ class LivenessDetector {
         if (this.isModelLoaded)
             return;
         try {
-            console.log('Loading liveness detection model...');
+            logger_1.logger.info('Loading liveness detection model...');
             // Load face detector
             await this.faceDetector.loadModel();
             // Simulate liveness model loading
             await new Promise(resolve => setTimeout(resolve, 500));
             this.isModelLoaded = true;
-            console.log('Liveness detection model loaded successfully');
+            logger_1.logger.info('Liveness detection model loaded successfully');
         }
         catch (error) {
             throw new Error(`Failed to load liveness detection model: ${error}`);
@@ -101,7 +102,7 @@ class LivenessDetector {
             return hasMotion;
         }
         catch (error) {
-            console.error('Motion check failed:', error);
+            logger_1.logger.error('Motion check failed:', error);
             return false;
         }
     }

package/dist/api/BackendClient.js

@@ -5,6 +5,7 @@
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.BackendClient = void 0;
+const logger_1 = require("../utils/logger");
 /**
  * Client for communicating with the Biometric Identity Backend
  */
@@ -28,7 +29,7 @@ class BackendClient {
             return response.status === 'healthy';
         }
         catch (error) {
-            console.warn('Backend health check failed:', error);
+            logger_1.logger.warn('Backend health check failed:', error);
             return false;
         }
     }
@@ -188,6 +189,10 @@ class BackendClient {
             });
             clearTimeout(timeoutId);
             if (!response.ok) {
+                // Handle 413 Payload Too Large specifically
+                if (response.status === 413) {
+                    throw new Error(`Payload too large (413). The request body exceeds the server's size limit. Try reducing the number of video frames or image sizes.`);
+                }
                 const errorData = await response.json().catch(() => ({}));
                 throw new Error(errorData?.error?.message ||
                     errorData?.detail ||

package/dist/i18n/index.js

@@ -19,6 +19,7 @@ const en_1 = require("./languages/en");
 const es_1 = require("./languages/es");
 const es_AR_1 = require("./languages/es-AR");
 const pt_BR_1 = require("./languages/pt-BR");
+const logger_1 = require("../utils/logger");
 const languages = {
     'en': en_1.en,
     'es': es_1.es,
@@ -31,7 +32,7 @@ const setLanguage = (lang) => {
         currentLanguage = lang;
     }
     else {
-        console.warn(`Language ${lang} not supported, falling back to English`);
+        logger_1.logger.warn(`Language ${lang} not supported, falling back to English`);
         currentLanguage = 'en';
     }
 };

package/dist/index.d.ts

@@ -17,4 +17,5 @@ export type { BackendValidationServiceConfig } from './services/BackendValidatio
 export type { IValidationService, LivenessChallenge, DocumentValidationResult, LivenessResult, FaceMatchResult, } from './services/IValidationService';
 export { getStrings, setLanguage, getCurrentLanguage } from './i18n';
 export type { SupportedLanguage, LanguageStrings } from './i18n';
+export { logger } from './utils/logger';
 export declare const SDK_VERSION = "1.0.0";

package/dist/index.js

@@ -21,7 +21,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.SDK_VERSION = exports.getCurrentLanguage = exports.setLanguage = exports.getStrings = exports.BackendValidationService = exports.BackendClient = exports.createIntegritySignature = exports.encryptImages = exports.EncryptionService = exports.isValidDate = exports.cleanText = exports.OCREngine = exports.meetsQualityStandards = exports.DocumentValidator = exports.LivenessDetector = exports.calculateFaceDistance = exports.calculateFaceSimilarity = exports.FaceDetector = exports.default = exports.BiometricIdentitySDK = void 0;
+exports.SDK_VERSION = exports.logger = exports.getCurrentLanguage = exports.setLanguage = exports.getStrings = exports.BackendValidationService = exports.BackendClient = exports.createIntegritySignature = exports.encryptImages = exports.EncryptionService = exports.isValidDate = exports.cleanText = exports.OCREngine = exports.meetsQualityStandards = exports.DocumentValidator = exports.LivenessDetector = exports.calculateFaceDistance = exports.calculateFaceSimilarity = exports.FaceDetector = exports.default = exports.BiometricIdentitySDK = void 0;
 // Main SDK class
 var BiometricIdentitySDK_1 = require("./BiometricIdentitySDK");
 Object.defineProperty(exports, "BiometricIdentitySDK", { enumerable: true, get: function () { return BiometricIdentitySDK_1.BiometricIdentitySDK; } });
@@ -60,5 +60,8 @@ var i18n_1 = require("./i18n");
 Object.defineProperty(exports, "getStrings", { enumerable: true, get: function () { return i18n_1.getStrings; } });
 Object.defineProperty(exports, "setLanguage", { enumerable: true, get: function () { return i18n_1.setLanguage; } });
 Object.defineProperty(exports, "getCurrentLanguage", { enumerable: true, get: function () { return i18n_1.getCurrentLanguage; } });
+// Logger
+var logger_1 = require("./utils/logger");
+Object.defineProperty(exports, "logger", { enumerable: true, get: function () { return logger_1.logger; } });
 // Version
 exports.SDK_VERSION = '1.0.0';

package/dist/utils/logger.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Professional logging utility for Hexar Biometry SDK
+ */
+export declare const logger: {
+    info: (message: string, ...args: any[]) => void;
+    warn: (message: string, ...args: any[]) => void;
+    error: (message: string, ...args: any[]) => void;
+};

package/dist/utils/logger.js

@@ -0,0 +1,34 @@
+"use strict";
+/**
+ * Professional logging utility for Hexar Biometry SDK
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.logger = void 0;
+const PREFIX = 'Hexar Biometry';
+function formatTimestamp() {
+    const now = new Date();
+    const hours = now.getHours().toString().padStart(2, '0');
+    const minutes = now.getMinutes().toString().padStart(2, '0');
+    const seconds = now.getSeconds().toString().padStart(2, '0');
+    const milliseconds = now.getMilliseconds().toString().padStart(3, '0');
+    return `${hours}:${minutes}:${seconds}.${milliseconds}`;
+}
+function formatMessage(level, message, ...args) {
+    const timestamp = formatTimestamp();
+    const prefix = `${timestamp} [${PREFIX}]`;
+    if (args.length > 0) {
+        return `${prefix} ${message} ${args.map(arg => typeof arg === 'object' ? JSON.stringify(arg, null, 2) : String(arg)).join(' ')}`;
+    }
+    return `${prefix} ${message}`;
+}
+exports.logger = {
+    info: (message, ...args) => {
+        console.log(formatMessage('info', message, ...args));
+    },
+    warn: (message, ...args) => {
+        console.warn(formatMessage('warn', message, ...args));
+    },
+    error: (message, ...args) => {
+        console.error(formatMessage('error', message, ...args));
+    },
+};

package/dist/validation/DocumentValidator.js

@@ -5,6 +5,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.DocumentValidator = void 0;
 exports.meetsQualityStandards = meetsQualityStandards;
+const logger_1 = require("../utils/logger");
 class DocumentValidator {
     constructor(modelPath) {
         this.modelPath = modelPath;
@@ -17,11 +18,11 @@ class DocumentValidator {
         if (this.isModelLoaded)
             return;
         try {
-            console.log('Loading document validation model...');
+            logger_1.logger.info('Loading document validation model...');
             // Simulate model loading
             await new Promise(resolve => setTimeout(resolve, 300));
             this.isModelLoaded = true;
-            console.log('Document validation model loaded successfully');
+            logger_1.logger.info('Document validation model loaded successfully');
         }
         catch (error) {
             throw new Error(`Failed to load document validation model: ${error}`);

package/dist/validation/OCREngine.js

@@ -6,6 +6,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.OCREngine = void 0;
 exports.cleanText = cleanText;
 exports.isValidDate = isValidDate;
+const logger_1 = require("../utils/logger");
 class OCREngine {
     constructor() {
         this.isInitialized = false;
@@ -17,12 +18,12 @@ class OCREngine {
         if (this.isInitialized)
             return;
         try {
-            console.log('Initializing OCR engine...');
+            logger_1.logger.info('Initializing OCR engine...');
             // In real implementation, would initialize Tesseract.js
             // await createWorker();
             await new Promise(resolve => setTimeout(resolve, 500));
             this.isInitialized = true;
-            console.log('OCR engine initialized successfully');
+            logger_1.logger.info('OCR engine initialized successfully');
         }
         catch (error) {
             throw new Error(`Failed to initialize OCR engine: ${error}`);

package/package.json

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

package/src/BiometricIdentitySDK.ts

@@ -15,6 +15,7 @@ import {
 } from './types';
 import { BackendClient, ChallengeResponse, ChallengeAction } from './api/BackendClient';
 import { setLanguage, SupportedLanguage } from './i18n';
+import { logger } from './utils/logger';
 
 const API_ENDPOINT = 'https://biometry.hexar.com.ar';
 
@@ -61,7 +62,7 @@ export class BiometricIdentitySDK {
    */
   static configure(apiKey: string, options?: { language?: SupportedLanguage }): void {
     if (BiometricIdentitySDK.instance) {
-      console.warn('SDK already initialized');
+      logger.warn('SDK already initialized');
       return;
     }
 
@@ -97,11 +98,9 @@ export class BiometricIdentitySDK {
    */
   async initialize(): Promise<void> {
     try {
-      console.log('Initializing Biometric Identity SDK...');
       this.updateState({ isLoading: true, progress: 0 });
 
       // Check backend availability
-      console.log('Checking backend availability...');
       this.isBackendAvailable = await this.backendClient.healthCheck();
       
       if (!this.isBackendAvailable) {
@@ -111,7 +110,6 @@ export class BiometricIdentitySDK {
         );
       }
 
-      console.log('✓ Backend is available - ready for validation');
 
       this.updateState({ 
         isLoading: false, 
@@ -119,7 +117,6 @@ export class BiometricIdentitySDK {
         currentStep: SDKStep.CAPTURE_FRONT_ID 
       });
       
-      console.log('SDK initialized successfully');
     } catch (error) {
       throw this.createError(
         BiometricErrorCode.MODEL_LOAD_FAILED,
@@ -145,7 +142,6 @@ export class BiometricIdentitySDK {
 
     try {
       const challenge = await this.backendClient.generateChallenge(challengeType);
-      console.log(`Generated challenge with ${challenge.challenges.length} actions`);
       return challenge;
     } catch (error) {
       throw this.createError(
@@ -206,7 +202,6 @@ export class BiometricIdentitySDK {
         currentStep: SDKStep.CAPTURE_BACK_ID
       });
 
-      console.log('Front ID uploaded successfully');
     } catch (error) {
       this.handleError(error);
       throw error;
@@ -230,7 +225,6 @@ export class BiometricIdentitySDK {
         currentStep: SDKStep.RECORD_LIVENESS
       });
 
-      console.log('Back ID uploaded successfully');
     } catch (error) {
       this.handleError(error);
       throw error;
@@ -250,7 +244,6 @@ export class BiometricIdentitySDK {
         isLoading: false,
       });
 
-      console.log('Video recording stored successfully');
     } catch (error) {
       this.handleError(error);
       throw error;
@@ -282,7 +275,6 @@ export class BiometricIdentitySDK {
         isLoading: false,
       });
 
-      console.log('Video liveness recorded successfully');
       return videoResult;
     } catch (error) {
       this.handleError(error);
@@ -326,7 +318,6 @@ export class BiometricIdentitySDK {
         currentStep: SDKStep.RESULT
       });
 
-      console.log('Validation completed successfully');
       return validationResult;
 
     } catch (error) {
@@ -343,14 +334,27 @@ export class BiometricIdentitySDK {
       throw new Error('Required data not available');
     }
 
-    console.log('Validating with backend API...');
     this.updateState({ progress: 80 });
 
     try {
+      // Limit and sample video frames to prevent payload size issues
+      // Take max 30 frames, sampling evenly across the video
+      let videoFrames = this.state.videoData.frames;
+      if (videoFrames.length === 0) {
+        throw new Error('No video frames available for validation');
+      }
+      
+      // Sample frames if we have too many (max 30 frames to keep payload reasonable)
+      const MAX_FRAMES = 30;
+      if (videoFrames.length > MAX_FRAMES) {
+        const step = Math.floor(videoFrames.length / MAX_FRAMES);
+        videoFrames = videoFrames.filter((_, index) => index % step === 0).slice(0, MAX_FRAMES);
+      }
+      
       const response = await this.backendClient.fullValidation({
         frontIdImage: this.state.frontID.data,
         backIdImage: this.state.backID?.data,
-        videoFrames: this.state.videoData.frames,
+        videoFrames: videoFrames,
         videoDurationMs: this.state.videoData.duration,
         challengesCompleted: this.state.videoData.challengesCompleted || [],
       });
@@ -486,7 +490,7 @@ export class BiometricIdentitySDK {
    */
   dispose(): void {
     // No local resources to clean up
-    console.log('SDK disposed');
+    logger.info('SDK disposed');
   }
 }
 

package/src/ai-models/FaceDetector.ts

@@ -4,6 +4,7 @@
  */
 
 import { FaceEmbedding, BoundingBox } from '../types';
+import { logger } from '../utils/logger';
 
 export interface FaceDetectionResult {
   faces: FaceEmbedding[];
@@ -25,13 +26,13 @@ export class FaceDetector {
     try {
       // In a real implementation, this would load the actual ONNX model
       // For now, we'll create a mock implementation
-      console.log('Loading face detection model...');
+      logger.info('Loading face detection model...');
       
       // Simulate model loading
       await new Promise(resolve => setTimeout(resolve, 500));
       
       this.isModelLoaded = true;
-      console.log('Face detection model loaded successfully');
+      logger.info('Face detection model loaded successfully');
     } catch (error) {
       throw new Error(`Failed to load face detection model: ${error}`);
     }

package/src/ai-models/LivenessDetector.ts

@@ -5,6 +5,7 @@
 
 import { LivenessValidationResult, VideoResult, LivenessInstruction } from '../types';
 import { FaceDetector } from './FaceDetector';
+import { logger } from '../utils/logger';
 
 export interface LivenessFrame {
   imageData: string;
@@ -28,7 +29,7 @@ export class LivenessDetector {
     if (this.isModelLoaded) return;
 
     try {
-      console.log('Loading liveness detection model...');
+      logger.info('Loading liveness detection model...');
       
       // Load face detector
       await this.faceDetector.loadModel();
@@ -37,7 +38,7 @@ export class LivenessDetector {
       await new Promise(resolve => setTimeout(resolve, 500));
       
       this.isModelLoaded = true;
-      console.log('Liveness detection model loaded successfully');
+      logger.info('Liveness detection model loaded successfully');
     } catch (error) {
       throw new Error(`Failed to load liveness detection model: ${error}`);
     }
@@ -125,7 +126,7 @@ export class LivenessDetector {
 
       return hasMotion;
     } catch (error) {
-      console.error('Motion check failed:', error);
+      logger.error('Motion check failed:', error);
       return false;
     }
   }

package/src/api/BackendClient.ts

@@ -10,6 +10,7 @@ import {
   DocumentData,
   BiometricConfig 
 } from '../types';
+import { logger } from '../utils/logger';
 
 export interface ChallengeAction {
   action: string;
@@ -153,7 +154,7 @@ export class BackendClient {
       const response = await this.request<{ status: string }>('/api/v1/health', 'GET');
       return response.status === 'healthy';
     } catch (error) {
-      console.warn('Backend health check failed:', error);
+      logger.warn('Backend health check failed:', error);
       return false;
     }
   }
@@ -381,6 +382,13 @@ export class BackendClient {
       clearTimeout(timeoutId);
 
       if (!response.ok) {
+        // Handle 413 Payload Too Large specifically
+        if (response.status === 413) {
+          throw new Error(
+            `Payload too large (413). The request body exceeds the server's size limit. Try reducing the number of video frames or image sizes.`
+          );
+        }
+        
         const errorData = await response.json().catch(() => ({})) as Record<string, any>;
         throw new Error(
           errorData?.error?.message || 

package/src/i18n/index.ts

@@ -3,6 +3,7 @@ import { en } from './languages/en';
 import { es } from './languages/es';
 import { esAR } from './languages/es-AR';
 import { ptBR } from './languages/pt-BR';
+import { logger } from '../utils/logger';
 
 const languages: Record<SupportedLanguage, LanguageStrings> = {
   'en': en,
@@ -17,7 +18,7 @@ export const setLanguage = (lang: SupportedLanguage): void => {
   if (languages[lang]) {
     currentLanguage = lang;
   } else {
-    console.warn(`Language ${lang} not supported, falling back to English`);
+    logger.warn(`Language ${lang} not supported, falling back to English`);
     currentLanguage = 'en';
   }
 };

package/src/index.ts

@@ -48,6 +48,9 @@ export type {
 export { getStrings, setLanguage, getCurrentLanguage } from './i18n';
 export type { SupportedLanguage, LanguageStrings } from './i18n';
 
+// Logger
+export { logger } from './utils/logger';
+
 // Version
 export const SDK_VERSION = '1.0.0';
 

package/src/utils/logger.ts

@@ -0,0 +1,44 @@
+/**
+ * Professional logging utility for Hexar Biometry SDK
+ */
+
+const PREFIX = 'Hexar Biometry';
+
+type LogLevel = 'info' | 'warn' | 'error';
+
+function formatTimestamp(): string {
+  const now = new Date();
+  const hours = now.getHours().toString().padStart(2, '0');
+  const minutes = now.getMinutes().toString().padStart(2, '0');
+  const seconds = now.getSeconds().toString().padStart(2, '0');
+  const milliseconds = now.getMilliseconds().toString().padStart(3, '0');
+  return `${hours}:${minutes}:${seconds}.${milliseconds}`;
+}
+
+function formatMessage(level: LogLevel, message: string, ...args: any[]): string {
+  const timestamp = formatTimestamp();
+  const prefix = `${timestamp} [${PREFIX}]`;
+  
+  if (args.length > 0) {
+    return `${prefix} ${message} ${args.map(arg => 
+      typeof arg === 'object' ? JSON.stringify(arg, null, 2) : String(arg)
+    ).join(' ')}`;
+  }
+  
+  return `${prefix} ${message}`;
+}
+
+export const logger = {
+  info: (message: string, ...args: any[]) => {
+    console.log(formatMessage('info', message, ...args));
+  },
+  
+  warn: (message: string, ...args: any[]) => {
+    console.warn(formatMessage('warn', message, ...args));
+  },
+  
+  error: (message: string, ...args: any[]) => {
+    console.error(formatMessage('error', message, ...args));
+  },
+};
+

package/src/validation/DocumentValidator.ts

@@ -3,6 +3,7 @@
  */
 
 import { DocumentValidationResult, BoundingBox } from '../types';
+import { logger } from '../utils/logger';
 
 export class DocumentValidator {
   private model: any;
@@ -17,13 +18,13 @@ export class DocumentValidator {
     if (this.isModelLoaded) return;
 
     try {
-      console.log('Loading document validation model...');
+      logger.info('Loading document validation model...');
       
       // Simulate model loading
       await new Promise(resolve => setTimeout(resolve, 300));
       
       this.isModelLoaded = true;
-      console.log('Document validation model loaded successfully');
+      logger.info('Document validation model loaded successfully');
     } catch (error) {
       throw new Error(`Failed to load document validation model: ${error}`);
     }

package/src/validation/OCREngine.ts

@@ -3,6 +3,7 @@
  */
 
 import { DocumentData } from '../types';
+import { logger } from '../utils/logger';
 
 export interface OCRResult {
   text: string;
@@ -28,7 +29,7 @@ export class OCREngine {
     if (this.isInitialized) return;
 
     try {
-      console.log('Initializing OCR engine...');
+      logger.info('Initializing OCR engine...');
       
       // In real implementation, would initialize Tesseract.js
       // await createWorker();
@@ -36,7 +37,7 @@ export class OCREngine {
       await new Promise(resolve => setTimeout(resolve, 500));
       
       this.isInitialized = true;
-      console.log('OCR engine initialized successfully');
+      logger.info('OCR engine initialized successfully');
     } catch (error) {
       throw new Error(`Failed to initialize OCR engine: ${error}`);
     }