@jaak.ai/stamps 2.1.0 → 2.2.0-dev.2

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

@@ -1,5 +1,6 @@
 import { h } from "@stencil/core";
 import { ServiceContainer } from "../../services/ServiceContainer";
+import { LicenseValidationService } from "../../services/LicenseValidationService";
 export class JaakStamps {
     el;
     debug = false;
@@ -12,8 +13,22 @@ export class JaakStamps {
     captureDelay = 1500;
     enableBackDocumentTimer = false;
     backDocumentTimerDuration = 20;
+    telemetryCollectorUrl = 'https://collector.jaak.ai/v1/traces';
+    metricsCollectorUrl = 'https://collector.jaak.ai/v1/metrics';
+    enableTelemetry = true;
+    enableMetrics = true;
+    customerId;
+    tenantId;
+    environment = 'production';
+    propagateTraceHeaderCorsUrls; // Comma-separated URLs or regex patterns
+    metricsExportIntervalMillis = 60000; // Export metrics every 60 seconds
+    license; // License key for validation
+    licenseEnvironment = 'prod'; // Environment for license validation
+    traceId; // Optional trace ID for tracking
+    appId = 'jaak-stamps-web'; // Application ID for license validation
     captureCompleted;
     isReady;
+    traceIdGenerated;
     // State derived from services
     detectionBoxes = [];
     sideAlignment = {
@@ -53,12 +68,17 @@ export class JaakStamps {
     showPerformanceMessage = false; // Show performance message temporarily
     captureStateVersion = 0; // Triggers re-render when StateManager changes
     processingButton = null; // Track which button is processing
+    licenseValid = true; // License validation status
+    licenseError = null; // License validation error message
     // Services
+    licenseValidationService = null;
     serviceContainer;
     eventBus;
     stateManager;
     cameraService;
     detectionService;
+    tracingService;
+    metricsService;
     // UI References
     videoRef;
     detectionContainer;
@@ -104,8 +124,23 @@ export class JaakStamps {
     // Canvas pool for optimized screenshot capture
     canvasPool = [];
     MAX_CANVAS_POOL_SIZE = 3;
+    async componentWillLoad() {
+        // License is required - always validate
+        // Wait a bit to ensure props are set from attributes
+        await new Promise(resolve => setTimeout(resolve, 50));
+        this.updateStatus('Validando licencia...', 'Verificando autorización de uso', 'initializing');
+        await this.validateLicense();
+        // If license validation failed, stop initialization
+        if (!this.licenseValid) {
+            return;
+        }
+    }
     async componentDidLoad() {
         try {
+            // If license validation failed, stop initialization
+            if (!this.licenseValid) {
+                return;
+            }
             this.updateStatus('Preparando capturador...', 'Configurando herramientas de captura', 'initializing');
             await this.initializeServices();
             this.updateStatus('Preparando funciones...', 'Configurando herramientas de trabajo', 'initializing');
@@ -121,6 +156,10 @@ export class JaakStamps {
         }
     }
     async initializeServices() {
+        // Parse propagateTraceHeaderCorsUrls from comma-separated string
+        const propagateUrls = this.propagateTraceHeaderCorsUrls
+            ? this.propagateTraceHeaderCorsUrls.split(',').map(url => url.trim())
+            : [];
         const config = {
             debug: this.debug,
             alignmentTolerance: this.alignmentTolerance,
@@ -129,13 +168,72 @@ export class JaakStamps {
             useDocumentClassification: this.useDocumentClassification,
             useDocumentDetector: this.useDocumentDetector,
             preferredCamera: this.preferredCamera,
-            captureDelay: this.captureDelay
+            captureDelay: this.captureDelay,
+            telemetryCollectorUrl: this.telemetryCollectorUrl,
+            metricsCollectorUrl: this.metricsCollectorUrl,
+            enableTelemetry: this.enableTelemetry,
+            enableMetrics: this.enableMetrics,
+            customerId: this.customerId,
+            tenantId: this.tenantId,
+            environment: this.environment,
+            propagateTraceHeaderCorsUrls: propagateUrls,
+            metricsExportIntervalMillis: this.metricsExportIntervalMillis
         };
         this.serviceContainer = new ServiceContainer(config);
         this.eventBus = this.serviceContainer.getEventBus();
         this.stateManager = this.serviceContainer.getStateManager();
         this.cameraService = this.serviceContainer.getCameraService();
         this.detectionService = this.serviceContainer.getDetectionService();
+        this.tracingService = this.serviceContainer.getTracingService();
+        this.metricsService = this.serviceContainer.getMetricsService();
+        // Record component initialization
+        if (this.tracingService) {
+            const span = this.tracingService.startSpan('component.initialize', {
+                'component.debug': this.debug,
+                'component.useDocumentDetector': this.useDocumentDetector,
+                'component.useDocumentClassification': this.useDocumentClassification,
+            });
+            this.tracingService.endSpan(span);
+        }
+    }
+    async validateLicense() {
+        if (!this.license) {
+            console.error('❌ No license provided for JAAK Stamps component');
+            this.licenseError = 'Este componente requiere una licencia válida. Por favor, proporcione una licencia usando el atributo "license".';
+            this.licenseValid = false;
+            this.updateStatus('Error de licencia', 'Licencia no proporcionada', 'error');
+            return;
+        }
+        try {
+            console.log('🔑 Validating license for JAAK Stamps...');
+            // Initialize license validation service
+            this.licenseValidationService = new LicenseValidationService(this.licenseEnvironment);
+            // Validate the license, passing traceId and appId if provided
+            const response = await this.licenseValidationService.validateLicense(this.license, this.traceId, this.appId);
+            if (response && response.access_token) {
+                this.licenseValid = true;
+                this.licenseError = null;
+                console.log('✅ License validated successfully for JAAK Stamps');
+                // Emit the traceId (either provided or generated)
+                if (response.traceId) {
+                    this.traceIdGenerated.emit({ traceId: response.traceId });
+                    console.log('📋 TraceId:', response.traceId);
+                }
+            }
+            else {
+                this.licenseValid = false;
+                this.licenseError = 'La licencia proporcionada no es válida. Por favor, verifique su licencia e intente nuevamente.';
+                this.updateStatus('Error de licencia', 'Licencia inválida', 'error');
+                console.error('❌ Invalid license for JAAK Stamps');
+            }
+        }
+        catch (error) {
+            this.licenseValid = false;
+            const licenseError = error;
+            this.licenseError = licenseError.error_description || 'Error al validar la licencia. Por favor, verifique su conexión e intente nuevamente.';
+            this.updateStatus('Error de licencia', 'Fallo en la validación', 'error');
+            console.error('❌ License validation failed for JAAK Stamps:', error);
+        }
     }
     async setupEventListeners() {
         this.eventBus.on('state-changed', () => {
@@ -403,17 +501,31 @@ export class JaakStamps {
         return this.stateManager.isProcessCompleted();
     }
     async startCapture() {
+        const span = this.tracingService?.startSpan('capture.start');
         const readyCheck = this.isComponentReady();
         if (!readyCheck.ready) {
             this.updateStatus(readyCheck.message, 'Espere a que termine la inicialización', readyCheck.status);
+            if (span) {
+                this.tracingService?.setSpanAttribute(span, 'error', true);
+                this.tracingService?.setSpanAttribute(span, 'error.message', readyCheck.message);
+                this.tracingService?.endSpan(span);
+            }
             return { success: false, error: readyCheck.message };
         }
         try {
             await this.startDetection();
+            if (span) {
+                this.tracingService?.setSpanAttribute(span, 'success', true);
+                this.tracingService?.endSpan(span);
+            }
             return { success: true };
         }
         catch (error) {
             this.updateStatus('Error al iniciar captura', error.message, 'error');
+            if (span) {
+                this.tracingService?.recordException(span, error);
+                this.tracingService?.endSpan(span);
+            }
             return { success: false, error: error.message };
         }
     }
@@ -511,13 +623,22 @@ export class JaakStamps {
         }
     }
     async preloadModel() {
+        const span = this.tracingService?.startSpan('model.preload');
         const readyCheck = this.isComponentReady();
         if (!readyCheck.ready) {
             this.updateStatus(readyCheck.message, 'Espere a que termine la inicialización', readyCheck.status);
+            if (span) {
+                this.tracingService?.setSpanAttribute(span, 'error', true);
+                this.tracingService?.endSpan(span);
+            }
             return { success: false, error: readyCheck.message };
         }
         if (this.detectionService.isModelLoaded()) {
             this.updateStatus('Reconocimiento listo', '', 'ready');
+            if (span) {
+                this.tracingService?.setSpanAttribute(span, 'cached', true);
+                this.tracingService?.endSpan(span);
+            }
             return { success: true, message: 'Model already loaded' };
         }
         try {
@@ -527,17 +648,31 @@ export class JaakStamps {
                 this.stateManager.updateCaptureState({ isLoading: true });
             }
             try {
+                const detectionStartTime = performance.now();
+                const modelSpan = this.tracingService?.startSpan('model.detection.load');
                 await this.detectionService.loadModel();
+                if (modelSpan)
+                    this.tracingService?.endSpan(modelSpan);
+                const detectionLoadTime = performance.now() - detectionStartTime;
+                this.metricsService?.recordModelLoad('detection', detectionLoadTime, false);
             }
             catch (modelError) {
+                this.metricsService?.recordError('model_load_failed', 'detection');
                 this.switchToManualModeWithError('Error al cargar modelo de detección');
                 throw modelError;
             }
             this.updateStatus('Optimizando detección...', 'Configurando reconocimiento de documentos', 'loading');
             try {
+                const classificationStartTime = performance.now();
+                const classSpan = this.tracingService?.startSpan('model.classification.load');
                 await this.detectionService.loadClassificationModel();
+                if (classSpan)
+                    this.tracingService?.endSpan(classSpan);
+                const classificationLoadTime = performance.now() - classificationStartTime;
+                this.metricsService?.recordModelLoad('classification', classificationLoadTime, false);
             }
             catch (classificationError) {
+                this.metricsService?.recordError('model_load_failed', 'classification');
                 this.switchToManualModeWithError('Error al cargar modelo de clasificación');
                 throw classificationError;
             }
@@ -547,6 +682,9 @@ export class JaakStamps {
             if (this.debug) {
                 this.recordOnnxPerformance(loadTime, 0);
             }
+            if (span) {
+                this.tracingService?.setSpanAttribute(span, 'loadTime', loadTime);
+            }
             this.updateStatus('Finalizando configuración...', 'Preparando herramientas para captura', 'loading');
             await new Promise(resolve => setTimeout(resolve, 300));
             this.updateStatus('Reconocimiento preparado', '', 'ready');
@@ -554,6 +692,10 @@ export class JaakStamps {
                 this.stateManager.updateCaptureState({ isLoading: false });
             }
             this.emitReadyEvent();
+            if (span) {
+                this.tracingService?.setSpanAttribute(span, 'success', true);
+                this.tracingService?.endSpan(span);
+            }
             return { success: true, message: 'Models preloaded successfully' };
         }
         catch (error) {
@@ -561,6 +703,10 @@ export class JaakStamps {
             if (this.stateManager) {
                 this.stateManager.updateCaptureState({ isLoading: false });
             }
+            if (span) {
+                this.tracingService?.recordException(span, error);
+                this.tracingService?.endSpan(span);
+            }
             return { success: false, error: error.message };
         }
     }
@@ -983,7 +1129,7 @@ export class JaakStamps {
             isCapturing: false
         };
         const cameraInfo = this.cameraInfoWithAutofocus;
-        return (h("div", { key: 'f9cbca2fd6b8548a29ace7fcb972b53f402f61af', class: "detector-container" }, h("div", { key: '4f3cac734eb6bfd44a8de644eadca17e7893e11a', class: "video-container" }, h("video", { key: '5e15a38c989a72d5274281272d41ba064447ca6f', ref: el => this.videoRef = el, autoplay: true, muted: true, playsinline: true, class: this.shouldMirrorVideo ? 'mirror' : '', style: { display: captureState.isVideoActive ? 'block' : 'none' } }), h("div", { key: '38c8ad8b691db60e9b5a2a8b641fe6febbeacfca', ref: el => this.detectionContainer = el, class: `detection-overlay ${this.shouldMirrorVideo ? 'mirror' : ''}` }, this.debug && this.detectionBoxes.map((box, index) => (h("div", { key: index, class: "detection-box", style: {
+        return (h("div", { key: '69b36b10f1a790caa352acd5e149fe012ddebd3d', class: "detector-container" }, !this.licenseValid && this.licenseError && (h("div", { key: 'b96d8b52f6bb366b1d6239922a95b100befa5735', class: "license-error-container" }, h("div", { key: '58fb20b1acae97631c35730ed395acf9fa583df2', class: "license-error-card" }, h("svg", { key: 'f2726621e000bad3c62b1106778bb50e32ece973', class: "license-error-icon", width: "64", height: "64", viewBox: "0 0 24 24", fill: "none", xmlns: "http://www.w3.org/2000/svg" }, h("path", { key: '18a51f219cdc93f717867f61502c55b35d250532', d: "M12 22C12 22 20 18 20 12V5L12 2L4 5V12C4 18 12 22 12 22Z", stroke: "currentColor", "stroke-width": "2", "stroke-linecap": "round", "stroke-linejoin": "round" }), h("path", { key: '0f157178a69c10590dd55f55c2223fdef31c2569', d: "M12 8V12", stroke: "currentColor", "stroke-width": "2", "stroke-linecap": "round" }), h("circle", { key: '0352746bef8e2e5a6be0c3868406005aae574a71', cx: "12", cy: "16", r: "0.5", fill: "currentColor", stroke: "currentColor", "stroke-width": "1" })), h("h2", { key: 'c63de740aa94503f1cf5e1cd1b366b11bc3253b3', class: "license-error-title" }, "Licencia Requerida"), h("p", { key: 'e36cefd08b510fc38f326de557ffc16425a0b324', class: "license-error-message" }, this.licenseError), h("p", { key: 'c77c6545b5186f7fb77a414120d3f6f5ba4a45f0', class: "license-error-help" }, "Contacte a soporte: ", h("a", { key: 'bef70b41a7ec454bed38c4162ce3cafc02c81071', href: "mailto:support@jaak.ai" }, "support@jaak.ai")), h("div", { key: '7fd679252453474021494c8dac3ec44da60b40eb', class: "license-error-footer" }, "JAAK Stamps")))), this.licenseValid && (h("div", { key: '369edcb3d7fcaa18059ae89f340f5e65bd0f0785', class: "video-container" }, h("video", { key: '88a67cf2451ebd53cb4fa709d34d11c7fa98cfc9', ref: el => this.videoRef = el, autoplay: true, muted: true, playsinline: true, class: this.shouldMirrorVideo ? 'mirror' : '', style: { display: captureState.isVideoActive ? 'block' : 'none' } }), h("div", { key: 'd309664c7a9e64f33dd45e0925f27768483b6795', ref: el => this.detectionContainer = el, class: `detection-overlay ${this.shouldMirrorVideo ? 'mirror' : ''}` }, this.debug && this.detectionBoxes.map((box, index) => (h("div", { key: index, class: "detection-box", style: {
                 position: 'absolute',
                 left: `${box.x}px`,
                 top: `${box.y}px`,
@@ -992,9 +1138,9 @@ export class JaakStamps {
                 border: '2px solid #32406C',
                 pointerEvents: 'none',
                 boxSizing: 'border-box'
-            } })))), this.isMaskReady && (h("div", { key: 'c56fde56b7a86a4e8a4cf558745291ea5cde12fd', class: "overlay-mask" }, h("div", { key: '04ed3f01f271dc84eed594cb4b60c2453645bd41', class: "card-outline" }, h("div", { key: '648bd423a5e886d4768115237de5896c7223b30b', class: "side side-top" }), h("div", { key: 'b8878059493ca61961b9b3c82ecc18b50b79ac85', class: "side side-right" }), h("div", { key: '09e5ad64ff33dbd5c112bf52b71e14409ab6aa65', class: "side side-bottom" }), h("div", { key: 'b8ba3d83c9bc1b4a0da859d7ed4b9a15eaddcc2a', class: "side side-left" })), !captureState.showFlipAnimation && !captureState.showSuccessAnimation && (h("div", { key: '3279701a240f77ac96e68a34ad95c099340c9a6a', class: `guide-text ${this.showPerformanceMessage ? 'performance-warning-text' : ''}` }, this.getGuideText(captureState.step))), captureState.step === 'back' && !captureState.showFlipAnimation && !captureState.showSuccessAnimation && (h("div", { key: '2adf96d0a57e482372fd9586229dac2301b64fd4', class: "back-capture-section" }, h("div", { key: '305a147c9cfee854c60ac946a48a1d21b2792725', class: "back-capture-buttons" }, (!this.useDocumentDetector || this.performanceDegradedMode || this.showManualCaptureButton) && (h("button", { key: '43270a0647f39307229c540dd5130fb58b1ff4fb', class: "capture-button primary-button", onClick: () => this.takeManualScreenshot(), type: "button", disabled: this.processingButton !== null }, this.processingButton === 'capture-back' && (h("span", { key: 'eb4666603774564eef95a120ac13faeb9e10c8b4', class: "button-spinner" })), "Capturar Reverso")), h("button", { key: 'cac667d9548ae2314ad5a677c5ed90f25184f728', class: "skip-button", onClick: () => this.skipBackCapture(), type: "button", disabled: this.processingButton !== null }, this.processingButton === 'skip-back' && (h("span", { key: '0af7aa4106ce189ae2d79bec78ede01abe25b1e7', class: "button-spinner" })), this.enableBackDocumentTimer && this.backDocumentTimerRemaining > 0
+            } })))), this.isMaskReady && (h("div", { key: 'fbfc808e22ec640ddd9e34d52fab476d7a9becc1', class: "overlay-mask" }, h("div", { key: '40846a04d852bbcc2ac6c4a0ca356adae1c67765', class: "card-outline" }, h("div", { key: '452fe1786b67d0f9194e5d03ad2aaee08868a5fd', class: "side side-top" }), h("div", { key: 'a462c388ea55cd022b9616571f0012bd5eb380d4', class: "side side-right" }), h("div", { key: 'bfa2232443e23f2e72f009c62f7a866b9ff1b084', class: "side side-bottom" }), h("div", { key: '581746eca6fde6340d78e8ab48d6e21d17e7dfd3', class: "side side-left" })), !captureState.showFlipAnimation && !captureState.showSuccessAnimation && (h("div", { key: '8e57ac550ea3718322ba954682f93239acbabc78', class: `guide-text ${this.showPerformanceMessage ? 'performance-warning-text' : ''}` }, this.getGuideText(captureState.step))), captureState.step === 'back' && !captureState.showFlipAnimation && !captureState.showSuccessAnimation && (h("div", { key: '81cfab68789796d901afadc895d28f398e8c15cf', class: "back-capture-section" }, h("div", { key: 'd80455bd916c2d7ac47eb0ce3c62b0e5efbe4dff', class: "back-capture-buttons" }, (!this.useDocumentDetector || this.performanceDegradedMode || this.showManualCaptureButton) && (h("button", { key: 'c6d427cb32ecfb1ff40150d39f1d8ad7565f7156', class: "capture-button primary-button", onClick: () => this.takeManualScreenshot(), type: "button", disabled: this.processingButton !== null }, this.processingButton === 'capture-back' && (h("span", { key: 'cb57aec75ff91f2887fa258bd79b8efb98614d13', class: "button-spinner" })), "Capturar Reverso")), h("button", { key: 'c76f356a34fcbc790ebe2d900ed61cc4a6a02e28', class: "skip-button", onClick: () => this.skipBackCapture(), type: "button", disabled: this.processingButton !== null }, this.processingButton === 'skip-back' && (h("span", { key: 'd8fe69623902a5f41587f630552ef28a352733c6', class: "button-spinner" })), this.enableBackDocumentTimer && this.backDocumentTimerRemaining > 0
             ? `Saltar reverso (${this.backDocumentTimerRemaining}s)`
-            : 'Saltar reverso')))), captureState.isVideoActive && (h("div", { key: 'de6e5c4fad4d4d996b894457c9af52bc71e533fb', class: "camera-controls" }, h("button", { key: 'cfddcf2420d5f5923a6b02ca446bbe1b8e9fc5e4', class: `camera-selector-button ${this.isSwitchingCamera ? 'loading' : ''}`, onClick: () => this.toggleCameraSelector(), type: "button", title: "Seleccionar c\u00E1mara", disabled: this.isSwitchingCamera }, this.isSwitchingCamera ? (h("div", { class: "button-spinner" })) : ('Cámaras')))), this.showCameraSelector && cameraInfo.availableCameras.length > 0 && (h("div", { key: '5fb73f958b9a5a6f9242032c4530b0bdab84f6c5', class: "camera-selector-dropdown" }, h("div", { key: '8ee2d26b1001e571e7b6c326e927926fa08287fd', class: "camera-selector-header" }, h("span", { key: '78350b0fb1bd933f7c8c59d8dab0b7122ffbe363' }, "Seleccionar C\u00E1mara"), h("button", { key: 'bb750e0ddd5a1ee5ff96bd57805a7f90b8821e9f', class: "close-selector", onClick: () => this.toggleCameraSelector(), type: "button" }, "\u00D7")), h("div", { key: 'd0f6343cf1b7367f3da33ec8cf64891109d923b8', class: "camera-list" }, cameraInfo.availableCameras.map((camera) => (h("button", { key: camera.id, class: `camera-option ${cameraInfo.selectedCameraId === camera.id ? 'selected' : ''}`, onClick: () => this.handleCameraSwitch(camera.id), type: "button" }, h("span", { class: "camera-label" }, camera.label || `Cámara ${cameraInfo.availableCameras.indexOf(camera) + 1}`, camera.hasAutofocus && (h("span", { class: "autofocus-icon", title: "Autofoco disponible" }, "\u29BF"))), cameraInfo.selectedCameraId === camera.id && (h("span", { class: "selected-indicator" }, "\u2713")))))), h("div", { key: 'c9642fbfb0acea766d3f0542f4cc9f17f4af4d7b', class: "device-info" }, h("small", { key: 'b6e9507ff7addf011f339f6c22a88a96b40db68a' }, "Dispositivo: ", cameraInfo.deviceType)))), this.showManualCaptureButton && captureState.step === 'front' && !captureState.showFlipAnimation && !captureState.showSuccessAnimation && (h("div", { key: '04ae9262409284782850b90945eb7038673e2097', class: "manual-capture-section" }, h("button", { key: '27c315e503ccba468b89ebd58d6b70f40ddd06ba', class: "manual-capture-button", onClick: () => this.takeManualScreenshot(), type: "button", disabled: this.processingButton !== null }, this.processingButton === 'capture-front' && (h("span", { key: '8f2dcd2df9a218b37eb0b8204a8724362cfeaa53', class: "button-spinner" })), "Capturar Frente"))))), captureState.isCapturing && (h("div", { key: '6fd6fe1d0213b01c8119a67fb8108f73227feee1', class: "capture-animation" })), captureState.showFlipAnimation && (h("div", { key: 'fba3816b48b99ca64510ecbefc0d41431569c9ae', class: "flip-animation" }, h("div", { key: 'beea1c8245b5d81f1008efc6d1b079a61c821e7f', class: "id-card-icon" }), h("div", { key: 'f0fbc34f619a653e2c0ade764ca99e7aa582d157', class: "flip-text" }, "\u00A1Voltea tu identificaci\u00F3n!"))), captureState.showSuccessAnimation && (h("div", { key: 'e4a0e6d31112e3a50024d1d0430b4ad997049fe7', class: "success-animation" }, h("div", { key: '5dd3f781f55630bc904c81207548ae35bc79b452', class: "check-icon" }), h("div", { key: 'a10ebc557582325091efb0abd12d62b27a43b98c', class: "success-text" }, "\u00A1Proceso completado!"))), h("div", { key: '975865955dee1803b5215ecf049701c98b324855', class: `component-status status-${this.currentStatus.type}` }, (this.currentStatus.type === 'loading' || this.currentStatus.type === 'initializing') && (h("div", { key: '84f6f67202e26ce80f7fc5d5f321e23b5bc55c57', class: "status-spinner" })), h("div", { key: 'a1ae56ed156e8feb279a1bf160f749c5d0b5ce45', class: "status-content" }, h("div", { key: 'd62932554cea257ce19763df26e0ba702e50eeca', class: "status-message" }, this.currentStatus.message), this.currentStatus.description && (h("div", { key: 'c5506fa12dd0d37d26dc26c9f2381c843330451f', class: "status-description" }, this.currentStatus.description)))), this.debug && (h("div", { key: '2097eda63185f336f7319014fae2ef6db1e41761', class: "performance-monitor" }, h("div", { key: 'd611c494c6b1a5930ef64aebdcba41e5d94c9ee6', class: "performance-expanded" }, h("div", { key: '800d46831e7b9bec260d9c5e67ea1a3eb9c2933e', class: "metrics-row" }, h("div", { key: 'dd0db1faa9050d98e71da4b5cd26a4a484c37c64', class: "metric-compact" }, h("span", { key: 'f0e6ea61a35ddb2ae5c2a6aff8c255a02c5c1219', class: "metric-label" }, "FPS"), h("span", { key: 'cbf4df4d142f6f01e45f566a8ede8fbbf29ad673', class: `metric-value ${this.performanceData.fps < 15 ? 'warning' : this.performanceData.fps < 10 ? 'danger' : 'good'}` }, this.performanceData.fps)), h("div", { key: '83861ad31fa46c8199a5583e4b3f8eefd44bacd6', class: "metric-compact" }, h("span", { key: '41b8de4cda47959dfc9df393e95fdadde534dd21', class: "metric-label" }, "MEM"), h("span", { key: 'b268f13cc78066e240ed158f1443113a94827aff', class: `metric-value ${this.performanceData.memoryUsage > 100 ? 'warning' : this.performanceData.memoryUsage > 200 ? 'danger' : 'good'}` }, this.performanceData.memoryUsage, "MB"))), h("div", { key: '9f9a9d0690906b186492af23b900c5fa0f5cff89', class: "metrics-row" }, h("div", { key: '84fa6e453dc36e4a74e8b573447b17230766229e', class: "metric-compact" }, h("span", { key: 'f17d52899090c89f532d74c552dd8c5338fc2d83', class: "metric-label" }, "INF"), h("span", { key: '2beca0d7ce55ed574f6b01efc086c5846983e024', class: `metric-value ${this.performanceData.inferenceTime > 100 ? 'warning' : this.performanceData.inferenceTime > 200 ? 'danger' : 'good'}` }, this.performanceData.inferenceTime, "ms")), h("div", { key: '981e300cf076e81bfe946974f6cffd63619eacde', class: "metric-compact" }, h("span", { key: '3dfb0c996a69eb87b0f711322675cad69c471146', class: "metric-label" }, "FRAME"), h("span", { key: '3ae2ac6e90cda77f23e559f3197c3b761f9bdc40', class: `metric-value ${this.performanceData.frameProcessingTime > 50 ? 'warning' : this.performanceData.frameProcessingTime > 100 ? 'danger' : 'good'}` }, this.performanceData.frameProcessingTime, "ms"))), h("div", { key: '2c51216838d87728d9d7764e5ba8a50fa02eb493', class: "metrics-row" }, h("div", { key: 'eda810ffb80ec38ab84583f59b26706f90a50fc9', class: "metric-compact" }, h("span", { key: '978ba9c0c67d6da6b29b3535af33a314bab9276a', class: "metric-label" }, "DET"), h("span", { key: '3e5e169fd4a3906283d8f918b5bbc7c5df6ccd0f', class: "metric-value good" }, this.performanceData.successfulDetections, "/", this.performanceData.totalDetections)), h("div", { key: 'b4b915c745e35c09470a4dc5edfc112d32cfb8b6', class: "metric-compact" }, h("span", { key: '3e2a7b88a4446813c955efb0dfa9e2958e8e1448', class: "metric-label" }, "RATE"), h("span", { key: 'f4f073f7ee622167a241c6a1c535ef580c13d9ab', class: `metric-value ${this.performanceData.detectionRate < 30 ? 'danger' : this.performanceData.detectionRate < 60 ? 'warning' : 'good'}` }, this.performanceData.detectionRate, "%")))))), h("div", { key: '76c556e92f6d7980539f1a30efe8751f665164fb', class: "watermark" }, h("img", { key: 'af23e115d6b4e92a72e55d6d98fde0e4b1d09e9b', src: "https://storage.googleapis.com/jaak-static/commons/powered-by-jaak.png", alt: "Powered by Jaak" })))));
+            : 'Saltar reverso')))), captureState.isVideoActive && (h("div", { key: '08f4037c20b4dfed59553a7f29474940f5f3eb49', class: "camera-controls" }, h("button", { key: 'e873835d5d6587b19eb5e61e0073e4992fe115b6', class: `camera-selector-button ${this.isSwitchingCamera ? 'loading' : ''}`, onClick: () => this.toggleCameraSelector(), type: "button", title: "Seleccionar c\u00E1mara", disabled: this.isSwitchingCamera }, this.isSwitchingCamera ? (h("div", { class: "button-spinner" })) : ('Cámaras')))), this.showCameraSelector && cameraInfo.availableCameras.length > 0 && (h("div", { key: '8fca7e29f868570bb99dd2d09ca7da807656dad0', class: "camera-selector-dropdown" }, h("div", { key: 'abfac31042d3b362c094a297429e0272dabb2511', class: "camera-selector-header" }, h("span", { key: 'ffcd0e3c262aa86c431617568c1070548d88f38a' }, "Seleccionar C\u00E1mara"), h("button", { key: '8351be02ccbfa818cab352a37a29d2cd5bfd53ef', class: "close-selector", onClick: () => this.toggleCameraSelector(), type: "button" }, "\u00D7")), h("div", { key: 'b42d7a5855ec2f76bc105f7b03369b3d4c950762', class: "camera-list" }, cameraInfo.availableCameras.map((camera) => (h("button", { key: camera.id, class: `camera-option ${cameraInfo.selectedCameraId === camera.id ? 'selected' : ''}`, onClick: () => this.handleCameraSwitch(camera.id), type: "button" }, h("span", { class: "camera-label" }, camera.label || `Cámara ${cameraInfo.availableCameras.indexOf(camera) + 1}`, camera.hasAutofocus && (h("span", { class: "autofocus-icon", title: "Autofoco disponible" }, "\u29BF"))), cameraInfo.selectedCameraId === camera.id && (h("span", { class: "selected-indicator" }, "\u2713")))))), h("div", { key: 'cf3ca9fe1d626320ad2653a3db44cd86e998bcdf', class: "device-info" }, h("small", { key: '9b908dc6e759f1a5311b068dba10428ebd22cdc3' }, "Dispositivo: ", cameraInfo.deviceType)))), this.showManualCaptureButton && captureState.step === 'front' && !captureState.showFlipAnimation && !captureState.showSuccessAnimation && (h("div", { key: '9aa48412eaac0b2adf19f1defb3bc835ab031d9f', class: "manual-capture-section" }, h("button", { key: '1828e293ae4e544b00d0dd17a86401ff0436de37', class: "manual-capture-button", onClick: () => this.takeManualScreenshot(), type: "button", disabled: this.processingButton !== null }, this.processingButton === 'capture-front' && (h("span", { key: 'bbea1d654f80e537ff6616920fb6a2cb410e55f0', class: "button-spinner" })), "Capturar Frente"))))), captureState.isCapturing && (h("div", { key: '532f72395868ecf58bef350aed4da4e4fc0fa13c', class: "capture-animation" })), captureState.showFlipAnimation && (h("div", { key: '555cbc7504660b722f23389899956cf979a27e6c', class: "flip-animation" }, h("div", { key: 'e5de939b02cfb65697c70f265492f1f30f75c771', class: "id-card-icon" }), h("div", { key: '35867c2fbdf463d5b28f0bd3a58313d0d6f15e7b', class: "flip-text" }, "\u00A1Voltea tu identificaci\u00F3n!"))), captureState.showSuccessAnimation && (h("div", { key: '4a96d077e993012ed333384219ba27d5a68787ea', class: "success-animation" }, h("div", { key: '836809412d0674a0061aadaaa7c712a22f8770da', class: "check-icon" }), h("div", { key: 'd541dbdfa548760b196dd09dc44c3d1a6af8093c', class: "success-text" }, "\u00A1Proceso completado!"))), h("div", { key: '89a9d99fbeedff1bbcf723ba13d551c3290150fe', class: `component-status status-${this.currentStatus.type}` }, (this.currentStatus.type === 'loading' || this.currentStatus.type === 'initializing') && (h("div", { key: 'f100984baef7602ea40cea9bb74b4c84fd1f6ed9', class: "status-spinner" })), h("div", { key: 'ad4161c71f438174117e306e5084bfdff3d18dce', class: "status-content" }, h("div", { key: '26310245b58f331075dd344a6497e90631d5d78c', class: "status-message" }, this.currentStatus.message), this.currentStatus.description && (h("div", { key: 'f739148b45f7d43a3015cca3de8efc8b71d3d5e4', class: "status-description" }, this.currentStatus.description)))), this.debug && (h("div", { key: '0397b96391dff4f0662c913068a62c714df168bf', class: "performance-monitor" }, h("div", { key: 'da3c3638b3c048a425bf691b29755762ad40aa5c', class: "performance-expanded" }, h("div", { key: '467f5e2dc207cfd9fd31cef24d434452b3247c5f', class: "metrics-row" }, h("div", { key: 'e620d9017402317e09ec554bf933a4f5a5d0b0de', class: "metric-compact" }, h("span", { key: '8d21fa081bbf3ec7ad54f553b60b0a64ae41fb01', class: "metric-label" }, "FPS"), h("span", { key: '8e99113c7b93c128d7e390900a63f16c5b9483c0', class: `metric-value ${this.performanceData.fps < 15 ? 'warning' : this.performanceData.fps < 10 ? 'danger' : 'good'}` }, this.performanceData.fps)), h("div", { key: '67927ff90810b0c4d6717d520ad50142d5d6c0dd', class: "metric-compact" }, h("span", { key: '4810964d65c18248f01aff90dca36d732b80a05c', class: "metric-label" }, "MEM"), h("span", { key: 'e82ff493a2bc1d3baf60c1f638154e9208d0991f', class: `metric-value ${this.performanceData.memoryUsage > 100 ? 'warning' : this.performanceData.memoryUsage > 200 ? 'danger' : 'good'}` }, this.performanceData.memoryUsage, "MB"))), h("div", { key: '6ef07b3f3dc4c3d991f4bbae34e902a9efc1a359', class: "metrics-row" }, h("div", { key: 'b5eed3b30cb99d4d088a05494cda2eff0ba393cc', class: "metric-compact" }, h("span", { key: '52749839a61316b90f424b0920f4c82c6683dd29', class: "metric-label" }, "INF"), h("span", { key: '8509cf19af19b6ac2efc7ab68ac46d9d053c5464', class: `metric-value ${this.performanceData.inferenceTime > 100 ? 'warning' : this.performanceData.inferenceTime > 200 ? 'danger' : 'good'}` }, this.performanceData.inferenceTime, "ms")), h("div", { key: '34a8540d0840056a525a7afc35ca956943b527af', class: "metric-compact" }, h("span", { key: 'bdc2d8cd180b92ee7b84c8372aba5c2f33289669', class: "metric-label" }, "FRAME"), h("span", { key: '481a0735a5b7258fecdc1bab65a4d4018cc0e7b9', class: `metric-value ${this.performanceData.frameProcessingTime > 50 ? 'warning' : this.performanceData.frameProcessingTime > 100 ? 'danger' : 'good'}` }, this.performanceData.frameProcessingTime, "ms"))), h("div", { key: '7b5aa0a6fe97970f09db23103f7f0301fd98c4f8', class: "metrics-row" }, h("div", { key: '1c691159409e021176557904a1ceec05abc329e1', class: "metric-compact" }, h("span", { key: '5ab6c25d80548aa4e63c79ecf88d2386393ae707', class: "metric-label" }, "DET"), h("span", { key: '7641532633bc764d4dc209ba7e1827a2f3f59338', class: "metric-value good" }, this.performanceData.successfulDetections, "/", this.performanceData.totalDetections)), h("div", { key: 'feee52f464eeb965eeadfd944a65e94600591ed5', class: "metric-compact" }, h("span", { key: 'c7962650a7bf1bc86f8c733eb01d5eeb9e08d37e', class: "metric-label" }, "RATE"), h("span", { key: '337529444c8e7bacb47d686d0be33721a066eebe', class: `metric-value ${this.performanceData.detectionRate < 30 ? 'danger' : this.performanceData.detectionRate < 60 ? 'warning' : 'good'}` }, this.performanceData.detectionRate, "%")))))), h("div", { key: '49717c49e5316bfe10690733c5bf07eb0475a3e2', class: "watermark" }, h("img", { key: 'f86ff4364196627bb3f169e5ee1c14696126cd68', src: "https://storage.googleapis.com/jaak-static/commons/powered-by-jaak.png", alt: "Powered by Jaak" }))))));
     }
     // Utility methods
     updateDetectionBoxes(boxes) {
@@ -1111,24 +1257,44 @@ export class JaakStamps {
     }
     async takeManualScreenshot() {
         console.log('🔵 Botón clicked: Capturar (Frente/Reverso)');
+        const captureStartTime = performance.now();
+        const span = this.tracingService?.startSpan('capture.screenshot.manual');
         // Set processing state immediately
         const captureState = this.stateManager?.getCaptureState();
+        const side = captureState?.step === 'front' ? 'front' : 'back';
         if (captureState?.step === 'front') {
             this.processingButton = 'capture-front';
+            if (span)
+                this.tracingService?.setSpanAttribute(span, 'side', 'front');
         }
         else if (captureState?.step === 'back') {
             this.processingButton = 'capture-back';
+            if (span)
+                this.tracingService?.setSpanAttribute(span, 'side', 'back');
         }
+        // Record user interaction
+        this.metricsService?.recordUserInteraction('manual_capture_button');
         console.log('🔵 processingButton set to:', this.processingButton);
         // Add small delay to show spinner
         await new Promise(resolve => setTimeout(resolve, 100));
         if (!this.videoRef) {
             this.processingButton = null;
+            if (span) {
+                this.tracingService?.setSpanAttribute(span, 'error', 'no_video_ref');
+                this.tracingService?.endSpan(span);
+            }
             return;
         }
         // When using manual capture, use mask coordinates for cropping
         // Note: processingButton will be cleared inside takeScreenshotWithMaskCoordinates
         await this.takeScreenshotWithMaskCoordinates();
+        // Record metrics
+        const captureDuration = performance.now() - captureStartTime;
+        this.metricsService?.recordCapture(side, 'manual', captureDuration);
+        if (span) {
+            this.tracingService?.setSpanAttribute(span, 'success', true);
+            this.tracingService?.endSpan(span);
+        }
     }
     async takeScreenshotWithMaskCoordinates() {
         if (!this.videoRef || !this.detectionContainer)
@@ -1247,6 +1413,8 @@ export class JaakStamps {
     async takeScreenshot() {
         if (!this.videoRef || !this.lastDetectedBox)
             return;
+        const captureStartTime = performance.now();
+        const span = this.tracingService?.startSpan('capture.screenshot.auto');
         this.stateManager.updateCaptureState({ isCapturing: true });
         this.triggerCaptureAnimation();
         // Use pooled canvas for optimization
@@ -1269,17 +1437,30 @@ export class JaakStamps {
         croppedCtx.drawImage(this.videoRef, cropX, cropY, cropWidth, cropHeight, 0, 0, cropWidth, cropHeight);
         const captureState = this.stateManager.getCaptureState();
         if (captureState.step === 'front') {
+            const frontImageData = captureCanvas.toDataURL('image/jpeg');
+            const croppedImageData = croppedCanvas.toDataURL('image/jpeg');
             this.stateManager.setCapturedImages({
                 front: {
-                    fullFrame: captureCanvas.toDataURL('image/jpeg'),
-                    cropped: croppedCanvas.toDataURL('image/jpeg')
+                    fullFrame: frontImageData,
+                    cropped: croppedImageData
                 }
             });
+            // Record metrics
+            const captureDuration = performance.now() - captureStartTime;
+            this.metricsService?.recordCapture('front', 'auto', captureDuration);
+            this.metricsService?.recordImageSize('front', frontImageData.length);
+            if (span) {
+                this.tracingService?.setSpanAttribute(span, 'side', 'front');
+            }
             // Check if document classification is enabled
             if (this.useDocumentClassification) {
                 try {
                     const classification = await this.detectionService.classifyDocument(croppedCanvas);
                     if (classification && classification.class === 'passport') {
+                        if (span) {
+                            this.tracingService?.setSpanAttribute(span, 'document.type', 'passport');
+                            this.tracingService?.endSpan(span);
+                        }
                         this.completeProcess(true);
                         return;
                     }
@@ -1293,6 +1474,9 @@ export class JaakStamps {
                 isDetectionPaused: true,
                 showFlipAnimation: true
             });
+            if (span) {
+                this.tracingService?.endSpan(span);
+            }
             setTimeout(() => {
                 this.stateManager.updateCaptureState({
                     showFlipAnimation: false,
@@ -1302,12 +1486,22 @@ export class JaakStamps {
             }, 3000);
         }
         else if (captureState.step === 'back') {
+            const backImageData = captureCanvas.toDataURL('image/jpeg');
+            const croppedBackImageData = croppedCanvas.toDataURL('image/jpeg');
             this.stateManager.setCapturedImages({
                 back: {
-                    fullFrame: captureCanvas.toDataURL('image/jpeg'),
-                    cropped: croppedCanvas.toDataURL('image/jpeg')
+                    fullFrame: backImageData,
+                    cropped: croppedBackImageData
                 }
             });
+            // Record metrics
+            const captureDuration = performance.now() - captureStartTime;
+            this.metricsService?.recordCapture('back', 'auto', captureDuration);
+            this.metricsService?.recordImageSize('back', backImageData.length);
+            if (span) {
+                this.tracingService?.setSpanAttribute(span, 'side', 'back');
+                this.tracingService?.endSpan(span);
+            }
             this.completeProcess(false);
         }
         // Return canvases to pool after use
@@ -1944,6 +2138,261 @@ export class JaakStamps {
                 "setter": false,
                 "reflect": false,
                 "defaultValue": "20"
+            },
+            "telemetryCollectorUrl": {
+                "type": "string",
+                "attribute": "telemetry-collector-url",
+                "mutable": false,
+                "complexType": {
+                    "original": "string",
+                    "resolved": "string",
+                    "references": {}
+                },
+                "required": false,
+                "optional": true,
+                "docs": {
+                    "tags": [],
+                    "text": ""
+                },
+                "getter": false,
+                "setter": false,
+                "reflect": false,
+                "defaultValue": "'https://collector.jaak.ai/v1/traces'"
+            },
+            "metricsCollectorUrl": {
+                "type": "string",
+                "attribute": "metrics-collector-url",
+                "mutable": false,
+                "complexType": {
+                    "original": "string",
+                    "resolved": "string",
+                    "references": {}
+                },
+                "required": false,
+                "optional": true,
+                "docs": {
+                    "tags": [],
+                    "text": ""
+                },
+                "getter": false,
+                "setter": false,
+                "reflect": false,
+                "defaultValue": "'https://collector.jaak.ai/v1/metrics'"
+            },
+            "enableTelemetry": {
+                "type": "boolean",
+                "attribute": "enable-telemetry",
+                "mutable": false,
+                "complexType": {
+                    "original": "boolean",
+                    "resolved": "boolean",
+                    "references": {}
+                },
+                "required": false,
+                "optional": false,
+                "docs": {
+                    "tags": [],
+                    "text": ""
+                },
+                "getter": false,
+                "setter": false,
+                "reflect": false,
+                "defaultValue": "true"
+            },
+            "enableMetrics": {
+                "type": "boolean",
+                "attribute": "enable-metrics",
+                "mutable": false,
+                "complexType": {
+                    "original": "boolean",
+                    "resolved": "boolean",
+                    "references": {}
+                },
+                "required": false,
+                "optional": false,
+                "docs": {
+                    "tags": [],
+                    "text": ""
+                },
+                "getter": false,
+                "setter": false,
+                "reflect": false,
+                "defaultValue": "true"
+            },
+            "customerId": {
+                "type": "string",
+                "attribute": "customer-id",
+                "mutable": false,
+                "complexType": {
+                    "original": "string",
+                    "resolved": "string",
+                    "references": {}
+                },
+                "required": false,
+                "optional": true,
+                "docs": {
+                    "tags": [],
+                    "text": ""
+                },
+                "getter": false,
+                "setter": false,
+                "reflect": false
+            },
+            "tenantId": {
+                "type": "string",
+                "attribute": "tenant-id",
+                "mutable": false,
+                "complexType": {
+                    "original": "string",
+                    "resolved": "string",
+                    "references": {}
+                },
+                "required": false,
+                "optional": true,
+                "docs": {
+                    "tags": [],
+                    "text": ""
+                },
+                "getter": false,
+                "setter": false,
+                "reflect": false
+            },
+            "environment": {
+                "type": "string",
+                "attribute": "environment",
+                "mutable": false,
+                "complexType": {
+                    "original": "string",
+                    "resolved": "string",
+                    "references": {}
+                },
+                "required": false,
+                "optional": true,
+                "docs": {
+                    "tags": [],
+                    "text": ""
+                },
+                "getter": false,
+                "setter": false,
+                "reflect": false,
+                "defaultValue": "'production'"
+            },
+            "propagateTraceHeaderCorsUrls": {
+                "type": "string",
+                "attribute": "propagate-trace-header-cors-urls",
+                "mutable": false,
+                "complexType": {
+                    "original": "string",
+                    "resolved": "string",
+                    "references": {}
+                },
+                "required": false,
+                "optional": true,
+                "docs": {
+                    "tags": [],
+                    "text": ""
+                },
+                "getter": false,
+                "setter": false,
+                "reflect": false
+            },
+            "metricsExportIntervalMillis": {
+                "type": "number",
+                "attribute": "metrics-export-interval-millis",
+                "mutable": false,
+                "complexType": {
+                    "original": "number",
+                    "resolved": "number",
+                    "references": {}
+                },
+                "required": false,
+                "optional": true,
+                "docs": {
+                    "tags": [],
+                    "text": ""
+                },
+                "getter": false,
+                "setter": false,
+                "reflect": false,
+                "defaultValue": "60000"
+            },
+            "license": {
+                "type": "string",
+                "attribute": "license",
+                "mutable": false,
+                "complexType": {
+                    "original": "string",
+                    "resolved": "string",
+                    "references": {}
+                },
+                "required": false,
+                "optional": true,
+                "docs": {
+                    "tags": [],
+                    "text": ""
+                },
+                "getter": false,
+                "setter": false,
+                "reflect": false
+            },
+            "licenseEnvironment": {
+                "type": "string",
+                "attribute": "license-environment",
+                "mutable": false,
+                "complexType": {
+                    "original": "'dev' | 'qa' | 'staging' | 'prod'",
+                    "resolved": "\"dev\" | \"prod\" | \"qa\" | \"staging\"",
+                    "references": {}
+                },
+                "required": false,
+                "optional": true,
+                "docs": {
+                    "tags": [],
+                    "text": ""
+                },
+                "getter": false,
+                "setter": false,
+                "reflect": false,
+                "defaultValue": "'prod'"
+            },
+            "traceId": {
+                "type": "string",
+                "attribute": "trace-id",
+                "mutable": false,
+                "complexType": {
+                    "original": "string",
+                    "resolved": "string",
+                    "references": {}
+                },
+                "required": false,
+                "optional": true,
+                "docs": {
+                    "tags": [],
+                    "text": ""
+                },
+                "getter": false,
+                "setter": false,
+                "reflect": false
+            },
+            "appId": {
+                "type": "string",
+                "attribute": "app-id",
+                "mutable": false,
+                "complexType": {
+                    "original": "string",
+                    "resolved": "string",
+                    "references": {}
+                },
+                "required": false,
+                "optional": true,
+                "docs": {
+                    "tags": [],
+                    "text": ""
+                },
+                "getter": false,
+                "setter": false,
+                "reflect": false,
+                "defaultValue": "'jaak-stamps-web'"
             }
         };
     }
@@ -1964,7 +2413,9 @@ export class JaakStamps {
             "performanceDegradedMode": {},
             "showPerformanceMessage": {},
             "captureStateVersion": {},
-            "processingButton": {}
+            "processingButton": {},
+            "licenseValid": {},
+            "licenseError": {}
         };
     }
     static get events() {
@@ -1998,6 +2449,21 @@ export class JaakStamps {
                     "resolved": "boolean",
                     "references": {}
                 }
+            }, {
+                "method": "traceIdGenerated",
+                "name": "traceIdGenerated",
+                "bubbles": true,
+                "cancelable": true,
+                "composed": true,
+                "docs": {
+                    "tags": [],
+                    "text": ""
+                },
+                "complexType": {
+                    "original": "{traceId: string}",
+                    "resolved": "{ traceId: string; }",
+                    "references": {}
+                }
             }];
     }
     static get methods() {