@jaak.ai/stamps 2.0.0-dev.28 → 2.0.0-dev.30

package/dist/collection/components/my-component/my-component.js

@@ -61,41 +61,72 @@ export class JaakStamps {
     preprocessCtx;
     captureCanvas;
     captureCtx;
-    MODEL_PATH = "https://storage.googleapis.com/jaak-static/web/component/stamps/ddmyp-v1.onnx";
+    MODEL_PATH = "https://storage.googleapis.com/jaak-static/web/component/stamps/ddmyp-v2.onnx";
     MOBILENET_MODEL_PATH = "https://storage.googleapis.com/jaak-static/web/component/stamps/cdmmp-v1.onnx";
     MOBILENET_CLASSES_PATH = "https://storage.googleapis.com/jaak-static/web/component/stamps/cdmmp-v1.json";
     INPUT_SIZE = 320;
     CONFIDENCE_THRESHOLD = 0.6;
     // ISO/IEC 7810 ID-1 standard dimensions (85.60mm x 53.98mm)
     ID1_ASPECT_RATIO = 85.60 / 53.98; // 1.5863320574...
-    debugLog(...args) {
-        if (this.debug) {
-            console.log(...args);
+    logger = {
+        info: (...args) => {
+            if (this.debug) {
+                console.log(`[JAAK-STAMPS] [INFO] [${new Date().toLocaleTimeString()}]`, ...args);
+            }
+        },
+        warn: (...args) => {
+            if (this.debug) {
+                console.warn(`[JAAK-STAMPS] [WARN] [${new Date().toLocaleTimeString()}]`, ...args);
+            }
+        },
+        error: (...args) => {
+            if (this.debug) {
+                console.error(`[JAAK-STAMPS] [ERROR] [${new Date().toLocaleTimeString()}]`, ...args);
+            }
+        },
+        debug: (...args) => {
+            if (this.debug) {
+                console.debug(`[JAAK-STAMPS] [DEBUG] [${new Date().toLocaleTimeString()}]`, ...args);
+            }
+        },
+        state: (state, data) => {
+            if (this.debug) {
+                console.log(`[JAAK-STAMPS] [STATE] [${new Date().toLocaleTimeString()}] ${state}`, data || '');
+            }
+        },
+        performance: (operation, duration) => {
+            if (this.debug) {
+                console.log(`[JAAK-STAMPS] [PERF] [${new Date().toLocaleTimeString()}] ${operation}: ${duration}ms`);
+            }
         }
-    }
+    };
     validateMaskSize() {
         if (this.maskSize < 50 || this.maskSize > 100) {
-            console.warn(`maskSize debe estar entre 50 y 100. Valor actual: ${this.maskSize}. Usando valor por defecto: 90`);
+            this.logger.warn(`Propiedad maskSize inválida. Valor: ${this.maskSize}, esperado: 50-100. Usando valor por defecto: 90`);
             this.maskSize = 90;
         }
     }
     validateCropMargin() {
         if (this.cropMargin < 0 || this.cropMargin > 100) {
-            console.warn(`cropMargin debe estar entre 0 y 100. Valor actual: ${this.cropMargin}. Usando valor por defecto: 0`);
+            this.logger.warn(`Propiedad cropMargin inválida. Valor: ${this.cropMargin}, esperado: 0-100. Usando valor por defecto: 0`);
             this.cropMargin = 0;
         }
     }
     validatePreferredCamera() {
         const validOptions = ['auto', 'front', 'back'];
         if (!validOptions.includes(this.preferredCamera)) {
-            console.warn(`preferredCamera debe ser uno de: ${validOptions.join(', ')}. Valor actual: ${this.preferredCamera}. Usando valor por defecto: 'auto'`);
+            this.logger.warn(`Propiedad preferredCamera inválida. Valor: ${this.preferredCamera}, esperado: ${validOptions.join(', ')}. Usando valor por defecto: 'auto'`);
             this.preferredCamera = 'auto';
         }
     }
     emitReadyEvent() {
         const isDocumentReady = !!window.ort && this.isModelPreloaded;
         this.isReady.emit(isDocumentReady);
-        this.debugLog('🟢 isReady event emitted:', isDocumentReady);
+        this.logger.state('COMPONENTE_LISTO', {
+            ortLibraryLoaded: !!window.ort,
+            modelPreloaded: this.isModelPreloaded,
+            isReady: isDocumentReady
+        });
     }
     isRearCamera(stream) {
         const videoTrack = stream.getVideoTracks()[0];
@@ -118,7 +149,11 @@ export class JaakStamps {
         else {
             this.deviceType = 'desktop';
         }
-        this.debugLog('📱 Device type detected:', this.deviceType);
+        this.logger.state('DISPOSITIVO_DETECTADO', {
+            deviceType: this.deviceType,
+            userAgent: navigator.userAgent,
+            screenDimensions: { width: window.innerWidth, height: window.innerHeight }
+        });
         // Enumerate available cameras
         await this.enumerateAndDetectCameras();
         // Load user preference
@@ -129,7 +164,7 @@ export class JaakStamps {
             // First, check if we have permission to enumerate devices
             const permissionStatus = await this.checkCameraPermission();
             if (permissionStatus === 'denied') {
-                this.debugLog('❌ Camera permission denied');
+                this.logger.error('Permiso de cámara denegado por el usuario');
                 this.statusMessage = "Permiso de cámara denegado";
                 this.statusColor = "#ff6b6b";
                 return;
@@ -143,7 +178,7 @@ export class JaakStamps {
             const devices = await navigator.mediaDevices.enumerateDevices();
             this.availableCameras = devices.filter(device => device.kind === 'videoinput');
             this.isMultipleCamerasAvailable = this.availableCameras.length > 1;
-            this.debugLog('📹 Available cameras:', {
+            this.logger.state('CAMARAS_DETECTADAS', {
                 count: this.availableCameras.length,
                 isMultipleCamerasAvailable: this.isMultipleCamerasAvailable,
                 cameras: this.availableCameras.map(cam => ({
@@ -155,7 +190,7 @@ export class JaakStamps {
             this.setInitialCameraPreference();
         }
         catch (error) {
-            this.debugLog('❌ Error enumerating cameras:', error);
+            this.logger.error('Error al enumerar cámaras disponibles:', error);
             this.handleCameraPermissionError(error);
         }
     }
@@ -168,7 +203,7 @@ export class JaakStamps {
             return permission.state;
         }
         catch (error) {
-            this.debugLog('⚠️ Could not check camera permission:', error);
+            this.logger.warn('No se pudo verificar permisos de cámara:', error);
             return 'prompt';
         }
     }
@@ -211,11 +246,11 @@ export class JaakStamps {
                 !camera.label.toLowerCase().includes('back') && !camera.label.toLowerCase().includes('rear'));
             if (frontCamera) {
                 this.selectedCameraId = frontCamera.deviceId;
-                this.debugLog('👤 User selected front camera:', frontCamera.label);
+                this.logger.state('CAMARA_FRONTAL_SELECCIONADA', { label: frontCamera.label, deviceId: frontCamera.deviceId });
             }
             else {
                 this.selectedCameraId = this.availableCameras[0].deviceId;
-                this.debugLog('⚠️ Front camera not found, using first available:', this.availableCameras[0].label);
+                this.logger.warn('Cámara frontal no encontrada, usando primera disponible:', this.availableCameras[0].label);
             }
         }
         else if (this.preferredCamera === 'back') {
@@ -226,11 +261,11 @@ export class JaakStamps {
                 camera.label.toLowerCase().includes('environment'));
             if (backCamera) {
                 this.selectedCameraId = backCamera.deviceId;
-                this.debugLog('📷 User selected back camera:', backCamera.label);
+                this.logger.state('CAMARA_TRASERA_SELECCIONADA', { label: backCamera.label, deviceId: backCamera.deviceId });
             }
             else {
                 this.selectedCameraId = this.availableCameras[0].deviceId;
-                this.debugLog('⚠️ Back camera not found, using first available:', this.availableCameras[0].label);
+                this.logger.warn('Cámara trasera no encontrada, usando primera disponible:', this.availableCameras[0].label);
             }
         }
         else {
@@ -243,17 +278,17 @@ export class JaakStamps {
                     camera.label.toLowerCase().includes('environment'));
                 if (rearCamera) {
                     this.selectedCameraId = rearCamera.deviceId;
-                    this.debugLog('📱 Auto-selected rear camera for mobile:', rearCamera.label);
+                    this.logger.state('CAMARA_AUTO_SELECCIONADA_MOBILE', { type: 'rear', label: rearCamera.label, deviceId: rearCamera.deviceId });
                 }
                 else {
                     this.selectedCameraId = this.availableCameras[0].deviceId;
-                    this.debugLog('📱 Rear camera not found, using first available:', this.availableCameras[0].label);
+                    this.logger.warn('Cámara trasera no encontrada en mobile, usando primera disponible:', this.availableCameras[0].label);
                 }
             }
             else {
                 // For desktop, use first available camera (usually the only one)
                 this.selectedCameraId = this.availableCameras[0].deviceId;
-                this.debugLog('💻 Auto-selected desktop camera:', this.availableCameras[0].label);
+                this.logger.state('CAMARA_AUTO_SELECCIONADA_DESKTOP', { label: this.availableCameras[0].label, deviceId: this.availableCameras[0].deviceId });
             }
         }
     }
@@ -267,12 +302,12 @@ export class JaakStamps {
                 if (isStillAvailable) {
                     this.selectedCameraId = preference.cameraId;
                     this.preferredCameraFacing = preference.facing;
-                    this.debugLog('💾 Loaded camera preference:', preference);
+                    this.logger.state('PREFERENCIA_CAMARA_CARGADA', preference);
                 }
             }
         }
         catch (error) {
-            this.debugLog('⚠️ Error loading camera preference:', error);
+            this.logger.warn('Error al cargar preferencia de cámara:', error);
         }
     }
     saveCameraPreference() {
@@ -283,10 +318,10 @@ export class JaakStamps {
                 timestamp: Date.now()
             };
             localStorage.setItem('jaak-stamps-camera-preference', JSON.stringify(preference));
-            this.debugLog('💾 Saved camera preference:', preference);
+            this.logger.state('PREFERENCIA_CAMARA_GUARDADA', preference);
         }
         catch (error) {
-            this.debugLog('⚠️ Error saving camera preference:', error);
+            this.logger.warn('Error al guardar preferencia de cámara:', error);
         }
     }
     async switchCamera(cameraId) {
@@ -296,7 +331,7 @@ export class JaakStamps {
             // Check if the selected camera is still available
             const selectedCamera = this.availableCameras.find(cam => cam.deviceId === cameraId);
             if (!selectedCamera) {
-                this.debugLog('❌ Selected camera not found, re-enumerating...');
+                this.logger.warn('Cámara seleccionada no encontrada, re-enumerando dispositivos...');
                 await this.enumerateAndDetectCameras();
                 return;
             }
@@ -320,10 +355,10 @@ export class JaakStamps {
             this.saveCameraPreference();
             // Setup new camera with error handling
             await this.setupCameraWithRetry();
-            this.debugLog('🔄 Switched to camera:', selectedCamera.label);
+            this.logger.state('CAMARA_CAMBIADA', { label: selectedCamera.label, deviceId: selectedCamera.deviceId });
         }
         catch (error) {
-            this.debugLog('❌ Error switching camera:', error);
+            this.logger.error('Error al cambiar de cámara:', error);
             this.handleCameraPermissionError(error);
         }
     }
@@ -338,7 +373,7 @@ export class JaakStamps {
                 return; // Success
             }
             catch (error) {
-                this.debugLog(`❌ Camera setup attempt ${attempt} failed:`, error);
+                this.logger.error(`Intento ${attempt} de configuración de cámara fallido:`, error);
                 if (attempt === maxRetries) {
                     // Last attempt failed, handle the error
                     this.statusMessage = "Error al configurar la cámara";
@@ -358,7 +393,7 @@ export class JaakStamps {
     }
     toggleCameraSelector() {
         this.showCameraSelector = !this.showCameraSelector;
-        this.debugLog('📹 Camera selector toggled:', {
+        this.logger.state('SELECTOR_CAMARA_TOGGLE', {
             showCameraSelector: this.showCameraSelector,
             isMultipleCamerasAvailable: this.isMultipleCamerasAvailable,
             availableCameras: this.availableCameras.length,
@@ -374,6 +409,13 @@ export class JaakStamps {
         await this.switchCamera(nextCamera.deviceId);
     }
     async componentDidLoad() {
+        this.logger.state('COMPONENTE_INICIALIZANDO', {
+            debug: this.debug,
+            maskSize: this.maskSize,
+            cropMargin: this.cropMargin,
+            useDocumentClassification: this.useDocumentClassification,
+            preferredCamera: this.preferredCamera
+        });
         if (this.debug) {
             // Show detailed initialization loading state only in debug mode
             this.isLoading = true;
@@ -438,7 +480,7 @@ export class JaakStamps {
             this.canvasRef.height = rect.height;
             // Update mask positioning based on container and video dimensions
             this.updateMaskDimensions(rect);
-            this.debugLog('📐 Canvas resized:', { width: rect.width, height: rect.height });
+            this.logger.debug('Canvas redimensionado:', { width: rect.width, height: rect.height });
         }
     }
     updateMaskDimensions(containerRect) {
@@ -498,7 +540,7 @@ export class JaakStamps {
         this.el.style.setProperty('--mask-center-y', `${videoCenterYPercent}%`);
         // Mark mask as ready now that dimensions are calculated
         this.isMaskReady = true;
-        this.debugLog('🎯 Mask dimensions updated:', {
+        this.logger.state('DIMENSIONES_MASCARA_ACTUALIZADAS', {
             video: { width: videoWidth, height: videoHeight },
             displayed: { width: displayedVideoWidth, height: displayedVideoHeight },
             mask: { widthPercent: maskWidthPercent, heightPercent: maskHeightPercent },
@@ -520,7 +562,7 @@ export class JaakStamps {
         this.captureCtx = this.captureCanvas.getContext('2d', {
             alpha: false
         });
-        this.debugLog('🎨 Canvas pool initialized for performance');
+        this.logger.state('CANVAS_POOL_INICIALIZADO', { preprocessCanvasSize: this.INPUT_SIZE });
     }
     disconnectedCallback() {
         this.cleanup();
@@ -568,7 +610,7 @@ export class JaakStamps {
     }
     async preloadModel() {
         if (this.isModelPreloaded || this.session) {
-            this.debugLog('🚀 Model already preloaded or session exists');
+            this.logger.state('MODELO_YA_PRECARGADO', { sessionExists: !!this.session, modelPreloaded: this.isModelPreloaded });
             return { success: true, message: 'Model already loaded' };
         }
         try {
@@ -576,7 +618,7 @@ export class JaakStamps {
             this.statusMessage = "Precargando modelos...";
             this.statusColor = "#007bff";
             const modelPath = this.MODEL_PATH;
-            this.debugLog('🤖 Preloading detection model:', modelPath);
+            this.logger.state('PRECARGANDO_MODELO_DETECCION', { modelPath });
             // Configure ONNX Runtime with device-specific optimizations
             const sessionOptions = this.getSessionOptions();
             const deviceInfo = this.getDeviceMemoryInfo();
@@ -585,7 +627,7 @@ export class JaakStamps {
             }
             catch (error) {
                 if (error.message.includes('failed to allocate a buffer')) {
-                    this.debugLog('❌ Buffer allocation failed during preload, trying with minimal settings');
+                    this.logger.warn('Fallo en asignación de buffer durante precarga, intentando con configuración mínima');
                     const fallbackOptions = {
                         executionProviders: ['wasm'],
                         graphOptimizationLevel: 'disabled',
@@ -606,7 +648,7 @@ export class JaakStamps {
             // For low memory devices, load sequentially to avoid memory pressure
             if (this.useDocumentClassification) {
                 if (deviceInfo.isLowMemory) {
-                    this.debugLog('🔄 Sequential model loading for low memory device');
+                    this.logger.state('CARGA_SECUENCIAL_MODELOS', { reason: 'low memory device' });
                     await new Promise(resolve => setTimeout(resolve, 1000));
                 }
                 await this.loadMobileNetModel();
@@ -616,11 +658,15 @@ export class JaakStamps {
             this.statusMessage = "Modelos precargados. Listo para comenzar detección";
             this.statusColor = "#28a745";
             this.emitReadyEvent();
-            this.debugLog('✅ Models preloaded successfully');
+            this.logger.state('MODELOS_PRECARGADOS_EXITOSAMENTE', {
+                detectionModel: !!this.session,
+                classificationModel: !!this.mobileNetSession,
+                useClassification: this.useDocumentClassification
+            });
             return { success: true, message: 'Models preloaded successfully' };
         }
         catch (error) {
-            this.debugLog('❌ Error preloading models:', error);
+            this.logger.error('Error al precargar modelos:', error);
             this.isLoading = false;
             this.statusMessage = "Error al precargar los modelos";
             this.statusColor = "#ff6b6b";
@@ -648,7 +694,7 @@ export class JaakStamps {
     }
     async setPreferredCamera(camera) {
         this.preferredCamera = camera;
-        this.debugLog('🎯 Camera preference changed to:', camera);
+        this.logger.state('PREFERENCIA_CAMARA_CAMBIADA', { newPreference: camera });
         // Re-detect and apply new camera preference
         await this.enumerateAndDetectCameras();
         // If video is active, switch to the new preferred camera
@@ -663,14 +709,14 @@ export class JaakStamps {
     }
     async loadMobileNetModel() {
         try {
-            this.debugLog('🤖 Loading MobileNet model...');
+            this.logger.state('CARGANDO_MODELO_MOBILENET', { path: this.MOBILENET_MODEL_PATH });
             // Load class map
             const classResponse = await fetch(this.MOBILENET_CLASSES_PATH);
             if (!classResponse.ok) {
                 throw new Error(`Failed to load class map: ${this.MOBILENET_CLASSES_PATH}`);
             }
             this.mobileNetClassMap = await classResponse.json();
-            this.debugLog('📋 MobileNet classes loaded:', this.mobileNetClassMap);
+            this.logger.state('CLASES_MOBILENET_CARGADAS', { classCount: Object.keys(this.mobileNetClassMap).length });
             // Load model
             const sessionOptions = this.getSessionOptions();
             try {
@@ -678,7 +724,7 @@ export class JaakStamps {
             }
             catch (error) {
                 if (error.message.includes('failed to allocate a buffer')) {
-                    this.debugLog('❌ MobileNet buffer allocation failed, trying with minimal settings');
+                    this.logger.warn('Fallo en asignación de buffer de MobileNet, intentando con configuración mínima');
                     const fallbackOptions = {
                         executionProviders: ['wasm'],
                         graphOptimizationLevel: 'disabled',
@@ -695,10 +741,10 @@ export class JaakStamps {
                     throw error;
                 }
             }
-            this.debugLog('✅ MobileNet model loaded successfully');
+            this.logger.state('MODELO_MOBILENET_CARGADO_EXITOSAMENTE', { sessionCreated: !!this.mobileNetSession });
         }
         catch (error) {
-            this.debugLog('❌ Error loading MobileNet model:', error);
+            this.logger.error('Error al cargar modelo MobileNet:', error);
             throw error;
         }
     }
@@ -725,11 +771,11 @@ export class JaakStamps {
     }
     async classifyDocument(canvas) {
         if (!this.mobileNetSession || !this.mobileNetClassMap) {
-            this.debugLog('⚠️ MobileNet model not loaded');
+            this.logger.warn('Modelo MobileNet no está cargado, saltando clasificación');
             return null;
         }
         try {
-            this.debugLog('🔍 Classifying document...');
+            this.logger.state('CLASIFICANDO_DOCUMENTO', { timestamp: Date.now() });
             // Preprocess image for MobileNet
             const inputTensor = this.preprocessMobileNet(canvas);
             // Run inference
@@ -740,10 +786,11 @@ export class JaakStamps {
             const maxIdx = output.reduce((bestIdx, val, idx, arr) => val > arr[bestIdx] ? idx : bestIdx, 0);
             const confidence = output[maxIdx];
             const className = this.mobileNetClassMap[maxIdx.toString()] || "unknown";
-            this.debugLog('📄 Document classification result:', {
+            this.logger.state('DOCUMENTO_CLASIFICADO', {
                 class: className,
                 confidence: confidence.toFixed(3),
-                classIndex: maxIdx
+                classIndex: maxIdx,
+                timestamp: Date.now()
             });
             return {
                 class: className,
@@ -752,7 +799,7 @@ export class JaakStamps {
             };
         }
         catch (error) {
-            this.debugLog('❌ Error classifying document:', error);
+            this.logger.error('Error al clasificar documento:', error);
             return null;
         }
     }
@@ -794,7 +841,7 @@ export class JaakStamps {
         }
         this.mobileNetClassMap = undefined;
         this.isModelPreloaded = false;
-        this.debugLog('🧹 Canvas pool cleaned up');
+        this.logger.state('CANVAS_POOL_LIMPIADO', { timestamp: Date.now() });
     }
     async getMaxResolution() {
         try {
@@ -844,18 +891,19 @@ export class JaakStamps {
                     constraints.width = { ideal: maxWidth };
                     constraints.height = { ideal: maxHeight };
                 }
-                this.debugLog('📐 Resolution capabilities:', {
+                this.logger.state('CAPACIDADES_RESOLUCION_DETECTADAS', {
                     maxWidth: capabilities.width.max,
                     maxHeight: capabilities.height.max,
                     selectedWidth: constraints.width.ideal,
                     selectedHeight: constraints.height.ideal,
-                    isTablet
+                    isTablet,
+                    deviceType: this.deviceType
                 });
             }
             return constraints;
         }
         catch (err) {
-            this.debugLog('⚠️ Could not get capabilities, using fallback');
+            this.logger.warn('No se pudieron obtener capacidades de cámara, usando configuración de respaldo');
             // Optimized fallback for tablets
             const isTablet = /iPad|Android/i.test(navigator.userAgent) && window.innerWidth >= 768;
             const fallbackConstraints = {
@@ -888,8 +936,11 @@ export class JaakStamps {
                 // Determine if video should be mirrored
                 const isRear = this.isRearCamera(stream);
                 this.shouldMirrorVideo = !isRear;
-                this.debugLog('📹 Rear camera:', isRear);
-                this.debugLog('🪞 Should mirror video:', this.shouldMirrorVideo);
+                this.logger.state('CAMARA_CONFIGURADA', {
+                    isRearCamera: isRear,
+                    shouldMirrorVideo: this.shouldMirrorVideo,
+                    videoActive: this.isVideoActive
+                });
                 return new Promise((resolve) => {
                     this.videoRef.onloadedmetadata = async () => {
                         await this.videoRef.play();
@@ -906,7 +957,7 @@ export class JaakStamps {
             }
         }
         catch (err) {
-            this.debugLog("❌ No se pudo acceder a la cámara:", err);
+            this.logger.error('No se pudo acceder a la cámara:', err);
             this.handleCameraPermissionError(err);
         }
     }
@@ -928,7 +979,37 @@ export class JaakStamps {
             B.push(data[i + 2] / 255);
         }
         const transposedData = new Float32Array(R.concat(G, B));
-        return new window.ort.Tensor("float32", transposedData, [1, 3, this.INPUT_SIZE, this.INPUT_SIZE]);
+        // Convert to float16 for the lighter model
+        const float16Data = new Uint16Array(transposedData.length);
+        for (let i = 0; i < transposedData.length; i++) {
+            float16Data[i] = this.float32ToFloat16(transposedData[i]);
+        }
+        return new window.ort.Tensor("float16", float16Data, [1, 3, this.INPUT_SIZE, this.INPUT_SIZE]);
+    }
+    float32ToFloat16(value) {
+        // Convert float32 to float16 using IEEE 754 half precision format
+        const buffer = new ArrayBuffer(4);
+        const view = new DataView(buffer);
+        view.setFloat32(0, value, true);
+        const f = view.getUint32(0, true);
+        const sign = (f >> 31) & 0x1;
+        const exp = (f >> 23) & 0xFF;
+        const frac = f & 0x7FFFFF;
+        let newExp = exp - 127 + 15;
+        if (exp === 0) {
+            newExp = 0;
+        }
+        else if (exp === 0xFF) {
+            newExp = 0x1F;
+        }
+        else if (newExp >= 0x1F) {
+            newExp = 0x1F;
+            return (sign << 15) | (newExp << 10);
+        }
+        else if (newExp <= 0) {
+            return (sign << 15);
+        }
+        return (sign << 15) | (newExp << 10) | (frac >> 13);
     }
     getDeviceMemoryInfo() {
         const nav = navigator;
@@ -972,6 +1053,12 @@ export class JaakStamps {
         };
     }
     async startDetection() {
+        this.logger.state('INICIANDO_DETECCION', {
+            sessionExists: !!this.session,
+            modelPreloaded: this.isModelPreloaded,
+            videoActive: this.isVideoActive,
+            captureStep: this.captureStep
+        });
         try {
             // Check if model is already preloaded
             if (!this.session) {
@@ -985,14 +1072,14 @@ export class JaakStamps {
                     this.statusColor = "#007bff";
                 }
                 const modelPath = this.MODEL_PATH;
-                this.debugLog('🤖 Loading detection model:', modelPath);
+                this.logger.state('CARGANDO_MODELO_DETECCION', { modelPath });
                 const sessionOptions = this.getSessionOptions();
                 try {
                     this.session = await window.ort.InferenceSession.create(modelPath, sessionOptions);
                 }
                 catch (error) {
                     if (error.message.includes('failed to allocate a buffer')) {
-                        this.debugLog('❌ Buffer allocation failed, trying with minimal settings');
+                        this.logger.warn('Fallo en asignación de buffer, intentando con configuración mínima');
                         const fallbackOptions = {
                             executionProviders: ['wasm'],
                             graphOptimizationLevel: 'disabled',
@@ -1023,7 +1110,7 @@ export class JaakStamps {
                 this.emitReadyEvent();
             }
             else {
-                this.debugLog('🚀 Using preloaded models');
+                this.logger.state('USANDO_MODELOS_PRECARGADOS', { sessionExists: !!this.session, modelPreloaded: this.isModelPreloaded });
                 if (this.debug) {
                     this.statusMessage = "Usando modelos precargados...";
                     this.statusColor = "#007bff";
@@ -1042,7 +1129,7 @@ export class JaakStamps {
             this.detectFrame();
         }
         catch (err) {
-            this.debugLog("Error al inicializar:", err);
+            this.logger.error('Error al inicializar detección:', err);
             this.statusMessage = "Error al inicializar el detector";
             this.statusColor = "#ff6b6b";
             this.isLoading = false;
@@ -1124,7 +1211,7 @@ export class JaakStamps {
             }
         }
         catch (e) {
-            this.debugLog("Error en inferencia:", e);
+            this.logger.error('Error en inferencia de modelo:', e);
             // Solo continuar si no hemos completado el proceso
             if (this.captureStep !== 'completed') {
                 // On error, wait longer before retrying
@@ -1252,7 +1339,7 @@ export class JaakStamps {
             if (!this.hasScreenshotTaken) {
                 this.lastDetectedBox = bestBox;
                 this.takeScreenshot().catch(error => {
-                    this.debugLog('❌ Error taking screenshot:', error);
+                    this.logger.error('Error al tomar captura de pantalla:', error);
                 });
                 this.hasScreenshotTaken = true;
                 // Reset para permitir segunda captura
@@ -1270,6 +1357,7 @@ export class JaakStamps {
         if (boxes.length === 0) {
             this.statusMessage = "Posicione la identificación dentro del marco";
             this.statusColor = "#ff6b6b";
+            this.logger.debug('Sin detección de documento en el frame');
         }
         else {
             const bestBox = boxes.reduce((best, current) => current.score > best.score ? current : best);
@@ -1279,6 +1367,11 @@ export class JaakStamps {
             if (allSidesAligned) {
                 this.statusMessage = "Identificación perfectamente alineada. Mantenga inmóvil";
                 this.statusColor = "#00ff00";
+                this.logger.state('DOCUMENTO_PERFECTAMENTE_ALINEADO', {
+                    score: bestBox.score,
+                    boxDimensions: { width: bestBox.w, height: bestBox.h },
+                    alignedSides: 4
+                });
             }
             else if (alignedSides > 0) {
                 this.statusMessage = `Alinee los lados restantes (${alignedSides}/4 lados correctos)`;
@@ -1339,6 +1432,14 @@ export class JaakStamps {
     async takeScreenshot() {
         if (!this.videoRef || !this.lastDetectedBox)
             return;
+        this.logger.state('INICIANDO_CAPTURA', {
+            captureStep: this.captureStep,
+            detectedBox: this.lastDetectedBox,
+            videoResolution: {
+                width: this.videoRef.videoWidth,
+                height: this.videoRef.videoHeight
+            }
+        });
         // Activar animación
         this.triggerCaptureAnimation();
         // OPTIMIZATION: Reuse capture canvas for full frame
@@ -1378,7 +1479,7 @@ export class JaakStamps {
                         await this.loadMobileNetModel();
                     }
                     catch (error) {
-                        this.debugLog('⚠️ Failed to load classification model, continuing without classification:', error);
+                        this.logger.warn('Fallo al cargar modelo de clasificación, continuando sin clasificación:', error);
                     }
                 }
                 // Classify the cropped document if model is available
@@ -1386,7 +1487,7 @@ export class JaakStamps {
                     const classification = await this.classifyDocument(croppedCanvas);
                     if (classification && classification.class === 'passport') {
                         // If it's a passport, skip back capture since passports don't have a back side
-                        this.debugLog('📄 Passport detected - skipping back capture');
+                        this.logger.state('PASAPORTE_DETECTADO_SALTANDO_REVERSO', { classification: classification?.class });
                         this.completeProcess(true);
                         return;
                     }
@@ -1407,14 +1508,23 @@ export class JaakStamps {
                     this.isDetectionPaused = false;
                 }, 3000);
             }, 800);
-            this.debugLog('📸 FRENTE capturado. Esperando trasera...');
+            this.logger.state('CAPTURA_FRENTE_COMPLETADA', {
+                captureStep: this.captureStep,
+                hasFullFrame: !!this.capturedFullFrame,
+                hasCroppedId: !!this.capturedCroppedId
+            });
         }
         else if (this.captureStep === 'back') {
             // Captura de la trasera usando canvas reutilizado
             this.capturedBackFullFrame = this.captureCanvas.toDataURL('image/png');
             this.capturedBackCroppedId = croppedCanvas.toDataURL('image/png');
             this.completeProcess(false);
-            this.debugLog('📸 TRASERA capturada. Proceso completado. Detector detenido. Imágenes emitidas.');
+            this.logger.state('CAPTURA_TRASERA_COMPLETADA', {
+                captureStep: this.captureStep,
+                hasBackFullFrame: !!this.capturedBackFullFrame,
+                hasBackCroppedId: !!this.capturedBackCroppedId,
+                processCompleted: true
+            });
         }
     }
     triggerCaptureAnimation() {
@@ -1438,7 +1548,7 @@ export class JaakStamps {
             const ctx = this.canvasRef.getContext("2d");
             ctx.clearRect(0, 0, this.canvasRef.width, this.canvasRef.height);
         }
-        this.debugLog('🛑 Detector de identificación detenido');
+        this.logger.state('DETECTOR_DETENIDO', { timestamp: Date.now() });
     }
     resetDetection() {
         this.bestScore = 0;
@@ -1477,6 +1587,13 @@ export class JaakStamps {
             "Proceso completado (solo frente capturado)" :
             "Proceso de captura completado exitosamente";
         this.statusColor = "#28a745";
+        this.logger.state('PROCESO_COMPLETADO', {
+            skippedBack,
+            hasFrontImages: !!(this.capturedFullFrame && this.capturedCroppedId),
+            hasBackImages: !!(this.capturedBackFullFrame && this.capturedBackCroppedId),
+            totalImages: skippedBack ? 2 : 4,
+            timestamp: new Date().toISOString()
+        });
         // Detener el detector
         this.stopDetection();
         // Emitir evento con las imágenes capturadas
@@ -1528,7 +1645,7 @@ export class JaakStamps {
         this.cleanup();
     }
     render() {
-        return (h("div", { key: 'bacf8b2ded1c5015d01dd4240dda6a93fbfb629e', class: "detector-container" }, h("div", { key: '235aefbd8916d6b53ab191c654ed00f303ca73b7', class: "video-container" }, h("video", { key: '9b641c7092c5ecfa601b1f80d6bf8c310539c436', ref: el => this.videoRef = el, autoplay: true, muted: true, playsinline: true, class: this.shouldMirrorVideo ? 'mirror' : '', style: { display: this.isVideoActive ? 'block' : 'none' } }), h("canvas", { key: '2c3c384436b7dd91084dbdd27a34ac9192fa3f22', ref: el => this.canvasRef = el, class: this.shouldMirrorVideo ? 'mirror' : '' }), this.isMaskReady && (h("div", { key: '9e2ca398482ebae4da984854483af3159d908d2b', class: "overlay-mask" }, h("div", { key: 'ee14fd65d752351644a281fc4cbd7d8cf8765eec', class: "card-outline" }, h("div", { key: 'c5a924145ac54e7f545b0b6571f1d7d259fc1145', class: "side side-top" }), h("div", { key: 'a88e9ab5f1a4f7041edb44008697b619bf52a85b', class: "side side-right" }), h("div", { key: '08fbf94000951ea31d029469d8158b8bd3349bf8', class: "side side-bottom" }), h("div", { key: '3b9ead8e1d2c0f7fea2878a248241681c07bd0f6', class: "side side-left" }), h("div", { key: 'f96b9a5a0f00f016b11486a63ca984b368d18c8b', class: "corner corner-tl" }), h("div", { key: '30210f2ec60913466665dea50a1e8bc6cba34b41', class: "corner corner-tr" }), h("div", { key: 'cc4644c99957a9ddf68901ddd368037e01c56899', class: "corner corner-bl" }), h("div", { key: '95b08e9b36f880dda1d614f929ceb71259f5ec38', class: "corner corner-br" }), !this.showFlipAnimation && !this.showSuccessAnimation && (h("div", { key: '9bb545a793764b258381b0e3d665472c67d65b5b', class: "guide-text" }, this.statusMessage))), this.captureStep === 'back' && !this.showFlipAnimation && !this.showSuccessAnimation && (h("button", { key: '3b78e394067ea610021fd915215fca30ed0d654b', class: "skip-button", onClick: () => this.skipBackCapture(), type: "button" }, "Saltar reverso")), this.isVideoActive && (h("div", { key: '85fbcf97d151fbf1f37a2f6f90bbd93ef77afdba', class: "camera-controls" }, this.isMultipleCamerasAvailable && (h("button", { key: '56bab78e6ea660e42057b5e6bc322f6990116119', class: "flip-camera-button", onClick: () => this.flipCamera(), type: "button", title: "Cambiar c\u00E1mara" }, "Girar c\u00E1mara")), h("button", { key: 'c149303ed671d326efada743393e52b5a3710710', class: "camera-selector-button", onClick: () => this.toggleCameraSelector(), type: "button", title: "Seleccionar c\u00E1mara" }, "C\u00E1maras"), this.debug && (h("div", { key: 'ce7c0c1dbc2ba267dbd0181dd7268e2d9f7209c0', style: {
+        return (h("div", { key: 'a09694bc3b5f78bc792ea101d470ada1a438a57b', class: "detector-container" }, h("div", { key: 'c673c10d3311a44479d4462f3efbb4b6257ec6a9', class: "video-container" }, h("video", { key: 'c9faf3f111c50f945bce9d566fea2bd6b249fa78', ref: el => this.videoRef = el, autoplay: true, muted: true, playsinline: true, class: this.shouldMirrorVideo ? 'mirror' : '', style: { display: this.isVideoActive ? 'block' : 'none' } }), h("canvas", { key: 'bdc04a389f6b956f7ca138d9fe74db38a6c8812c', ref: el => this.canvasRef = el, class: this.shouldMirrorVideo ? 'mirror' : '' }), this.isMaskReady && (h("div", { key: '317156579b40924a7bb96c89dd247713f87f1aa9', class: "overlay-mask" }, h("div", { key: '71cfc3c3bbfdae49f05fd563e14f56181440fafa', class: "card-outline" }, h("div", { key: '3f940eeb59d783f47e2e2651ccf1a7be19f1d8b9', class: "side side-top" }), h("div", { key: 'f07e54e9542811897191e9a9a08f91b9e4785cc6', class: "side side-right" }), h("div", { key: '5b6a323213ddff52071b3469068cba0b31930ea0', class: "side side-bottom" }), h("div", { key: '44cf6567819855ab915fcee51cec7d08cb8654a8', class: "side side-left" }), h("div", { key: '8f866542b2d1a399418d1c8cb58ea856d5f3b9e7', class: "corner corner-tl" }), h("div", { key: 'a6567d410c755553d4be5b77dfc965e63b4ef07f', class: "corner corner-tr" }), h("div", { key: '255636461627f2deb61c9feacda3c9379abaaf29', class: "corner corner-bl" }), h("div", { key: 'dd029757b1ccc49c44bedee12c19b9485ef16545', class: "corner corner-br" }), !this.showFlipAnimation && !this.showSuccessAnimation && (h("div", { key: '37aef58019835eac5883042554c648b89cd305ac', class: "guide-text" }, this.statusMessage))), this.captureStep === 'back' && !this.showFlipAnimation && !this.showSuccessAnimation && (h("button", { key: '541f6d35d0655093f767423fc6851b521a5b43cd', class: "skip-button", onClick: () => this.skipBackCapture(), type: "button" }, "Saltar reverso")), this.isVideoActive && (h("div", { key: '73f2232b7c79f8b935cc78f2e5de1f064e4a3472', class: "camera-controls" }, this.isMultipleCamerasAvailable && (h("button", { key: '3c176f9848dc4bf3b7144e2d68225562ae3780c0', class: "flip-camera-button", onClick: () => this.flipCamera(), type: "button", title: "Cambiar c\u00E1mara" }, "Girar c\u00E1mara")), h("button", { key: '9460ad4c42872324141ab19b516e7fa026afdd37', class: "camera-selector-button", onClick: () => this.toggleCameraSelector(), type: "button", title: "Seleccionar c\u00E1mara" }, "C\u00E1maras"), this.debug && (h("div", { key: '961d825eaba6077189f32193d527fe98a6d4e1e1', style: {
                 position: 'absolute',
                 top: '50px',
                 right: '0',
@@ -1538,10 +1655,10 @@ export class JaakStamps {
                 fontSize: '10px',
                 borderRadius: '4px',
                 whiteSpace: 'nowrap'
-            } }, "C\u00E1maras: ", this.availableCameras.length, h("br", { key: 'd62a6ddde7160f41075b3b1d00340515019a48ca' }), "M\u00FAltiples: ", this.isMultipleCamerasAvailable ? 'Sí' : 'No', h("br", { key: 'fe8c322421809a58f49150ef877ae0502d34d002' }), "Selector: ", this.showCameraSelector ? 'Visible' : 'Oculto', h("br", { key: '084d8c5c6c0193edcaf3bd7d64d0bce8e0bb6964' }), "Video: ", this.isVideoActive ? 'Activo' : 'Inactivo')))), this.showCameraSelector && this.availableCameras.length > 0 && (h("div", { key: '03b1a66188e65f1843c50aec096db840d60bb703', class: "camera-selector-dropdown" }, h("div", { key: 'fe7e08d25dd394d893a7f6269c80a2aaa4732134', class: "camera-selector-header" }, h("span", { key: '1b8f4892c3eef6dac8c682e152abb35e2331496c' }, "Seleccionar C\u00E1mara"), h("button", { key: '396c78a3753c707619e27ef7e5f3a412ba8480c6', class: "close-selector", onClick: () => this.toggleCameraSelector(), type: "button" }, "\u00D7")), h("div", { key: '6d56d67efe54719f21978cc6cc44cf2f421469bb', class: "camera-list" }, this.availableCameras.map((camera) => (h("button", { key: camera.deviceId, class: `camera-option ${this.selectedCameraId === camera.deviceId ? 'selected' : ''}`, onClick: () => {
+            } }, "C\u00E1maras: ", this.availableCameras.length, h("br", { key: 'f7e12d21177478d03f6df0490dfc91df12bd1225' }), "M\u00FAltiples: ", this.isMultipleCamerasAvailable ? 'Sí' : 'No', h("br", { key: '1f1cc8cf92e10b9b902fd981875621fa8dbe70f2' }), "Selector: ", this.showCameraSelector ? 'Visible' : 'Oculto', h("br", { key: 'c119c6567b28fc33e99b59f76e53e9359491ab77' }), "Video: ", this.isVideoActive ? 'Activo' : 'Inactivo')))), this.showCameraSelector && this.availableCameras.length > 0 && (h("div", { key: 'c230990e87f3b6133263c42fc1b568c0caf076e2', class: "camera-selector-dropdown" }, h("div", { key: '44c224e93c5832eea498e756a446e12ce8255e61', class: "camera-selector-header" }, h("span", { key: '64d951db4843164378424f2d8d2ed2802eb35170' }, "Seleccionar C\u00E1mara"), h("button", { key: '0575a7d0a9a99d665d42c6a7f7d8ceff53da9bd2', class: "close-selector", onClick: () => this.toggleCameraSelector(), type: "button" }, "\u00D7")), h("div", { key: '4aceed8bcf821710af343611f1b31efdfe61438e', class: "camera-list" }, this.availableCameras.map((camera) => (h("button", { key: camera.deviceId, class: `camera-option ${this.selectedCameraId === camera.deviceId ? 'selected' : ''}`, onClick: () => {
                 this.switchCamera(camera.deviceId);
                 this.toggleCameraSelector();
-            }, type: "button" }, h("span", { class: "camera-label" }, camera.label || `Cámara ${this.availableCameras.indexOf(camera) + 1}`), this.selectedCameraId === camera.deviceId && (h("span", { class: "selected-indicator" }, "\u2713")))))), h("div", { key: '7f5dda6214695d50c08d2ba4ccec236f3bd158cf', class: "device-info" }, h("small", { key: '50d2768f82b9b7f0a9c1729a5167493f731fb4f6' }, "Dispositivo: ", this.deviceType)))))), this.isCapturing && (h("div", { key: '7ed246b862639b2c6df54dbd32ebb883776bfbd7', class: "capture-animation" })), this.showFlipAnimation && (h("div", { key: 'f2d3a97dfcb9fd757b2f39ec184bce3f5dcb3595', class: "flip-animation" }, h("div", { key: '89a98223c60317d2b9449029ba393c75bec154b3', class: "id-card-icon" }), h("div", { key: '507f6f1b7f38082772bbac2fc28046618161c69b', class: "flip-text" }, "\u00A1Voltea tu identificaci\u00F3n!"))), this.showSuccessAnimation && (h("div", { key: '9010d5be6684759b5d99c58ee65b0a7ebe82b9cb', class: "success-animation" }, h("div", { key: '454c39a5c0d457418b8abdc6e63b1c8a249a118f', class: "check-icon" }), h("div", { key: '502e55f1496f7d8cde9178c416bd9db4cf0491eb', class: "success-text" }, "\u00A1Proceso completado!"))), this.isLoading && (h("div", { key: 'e4d6b7c5ebc8da42689150195dd837e77e152ea3', class: "loading-overlay" }, h("div", { key: '7cc39dbbe94e0730c47829291b83717476517f7f', class: "loading-spinner" }), h("div", { key: '4c1afe04fc7a627c9a57c2f7b851ce62f9305676', class: "loading-text" }, this.statusMessage))), this.debug && (h("div", { key: '8745c4603b35003bff859657c86c713b7f58e204', class: "status-bar" }, h("div", { key: 'e098f2402d58d1808052e3d213f851e66db69ee4', class: "status-message", style: { 'color': this.statusColor } }, this.statusMessage))), h("div", { key: 'af4e07b405af5b1786009b0e9ecf72551753de28', class: "watermark" }, h("img", { key: '25f4b80f13528617007aad160c855c4fff0c8af5', src: "https://storage.googleapis.com/jaak-static/commons/powered-by-jaak.png", alt: "Powered by Jaak" })))));
+            }, type: "button" }, h("span", { class: "camera-label" }, camera.label || `Cámara ${this.availableCameras.indexOf(camera) + 1}`), this.selectedCameraId === camera.deviceId && (h("span", { class: "selected-indicator" }, "\u2713")))))), h("div", { key: 'd6d691cc499a35f40e348cf61d8f81a380e6fe98', class: "device-info" }, h("small", { key: 'ed38304b9dcac5b99d7b32f5733c59b335433f61' }, "Dispositivo: ", this.deviceType)))))), this.isCapturing && (h("div", { key: 'ad19c6c3a2cb761a67b80e52761b2b9cb14d251d', class: "capture-animation" })), this.showFlipAnimation && (h("div", { key: '480615ac9b8ceb5cfc2d821d5777b213c2e86d83', class: "flip-animation" }, h("div", { key: '45e74e5ef254bce75f51d2d12a5961722fb0af03', class: "id-card-icon" }), h("div", { key: '38b9274a67fa8cf1f83bd4b06a3d4ef3d03cdb14', class: "flip-text" }, "\u00A1Voltea tu identificaci\u00F3n!"))), this.showSuccessAnimation && (h("div", { key: 'a6344502e3bbbe298dfb509b41354a54038826aa', class: "success-animation" }, h("div", { key: '579f89d7c8d0ff76e42af611286d96a35d3dbfb9', class: "check-icon" }), h("div", { key: '5bb5c155c70f4bf7a04a62d10142e413763fa1fa', class: "success-text" }, "\u00A1Proceso completado!"))), this.isLoading && (h("div", { key: '664113d7266be3c4171291faede143e736efadf0', class: "loading-overlay" }, h("div", { key: 'b699ad30f1784e1a92657391c080b91e017f7420', class: "loading-spinner" }), h("div", { key: '287f8e13229e4d14de31b0c5ad7d89a202eca5f9', class: "loading-text" }, this.statusMessage))), this.debug && (h("div", { key: 'ba649b0414153cb28b2c6e3c5451b324a990ec63', class: "status-bar" }, h("div", { key: '55b11462af7ef04d293757e2e45344f9206352ac', class: "status-message", style: { 'color': this.statusColor } }, this.statusMessage))), h("div", { key: '3b24a505519d8b483fad2b2f66ef8159d458e1b4', class: "watermark" }, h("img", { key: 'd61f9366631661835e1dd9500500c2b7a7334581', src: "https://storage.googleapis.com/jaak-static/commons/powered-by-jaak.png", alt: "Powered by Jaak" })))));
     }
     static get is() { return "jaak-stamps"; }
     static get encapsulation() { return "shadow"; }