autotel 2.1.0

package/dist/chunk-5ZN622AO.js

@@ -0,0 +1,73 @@
+// src/metric-testing.ts
+function createMetricsCollector() {
+  const events = [];
+  const funnelSteps = [];
+  const outcomes = [];
+  const values = [];
+  return {
+    getEvents() {
+      return [...events];
+    },
+    getFunnelSteps() {
+      return [...funnelSteps];
+    },
+    getOutcomes() {
+      return [...outcomes];
+    },
+    getValues() {
+      return [...values];
+    },
+    clear() {
+      events.length = 0;
+      funnelSteps.length = 0;
+      outcomes.length = 0;
+      values.length = 0;
+    },
+    recordEvent(event) {
+      events.push(event);
+    },
+    recordFunnelStep(step) {
+      funnelSteps.push(step);
+    },
+    recordOutcome(outcome) {
+      outcomes.push(outcome);
+    },
+    recordValue(value) {
+      values.push(value);
+    }
+  };
+}
+function assertEventTracked(options) {
+  const events = options.collector.getEvents();
+  const matching = events.filter((e) => e.event === options.eventName);
+  if (matching.length === 0) {
+    throw new Error(`No events found with name: ${options.eventName}`);
+  }
+  if (options.attributes) {
+    const matchingWithAttrs = matching.filter(
+      (e) => Object.entries(options.attributes).every(
+        ([key, value]) => e.attributes && e.attributes[key] === value
+      )
+    );
+    if (matchingWithAttrs.length === 0) {
+      throw new Error(
+        `Event ${options.eventName} found but attributes don't match: ${JSON.stringify(options.attributes)}`
+      );
+    }
+  }
+}
+function assertOutcomeTracked(options) {
+  const outcomes = options.collector.getOutcomes();
+  const matching = outcomes.filter(
+    (o) => o.operation === options.operation && o.status === options.status
+  );
+  if (matching.length === 0) {
+    throw new Error(
+      `No outcomes found with operation: ${options.operation} and status: ${options.status}`
+    );
+  }
+}
+
+export { assertEventTracked, assertOutcomeTracked, createMetricsCollector };
+//# sourceMappingURL=chunk-5ZN622AO.js.map
+//# sourceMappingURL=chunk-5ZN622AO.js.map

package/dist/chunk-5ZN622AO.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/metric-testing.ts"],"names":[],"mappings":";AAkFO,SAAS,sBAAA,GAA2C;AACzD,EAAA,MAAM,SAAyB,EAAC;AAChC,EAAA,MAAM,cAAmC,EAAC;AAC1C,EAAA,MAAM,WAA6B,EAAC;AACpC,EAAA,MAAM,SAAyB,EAAC;AAEhC,EAAA,OAAO;AAAA,IACL,SAAA,GAA4B;AAC1B,MAAA,OAAO,CAAC,GAAG,MAAM,CAAA;AAAA,IACnB,CAAA;AAAA,IAEA,cAAA,GAAsC;AACpC,MAAA,OAAO,CAAC,GAAG,WAAW,CAAA;AAAA,IACxB,CAAA;AAAA,IAEA,WAAA,GAAgC;AAC9B,MAAA,OAAO,CAAC,GAAG,QAAQ,CAAA;AAAA,IACrB,CAAA;AAAA,IAEA,SAAA,GAA4B;AAC1B,MAAA,OAAO,CAAC,GAAG,MAAM,CAAA;AAAA,IACnB,CAAA;AAAA,IAEA,KAAA,GAAc;AACZ,MAAA,MAAA,CAAO,MAAA,GAAS,CAAA;AAChB,MAAA,WAAA,CAAY,MAAA,GAAS,CAAA;AACrB,MAAA,QAAA,CAAS,MAAA,GAAS,CAAA;AAClB,MAAA,MAAA,CAAO,MAAA,GAAS,CAAA;AAAA,IAClB,CAAA;AAAA,IAEA,YAAY,KAAA,EAA2B;AACrC,MAAA,MAAA,CAAO,KAAK,KAAK,CAAA;AAAA,IACnB,CAAA;AAAA,IAEA,iBAAiB,IAAA,EAA+B;AAC9C,MAAA,WAAA,CAAY,KAAK,IAAI,CAAA;AAAA,IACvB,CAAA;AAAA,IAEA,cAAc,OAAA,EAA+B;AAC3C,MAAA,QAAA,CAAS,KAAK,OAAO,CAAA;AAAA,IACvB,CAAA;AAAA,IAEA,YAAY,KAAA,EAA2B;AACrC,MAAA,MAAA,CAAO,KAAK,KAAK,CAAA;AAAA,IACnB;AAAA,GACF;AACF;AAcO,SAAS,mBAAmB,OAAA,EAI1B;AACP,EAAA,MAAM,MAAA,GAAS,OAAA,CAAQ,SAAA,CAAU,SAAA,EAAU;AAC3C,EAAA,MAAM,QAAA,GAAW,OAAO,MAAA,CAAO,CAAC,MAAM,CAAA,CAAE,KAAA,KAAU,QAAQ,SAAS,CAAA;AAEnE,EAAA,IAAI,QAAA,CAAS,WAAW,CAAA,EAAG;AACzB,IAAA,MAAM,IAAI,KAAA,CAAM,CAAA,2BAAA,EAA8B,OAAA,CAAQ,SAAS,CAAA,CAAE,CAAA;AAAA,EACnE;AAEA,EAAA,IAAI,QAAQ,UAAA,EAAY;AACtB,IAAA,MAAM,oBAAoB,QAAA,CAAS,MAAA;AAAA,MAAO,CAAC,CAAA,KACzC,MAAA,CAAO,OAAA,CAAQ,OAAA,CAAQ,UAAW,CAAA,CAAE,KAAA;AAAA,QAClC,CAAC,CAAC,GAAA,EAAK,KAAK,CAAA,KAAM,EAAE,UAAA,IAAc,CAAA,CAAE,UAAA,CAAW,GAAG,CAAA,KAAM;AAAA;AAC1D,KACF;AAEA,IAAA,IAAI,iBAAA,CAAkB,WAAW,CAAA,EAAG;AAClC,MAAA,MAAM,IAAI,KAAA;AAAA,QACR,CAAA,MAAA,EAAS,QAAQ,SAAS,CAAA,mCAAA,EAAsC,KAAK,SAAA,CAAU,OAAA,CAAQ,UAAU,CAAC,CAAA;AAAA,OACpG;AAAA,IACF;AAAA,EACF;AACF;AAcO,SAAS,qBAAqB,OAAA,EAI5B;AACP,EAAA,MAAM,QAAA,GAAW,OAAA,CAAQ,SAAA,CAAU,WAAA,EAAY;AAC/C,EAAA,MAAM,WAAW,QAAA,CAAS,MAAA;AAAA,IACxB,CAAC,MAAM,CAAA,CAAE,SAAA,KAAc,QAAQ,SAAA,IAAa,CAAA,CAAE,WAAW,OAAA,CAAQ;AAAA,GACnE;AAEA,EAAA,IAAI,QAAA,CAAS,WAAW,CAAA,EAAG;AACzB,IAAA,MAAM,IAAI,KAAA;AAAA,MACR,CAAA,kCAAA,EAAqC,OAAA,CAAQ,SAAS,CAAA,aAAA,EAAgB,QAAQ,MAAM,CAAA;AAAA,KACtF;AAAA,EACF;AACF","file":"chunk-5ZN622AO.js","sourcesContent":["/**\n * Testing utilities for Metrics\n *\n * Provides in-memory collection of metrics for testing purposes.\n */\n\nimport type {\n  EventAttributes,\n  FunnelStatus,\n  OutcomeStatus,\n} from './event-subscriber';\n\nexport interface MetricsEvent {\n  event: string;\n  attributes?: EventAttributes;\n  service: string;\n  timestamp: number;\n}\n\nexport interface MetricsFunnelStep {\n  funnel: string;\n  status: FunnelStatus;\n  attributes?: EventAttributes;\n  service: string;\n  timestamp: number;\n}\n\nexport interface MetricsOutcome {\n  operation: string;\n  status: OutcomeStatus;\n  attributes?: EventAttributes;\n  service: string;\n  timestamp: number;\n}\n\nexport interface MetricsValue {\n  metric: string;\n  value: number;\n  attributes?: EventAttributes;\n  service: string;\n  timestamp: number;\n}\n\n/**\n * In-memory metrics collector for testing\n */\nexport interface MetricsCollector {\n  /** Get all collected events */\n  getEvents(): MetricsEvent[];\n  /** Get all collected funnel steps */\n  getFunnelSteps(): MetricsFunnelStep[];\n  /** Get all collected outcomes */\n  getOutcomes(): MetricsOutcome[];\n  /** Get all collected values */\n  getValues(): MetricsValue[];\n  /** Clear all collected metrics */\n  clear(): void;\n  /** Record an event (internal use) */\n  recordEvent(event: MetricsEvent): void;\n  /** Record a funnel step (internal use) */\n  recordFunnelStep(step: MetricsFunnelStep): void;\n  /** Record an outcome (internal use) */\n  recordOutcome(outcome: MetricsOutcome): void;\n  /** Record a value (internal use) */\n  recordValue(value: MetricsValue): void;\n}\n\n/**\n * Create an in-memory metrics collector for testing\n *\n * @example\n * ```typescript\n * const collector = createMetricsCollector()\n *\n * const metrics = new Metric('test-service', { collector })\n * metrics.trackEvent('order.completed', { orderId: '123' })\n *\n * const event =collector.getEvents()\n * expect(events).toHaveLength(1)\n * expect(events[0].event).toBe('order.completed')\n * ```\n */\nexport function createMetricsCollector(): MetricsCollector {\n  const events: MetricsEvent[] = [];\n  const funnelSteps: MetricsFunnelStep[] = [];\n  const outcomes: MetricsOutcome[] = [];\n  const values: MetricsValue[] = [];\n\n  return {\n    getEvents(): MetricsEvent[] {\n      return [...events];\n    },\n\n    getFunnelSteps(): MetricsFunnelStep[] {\n      return [...funnelSteps];\n    },\n\n    getOutcomes(): MetricsOutcome[] {\n      return [...outcomes];\n    },\n\n    getValues(): MetricsValue[] {\n      return [...values];\n    },\n\n    clear(): void {\n      events.length = 0;\n      funnelSteps.length = 0;\n      outcomes.length = 0;\n      values.length = 0;\n    },\n\n    recordEvent(event: MetricsEvent): void {\n      events.push(event);\n    },\n\n    recordFunnelStep(step: MetricsFunnelStep): void {\n      funnelSteps.push(step);\n    },\n\n    recordOutcome(outcome: MetricsOutcome): void {\n      outcomes.push(outcome);\n    },\n\n    recordValue(value: MetricsValue): void {\n      values.push(value);\n    },\n  };\n}\n\n/**\n * Assert that a metric event was tracked\n *\n * @example\n * ```typescript\n * assertEventTracked({\n *   collector,\n *   eventName: 'order.completed',\n *   attributes: { orderId: '123' }\n * })\n * ```\n */\nexport function assertEventTracked(options: {\n  collector: MetricsCollector;\n  eventName: string;\n  attributes?: Record<string, unknown>;\n}): void {\n  const events = options.collector.getEvents();\n  const matching = events.filter((e) => e.event === options.eventName);\n\n  if (matching.length === 0) {\n    throw new Error(`No events found with name: ${options.eventName}`);\n  }\n\n  if (options.attributes) {\n    const matchingWithAttrs = matching.filter((e) =>\n      Object.entries(options.attributes!).every(\n        ([key, value]) => e.attributes && e.attributes[key] === value,\n      ),\n    );\n\n    if (matchingWithAttrs.length === 0) {\n      throw new Error(\n        `Event ${options.eventName} found but attributes don't match: ${JSON.stringify(options.attributes)}`,\n      );\n    }\n  }\n}\n\n/**\n * Assert that an outcome was tracked\n *\n * @example\n * ```typescript\n * assertOutcomeTracked({\n *   collector,\n *   operation: 'payment.process',\n *   status: 'success'\n * })\n * ```\n */\nexport function assertOutcomeTracked(options: {\n  collector: MetricsCollector;\n  operation: string;\n  status: 'success' | 'failure' | 'partial';\n}): void {\n  const outcomes = options.collector.getOutcomes();\n  const matching = outcomes.filter(\n    (o) => o.operation === options.operation && o.status === options.status,\n  );\n\n  if (matching.length === 0) {\n    throw new Error(\n      `No outcomes found with operation: ${options.operation} and status: ${options.status}`,\n    );\n  }\n}\n"]}

package/dist/chunk-77MSMAUQ.cjs

@@ -0,0 +1,498 @@
+'use strict';
+
+var chunkYLPNXZFI_cjs = require('./chunk-YLPNXZFI.cjs');
+var chunkABPEQ6RK_cjs = require('./chunk-ABPEQ6RK.cjs');
+var api = require('@opentelemetry/api');
+
+// src/circuit-breaker.ts
+var DEFAULT_CONFIG = {
+  failureThreshold: 5,
+  resetTimeout: 3e4,
+  // 30 seconds
+  windowSize: 6e4
+  // 1 minute
+};
+var CircuitState = {
+  CLOSED: "CLOSED",
+  // Normal operation
+  OPEN: "OPEN",
+  // Fast-fail mode
+  HALF_OPEN: "HALF_OPEN"
+  // Testing recovery
+};
+var CircuitBreaker = class {
+  state = CircuitState.CLOSED;
+  failures = [];
+  lastFailureTime = 0;
+  config;
+  name;
+  constructor(name, config) {
+    this.name = name;
+    this.config = { ...DEFAULT_CONFIG, ...config };
+  }
+  /**
+   * Execute a function with circuit breaker protection
+   * Throws CircuitOpenError if circuit is open
+   */
+  async execute(fn) {
+    if (this.state === CircuitState.OPEN) {
+      const now = Date.now();
+      if (now - this.lastFailureTime >= this.config.resetTimeout) {
+        this.state = CircuitState.HALF_OPEN;
+      } else {
+        throw new CircuitOpenError(
+          `Circuit breaker is OPEN for ${this.name}. Will retry in ${Math.ceil((this.config.resetTimeout - (now - this.lastFailureTime)) / 1e3)}s`
+        );
+      }
+    }
+    try {
+      const result = await fn();
+      if (this.state === CircuitState.HALF_OPEN) {
+        this.reset();
+      }
+      return result;
+    } catch (error) {
+      this.recordFailure(error);
+      throw error;
+    }
+  }
+  /**
+   * Record a failure and potentially open the circuit
+   */
+  recordFailure(error) {
+    const now = Date.now();
+    this.failures = this.failures.filter(
+      (f) => now - f.timestamp < this.config.windowSize
+    );
+    this.failures.push({
+      timestamp: now,
+      error: error instanceof Error ? error.message : String(error)
+    });
+    this.lastFailureTime = now;
+    if (this.failures.length >= this.config.failureThreshold) {
+      if (this.state === CircuitState.HALF_OPEN) {
+        this.state = CircuitState.OPEN;
+      } else if (this.state === CircuitState.CLOSED) {
+        this.state = CircuitState.OPEN;
+      }
+    }
+  }
+  /**
+   * Reset the circuit breaker (on success)
+   */
+  reset() {
+    this.state = CircuitState.CLOSED;
+    this.failures = [];
+    this.lastFailureTime = 0;
+  }
+  /**
+   * Get current state (for monitoring)
+   */
+  getState() {
+    return this.state;
+  }
+  /**
+   * Get failure count in current window
+   */
+  getFailureCount() {
+    const now = Date.now();
+    this.failures = this.failures.filter(
+      (f) => now - f.timestamp < this.config.windowSize
+    );
+    return this.failures.length;
+  }
+  /**
+   * Get recent failures (for debugging)
+   */
+  getRecentFailures() {
+    const now = Date.now();
+    return this.failures.filter(
+      (f) => now - f.timestamp < this.config.windowSize
+    );
+  }
+  /**
+   * Manually reset the circuit breaker (for testing or manual intervention)
+   */
+  forceReset() {
+    this.reset();
+  }
+  /**
+   * Manually open the circuit (for testing or manual intervention)
+   */
+  forceOpen() {
+    this.state = CircuitState.OPEN;
+    this.lastFailureTime = Date.now();
+  }
+};
+var CircuitOpenError = class extends Error {
+  constructor(message) {
+    super(message);
+    this.name = "CircuitOpenError";
+  }
+};
+
+// src/event.ts
+var Event = class {
+  serviceName;
+  logger;
+  collector;
+  subscribers;
+  hasSubscribers;
+  // Cached for performance
+  circuitBreakers;
+  // One per subscriber
+  /**
+   * Create a new Event instance
+   *
+   * **Note**: Most users should use `init()` + `track()` instead of creating Event instances directly.
+   *
+   * **Subscriber Resolution**:
+   * - If `subscribers` provided in options → uses those (instance override)
+   * - If `subscribers` not provided → falls back to subscribers from `init()` (global config)
+   * - If neither → no subscribers (events logged only)
+   *
+   * @param serviceName - Service name for identifying events
+   * @param options - Optional configuration (logger, collector, subscribers)
+   *
+   * @example Recommended: Use track() with init()
+   * ```typescript
+   * import { init, track } from 'autotel';
+   * import { PostHogSubscriber } from 'autotel-subscribers/posthog';
+   *
+   * init({
+   *   service: 'checkout',
+   *   subscribers: [new PostHogSubscriber({ apiKey: 'phc_...' })]
+   * });
+   *
+   * track('purchase.completed', { amount: 99.99 });
+   * ```
+   *
+   * @example Inherit subscribers from init()
+   * ```typescript
+   * // Uses subscribers configured in init()
+   * const event = new Event('checkout');
+   * event.trackEvent('purchase.completed', { amount: 99.99 });
+   * ```
+   *
+   * @example Override subscribers for this instance
+   * ```typescript
+   * import { Event } from 'autotel/event';
+   * import { PostHogSubscriber } from 'autotel-subscribers/posthog';
+   *
+   * // Override: use different subscribers for this instance only
+   * const event = new Event('checkout', {
+   *   subscribers: [new PostHogSubscriber({ apiKey: 'phc_different_project' })]
+   * });
+   * ```
+   */
+  constructor(serviceName, options = {}) {
+    this.serviceName = serviceName;
+    this.logger = options.logger;
+    this.collector = options.collector;
+    this.subscribers = options.subscribers === void 0 ? chunkABPEQ6RK_cjs.getConfig()?.subscribers || [] : options.subscribers;
+    this.hasSubscribers = this.subscribers.length > 0;
+    this.circuitBreakers = /* @__PURE__ */ new Map();
+    for (const subscriber of this.subscribers) {
+      const subscriberName = subscriber.name || "Unknown";
+      this.circuitBreakers.set(
+        subscriber,
+        new CircuitBreaker(subscriberName, {
+          failureThreshold: 5,
+          resetTimeout: 3e4,
+          // 30s
+          windowSize: 6e4
+          // 1min
+        })
+      );
+    }
+  }
+  /**
+   * Automatically enrich attributes with all available telemetry context
+   *
+   * Auto-captures:
+   * - Resource attributes: service.version, deployment.environment
+   * - Trace context: traceId, spanId, correlationId
+   * - Operation context: operation.name
+   */
+  enrichWithTelemetryContext(attributes = {}) {
+    const enriched = {
+      service: this.serviceName,
+      ...attributes
+    };
+    const config = chunkABPEQ6RK_cjs.getConfig();
+    if (config) {
+      if (config.version) {
+        enriched["service.version"] = config.version;
+      }
+      if (config.environment) {
+        enriched["deployment.environment"] = config.environment;
+      }
+    }
+    const span = api.trace.getActiveSpan();
+    const spanContext = span?.spanContext();
+    if (spanContext) {
+      enriched.traceId = spanContext.traceId;
+      enriched.spanId = spanContext.spanId;
+      enriched.correlationId = spanContext.traceId.slice(0, 16);
+    }
+    const operationContext = chunkYLPNXZFI_cjs.getOperationContext();
+    if (operationContext) {
+      enriched["operation.name"] = operationContext.name;
+    }
+    return enriched;
+  }
+  /**
+   * Track a business event
+   *
+   * Use this for tracking user actions, business events, product usage:
+   * - "user.signup"
+   * - "order.completed"
+   * - "feature.used"
+   *
+   * Events are sent to configured subscribers (PostHog, Mixpanel, etc.).
+   *
+   * @example
+   * ```typescript
+   * // Track user signup
+   * events.trackEvent('user.signup', {
+   *   userId: '123',
+   *   plan: 'pro'
+   * })
+   *
+   * // Track order
+   * events.trackEvent('order.completed', {
+   *   orderId: 'ord_123',
+   *   amount: 99.99
+   * })
+   * ```
+   */
+  trackEvent(eventName, attributes) {
+    const validationConfig = chunkABPEQ6RK_cjs.getValidationConfig();
+    const validated = chunkYLPNXZFI_cjs.validateEvent(
+      eventName,
+      attributes,
+      validationConfig || void 0
+    );
+    const enrichedAttributes = this.enrichWithTelemetryContext(
+      validated.attributes
+    );
+    this.logger?.info("Event tracked", {
+      event: validated.eventName,
+      attributes: enrichedAttributes
+    });
+    this.collector?.recordEvent({
+      event: validated.eventName,
+      attributes: enrichedAttributes,
+      service: this.serviceName,
+      timestamp: Date.now()
+    });
+    if (this.hasSubscribers) {
+      void this.notifySubscribers(
+        (subscriber) => subscriber.trackEvent(validated.eventName, enrichedAttributes)
+      );
+    }
+  }
+  /**
+   * Notify all subscribers concurrently without blocking
+   * Uses circuit breakers to protect against failing subscribers
+   * Uses Promise.allSettled to prevent subscriber errors from affecting other subscribers
+   */
+  async notifySubscribers(fn) {
+    const promises = this.subscribers.map(async (subscriber) => {
+      const circuitBreaker = this.circuitBreakers.get(subscriber);
+      if (!circuitBreaker) return;
+      try {
+        await circuitBreaker.execute(() => fn(subscriber));
+      } catch (error) {
+        if (error instanceof CircuitOpenError) {
+          chunkABPEQ6RK_cjs.getLogger().warn(`[Events] ${error.message}`, {
+            subscriberName: subscriber.name || "Unknown"
+          });
+          return;
+        }
+        chunkABPEQ6RK_cjs.getLogger().error(
+          `[Events] Subscriber ${subscriber.name || "Unknown"} failed`,
+          error instanceof Error ? error : void 0,
+          { subscriberName: subscriber.name || "Unknown" }
+        );
+      }
+    });
+    await Promise.allSettled(promises);
+  }
+  /**
+   * Track conversion funnel steps
+   *
+   * Monitor where users drop off in multi-step processes.
+   *
+   * @example
+   * ```typescript
+   * // Track signup funnel
+   * events.trackFunnelStep('signup', 'started', { userId: '123' })
+   * events.trackFunnelStep('signup', 'email_verified', { userId: '123' })
+   * events.trackFunnelStep('signup', 'completed', { userId: '123' })
+   *
+   * // Track checkout flow
+   * events.trackFunnelStep('checkout', 'started', { cartValue: 99.99 })
+   * events.trackFunnelStep('checkout', 'payment_info', { cartValue: 99.99 })
+   * events.trackFunnelStep('checkout', 'completed', { cartValue: 99.99 })
+   * ```
+   */
+  trackFunnelStep(funnelName, status, attributes) {
+    const enrichedAttributes = this.enrichWithTelemetryContext(attributes);
+    this.logger?.info("Funnel step tracked", {
+      funnel: funnelName,
+      status,
+      attributes: enrichedAttributes
+    });
+    this.collector?.recordFunnelStep({
+      funnel: funnelName,
+      status,
+      attributes: enrichedAttributes,
+      service: this.serviceName,
+      timestamp: Date.now()
+    });
+    if (this.hasSubscribers) {
+      void this.notifySubscribers(
+        (subscriber) => subscriber.trackFunnelStep(funnelName, status, enrichedAttributes)
+      );
+    }
+  }
+  /**
+   * Track outcomes (success/failure/partial)
+   *
+   * Monitor success rates of critical operations.
+   *
+   * @example
+   * ```typescript
+   * // Track email delivery
+   * events.trackOutcome('email.delivery', 'success', {
+   *   recipientType: 'user',
+   *   emailType: 'welcome'
+   * })
+   *
+   * events.trackOutcome('email.delivery', 'failure', {
+   *   recipientType: 'user',
+   *   errorCode: 'invalid_email'
+   * })
+   *
+   * // Track payment processing
+   * events.trackOutcome('payment.process', 'success', { amount: 99.99 })
+   * events.trackOutcome('payment.process', 'failure', { error: 'insufficient_funds' })
+   * ```
+   */
+  trackOutcome(operationName, status, attributes) {
+    const enrichedAttributes = this.enrichWithTelemetryContext(attributes);
+    this.logger?.info("Outcome tracked", {
+      operation: operationName,
+      status,
+      attributes: enrichedAttributes
+    });
+    this.collector?.recordOutcome({
+      operation: operationName,
+      status,
+      attributes: enrichedAttributes,
+      service: this.serviceName,
+      timestamp: Date.now()
+    });
+    if (this.hasSubscribers) {
+      void this.notifySubscribers(
+        (subscriber) => subscriber.trackOutcome(operationName, status, enrichedAttributes)
+      );
+    }
+  }
+  /**
+   * Track value metrics
+   *
+   * Record numerical values like revenue, transaction amounts,
+   * item counts, processing times, engagement scores, etc.
+   *
+   * @example
+   * ```typescript
+   * // Track revenue
+   * events.trackValue('order.revenue', 149.99, {
+   *   currency: 'USD',
+   *   productCategory: 'electronics'
+   * })
+   *
+   * // Track items per cart
+   * events.trackValue('cart.item_count', 5, {
+   *   userId: '123'
+   * })
+   *
+   * // Track processing time
+   * events.trackValue('api.response_time', 250, {
+   *   unit: 'ms',
+   *   endpoint: '/api/checkout'
+   * })
+   * ```
+   */
+  trackValue(metricName, value, attributes) {
+    const enrichedAttributes = this.enrichWithTelemetryContext({
+      metric: metricName,
+      ...attributes
+    });
+    this.logger?.debug("Value tracked", {
+      metric: metricName,
+      value,
+      attributes: enrichedAttributes
+    });
+    this.collector?.recordValue({
+      metric: metricName,
+      value,
+      attributes: enrichedAttributes,
+      service: this.serviceName,
+      timestamp: Date.now()
+    });
+    if (this.hasSubscribers) {
+      void this.notifySubscribers(
+        (subscriber) => subscriber.trackValue(metricName, value, enrichedAttributes)
+      );
+    }
+  }
+  /**
+   * Flush all subscribers and wait for pending events
+   *
+   * Call this before shutdown to ensure all events are delivered.
+   *
+   * @example
+   * ```typescript
+   * const event =new Event('app', { subscribers: [...] });
+   *
+   * // Before shutdown
+   * await events.flush();
+   * ```
+   */
+  async flush() {
+    if (!this.hasSubscribers) return;
+    const shutdownPromises = this.subscribers.map(async (subscriber) => {
+      if (subscriber.shutdown) {
+        try {
+          await subscriber.shutdown();
+        } catch (error) {
+          chunkABPEQ6RK_cjs.getLogger().error(
+            `[Events] Failed to shutdown subscriber ${subscriber.name || "Unknown"}`,
+            error instanceof Error ? error : void 0,
+            { subscriberName: subscriber.name || "Unknown" }
+          );
+        }
+      }
+    });
+    await Promise.allSettled(shutdownPromises);
+  }
+};
+var eventsInstances = /* @__PURE__ */ new Map();
+function getEvents(serviceName, logger) {
+  if (!eventsInstances.has(serviceName)) {
+    eventsInstances.set(serviceName, new Event(serviceName, { logger }));
+  }
+  return eventsInstances.get(serviceName);
+}
+function resetEvents() {
+  eventsInstances.clear();
+}
+
+exports.Event = Event;
+exports.getEvents = getEvents;
+exports.resetEvents = resetEvents;
+//# sourceMappingURL=chunk-77MSMAUQ.cjs.map
+//# sourceMappingURL=chunk-77MSMAUQ.cjs.map

package/dist/chunk-77MSMAUQ.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/circuit-breaker.ts","../src/event.ts"],"names":["getConfig","trace","getOperationContext","getValidationConfig","validateEvent","getLogger"],"mappings":";;;;;;;AAmBA,IAAM,cAAA,GAAuC;AAAA,EAC3C,gBAAA,EAAkB,CAAA;AAAA,EAClB,YAAA,EAAc,GAAA;AAAA;AAAA,EACd,UAAA,EAAY;AAAA;AACd,CAAA;AAIO,IAAM,YAAA,GAAe;AAAA,EAC1B,MAAA,EAAQ,QAAA;AAAA;AAAA,EACR,IAAA,EAAM,MAAA;AAAA;AAAA,EACN,SAAA,EAAW;AAAA;AACb,CAAA;AAaO,IAAM,iBAAN,MAAqB;AAAA,EAClB,QAAsB,YAAA,CAAa,MAAA;AAAA,EACnC,WAA4B,EAAC;AAAA,EAC7B,eAAA,GAA0B,CAAA;AAAA,EACjB,MAAA;AAAA,EACA,IAAA;AAAA,EAEjB,WAAA,CAAY,MAAc,MAAA,EAAwC;AAChE,IAAA,IAAA,CAAK,IAAA,GAAO,IAAA;AACZ,IAAA,IAAA,CAAK,MAAA,GAAS,EAAE,GAAG,cAAA,EAAgB,GAAG,MAAA,EAAO;AAAA,EAC/C;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,MAAM,QAAW,EAAA,EAAkC;AAEjD,IAAA,IAAI,IAAA,CAAK,KAAA,KAAU,YAAA,CAAa,IAAA,EAAM;AAEpC,MAAA,MAAM,GAAA,GAAM,KAAK,GAAA,EAAI;AACrB,MAAA,IAAI,GAAA,GAAM,IAAA,CAAK,eAAA,IAAmB,IAAA,CAAK,OAAO,YAAA,EAAc;AAC1D,QAAA,IAAA,CAAK,QAAQ,YAAA,CAAa,SAAA;AAAA,MAC5B,CAAA,MAAO;AACL,QAAA,MAAM,IAAI,gBAAA;AAAA,UACR,CAAA,4BAAA,EAA+B,IAAA,CAAK,IAAI,CAAA,gBAAA,EACrB,IAAA,CAAK,IAAA,CAAA,CAAM,IAAA,CAAK,MAAA,CAAO,YAAA,IAAgB,GAAA,GAAM,IAAA,CAAK,eAAA,CAAA,IAAoB,GAAI,CAAC,CAAA,CAAA;AAAA,SAChG;AAAA,MACF;AAAA,IACF;AAEA,IAAA,IAAI;AACF,MAAA,MAAM,MAAA,GAAS,MAAM,EAAA,EAAG;AAGxB,MAAA,IAAI,IAAA,CAAK,KAAA,KAAU,YAAA,CAAa,SAAA,EAAW;AACzC,QAAA,IAAA,CAAK,KAAA,EAAM;AAAA,MACb;AAEA,MAAA,OAAO,MAAA;AAAA,IACT,SAAS,KAAA,EAAO;AACd,MAAA,IAAA,CAAK,cAAc,KAAK,CAAA;AACxB,MAAA,MAAM,KAAA;AAAA,IACR;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKQ,cAAc,KAAA,EAAsB;AAC1C,IAAA,MAAM,GAAA,GAAM,KAAK,GAAA,EAAI;AAGrB,IAAA,IAAA,CAAK,QAAA,GAAW,KAAK,QAAA,CAAS,MAAA;AAAA,MAC5B,CAAC,CAAA,KAAM,GAAA,GAAM,CAAA,CAAE,SAAA,GAAY,KAAK,MAAA,CAAO;AAAA,KACzC;AAGA,IAAA,IAAA,CAAK,SAAS,IAAA,CAAK;AAAA,MACjB,SAAA,EAAW,GAAA;AAAA,MACX,OAAO,KAAA,YAAiB,KAAA,GAAQ,KAAA,CAAM,OAAA,GAAU,OAAO,KAAK;AAAA,KAC7D,CAAA;AAED,IAAA,IAAA,CAAK,eAAA,GAAkB,GAAA;AAGvB,IAAA,IAAI,IAAA,CAAK,QAAA,CAAS,MAAA,IAAU,IAAA,CAAK,OAAO,gBAAA,EAAkB;AACxD,MAAA,IAAI,IAAA,CAAK,KAAA,KAAU,YAAA,CAAa,SAAA,EAAW;AAEzC,QAAA,IAAA,CAAK,QAAQ,YAAA,CAAa,IAAA;AAAA,MAC5B,CAAA,MAAA,IAAW,IAAA,CAAK,KAAA,KAAU,YAAA,CAAa,MAAA,EAAQ;AAE7C,QAAA,IAAA,CAAK,QAAQ,YAAA,CAAa,IAAA;AAAA,MAC5B;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKQ,KAAA,GAAc;AACpB,IAAA,IAAA,CAAK,QAAQ,YAAA,CAAa,MAAA;AAC1B,IAAA,IAAA,CAAK,WAAW,EAAC;AACjB,IAAA,IAAA,CAAK,eAAA,GAAkB,CAAA;AAAA,EACzB;AAAA;AAAA;AAAA;AAAA,EAKA,QAAA,GAAyB;AACvB,IAAA,OAAO,IAAA,CAAK,KAAA;AAAA,EACd;AAAA;AAAA;AAAA;AAAA,EAKA,eAAA,GAA0B;AACxB,IAAA,MAAM,GAAA,GAAM,KAAK,GAAA,EAAI;AAErB,IAAA,IAAA,CAAK,QAAA,GAAW,KAAK,QAAA,CAAS,MAAA;AAAA,MAC5B,CAAC,CAAA,KAAM,GAAA,GAAM,CAAA,CAAE,SAAA,GAAY,KAAK,MAAA,CAAO;AAAA,KACzC;AACA,IAAA,OAAO,KAAK,QAAA,CAAS,MAAA;AAAA,EACvB;AAAA;AAAA;AAAA;AAAA,EAKA,iBAAA,GAAqC;AACnC,IAAA,MAAM,GAAA,GAAM,KAAK,GAAA,EAAI;AACrB,IAAA,OAAO,KAAK,QAAA,CAAS,MAAA;AAAA,MACnB,CAAC,CAAA,KAAM,GAAA,GAAM,CAAA,CAAE,SAAA,GAAY,KAAK,MAAA,CAAO;AAAA,KACzC;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,UAAA,GAAmB;AACjB,IAAA,IAAA,CAAK,KAAA,EAAM;AAAA,EACb;AAAA;AAAA;AAAA;AAAA,EAKA,SAAA,GAAkB;AAChB,IAAA,IAAA,CAAK,QAAQ,YAAA,CAAa,IAAA;AAC1B,IAAA,IAAA,CAAK,eAAA,GAAkB,KAAK,GAAA,EAAI;AAAA,EAClC;AACF,CAAA;AAKO,IAAM,gBAAA,GAAN,cAA+B,KAAA,CAAM;AAAA,EAC1C,YAAY,OAAA,EAAiB;AAC3B,IAAA,KAAA,CAAM,OAAO,CAAA;AACb,IAAA,IAAA,CAAK,IAAA,GAAO,kBAAA;AAAA,EACd;AACF,CAAA;;;AClFO,IAAM,QAAN,MAAY;AAAA,EACT,WAAA;AAAA,EACA,MAAA;AAAA,EACA,SAAA;AAAA,EACA,WAAA;AAAA,EACA,cAAA;AAAA;AAAA,EACA,eAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EA8CR,WAAA,CAAY,WAAA,EAAqB,OAAA,GAAyB,EAAC,EAAG;AAC5D,IAAA,IAAA,CAAK,WAAA,GAAc,WAAA;AACnB,IAAA,IAAA,CAAK,SAAS,OAAA,CAAQ,MAAA;AACtB,IAAA,IAAA,CAAK,YAAY,OAAA,CAAQ,SAAA;AAKzB,IAAA,IAAA,CAAK,WAAA,GACH,QAAQ,WAAA,KAAgB,MAAA,GACpBA,6BAAU,EAAG,WAAA,IAAe,EAAC,GAC7B,OAAA,CAAQ,WAAA;AAEd,IAAA,IAAA,CAAK,cAAA,GAAiB,IAAA,CAAK,WAAA,CAAY,MAAA,GAAS,CAAA;AAGhD,IAAA,IAAA,CAAK,eAAA,uBAAsB,GAAA,EAAI;AAC/B,IAAA,KAAA,MAAW,UAAA,IAAc,KAAK,WAAA,EAAa;AACzC,MAAA,MAAM,cAAA,GAAiB,WAAW,IAAA,IAAQ,SAAA;AAC1C,MAAA,IAAA,CAAK,eAAA,CAAgB,GAAA;AAAA,QACnB,UAAA;AAAA,QACA,IAAI,eAAe,cAAA,EAAgB;AAAA,UACjC,gBAAA,EAAkB,CAAA;AAAA,UAClB,YAAA,EAAc,GAAA;AAAA;AAAA,UACd,UAAA,EAAY;AAAA;AAAA,SACb;AAAA,OACH;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUQ,0BAAA,CACN,UAAA,GAA8B,EAAC,EACd;AACjB,IAAA,MAAM,QAAA,GAA4B;AAAA,MAChC,SAAS,IAAA,CAAK,WAAA;AAAA,MACd,GAAG;AAAA,KACL;AAGA,IAAA,MAAM,SAASA,2BAAA,EAAU;AACzB,IAAA,IAAI,MAAA,EAAQ;AACV,MAAA,IAAI,OAAO,OAAA,EAAS;AAClB,QAAA,QAAA,CAAS,iBAAiB,IAAI,MAAA,CAAO,OAAA;AAAA,MACvC;AACA,MAAA,IAAI,OAAO,WAAA,EAAa;AACtB,QAAA,QAAA,CAAS,wBAAwB,IAAI,MAAA,CAAO,WAAA;AAAA,MAC9C;AAAA,IACF;AAGA,IAAA,MAAM,IAAA,GAAOC,UAAM,aAAA,EAAc;AACjC,IAAA,MAAM,WAAA,GAAc,MAAM,WAAA,EAAY;AACtC,IAAA,IAAI,WAAA,EAAa;AACf,MAAA,QAAA,CAAS,UAAU,WAAA,CAAY,OAAA;AAC/B,MAAA,QAAA,CAAS,SAAS,WAAA,CAAY,MAAA;AAE9B,MAAA,QAAA,CAAS,aAAA,GAAgB,WAAA,CAAY,OAAA,CAAQ,KAAA,CAAM,GAAG,EAAE,CAAA;AAAA,IAC1D;AAGA,IAAA,MAAM,mBAAmBC,qCAAA,EAAoB;AAC7C,IAAA,IAAI,gBAAA,EAAkB;AACpB,MAAA,QAAA,CAAS,gBAAgB,IAAI,gBAAA,CAAiB,IAAA;AAAA,IAChD;AAEA,IAAA,OAAO,QAAA;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EA2BA,UAAA,CAAW,WAAmB,UAAA,EAAoC;AAEhE,IAAA,MAAM,mBAAmBC,qCAAA,EAAoB;AAC7C,IAAA,MAAM,SAAA,GAAYC,+BAAA;AAAA,MAChB,SAAA;AAAA,MACA,UAAA;AAAA,MACA,gBAAA,IAAoB;AAAA,KACtB;AAGA,IAAA,MAAM,qBAAqB,IAAA,CAAK,0BAAA;AAAA,MAC9B,SAAA,CAAU;AAAA,KACZ;AAEA,IAAA,IAAA,CAAK,MAAA,EAAQ,KAAK,eAAA,EAAiB;AAAA,MACjC,OAAO,SAAA,CAAU,SAAA;AAAA,MACjB,UAAA,EAAY;AAAA,KACb,CAAA;AAGD,IAAA,IAAA,CAAK,WAAW,WAAA,CAAY;AAAA,MAC1B,OAAO,SAAA,CAAU,SAAA;AAAA,MACjB,UAAA,EAAY,kBAAA;AAAA,MACZ,SAAS,IAAA,CAAK,WAAA;AAAA,MACd,SAAA,EAAW,KAAK,GAAA;AAAI,KACrB,CAAA;AAID,IAAA,IAAI,KAAK,cAAA,EAAgB;AACvB,MAAA,KAAK,IAAA,CAAK,iBAAA;AAAA,QAAkB,CAAC,UAAA,KAC3B,UAAA,CAAW,UAAA,CAAW,SAAA,CAAU,WAAW,kBAAkB;AAAA,OAC/D;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAc,kBACZ,EAAA,EACe;AACf,IAAA,MAAM,QAAA,GAAW,IAAA,CAAK,WAAA,CAAY,GAAA,CAAI,OAAO,UAAA,KAAe;AAC1D,MAAA,MAAM,cAAA,GAAiB,IAAA,CAAK,eAAA,CAAgB,GAAA,CAAI,UAAU,CAAA;AAC1D,MAAA,IAAI,CAAC,cAAA,EAAgB;AAErB,MAAA,IAAI;AAEF,QAAA,MAAM,cAAA,CAAe,OAAA,CAAQ,MAAM,EAAA,CAAG,UAAU,CAAC,CAAA;AAAA,MACnD,SAAS,KAAA,EAAO;AAEd,QAAA,IAAI,iBAAiB,gBAAA,EAAkB;AAErC,UAAAC,2BAAA,EAAU,CAAE,IAAA,CAAK,CAAA,SAAA,EAAY,KAAA,CAAM,OAAO,CAAA,CAAA,EAAI;AAAA,YAC5C,cAAA,EAAgB,WAAW,IAAA,IAAQ;AAAA,WACpC,CAAA;AACD,UAAA;AAAA,QACF;AAGA,QAAAA,2BAAA,EAAU,CAAE,KAAA;AAAA,UACV,CAAA,oBAAA,EAAuB,UAAA,CAAW,IAAA,IAAQ,SAAS,CAAA,OAAA,CAAA;AAAA,UACnD,KAAA,YAAiB,QAAQ,KAAA,GAAQ,MAAA;AAAA,UACjC,EAAE,cAAA,EAAgB,UAAA,CAAW,IAAA,IAAQ,SAAA;AAAU,SACjD;AAAA,MACF;AAAA,IACF,CAAC,CAAA;AAGD,IAAA,MAAM,OAAA,CAAQ,WAAW,QAAQ,CAAA;AAAA,EACnC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAoBA,eAAA,CACE,UAAA,EACA,MAAA,EACA,UAAA,EACM;AAEN,IAAA,MAAM,kBAAA,GAAqB,IAAA,CAAK,0BAAA,CAA2B,UAAU,CAAA;AAErE,IAAA,IAAA,CAAK,MAAA,EAAQ,KAAK,qBAAA,EAAuB;AAAA,MACvC,MAAA,EAAQ,UAAA;AAAA,MACR,MAAA;AAAA,MACA,UAAA,EAAY;AAAA,KACb,CAAA;AAGD,IAAA,IAAA,CAAK,WAAW,gBAAA,CAAiB;AAAA,MAC/B,MAAA,EAAQ,UAAA;AAAA,MACR,MAAA;AAAA,MACA,UAAA,EAAY,kBAAA;AAAA,MACZ,SAAS,IAAA,CAAK,WAAA;AAAA,MACd,SAAA,EAAW,KAAK,GAAA;AAAI,KACrB,CAAA;AAGD,IAAA,IAAI,KAAK,cAAA,EAAgB;AACvB,MAAA,KAAK,IAAA,CAAK,iBAAA;AAAA,QAAkB,CAAC,UAAA,KAC3B,UAAA,CAAW,eAAA,CAAgB,UAAA,EAAY,QAAQ,kBAAkB;AAAA,OACnE;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAyBA,YAAA,CACE,aAAA,EACA,MAAA,EACA,UAAA,EACM;AAEN,IAAA,MAAM,kBAAA,GAAqB,IAAA,CAAK,0BAAA,CAA2B,UAAU,CAAA;AAErE,IAAA,IAAA,CAAK,MAAA,EAAQ,KAAK,iBAAA,EAAmB;AAAA,MACnC,SAAA,EAAW,aAAA;AAAA,MACX,MAAA;AAAA,MACA,UAAA,EAAY;AAAA,KACb,CAAA;AAGD,IAAA,IAAA,CAAK,WAAW,aAAA,CAAc;AAAA,MAC5B,SAAA,EAAW,aAAA;AAAA,MACX,MAAA;AAAA,MACA,UAAA,EAAY,kBAAA;AAAA,MACZ,SAAS,IAAA,CAAK,WAAA;AAAA,MACd,SAAA,EAAW,KAAK,GAAA;AAAI,KACrB,CAAA;AAGD,IAAA,IAAI,KAAK,cAAA,EAAgB;AACvB,MAAA,KAAK,IAAA,CAAK,iBAAA;AAAA,QAAkB,CAAC,UAAA,KAC3B,UAAA,CAAW,YAAA,CAAa,aAAA,EAAe,QAAQ,kBAAkB;AAAA,OACnE;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EA4BA,UAAA,CACE,UAAA,EACA,KAAA,EACA,UAAA,EACM;AAEN,IAAA,MAAM,kBAAA,GAAqB,KAAK,0BAAA,CAA2B;AAAA,MACzD,MAAA,EAAQ,UAAA;AAAA,MACR,GAAG;AAAA,KACJ,CAAA;AAED,IAAA,IAAA,CAAK,MAAA,EAAQ,MAAM,eAAA,EAAiB;AAAA,MAClC,MAAA,EAAQ,UAAA;AAAA,MACR,KAAA;AAAA,MACA,UAAA,EAAY;AAAA,KACb,CAAA;AAGD,IAAA,IAAA,CAAK,WAAW,WAAA,CAAY;AAAA,MAC1B,MAAA,EAAQ,UAAA;AAAA,MACR,KAAA;AAAA,MACA,UAAA,EAAY,kBAAA;AAAA,MACZ,SAAS,IAAA,CAAK,WAAA;AAAA,MACd,SAAA,EAAW,KAAK,GAAA;AAAI,KACrB,CAAA;AAGD,IAAA,IAAI,KAAK,cAAA,EAAgB;AACvB,MAAA,KAAK,IAAA,CAAK,iBAAA;AAAA,QAAkB,CAAC,UAAA,KAC3B,UAAA,CAAW,UAAA,CAAW,UAAA,EAAY,OAAO,kBAAkB;AAAA,OAC7D;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAeA,MAAM,KAAA,GAAuB;AAC3B,IAAA,IAAI,CAAC,KAAK,cAAA,EAAgB;AAE1B,IAAA,MAAM,gBAAA,GAAmB,IAAA,CAAK,WAAA,CAAY,GAAA,CAAI,OAAO,UAAA,KAAe;AAClE,MAAA,IAAI,WAAW,QAAA,EAAU;AACvB,QAAA,IAAI;AACF,UAAA,MAAM,WAAW,QAAA,EAAS;AAAA,QAC5B,SAAS,KAAA,EAAO;AACd,UAAAA,2BAAA,EAAU,CAAE,KAAA;AAAA,YACV,CAAA,uCAAA,EAA0C,UAAA,CAAW,IAAA,IAAQ,SAAS,CAAA,CAAA;AAAA,YACtE,KAAA,YAAiB,QAAQ,KAAA,GAAQ,MAAA;AAAA,YACjC,EAAE,cAAA,EAAgB,UAAA,CAAW,IAAA,IAAQ,SAAA;AAAU,WACjD;AAAA,QACF;AAAA,MACF;AAAA,IACF,CAAC,CAAA;AAED,IAAA,MAAM,OAAA,CAAQ,WAAW,gBAAgB,CAAA;AAAA,EAC3C;AACF;AAKA,IAAM,eAAA,uBAAsB,GAAA,EAAmB;AAexC,SAAS,SAAA,CAAU,aAAqB,MAAA,EAAwB;AACrE,EAAA,IAAI,CAAC,eAAA,CAAgB,GAAA,CAAI,WAAW,CAAA,EAAG;AACrC,IAAA,eAAA,CAAgB,GAAA,CAAI,aAAa,IAAI,KAAA,CAAM,aAAa,EAAE,MAAA,EAAQ,CAAC,CAAA;AAAA,EACrE;AACA,EAAA,OAAO,eAAA,CAAgB,IAAI,WAAW,CAAA;AACxC;AAKO,SAAS,WAAA,GAAoB;AAClC,EAAA,eAAA,CAAgB,KAAA,EAAM;AACxB","file":"chunk-77MSMAUQ.cjs","sourcesContent":["/**\n * Circuit breaker for event subscribers\n *\n * Prevents cascading failures by fast-failing when an (subscriber) is unhealthy.\n * Uses the circuit breaker pattern with three states:\n * - CLOSED: Normal operation ((subscriber) working)\n * - OPEN: Fast-fail mode ((subscriber) down)\n * - HALF_OPEN: Testing if (subscriber) recovered\n */\n\nexport interface CircuitBreakerConfig {\n  /** Number of failures before opening circuit (default: 5) */\n  failureThreshold: number;\n  /** Time to wait before trying again in ms (default: 30000 = 30s) */\n  resetTimeout: number;\n  /** Time window for counting failures in ms (default: 60000 = 1min) */\n  windowSize: number;\n}\n\nconst DEFAULT_CONFIG: CircuitBreakerConfig = {\n  failureThreshold: 5,\n  resetTimeout: 30_000, // 30 seconds\n  windowSize: 60_000, // 1 minute\n};\n\nexport type CircuitState = 'CLOSED' | 'OPEN' | 'HALF_OPEN';\n\nexport const CircuitState = {\n  CLOSED: 'CLOSED' as const, // Normal operation\n  OPEN: 'OPEN' as const, // Fast-fail mode\n  HALF_OPEN: 'HALF_OPEN' as const, // Testing recovery\n} as const;\n\ninterface FailureRecord {\n  timestamp: number;\n  error: string;\n}\n\n/**\n * Circuit breaker implementation\n *\n * Tracks failures and automatically opens the circuit to prevent\n * overwhelming failing subscribers.\n */\nexport class CircuitBreaker {\n  private state: CircuitState = CircuitState.CLOSED;\n  private failures: FailureRecord[] = [];\n  private lastFailureTime: number = 0;\n  private readonly config: CircuitBreakerConfig;\n  private readonly name: string;\n\n  constructor(name: string, config?: Partial<CircuitBreakerConfig>) {\n    this.name = name;\n    this.config = { ...DEFAULT_CONFIG, ...config };\n  }\n\n  /**\n   * Execute a function with circuit breaker protection\n   * Throws CircuitOpenError if circuit is open\n   */\n  async execute<T>(fn: () => Promise<T>): Promise<T> {\n    // Check if circuit is open\n    if (this.state === CircuitState.OPEN) {\n      // Check if we should transition to half-open\n      const now = Date.now();\n      if (now - this.lastFailureTime >= this.config.resetTimeout) {\n        this.state = CircuitState.HALF_OPEN;\n      } else {\n        throw new CircuitOpenError(\n          `Circuit breaker is OPEN for ${this.name}. ` +\n            `Will retry in ${Math.ceil((this.config.resetTimeout - (now - this.lastFailureTime)) / 1000)}s`,\n        );\n      }\n    }\n\n    try {\n      const result = await fn();\n\n      // Success! Close circuit if it was half-open\n      if (this.state === CircuitState.HALF_OPEN) {\n        this.reset();\n      }\n\n      return result;\n    } catch (error) {\n      this.recordFailure(error);\n      throw error;\n    }\n  }\n\n  /**\n   * Record a failure and potentially open the circuit\n   */\n  private recordFailure(error: unknown): void {\n    const now = Date.now();\n\n    // Remove old failures outside the time window\n    this.failures = this.failures.filter(\n      (f) => now - f.timestamp < this.config.windowSize,\n    );\n\n    // Record new failure\n    this.failures.push({\n      timestamp: now,\n      error: error instanceof Error ? error.message : String(error),\n    });\n\n    this.lastFailureTime = now;\n\n    // Check if we should open the circuit\n    if (this.failures.length >= this.config.failureThreshold) {\n      if (this.state === CircuitState.HALF_OPEN) {\n        // Failed during test - reopen circuit\n        this.state = CircuitState.OPEN;\n      } else if (this.state === CircuitState.CLOSED) {\n        // Too many failures - open circuit\n        this.state = CircuitState.OPEN;\n      }\n    }\n  }\n\n  /**\n   * Reset the circuit breaker (on success)\n   */\n  private reset(): void {\n    this.state = CircuitState.CLOSED;\n    this.failures = [];\n    this.lastFailureTime = 0;\n  }\n\n  /**\n   * Get current state (for monitoring)\n   */\n  getState(): CircuitState {\n    return this.state;\n  }\n\n  /**\n   * Get failure count in current window\n   */\n  getFailureCount(): number {\n    const now = Date.now();\n    // Clean up old failures\n    this.failures = this.failures.filter(\n      (f) => now - f.timestamp < this.config.windowSize,\n    );\n    return this.failures.length;\n  }\n\n  /**\n   * Get recent failures (for debugging)\n   */\n  getRecentFailures(): FailureRecord[] {\n    const now = Date.now();\n    return this.failures.filter(\n      (f) => now - f.timestamp < this.config.windowSize,\n    );\n  }\n\n  /**\n   * Manually reset the circuit breaker (for testing or manual intervention)\n   */\n  forceReset(): void {\n    this.reset();\n  }\n\n  /**\n   * Manually open the circuit (for testing or manual intervention)\n   */\n  forceOpen(): void {\n    this.state = CircuitState.OPEN;\n    this.lastFailureTime = Date.now();\n  }\n}\n\n/**\n * Error thrown when circuit is open\n */\nexport class CircuitOpenError extends Error {\n  constructor(message: string) {\n    super(message);\n    this.name = 'CircuitOpenError';\n  }\n}\n","/**\n * Events API for product events platforms\n *\n * Track user behavior, business events, and critical actions.\n * Sends to product events platforms (PostHog, Mixpanel, Amplitude) via subscribers.\n * For business people who think in events/funnels.\n *\n * For OpenTelemetry metrics (Prometheus/Grafana), use the Metrics class instead.\n *\n * @example Recommended: Configure subscribers in init(), use track() function\n * ```typescript\n * import { init, track } from 'autotel';\n * import { PostHogSubscriber } from 'autotel-subscribers/posthog';\n *\n * init({\n *   service: 'my-app',\n *   subscribers: [new PostHogSubscriber({ apiKey: 'phc_...' })]\n * });\n *\n * // Track events - uses subscribers from init()\n * track('application.submitted', { jobId: '123', userId: '456' });\n * ```\n *\n * @example Create Event instance (inherits subscribers from init)\n * ```typescript\n * import { Event } from 'autotel/event';\n *\n * // Uses subscribers configured in init()\n * const event = new Event('job-application');\n * event.trackEvent('application.submitted', { jobId: '123' });\n * ```\n *\n * @example Override subscribers for specific Event instance\n * ```typescript\n * import { Event } from 'autotel/event';\n * import { PostHogSubscriber } from 'autotel-subscribers/posthog';\n *\n * // Override: use different subscribers for this instance\n * const event = new Event('job-application', {\n *   subscribers: [new PostHogSubscriber({ apiKey: 'phc_different_project' })]\n * });\n *\n * event.trackEvent('application.submitted', { jobId: '123' });\n * ```\n */\n\nimport { trace } from '@opentelemetry/api';\nimport { type Logger } from './logger';\nimport { getLogger, getValidationConfig, getConfig } from './init';\nimport {\n  type EventSubscriber,\n  type EventAttributes,\n  type FunnelStatus,\n  type OutcomeStatus,\n} from './event-subscriber';\nimport { type EventCollector } from './event-testing';\nimport { CircuitBreaker, CircuitOpenError } from './circuit-breaker';\nimport { validateEvent } from './validation';\nimport { getOperationContext } from './operation-context';\n\n// Re-export types for convenience\nexport type {\n  EventAttributes,\n  FunnelStatus,\n  OutcomeStatus,\n} from './event-subscriber';\n\n/**\n * Events class for tracking user behavior and product events\n *\n * Track critical indicators such as:\n * - User events (signups, purchases, feature usage)\n * - Conversion funnels (signup → activation → purchase)\n * - Business outcomes (success/failure rates)\n * - Product metrics (revenue, engagement, retention)\n *\n * All events are sent to events platforms via subscribers (PostHog, Mixpanel, etc.).\n * For OpenTelemetry metrics, use the Metrics class instead.\n */\n/**\n * Events options\n */\nexport interface EventsOptions {\n  /** Optional logger for audit trail */\n  logger?: Logger;\n  /** Optional collector for testing (captures events in memory) */\n  collector?: EventCollector;\n  /**\n   * Optional subscribers to send events to other platforms\n   * (e.g., PostHog, Mixpanel, Amplitude)\n   *\n   * **Subscriber Resolution**:\n   * - If provided → uses these subscribers (instance override)\n   * - If not provided → falls back to subscribers from `init()` (global config)\n   * - If neither → no subscribers (events logged only)\n   *\n   * Install `autotel-subscribers` package for ready-made subscribers\n   */\n  subscribers?: EventSubscriber[];\n}\n\nexport class Event {\n  private serviceName: string;\n  private logger?: Logger;\n  private collector?: EventCollector;\n  private subscribers: EventSubscriber[];\n  private hasSubscribers: boolean; // Cached for performance\n  private circuitBreakers: Map<EventSubscriber, CircuitBreaker>; // One per subscriber\n\n  /**\n   * Create a new Event instance\n   *\n   * **Note**: Most users should use `init()` + `track()` instead of creating Event instances directly.\n   *\n   * **Subscriber Resolution**:\n   * - If `subscribers` provided in options → uses those (instance override)\n   * - If `subscribers` not provided → falls back to subscribers from `init()` (global config)\n   * - If neither → no subscribers (events logged only)\n   *\n   * @param serviceName - Service name for identifying events\n   * @param options - Optional configuration (logger, collector, subscribers)\n   *\n   * @example Recommended: Use track() with init()\n   * ```typescript\n   * import { init, track } from 'autotel';\n   * import { PostHogSubscriber } from 'autotel-subscribers/posthog';\n   *\n   * init({\n   *   service: 'checkout',\n   *   subscribers: [new PostHogSubscriber({ apiKey: 'phc_...' })]\n   * });\n   *\n   * track('purchase.completed', { amount: 99.99 });\n   * ```\n   *\n   * @example Inherit subscribers from init()\n   * ```typescript\n   * // Uses subscribers configured in init()\n   * const event = new Event('checkout');\n   * event.trackEvent('purchase.completed', { amount: 99.99 });\n   * ```\n   *\n   * @example Override subscribers for this instance\n   * ```typescript\n   * import { Event } from 'autotel/event';\n   * import { PostHogSubscriber } from 'autotel-subscribers/posthog';\n   *\n   * // Override: use different subscribers for this instance only\n   * const event = new Event('checkout', {\n   *   subscribers: [new PostHogSubscriber({ apiKey: 'phc_different_project' })]\n   * });\n   * ```\n   */\n  constructor(serviceName: string, options: EventsOptions = {}) {\n    this.serviceName = serviceName;\n    this.logger = options.logger;\n    this.collector = options.collector;\n\n    // Subscriber resolution: instance-level overrides global init() config\n    // If subscribers provided to constructor, use those\n    // Otherwise, fall back to subscribers from init()\n    this.subscribers =\n      options.subscribers === undefined\n        ? getConfig()?.subscribers || []\n        : options.subscribers;\n\n    this.hasSubscribers = this.subscribers.length > 0; // Cache for hot path\n\n    // Create circuit breaker for each subscriber\n    this.circuitBreakers = new Map();\n    for (const subscriber of this.subscribers) {\n      const subscriberName = subscriber.name || 'Unknown';\n      this.circuitBreakers.set(\n        subscriber,\n        new CircuitBreaker(subscriberName, {\n          failureThreshold: 5,\n          resetTimeout: 30_000, // 30s\n          windowSize: 60_000, // 1min\n        }),\n      );\n    }\n  }\n\n  /**\n   * Automatically enrich attributes with all available telemetry context\n   *\n   * Auto-captures:\n   * - Resource attributes: service.version, deployment.environment\n   * - Trace context: traceId, spanId, correlationId\n   * - Operation context: operation.name\n   */\n  private enrichWithTelemetryContext(\n    attributes: EventAttributes = {},\n  ): EventAttributes {\n    const enriched: EventAttributes = {\n      service: this.serviceName,\n      ...attributes,\n    };\n\n    // 1. Resource attributes (service-level context)\n    const config = getConfig();\n    if (config) {\n      if (config.version) {\n        enriched['service.version'] = config.version;\n      }\n      if (config.environment) {\n        enriched['deployment.environment'] = config.environment;\n      }\n    }\n\n    // 2. Trace context (if inside a traced operation)\n    const span = trace.getActiveSpan();\n    const spanContext = span?.spanContext();\n    if (spanContext) {\n      enriched.traceId = spanContext.traceId;\n      enriched.spanId = spanContext.spanId;\n      // Add correlation ID (first 16 chars of trace ID) for easier log grouping\n      enriched.correlationId = spanContext.traceId.slice(0, 16);\n    }\n\n    // 3. Operation context (if inside a trace/span)\n    const operationContext = getOperationContext();\n    if (operationContext) {\n      enriched['operation.name'] = operationContext.name;\n    }\n\n    return enriched;\n  }\n\n  /**\n   * Track a business event\n   *\n   * Use this for tracking user actions, business events, product usage:\n   * - \"user.signup\"\n   * - \"order.completed\"\n   * - \"feature.used\"\n   *\n   * Events are sent to configured subscribers (PostHog, Mixpanel, etc.).\n   *\n   * @example\n   * ```typescript\n   * // Track user signup\n   * events.trackEvent('user.signup', {\n   *   userId: '123',\n   *   plan: 'pro'\n   * })\n   *\n   * // Track order\n   * events.trackEvent('order.completed', {\n   *   orderId: 'ord_123',\n   *   amount: 99.99\n   * })\n   * ```\n   */\n  trackEvent(eventName: string, attributes?: EventAttributes): void {\n    // Validate and sanitize input (with custom config if provided)\n    const validationConfig = getValidationConfig();\n    const validated = validateEvent(\n      eventName,\n      attributes,\n      validationConfig || undefined,\n    );\n\n    // Auto-attach all available telemetry context\n    const enrichedAttributes = this.enrichWithTelemetryContext(\n      validated.attributes,\n    );\n\n    this.logger?.info('Event tracked', {\n      event: validated.eventName,\n      attributes: enrichedAttributes,\n    });\n\n    // Record for testing\n    this.collector?.recordEvent({\n      event: validated.eventName,\n      attributes: enrichedAttributes,\n      service: this.serviceName,\n      timestamp: Date.now(),\n    });\n\n    // Notify subscribers (zero overhead if no subscribers)\n    // Run in background - don't block event recording\n    if (this.hasSubscribers) {\n      void this.notifySubscribers((subscriber) =>\n        subscriber.trackEvent(validated.eventName, enrichedAttributes),\n      );\n    }\n  }\n\n  /**\n   * Notify all subscribers concurrently without blocking\n   * Uses circuit breakers to protect against failing subscribers\n   * Uses Promise.allSettled to prevent subscriber errors from affecting other subscribers\n   */\n  private async notifySubscribers(\n    fn: (subscriber: EventSubscriber) => Promise<void>,\n  ): Promise<void> {\n    const promises = this.subscribers.map(async (subscriber) => {\n      const circuitBreaker = this.circuitBreakers.get(subscriber);\n      if (!circuitBreaker) return; // Should never happen\n\n      try {\n        // Execute with circuit breaker protection\n        await circuitBreaker.execute(() => fn(subscriber));\n      } catch (error) {\n        // Handle circuit open errors (expected behavior when subscriber is down)\n        if (error instanceof CircuitOpenError) {\n          // Circuit is open - subscriber is down, log at warn level for visibility (same behavior in all environments)\n          getLogger().warn(`[Events] ${error.message}`, {\n            subscriberName: subscriber.name || 'Unknown',\n          });\n          return;\n        }\n\n        // Log other subscriber errors but don't throw - event failures shouldn't break business logic\n        getLogger().error(\n          `[Events] Subscriber ${subscriber.name || 'Unknown'} failed`,\n          error instanceof Error ? error : undefined,\n          { subscriberName: subscriber.name || 'Unknown' },\n        );\n      }\n    });\n\n    // Wait for all subscribers (success or failure)\n    await Promise.allSettled(promises);\n  }\n\n  /**\n   * Track conversion funnel steps\n   *\n   * Monitor where users drop off in multi-step processes.\n   *\n   * @example\n   * ```typescript\n   * // Track signup funnel\n   * events.trackFunnelStep('signup', 'started', { userId: '123' })\n   * events.trackFunnelStep('signup', 'email_verified', { userId: '123' })\n   * events.trackFunnelStep('signup', 'completed', { userId: '123' })\n   *\n   * // Track checkout flow\n   * events.trackFunnelStep('checkout', 'started', { cartValue: 99.99 })\n   * events.trackFunnelStep('checkout', 'payment_info', { cartValue: 99.99 })\n   * events.trackFunnelStep('checkout', 'completed', { cartValue: 99.99 })\n   * ```\n   */\n  trackFunnelStep(\n    funnelName: string,\n    status: FunnelStatus,\n    attributes?: EventAttributes,\n  ): void {\n    // Auto-attach all available telemetry context\n    const enrichedAttributes = this.enrichWithTelemetryContext(attributes);\n\n    this.logger?.info('Funnel step tracked', {\n      funnel: funnelName,\n      status,\n      attributes: enrichedAttributes,\n    });\n\n    // Record for testing\n    this.collector?.recordFunnelStep({\n      funnel: funnelName,\n      status,\n      attributes: enrichedAttributes,\n      service: this.serviceName,\n      timestamp: Date.now(),\n    });\n\n    // Notify subscribers\n    if (this.hasSubscribers) {\n      void this.notifySubscribers((subscriber) =>\n        subscriber.trackFunnelStep(funnelName, status, enrichedAttributes),\n      );\n    }\n  }\n\n  /**\n   * Track outcomes (success/failure/partial)\n   *\n   * Monitor success rates of critical operations.\n   *\n   * @example\n   * ```typescript\n   * // Track email delivery\n   * events.trackOutcome('email.delivery', 'success', {\n   *   recipientType: 'user',\n   *   emailType: 'welcome'\n   * })\n   *\n   * events.trackOutcome('email.delivery', 'failure', {\n   *   recipientType: 'user',\n   *   errorCode: 'invalid_email'\n   * })\n   *\n   * // Track payment processing\n   * events.trackOutcome('payment.process', 'success', { amount: 99.99 })\n   * events.trackOutcome('payment.process', 'failure', { error: 'insufficient_funds' })\n   * ```\n   */\n  trackOutcome(\n    operationName: string,\n    status: OutcomeStatus,\n    attributes?: EventAttributes,\n  ): void {\n    // Auto-attach all available telemetry context\n    const enrichedAttributes = this.enrichWithTelemetryContext(attributes);\n\n    this.logger?.info('Outcome tracked', {\n      operation: operationName,\n      status,\n      attributes: enrichedAttributes,\n    });\n\n    // Record for testing\n    this.collector?.recordOutcome({\n      operation: operationName,\n      status,\n      attributes: enrichedAttributes,\n      service: this.serviceName,\n      timestamp: Date.now(),\n    });\n\n    // Notify subscribers\n    if (this.hasSubscribers) {\n      void this.notifySubscribers((subscriber) =>\n        subscriber.trackOutcome(operationName, status, enrichedAttributes),\n      );\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   * events.trackValue('order.revenue', 149.99, {\n   *   currency: 'USD',\n   *   productCategory: 'electronics'\n   * })\n   *\n   * // Track items per cart\n   * events.trackValue('cart.item_count', 5, {\n   *   userId: '123'\n   * })\n   *\n   * // Track processing time\n   * events.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    // Auto-attach all available telemetry context\n    const enrichedAttributes = this.enrichWithTelemetryContext({\n      metric: metricName,\n      ...attributes,\n    });\n\n    this.logger?.debug('Value tracked', {\n      metric: metricName,\n      value,\n      attributes: enrichedAttributes,\n    });\n\n    // Record for testing\n    this.collector?.recordValue({\n      metric: metricName,\n      value,\n      attributes: enrichedAttributes,\n      service: this.serviceName,\n      timestamp: Date.now(),\n    });\n\n    // Notify subscribers\n    if (this.hasSubscribers) {\n      void this.notifySubscribers((subscriber) =>\n        subscriber.trackValue(metricName, value, enrichedAttributes),\n      );\n    }\n  }\n\n  /**\n   * Flush all subscribers and wait for pending events\n   *\n   * Call this before shutdown to ensure all events are delivered.\n   *\n   * @example\n   * ```typescript\n   * const event =new Event('app', { subscribers: [...] });\n   *\n   * // Before shutdown\n   * await events.flush();\n   * ```\n   */\n  async flush(): Promise<void> {\n    if (!this.hasSubscribers) return;\n\n    const shutdownPromises = this.subscribers.map(async (subscriber) => {\n      if (subscriber.shutdown) {\n        try {\n          await subscriber.shutdown();\n        } catch (error) {\n          getLogger().error(\n            `[Events] Failed to shutdown subscriber ${subscriber.name || 'Unknown'}`,\n            error instanceof Error ? error : undefined,\n            { subscriberName: subscriber.name || 'Unknown' },\n          );\n        }\n      }\n    });\n\n    await Promise.allSettled(shutdownPromises);\n  }\n}\n\n/**\n * Global events instances (singleton pattern)\n */\nconst eventsInstances = new Map<string, Event>();\n\n/**\n * Get or create an Events instance for a service\n *\n * @param serviceName - Service name for identifying events\n * @param logger - Optional logger\n * @returns Events instance\n *\n * @example\n * ```typescript\n * const event =getEvents('job-application')\n * events.trackEvent('application.submitted', { jobId: '123' })\n * ```\n */\nexport function getEvents(serviceName: string, logger?: Logger): Event {\n  if (!eventsInstances.has(serviceName)) {\n    eventsInstances.set(serviceName, new Event(serviceName, { logger }));\n  }\n  return eventsInstances.get(serviceName)!;\n}\n\n/**\n * Reset all events instances (mainly for testing)\n */\nexport function resetEvents(): void {\n  eventsInstances.clear();\n}\n"]}