autotel 3.6.0 → 3.7.0

package/dist/metric.d.cts

@@ -1,37 +1,8 @@
-import { Logger } from './logger.cjs';
-import { EventAttributes, FunnelStatus, OutcomeStatus } from './event-subscriber.cjs';
-import { MetricsCollector } from './metric-testing.cjs';
-import 'pino';
-
-/**
- * Metrics API for OpenTelemetry
- *
- * Track business metrics for OpenTelemetry (Prometheus/Grafana).
- * For business people who think in metrics.
- *
- * @example Track business metrics
- * ```typescript
- * const metrics = new Metric('checkout')
- *
- * // Track events as metrics
- * metrics.trackEvent('order.completed', {
- *   amount: 99.99,
- *   currency: 'USD'
- * })
- *
- * // Track conversion funnels
- * metrics.trackFunnelStep('checkout', 'started', { cartValue: 99.99 })
- * metrics.trackFunnelStep('checkout', 'completed', { cartValue: 99.99 })
- *
- * // Track outcomes
- * metrics.trackOutcome('payment.process', 'success', { amount: 99.99 })
- * metrics.trackOutcome('payment.process', 'failure', { error: 'insufficient_funds' })
- *
- * // Track values
- * metrics.trackValue('revenue', 149.99, { currency: 'USD' })
- * ```
- */
+import { s as Logger } from "./logger-BauSUhUv.cjs";
+import { c as OutcomeStatus, n as EventAttributes, s as FunnelStatus } from "./event-subscriber-D1XLkPzi.cjs";
+import { t as MetricsCollector } from "./metric-testing-MxvzChDp.cjs";
 
+//#region src/metric.d.ts
 /**
  * Metrics class for tracking business metrics in OpenTelemetry
  *
@@ -47,176 +18,176 @@ import 'pino';
  * Metric configuration for customizing metric names and descriptions
  */
 interface MetricConfig {
-    /** Metric name (e.g., 'metrics.events' or 'custom.events') */
-    name?: string;
-    /** Metric description */
-    description?: string;
-    /** Metric unit (default: '1') */
-    unit?: string;
+  /** Metric name (e.g., 'metrics.events' or 'custom.events') */
+  name?: string;
+  /** Metric description */
+  description?: string;
+  /** Metric unit (default: '1') */
+  unit?: string;
 }
 /**
  * Metrics options
  */
 interface MetricsOptions {
-    /** Optional logger for audit trail */
-    logger?: Logger;
-    /** Optional collector for testing (captures metrics in memory) */
-    collector?: MetricsCollector;
-    /**
-     * Namespace for metrics (default: 'metrics')
-     * Results in metrics like: {serviceName}.{namespace}.events
-     */
-    namespace?: string;
-    /**
-     * Custom metric configurations
-     * Override metric names, descriptions, and units
-     */
-    metrics?: {
-        events?: MetricConfig;
-        funnel?: MetricConfig;
-        outcomes?: MetricConfig;
-        value?: MetricConfig;
-    };
+  /** Optional logger for audit trail */
+  logger?: Logger;
+  /** Optional collector for testing (captures metrics in memory) */
+  collector?: MetricsCollector;
+  /**
+   * Namespace for metrics (default: 'metrics')
+   * Results in metrics like: {serviceName}.{namespace}.events
+   */
+  namespace?: string;
+  /**
+   * Custom metric configurations
+   * Override metric names, descriptions, and units
+   */
+  metrics?: {
+    events?: MetricConfig;
+    funnel?: MetricConfig;
+    outcomes?: MetricConfig;
+    value?: MetricConfig;
+  };
 }
 declare class Metric {
-    private serviceName;
-    private eventCounter;
-    private funnelCounter;
-    private outcomeCounter;
-    private valueHistogram;
-    private logger?;
-    private 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: string, options?: MetricsOptions);
-    /**
-     * 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: string, attributes?: EventAttributes): void;
-    /**
-     * 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: string, status: FunnelStatus, attributes?: EventAttributes): void;
-    /**
-     * 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: string, status: OutcomeStatus, attributes?: EventAttributes): void;
-    /**
-     * 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: string, value: number, attributes?: EventAttributes): void;
+  private serviceName;
+  private eventCounter;
+  private funnelCounter;
+  private outcomeCounter;
+  private valueHistogram;
+  private logger?;
+  private 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: string, options?: MetricsOptions);
+  /**
+   * 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: string, attributes?: EventAttributes): void;
+  /**
+   * 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: string, status: FunnelStatus, attributes?: EventAttributes): void;
+  /**
+   * 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: string, status: OutcomeStatus, attributes?: EventAttributes): void;
+  /**
+   * 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: string, value: number, attributes?: EventAttributes): void;
 }
 /**
  * Get or create a Metrics instance for a service
@@ -236,5 +207,6 @@ declare function getMetrics(serviceName: string, logger?: Logger): Metric;
  * Reset all metrics instances (mainly for testing)
  */
 declare function resetMetrics(): void;
-
-export { EventAttributes, FunnelStatus, Metric, type MetricConfig, type MetricsOptions, OutcomeStatus, getMetrics, resetMetrics };
+//#endregion
+export { type EventAttributes, type FunnelStatus, Metric, MetricConfig, MetricsOptions, type OutcomeStatus, getMetrics, resetMetrics };
+//# sourceMappingURL=metric.d.cts.map

package/dist/metric.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metric.d.cts","names":[],"sources":["../src/metric.ts"],"mappings":";;;;;;;;;;;;;AAgGwB;AAIxB;;;;;UApCiB,YAAA;EA8MA;EA5Mf,IAAA;EAoQe;EAlQf,WAAA;EA6T8B;EA3T9B,IAAA;AAAA;;;;UAMe,cAAA;EA8BP;EA5BR,MAAA,GAAS,MAAA;;EAET,SAAA,GAAY,gBAAA;EAiE8B;;;;EA3D1C,SAAA;EAyI8B;;;;EAnI9B,OAAA;IACE,MAAA,GAAS,YAAA;IACT,MAAA,GAAS,YAAA;IACT,QAAA,GAAW,YAAA;IACX,KAAA,GAAQ,YAAA;EAAA;AAAA;AAAA,cAIC,MAAA;EAAA,QACH,WAAA;EAAA,QACA,YAAA;EAAA,QACA,aAAA;EAAA,QACA,cAAA;EAAA,QACA,cAAA;EAAA,QACA,MAAA;EAAA,QACA,SAAA;EAsRsB;AAgDhC;;;;;;;;;AAAwE;AAUxE;;;;AAA4B;;;;;;;;;;;;;;;;;;;;;cA1Sd,WAAA,UAAqB,OAAA,GAAS,cAAA;;;;;;;;;;;;;;;;;;;;;;;;EA8E1C,UAAA,CAAW,SAAA,UAAmB,UAAA,GAAa,eAAA;;;;;;;;;;;;;;;;;;;EA4C3C,eAAA,CACE,UAAA,UACA,MAAA,EAAQ,YAAA,EACR,UAAA,GAAa,eAAA;;;;;;;;;;;;;;;;;;;;;;;;EAqDf,YAAA,CACE,aAAA,UACA,MAAA,EAAQ,aAAA,EACR,UAAA,GAAa,eAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;EAwDf,UAAA,CACE,UAAA,UACA,KAAA,UACA,UAAA,GAAa,eAAA;AAAA;;;;;;;;;;;;;;iBAgDD,UAAA,CAAW,WAAA,UAAqB,MAAA,GAAS,MAAA,GAAS,MAAM;;;;iBAUxD,YAAA"}