autotel 2.1.0

package/dist/metric-testing.d.ts

@@ -0,0 +1,110 @@
+import { EventAttributes, FunnelStatus, OutcomeStatus } from './event-subscriber.js';
+
+/**
+ * Testing utilities for Metrics
+ *
+ * Provides in-memory collection of metrics for testing purposes.
+ */
+
+interface MetricsEvent {
+    event: string;
+    attributes?: EventAttributes;
+    service: string;
+    timestamp: number;
+}
+interface MetricsFunnelStep {
+    funnel: string;
+    status: FunnelStatus;
+    attributes?: EventAttributes;
+    service: string;
+    timestamp: number;
+}
+interface MetricsOutcome {
+    operation: string;
+    status: OutcomeStatus;
+    attributes?: EventAttributes;
+    service: string;
+    timestamp: number;
+}
+interface MetricsValue {
+    metric: string;
+    value: number;
+    attributes?: EventAttributes;
+    service: string;
+    timestamp: number;
+}
+/**
+ * In-memory metrics collector for testing
+ */
+interface MetricsCollector {
+    /** Get all collected events */
+    getEvents(): MetricsEvent[];
+    /** Get all collected funnel steps */
+    getFunnelSteps(): MetricsFunnelStep[];
+    /** Get all collected outcomes */
+    getOutcomes(): MetricsOutcome[];
+    /** Get all collected values */
+    getValues(): MetricsValue[];
+    /** Clear all collected metrics */
+    clear(): void;
+    /** Record an event (internal use) */
+    recordEvent(event: MetricsEvent): void;
+    /** Record a funnel step (internal use) */
+    recordFunnelStep(step: MetricsFunnelStep): void;
+    /** Record an outcome (internal use) */
+    recordOutcome(outcome: MetricsOutcome): void;
+    /** Record a value (internal use) */
+    recordValue(value: MetricsValue): void;
+}
+/**
+ * Create an in-memory metrics collector for testing
+ *
+ * @example
+ * ```typescript
+ * const collector = createMetricsCollector()
+ *
+ * const metrics = new Metric('test-service', { collector })
+ * metrics.trackEvent('order.completed', { orderId: '123' })
+ *
+ * const event =collector.getEvents()
+ * expect(events).toHaveLength(1)
+ * expect(events[0].event).toBe('order.completed')
+ * ```
+ */
+declare function createMetricsCollector(): MetricsCollector;
+/**
+ * Assert that a metric event was tracked
+ *
+ * @example
+ * ```typescript
+ * assertEventTracked({
+ *   collector,
+ *   eventName: 'order.completed',
+ *   attributes: { orderId: '123' }
+ * })
+ * ```
+ */
+declare function assertEventTracked(options: {
+    collector: MetricsCollector;
+    eventName: string;
+    attributes?: Record<string, unknown>;
+}): void;
+/**
+ * Assert that an outcome was tracked
+ *
+ * @example
+ * ```typescript
+ * assertOutcomeTracked({
+ *   collector,
+ *   operation: 'payment.process',
+ *   status: 'success'
+ * })
+ * ```
+ */
+declare function assertOutcomeTracked(options: {
+    collector: MetricsCollector;
+    operation: string;
+    status: 'success' | 'failure' | 'partial';
+}): void;
+
+export { type MetricsCollector, type MetricsEvent, type MetricsFunnelStep, type MetricsOutcome, type MetricsValue, assertEventTracked, assertOutcomeTracked, createMetricsCollector };

package/dist/metric-testing.js

@@ -0,0 +1,4 @@
+export { assertEventTracked, assertOutcomeTracked, createMetricsCollector } from './chunk-5ZN622AO.js';
+import './chunk-Z6ZWNWWR.js';
+//# sourceMappingURL=metric-testing.js.map
+//# sourceMappingURL=metric-testing.js.map

package/dist/metric-testing.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"metric-testing.js"}

package/dist/metric.cjs

@@ -0,0 +1,26 @@
+'use strict';
+
+var chunkW3253FGB_cjs = require('./chunk-W3253FGB.cjs');
+require('./chunk-YTXEZ4SD.cjs');
+require('./chunk-NZ72VDNY.cjs');
+require('./chunk-4OAT42CA.cjs');
+require('./chunk-Y4Y2S7BM.cjs');
+require('./chunk-URRW6M2C.cjs');
+require('./chunk-G7VZBCD6.cjs');
+
+
+
+Object.defineProperty(exports, "Metric", {
+  enumerable: true,
+  get: function () { return chunkW3253FGB_cjs.Metric; }
+});
+Object.defineProperty(exports, "getMetrics", {
+  enumerable: true,
+  get: function () { return chunkW3253FGB_cjs.getMetrics; }
+});
+Object.defineProperty(exports, "resetMetrics", {
+  enumerable: true,
+  get: function () { return chunkW3253FGB_cjs.resetMetrics; }
+});
+//# sourceMappingURL=metric.cjs.map
+//# sourceMappingURL=metric.cjs.map

package/dist/metric.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"metric.cjs"}

package/dist/metric.d.cts

@@ -0,0 +1,240 @@
+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' })
+ * ```
+ */
+
+/**
+ * Metrics class for tracking business metrics in OpenTelemetry
+ *
+ * Track critical business indicators such as:
+ * - User events (signups, purchases, feature usage) as metrics
+ * - Conversion funnels (signup → activation → purchase)
+ * - Business outcomes (success/failure rates)
+ * - Value metrics (revenue, counts, etc.)
+ *
+ * All metrics are sent to OpenTelemetry (OTLP/Prometheus/Grafana).
+ */
+/**
+ * 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;
+}
+/**
+ * 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;
+    };
+}
+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;
+}
+/**
+ * Get or create a Metrics instance for a service
+ *
+ * @param serviceName - Service name for metric namespacing
+ * @param logger - Optional logger
+ * @returns Metrics instance
+ *
+ * @example
+ * ```typescript
+ * const metrics = getMetrics('checkout')
+ * metrics.trackEvent('order.completed', { orderId: '123' })
+ * ```
+ */
+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 };

package/dist/metric.d.ts

@@ -0,0 +1,240 @@
+import { Logger } from './logger.js';
+import { EventAttributes, FunnelStatus, OutcomeStatus } from './event-subscriber.js';
+import { MetricsCollector } from './metric-testing.js';
+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' })
+ * ```
+ */
+
+/**
+ * Metrics class for tracking business metrics in OpenTelemetry
+ *
+ * Track critical business indicators such as:
+ * - User events (signups, purchases, feature usage) as metrics
+ * - Conversion funnels (signup → activation → purchase)
+ * - Business outcomes (success/failure rates)
+ * - Value metrics (revenue, counts, etc.)
+ *
+ * All metrics are sent to OpenTelemetry (OTLP/Prometheus/Grafana).
+ */
+/**
+ * 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;
+}
+/**
+ * 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;
+    };
+}
+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;
+}
+/**
+ * Get or create a Metrics instance for a service
+ *
+ * @param serviceName - Service name for metric namespacing
+ * @param logger - Optional logger
+ * @returns Metrics instance
+ *
+ * @example
+ * ```typescript
+ * const metrics = getMetrics('checkout')
+ * metrics.trackEvent('order.completed', { orderId: '123' })
+ * ```
+ */
+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 };

package/dist/metric.js

@@ -0,0 +1,9 @@
+export { Metric, getMetrics, resetMetrics } from './chunk-2LNRY4QK.js';
+import './chunk-5ZN622AO.js';
+import './chunk-LITNXTTT.js';
+import './chunk-5GWX5LFW.js';
+import './chunk-KVGNW3FC.js';
+import './chunk-P6JUDYNO.js';
+import './chunk-Z6ZWNWWR.js';
+//# sourceMappingURL=metric.js.map
+//# sourceMappingURL=metric.js.map

package/dist/metric.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"metric.js"}

package/dist/processors.cjs

@@ -0,0 +1,17 @@
+'use strict';
+
+require('./chunk-G7VZBCD6.cjs');
+var sdkTraceBase = require('@opentelemetry/sdk-trace-base');
+
+
+
+Object.defineProperty(exports, "BatchSpanProcessor", {
+  enumerable: true,
+  get: function () { return sdkTraceBase.BatchSpanProcessor; }
+});
+Object.defineProperty(exports, "SimpleSpanProcessor", {
+  enumerable: true,
+  get: function () { return sdkTraceBase.SimpleSpanProcessor; }
+});
+//# sourceMappingURL=processors.cjs.map
+//# sourceMappingURL=processors.cjs.map

package/dist/processors.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"processors.cjs","sourcesContent":[]}

package/dist/processors.d.cts

@@ -0,0 +1 @@
+export { BatchSpanProcessor, SimpleSpanProcessor } from '@opentelemetry/sdk-trace-base';

package/dist/processors.d.ts

@@ -0,0 +1 @@
+export { BatchSpanProcessor, SimpleSpanProcessor } from '@opentelemetry/sdk-trace-base';

package/dist/processors.js

@@ -0,0 +1,4 @@
+import './chunk-Z6ZWNWWR.js';
+export { BatchSpanProcessor, SimpleSpanProcessor } from '@opentelemetry/sdk-trace-base';
+//# sourceMappingURL=processors.js.map
+//# sourceMappingURL=processors.js.map

package/dist/processors.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"processors.js","sourcesContent":[]}