autotel 6.4.1 → 7.0.0

package/dist/{init-Cc7-vvzj.d.cts → init-DrlL1eis.d.cts}

@@ -1,12 +1,12 @@
-import { a as AttributeRedactorPreset, r as AttributeRedactorConfig } from "./attribute-redacting-processor-Pk7lAzWd.cjs";
-import { s as Logger } from "./logger-CN4xpzMd.cjs";
-import { h as SamplingPreset, p as Sampler } from "./sampling-BR9fkSwx.cjs";
-import { a as EventSubscriber } from "./event-subscriber-CWh8sTGh.cjs";
+import { a as AttributeRedactorPreset, r as AttributeRedactorConfig } from "./attribute-redacting-processor-CvBE0z1p.cjs";
+import { s as Logger } from "./logger-S1Fgl0g3.cjs";
+import { h as SamplingPreset, p as Sampler } from "./sampling-CmRdnXUi.cjs";
+import { o as EventSubscriber } from "./event-subscriber-DMACQA-1.cjs";
 import { r as SpanFilterPredicate } from "./filtering-span-processor-BpDagWNa.cjs";
 import { r as Policy } from "./policy-CbpP4tFH.cjs";
 import { r as SpanNameNormalizerConfig } from "./span-name-normalizer-CN1-8C76.cjs";
-import { t as CanonicalLogLineOptions } from "./canonical-log-line-processor-B4WgG-VS.cjs";
-import { SpanExporter, SpanProcessor } from "@opentelemetry/sdk-trace-base";
+import { t as CanonicalLogLineOptions } from "./canonical-log-line-processor-l0Aqe6yp.cjs";
+import { ReadableSpan, SpanExporter, SpanProcessor } from "@opentelemetry/sdk-trace-base";
 import { Attributes } from "@opentelemetry/api";
 import { Resource } from "@opentelemetry/resources";
 import { NodeSDK, NodeSDKConfiguration } from "@opentelemetry/sdk-node";
@@ -223,6 +223,73 @@ interface ProcessHandlersConfig {
   shutdownTimeoutMs?: number;
 }
 //#endregion
+//#region src/canonical-log-lines-config.d.ts
+/**
+ * Emit completed spans as canonical wide-event logs.
+ *
+ * Each span (or only each root span) becomes one comprehensive log record with
+ * all span attributes. This provides high-cardinality, structured events
+ * without scattering logging calls throughout a request.
+ *
+ * @example One canonical log line per request
+ * ```typescript
+ * init({
+ *   service: 'checkout-api',
+ *   canonicalLogLines: {
+ *     enabled: true,
+ *     rootSpansOnly: true,
+ *   },
+ * });
+ * ```
+ *
+ * @example Custom logger and message
+ * ```typescript
+ * const logger = pino();
+ * init({
+ *   service: 'checkout-api',
+ *   logger,
+ *   canonicalLogLines: {
+ *     enabled: true,
+ *     logger,
+ *     messageFormat: (span) => {
+ *       const status = span.status.code === 2 ? 'ERROR' : 'SUCCESS';
+ *       return `${span.name} [${status}]`;
+ *     },
+ *   },
+ * });
+ * ```
+ */
+interface CanonicalLogLinesConfig {
+  enabled: boolean;
+  /** Logger to use for emitting canonical log lines (defaults to OTel Logs API). */
+  logger?: Logger;
+  /** Only emit canonical log lines for root spans (default: false). */
+  rootSpansOnly?: boolean;
+  /** Minimum log level for canonical log lines (default: 'info'). */
+  minLevel?: 'debug' | 'info' | 'warn' | 'error';
+  /** Custom message format (default: uses the span name). */
+  messageFormat?: (span: ReadableSpan) => string;
+  /** Whether to include resource attributes (default: true). */
+  includeResourceAttributes?: boolean;
+  /** Predicate to decide whether to emit (runs after the event is built). */
+  shouldEmit?: CanonicalLogLineOptions['shouldEmit'];
+  /**
+   * Declarative tail sampling conditions (OR logic).
+   * Ignored when `shouldEmit` is provided.
+   * @example keep: [{ status: 500 }, { durationMs: 1000 }]
+   */
+  keep?: CanonicalLogLineOptions['keep'];
+  /** Callback invoked after emit for custom fan-out. */
+  drain?: CanonicalLogLineOptions['drain'];
+  /** Handler for drain failures. */
+  onDrainError?: CanonicalLogLineOptions['onDrainError'];
+  /**
+   * Pretty-print canonical log lines to console.
+   * Defaults to true when NODE_ENV is 'development'.
+   */
+  pretty?: boolean;
+}
+//#endregion
 //#region src/otlp-exporters.d.ts
 type OtlpSignal = 'traces' | 'metrics' | 'logs';
 interface OtlpDestinationConfig {
@@ -465,6 +532,24 @@ interface AutotelConfig {
    * ```
    */
   spanProcessors?: SpanProcessor[];
+  /**
+   * Span processors that decorate spans on the way out, running before every
+   * exporting processor.
+   *
+   * Unlike {@link spanProcessors}, which replaces the pipeline autotel would
+   * have built, these are added to it. Use them for processors that enrich
+   * rather than export, so `destinations` keeps working:
+   *
+   * @example
+   * ```typescript
+   * init({
+   *   service: 'support-agent',
+   *   destinations: [{ endpoint: `${langfuseUrl}/api/public/otel`, headers }],
+   *   spanEnrichers: [langfuseCompatibility({ tags: ['production'] })],
+   * })
+   * ```
+   */
+  spanEnrichers?: SpanProcessor[];
   /**
    * Custom span processor for traces (single-item alias of spanProcessors)
    * @deprecated Use spanProcessors for consistency with other multi-value config fields
@@ -1105,89 +1190,8 @@ interface AutotelConfig {
     enabled: boolean;
     options?: Record<string, unknown>;
   };
-  /**
-   * Canonical log lines - automatically emit spans as wide events (canonical log lines)
-   *
-   * When enabled, each span (or root span only) is automatically emitted as a
-   * comprehensive log record with ALL span attributes. This implements the
-   * "canonical log line" pattern: one comprehensive event per request with all context.
-   *
-   * **Benefits:**
-   * - One log line per request with all context (wide event)
-   * - High-cardinality, high-dimensionality data for powerful queries
-   * - Automatic - no manual logging needed
-   * - Queryable as structured data instead of string search
-   *
-   * @example Basic usage (one canonical log line per request)
-   * ```typescript
-   * init({
-   *   service: 'checkout-api',
-   *   canonicalLogLines: {
-   *     enabled: true,
-   *     rootSpansOnly: true, // One canonical log line per request
-   *   },
-   * });
-   * ```
-   *
-   * @example With custom logger
-   * ```typescript
-   * import pino from 'pino';
-   * const logger = pino();
-   * init({
-   *   service: 'my-app',
-   *   logger,
-   *   canonicalLogLines: {
-   *     enabled: true,
-   *     logger, // Use Pino for canonical log lines
-   *     rootSpansOnly: true,
-   *   },
-   * });
-   * ```
-   *
-   * @example Custom message format
-   * ```typescript
-   * init({
-   *   service: 'my-app',
-   *   canonicalLogLines: {
-   *     enabled: true,
-   *     messageFormat: (span) => {
-   *       const status = span.status.code === 2 ? 'ERROR' : 'SUCCESS';
-   *       return `${span.name} [${status}]`;
-   *     },
-   *   },
-   * });
-   * ```
-   */
-  canonicalLogLines?: {
-    enabled: boolean;
-    /** Logger to use for emitting canonical log lines (defaults to OTel Logs API) */
-    logger?: Logger;
-    /** Only emit canonical log lines for root spans (default: false) */
-    rootSpansOnly?: boolean;
-    /** Minimum log level for canonical log lines (default: 'info') */
-    minLevel?: 'debug' | 'info' | 'warn' | 'error';
-    /** Custom message format (default: uses span name) */
-    messageFormat?: (span: import('@opentelemetry/sdk-trace-base').ReadableSpan) => string;
-    /** Whether to include resource attributes (default: true) */
-    includeResourceAttributes?: boolean;
-    /** Predicate to decide whether to emit (runs after event is built). */
-    shouldEmit?: CanonicalLogLineOptions['shouldEmit'];
-    /**
-     * Declarative tail sampling conditions (OR logic).
-     * Ignored when `shouldEmit` is provided.
-     * @example keep: [{ status: 500 }, { durationMs: 1000 }]
-     */
-    keep?: CanonicalLogLineOptions['keep'];
-    /** Callback invoked after emit for custom fan-out. */
-    drain?: CanonicalLogLineOptions['drain'];
-    /** Handler for drain failures. */
-    onDrainError?: CanonicalLogLineOptions['onDrainError'];
-    /**
-     * Pretty-print canonical log lines to console.
-     * Defaults to true when NODE_ENV is 'development'.
-     */
-    pretty?: boolean;
-  };
+  /** Emit completed spans as canonical wide-event logs. */
+  canonicalLogLines?: CanonicalLogLinesConfig;
   /**
    * Suppress console output while keeping OTel exporters running.
    * Useful for platforms like GCP Cloud Run / AWS Lambda where stdout
@@ -1229,7 +1233,7 @@ declare function isLoggerLocked(): boolean;
  *
  * @example With events (observe in PostHog, Mixpanel, etc.)
  * ```typescript
- * import { PostHogSubscriber } from 'autotel-subscribers/posthog';
+ * import { PostHogSubscriber } from 'autotel-posthog/subscriber';
  *
  * init({
  *   service: 'my-app',