@jaak.ai/stamps 2.5.7 → 2.5.8-dev.2

package/dist/cjs/loader.cjs.js

@@ -1,12 +1,12 @@
 'use strict';
 
-var index = require('./index-D6NBn_qu.js');
+var index = require('./index-BcFBOmM6.js');
 var appGlobals = require('./app-globals-V2Kpy_OQ.js');
 
 const defineCustomElements = async (win, options) => {
   if (typeof window === 'undefined') return undefined;
   await appGlobals.globalScripts();
-  return index.bootstrapLazy([["jaak-stamps.cjs",[[257,"jaak-stamps",{"debug":[4],"alignmentTolerance":[2,"alignment-tolerance"],"maskSize":[2,"mask-size"],"cropMargin":[2,"crop-margin"],"useDocumentClassification":[4,"use-document-classification"],"useDocumentDetector":[4,"use-document-detector"],"preferredCamera":[1,"preferred-camera"],"captureDelay":[2,"capture-delay"],"enableBackDocumentTimer":[4,"enable-back-document-timer"],"backDocumentTimerDuration":[2,"back-document-timer-duration"],"telemetryCollectorUrl":[1,"telemetry-collector-url"],"metricsCollectorUrl":[1,"metrics-collector-url"],"enableTelemetry":[4,"enable-telemetry"],"enableMetrics":[4,"enable-metrics"],"customerId":[1,"customer-id"],"tenantId":[1,"tenant-id"],"environment":[1],"propagateTraceHeaderCorsUrls":[1,"propagate-trace-header-cors-urls"],"metricsExportIntervalMillis":[2,"metrics-export-interval-millis"],"license":[1],"licenseEnvironment":[1,"license-environment"],"traceId":[1,"trace-id"],"appId":[1,"app-id"],"detectionBoxes":[32],"sideAlignment":[32],"isMaskReady":[32],"shouldMirrorVideo":[32],"showCameraSelector":[32],"isSwitchingCamera":[32],"hasDocumentDetected":[32],"cameraInfoWithAutofocus":[32],"currentStatus":[32],"performanceData":[32],"backDocumentTimerRemaining":[32],"showManualCaptureButton":[32],"performanceDegradedMode":[32],"showPerformanceMessage":[32],"captureStateVersion":[32],"processingButton":[32],"licenseValid":[32],"licenseError":[32],"classificationDisabled":[32],"getCapturedImages":[64],"isProcessCompleted":[64],"startCapture":[64],"stopCapture":[64],"resetCapture":[64],"skipBackCapture":[64],"getStatus":[64],"preloadModel":[64],"getCameraInfo":[64],"setPreferredCamera":[64],"setCaptureDelay":[64],"getCaptureDelay":[64]}]]]], options);
+  return index.bootstrapLazy([["jaak-stamps.cjs",[[257,"jaak-stamps",{"debug":[4],"alignmentTolerance":[2,"alignment-tolerance"],"maskSize":[2,"mask-size"],"cropMargin":[2,"crop-margin"],"useDocumentClassification":[4,"use-document-classification"],"useDocumentDetector":[4,"use-document-detector"],"preferredCamera":[1,"preferred-camera"],"captureDelay":[2,"capture-delay"],"enableBackDocumentTimer":[4,"enable-back-document-timer"],"backDocumentTimerDuration":[2,"back-document-timer-duration"],"telemetryCollectorUrl":[1,"telemetry-collector-url"],"metricsCollectorUrl":[1,"metrics-collector-url"],"enableTelemetry":[4,"enable-telemetry"],"enableMetrics":[4,"enable-metrics"],"customerId":[1,"customer-id"],"tenantId":[1,"tenant-id"],"environment":[1],"propagateTraceHeaderCorsUrls":[1,"propagate-trace-header-cors-urls"],"metricsExportIntervalMillis":[2,"metrics-export-interval-millis"],"license":[1],"licenseEnvironment":[1,"license-environment"],"traceId":[1,"trace-id"],"appId":[1,"app-id"],"detectionBoxes":[32],"sideAlignment":[32],"isMaskReady":[32],"shouldMirrorVideo":[32],"showCameraSelector":[32],"isSwitchingCamera":[32],"hasDocumentDetected":[32],"cameraInfoWithAutofocus":[32],"currentStatus":[32],"performanceData":[32],"backDocumentTimerRemaining":[32],"showManualCaptureButton":[32],"performanceDegradedMode":[32],"showPerformanceMessage":[32],"captureStateVersion":[32],"processingButton":[32],"licenseValid":[32],"licenseError":[32],"classificationDisabled":[32],"getCapturedImages":[64],"isProcessCompleted":[64],"startCapture":[64],"stopCapture":[64],"resetCapture":[64],"skipBackCapture":[64],"getStatus":[64],"preloadModel":[64],"getCameraInfo":[64],"setPreferredCamera":[64],"setCaptureDelay":[64],"getCaptureDelay":[64]},null,{"license":["onLicenseChanged"],"licenseEnvironment":["onLicenseEnvironmentChanged"]}]]]], options);
 };
 
 exports.setNonce = index.setNonce;

package/dist/collection/collection-manifest.json

@@ -1,6 +1,6 @@
 {
   "entries": [
-    "components/my-component/my-component.js"
+    "components/jaak-stamps/jaak-stamps.js"
   ],
   "compiler": {
     "name": "@stencil/core",

package/dist/collection/components/{my-component/my-component.js → jaak-stamps/jaak-stamps.js}

@@ -24,7 +24,7 @@ export class JaakStamps {
     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
+    licenseEnvironment = 'prod';
     traceId; // Optional trace ID for tracking
     appId = 'jaak-stamps-web'; // Application ID for license validation
     captureCompleted;
@@ -72,6 +72,10 @@ export class JaakStamps {
     licenseValid = true; // License validation status
     licenseError = null; // License validation error message
     classificationDisabled = false; // Classification disabled at runtime due to errors
+    _initialized = false;
+    _initializing = false;
+    _pendingEnvironmentRetry = false;
+    _pendingInit = null;
     // Services
     licenseValidationService = null;
     serviceContainer;
@@ -140,46 +144,124 @@ export class JaakStamps {
     // Canvas pool for optimized screenshot capture
     canvasPool = [];
     MAX_CANVAS_POOL_SIZE = 3;
+    // Readiness gate for startCapture(). The host may call startCapture() before the
+    // component finishes loading its resources (ONNX Runtime + WASM/models from the CDN).
+    // On slow devices/networks this race made startCapture() abort with "El componente
+    // está cargando recursos", leaving the screen black (TO-807). Instead of aborting we
+    // wait for initialization to settle and retry. `initializationSettled` flips once
+    // finalizeInitialization() has run; pending waiters are released via these callbacks.
+    initializationSettled = false;
+    initializationWaiters = [];
+    // Max time startCapture() waits for a still-initializing component before giving up.
+    // Sized for slow Android/network asset downloads; if resources never load (CDN down,
+    // 404, CORS) the timeout fires and startCapture() returns the original error.
+    START_CAPTURE_READY_TIMEOUT_MS = 15000;
     async componentWillLoad() {
+        // @Watch handlers fire synchronously when Angular sets properties, which happens
+        // BEFORE componentWillLoad (Stencil schedules componentWillLoad as a microtask after
+        // connectedCallback, while Angular sets props synchronously in that same call stack).
+        // @Watch('license') defers init to a macrotask so @Watch('licenseEnvironment') fires
+        // first. By the time we resume here, init may already be in progress.
+        await new Promise(resolve => setTimeout(resolve, 50));
         if (this.debug) {
-            console.log('[JAAK-DEBUG] componentWillLoad() - Props at initialization:');
+            console.log('[JAAK-DEBUG] componentWillLoad() - Props after yield:');
+            console.log('[JAAK-DEBUG]   license:', this.license ? this.license.substring(0, 8) + '...' : 'EMPTY');
+            console.log('[JAAK-DEBUG]   licenseEnvironment:', this.licenseEnvironment);
+            console.log('[JAAK-DEBUG]   _initializing:', this._initializing);
+            console.log('[JAAK-DEBUG]   _initialized:', this._initialized);
             console.log('[JAAK-DEBUG]   useDocumentDetector:', this.useDocumentDetector, '(type:', typeof this.useDocumentDetector, ')');
             console.log('[JAAK-DEBUG]   useDocumentClassification:', this.useDocumentClassification);
             console.log('[JAAK-DEBUG]   debug:', this.debug);
-            console.log('[JAAK-DEBUG]   license:', this.license ? this.license.substring(0, 8) + '...' : 'EMPTY');
-            console.log('[JAAK-DEBUG]   licenseEnvironment:', this.licenseEnvironment);
             console.log('[JAAK-DEBUG]   alignmentTolerance:', this.alignmentTolerance);
             console.log('[JAAK-DEBUG]   maskSize:', this.maskSize);
             console.log('[JAAK-DEBUG]   captureDelay:', this.captureDelay);
             console.log('[JAAK-DEBUG]   preferredCamera:', this.preferredCamera);
             console.log('[JAAK-DEBUG]   appId:', this.appId);
         }
-        // License is required - always validate
-        // Wait a bit to ensure props are set from attributes
-        await new Promise(resolve => setTimeout(resolve, 50));
-        if (this.debug) {
-            console.log('[JAAK-DEBUG] Props AFTER 50ms wait:');
-            console.log('[JAAK-DEBUG]   useDocumentDetector:', this.useDocumentDetector, '(type:', typeof this.useDocumentDetector, ')');
-        }
-        this.updateStatus('Validando licencia...', 'Verificando autorización de uso', 'initializing');
-        await this.validateLicense();
-        // If license validation failed, stop initialization
-        if (!this.licenseValid) {
-            if (this.debug) {
-                console.error('[JAAK-DEBUG] License validation FAILED. Stopping initialization.');
+        if (!this.license) {
+            if (!this._initialized && !this._initializing) {
+                // No license and init not started — show blocking error UI
+                this.licenseValid = false;
+                this.licenseError = 'Se requiere una licencia para continuar. Por favor, proporcione una licencia usando el atributo "license".';
+                this.updateStatus('Licencia requerida', 'Proporcione una licencia para continuar', 'error');
             }
-            return;
         }
-        if (this.debug) {
-            console.log('[JAAK-DEBUG] License validation OK');
+        else if (!this._initialized && !this._initializing) {
+            // License present but init hasn't started yet (no @Watch fired) — set initial status
+            // so the first render already shows it without a redundant state change in componentDidLoad
+            this.updateStatus('Validando licencia...', 'Verificando autorización de uso', 'initializing');
         }
+        // Heavy initialization is deferred to componentDidLoad so the first render is not blocked
     }
     async componentDidLoad() {
+        // If @Watch('license') already scheduled or started init, let it proceed
+        if (!this.license || this._initialized || this._initializing || this._pendingInit !== null) {
+            return;
+        }
+        await this.validateAndInitialize();
+    }
+    onLicenseChanged(newLicense) {
+        if (!newLicense || this._initialized || this._initializing) {
+            return;
+        }
+        // Defer init by one macrotask (setTimeout 0) so @Watch('licenseEnvironment') fires
+        // first. Angular applies [license] before [licenseEnvironment] in template order,
+        // meaning a synchronous start here would use the Stencil default "prod" for the env.
+        if (this._pendingInit !== null)
+            clearTimeout(this._pendingInit);
+        this._pendingInit = setTimeout(async () => {
+            this._pendingInit = null;
+            if (!this._initialized && !this._initializing && this.license) {
+                this.updateStatus('Validando licencia...', 'Verificando autorización de uso', 'initializing');
+                await this.validateAndInitialize();
+            }
+        }, 0);
+    }
+    async onLicenseEnvironmentChanged() {
+        // Always recreate the service so the correct environment URL is ready.
+        this.licenseValidationService = new LicenseValidationService(this.licenseEnvironment);
+        if (this._initializing) {
+            // Validation is already in-flight with the wrong environment.
+            // Flag a retry so validateAndInitialize restarts once the current attempt ends.
+            this._pendingEnvironmentRetry = true;
+            return;
+        }
+        // If @Watch('license') already scheduled a deferred init, that init will read
+        // this.licenseEnvironment at fire time (after this handler returns), so the
+        // correct URL will be used — no need to trigger a second init here.
+        if (this._pendingInit !== null) {
+            return;
+        }
+        if (this._initialized) {
+            // Component was fully initialized with the wrong env URL (e.g. Ionic animation
+            // delayed Angular's CD past the initial validateAndInitialize() cycle).
+            // Re-validate the license only — services and camera are already running.
+            await this.validateLicense();
+            return;
+        }
+        if (this.license) {
+            this.updateStatus('Validando licencia...', 'Verificando autorización de uso', 'initializing');
+            await this.validateAndInitialize();
+        }
+    }
+    async validateAndInitialize() {
+        if (this._initialized || this._initializing) {
+            return;
+        }
+        this._initializing = true;
         try {
-            // If license validation failed, stop initialization
+            // Status was already set synchronously by the caller (componentWillLoad or @Watch)
+            // to avoid a state change inside componentDidLoad that Stencil warns about.
+            await this.validateLicense();
             if (!this.licenseValid) {
+                if (this.debug) {
+                    console.error('[JAAK-DEBUG] License validation FAILED. Stopping initialization.');
+                }
                 return;
             }
+            if (this.debug) {
+                console.log('[JAAK-DEBUG] License validation OK');
+            }
             this.updateStatus('Preparando capturador...', 'Configurando herramientas de captura', 'initializing');
             await this.initializeServices();
             this.updateStatus('Preparando funciones...', 'Configurando herramientas de trabajo', 'initializing');
@@ -189,9 +271,37 @@ export class JaakStamps {
             if (this.debug) {
                 this.initializePerformanceMonitor();
             }
+            this._initialized = true;
         }
         catch (error) {
-            this.updateStatus('Error de inicialización', error.message, 'error');
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            this.updateStatus('Error de inicialización', errorMessage, 'error');
+        }
+        finally {
+            this._initializing = false;
+            if (this._pendingEnvironmentRetry && this.license) {
+                this._pendingEnvironmentRetry = false;
+                if (this._initialized) {
+                    // Already fully initialized with wrong env URL — re-validate only the license.
+                    // Services and camera are already running and don't depend on the env URL.
+                    await this.validateLicense();
+                }
+                else {
+                    // Not yet initialized — full retry with the correct environment.
+                    this.updateStatus('Validando licencia...', 'Verificando autorización de uso', 'initializing');
+                    await this.validateAndInitialize();
+                }
+            }
+            else {
+                this._pendingEnvironmentRetry = false;
+            }
+            // Release any startCapture() calls waiting on readiness. On success this is a
+            // no-op (finalizeInitialization already settled); on a terminal failure (invalid
+            // license / init error) it lets startCapture() return its error without waiting
+            // out the full timeout. Idempotent, so a completed retry above stays settled.
+            if (!this._initializing) {
+                this.settleInitialization();
+            }
         }
     }
     async initializeServices() {
@@ -241,14 +351,14 @@ export class JaakStamps {
     }
     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...');
+            if (this.debug)
+                console.log('[jaak-stamps] validating license...');
             // Initialize license validation service
             this.licenseValidationService = new LicenseValidationService(this.licenseEnvironment);
             // Validate the license, passing traceId and appId if provided
@@ -256,18 +366,21 @@ export class JaakStamps {
             if (response && response.access_token) {
                 this.licenseValid = true;
                 this.licenseError = null;
-                console.log('✅ License validated successfully for JAAK Stamps');
+                if (this.debug)
+                    console.log('[jaak-stamps] license validated successfully');
                 // Emit the traceId (either provided or generated)
                 if (response.traceId) {
                     this.traceIdGenerated.emit({ traceId: response.traceId });
-                    console.log('📋 TraceId:', response.traceId);
+                    if (this.debug)
+                        console.log('[jaak-stamps] 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');
+                if (this.debug)
+                    console.error('[jaak-stamps] invalid license');
             }
         }
         catch (error) {
@@ -275,7 +388,8 @@ export class JaakStamps {
             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);
+            if (this.debug)
+                console.error('[jaak-stamps] license validation failed:', error);
         }
     }
     async setupEventListeners() {
@@ -378,6 +492,42 @@ export class JaakStamps {
             };
         }
         this.emitReadyEvent();
+        this.settleInitialization();
+    }
+    // Releases any startCapture() calls that arrived while the component was still
+    // initializing. Idempotent: safe to call more than once.
+    settleInitialization() {
+        if (this.initializationSettled) {
+            return;
+        }
+        this.initializationSettled = true;
+        const waiters = this.initializationWaiters;
+        this.initializationWaiters = [];
+        waiters.forEach(resolve => resolve());
+    }
+    // Waits until initialization settles (finalizeInitialization ran) or the timeout
+    // elapses, whichever comes first. Resolves regardless of outcome; the caller
+    // re-checks isComponentReady() afterwards to decide success/failure.
+    waitForInitialization(timeoutMs) {
+        if (this.initializationSettled) {
+            return Promise.resolve();
+        }
+        return new Promise(resolve => {
+            let settled = false;
+            const done = () => {
+                if (settled) {
+                    return;
+                }
+                settled = true;
+                clearTimeout(timer);
+                resolve();
+            };
+            const timer = setTimeout(() => {
+                this.initializationWaiters = this.initializationWaiters.filter(w => w !== done);
+                done();
+            }, timeoutMs);
+            this.initializationWaiters.push(done);
+        });
     }
     updateStatus(message, description, type = 'loading') {
         this.currentStatus = {
@@ -569,7 +719,20 @@ export class JaakStamps {
     }
     async startCapture() {
         const span = this.tracingService?.startSpan('capture.start');
-        const readyCheck = this.isComponentReady();
+        let readyCheck = this.isComponentReady();
+        // TO-807: absorb the start-before-ready race instead of aborting. When the
+        // component is still loading its resources (transient initializing/loading
+        // state) we wait for initialization to settle and re-check, rather than
+        // returning an error immediately (which left the host with a black screen).
+        // A terminal state ('error' / missing services) is not waited on.
+        if (!readyCheck.ready && (readyCheck.status === 'initializing' || readyCheck.status === 'loading')) {
+            this.updateStatus('El componente está cargando recursos', 'Espere a que termine la inicialización', 'loading');
+            if (span) {
+                this.tracingService?.setSpanAttribute(span, 'startCapture.waitedForReady', true);
+            }
+            await this.waitForInitialization(this.START_CAPTURE_READY_TIMEOUT_MS);
+            readyCheck = this.isComponentReady();
+        }
         if (!readyCheck.ready) {
             this.updateStatus(readyCheck.message, 'Espere a que termine la inicialización', readyCheck.status);
             if (span) {
@@ -1562,7 +1725,7 @@ export class JaakStamps {
             isCapturing: false
         };
         const cameraInfo = this.cameraInfoWithAutofocus;
-        return (h("div", { key: 'a4f5254bb0f5198cfea553fb46d8841c4a410853', class: "detector-container" }, !this.licenseValid && this.licenseError && (h("div", { key: '48353567b7c23df1b44e035cd6b52dd692b338a6', class: "license-error-container" }, h("div", { key: '8a520b2cb936cae9ed64c513ae9e583f62d31b99', class: "license-error-card" }, h("svg", { key: 'dccdda293c28bd5d1e76bbff0060859a394a800c', 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: '09015453d8230c523abe8e5b4b800b4a55a81202', 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: '5f9fd50412d21de2274e124c02dcc8e971fd23ee', d: "M12 8V12", stroke: "currentColor", "stroke-width": "2", "stroke-linecap": "round" }), h("circle", { key: 'e534af1f29c6382c2c47623129a94d3aac3ec71e', cx: "12", cy: "16", r: "0.5", fill: "currentColor", stroke: "currentColor", "stroke-width": "1" })), h("h2", { key: '6ed105bb6e16d8ce7419bc64a0f69e7e2d7ed0ac', class: "license-error-title" }, "Licencia Requerida"), h("p", { key: 'c1d7e06b03a4af316e28836eb7a0f3729993ca1f', class: "license-error-message" }, this.licenseError), h("p", { key: '349ae281248b56524460cb18f36300e69c11ab5e', class: "license-error-help" }, "Contacte a soporte: ", h("a", { key: '62546d77296d220338953c3bd1820946164ff96c', href: "mailto:support@jaak.ai" }, "support@jaak.ai")), h("div", { key: 'b45ac9c2d9b9d65e4156d07a067e6c9214da8113', class: "license-error-footer" }, "JAAK Stamps")))), this.licenseValid && (h("div", { key: '77c274b14b69fe4220f71ef789de8c4943833fee', class: "video-container" }, h("video", { key: 'e036a408939aa5875e36a1f038bed98bfbfba134', ref: el => this.videoRef = el, autoplay: true, muted: true, playsinline: true, class: this.shouldMirrorVideo ? 'mirror' : '', style: {
+        return (h("div", { key: 'ed400c7cc247fb12e5915e270207d3fa916362fd', class: "detector-container" }, !this.licenseValid && this.licenseError && (h("div", { key: 'd2f7507026d01d2fd381d365c9954067eb37c3f4', class: "license-error-container" }, h("div", { key: 'fc4ae7ae434a038a3730057a99a7d96d851dba43', class: "license-error-card" }, h("svg", { key: '7361da72e3fda0147044873bc770460098a4b4f1', 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: '57a3dce14d47d4b91af6ff84ab39cde58814f573', 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: '8c96a1638602eface0ae8c7377cdda04dffde5c7', d: "M12 8V12", stroke: "currentColor", "stroke-width": "2", "stroke-linecap": "round" }), h("circle", { key: '7455af58b1827570713d778a4ef01bb0ffcfb553', cx: "12", cy: "16", r: "0.5", fill: "currentColor", stroke: "currentColor", "stroke-width": "1" })), h("h2", { key: '5779f8a2c4468ea185df620edecb3f79b7ae8bfb', class: "license-error-title" }, "Licencia Requerida"), h("p", { key: '8180147597c077798ff4ea4eb9309a3bec69c77f', class: "license-error-message" }, this.licenseError), h("p", { key: '2103af42045a8ee8385de273da8f98e23395469b', class: "license-error-help" }, "Contacte a soporte: ", h("a", { key: '8a7fe987b24600b123216c952c5b69f2c2afc0a0', href: "mailto:support@jaak.ai" }, "support@jaak.ai")), h("div", { key: 'fd00ef42e259669b7b7cc512478c9c925bd03415', class: "license-error-footer" }, "JAAK Stamps")))), this.licenseValid && (h("div", { key: '44a92ba0a4cc066bb4497f4f548fce0bd5dbc121', class: "video-container" }, h("video", { key: '9ef40fb28c0fea1b59657ae50134b4dc3df4cf24', ref: el => this.videoRef = el, autoplay: true, muted: true, playsinline: true, class: this.shouldMirrorVideo ? 'mirror' : '', style: {
                 // Keep the element rendered (display: block) so the browser
                 // loads stream metadata and fires 'loadedmetadata'. Hiding it
                 // with display:none prevents metadata loading in Chrome and
@@ -1571,7 +1734,7 @@ export class JaakStamps {
                 // render context alive.
                 opacity: captureState.isVideoActive ? '1' : '0',
                 visibility: captureState.isVideoActive ? 'visible' : 'hidden',
-            } }), h("div", { key: '9389f1495814409aa849ce409a28cb578761df76', 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: {
+            } }), h("div", { key: 'f3d6e544bb8b13214894f71216badf092d2516dd', 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`,
@@ -1580,9 +1743,9 @@ export class JaakStamps {
                 border: '2px solid #32406C',
                 pointerEvents: 'none',
                 boxSizing: 'border-box'
-            } })))), this.isMaskReady && (h("div", { key: '8050beb9a72279f3a2d54884fe598eca8b1929af', class: "overlay-mask" }, h("div", { key: '25028f1c5bab6b457563c098899c7645083be3a0', class: "card-outline" }, h("div", { key: 'd125b627160c671f1be837d1f957704d016dcf47', class: "side side-top" }), h("div", { key: '78ed55f578fcadba60e80c50315f4a82bbe9c15c', class: "side side-right" }), h("div", { key: '263d29d0844bfa88d68698d71630fd9b08debc26', class: "side side-bottom" }), h("div", { key: '18e528b4d877699add45d9b4e1e029a2bb993582', class: "side side-left" })), !captureState.showFlipAnimation && !captureState.showSuccessAnimation && (h("div", { key: '7e09980601c146cd48f80a04640a8a7d635e14d4', class: `guide-text ${this.showPerformanceMessage ? 'performance-warning-text' : ''}` }, this.getGuideText(captureState.step))), captureState.step === 'back' && !captureState.showFlipAnimation && !captureState.showSuccessAnimation && (h("div", { key: '102e95d211e79d5c5d8e13ae717cb8913eae7ea1', class: "back-capture-section" }, h("div", { key: 'cde593bf62825392df6e950585e9950351bac430', class: "back-capture-buttons" }, (!this.useDocumentDetector || this.performanceDegradedMode || this.showManualCaptureButton) && (h("button", { key: '823b35d70e2bb1cf242e01578e921c8a091c7639', class: "capture-button primary-button", onClick: () => this.takeManualScreenshot(), type: "button", disabled: this.processingButton !== null }, this.processingButton === 'capture-back' && (h("span", { key: 'b6f6e82f515cd588eeca60e7abe220d89b40cfe8', class: "button-spinner" })), "Capturar Reverso")), h("button", { key: '7d91e6b780958a36df9a859fb02d8224b0de46dc', class: "skip-button", onClick: () => this.skipBackCapture(), type: "button", disabled: this.processingButton !== null }, this.processingButton === 'skip-back' && (h("span", { key: '0d5bce58452c7f7b5e197dfa0eff959971357b3c', class: "button-spinner" })), this.enableBackDocumentTimer && this.backDocumentTimerRemaining > 0
+            } })))), this.isMaskReady && (h("div", { key: '312b9d7733e550a444e84d699c0e14834fc41057', class: "overlay-mask" }, h("div", { key: '2af1c83efb4d360ecada3301f4479bbf8845f032', class: "card-outline" }, h("div", { key: 'b6f57f153953e059056fae6d9f8a8220bfff4357', class: "side side-top" }), h("div", { key: 'e465f72b8834a04174dc88897b813517afa372fb', class: "side side-right" }), h("div", { key: '32e2785c7570f2002b6bc68b491007925d9fcad5', class: "side side-bottom" }), h("div", { key: 'bf2133811df7f516d9e3b37ae6019c90c0a68d0b', class: "side side-left" })), !captureState.showFlipAnimation && !captureState.showSuccessAnimation && (h("div", { key: 'de00829ac42fe7f3645cb515fb46cfabe415190b', class: `guide-text ${this.showPerformanceMessage ? 'performance-warning-text' : ''}` }, this.getGuideText(captureState.step))), captureState.step === 'back' && !captureState.showFlipAnimation && !captureState.showSuccessAnimation && (h("div", { key: 'ae09d9c23635d87d31110781dc0ab3acb8ec4667', class: "back-capture-section" }, h("div", { key: 'a30a50ee0272140d16e32f582dd93f8de87d2a44', class: "back-capture-buttons" }, (!this.useDocumentDetector || this.performanceDegradedMode || this.showManualCaptureButton) && (h("button", { key: 'fb104cf6feaeca2f9542a2d5933bbf4f15c6771f', class: "capture-button primary-button", onClick: () => this.takeManualScreenshot(), type: "button", disabled: this.processingButton !== null }, this.processingButton === 'capture-back' && (h("span", { key: '7a1bff56bae244c5b8d1d4c3fd523e7a20b4b5ce', class: "button-spinner" })), "Capturar Reverso")), h("button", { key: '59125b29ad55122e5ee9e8c2aaf9689a1fef588e', class: "skip-button", onClick: () => this.skipBackCapture(), type: "button", disabled: this.processingButton !== null }, this.processingButton === 'skip-back' && (h("span", { key: '4d0b8184b4eb82824d5d864fb1b196f22302506d', class: "button-spinner" })), this.enableBackDocumentTimer && this.backDocumentTimerRemaining > 0
             ? `Saltar reverso (${this.backDocumentTimerRemaining}s)`
-            : 'Saltar reverso')))), captureState.isVideoActive && (h("div", { key: 'e8fc7f2bb1a0ca8235a82ed368717205c7b63ad8', class: "camera-controls" }, h("button", { key: '691e4a97f2804666db5e32236619196d616227f7', 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: '80233723131262f516574a4dd2bb125970f7aeea', class: "camera-selector-dropdown" }, h("div", { key: 'c9284a77cd9f2d3e600924c9e5f38614f3d06dc4', class: "camera-selector-header" }, h("span", { key: '92a495d2b605a73a067791442a8c8617706d96bf' }, "Seleccionar C\u00E1mara"), h("button", { key: 'dc06382c154443ea9928740d53546dc2ab3ce662', class: "close-selector", onClick: () => this.toggleCameraSelector(), type: "button" }, "\u00D7")), h("div", { key: 'b520d0940ef51dc1a46641adaf834e105a16c964', 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: '7df8908982af0142d5c02d9b09827f44e697cbb5', class: "device-info" }, h("small", { key: '5669aa375b7aa6cd98d36e5a77eb217e549a5d4d' }, "Dispositivo: ", cameraInfo.deviceType)))), this.showManualCaptureButton && captureState.step === 'front' && !captureState.showFlipAnimation && !captureState.showSuccessAnimation && (h("div", { key: '40ed9bde6c2a0afadd8b949ce0cba59344b09379', class: "manual-capture-section" }, h("button", { key: 'f394d0a578888782a0a569e721f06bb642ebfbd4', class: "manual-capture-button", onClick: () => this.takeManualScreenshot(), type: "button", disabled: this.processingButton !== null }, this.processingButton === 'capture-front' && (h("span", { key: 'ec5ee370a578705ccc3a562763c906701a1e4da4', class: "button-spinner" })), "Capturar Frente"))))), captureState.isCapturing && (h("div", { key: '60520ec5cdd2632ac9cd645a5d8d820298b7388b', class: "capture-animation" })), captureState.showFlipAnimation && (h("div", { key: 'af3647bc1dd4e58630bf06bae37d7e5cd522c900', class: "flip-animation" }, h("div", { key: 'e974ee4fc12ebdef1cdcef288951abb0b98b368a', class: "id-card-icon" }), h("div", { key: 'd80764bf0e01069d4fa1367b250215024c8e41ee', class: "flip-text" }, "\u00A1Voltea tu identificaci\u00F3n!"))), captureState.showSuccessAnimation && (h("div", { key: '07956e4e03dee2ebe64d5eeb1d0c6559dbd8c944', class: "success-animation" }, h("div", { key: 'd8cb39f4f7ad3adc9c16b2226b75d14b788636f6', class: "check-icon" }), h("div", { key: '9e3ddbac4946cd585de7c406d55915f532a390ed', class: "success-text" }, "\u00A1Proceso completado!"))), h("div", { key: 'b1ba412c9c4664eda9c024c3fa22e53f11acae4f', class: `component-status status-${this.currentStatus.type}` }, (this.currentStatus.type === 'loading' || this.currentStatus.type === 'initializing') && (h("div", { key: 'b466904829c87bcb050500c9f24f507a6d42d56d', class: "status-spinner" })), h("div", { key: '3dcfe509f83adf031fadd2fa322a110456e5993b', class: "status-content" }, h("div", { key: '3a6c820251b30c0cbd63538b23872ac1191b5213', class: "status-message" }, this.currentStatus.message), this.currentStatus.description && (h("div", { key: 'a7c35a8a773d852035a35e77fb99cf475307a5f7', class: "status-description" }, this.currentStatus.description)))), this.debug && (h("div", { key: 'd581099e2e1aedc1aea88a4c26af59a118042070', class: "performance-monitor" }, h("div", { key: '18bf5ba4feb6515a454d0769fe8eb02fd37ef167', class: "performance-expanded" }, h("div", { key: '7765f916c26556046b8326befc796f9188aeca3f', class: "metrics-row" }, h("div", { key: '9533109a7a762a7d8a95f12f45dddb6833fa7326', class: "metric-compact" }, h("span", { key: 'c236d06e692694a58519e86f133f39a5184a485f', class: "metric-label" }, "FPS"), h("span", { key: '4a7b53c89c4822dc03c6683f6d6895f96458b95d', class: `metric-value ${this.performanceData.fps < 15 ? 'warning' : this.performanceData.fps < 10 ? 'danger' : 'good'}` }, this.performanceData.fps)), h("div", { key: 'd362ceb5edf7585fc7c05da7367a6affee83b942', class: "metric-compact" }, h("span", { key: '08779e8da11b1593f7d91b409b36184ed405dee6', class: "metric-label" }, "MEM"), h("span", { key: '64c15bcbaeca6760e578e4ff9386583938c0be87', class: `metric-value ${this.performanceData.memoryUsage > 100 ? 'warning' : this.performanceData.memoryUsage > 200 ? 'danger' : 'good'}` }, this.performanceData.memoryUsage, "MB"))), h("div", { key: '1ef4f7a5aaae9ed9131bd45c7a4c227ad6419d93', class: "metrics-row" }, h("div", { key: 'c5d5ab2a81f7c8f5145253ece37e43981c68ccb8', class: "metric-compact" }, h("span", { key: '7ba45cae45b336c52adf1eb4588851be20475f4e', class: "metric-label" }, "INF"), h("span", { key: '1341edaafa1de81b304605378a8b1262f2f8a084', class: `metric-value ${this.performanceData.inferenceTime > 100 ? 'warning' : this.performanceData.inferenceTime > 200 ? 'danger' : 'good'}` }, this.performanceData.inferenceTime, "ms")), h("div", { key: '4c6edc10f88b776825a5a07643864fef4295c295', class: "metric-compact" }, h("span", { key: '7d58a7250a133b84f001a5313dce606fcd9eda82', class: "metric-label" }, "FRAME"), h("span", { key: 'de6a8e8475cd893546b939d5e3a7045a9d7df6dc', class: `metric-value ${this.performanceData.frameProcessingTime > 50 ? 'warning' : this.performanceData.frameProcessingTime > 100 ? 'danger' : 'good'}` }, this.performanceData.frameProcessingTime, "ms"))), h("div", { key: 'a26794337b9fd17fc9bc6718461c5251b57c1949', class: "metrics-row" }, h("div", { key: 'd790ac359b04532a5e7aa44e2a2952522c1ceb64', class: "metric-compact" }, h("span", { key: '581c72f166de867bbbfe3bb654cdf89e94cfc27b', class: "metric-label" }, "DET"), h("span", { key: '8d478a6d5e84151504e2dd136e2b1ff1e26e0853', class: "metric-value good" }, this.performanceData.successfulDetections, "/", this.performanceData.totalDetections)), h("div", { key: 'bb7f6dad291a79b5f683e51e07558ca73c22ad98', class: "metric-compact" }, h("span", { key: '1d2626fb63026ce3eb9d0696501b08c0ddf4be09', class: "metric-label" }, "RATE"), h("span", { key: '8f8a67276ad40ce3fe9acab86c2a807f426d2a23', class: `metric-value ${this.performanceData.detectionRate < 30 ? 'danger' : this.performanceData.detectionRate < 60 ? 'warning' : 'good'}` }, this.performanceData.detectionRate, "%")))))), h("div", { key: 'a9ae57be92d04f8d5d7eae801c0a0ae7c548f770', class: "watermark" }, h("img", { key: 'c9cd4510dfff2265e3ae5d213845e7b5d8f9a343', src: "https://static.jaak.ai/commons/powered-by-jaak.png", alt: "Powered by Jaak", onError: (e) => {
+            : 'Saltar reverso')))), captureState.isVideoActive && (h("div", { key: '1febf678f87e32916d3990677b41345ce034db4e', class: "camera-controls" }, h("button", { key: '79f00bac9d56347de1fc08b2e06be1c0e996a855', 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: '4f6d101ce789b7fff227a6a2ce2479cb6255fd58', class: "camera-selector-dropdown" }, h("div", { key: 'f82222bb25162d2717d84c098c2a6540caa821f3', class: "camera-selector-header" }, h("span", { key: '0b1648857467c5749fe5d1d846d1786fa2e394c3' }, "Seleccionar C\u00E1mara"), h("button", { key: 'f406f08ad9dc2dcaced7e95aed013665c5fcfb4e', class: "close-selector", onClick: () => this.toggleCameraSelector(), type: "button" }, "\u00D7")), h("div", { key: 'a051beeab1c8447730d41e963cd3b95027922cab', 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: 'c9c0702a57c105b02062f325cd413b531c7f802c', class: "device-info" }, h("small", { key: '584f4c1ce525b8ab03107329c92797737d5afad5' }, "Dispositivo: ", cameraInfo.deviceType)))), this.showManualCaptureButton && captureState.step === 'front' && !captureState.showFlipAnimation && !captureState.showSuccessAnimation && (h("div", { key: 'e3e2a270d3c4e7accdd9bc8b37861af4fceaad5d', class: "manual-capture-section" }, h("button", { key: '1283629ce59fc82d7b3fc08d5573bc69238f7aab', class: "manual-capture-button", onClick: () => this.takeManualScreenshot(), type: "button", disabled: this.processingButton !== null }, this.processingButton === 'capture-front' && (h("span", { key: '5de009e4d2ff0de43355e95e1d69f12d7f2e65f8', class: "button-spinner" })), "Capturar Frente"))))), captureState.isCapturing && (h("div", { key: '975142144bb104d3ed532ac80fca19a7f237bb2b', class: "capture-animation" })), captureState.showFlipAnimation && (h("div", { key: '5d54b9130ed4d1e13b95cfeee8f9d694b5de68d3', class: "flip-animation" }, h("div", { key: 'c8b955180065d2b99f8e5f405b1ff92bc050af77', class: "id-card-icon" }), h("div", { key: 'f103b1871266886455d5bba094a0e119aa484595', class: "flip-text" }, "\u00A1Voltea tu identificaci\u00F3n!"))), captureState.showSuccessAnimation && (h("div", { key: '5845c045d37099cf906f7c56d3c91568dd198bdf', class: "success-animation" }, h("div", { key: '430496db95f10834a43842e9ac97bdf0f025eb3b', class: "check-icon" }), h("div", { key: '0815cf6feffe8bd4ba84712c14d8f29c1a945577', class: "success-text" }, "\u00A1Proceso completado!"))), h("div", { key: 'f8a8a529850fc93e93f12810b7928e4700bac880', class: `component-status status-${this.currentStatus.type}` }, (this.currentStatus.type === 'loading' || this.currentStatus.type === 'initializing') && (h("div", { key: '929ab612be046e97bb02ebe366b531864b90cc7a', class: "status-spinner" })), h("div", { key: 'defaf70aa54f2ccc222ddbe392cc47f7c143fc06', class: "status-content" }, h("div", { key: '685cca31f70e26d062f2d01b9ffd8c5a4a6b6f86', class: "status-message" }, this.currentStatus.message), this.currentStatus.description && (h("div", { key: '21bce9f6de9e5a50763ef83a25787225319dc5bf', class: "status-description" }, this.currentStatus.description)))), this.debug && (h("div", { key: '6e43560821e469e397b78ab44d1679a3ff8e330f', class: "performance-monitor" }, h("div", { key: 'afcde6083be4a1b4a76d5523e0a239926b76ff9a', class: "performance-expanded" }, h("div", { key: '0706e93c06bcaf2e573c0c2ac414c3ca7d3605ba', class: "metrics-row" }, h("div", { key: '32b755f0f81ae758d9ab0b2e75dd9d55ef52eef0', class: "metric-compact" }, h("span", { key: 'b1d8e773fdd1e333cd55bb5bbed2878a7e106474', class: "metric-label" }, "FPS"), h("span", { key: 'a6c53d389e7424f6696b6279bef267b28e112201', class: `metric-value ${this.performanceData.fps < 15 ? 'warning' : this.performanceData.fps < 10 ? 'danger' : 'good'}` }, this.performanceData.fps)), h("div", { key: 'a8c4157b696ae53e8ae5cee14f9e8b37be34a0a6', class: "metric-compact" }, h("span", { key: '0fa82dd84f6e0a9c16c1894021932e8ba355991a', class: "metric-label" }, "MEM"), h("span", { key: 'fc7f19be4e3fbbc82da538703ef9049e26571496', class: `metric-value ${this.performanceData.memoryUsage > 100 ? 'warning' : this.performanceData.memoryUsage > 200 ? 'danger' : 'good'}` }, this.performanceData.memoryUsage, "MB"))), h("div", { key: '84bd7b6da8e91004ef6c554264b97b89fa6123e1', class: "metrics-row" }, h("div", { key: 'a2bc7af57fe87f5ef53ee00f76aa27675736c404', class: "metric-compact" }, h("span", { key: '59e9114f50cf4d69bfc447162001e8ab3214906a', class: "metric-label" }, "INF"), h("span", { key: 'c92e1f7e92127d85e0cdd647af44f1da4c46da57', class: `metric-value ${this.performanceData.inferenceTime > 100 ? 'warning' : this.performanceData.inferenceTime > 200 ? 'danger' : 'good'}` }, this.performanceData.inferenceTime, "ms")), h("div", { key: '5751e9dee9d55ddc559d1c60e68c4be7da2eb7a2', class: "metric-compact" }, h("span", { key: 'a34e394ab188e74a39eb77af4cf0108c8a2be1c3', class: "metric-label" }, "FRAME"), h("span", { key: '19165e851fc7f348e6cee93deccff0159c3bb982', class: `metric-value ${this.performanceData.frameProcessingTime > 50 ? 'warning' : this.performanceData.frameProcessingTime > 100 ? 'danger' : 'good'}` }, this.performanceData.frameProcessingTime, "ms"))), h("div", { key: 'dde9e547b8c9e200624e525d15baaa4a18a27417', class: "metrics-row" }, h("div", { key: '770301e51025a446e29638d38e8e8a8dfb911882', class: "metric-compact" }, h("span", { key: '96750b7a455ef1f3353b870467afdff402fa605b', class: "metric-label" }, "DET"), h("span", { key: 'a7951b69998e1d13beee40b6677d55091a413a4c', class: "metric-value good" }, this.performanceData.successfulDetections, "/", this.performanceData.totalDetections)), h("div", { key: 'a82589fbccc749ef904a68933c6b850c3b69018c', class: "metric-compact" }, h("span", { key: 'ced7d42d2ebf2c4f20671c696b845263f4de4f4a', class: "metric-label" }, "RATE"), h("span", { key: '693c9735796ec276ca1d7e559aea250dafb0e5cf', class: `metric-value ${this.performanceData.detectionRate < 30 ? 'danger' : this.performanceData.detectionRate < 60 ? 'warning' : 'good'}` }, this.performanceData.detectionRate, "%")))))), h("div", { key: '3ff1698eae36352f9268839b86cef29144de297c', class: "watermark" }, h("img", { key: 'efa9735216e7caafdb67e10a5fc9363b503307b5', src: "https://static.jaak.ai/commons/powered-by-jaak.png", alt: "Powered by Jaak", onError: (e) => {
                 const img = e.target;
                 img.onerror = null;
                 img.src = POWERED_BY_JAAK_FALLBACK;
@@ -2130,7 +2293,7 @@ export class JaakStamps {
                 await this.tracingService.flush();
             }
             catch (error) {
-                console.error('[my-component] Failed to flush traces:', error);
+                console.error('[jaak-stamps] Failed to flush traces:', error);
             }
         }
         this.captureCompleted.emit(finalImages);
@@ -2406,12 +2569,12 @@ export class JaakStamps {
     static get encapsulation() { return "shadow"; }
     static get originalStyleUrls() {
         return {
-            "$": ["my-component.css"]
+            "$": ["jaak-stamps.css"]
         };
     }
     static get styleUrls() {
         return {
-            "$": ["my-component.css"]
+            "$": ["jaak-stamps.css"]
         };
     }
     static get assetsDirs() { return ["../../assets"]; }
@@ -3177,5 +3340,14 @@ export class JaakStamps {
         };
     }
     static get elementRef() { return "el"; }
+    static get watchers() {
+        return [{
+                "propName": "license",
+                "methodName": "onLicenseChanged"
+            }, {
+                "propName": "licenseEnvironment",
+                "methodName": "onLicenseEnvironmentChanged"
+            }];
+    }
 }
-//# sourceMappingURL=my-component.js.map
+//# sourceMappingURL=jaak-stamps.js.map