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

package/dist/components/jaak-stamps.js

@@ -78,34 +78,65 @@ const JaakStamps$1 = /*@__PURE__*/ proxyCustomElement(class JaakStamps extends H
     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];
@@ -128,7 +159,11 @@ const JaakStamps$1 = /*@__PURE__*/ proxyCustomElement(class JaakStamps extends H
         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
@@ -139,7 +174,7 @@ const JaakStamps$1 = /*@__PURE__*/ proxyCustomElement(class JaakStamps extends H
             // 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;
@@ -153,7 +188,7 @@ const JaakStamps$1 = /*@__PURE__*/ proxyCustomElement(class JaakStamps extends H
             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 => ({
@@ -165,7 +200,7 @@ const JaakStamps$1 = /*@__PURE__*/ proxyCustomElement(class JaakStamps extends H
             this.setInitialCameraPreference();
         }
         catch (error) {
-            this.debugLog('❌ Error enumerating cameras:', error);
+            this.logger.error('Error al enumerar cámaras disponibles:', error);
             this.handleCameraPermissionError(error);
         }
     }
@@ -178,7 +213,7 @@ const JaakStamps$1 = /*@__PURE__*/ proxyCustomElement(class JaakStamps extends H
             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';
         }
     }
@@ -221,11 +256,11 @@ const JaakStamps$1 = /*@__PURE__*/ proxyCustomElement(class JaakStamps extends H
                 !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') {
@@ -236,11 +271,11 @@ const JaakStamps$1 = /*@__PURE__*/ proxyCustomElement(class JaakStamps extends H
                 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 {
@@ -253,17 +288,17 @@ const JaakStamps$1 = /*@__PURE__*/ proxyCustomElement(class JaakStamps extends H
                     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 });
             }
         }
     }
@@ -277,12 +312,12 @@ const JaakStamps$1 = /*@__PURE__*/ proxyCustomElement(class JaakStamps extends H
                 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() {
@@ -293,10 +328,10 @@ const JaakStamps$1 = /*@__PURE__*/ proxyCustomElement(class JaakStamps extends H
                 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) {
@@ -306,7 +341,7 @@ const JaakStamps$1 = /*@__PURE__*/ proxyCustomElement(class JaakStamps extends H
             // 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;
             }
@@ -330,10 +365,10 @@ const JaakStamps$1 = /*@__PURE__*/ proxyCustomElement(class JaakStamps extends H
             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);
         }
     }
@@ -348,7 +383,7 @@ const JaakStamps$1 = /*@__PURE__*/ proxyCustomElement(class JaakStamps extends H
                 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";
@@ -368,7 +403,7 @@ const JaakStamps$1 = /*@__PURE__*/ proxyCustomElement(class JaakStamps extends H
     }
     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,
@@ -384,6 +419,13 @@ const JaakStamps$1 = /*@__PURE__*/ proxyCustomElement(class JaakStamps extends H
         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;
@@ -448,7 +490,7 @@ const JaakStamps$1 = /*@__PURE__*/ proxyCustomElement(class JaakStamps extends H
             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) {
@@ -508,7 +550,7 @@ const JaakStamps$1 = /*@__PURE__*/ proxyCustomElement(class JaakStamps extends H
         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 },
@@ -530,7 +572,7 @@ const JaakStamps$1 = /*@__PURE__*/ proxyCustomElement(class JaakStamps extends H
         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();
@@ -578,7 +620,7 @@ const JaakStamps$1 = /*@__PURE__*/ proxyCustomElement(class JaakStamps extends H
     }
     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 {
@@ -586,7 +628,7 @@ const JaakStamps$1 = /*@__PURE__*/ proxyCustomElement(class JaakStamps extends H
             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();
@@ -595,7 +637,7 @@ const JaakStamps$1 = /*@__PURE__*/ proxyCustomElement(class JaakStamps extends H
             }
             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',
@@ -616,7 +658,7 @@ const JaakStamps$1 = /*@__PURE__*/ proxyCustomElement(class JaakStamps extends H
             // 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();
@@ -626,11 +668,15 @@ const JaakStamps$1 = /*@__PURE__*/ proxyCustomElement(class JaakStamps extends H
             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";
@@ -658,7 +704,7 @@ const JaakStamps$1 = /*@__PURE__*/ proxyCustomElement(class JaakStamps extends H
     }
     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
@@ -673,14 +719,14 @@ const JaakStamps$1 = /*@__PURE__*/ proxyCustomElement(class JaakStamps extends H
     }
     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 {
@@ -688,7 +734,7 @@ const JaakStamps$1 = /*@__PURE__*/ proxyCustomElement(class JaakStamps extends H
             }
             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',
@@ -705,10 +751,10 @@ const JaakStamps$1 = /*@__PURE__*/ proxyCustomElement(class JaakStamps extends H
                     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;
         }
     }
@@ -735,11 +781,11 @@ const JaakStamps$1 = /*@__PURE__*/ proxyCustomElement(class JaakStamps extends H
     }
     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
@@ -750,10 +796,11 @@ const JaakStamps$1 = /*@__PURE__*/ proxyCustomElement(class JaakStamps extends H
             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,
@@ -762,7 +809,7 @@ const JaakStamps$1 = /*@__PURE__*/ proxyCustomElement(class JaakStamps extends H
             };
         }
         catch (error) {
-            this.debugLog('❌ Error classifying document:', error);
+            this.logger.error('Error al clasificar documento:', error);
             return null;
         }
     }
@@ -804,7 +851,7 @@ const JaakStamps$1 = /*@__PURE__*/ proxyCustomElement(class JaakStamps extends H
         }
         this.mobileNetClassMap = undefined;
         this.isModelPreloaded = false;
-        this.debugLog('🧹 Canvas pool cleaned up');
+        this.logger.state('CANVAS_POOL_LIMPIADO', { timestamp: Date.now() });
     }
     async getMaxResolution() {
         try {
@@ -853,18 +900,19 @@ const JaakStamps$1 = /*@__PURE__*/ proxyCustomElement(class JaakStamps extends H
                     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 = {
@@ -897,8 +945,11 @@ const JaakStamps$1 = /*@__PURE__*/ proxyCustomElement(class JaakStamps extends H
                 // 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();
@@ -915,7 +966,7 @@ const JaakStamps$1 = /*@__PURE__*/ proxyCustomElement(class JaakStamps extends H
             }
         }
         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);
         }
     }
@@ -981,6 +1032,12 @@ const JaakStamps$1 = /*@__PURE__*/ proxyCustomElement(class JaakStamps extends H
         };
     }
     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) {
@@ -994,14 +1051,14 @@ const JaakStamps$1 = /*@__PURE__*/ proxyCustomElement(class JaakStamps extends H
                     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',
@@ -1032,7 +1089,7 @@ const JaakStamps$1 = /*@__PURE__*/ proxyCustomElement(class JaakStamps extends H
                 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";
@@ -1051,7 +1108,7 @@ const JaakStamps$1 = /*@__PURE__*/ proxyCustomElement(class JaakStamps extends H
             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;
@@ -1133,7 +1190,7 @@ const JaakStamps$1 = /*@__PURE__*/ proxyCustomElement(class JaakStamps extends H
             }
         }
         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
@@ -1261,7 +1318,7 @@ const JaakStamps$1 = /*@__PURE__*/ proxyCustomElement(class JaakStamps extends H
             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
@@ -1279,6 +1336,7 @@ const JaakStamps$1 = /*@__PURE__*/ proxyCustomElement(class JaakStamps extends H
         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);
@@ -1288,6 +1346,11 @@ const JaakStamps$1 = /*@__PURE__*/ proxyCustomElement(class JaakStamps extends H
             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)`;
@@ -1348,6 +1411,14 @@ const JaakStamps$1 = /*@__PURE__*/ proxyCustomElement(class JaakStamps extends H
     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
@@ -1387,7 +1458,7 @@ const JaakStamps$1 = /*@__PURE__*/ proxyCustomElement(class JaakStamps extends H
                         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
@@ -1395,7 +1466,7 @@ const JaakStamps$1 = /*@__PURE__*/ proxyCustomElement(class JaakStamps extends H
                     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;
                     }
@@ -1416,14 +1487,23 @@ const JaakStamps$1 = /*@__PURE__*/ proxyCustomElement(class JaakStamps extends H
                     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() {
@@ -1447,7 +1527,7 @@ const JaakStamps$1 = /*@__PURE__*/ proxyCustomElement(class JaakStamps extends H
             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;
@@ -1486,6 +1566,13 @@ const JaakStamps$1 = /*@__PURE__*/ proxyCustomElement(class JaakStamps extends H
             "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
@@ -1537,7 +1624,7 @@ const JaakStamps$1 = /*@__PURE__*/ proxyCustomElement(class JaakStamps extends H
         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: '87e2e2065012b5792b52b18349490492b5bdc80c', class: "detector-container" }, h("div", { key: '04b8bba38297d39c84ddc01f5a9bf72c65b9bef4', class: "video-container" }, h("video", { key: '905b99e1670fccb2ff5555818f91d0b0241fa29d', ref: el => this.videoRef = el, autoplay: true, muted: true, playsinline: true, class: this.shouldMirrorVideo ? 'mirror' : '', style: { display: this.isVideoActive ? 'block' : 'none' } }), h("canvas", { key: '3f219b649b8d4f961b15256b8586451c2a737eb8', ref: el => this.canvasRef = el, class: this.shouldMirrorVideo ? 'mirror' : '' }), this.isMaskReady && (h("div", { key: 'f8d6742689d4446897ca48c2407cb3d3fab643e9', class: "overlay-mask" }, h("div", { key: '630a06c530f168cc0b71286adbf48fd922eb710d', class: "card-outline" }, h("div", { key: 'ce8c043ad41d5574cd0c4d737dec08b9f7fee927', class: "side side-top" }), h("div", { key: 'e90ead592f84e5df98143bc88714e70f32684204', class: "side side-right" }), h("div", { key: '31d6778c5036e42a3addb26c732149abc5a18ef7', class: "side side-bottom" }), h("div", { key: 'f85c31e77f024f9070c706b06b91d62a7fdbc357', class: "side side-left" }), h("div", { key: '27b362711bc53019483c0d36742d97e10ae9b9ce', class: "corner corner-tl" }), h("div", { key: '03b55893610684d690987c2eacf3c4e5d0c3bbe5', class: "corner corner-tr" }), h("div", { key: 'b6bf31327925c45a7fa8e1fd5ab2f25b824a03a2', class: "corner corner-bl" }), h("div", { key: '0737e0c82f8ad9703ce2546f3e594db6d50cafde', class: "corner corner-br" }), !this.showFlipAnimation && !this.showSuccessAnimation && (h("div", { key: '145f8383c496e151bd6ef4f5841292adeba083c4', class: "guide-text" }, this.statusMessage))), this.captureStep === 'back' && !this.showFlipAnimation && !this.showSuccessAnimation && (h("button", { key: 'fcdedebc31eddd21b978dd63e93c348d324b47da', class: "skip-button", onClick: () => this.skipBackCapture(), type: "button" }, "Saltar reverso")), this.isVideoActive && (h("div", { key: 'dc9157bf7bed3b6439db742055201e2c4eddec84', class: "camera-controls" }, this.isMultipleCamerasAvailable && (h("button", { key: '6b052562ccb203dbf3cc8b627f31ed2435559f80', class: "flip-camera-button", onClick: () => this.flipCamera(), type: "button", title: "Cambiar c\u00E1mara" }, "Girar c\u00E1mara")), h("button", { key: 'f9fad1757d01f0cb45f65bb2088bd1f0bc0e4e8d', class: "camera-selector-button", onClick: () => this.toggleCameraSelector(), type: "button", title: "Seleccionar c\u00E1mara" }, "C\u00E1maras"), this.debug && (h("div", { key: '5362fb33508c7f903b09f65fdb449b608804260d', style: {
                 position: 'absolute',
                 top: '50px',
                 right: '0',
@@ -1547,10 +1634,10 @@ const JaakStamps$1 = /*@__PURE__*/ proxyCustomElement(class JaakStamps extends H
                 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: '5ead451a54a59c885f62740d0a0ce43ba8b674e4' }), "M\u00FAltiples: ", this.isMultipleCamerasAvailable ? 'Sí' : 'No', h("br", { key: '9a92514d07576ed7052eaa3a418c00013ef7c479' }), "Selector: ", this.showCameraSelector ? 'Visible' : 'Oculto', h("br", { key: 'd06abebad3b2e3c19aa22e511e0c4cfd4425b8b2' }), "Video: ", this.isVideoActive ? 'Activo' : 'Inactivo')))), this.showCameraSelector && this.availableCameras.length > 0 && (h("div", { key: '93a09ce3bb108175b55944a71c21e86e58de55be', class: "camera-selector-dropdown" }, h("div", { key: '7ceb4c8826945ab2a9da106a88a44cbb5490e92a', class: "camera-selector-header" }, h("span", { key: 'fa98621700584d8021ff57eca6f804b6eb792c5b' }, "Seleccionar C\u00E1mara"), h("button", { key: 'ce6477a1494f58fb5974dd7c9e62bd7d041572c5', class: "close-selector", onClick: () => this.toggleCameraSelector(), type: "button" }, "\u00D7")), h("div", { key: 'eff226b006c95fafce2566947155e13ee68f9a02', 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: '617d33caa5d3b3e6dca56d479b27c0ac7ed19c2c', class: "device-info" }, h("small", { key: 'fba56ac1238c33864f8dba1d8bd9a5661e11d770' }, "Dispositivo: ", this.deviceType)))))), this.isCapturing && (h("div", { key: 'b46982a0b949ee9d50d0a819c59b24dceec9d7b2', class: "capture-animation" })), this.showFlipAnimation && (h("div", { key: 'c82773fffca8ec53949197a105e1e11bf0f9b294', class: "flip-animation" }, h("div", { key: 'ad52c9ec91132bf5ed94e36f621489a66b0bf680', class: "id-card-icon" }), h("div", { key: '2be407ee84beddc5ce968a9a94d9014f416cde54', class: "flip-text" }, "\u00A1Voltea tu identificaci\u00F3n!"))), this.showSuccessAnimation && (h("div", { key: 'f20b6be925178a123de99e535e893b7c09391dee', class: "success-animation" }, h("div", { key: 'd3ae65d40943f73bc92e9529764ded454adc5dbf', class: "check-icon" }), h("div", { key: 'f2b03082a106c69f09d384ba3b1cb4a636d3a189', class: "success-text" }, "\u00A1Proceso completado!"))), this.isLoading && (h("div", { key: '65736e303d9eb1c3f6f2dccb5cc0d27c571ac9c8', class: "loading-overlay" }, h("div", { key: '5863d855d1caea9202a9f3d0a29919985ddbb926', class: "loading-spinner" }), h("div", { key: 'aa5a16c96ac6bfa43846ba06346fad6dce39dfbb', class: "loading-text" }, this.statusMessage))), this.debug && (h("div", { key: '308c664b07d2c2427c38f766fc9eb78d27843f67', class: "status-bar" }, h("div", { key: '3884b311710d7f373a508eb492771e503e68f648', class: "status-message", style: { 'color': this.statusColor } }, this.statusMessage))), h("div", { key: '3125cfecda03d3ab9e80e0d9d5674f1cc167e2f8', class: "watermark" }, h("img", { key: '5ef43a18aea74f570db0d61f4fd86c3becf1d23e', src: "https://storage.googleapis.com/jaak-static/commons/powered-by-jaak.png", alt: "Powered by Jaak" })))));
     }
     static get style() { return myComponentCss; }
 }, [1, "jaak-stamps", {