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

package/dist/collection/services/LicenseValidationService.js

@@ -0,0 +1,111 @@
+/**
+ * License Validation Service
+ * Handles license validation for the jaak-stamps webcomponent
+ */
+export class LicenseValidationService {
+    apiEndpoint = '/api/v1/license/validate';
+    baseUrl;
+    // Environment-specific base URLs
+    static ENVIRONMENT_URLS = {
+        dev: 'https://api.dev.jaak.ai',
+        qa: 'https://api.qa.jaak.ai',
+        staging: 'https://api-staging.jaak.ai',
+        prod: 'https://api.jaak.ai',
+    };
+    constructor(environment = 'prod') {
+        this.baseUrl = LicenseValidationService.ENVIRONMENT_URLS[environment];
+    }
+    /**
+     * Validate license with the API
+     * @param license License key to validate
+     * @param traceId Optional trace ID from W3C Trace Context
+     * @param appId Optional application ID
+     * @param metadata Optional additional metadata
+     * @returns Promise<LicenseValidationResponse>
+     */
+    async validateLicense(license, traceId, appId = 'jaak-stamps-web') {
+        // Generate traceId if not provided
+        const effectiveTraceId = traceId || this.generateTraceId();
+        // Build request body
+        const requestBody = {
+            license: traceId ? `L${effectiveTraceId}` : license,
+            origin: 'web',
+            app_id: appId,
+            product: 'kyc',
+            metadata: {
+                sdk_version: '2.1.0',
+            },
+        };
+        const headers = {
+            'Content-Type': 'application/json',
+        };
+        // Add traceparent header with the effective traceId
+        headers['traceparent'] = `00-${effectiveTraceId}-${this.generateSpanId()}-01`;
+        try {
+            const response = await fetch(`${this.baseUrl}${this.apiEndpoint}`, {
+                method: 'POST',
+                headers,
+                body: JSON.stringify(requestBody),
+            });
+            if (!response.ok) {
+                const errorData = await response.json().catch(() => ({}));
+                throw {
+                    error: errorData.error || 'license_validation_failed',
+                    error_description: errorData.error_description || `HTTP ${response.status}: ${response.statusText}`,
+                    status_code: response.status,
+                };
+            }
+            const responseData = await response.json();
+            // Add the traceId to the response
+            return {
+                ...responseData,
+                traceId: effectiveTraceId,
+            };
+        }
+        catch (error) {
+            if (error.error) {
+                throw error;
+            }
+            throw {
+                error: 'network_error',
+                error_description: 'Failed to connect to license validation service',
+                status_code: 0,
+            };
+        }
+    }
+    /**
+     * Generate a random trace ID for W3C Trace Context (32 hex characters)
+     */
+    generateTraceId() {
+        const array = new Uint8Array(16);
+        crypto.getRandomValues(array);
+        return Array.from(array, byte => byte.toString(16).padStart(2, '0')).join('');
+    }
+    /**
+     * Generate a random span ID for W3C Trace Context (16 hex characters)
+     */
+    generateSpanId() {
+        const array = new Uint8Array(8);
+        crypto.getRandomValues(array);
+        return Array.from(array, byte => byte.toString(16).padStart(2, '0')).join('');
+    }
+    /**
+     * Extract trace ID from license field
+     * License format: "L<32-hex-chars>"
+     * Example: "Ld79223833a2fd91971e4c14a33298904" -> "d79223833a2fd91971e4c14a33298904"
+     */
+    static extractTraceIdFromLicense(license) {
+        if (!license || typeof license !== 'string') {
+            return null;
+        }
+        // Remove "L" prefix if present
+        const traceId = license.startsWith('L') ? license.slice(1) : license;
+        // Validate format (32 hex characters)
+        if (traceId.length === 32 && /^[a-f0-9]{32}$/i.test(traceId)) {
+            return traceId.toLowerCase();
+        }
+        console.warn('[LicenseValidationService] Invalid license format for trace ID:', license);
+        return null;
+    }
+}
+//# sourceMappingURL=LicenseValidationService.js.map

package/dist/collection/services/LicenseValidationService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LicenseValidationService.js","sourceRoot":"","sources":["../../src/services/LicenseValidationService.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * License Validation Service\n * Handles license validation for the jaak-stamps webcomponent\n */\n\nexport type Environment = 'dev' | 'qa' | 'staging' | 'prod';\n\nexport interface LicenseValidationRequest {\n  license: string;\n  origin: string;\n  app_id?: string;\n  product?: string;\n  product_version?: string;\n  metadata?: {\n    [key: string]: any;\n  };\n}\n\nexport interface LicenseValidationResponse {\n  access_token: string;\n  token_type: string;\n  expires_at: string;\n  session_id: string;\n  jti: string;\n  step: number;\n  license: string;\n  traceId?: string; // Generated or provided traceId\n}\n\nexport interface LicenseValidationError {\n  error: string;\n  error_description?: string;\n  status_code?: number;\n}\n\nexport class LicenseValidationService {\n  private apiEndpoint: string = '/api/v1/license/validate';\n  private baseUrl: string;\n\n  // Environment-specific base URLs\n  private static readonly ENVIRONMENT_URLS: Record<Environment, string> = {\n    dev: 'https://api.dev.jaak.ai',\n    qa: 'https://api.qa.jaak.ai',\n    staging: 'https://api-staging.jaak.ai',\n    prod: 'https://api.jaak.ai',\n  };\n\n  constructor(environment: Environment = 'prod') {\n    this.baseUrl = LicenseValidationService.ENVIRONMENT_URLS[environment];\n  }\n\n  /**\n   * Validate license with the API\n   * @param license License key to validate\n   * @param traceId Optional trace ID from W3C Trace Context\n   * @param appId Optional application ID\n   * @param metadata Optional additional metadata\n   * @returns Promise<LicenseValidationResponse>\n   */\n  async validateLicense(\n    license: string,\n    traceId?: string,\n    appId: string = 'jaak-stamps-web',\n  ): Promise<LicenseValidationResponse> {\n    // Generate traceId if not provided\n    const effectiveTraceId = traceId || this.generateTraceId();\n\n    // Build request body\n    const requestBody: LicenseValidationRequest = {\n      license: traceId ? `L${effectiveTraceId}` : license,\n      origin: 'web',\n      app_id: appId,\n      product: 'kyc',\n      metadata: {\n        sdk_version: '2.1.0',\n      },\n    };\n\n    const headers: HeadersInit = {\n      'Content-Type': 'application/json',\n    };\n\n    // Add traceparent header with the effective traceId\n    headers['traceparent'] = `00-${effectiveTraceId}-${this.generateSpanId()}-01`;\n\n    try {\n      const response = await fetch(`${this.baseUrl}${this.apiEndpoint}`, {\n        method: 'POST',\n        headers,\n        body: JSON.stringify(requestBody),\n      });\n\n      if (!response.ok) {\n        const errorData = await response.json().catch(() => ({}));\n        throw {\n          error: errorData.error || 'license_validation_failed',\n          error_description: errorData.error_description || `HTTP ${response.status}: ${response.statusText}`,\n          status_code: response.status,\n        } as LicenseValidationError;\n      }\n\n      const responseData = await response.json();\n      // Add the traceId to the response\n      return {\n        ...responseData,\n        traceId: effectiveTraceId,\n      };\n    } catch (error) {\n      if ((error as any).error) {\n        throw error;\n      }\n\n      throw {\n        error: 'network_error',\n        error_description: 'Failed to connect to license validation service',\n        status_code: 0,\n      } as LicenseValidationError;\n    }\n  }\n\n  /**\n   * Generate a random trace ID for W3C Trace Context (32 hex characters)\n   */\n  private generateTraceId(): string {\n    const array = new Uint8Array(16);\n    crypto.getRandomValues(array);\n    return Array.from(array, byte => byte.toString(16).padStart(2, '0')).join('');\n  }\n\n  /**\n   * Generate a random span ID for W3C Trace Context (16 hex characters)\n   */\n  private generateSpanId(): string {\n    const array = new Uint8Array(8);\n    crypto.getRandomValues(array);\n    return Array.from(array, byte => byte.toString(16).padStart(2, '0')).join('');\n  }\n\n  /**\n   * Extract trace ID from license field\n   * License format: \"L<32-hex-chars>\"\n   * Example: \"Ld79223833a2fd91971e4c14a33298904\" -> \"d79223833a2fd91971e4c14a33298904\"\n   */\n  static extractTraceIdFromLicense(license: string): string | null {\n    if (!license || typeof license !== 'string') {\n      return null;\n    }\n\n    // Remove \"L\" prefix if present\n    const traceId = license.startsWith('L') ? license.slice(1) : license;\n\n    // Validate format (32 hex characters)\n    if (traceId.length === 32 && /^[a-f0-9]{32}$/i.test(traceId)) {\n      return traceId.toLowerCase();\n    }\n\n    console.warn('[LicenseValidationService] Invalid license format for trace ID:', license);\n    return null;\n  }\n}\n"]}

package/dist/collection/services/MetricsService.js

@@ -0,0 +1,350 @@
+import { MeterProvider, PeriodicExportingMetricReader } from "@opentelemetry/sdk-metrics";
+import { OTLPMetricExporter } from "@opentelemetry/exporter-metrics-otlp-http";
+export class MetricsService {
+    meterProvider = null;
+    meter = null;
+    collectorUrl;
+    serviceName;
+    serviceVersion;
+    debug;
+    customerId;
+    tenantId;
+    environment;
+    exportIntervalMillis;
+    metricReader = null;
+    // Business Metrics - Counters
+    captureCounter = null;
+    errorCounter = null;
+    modelLoadCounter = null;
+    userInteractionCounter = null;
+    // Business Metrics - Histograms (for latencies and sizes)
+    captureLatencyHistogram = null;
+    modelLoadLatencyHistogram = null;
+    detectionLatencyHistogram = null;
+    imageSizeHistogram = null;
+    // Business Metrics - Gauges (for current state)
+    activeSessionsGauge = null;
+    memoryUsageGauge = null;
+    // State tracking
+    activeSessions = 0;
+    gaugeValues = new Map();
+    constructor(config = {}) {
+        this.collectorUrl = config.collectorUrl || 'https://collector.jaak.ai/v1/metrics';
+        this.serviceName = config.serviceName || 'jaak-stamps-webcomponent';
+        this.serviceVersion = config.serviceVersion || '2.1.0';
+        this.debug = config.debug || false;
+        this.customerId = config.customerId;
+        this.tenantId = config.tenantId;
+        this.environment = config.environment || 'production';
+        this.exportIntervalMillis = config.exportIntervalMillis || 60000; // Export every 60 seconds
+    }
+    initialize() {
+        try {
+            // Create OTLP metrics exporter
+            const exporter = new OTLPMetricExporter({
+                url: this.collectorUrl,
+                headers: {
+                    'Content-Type': 'application/json',
+                },
+            });
+            // Create periodic exporting metric reader
+            this.metricReader = new PeriodicExportingMetricReader({
+                exporter: exporter,
+                exportIntervalMillis: this.exportIntervalMillis,
+                exportTimeoutMillis: 30000,
+            });
+            // Create meter provider
+            this.meterProvider = new MeterProvider({
+                readers: [this.metricReader],
+            });
+            // Get meter
+            this.meter = this.meterProvider.getMeter(this.serviceName, this.serviceVersion);
+            // Initialize business metrics
+            this.initializeMetrics();
+            if (this.debug) {
+                console.log('[MetricsService] Initialized successfully', {
+                    collectorUrl: this.collectorUrl,
+                    serviceName: this.serviceName,
+                    serviceVersion: this.serviceVersion,
+                    environment: this.environment,
+                    customerId: this.customerId,
+                    tenantId: this.tenantId,
+                    exportIntervalMillis: this.exportIntervalMillis,
+                });
+            }
+        }
+        catch (error) {
+            console.error('[MetricsService] Failed to initialize:', error);
+            // Don't throw - metrics should fail silently in production
+        }
+    }
+    initializeMetrics() {
+        if (!this.meter)
+            return;
+        const baseAttributes = this.getBaseAttributes();
+        try {
+            // COUNTERS - Track events and totals
+            // Total captures performed
+            this.captureCounter = this.meter.createCounter('jaak.captures.total', {
+                description: 'Total number of document captures',
+                unit: '1',
+            });
+            // Total errors
+            this.errorCounter = this.meter.createCounter('jaak.errors.total', {
+                description: 'Total number of errors',
+                unit: '1',
+            });
+            // Model loads
+            this.modelLoadCounter = this.meter.createCounter('jaak.model.loads.total', {
+                description: 'Total number of model loads',
+                unit: '1',
+            });
+            // User interactions
+            this.userInteractionCounter = this.meter.createCounter('jaak.user.interactions.total', {
+                description: 'Total user interactions (clicks, etc.)',
+                unit: '1',
+            });
+            // HISTOGRAMS - Track distributions of latencies and sizes
+            // Capture latency (time from start to completion)
+            this.captureLatencyHistogram = this.meter.createHistogram('jaak.capture.duration', {
+                description: 'Duration of capture operations',
+                unit: 'ms',
+            });
+            // Model load latency
+            this.modelLoadLatencyHistogram = this.meter.createHistogram('jaak.model.load.duration', {
+                description: 'Duration of model loading',
+                unit: 'ms',
+            });
+            // Detection latency (per frame)
+            this.detectionLatencyHistogram = this.meter.createHistogram('jaak.detection.duration', {
+                description: 'Duration of detection inference',
+                unit: 'ms',
+            });
+            // Image sizes
+            this.imageSizeHistogram = this.meter.createHistogram('jaak.image.size', {
+                description: 'Size of captured images',
+                unit: 'bytes',
+            });
+            // GAUGES - Track current state values
+            // Active capture sessions
+            this.activeSessionsGauge = this.meter.createObservableGauge('jaak.sessions.active', {
+                description: 'Number of active capture sessions',
+                unit: '1',
+            });
+            this.activeSessionsGauge.addCallback((observableResult) => {
+                observableResult.observe(this.activeSessions, baseAttributes);
+            });
+            // Memory usage (if available)
+            if ('memory' in performance) {
+                this.memoryUsageGauge = this.meter.createObservableGauge('jaak.memory.usage', {
+                    description: 'JavaScript heap memory usage',
+                    unit: 'bytes',
+                });
+                this.memoryUsageGauge.addCallback((observableResult) => {
+                    const memInfo = performance.memory;
+                    if (memInfo) {
+                        observableResult.observe(memInfo.usedJSHeapSize, baseAttributes);
+                    }
+                });
+            }
+            if (this.debug) {
+                console.log('[MetricsService] Business metrics initialized');
+            }
+        }
+        catch (error) {
+            console.error('[MetricsService] Failed to initialize metrics:', error);
+        }
+    }
+    getBaseAttributes() {
+        const attributes = {
+            'service.name': this.serviceName,
+            'service.version': this.serviceVersion,
+            'deployment.environment': this.environment,
+        };
+        if (this.customerId) {
+            attributes['customer.id'] = this.customerId;
+        }
+        if (this.tenantId) {
+            attributes['tenant.id'] = this.tenantId;
+        }
+        return attributes;
+    }
+    incrementCounter(name, value = 1, attributes) {
+        try {
+            const baseAttrs = this.getBaseAttributes();
+            const allAttrs = { ...baseAttrs, ...attributes };
+            // Use predefined counters or create ad-hoc
+            switch (name) {
+                case 'captures':
+                    this.captureCounter?.add(value, allAttrs);
+                    break;
+                case 'errors':
+                    this.errorCounter?.add(value, allAttrs);
+                    break;
+                case 'model_loads':
+                    this.modelLoadCounter?.add(value, allAttrs);
+                    break;
+                case 'user_interactions':
+                    this.userInteractionCounter?.add(value, allAttrs);
+                    break;
+                default:
+                    // Create ad-hoc counter if needed
+                    if (this.meter) {
+                        const counter = this.meter.createCounter(`jaak.${name}.total`, {
+                            description: `Total ${name}`,
+                            unit: '1',
+                        });
+                        counter.add(value, allAttrs);
+                    }
+            }
+            if (this.debug) {
+                console.log(`[MetricsService] Counter incremented: ${name} += ${value}`, attributes);
+            }
+        }
+        catch (error) {
+            console.error('[MetricsService] Failed to increment counter:', error);
+        }
+    }
+    recordHistogram(name, value, attributes) {
+        try {
+            const baseAttrs = this.getBaseAttributes();
+            const allAttrs = { ...baseAttrs, ...attributes };
+            // Use predefined histograms
+            switch (name) {
+                case 'capture_duration':
+                    this.captureLatencyHistogram?.record(value, allAttrs);
+                    break;
+                case 'model_load_duration':
+                    this.modelLoadLatencyHistogram?.record(value, allAttrs);
+                    break;
+                case 'detection_duration':
+                    this.detectionLatencyHistogram?.record(value, allAttrs);
+                    break;
+                case 'image_size':
+                    this.imageSizeHistogram?.record(value, allAttrs);
+                    break;
+                default:
+                    // Create ad-hoc histogram if needed
+                    if (this.meter) {
+                        const histogram = this.meter.createHistogram(`jaak.${name}`, {
+                            description: `Distribution of ${name}`,
+                            unit: 'ms',
+                        });
+                        histogram.record(value, allAttrs);
+                    }
+            }
+            if (this.debug) {
+                console.log(`[MetricsService] Histogram recorded: ${name} = ${value}`, attributes);
+            }
+        }
+        catch (error) {
+            console.error('[MetricsService] Failed to record histogram:', error);
+        }
+    }
+    setGauge(name, value, attributes) {
+        try {
+            // Store gauge value for observable callbacks
+            this.gaugeValues.set(name, value);
+            // Update known gauges
+            if (name === 'active_sessions') {
+                this.activeSessions = value;
+            }
+            if (this.debug) {
+                console.log(`[MetricsService] Gauge set: ${name} = ${value}`, attributes);
+            }
+        }
+        catch (error) {
+            console.error('[MetricsService] Failed to set gauge:', error);
+        }
+    }
+    async measureDuration(name, fn, attributes) {
+        const startTime = performance.now();
+        try {
+            const result = await fn();
+            const duration = performance.now() - startTime;
+            this.recordHistogram(name, duration, attributes);
+            return result;
+        }
+        catch (error) {
+            const duration = performance.now() - startTime;
+            this.recordHistogram(name, duration, { ...attributes, error: true });
+            throw error;
+        }
+    }
+    async flush() {
+        try {
+            if (this.metricReader) {
+                await this.metricReader.forceFlush();
+            }
+            if (this.debug) {
+                console.log('[MetricsService] Metrics flushed');
+            }
+        }
+        catch (error) {
+            console.error('[MetricsService] Failed to flush metrics:', error);
+        }
+    }
+    async cleanup() {
+        try {
+            if (this.metricReader) {
+                await this.metricReader.forceFlush();
+                await this.metricReader.shutdown();
+            }
+            if (this.meterProvider) {
+                await this.meterProvider.shutdown();
+            }
+            if (this.debug) {
+                console.log('[MetricsService] Cleaned up successfully');
+            }
+        }
+        catch (error) {
+            console.error('[MetricsService] Failed to cleanup:', error);
+        }
+    }
+    // Helper methods for common business metrics
+    /**
+     * Record a successful capture
+     */
+    recordCapture(side, mode, durationMs) {
+        this.incrementCounter('captures', 1, { side, mode });
+        this.recordHistogram('capture_duration', durationMs, { side, mode });
+    }
+    /**
+     * Record an error
+     */
+    recordError(errorType, operation) {
+        this.incrementCounter('errors', 1, { error_type: errorType, operation });
+    }
+    /**
+     * Record model load performance
+     */
+    recordModelLoad(modelType, durationMs, cached) {
+        this.incrementCounter('model_loads', 1, { model_type: modelType, cached });
+        this.recordHistogram('model_load_duration', durationMs, { model_type: modelType, cached });
+    }
+    /**
+     * Record detection performance
+     */
+    recordDetection(durationMs, detectionsFound) {
+        this.recordHistogram('detection_duration', durationMs, { detections_found: detectionsFound });
+    }
+    /**
+     * Record image size
+     */
+    recordImageSize(side, sizeBytes) {
+        this.recordHistogram('image_size', sizeBytes, { side });
+    }
+    /**
+     * Update active sessions count
+     */
+    updateActiveSessions(count) {
+        this.setGauge('active_sessions', count);
+    }
+    /**
+     * Record user interaction
+     */
+    recordUserInteraction(interactionType) {
+        this.incrementCounter('user_interactions', 1, { interaction_type: interactionType });
+    }
+}
+//# sourceMappingURL=MetricsService.js.map

package/dist/collection/services/MetricsService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MetricsService.js","sourceRoot":"","sources":["../../src/services/MetricsService.ts"],"names":[],"mappings":"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","sourcesContent":["import { IMetricsService } from './interfaces/IMetricsService';\nimport { MeterProvider, PeriodicExportingMetricReader } from '@opentelemetry/sdk-metrics';\nimport { OTLPMetricExporter } from '@opentelemetry/exporter-metrics-otlp-http';\nimport type { Counter, Histogram, ObservableGauge, Meter } from '@opentelemetry/api';\n\nexport interface MetricsConfig {\n  collectorUrl?: string;\n  serviceName?: string;\n  serviceVersion?: string;\n  debug?: boolean;\n  customerId?: string;\n  tenantId?: string;\n  environment?: string;\n  exportIntervalMillis?: number;\n}\n\nexport class MetricsService implements IMetricsService {\n  private meterProvider: MeterProvider | null = null;\n  private meter: Meter | null = null;\n  private readonly collectorUrl: string;\n  private readonly serviceName: string;\n  private readonly serviceVersion: string;\n  private readonly debug: boolean;\n  private readonly customerId?: string;\n  private readonly tenantId?: string;\n  private readonly environment?: string;\n  private readonly exportIntervalMillis: number;\n  private metricReader: PeriodicExportingMetricReader | null = null;\n\n  // Business Metrics - Counters\n  private captureCounter: Counter | null = null;\n  private errorCounter: Counter | null = null;\n  private modelLoadCounter: Counter | null = null;\n  private userInteractionCounter: Counter | null = null;\n\n  // Business Metrics - Histograms (for latencies and sizes)\n  private captureLatencyHistogram: Histogram | null = null;\n  private modelLoadLatencyHistogram: Histogram | null = null;\n  private detectionLatencyHistogram: Histogram | null = null;\n  private imageSizeHistogram: Histogram | null = null;\n\n  // Business Metrics - Gauges (for current state)\n  private activeSessionsGauge: ObservableGauge | null = null;\n  private memoryUsageGauge: ObservableGauge | null = null;\n\n  // State tracking\n  private activeSessions: number = 0;\n  private gaugeValues: Map<string, number> = new Map();\n\n  constructor(config: MetricsConfig = {}) {\n    this.collectorUrl = config.collectorUrl || 'https://collector.jaak.ai/v1/metrics';\n    this.serviceName = config.serviceName || 'jaak-stamps-webcomponent';\n    this.serviceVersion = config.serviceVersion || '2.1.0';\n    this.debug = config.debug || false;\n    this.customerId = config.customerId;\n    this.tenantId = config.tenantId;\n    this.environment = config.environment || 'production';\n    this.exportIntervalMillis = config.exportIntervalMillis || 60000; // Export every 60 seconds\n  }\n\n  initialize(): void {\n    try {\n      // Create OTLP metrics exporter\n      const exporter = new OTLPMetricExporter({\n        url: this.collectorUrl,\n        headers: {\n          'Content-Type': 'application/json',\n        },\n      });\n\n      // Create periodic exporting metric reader\n      this.metricReader = new PeriodicExportingMetricReader({\n        exporter: exporter,\n        exportIntervalMillis: this.exportIntervalMillis,\n        exportTimeoutMillis: 30000,\n      });\n\n      // Create meter provider\n      this.meterProvider = new MeterProvider({\n        readers: [this.metricReader],\n      });\n\n      // Get meter\n      this.meter = this.meterProvider.getMeter(this.serviceName, this.serviceVersion);\n\n      // Initialize business metrics\n      this.initializeMetrics();\n\n      if (this.debug) {\n        console.log('[MetricsService] Initialized successfully', {\n          collectorUrl: this.collectorUrl,\n          serviceName: this.serviceName,\n          serviceVersion: this.serviceVersion,\n          environment: this.environment,\n          customerId: this.customerId,\n          tenantId: this.tenantId,\n          exportIntervalMillis: this.exportIntervalMillis,\n        });\n      }\n    } catch (error) {\n      console.error('[MetricsService] Failed to initialize:', error);\n      // Don't throw - metrics should fail silently in production\n    }\n  }\n\n  private initializeMetrics(): void {\n    if (!this.meter) return;\n\n    const baseAttributes = this.getBaseAttributes();\n\n    try {\n      // COUNTERS - Track events and totals\n\n      // Total captures performed\n      this.captureCounter = this.meter.createCounter('jaak.captures.total', {\n        description: 'Total number of document captures',\n        unit: '1',\n      });\n\n      // Total errors\n      this.errorCounter = this.meter.createCounter('jaak.errors.total', {\n        description: 'Total number of errors',\n        unit: '1',\n      });\n\n      // Model loads\n      this.modelLoadCounter = this.meter.createCounter('jaak.model.loads.total', {\n        description: 'Total number of model loads',\n        unit: '1',\n      });\n\n      // User interactions\n      this.userInteractionCounter = this.meter.createCounter('jaak.user.interactions.total', {\n        description: 'Total user interactions (clicks, etc.)',\n        unit: '1',\n      });\n\n      // HISTOGRAMS - Track distributions of latencies and sizes\n\n      // Capture latency (time from start to completion)\n      this.captureLatencyHistogram = this.meter.createHistogram('jaak.capture.duration', {\n        description: 'Duration of capture operations',\n        unit: 'ms',\n      });\n\n      // Model load latency\n      this.modelLoadLatencyHistogram = this.meter.createHistogram('jaak.model.load.duration', {\n        description: 'Duration of model loading',\n        unit: 'ms',\n      });\n\n      // Detection latency (per frame)\n      this.detectionLatencyHistogram = this.meter.createHistogram('jaak.detection.duration', {\n        description: 'Duration of detection inference',\n        unit: 'ms',\n      });\n\n      // Image sizes\n      this.imageSizeHistogram = this.meter.createHistogram('jaak.image.size', {\n        description: 'Size of captured images',\n        unit: 'bytes',\n      });\n\n      // GAUGES - Track current state values\n\n      // Active capture sessions\n      this.activeSessionsGauge = this.meter.createObservableGauge('jaak.sessions.active', {\n        description: 'Number of active capture sessions',\n        unit: '1',\n      });\n\n      this.activeSessionsGauge.addCallback((observableResult) => {\n        observableResult.observe(this.activeSessions, baseAttributes);\n      });\n\n      // Memory usage (if available)\n      if ('memory' in performance) {\n        this.memoryUsageGauge = this.meter.createObservableGauge('jaak.memory.usage', {\n          description: 'JavaScript heap memory usage',\n          unit: 'bytes',\n        });\n\n        this.memoryUsageGauge.addCallback((observableResult) => {\n          const memInfo = (performance as any).memory;\n          if (memInfo) {\n            observableResult.observe(memInfo.usedJSHeapSize, baseAttributes);\n          }\n        });\n      }\n\n      if (this.debug) {\n        console.log('[MetricsService] Business metrics initialized');\n      }\n    } catch (error) {\n      console.error('[MetricsService] Failed to initialize metrics:', error);\n    }\n  }\n\n  private getBaseAttributes(): Record<string, any> {\n    const attributes: Record<string, any> = {\n      'service.name': this.serviceName,\n      'service.version': this.serviceVersion,\n      'deployment.environment': this.environment,\n    };\n\n    if (this.customerId) {\n      attributes['customer.id'] = this.customerId;\n    }\n\n    if (this.tenantId) {\n      attributes['tenant.id'] = this.tenantId;\n    }\n\n    return attributes;\n  }\n\n  incrementCounter(name: string, value: number = 1, attributes?: Record<string, any>): void {\n    try {\n      const baseAttrs = this.getBaseAttributes();\n      const allAttrs = { ...baseAttrs, ...attributes };\n\n      // Use predefined counters or create ad-hoc\n      switch (name) {\n        case 'captures':\n          this.captureCounter?.add(value, allAttrs);\n          break;\n        case 'errors':\n          this.errorCounter?.add(value, allAttrs);\n          break;\n        case 'model_loads':\n          this.modelLoadCounter?.add(value, allAttrs);\n          break;\n        case 'user_interactions':\n          this.userInteractionCounter?.add(value, allAttrs);\n          break;\n        default:\n          // Create ad-hoc counter if needed\n          if (this.meter) {\n            const counter = this.meter.createCounter(`jaak.${name}.total`, {\n              description: `Total ${name}`,\n              unit: '1',\n            });\n            counter.add(value, allAttrs);\n          }\n      }\n\n      if (this.debug) {\n        console.log(`[MetricsService] Counter incremented: ${name} += ${value}`, attributes);\n      }\n    } catch (error) {\n      console.error('[MetricsService] Failed to increment counter:', error);\n    }\n  }\n\n  recordHistogram(name: string, value: number, attributes?: Record<string, any>): void {\n    try {\n      const baseAttrs = this.getBaseAttributes();\n      const allAttrs = { ...baseAttrs, ...attributes };\n\n      // Use predefined histograms\n      switch (name) {\n        case 'capture_duration':\n          this.captureLatencyHistogram?.record(value, allAttrs);\n          break;\n        case 'model_load_duration':\n          this.modelLoadLatencyHistogram?.record(value, allAttrs);\n          break;\n        case 'detection_duration':\n          this.detectionLatencyHistogram?.record(value, allAttrs);\n          break;\n        case 'image_size':\n          this.imageSizeHistogram?.record(value, allAttrs);\n          break;\n        default:\n          // Create ad-hoc histogram if needed\n          if (this.meter) {\n            const histogram = this.meter.createHistogram(`jaak.${name}`, {\n              description: `Distribution of ${name}`,\n              unit: 'ms',\n            });\n            histogram.record(value, allAttrs);\n          }\n      }\n\n      if (this.debug) {\n        console.log(`[MetricsService] Histogram recorded: ${name} = ${value}`, attributes);\n      }\n    } catch (error) {\n      console.error('[MetricsService] Failed to record histogram:', error);\n    }\n  }\n\n  setGauge(name: string, value: number, attributes?: Record<string, any>): void {\n    try {\n      // Store gauge value for observable callbacks\n      this.gaugeValues.set(name, value);\n\n      // Update known gauges\n      if (name === 'active_sessions') {\n        this.activeSessions = value;\n      }\n\n      if (this.debug) {\n        console.log(`[MetricsService] Gauge set: ${name} = ${value}`, attributes);\n      }\n    } catch (error) {\n      console.error('[MetricsService] Failed to set gauge:', error);\n    }\n  }\n\n  async measureDuration<T>(name: string, fn: () => T | Promise<T>, attributes?: Record<string, any>): Promise<T> {\n    const startTime = performance.now();\n\n    try {\n      const result = await fn();\n      const duration = performance.now() - startTime;\n\n      this.recordHistogram(name, duration, attributes);\n\n      return result;\n    } catch (error) {\n      const duration = performance.now() - startTime;\n      this.recordHistogram(name, duration, { ...attributes, error: true });\n      throw error;\n    }\n  }\n\n  async flush(): Promise<void> {\n    try {\n      if (this.metricReader) {\n        await this.metricReader.forceFlush();\n      }\n\n      if (this.debug) {\n        console.log('[MetricsService] Metrics flushed');\n      }\n    } catch (error) {\n      console.error('[MetricsService] Failed to flush metrics:', error);\n    }\n  }\n\n  async cleanup(): Promise<void> {\n    try {\n      if (this.metricReader) {\n        await this.metricReader.forceFlush();\n        await this.metricReader.shutdown();\n      }\n\n      if (this.meterProvider) {\n        await this.meterProvider.shutdown();\n      }\n\n      if (this.debug) {\n        console.log('[MetricsService] Cleaned up successfully');\n      }\n    } catch (error) {\n      console.error('[MetricsService] Failed to cleanup:', error);\n    }\n  }\n\n  // Helper methods for common business metrics\n\n  /**\n   * Record a successful capture\n   */\n  recordCapture(side: 'front' | 'back', mode: 'auto' | 'manual', durationMs: number): void {\n    this.incrementCounter('captures', 1, { side, mode });\n    this.recordHistogram('capture_duration', durationMs, { side, mode });\n  }\n\n  /**\n   * Record an error\n   */\n  recordError(errorType: string, operation: string): void {\n    this.incrementCounter('errors', 1, { error_type: errorType, operation });\n  }\n\n  /**\n   * Record model load performance\n   */\n  recordModelLoad(modelType: 'detection' | 'classification', durationMs: number, cached: boolean): void {\n    this.incrementCounter('model_loads', 1, { model_type: modelType, cached });\n    this.recordHistogram('model_load_duration', durationMs, { model_type: modelType, cached });\n  }\n\n  /**\n   * Record detection performance\n   */\n  recordDetection(durationMs: number, detectionsFound: number): void {\n    this.recordHistogram('detection_duration', durationMs, { detections_found: detectionsFound });\n  }\n\n  /**\n   * Record image size\n   */\n  recordImageSize(side: 'front' | 'back', sizeBytes: number): void {\n    this.recordHistogram('image_size', sizeBytes, { side });\n  }\n\n  /**\n   * Update active sessions count\n   */\n  updateActiveSessions(count: number): void {\n    this.setGauge('active_sessions', count);\n  }\n\n  /**\n   * Record user interaction\n   */\n  recordUserInteraction(interactionType: string): void {\n    this.incrementCounter('user_interactions', 1, { interaction_type: interactionType });\n  }\n}\n"]}

package/dist/collection/services/ServiceContainer.js

@@ -2,6 +2,8 @@ import { EventBusService } from "./EventBusService";
 import { StateManagerService } from "./StateManagerService";
 import { CameraService } from "./CameraService";
 import { DetectionService } from "./DetectionService";
+import { TracingService } from "./TracingService";
+import { MetricsService } from "./MetricsService";
 export class ServiceContainer {
     services = new Map();
     constructor(config) {
@@ -13,11 +15,48 @@ export class ServiceContainer {
         const stateManager = new StateManagerService(eventBus);
         const cameraService = new CameraService(eventBus, config.preferredCamera);
         const detectionService = new DetectionService(config.debug, config.useDocumentClassification, config.useDocumentDetector);
+        // Initialize tracing service if enabled
+        let tracingService = null;
+        if (config.enableTelemetry !== false) {
+            tracingService = new TracingService({
+                collectorUrl: config.telemetryCollectorUrl || 'https://collector.jaak.ai/v1/traces',
+                serviceName: 'jaak-stamps-webcomponent',
+                serviceVersion: '2.1.0',
+                debug: config.debug,
+                customerId: config.customerId,
+                tenantId: config.tenantId,
+                environment: config.environment || 'production',
+                propagateTraceHeaderCorsUrls: config.propagateTraceHeaderCorsUrls || [],
+                enableAutoInstrumentation: true,
+            });
+            tracingService.initialize();
+        }
+        // Initialize metrics service if enabled
+        let metricsService = null;
+        if (config.enableMetrics !== false) {
+            metricsService = new MetricsService({
+                collectorUrl: config.metricsCollectorUrl || 'https://collector.jaak.ai/v1/metrics',
+                serviceName: 'jaak-stamps-webcomponent',
+                serviceVersion: '2.1.0',
+                debug: config.debug,
+                customerId: config.customerId,
+                tenantId: config.tenantId,
+                environment: config.environment || 'production',
+                exportIntervalMillis: config.metricsExportIntervalMillis || 60000,
+            });
+            metricsService.initialize();
+        }
         // Register services
         this.services.set('eventBus', eventBus);
         this.services.set('stateManager', stateManager);
         this.services.set('cameraService', cameraService);
         this.services.set('detectionService', detectionService);
+        if (tracingService) {
+            this.services.set('tracingService', tracingService);
+        }
+        if (metricsService) {
+            this.services.set('metricsService', metricsService);
+        }
     }
     get(serviceName) {
         const service = this.services.get(serviceName);
@@ -38,6 +77,22 @@ export class ServiceContainer {
     getDetectionService() {
         return this.get('detectionService');
     }
+    getTracingService() {
+        try {
+            return this.get('tracingService');
+        }
+        catch {
+            return null;
+        }
+    }
+    getMetricsService() {
+        try {
+            return this.get('metricsService');
+        }
+        catch {
+            return null;
+        }
+    }
     updateConfig(config) {
         // Reinitialize services that depend on configuration changes
         if (config.preferredCamera !== undefined ||
@@ -47,9 +102,19 @@ export class ServiceContainer {
             // For simplicity, this is omitted in this example
         }
     }
-    cleanup() {
+    async cleanup() {
         // Cleanup services in reverse order
         this.getDetectionService().cleanup();
+        // Cleanup metrics service if present
+        const metricsService = this.getMetricsService();
+        if (metricsService) {
+            await metricsService.cleanup();
+        }
+        // Cleanup tracing service if present
+        const tracingService = this.getTracingService();
+        if (tracingService) {
+            await tracingService.cleanup();
+        }
         this.getEventBus().clear();
         this.services.clear();
     }