@skillsmith/core 0.5.5 → 0.5.6

package/dist/telemetry/posthog.js

@@ -0,0 +1,213 @@
+/**
+ * SMI-1246: PostHog Telemetry Integration
+ *
+ * Provides product analytics and event tracking via PostHog:
+ * - Skill searches and views
+ * - Installation events
+ * - User engagement metrics
+ * - Feature usage tracking
+ *
+ * Privacy-first: All user IDs are anonymized, no PII collected.
+ */
+import { PostHog } from 'posthog-node';
+// Singleton instance
+let posthogInstance = null;
+let isDisabled = false;
+/**
+ * Initialize PostHog client
+ * Call this at application startup
+ *
+ * @param config - PostHog configuration
+ */
+export function initializePostHog(config) {
+    if (config.disabled) {
+        isDisabled = true;
+        return;
+    }
+    if (!config.apiKey) {
+        console.warn('[PostHog] No API key provided, telemetry disabled');
+        isDisabled = true;
+        return;
+    }
+    posthogInstance = new PostHog(config.apiKey, {
+        host: config.host || 'https://app.posthog.com',
+        flushInterval: config.flushInterval || 10000,
+    });
+    if (config.debug) {
+        posthogInstance.debug();
+    }
+}
+/**
+ * Get the PostHog client instance
+ * Returns null if not initialized or disabled
+ */
+export function getPostHog() {
+    return posthogInstance;
+}
+/**
+ * Check if PostHog is enabled and initialized
+ */
+export function isPostHogEnabled() {
+    return !isDisabled && posthogInstance !== null;
+}
+/**
+ * Track an event with PostHog
+ * Silently no-ops if PostHog is disabled or not initialized
+ *
+ * @param distinctId - Anonymous user identifier
+ * @param event - Event name
+ * @param properties - Event properties
+ */
+export function trackEvent(distinctId, event, properties) {
+    if (!isPostHogEnabled() || !posthogInstance) {
+        return;
+    }
+    try {
+        posthogInstance.capture({
+            distinctId,
+            event,
+            properties: {
+                ...properties,
+                $lib: 'skillsmith',
+                $lib_version: process.env.npm_package_version || 'unknown',
+            },
+        });
+    }
+    catch (error) {
+        // Silently fail - telemetry should never break the app
+        console.debug('[PostHog] Failed to track event:', error);
+    }
+}
+/**
+ * Allowed trait keys for user identification.
+ * Only non-PII properties are permitted to prevent data leakage.
+ */
+export const ALLOWED_TRAITS = ['tier', 'version', 'platform', 'sdk_version'];
+/**
+ * Identify a user with restricted traits.
+ *
+ * @warning DO NOT pass PII (email, name, IP, etc.) to this function.
+ * Only the following safe traits are allowed: tier, version, platform, sdk_version.
+ * Any other properties will be silently filtered out to prevent data leakage.
+ *
+ * @param distinctId - Anonymous user identifier (should be a hash, not an email)
+ * @param traits - User properties (restricted to AllowedUserTraits)
+ */
+export function identifyUser(distinctId, traits) {
+    if (!isPostHogEnabled() || !posthogInstance) {
+        return;
+    }
+    // Filter traits to only include allowed keys (defense in depth)
+    const safeTraits = {};
+    for (const key of ALLOWED_TRAITS) {
+        if (traits[key] !== undefined) {
+            safeTraits[key] = traits[key];
+        }
+    }
+    try {
+        posthogInstance.identify({
+            distinctId,
+            properties: safeTraits,
+        });
+    }
+    catch (error) {
+        console.debug('[PostHog] Failed to identify user:', error);
+    }
+}
+/**
+ * Check if a feature flag is enabled for a user
+ *
+ * @param distinctId - Anonymous user identifier
+ * @param flagKey - Feature flag key
+ * @returns true if enabled, false otherwise
+ */
+export async function isFeatureFlagEnabled(distinctId, flagKey) {
+    if (!isPostHogEnabled() || !posthogInstance) {
+        return false;
+    }
+    try {
+        const result = await posthogInstance.isFeatureEnabled(flagKey, distinctId);
+        trackEvent(distinctId, 'feature_flag_evaluated', {
+            flag_key: flagKey,
+            flag_value: result,
+        });
+        return result ?? false;
+    }
+    catch (error) {
+        console.debug('[PostHog] Failed to check feature flag:', error);
+        return false;
+    }
+}
+/**
+ * Flush all pending events immediately
+ * Call this before application shutdown
+ */
+export async function flushPostHog() {
+    if (!posthogInstance) {
+        return;
+    }
+    try {
+        await posthogInstance.flush();
+    }
+    catch (error) {
+        console.debug('[PostHog] Failed to flush events:', error);
+    }
+}
+/**
+ * Shutdown PostHog client
+ * Call this at application shutdown
+ */
+export async function shutdownPostHog() {
+    if (!posthogInstance) {
+        return;
+    }
+    try {
+        await posthogInstance.shutdown();
+        posthogInstance = null;
+        isDisabled = false;
+    }
+    catch (error) {
+        console.debug('[PostHog] Failed to shutdown:', error);
+    }
+}
+/**
+ * Convenience function to track skill search events
+ */
+export function trackSkillSearch(distinctId, query, resultCount, durationMs, filters) {
+    trackEvent(distinctId, 'skill_search', {
+        query,
+        result_count: resultCount,
+        duration_ms: durationMs,
+        trust_tier: filters?.trustTier,
+        category: filters?.category,
+    });
+}
+/**
+ * Convenience function to track skill view events
+ */
+export function trackSkillView(distinctId, skillId, source) {
+    trackEvent(distinctId, 'skill_view', {
+        skill_id: skillId,
+        source,
+    });
+}
+/**
+ * Convenience function to track skill install events
+ */
+export function trackSkillInstall(distinctId, skillId, source) {
+    trackEvent(distinctId, 'skill_install', {
+        skill_id: skillId,
+        source,
+    });
+}
+/**
+ * Convenience function to track API errors
+ */
+export function trackApiError(distinctId, errorCode, endpoint, durationMs) {
+    trackEvent(distinctId, 'api_error', {
+        error_code: errorCode,
+        endpoint,
+        duration_ms: durationMs,
+    });
+}
+//# sourceMappingURL=posthog.js.map

package/dist/telemetry/posthog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"posthog.js","sourceRoot":"","sources":["../../src/telemetry/posthog.ts"],"names":[],"mappings":"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"}

package/dist/telemetry/prometheus.d.ts

@@ -0,0 +1,81 @@
+/**
+ * SMI-1018: Prometheus Metrics Exporter
+ *
+ * Exports Skillsmith metrics in Prometheus text exposition format.
+ * Integrates with existing MetricsRegistry for monitoring dashboards.
+ *
+ * @see https://prometheus.io/docs/instrumenting/exposition_formats/
+ */
+import type { MetricsSnapshot } from './metrics.js';
+/**
+ * Prometheus export options
+ */
+export interface PrometheusExportOptions {
+    /** Include TYPE and HELP comments (default: true) */
+    includeMetadata?: boolean;
+    /** Prefix for all metric names (default: none) */
+    prefix?: string;
+    /** Custom labels to add to all metrics */
+    globalLabels?: Record<string, string>;
+    /** Timestamp for all metrics (epoch ms, default: current time) */
+    timestamp?: number;
+}
+/**
+ * Export metrics snapshot to Prometheus text format
+ *
+ * @param snapshot - Metrics snapshot from MetricsRegistry.getSnapshot()
+ * @param options - Export options
+ * @returns Prometheus text exposition format string
+ *
+ * @example
+ * ```typescript
+ * const metrics = getMetrics()
+ * const snapshot = metrics.getSnapshot()
+ * const prometheusText = exportToPrometheus(snapshot)
+ * // Returns:
+ * // # HELP skillsmith_mcp_request_total Total number of MCP tool requests
+ * // # TYPE skillsmith_mcp_request_total counter
+ * // skillsmith_mcp_request_total 42
+ * ```
+ */
+export declare function exportToPrometheus(snapshot: MetricsSnapshot, options?: PrometheusExportOptions): string;
+/**
+ * Get current metrics in Prometheus format
+ * Convenience function that combines getSnapshot() and exportToPrometheus()
+ *
+ * @param options - Export options
+ * @returns Prometheus text exposition format string
+ *
+ * @example
+ * ```typescript
+ * // In an HTTP handler:
+ * app.get('/metrics', (req, res) => {
+ *   res.set('Content-Type', 'text/plain; version=0.0.4')
+ *   res.send(getPrometheusMetrics())
+ * })
+ * ```
+ */
+export declare function getPrometheusMetrics(options?: PrometheusExportOptions): string;
+/**
+ * Prometheus HTTP endpoint handler
+ *
+ * Creates a handler function suitable for Express/Koa/etc.
+ *
+ * @param options - Export options
+ * @returns Handler function (req, res) => void
+ *
+ * @example
+ * ```typescript
+ * // Express
+ * import express from 'express'
+ * import { createPrometheusHandler } from '@skillsmith/core'
+ *
+ * const app = express()
+ * app.get('/metrics', createPrometheusHandler())
+ * ```
+ */
+export declare function createPrometheusHandler(options?: PrometheusExportOptions): (req: unknown, res: {
+    set: (k: string, v: string) => void;
+    send: (body: string) => void;
+}) => void;
+//# sourceMappingURL=prometheus.d.ts.map

package/dist/telemetry/prometheus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prometheus.d.ts","sourceRoot":"","sources":["../../src/telemetry/prometheus.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA;AAiBnD;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,qDAAqD;IACrD,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB,kDAAkD;IAClD,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,0CAA0C;IAC1C,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACrC,kEAAkE;IAClE,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAoID;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,eAAe,EACzB,OAAO,GAAE,uBAA4B,GACpC,MAAM,CAgER;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,GAAE,uBAA4B,GAAG,MAAM,CAIlF;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,GAAE,uBAA4B,GACpC,CACD,GAAG,EAAE,OAAO,EACZ,GAAG,EAAE;IAAE,GAAG,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAAC,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;CAAE,KACvE,IAAI,CAKR"}

package/dist/telemetry/prometheus.js

@@ -0,0 +1,252 @@
+/**
+ * SMI-1018: Prometheus Metrics Exporter
+ *
+ * Exports Skillsmith metrics in Prometheus text exposition format.
+ * Integrates with existing MetricsRegistry for monitoring dashboards.
+ *
+ * @see https://prometheus.io/docs/instrumenting/exposition_formats/
+ */
+import { getMetrics } from './metrics.js';
+/**
+ * Metric descriptions for Prometheus HELP text
+ */
+const METRIC_DESCRIPTIONS = {
+    'skillsmith.mcp.request.latency': {
+        name: 'skillsmith_mcp_request_latency_ms',
+        type: 'histogram',
+        help: 'Latency of MCP tool requests in milliseconds',
+    },
+    'skillsmith.mcp.request.count': {
+        name: 'skillsmith_mcp_request_total',
+        type: 'counter',
+        help: 'Total number of MCP tool requests',
+    },
+    'skillsmith.mcp.error.count': {
+        name: 'skillsmith_mcp_errors_total',
+        type: 'counter',
+        help: 'Total number of MCP tool errors',
+    },
+    'skillsmith.db.query.latency': {
+        name: 'skillsmith_db_query_latency_ms',
+        type: 'histogram',
+        help: 'Latency of database queries in milliseconds',
+    },
+    'skillsmith.db.query.count': {
+        name: 'skillsmith_db_query_total',
+        type: 'counter',
+        help: 'Total number of database queries',
+    },
+    'skillsmith.cache.hits': {
+        name: 'skillsmith_cache_hits_total',
+        type: 'counter',
+        help: 'Total number of cache hits',
+    },
+    'skillsmith.cache.misses': {
+        name: 'skillsmith_cache_misses_total',
+        type: 'counter',
+        help: 'Total number of cache misses',
+    },
+    'skillsmith.cache.size': {
+        name: 'skillsmith_cache_entries',
+        type: 'gauge',
+        help: 'Current number of entries in cache',
+    },
+    'skillsmith.embedding.latency': {
+        name: 'skillsmith_embedding_latency_ms',
+        type: 'histogram',
+        help: 'Latency of embedding generation in milliseconds',
+    },
+    'skillsmith.embedding.count': {
+        name: 'skillsmith_embedding_total',
+        type: 'counter',
+        help: 'Total number of embeddings generated',
+    },
+    'skillsmith.search.latency': {
+        name: 'skillsmith_search_latency_ms',
+        type: 'histogram',
+        help: 'Latency of search operations in milliseconds',
+    },
+    'skillsmith.search.count': {
+        name: 'skillsmith_search_total',
+        type: 'counter',
+        help: 'Total number of search operations',
+    },
+    'skillsmith.operations.active': {
+        name: 'skillsmith_operations_active',
+        type: 'gauge',
+        help: 'Number of currently active operations',
+    },
+    // Rate limiting metrics (from security module)
+    'skillsmith.rate_limit.allowed': {
+        name: 'skillsmith_rate_limit_allowed_total',
+        type: 'counter',
+        help: 'Total number of requests allowed by rate limiter',
+    },
+    'skillsmith.rate_limit.blocked': {
+        name: 'skillsmith_rate_limit_blocked_total',
+        type: 'counter',
+        help: 'Total number of requests blocked by rate limiter',
+    },
+    // Audit metrics
+    'skillsmith.audit.events': {
+        name: 'skillsmith_audit_events_total',
+        type: 'counter',
+        help: 'Total number of audit events logged',
+    },
+    // Security scan metrics
+    'skillsmith.security_scan.count': {
+        name: 'skillsmith_security_scan_total',
+        type: 'counter',
+        help: 'Total number of security scans performed',
+    },
+    'skillsmith.security_scan.findings': {
+        name: 'skillsmith_security_scan_findings_total',
+        type: 'counter',
+        help: 'Total number of security findings detected',
+    },
+};
+/**
+ * Convert internal metric name to Prometheus format
+ * - Replace dots with underscores
+ * - Apply prefix if provided
+ */
+function toPrometheusName(internalName, prefix) {
+    const meta = METRIC_DESCRIPTIONS[internalName];
+    const baseName = meta?.name ?? internalName.replace(/\./g, '_');
+    return prefix ? `${prefix}_${baseName}` : baseName;
+}
+/**
+ * Format labels as Prometheus label string
+ */
+function formatLabels(labels) {
+    if (!labels || Object.keys(labels).length === 0) {
+        return '';
+    }
+    const pairs = Object.entries(labels)
+        .map(([k, v]) => `${k}="${escapeLabel(v)}"`)
+        .join(',');
+    return `{${pairs}}`;
+}
+/**
+ * Escape label values for Prometheus format
+ */
+function escapeLabel(value) {
+    return value.replace(/\\/g, '\\\\').replace(/"/g, '\\"').replace(/\n/g, '\\n');
+}
+/**
+ * Export metrics snapshot to Prometheus text format
+ *
+ * @param snapshot - Metrics snapshot from MetricsRegistry.getSnapshot()
+ * @param options - Export options
+ * @returns Prometheus text exposition format string
+ *
+ * @example
+ * ```typescript
+ * const metrics = getMetrics()
+ * const snapshot = metrics.getSnapshot()
+ * const prometheusText = exportToPrometheus(snapshot)
+ * // Returns:
+ * // # HELP skillsmith_mcp_request_total Total number of MCP tool requests
+ * // # TYPE skillsmith_mcp_request_total counter
+ * // skillsmith_mcp_request_total 42
+ * ```
+ */
+export function exportToPrometheus(snapshot, options = {}) {
+    const { includeMetadata = true, prefix, globalLabels, timestamp } = options;
+    const lines = [];
+    // Process counters
+    for (const [name, value] of Object.entries(snapshot.counters)) {
+        const promName = toPrometheusName(name, prefix);
+        const meta = METRIC_DESCRIPTIONS[name];
+        if (includeMetadata && meta) {
+            lines.push(`# HELP ${promName} ${meta.help}`);
+            lines.push(`# TYPE ${promName} counter`);
+        }
+        const labels = formatLabels(globalLabels);
+        const ts = timestamp ? ` ${timestamp}` : '';
+        lines.push(`${promName}${labels} ${value}${ts}`);
+        lines.push(''); // Blank line between metrics
+    }
+    // Process histograms
+    for (const [name, stats] of Object.entries(snapshot.histograms)) {
+        const promName = toPrometheusName(name, prefix);
+        const meta = METRIC_DESCRIPTIONS[name];
+        const ts = timestamp ? ` ${timestamp}` : '';
+        if (includeMetadata && meta) {
+            lines.push(`# HELP ${promName} ${meta.help}`);
+            lines.push(`# TYPE ${promName} histogram`);
+        }
+        // Export histogram summary stats as gauges (since we don't have actual buckets)
+        const baseLabels = globalLabels ? formatLabels(globalLabels) : '';
+        lines.push(`${promName}_count${baseLabels} ${stats.count}${ts}`);
+        lines.push(`${promName}_sum${baseLabels} ${stats.sum}${ts}`);
+        // Export percentiles as quantiles
+        const p50Labels = formatLabels({ ...globalLabels, quantile: '0.5' });
+        const p95Labels = formatLabels({ ...globalLabels, quantile: '0.95' });
+        const p99Labels = formatLabels({ ...globalLabels, quantile: '0.99' });
+        lines.push(`${promName}${p50Labels} ${stats.p50}${ts}`);
+        lines.push(`${promName}${p95Labels} ${stats.p95}${ts}`);
+        lines.push(`${promName}${p99Labels} ${stats.p99}${ts}`);
+        lines.push('');
+    }
+    // Process gauges
+    for (const [name, value] of Object.entries(snapshot.gauges)) {
+        const promName = toPrometheusName(name, prefix);
+        const meta = METRIC_DESCRIPTIONS[name];
+        if (includeMetadata && meta) {
+            lines.push(`# HELP ${promName} ${meta.help}`);
+            lines.push(`# TYPE ${promName} gauge`);
+        }
+        const labels = formatLabels(globalLabels);
+        const ts = timestamp ? ` ${timestamp}` : '';
+        lines.push(`${promName}${labels} ${value}${ts}`);
+        lines.push('');
+    }
+    return lines.join('\n').trim();
+}
+/**
+ * Get current metrics in Prometheus format
+ * Convenience function that combines getSnapshot() and exportToPrometheus()
+ *
+ * @param options - Export options
+ * @returns Prometheus text exposition format string
+ *
+ * @example
+ * ```typescript
+ * // In an HTTP handler:
+ * app.get('/metrics', (req, res) => {
+ *   res.set('Content-Type', 'text/plain; version=0.0.4')
+ *   res.send(getPrometheusMetrics())
+ * })
+ * ```
+ */
+export function getPrometheusMetrics(options = {}) {
+    const metrics = getMetrics();
+    const snapshot = metrics.getSnapshot();
+    return exportToPrometheus(snapshot, options);
+}
+/**
+ * Prometheus HTTP endpoint handler
+ *
+ * Creates a handler function suitable for Express/Koa/etc.
+ *
+ * @param options - Export options
+ * @returns Handler function (req, res) => void
+ *
+ * @example
+ * ```typescript
+ * // Express
+ * import express from 'express'
+ * import { createPrometheusHandler } from '@skillsmith/core'
+ *
+ * const app = express()
+ * app.get('/metrics', createPrometheusHandler())
+ * ```
+ */
+export function createPrometheusHandler(options = {}) {
+    return (_req, res) => {
+        res.set('Content-Type', 'text/plain; version=0.0.4; charset=utf-8');
+        res.send(getPrometheusMetrics(options));
+    };
+}
+//# sourceMappingURL=prometheus.js.map

package/dist/telemetry/prometheus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prometheus.js","sourceRoot":"","sources":["../../src/telemetry/prometheus.ts"],"names":[],"mappings":"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"}

package/dist/telemetry/span-utils.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Span utility classes for Skillsmith Tracer
+ * @module @skillsmith/core/telemetry/span-utils
+ */
+import type { Span, SpanAttributes, SpanWrapper } from './tracer-types.js';
+/**
+ * No-op span wrapper for when tracing is disabled
+ */
+export declare class NoOpSpanWrapper implements SpanWrapper {
+    setAttributes(_attributes: SpanAttributes): void;
+    setStatus(_code: 'ok' | 'error', _message?: string): void;
+    recordException(_error: Error): void;
+    addEvent(_name: string, _attributes?: SpanAttributes): void;
+    end(): void;
+    getSpan(): Span | null;
+}
+/**
+ * Active span wrapper with real OTEL span
+ */
+export declare class ActiveSpanWrapper implements SpanWrapper {
+    private span;
+    constructor(span: Span);
+    setAttributes(attributes: SpanAttributes): void;
+    setStatus(code: 'ok' | 'error', message?: string): void;
+    recordException(error: Error): void;
+    addEvent(name: string, attributes?: SpanAttributes): void;
+    end(): void;
+    getSpan(): Span;
+}
+//# sourceMappingURL=span-utils.d.ts.map

package/dist/telemetry/span-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"span-utils.d.ts","sourceRoot":"","sources":["../../src/telemetry/span-utils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,cAAc,EAAkB,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAE1F;;GAEG;AACH,qBAAa,eAAgB,YAAW,WAAW;IACjD,aAAa,CAAC,WAAW,EAAE,cAAc,GAAG,IAAI;IAChD,SAAS,CAAC,KAAK,EAAE,IAAI,GAAG,OAAO,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI;IACzD,eAAe,CAAC,MAAM,EAAE,KAAK,GAAG,IAAI;IACpC,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,cAAc,GAAG,IAAI;IAC3D,GAAG,IAAI,IAAI;IACX,OAAO,IAAI,IAAI,GAAG,IAAI;CAGvB;AAED;;GAEG;AACH,qBAAa,iBAAkB,YAAW,WAAW;IACvC,OAAO,CAAC,IAAI;gBAAJ,IAAI,EAAE,IAAI;IAE9B,aAAa,CAAC,UAAU,EAAE,cAAc,GAAG,IAAI;IAW/C,SAAS,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI;IAKvD,eAAe,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IAInC,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,cAAc,GAAG,IAAI;IAazD,GAAG,IAAI,IAAI;IAIX,OAAO,IAAI,IAAI;CAGhB"}

package/dist/telemetry/span-utils.js

@@ -0,0 +1,62 @@
+/**
+ * Span utility classes for Skillsmith Tracer
+ * @module @skillsmith/core/telemetry/span-utils
+ */
+/**
+ * No-op span wrapper for when tracing is disabled
+ */
+export class NoOpSpanWrapper {
+    setAttributes(_attributes) { }
+    setStatus(_code, _message) { }
+    recordException(_error) { }
+    addEvent(_name, _attributes) { }
+    end() { }
+    getSpan() {
+        return null;
+    }
+}
+/**
+ * Active span wrapper with real OTEL span
+ */
+export class ActiveSpanWrapper {
+    span;
+    constructor(span) {
+        this.span = span;
+    }
+    setAttributes(attributes) {
+        // Filter out undefined values
+        const filtered = {};
+        for (const [key, value] of Object.entries(attributes)) {
+            if (value !== undefined) {
+                filtered[key] = value;
+            }
+        }
+        this.span.setAttributes(filtered);
+    }
+    setStatus(code, message) {
+        const statusCode = code === 'ok' ? 1 : 2; // SpanStatusCode.OK = 1, ERROR = 2
+        this.span.setStatus({ code: statusCode, message });
+    }
+    recordException(error) {
+        this.span.recordException(error);
+    }
+    addEvent(name, attributes) {
+        // Filter out undefined values
+        const filtered = {};
+        if (attributes) {
+            for (const [key, value] of Object.entries(attributes)) {
+                if (value !== undefined) {
+                    filtered[key] = value;
+                }
+            }
+        }
+        this.span.addEvent(name, filtered);
+    }
+    end() {
+        this.span.end();
+    }
+    getSpan() {
+        return this.span;
+    }
+}
+//# sourceMappingURL=span-utils.js.map

package/dist/telemetry/span-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"span-utils.js","sourceRoot":"","sources":["../../src/telemetry/span-utils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH;;GAEG;AACH,MAAM,OAAO,eAAe;IAC1B,aAAa,CAAC,WAA2B,IAAS,CAAC;IACnD,SAAS,CAAC,KAAqB,EAAE,QAAiB,IAAS,CAAC;IAC5D,eAAe,CAAC,MAAa,IAAS,CAAC;IACvC,QAAQ,CAAC,KAAa,EAAE,WAA4B,IAAS,CAAC;IAC9D,GAAG,KAAU,CAAC;IACd,OAAO;QACL,OAAO,IAAI,CAAA;IACb,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,iBAAiB;IACR;IAApB,YAAoB,IAAU;QAAV,SAAI,GAAJ,IAAI,CAAM;IAAG,CAAC;IAElC,aAAa,CAAC,UAA0B;QACtC,8BAA8B;QAC9B,MAAM,QAAQ,GAAgF,EAAE,CAAA;QAChG,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;YACtD,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;gBACxB,QAAQ,CAAC,GAAG,CAAC,GAAG,KAAK,CAAA;YACvB,CAAC;QACH,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAA;IACnC,CAAC;IAED,SAAS,CAAC,IAAoB,EAAE,OAAgB;QAC9C,MAAM,UAAU,GAAmB,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA,CAAC,mCAAmC;QAC5F,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC,CAAA;IACpD,CAAC;IAED,eAAe,CAAC,KAAY;QAC1B,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,CAAA;IAClC,CAAC;IAED,QAAQ,CAAC,IAAY,EAAE,UAA2B;QAChD,8BAA8B;QAC9B,MAAM,QAAQ,GAAgF,EAAE,CAAA;QAChG,IAAI,UAAU,EAAE,CAAC;YACf,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;gBACtD,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;oBACxB,QAAQ,CAAC,GAAG,CAAC,GAAG,KAAK,CAAA;gBACvB,CAAC;YACH,CAAC;QACH,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAA;IACpC,CAAC;IAED,GAAG;QACD,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,CAAA;IACjB,CAAC;IAED,OAAO;QACL,OAAO,IAAI,CAAC,IAAI,CAAA;IAClB,CAAC;CACF"}