autotel 3.5.0 → 3.7.0

package/dist/chunk-TC5ZPWM4.cjs

@@ -1,289 +0,0 @@
-'use strict';
-
-var chunkESLWRGAG_cjs = require('./chunk-ESLWRGAG.cjs');
-require('@opentelemetry/api');
-
-var Metric = class {
-  serviceName;
-  eventCounter;
-  funnelCounter;
-  outcomeCounter;
-  valueHistogram;
-  logger;
-  collector;
-  /**
-   * Create a new Metrics instance
-   *
-   * @param serviceName - Service name for metric namespacing
-   * @param options - Optional configuration (logger, collector, namespace, metrics)
-   *
-   * @example Basic usage (default 'metrics' namespace)
-   * ```typescript
-   * const metrics = new Metric('checkout');
-   * // Creates: checkout.metrics.events, checkout.metrics.funnel, etc.
-   * ```
-   *
-   * @example Custom namespace
-   * ```typescript
-   * const metrics = new Metric('api', { namespace: 'business' });
-   * // Creates: api.business.events, api.business.funnel, etc.
-   * ```
-   *
-   * @example Custom metric names and descriptions
-   * ```typescript
-   * const metrics = new Metric('payments', {
-   *   metrics: {
-   *     outcomes: {
-   *       name: 'payments.transactions',
-   *       description: 'Payment transaction outcomes',
-   *       unit: 'transactions'
-   *     },
-   *     value: {
-   *       name: 'payments.revenue',
-   *       description: 'Payment revenue in USD',
-   *       unit: 'USD'
-   *     }
-   *   }
-   * });
-   * ```
-   */
-  constructor(serviceName, options = {}) {
-    this.serviceName = serviceName;
-    this.logger = options.logger;
-    this.collector = options.collector;
-    const config = chunkESLWRGAG_cjs.getConfig();
-    const meter = config.meter;
-    const namespace = options.namespace || "metrics";
-    const metricsConfig = options.metrics || {};
-    const eventsConfig = metricsConfig.events || {};
-    this.eventCounter = meter.createCounter(
-      eventsConfig.name || `${serviceName}.${namespace}.events`,
-      {
-        description: eventsConfig.description || "Count of business events",
-        unit: eventsConfig.unit || "1"
-      }
-    );
-    const funnelConfig = metricsConfig.funnel || {};
-    this.funnelCounter = meter.createCounter(
-      funnelConfig.name || `${serviceName}.${namespace}.funnel`,
-      {
-        description: funnelConfig.description || "Conversion funnel tracking",
-        unit: funnelConfig.unit || "1"
-      }
-    );
-    const outcomesConfig = metricsConfig.outcomes || {};
-    this.outcomeCounter = meter.createCounter(
-      outcomesConfig.name || `${serviceName}.${namespace}.outcomes`,
-      {
-        description: outcomesConfig.description || "Outcome tracking (success/failure)",
-        unit: outcomesConfig.unit || "1"
-      }
-    );
-    const valueConfig = metricsConfig.value || {};
-    this.valueHistogram = meter.createHistogram(
-      valueConfig.name || `${serviceName}.${namespace}.value`,
-      {
-        description: valueConfig.description || "Value metrics (revenue, counts, etc.)",
-        unit: valueConfig.unit || "1"
-      }
-    );
-  }
-  /**
-   * Track a business event as a metric
-   *
-   * Use this for tracking user actions, business events, product usage as metrics:
-   * - "user.signup"
-   * - "order.completed"
-   * - "feature.used"
-   *
-   * @example
-   * ```typescript
-   * // Track user signup as metric
-   * metrics.trackEvent('user.signup', {
-   *   userId: '123',
-   *   plan: 'pro'
-   * })
-   *
-   * // Track order as metric
-   * metrics.trackEvent('order.completed', {
-   *   orderId: 'ord_123',
-   *   amount: 99.99
-   * })
-   * ```
-   */
-  trackEvent(eventName, attributes) {
-    const attrs = {
-      service: this.serviceName,
-      event: eventName,
-      ...attributes
-    };
-    this.eventCounter.add(1, attrs);
-    this.logger?.info(
-      {
-        event: eventName,
-        attributes
-      },
-      "Metric event tracked"
-    );
-    this.collector?.recordEvent({
-      event: eventName,
-      attributes,
-      service: this.serviceName,
-      timestamp: Date.now()
-    });
-  }
-  /**
-   * Track conversion funnel steps as metrics
-   *
-   * Monitor where users drop off in multi-step processes.
-   *
-   * @example
-   * ```typescript
-   * // Track signup funnel
-   * metrics.trackFunnelStep('signup', 'started', { userId: '123' })
-   * metrics.trackFunnelStep('signup', 'email_verified', { userId: '123' })
-   * metrics.trackFunnelStep('signup', 'completed', { userId: '123' })
-   *
-   * // Track checkout flow
-   * metrics.trackFunnelStep('checkout', 'started', { cartValue: 99.99 })
-   * metrics.trackFunnelStep('checkout', 'payment_info', { cartValue: 99.99 })
-   * metrics.trackFunnelStep('checkout', 'completed', { cartValue: 99.99 })
-   * ```
-   */
-  trackFunnelStep(funnelName, status, attributes) {
-    const attrs = {
-      service: this.serviceName,
-      funnel: funnelName,
-      status,
-      ...attributes
-    };
-    this.funnelCounter.add(1, attrs);
-    this.logger?.info(
-      {
-        funnel: funnelName,
-        status,
-        attributes
-      },
-      "Funnel step tracked"
-    );
-    this.collector?.recordFunnelStep({
-      funnel: funnelName,
-      status,
-      attributes,
-      service: this.serviceName,
-      timestamp: Date.now()
-    });
-  }
-  /**
-   * Track outcomes (success/failure/partial) as metrics
-   *
-   * Monitor success rates of critical operations.
-   *
-   * @example
-   * ```typescript
-   * // Track email delivery
-   * metrics.trackOutcome('email.delivery', 'success', {
-   *   recipientType: 'user',
-   *   emailType: 'welcome'
-   * })
-   *
-   * metrics.trackOutcome('email.delivery', 'failure', {
-   *   recipientType: 'user',
-   *   errorCode: 'invalid_email'
-   * })
-   *
-   * // Track payment processing
-   * metrics.trackOutcome('payment.process', 'success', { amount: 99.99 })
-   * metrics.trackOutcome('payment.process', 'failure', { error: 'insufficient_funds' })
-   * ```
-   */
-  trackOutcome(operationName, status, attributes) {
-    const attrs = {
-      service: this.serviceName,
-      operation: operationName,
-      status,
-      ...attributes
-    };
-    this.outcomeCounter.add(1, attrs);
-    this.logger?.info(
-      {
-        operation: operationName,
-        status,
-        attributes
-      },
-      "Outcome tracked"
-    );
-    this.collector?.recordOutcome({
-      operation: operationName,
-      status,
-      attributes,
-      service: this.serviceName,
-      timestamp: Date.now()
-    });
-  }
-  /**
-   * Track value metrics
-   *
-   * Record numerical values like revenue, transaction amounts,
-   * item counts, processing times, engagement scores, etc.
-   *
-   * @example
-   * ```typescript
-   * // Track revenue
-   * metrics.trackValue('order.revenue', 149.99, {
-   *   currency: 'USD',
-   *   productCategory: 'electronics'
-   * })
-   *
-   * // Track items per cart
-   * metrics.trackValue('cart.item_count', 5, {
-   *   userId: '123'
-   * })
-   *
-   * // Track processing time
-   * metrics.trackValue('api.response_time', 250, {
-   *   unit: 'ms',
-   *   endpoint: '/api/checkout'
-   * })
-   * ```
-   */
-  trackValue(metricName, value, attributes) {
-    const attrs = {
-      service: this.serviceName,
-      metric: metricName,
-      ...attributes
-    };
-    this.valueHistogram.record(value, attrs);
-    this.logger?.debug(
-      {
-        metric: metricName,
-        value,
-        attributes
-      },
-      "Value metric tracked"
-    );
-    this.collector?.recordValue({
-      metric: metricName,
-      value,
-      attributes,
-      service: this.serviceName,
-      timestamp: Date.now()
-    });
-  }
-};
-var metricsInstances = /* @__PURE__ */ new Map();
-function getMetrics(serviceName, logger) {
-  if (!metricsInstances.has(serviceName)) {
-    metricsInstances.set(serviceName, new Metric(serviceName, { logger }));
-  }
-  return metricsInstances.get(serviceName);
-}
-function resetMetrics() {
-  metricsInstances.clear();
-}
-
-exports.Metric = Metric;
-exports.getMetrics = getMetrics;
-exports.resetMetrics = resetMetrics;
-//# sourceMappingURL=chunk-TC5ZPWM4.cjs.map
-//# sourceMappingURL=chunk-TC5ZPWM4.cjs.map

package/dist/chunk-TC5ZPWM4.cjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/metric.ts"],"names":["getConfig"],"mappings":"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","file":"chunk-TC5ZPWM4.cjs","sourcesContent":["/**\n * Metrics API for OpenTelemetry\n *\n * Track business metrics for OpenTelemetry (Prometheus/Grafana).\n * For business people who think in metrics.\n *\n * @example Track business metrics\n * ```typescript\n * const metrics = new Metric('checkout')\n *\n * // Track events as metrics\n * metrics.trackEvent('order.completed', {\n *   amount: 99.99,\n *   currency: 'USD'\n * })\n *\n * // Track conversion funnels\n * metrics.trackFunnelStep('checkout', 'started', { cartValue: 99.99 })\n * metrics.trackFunnelStep('checkout', 'completed', { cartValue: 99.99 })\n *\n * // Track outcomes\n * metrics.trackOutcome('payment.process', 'success', { amount: 99.99 })\n * metrics.trackOutcome('payment.process', 'failure', { error: 'insufficient_funds' })\n *\n * // Track values\n * metrics.trackValue('revenue', 149.99, { currency: 'USD' })\n * ```\n */\n\nimport {\n  type Counter,\n  type Histogram,\n  type Attributes,\n} from '@opentelemetry/api';\nimport { getConfig } from './config';\nimport { type Logger } from './logger';\nimport {\n  type EventAttributes,\n  type FunnelStatus,\n  type OutcomeStatus,\n} from './event-subscriber';\nimport { type MetricsCollector } from './metric-testing';\n\n// Re-export types for convenience\nexport type {\n  EventAttributes,\n  FunnelStatus,\n  OutcomeStatus,\n} from './event-subscriber';\n\n/**\n * Metrics class for tracking business metrics in OpenTelemetry\n *\n * Track critical business indicators such as:\n * - User events (signups, purchases, feature usage) as metrics\n * - Conversion funnels (signup → activation → purchase)\n * - Business outcomes (success/failure rates)\n * - Value metrics (revenue, counts, etc.)\n *\n * All metrics are sent to OpenTelemetry (OTLP/Prometheus/Grafana).\n */\n/**\n * Metric configuration for customizing metric names and descriptions\n */\nexport interface MetricConfig {\n  /** Metric name (e.g., 'metrics.events' or 'custom.events') */\n  name?: string;\n  /** Metric description */\n  description?: string;\n  /** Metric unit (default: '1') */\n  unit?: string;\n}\n\n/**\n * Metrics options\n */\nexport interface MetricsOptions {\n  /** Optional logger for audit trail */\n  logger?: Logger;\n  /** Optional collector for testing (captures metrics in memory) */\n  collector?: MetricsCollector;\n\n  /**\n   * Namespace for metrics (default: 'metrics')\n   * Results in metrics like: {serviceName}.{namespace}.events\n   */\n  namespace?: string;\n\n  /**\n   * Custom metric configurations\n   * Override metric names, descriptions, and units\n   */\n  metrics?: {\n    events?: MetricConfig;\n    funnel?: MetricConfig;\n    outcomes?: MetricConfig;\n    value?: MetricConfig;\n  };\n}\n\nexport class Metric {\n  private serviceName: string;\n  private eventCounter: Counter;\n  private funnelCounter: Counter;\n  private outcomeCounter: Counter;\n  private valueHistogram: Histogram;\n  private logger?: Logger;\n  private collector?: MetricsCollector;\n\n  /**\n   * Create a new Metrics instance\n   *\n   * @param serviceName - Service name for metric namespacing\n   * @param options - Optional configuration (logger, collector, namespace, metrics)\n   *\n   * @example Basic usage (default 'metrics' namespace)\n   * ```typescript\n   * const metrics = new Metric('checkout');\n   * // Creates: checkout.metrics.events, checkout.metrics.funnel, etc.\n   * ```\n   *\n   * @example Custom namespace\n   * ```typescript\n   * const metrics = new Metric('api', { namespace: 'business' });\n   * // Creates: api.business.events, api.business.funnel, etc.\n   * ```\n   *\n   * @example Custom metric names and descriptions\n   * ```typescript\n   * const metrics = new Metric('payments', {\n   *   metrics: {\n   *     outcomes: {\n   *       name: 'payments.transactions',\n   *       description: 'Payment transaction outcomes',\n   *       unit: 'transactions'\n   *     },\n   *     value: {\n   *       name: 'payments.revenue',\n   *       description: 'Payment revenue in USD',\n   *       unit: 'USD'\n   *     }\n   *   }\n   * });\n   * ```\n   */\n  constructor(serviceName: string, options: MetricsOptions = {}) {\n    this.serviceName = serviceName;\n    this.logger = options.logger;\n    this.collector = options.collector;\n\n    const config = getConfig();\n    const meter = config.meter;\n\n    // Default namespace and metric configurations\n    const namespace = options.namespace || 'metrics';\n    const metricsConfig = options.metrics || {};\n\n    // Event counter configuration\n    const eventsConfig = metricsConfig.events || {};\n    this.eventCounter = meter.createCounter(\n      eventsConfig.name || `${serviceName}.${namespace}.events`,\n      {\n        description: eventsConfig.description || 'Count of business events',\n        unit: eventsConfig.unit || '1',\n      },\n    );\n\n    // Funnel counter configuration\n    const funnelConfig = metricsConfig.funnel || {};\n    this.funnelCounter = meter.createCounter(\n      funnelConfig.name || `${serviceName}.${namespace}.funnel`,\n      {\n        description: funnelConfig.description || 'Conversion funnel tracking',\n        unit: funnelConfig.unit || '1',\n      },\n    );\n\n    // Outcome counter configuration\n    const outcomesConfig = metricsConfig.outcomes || {};\n    this.outcomeCounter = meter.createCounter(\n      outcomesConfig.name || `${serviceName}.${namespace}.outcomes`,\n      {\n        description:\n          outcomesConfig.description || 'Outcome tracking (success/failure)',\n        unit: outcomesConfig.unit || '1',\n      },\n    );\n\n    // Value histogram configuration\n    const valueConfig = metricsConfig.value || {};\n    this.valueHistogram = meter.createHistogram(\n      valueConfig.name || `${serviceName}.${namespace}.value`,\n      {\n        description:\n          valueConfig.description || 'Value metrics (revenue, counts, etc.)',\n        unit: valueConfig.unit || '1',\n      },\n    );\n  }\n\n  /**\n   * Track a business event as a metric\n   *\n   * Use this for tracking user actions, business events, product usage as metrics:\n   * - \"user.signup\"\n   * - \"order.completed\"\n   * - \"feature.used\"\n   *\n   * @example\n   * ```typescript\n   * // Track user signup as metric\n   * metrics.trackEvent('user.signup', {\n   *   userId: '123',\n   *   plan: 'pro'\n   * })\n   *\n   * // Track order as metric\n   * metrics.trackEvent('order.completed', {\n   *   orderId: 'ord_123',\n   *   amount: 99.99\n   * })\n   * ```\n   */\n  trackEvent(eventName: string, attributes?: EventAttributes): void {\n    const attrs: Attributes = {\n      service: this.serviceName,\n      event: eventName,\n      ...attributes,\n    };\n\n    this.eventCounter.add(1, attrs);\n\n    this.logger?.info(\n      {\n        event: eventName,\n        attributes,\n      },\n      'Metric event tracked',\n    );\n\n    // Record for testing\n    this.collector?.recordEvent({\n      event: eventName,\n      attributes,\n      service: this.serviceName,\n      timestamp: Date.now(),\n    });\n  }\n\n  /**\n   * Track conversion funnel steps as metrics\n   *\n   * Monitor where users drop off in multi-step processes.\n   *\n   * @example\n   * ```typescript\n   * // Track signup funnel\n   * metrics.trackFunnelStep('signup', 'started', { userId: '123' })\n   * metrics.trackFunnelStep('signup', 'email_verified', { userId: '123' })\n   * metrics.trackFunnelStep('signup', 'completed', { userId: '123' })\n   *\n   * // Track checkout flow\n   * metrics.trackFunnelStep('checkout', 'started', { cartValue: 99.99 })\n   * metrics.trackFunnelStep('checkout', 'payment_info', { cartValue: 99.99 })\n   * metrics.trackFunnelStep('checkout', 'completed', { cartValue: 99.99 })\n   * ```\n   */\n  trackFunnelStep(\n    funnelName: string,\n    status: FunnelStatus,\n    attributes?: EventAttributes,\n  ): void {\n    const attrs: Attributes = {\n      service: this.serviceName,\n      funnel: funnelName,\n      status,\n      ...attributes,\n    };\n\n    this.funnelCounter.add(1, attrs);\n\n    this.logger?.info(\n      {\n        funnel: funnelName,\n        status,\n        attributes,\n      },\n      'Funnel step tracked',\n    );\n\n    // Record for testing\n    this.collector?.recordFunnelStep({\n      funnel: funnelName,\n      status,\n      attributes,\n      service: this.serviceName,\n      timestamp: Date.now(),\n    });\n  }\n\n  /**\n   * Track outcomes (success/failure/partial) as metrics\n   *\n   * Monitor success rates of critical operations.\n   *\n   * @example\n   * ```typescript\n   * // Track email delivery\n   * metrics.trackOutcome('email.delivery', 'success', {\n   *   recipientType: 'user',\n   *   emailType: 'welcome'\n   * })\n   *\n   * metrics.trackOutcome('email.delivery', 'failure', {\n   *   recipientType: 'user',\n   *   errorCode: 'invalid_email'\n   * })\n   *\n   * // Track payment processing\n   * metrics.trackOutcome('payment.process', 'success', { amount: 99.99 })\n   * metrics.trackOutcome('payment.process', 'failure', { error: 'insufficient_funds' })\n   * ```\n   */\n  trackOutcome(\n    operationName: string,\n    status: OutcomeStatus,\n    attributes?: EventAttributes,\n  ): void {\n    const attrs: Attributes = {\n      service: this.serviceName,\n      operation: operationName,\n      status,\n      ...attributes,\n    };\n\n    this.outcomeCounter.add(1, attrs);\n\n    this.logger?.info(\n      {\n        operation: operationName,\n        status,\n        attributes,\n      },\n      'Outcome tracked',\n    );\n\n    // Record for testing\n    this.collector?.recordOutcome({\n      operation: operationName,\n      status,\n      attributes,\n      service: this.serviceName,\n      timestamp: Date.now(),\n    });\n  }\n\n  /**\n   * Track value metrics\n   *\n   * Record numerical values like revenue, transaction amounts,\n   * item counts, processing times, engagement scores, etc.\n   *\n   * @example\n   * ```typescript\n   * // Track revenue\n   * metrics.trackValue('order.revenue', 149.99, {\n   *   currency: 'USD',\n   *   productCategory: 'electronics'\n   * })\n   *\n   * // Track items per cart\n   * metrics.trackValue('cart.item_count', 5, {\n   *   userId: '123'\n   * })\n   *\n   * // Track processing time\n   * metrics.trackValue('api.response_time', 250, {\n   *   unit: 'ms',\n   *   endpoint: '/api/checkout'\n   * })\n   * ```\n   */\n  trackValue(\n    metricName: string,\n    value: number,\n    attributes?: EventAttributes,\n  ): void {\n    const attrs: Attributes = {\n      service: this.serviceName,\n      metric: metricName,\n      ...attributes,\n    };\n\n    this.valueHistogram.record(value, attrs);\n\n    this.logger?.debug(\n      {\n        metric: metricName,\n        value,\n        attributes,\n      },\n      'Value metric tracked',\n    );\n\n    // Record for testing\n    this.collector?.recordValue({\n      metric: metricName,\n      value,\n      attributes,\n      service: this.serviceName,\n      timestamp: Date.now(),\n    });\n  }\n}\n\n/**\n * Global metrics instances (singleton pattern)\n */\nconst metricsInstances = new Map<string, Metric>();\n\n/**\n * Get or create a Metrics instance for a service\n *\n * @param serviceName - Service name for metric namespacing\n * @param logger - Optional logger\n * @returns Metrics instance\n *\n * @example\n * ```typescript\n * const metrics = getMetrics('checkout')\n * metrics.trackEvent('order.completed', { orderId: '123' })\n * ```\n */\nexport function getMetrics(serviceName: string, logger?: Logger): Metric {\n  if (!metricsInstances.has(serviceName)) {\n    metricsInstances.set(serviceName, new Metric(serviceName, { logger }));\n  }\n  return metricsInstances.get(serviceName)!;\n}\n\n/**\n * Reset all metrics instances (mainly for testing)\n */\nexport function resetMetrics(): void {\n  metricsInstances.clear();\n}\n"]}

package/dist/chunk-TQ5UWA7S.js

@@ -1,26 +0,0 @@
-import { getConfig } from './chunk-J5QENANM.js';
-
-// src/metric-helpers.ts
-function getActiveMeter() {
-  const config = getConfig();
-  return config.meter;
-}
-function getMeter() {
-  return getActiveMeter();
-}
-function createCounter(name, options) {
-  return getActiveMeter().createCounter(name, options);
-}
-function createHistogram(name, options) {
-  return getActiveMeter().createHistogram(name, options);
-}
-function createUpDownCounter(name, options) {
-  return getActiveMeter().createUpDownCounter(name, options);
-}
-function createObservableGauge(name, options) {
-  return getActiveMeter().createObservableGauge(name, options);
-}
-
-export { createCounter, createHistogram, createObservableGauge, createUpDownCounter, getMeter };
-//# sourceMappingURL=chunk-TQ5UWA7S.js.map
-//# sourceMappingURL=chunk-TQ5UWA7S.js.map

package/dist/chunk-TQ5UWA7S.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/metric-helpers.ts"],"names":[],"mappings":";;;AASA,SAAS,cAAA,GAAwB;AAC/B,EAAA,MAAM,SAAS,SAAA,EAAU;AACzB,EAAA,OAAO,MAAA,CAAO,KAAA;AAChB;AAEO,SAAS,QAAA,GAAkB;AAChC,EAAA,OAAO,cAAA,EAAe;AACxB;AAOO,SAAS,aAAA,CAAc,MAAc,OAAA,EAAmC;AAC7E,EAAA,OAAO,cAAA,EAAe,CAAE,aAAA,CAAc,IAAA,EAAM,OAAO,CAAA;AACrD;AAEO,SAAS,eAAA,CACd,MACA,OAAA,EACW;AACX,EAAA,OAAO,cAAA,EAAe,CAAE,eAAA,CAAgB,IAAA,EAAM,OAAO,CAAA;AACvD;AAEO,SAAS,mBAAA,CACd,MACA,OAAA,EACe;AACf,EAAA,OAAO,cAAA,EAAe,CAAE,mBAAA,CAAoB,IAAA,EAAM,OAAO,CAAA;AAC3D;AAEO,SAAS,qBAAA,CACd,MACA,OAAA,EACiB;AACjB,EAAA,OAAO,cAAA,EAAe,CAAE,qBAAA,CAAsB,IAAA,EAAM,OAAO,CAAA;AAC7D","file":"chunk-TQ5UWA7S.js","sourcesContent":["import type {\n  Counter,\n  Histogram,\n  Meter,\n  ObservableGauge,\n  UpDownCounter,\n} from '@opentelemetry/api';\nimport { getConfig } from './config';\n\nfunction getActiveMeter(): Meter {\n  const config = getConfig();\n  return config.meter;\n}\n\nexport function getMeter(): Meter {\n  return getActiveMeter();\n}\n\ntype CounterOptions = Parameters<Meter['createCounter']>[1];\ntype HistogramOptions = Parameters<Meter['createHistogram']>[1];\ntype UpDownCounterOptions = Parameters<Meter['createUpDownCounter']>[1];\ntype ObservableGaugeOptions = Parameters<Meter['createObservableGauge']>[1];\n\nexport function createCounter(name: string, options?: CounterOptions): Counter {\n  return getActiveMeter().createCounter(name, options);\n}\n\nexport function createHistogram(\n  name: string,\n  options?: HistogramOptions,\n): Histogram {\n  return getActiveMeter().createHistogram(name, options);\n}\n\nexport function createUpDownCounter(\n  name: string,\n  options?: UpDownCounterOptions,\n): UpDownCounter {\n  return getActiveMeter().createUpDownCounter(name, options);\n}\n\nexport function createObservableGauge(\n  name: string,\n  options?: ObservableGaugeOptions,\n): ObservableGauge {\n  return getActiveMeter().createObservableGauge(name, options);\n}\n"]}

package/dist/chunk-URHPSJW2.js

@@ -1,339 +0,0 @@
-import { emitCorrelatedEvent } from './chunk-KIL5CUN6.js';
-import { trace } from './chunk-YWCESU4Y.js';
-import { getActiveSpan } from './chunk-HT5JQKN2.js';
-import { AsyncLocalStorage } from 'async_hooks';
-
-var workflowStates = /* @__PURE__ */ new WeakMap();
-var workflowContextStorage = new AsyncLocalStorage();
-function traceWorkflow(config) {
-  const spanName = `workflow.${config.name}`;
-  return (fnFactory) => {
-    return trace(spanName, (baseCtx) => {
-      return async (...args) => {
-        const workflowId = typeof config.workflowId === "function" ? config.workflowId(...args) : config.workflowId;
-        const ctx = createWorkflowContext(baseCtx, config.name, workflowId);
-        ctx.setAttribute("workflow.name", config.name);
-        ctx.setAttribute("workflow.id", workflowId);
-        if (config.version) {
-          ctx.setAttribute("workflow.version", config.version);
-        }
-        ctx.setAttribute("workflow.status", "running");
-        if (config.attributes) {
-          for (const [key, value] of Object.entries(config.attributes)) {
-            if (value !== void 0) {
-              ctx.setAttribute(key, value);
-            }
-          }
-        }
-        return workflowContextStorage.run(ctx, async () => {
-          try {
-            const userFn = fnFactory(ctx);
-            const result = await userFn(...args);
-            ctx.setWorkflowStatus("completed");
-            config.onComplete?.(ctx, result);
-            return result;
-          } catch (error) {
-            ctx.setWorkflowStatus("failed");
-            config.onFailed?.(ctx, error);
-            const state = getWorkflowState();
-            if (state && state.compensations.size > 0) {
-              ctx.setWorkflowStatus("compensating");
-              config.onCompensating?.(ctx);
-              try {
-                await ctx.compensate(error);
-                ctx.setWorkflowStatus("compensated");
-              } catch (compensationError) {
-                ctx.setWorkflowStatus("compensation_failed");
-                ctx.setAttribute(
-                  "workflow.compensation.error",
-                  String(compensationError)
-                );
-              }
-            }
-            throw error;
-          }
-        });
-      };
-    });
-  };
-}
-function traceStep(config) {
-  return (fn) => {
-    const spanName = `step.${config.name}`;
-    return trace(spanName, (baseCtx) => {
-      return async (...args) => {
-        const workflowCtx = workflowContextStorage.getStore() ?? null;
-        const ctx = createStepContext(baseCtx, config, workflowCtx);
-        ctx.setAttribute("workflow.step.name", config.name);
-        ctx.setAttribute("workflow.step.index", ctx.getStepIndex());
-        ctx.setAttribute("workflow.step.status", "running");
-        if (config.description) {
-          ctx.setAttribute("workflow.step.description", config.description);
-        }
-        if (config.idempotent) {
-          ctx.setAttribute("workflow.step.idempotent", true);
-        }
-        if (config.attributes) {
-          for (const [key, value] of Object.entries(config.attributes)) {
-            if (value !== void 0) {
-              ctx.setAttribute(key, value);
-            }
-          }
-        }
-        await addStepLinks(ctx, config, workflowCtx);
-        if (config.compensate && workflowCtx) {
-          workflowCtx.registerCompensation(config.name, config.compensate);
-        }
-        let lastError;
-        const maxAttempts = config.retry?.maxAttempts ?? 1;
-        for (let attempt = 1; attempt <= maxAttempts; attempt++) {
-          try {
-            if (attempt > 1) {
-              ctx.setAttribute("workflow.step.retry_attempt", attempt);
-              emitCorrelatedEvent(ctx, "step_retry", {
-                "workflow.step.attempt": attempt,
-                "workflow.step.max_attempts": maxAttempts
-              });
-              if (config.retry?.backoffMs) {
-                await sleep(config.retry.backoffMs * attempt);
-              }
-            }
-            const result = await fn(...args);
-            ctx.setAttribute("workflow.step.status", "completed");
-            ctx.complete();
-            config.onComplete?.(ctx);
-            return result;
-          } catch (error) {
-            lastError = error;
-            if (attempt < maxAttempts) {
-              emitCorrelatedEvent(ctx, "step_retry_scheduled", {
-                "workflow.step.error": String(error),
-                "workflow.step.attempt": attempt
-              });
-            }
-          }
-        }
-        ctx.setAttribute("workflow.step.status", "failed");
-        ctx.setAttribute("workflow.step.error", String(lastError));
-        config.onFailed?.(ctx, lastError);
-        throw lastError;
-      };
-    });
-  };
-}
-function createWorkflowContext(baseCtx, workflowName, workflowId) {
-  const span = getActiveSpan();
-  const state = {
-    workflowId,
-    workflowName,
-    status: "running",
-    steps: /* @__PURE__ */ new Map(),
-    stepCounter: 0,
-    compensations: /* @__PURE__ */ new Map()
-  };
-  if (span) {
-    workflowStates.set(span, state);
-  }
-  return {
-    ...baseCtx,
-    getWorkflowId() {
-      return workflowId;
-    },
-    getWorkflowName() {
-      return workflowName;
-    },
-    getStatus() {
-      return state.status;
-    },
-    completeStep(stepName) {
-      let step = state.steps.get(stepName);
-      if (!step) {
-        step = {
-          name: stepName,
-          index: state.stepCounter++,
-          status: "pending",
-          startTime: Date.now()
-        };
-        state.steps.set(stepName, step);
-      }
-      step.status = "completed";
-      step.endTime = Date.now();
-      const currentSpan = getActiveSpan();
-      if (currentSpan) {
-        step.spanContext = currentSpan.spanContext();
-      }
-    },
-    getPreviousStep(stepName) {
-      if (stepName) {
-        const step = state.steps.get(stepName);
-        return step?.spanContext ?? null;
-      }
-      let lastStep = null;
-      for (const step of state.steps.values()) {
-        if (step.status === "completed" && (!lastStep || step.index > lastStep.index)) {
-          lastStep = step;
-        }
-      }
-      return lastStep?.spanContext ?? null;
-    },
-    getCompletedSteps() {
-      const completed = [];
-      for (const [name, step] of state.steps) {
-        if (step.status === "completed") {
-          completed.push(name);
-        }
-      }
-      return completed.toSorted(
-        (a, b) => (state.steps.get(a)?.index ?? 0) - (state.steps.get(b)?.index ?? 0)
-      );
-    },
-    registerCompensation(stepName, handler) {
-      state.compensations.set(stepName, handler);
-    },
-    async compensate(error) {
-      const compensationOrder = [...state.compensations.entries()].toReversed();
-      for (const [stepName, handler] of compensationOrder) {
-        const step = state.steps.get(stepName);
-        if (step && step.status === "completed") {
-          try {
-            emitCorrelatedEvent(baseCtx, "compensation_started", {
-              "workflow.step.name": stepName
-            });
-            await Promise.resolve(handler(error));
-            this.recordCompensation(stepName, true);
-            step.status = "compensated";
-          } catch (compensationError) {
-            this.recordCompensation(
-              stepName,
-              false,
-              compensationError
-            );
-            throw compensationError;
-          }
-        }
-      }
-    },
-    recordCompensation(stepName, success, error) {
-      emitCorrelatedEvent(baseCtx, "compensation_completed", {
-        "workflow.step.name": stepName,
-        "workflow.compensation.success": success,
-        ...error && { "workflow.compensation.error": String(error) }
-      });
-      baseCtx.setAttribute(
-        `workflow.compensation.${stepName}`,
-        success ? "success" : "failed"
-      );
-    },
-    setWorkflowStatus(status) {
-      state.status = status;
-      baseCtx.setAttribute("workflow.status", status);
-      emitCorrelatedEvent(baseCtx, "workflow_status_changed", {
-        "workflow.status": status
-      });
-    }
-  };
-}
-function createStepContext(baseCtx, config, workflowCtx) {
-  let stepIndex = config.index ?? 0;
-  if (workflowCtx) {
-    const span = getActiveSpan();
-    if (span) {
-      const state = workflowStates.get(span);
-      if (state) {
-        stepIndex = config.index ?? state.stepCounter++;
-      }
-    }
-  }
-  if (workflowCtx) {
-    const wfSpan = getActiveSpan();
-    if (wfSpan) {
-      const state = workflowStates.get(wfSpan);
-      if (state) {
-        state.steps.set(config.name, {
-          name: config.name,
-          index: stepIndex,
-          status: "running",
-          startTime: Date.now(),
-          compensate: config.compensate
-        });
-      }
-    }
-  }
-  return {
-    ...baseCtx,
-    getStepName() {
-      return config.name;
-    },
-    getStepIndex() {
-      return stepIndex;
-    },
-    complete() {
-      if (workflowCtx) {
-        workflowCtx.completeStep(config.name);
-      }
-    },
-    skip(reason) {
-      baseCtx.setAttribute("workflow.step.status", "skipped");
-      if (reason) {
-        baseCtx.setAttribute("workflow.step.skip_reason", reason);
-      }
-      emitCorrelatedEvent(baseCtx, "step_skipped", {
-        "workflow.step.name": config.name,
-        ...reason && { "workflow.step.skip_reason": reason }
-      });
-    },
-    getWorkflowContext() {
-      return workflowCtx;
-    }
-  };
-}
-function getWorkflowState() {
-  const span = getActiveSpan();
-  return span ? workflowStates.get(span) : null;
-}
-async function addStepLinks(ctx, config, workflowCtx) {
-  if (!workflowCtx) return;
-  const links = [];
-  if (config.linkToPrevious) {
-    const prevSpanContext = workflowCtx.getPreviousStep();
-    if (prevSpanContext) {
-      links.push({
-        context: prevSpanContext,
-        attributes: {
-          "workflow.link.type": "sequence"
-        }
-      });
-    }
-  }
-  if (config.linkTo) {
-    const stepNames = Array.isArray(config.linkTo) ? config.linkTo : [config.linkTo];
-    for (const stepName of stepNames) {
-      const spanContext = workflowCtx.getPreviousStep(stepName);
-      if (spanContext) {
-        links.push({
-          context: spanContext,
-          attributes: {
-            "workflow.link.type": "dependency",
-            "workflow.link.step": stepName
-          }
-        });
-      }
-    }
-  }
-  if (links.length > 0) {
-    ctx.addLinks(links);
-  }
-}
-function sleep(ms) {
-  return new Promise((resolve) => setTimeout(resolve, ms));
-}
-function getCurrentWorkflowContext() {
-  return workflowContextStorage.getStore() ?? null;
-}
-function isInWorkflow() {
-  return workflowContextStorage.getStore() !== void 0;
-}
-
-export { getCurrentWorkflowContext, isInWorkflow, traceStep, traceWorkflow };
-//# sourceMappingURL=chunk-URHPSJW2.js.map
-//# sourceMappingURL=chunk-URHPSJW2.js.map