autotel 2.25.2 → 2.25.3

package/src/tail-sampling-processor.test.ts

@@ -4,6 +4,10 @@
 
 import { describe, it, expect, beforeEach } from 'vitest';
 import { TailSamplingSpanProcessor } from './tail-sampling-processor';
+import {
+  AUTOTEL_SAMPLING_TAIL_KEEP,
+  AUTOTEL_SAMPLING_TAIL_EVALUATED,
+} from './sampling';
 import type {
   SpanProcessor,
   ReadableSpan,
@@ -86,8 +90,8 @@ describe('TailSamplingSpanProcessor', () => {
 
     it('should forward spans marked to keep (sampling.tail.keep = true)', () => {
       const span = createMockSpan({
-        'sampling.tail.evaluated': true,
-        'sampling.tail.keep': true,
+        [AUTOTEL_SAMPLING_TAIL_EVALUATED]: true,
+        [AUTOTEL_SAMPLING_TAIL_KEEP]: true,
       });
 
       tailSamplingProcessor.onEnd(span);
@@ -100,8 +104,8 @@ describe('TailSamplingSpanProcessor', () => {
   describe('Span dropping', () => {
     it('should drop spans marked to drop (sampling.tail.keep = false)', () => {
       const span = createMockSpan({
-        'sampling.tail.evaluated': true,
-        'sampling.tail.keep': false,
+        [AUTOTEL_SAMPLING_TAIL_EVALUATED]: true,
+        [AUTOTEL_SAMPLING_TAIL_KEEP]: false,
       });
 
       tailSamplingProcessor.onEnd(span);
@@ -112,13 +116,13 @@ describe('TailSamplingSpanProcessor', () => {
 
     it('should drop multiple spans marked as false', () => {
       const span1 = createMockSpan({
-        'sampling.tail.evaluated': true,
-        'sampling.tail.keep': false,
+        [AUTOTEL_SAMPLING_TAIL_EVALUATED]: true,
+        [AUTOTEL_SAMPLING_TAIL_KEEP]: false,
       });
 
       const span2 = createMockSpan({
-        'sampling.tail.evaluated': true,
-        'sampling.tail.keep': false,
+        [AUTOTEL_SAMPLING_TAIL_EVALUATED]: true,
+        [AUTOTEL_SAMPLING_TAIL_KEEP]: false,
       });
 
       tailSamplingProcessor.onEnd(span1);
@@ -131,8 +135,8 @@ describe('TailSamplingSpanProcessor', () => {
   describe('Edge cases', () => {
     it('should forward spans when only evaluated but no keep attribute', () => {
       const span = createMockSpan({
-        'sampling.tail.evaluated': true,
-        // Missing 'sampling.tail.keep'
+        [AUTOTEL_SAMPLING_TAIL_EVALUATED]: true,
+        // Missing AUTOTEL_SAMPLING_TAIL_KEEP
       });
 
       tailSamplingProcessor.onEnd(span);
@@ -143,8 +147,8 @@ describe('TailSamplingSpanProcessor', () => {
 
     it('should forward spans when only keep but not evaluated', () => {
       const span = createMockSpan({
-        // Missing 'sampling.tail.evaluated'
-        'sampling.tail.keep': false,
+        // Missing AUTOTEL_SAMPLING_TAIL_EVALUATED
+        [AUTOTEL_SAMPLING_TAIL_KEEP]: false,
       });
 
       tailSamplingProcessor.onEnd(span);
@@ -156,12 +160,12 @@ describe('TailSamplingSpanProcessor', () => {
     it('should handle mixed spans (some kept, some dropped)', () => {
       const keptSpan1 = createMockSpan({ foo: 'bar' });
       const droppedSpan = createMockSpan({
-        'sampling.tail.evaluated': true,
-        'sampling.tail.keep': false,
+        [AUTOTEL_SAMPLING_TAIL_EVALUATED]: true,
+        [AUTOTEL_SAMPLING_TAIL_KEEP]: false,
       });
       const keptSpan2 = createMockSpan({
-        'sampling.tail.evaluated': true,
-        'sampling.tail.keep': true,
+        [AUTOTEL_SAMPLING_TAIL_EVALUATED]: true,
+        [AUTOTEL_SAMPLING_TAIL_KEEP]: true,
       });
 
       tailSamplingProcessor.onEnd(keptSpan1);
@@ -196,20 +200,20 @@ describe('TailSamplingSpanProcessor', () => {
       // 3. Error request (keep)
 
       const fastSpan = createMockSpan({
-        'sampling.tail.evaluated': true,
-        'sampling.tail.keep': false, // Fast, no errors
+        [AUTOTEL_SAMPLING_TAIL_EVALUATED]: true,
+        [AUTOTEL_SAMPLING_TAIL_KEEP]: false, // Fast, no errors
         duration: 50,
       });
 
       const slowSpan = createMockSpan({
-        'sampling.tail.evaluated': true,
-        'sampling.tail.keep': true, // Slow request
+        [AUTOTEL_SAMPLING_TAIL_EVALUATED]: true,
+        [AUTOTEL_SAMPLING_TAIL_KEEP]: true, // Slow request
         duration: 1000,
       });
 
       const errorSpan = createMockSpan({
-        'sampling.tail.evaluated': true,
-        'sampling.tail.keep': true, // Had error
+        [AUTOTEL_SAMPLING_TAIL_EVALUATED]: true,
+        [AUTOTEL_SAMPLING_TAIL_KEEP]: true, // Had error
         error: true,
       });
 

package/src/tail-sampling-processor.ts

@@ -1,14 +1,14 @@
 /**
  * Tail Sampling Span Processor
  *
- * Filters spans based on the `sampling.tail.keep` attribute set during execution.
+ * Filters spans based on the `autotel.sampling.tail.keep` attribute set during execution.
  * This enables adaptive sampling where we decide whether to keep a span AFTER
  * the operation completes, based on criteria like errors, duration, etc.
  *
  * How it works:
  * 1. Decorator creates span optimistically (head sampling returns true)
  * 2. Operation executes and completes
- * 3. Decorator calls shouldKeepTrace() and sets sampling.tail.keep attribute
+ * 3. Decorator calls shouldKeepTrace() and sets autotel.sampling.tail.keep attribute
  * 4. This processor checks the attribute and drops spans marked as false
  */
 
@@ -18,6 +18,10 @@ import type {
 } from '@opentelemetry/sdk-trace-base';
 import type { Context } from '@opentelemetry/api';
 import type { Span } from '@opentelemetry/sdk-trace-base';
+import {
+  AUTOTEL_SAMPLING_TAIL_KEEP,
+  AUTOTEL_SAMPLING_TAIL_EVALUATED,
+} from './sampling';
 
 export class TailSamplingSpanProcessor implements SpanProcessor {
   private wrappedProcessor: SpanProcessor;
@@ -31,8 +35,8 @@ export class TailSamplingSpanProcessor implements SpanProcessor {
   }
 
   onEnd(span: ReadableSpan): void {
-    const tailEvaluated = span.attributes['sampling.tail.evaluated'];
-    const shouldKeep = span.attributes['sampling.tail.keep'];
+    const tailEvaluated = span.attributes[AUTOTEL_SAMPLING_TAIL_EVALUATED];
+    const shouldKeep = span.attributes[AUTOTEL_SAMPLING_TAIL_KEEP];
 
     if (tailEvaluated === true && shouldKeep === false) {
       return;

package/src/yaml-config.test.ts

@@ -7,6 +7,7 @@ import {
 import { writeFileSync, mkdirSync, rmSync } from 'node:fs';
 import path from 'node:path';
 import { tmpdir } from 'node:os';
+import { AdaptiveSampler } from './sampling';
 
 describe('yaml-config', () => {
   const testDir = path.join(tmpdir(), `autotel-yaml-test-${Date.now()}`);
@@ -207,6 +208,76 @@ service:
     it('should throw on non-existent file', () => {
       expect(() => loadYamlConfigFromFile('/non/existent/path.yaml')).toThrow();
     });
+
+    it('should map sampling preset to config.sampling shorthand', () => {
+      const yaml = `
+sampling:
+  preset: production
+`;
+      const filePath = path.join(testDir, 'sampling-preset.yaml');
+      writeFileSync(filePath, yaml);
+
+      const config = loadYamlConfigFromFile(filePath);
+      expect(config.sampling).toBe('production');
+      expect(config.sampler).toBeUndefined();
+    });
+
+    it('should prefer sampling preset over typed sampler config', () => {
+      const yaml = `
+sampling:
+  preset: off
+  type: adaptive
+  baseline_rate: 0.5
+`;
+      const filePath = path.join(testDir, 'sampling-preset-precedence.yaml');
+      writeFileSync(filePath, yaml);
+
+      const config = loadYamlConfigFromFile(filePath);
+      expect(config.sampling).toBe('off');
+      expect(config.sampler).toBeUndefined();
+    });
+
+    it('should warn when preset is combined with ignored override fields', () => {
+      const warnSpy = vi.spyOn(console, 'warn').mockImplementation(() => {});
+      const yaml = `
+sampling:
+  preset: production
+  type: adaptive
+  baseline_rate: 0.5
+  slow_threshold_ms: 250
+`;
+      const filePath = path.join(testDir, 'sampling-preset-warning.yaml');
+      writeFileSync(filePath, yaml);
+
+      const config = loadYamlConfigFromFile(filePath);
+
+      expect(config.sampling).toBe('production');
+      expect(config.sampler).toBeUndefined();
+      expect(warnSpy).toHaveBeenCalledWith(
+        expect.stringContaining(
+          'sampling.preset="production" ignores these YAML fields',
+        ),
+      );
+      expect(warnSpy).toHaveBeenCalledWith(
+        expect.stringContaining('type, baseline_rate, slow_threshold_ms'),
+      );
+
+      warnSpy.mockRestore();
+    });
+
+    it('should still build sampler from typed YAML config without preset', () => {
+      const yaml = `
+sampling:
+  type: adaptive
+  baseline_rate: 0.25
+`;
+      const filePath = path.join(testDir, 'sampling-adaptive.yaml');
+      writeFileSync(filePath, yaml);
+
+      const config = loadYamlConfigFromFile(filePath);
+      expect(config.sampler).toBeInstanceOf(AdaptiveSampler);
+      expect(config.sampling).toBeUndefined();
+    });
   });
 
   describe('loadYamlConfig', () => {

package/src/yaml-config.ts

@@ -29,6 +29,7 @@ import {
   AlwaysSampler,
   NeverSampler,
   RandomSampler,
+  type SamplingPreset,
 } from './sampling';
 
 /**
@@ -63,6 +64,7 @@ export interface YamlConfig {
   };
   resource?: Record<string, string | number | boolean>;
   sampling?: {
+    preset?: SamplingPreset;
     type?: 'adaptive' | 'always_on' | 'always_off' | 'ratio';
     ratio?: number;
     baseline_rate?: number;
@@ -189,8 +191,13 @@ function yamlToAutotelConfig(yaml: YamlConfig): Partial<AutotelConfig> {
   if (yaml.debug !== undefined) config.debug = yaml.debug;
 
   // Sampling configuration
-  const sampler = createSamplerFromYaml(yaml.sampling);
-  if (sampler) config.sampler = sampler;
+  if (yaml.sampling?.preset) {
+    warnOnIgnoredPresetOverrides(yaml.sampling);
+    config.sampling = yaml.sampling.preset;
+  } else {
+    const sampler = createSamplerFromYaml(yaml.sampling);
+    if (sampler) config.sampler = sampler;
+  }
 
   return config;
 }
@@ -199,6 +206,7 @@ function createSamplerFromYaml(
   sampling?: YamlConfig['sampling'],
 ): AutotelConfig['sampler'] {
   if (!sampling) return undefined;
+  if (sampling.preset) return undefined;
 
   const type = sampling.type ?? 'adaptive';
 
@@ -242,6 +250,28 @@ function createSamplerFromYaml(
   }
 }
 
+function warnOnIgnoredPresetOverrides(
+  sampling: NonNullable<YamlConfig['sampling']>,
+): void {
+  const ignoredFields = [
+    'type',
+    'ratio',
+    'baseline_rate',
+    'always_sample_errors',
+    'always_sample_slow',
+    'slow_threshold_ms',
+  ].filter((field) => sampling[field as keyof typeof sampling] !== undefined);
+
+  if (ignoredFields.length === 0) {
+    return;
+  }
+
+  console.warn(
+    `[autotel] sampling.preset="${sampling.preset}" ignores these YAML fields: ${ignoredFields.join(', ')}. ` +
+      'Use the programmatic API with sampler or samplingPresets.*(...) for tuned presets.',
+  );
+}
+
 /**
  * Load and parse YAML config file (auto-discovery)
  *

package/dist/chunk-6YIDHH2S.cjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/yaml-config.ts"],"names":["requireModule","path","existsSync","AdaptiveSampler","AlwaysSampler","NeverSampler","RandomSampler","readFileSync"],"mappings":"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","file":"chunk-6YIDHH2S.cjs","sourcesContent":["/**\n * YAML configuration loader for autotel\n *\n * Supports:\n * - Auto-discovery of autotel.yaml in cwd\n * - AUTOTEL_CONFIG_FILE env var override\n * - Environment variable substitution: ${env:VAR} and ${env:VAR:-default}\n *\n * @example Auto-discovery\n * ```yaml\n * # autotel.yaml in project root\n * service:\n *   name: my-service\n * exporter:\n *   endpoint: ${env:OTEL_EXPORTER_OTLP_ENDPOINT:-http://localhost:4318}\n * ```\n *\n * @example Explicit path\n * ```bash\n * AUTOTEL_CONFIG_FILE=./config/otel.yaml tsx --import autotel/auto src/index.ts\n * ```\n */\n\nimport { readFileSync, existsSync } from 'node:fs';\nimport path from 'node:path';\nimport type { AutotelConfig } from './init';\nimport {\n  AdaptiveSampler,\n  AlwaysSampler,\n  NeverSampler,\n  RandomSampler,\n} from './sampling';\n\n/**\n * Lazy-load yaml parser (optional peer dependency)\n * Only loads when a YAML config file is actually found\n */\nimport { requireModule } from './node-require';\n\nfunction loadYamlParser(): (content: string) => unknown {\n  try {\n    const mod = requireModule<{ parse: (content: string) => unknown }>('yaml');\n    return mod.parse;\n  } catch {\n    throw new Error('YAML parser not found. Install with: pnpm add yaml');\n  }\n}\n\n/**\n * YAML config structure\n * Maps to AutotelConfig with user-friendly naming\n */\nexport interface YamlConfig {\n  service?: {\n    name?: string;\n    version?: string;\n    environment?: string;\n  };\n  exporter?: {\n    endpoint?: string;\n    protocol?: 'http' | 'grpc';\n    headers?: Record<string, string>;\n  };\n  resource?: Record<string, string | number | boolean>;\n  sampling?: {\n    type?: 'adaptive' | 'always_on' | 'always_off' | 'ratio';\n    ratio?: number;\n    baseline_rate?: number;\n    always_sample_errors?: boolean;\n    always_sample_slow?: boolean;\n    slow_threshold_ms?: number;\n  };\n  autoInstrumentations?: string[] | Record<string, { enabled?: boolean }>;\n  debug?: boolean;\n}\n\n/**\n * Environment variable substitution regex\n * Matches ${env:VAR_NAME} and ${env:VAR_NAME:-default}\n */\nconst ENV_VAR_PATTERN = /\\$\\{env:([A-Za-z_][A-Za-z0-9_]*)(?::-([^}]*))?\\}/g;\n\n/**\n * Substitute ${env:VAR} and ${env:VAR:-default} in a string\n *\n * @param value - String potentially containing env var references\n * @returns String with env vars substituted\n *\n * @example\n * substituteEnvVars('${env:NODE_ENV:-development}')\n * // Returns 'production' if NODE_ENV=production, else 'development'\n */\nfunction substituteEnvVars(value: string): string {\n  return value.replaceAll(\n    ENV_VAR_PATTERN,\n    (_match, varName: string, defaultValue?: string) => {\n      const envValue = process.env[varName];\n      if (envValue !== undefined) return envValue;\n      if (defaultValue !== undefined) return defaultValue;\n      console.warn(\n        `[autotel] Environment variable ${varName} not set and no default provided`,\n      );\n      return '';\n    },\n  );\n}\n\n/**\n * Recursively substitute env vars in an object\n *\n * @param obj - Object to process\n * @returns Object with all string values having env vars substituted\n */\nfunction substituteEnvVarsDeep(obj: unknown): unknown {\n  if (typeof obj === 'string') {\n    return substituteEnvVars(obj);\n  }\n  if (Array.isArray(obj)) {\n    return obj.map((item) => substituteEnvVarsDeep(item));\n  }\n  if (obj && typeof obj === 'object') {\n    const result: Record<string, unknown> = {};\n    for (const [key, value] of Object.entries(obj)) {\n      result[key] = substituteEnvVarsDeep(value);\n    }\n    return result;\n  }\n  return obj;\n}\n\n/**\n * Find YAML config file path\n *\n * Priority:\n * 1. AUTOTEL_CONFIG_FILE env var (explicit path)\n * 2. autotel.yaml in cwd (convention)\n * 3. autotel.yml in cwd (alternative extension)\n *\n * @returns File path if found, null otherwise\n */\nfunction findConfigFile(): string | null {\n  // Check env var first (explicit takes priority)\n  const envPath = process.env.AUTOTEL_CONFIG_FILE;\n  if (envPath) {\n    const resolved = path.resolve(envPath);\n    if (existsSync(resolved)) return resolved;\n    console.warn(`[autotel] Config file not found: ${envPath}`);\n    return null;\n  }\n\n  // Auto-discover autotel.yaml in cwd\n  const conventionPath = path.resolve(process.cwd(), 'autotel.yaml');\n  if (existsSync(conventionPath)) return conventionPath;\n\n  // Also check .yml extension\n  const altPath = path.resolve(process.cwd(), 'autotel.yml');\n  if (existsSync(altPath)) return altPath;\n\n  return null;\n}\n\n/**\n * Convert YAML config structure to AutotelConfig\n *\n * @param yaml - Parsed and env-substituted YAML config\n * @returns Partial AutotelConfig ready for merging\n */\nfunction yamlToAutotelConfig(yaml: YamlConfig): Partial<AutotelConfig> {\n  const config: Partial<AutotelConfig> = {};\n\n  // Service configuration\n  if (yaml.service?.name) config.service = yaml.service.name;\n  if (yaml.service?.version) config.version = yaml.service.version;\n  if (yaml.service?.environment) config.environment = yaml.service.environment;\n\n  // Exporter configuration\n  if (yaml.exporter?.endpoint) config.endpoint = yaml.exporter.endpoint;\n  if (yaml.exporter?.protocol) config.protocol = yaml.exporter.protocol;\n  if (yaml.exporter?.headers) config.headers = yaml.exporter.headers;\n\n  // Resource attributes (flattened)\n  if (yaml.resource) config.resourceAttributes = yaml.resource;\n\n  // Integrations\n  if (yaml.autoInstrumentations)\n    config.autoInstrumentations = yaml.autoInstrumentations;\n\n  // Debug mode\n  if (yaml.debug !== undefined) config.debug = yaml.debug;\n\n  // Sampling configuration\n  const sampler = createSamplerFromYaml(yaml.sampling);\n  if (sampler) config.sampler = sampler;\n\n  return config;\n}\n\nfunction createSamplerFromYaml(\n  sampling?: YamlConfig['sampling'],\n): AutotelConfig['sampler'] {\n  if (!sampling) return undefined;\n\n  const type = sampling.type ?? 'adaptive';\n\n  try {\n    switch (type) {\n      case 'adaptive': {\n        return new AdaptiveSampler({\n          baselineSampleRate: sampling.baseline_rate,\n          alwaysSampleErrors: sampling.always_sample_errors,\n          alwaysSampleSlow: sampling.always_sample_slow,\n          slowThresholdMs: sampling.slow_threshold_ms,\n        });\n      }\n      case 'always_on': {\n        return new AlwaysSampler();\n      }\n      case 'always_off': {\n        return new NeverSampler();\n      }\n      case 'ratio': {\n        if (sampling.ratio === undefined) {\n          console.warn(\n            '[autotel] sampling.ratio missing in YAML sampling config. Falling back to adaptive sampler.',\n          );\n          return new AdaptiveSampler();\n        }\n        return new RandomSampler(sampling.ratio);\n      }\n      default: {\n        console.warn(\n          `[autotel] Unknown sampling type \"${type}\" in YAML config. Falling back to defaults.`,\n        );\n        return undefined;\n      }\n    }\n  } catch (error) {\n    console.warn(\n      `[autotel] Failed to configure sampling from YAML: ${error instanceof Error ? error.message : String(error)}`,\n    );\n    return undefined;\n  }\n}\n\n/**\n * Load and parse YAML config file (auto-discovery)\n *\n * Automatically finds and loads autotel.yaml or uses AUTOTEL_CONFIG_FILE.\n * Returns null if no config file found (not an error - YAML config is optional).\n *\n * @returns Partial AutotelConfig or null if no config file found\n *\n * @example\n * const yamlConfig = loadYamlConfig();\n * if (yamlConfig) {\n *   init({ ...yamlConfig, debug: true });\n * }\n */\nexport function loadYamlConfig(): Partial<AutotelConfig> | null {\n  const filePath = findConfigFile();\n  if (!filePath) return null;\n\n  try {\n    const content = readFileSync(filePath, 'utf8');\n    const parseYaml = loadYamlParser();\n    const rawYaml = parseYaml(content) as YamlConfig;\n    const substituted = substituteEnvVarsDeep(rawYaml) as YamlConfig;\n    return yamlToAutotelConfig(substituted);\n  } catch (error) {\n    console.error(\n      `[autotel] Failed to load YAML config from ${filePath}:`,\n      error,\n    );\n    return null;\n  }\n}\n\n/**\n * Load YAML config from a specific file path\n *\n * Unlike loadYamlConfig(), this throws if the file cannot be read.\n *\n * @param filePath - Path to YAML config file\n * @returns Partial AutotelConfig\n * @throws Error if file cannot be read or parsed\n *\n * @example\n * import { loadYamlConfigFromFile } from 'autotel/yaml';\n * import { init } from 'autotel';\n *\n * const config = loadYamlConfigFromFile('./config/otel.yaml');\n * init({ ...config, debug: true });\n */\nexport function loadYamlConfigFromFile(\n  filePath: string,\n): Partial<AutotelConfig> {\n  const resolved = path.resolve(filePath);\n  const content = readFileSync(resolved, 'utf8');\n  const parseYaml = loadYamlParser();\n  const rawYaml = parseYaml(content) as YamlConfig;\n  const substituted = substituteEnvVarsDeep(rawYaml) as YamlConfig;\n  return yamlToAutotelConfig(substituted);\n}\n\n/**\n * Check if a YAML config file exists (without loading it)\n *\n * @returns true if a config file would be found by loadYamlConfig()\n */\nexport function hasYamlConfig(): boolean {\n  return findConfigFile() !== null;\n}\n"]}

package/dist/chunk-BGVKKL2N.cjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/sampling.ts"],"names":["TraceFlags"],"mappings":"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","file":"chunk-BGVKKL2N.cjs","sourcesContent":["/**\n * Sampling Strategies\n *\n * Provides intelligent sampling beyond simple random rates.\n * Helps reduce telemetry costs while capturing critical data.\n *\n * Key strategies:\n * - Always trace errors and slow requests (critical for debugging)\n * - Sample by user ID for consistent request tracing\n * - Adaptive sampling based on load\n * - Sample by feature flags for A/B testing correlation\n *\n * @example\n * ```typescript\n * import { AlwaysOnErrorSampler, UserIdSampler } from './sampling'\n *\n * @Instrumented({\n *   serviceName: 'user',\n *   sampler: new AlwaysOnErrorSampler(0.1) // 10% baseline, 100% on errors\n * })\n * class UserService { }\n * ```\n */\n\nimport type { Link, Attributes } from '@opentelemetry/api';\nimport { TraceFlags } from '@opentelemetry/api';\nimport { type Logger } from './logger';\n\n/**\n * Sampler interface - return true to trace, false to skip\n */\nexport interface Sampler {\n  /**\n   * Decide whether to trace this operation\n   *\n   * @param context - Sampling context\n   * @returns true to trace, false to skip\n   */\n  shouldSample(context: SamplingContext): boolean;\n\n  /**\n   * Whether this sampler needs tail sampling (post-execution decision)\n   * If true, spans are always created and shouldKeepTrace() is called after execution\n   *\n   * @returns true if this sampler needs to evaluate after operation completes\n   */\n  needsTailSampling?(): boolean;\n\n  /**\n   * Re-evaluate sampling decision after operation completes (tail sampling)\n   * Only called if needsTailSampling() returns true\n   *\n   * @param context - Sampling context\n   * @param result - Operation result\n   * @returns true if this trace should be kept, false to drop it\n   */\n  shouldKeepTrace?(context: SamplingContext, result: OperationResult): boolean;\n}\n\n/**\n * Context information for sampling decisions\n */\nexport interface SamplingContext {\n  /** Operation name */\n  operationName: string;\n  /** Method arguments (for extracting user IDs, etc.) */\n  args: unknown[];\n  /** Optional metadata (e.g., feature flags, request headers) */\n  metadata?: Record<string, unknown>;\n  /** Optional span links for links-based sampling */\n  links?: Link[];\n}\n\n/**\n * Result of a trace operation (for post-execution sampling)\n */\nexport interface OperationResult {\n  /** Whether the operation succeeded */\n  success: boolean;\n  /** Duration in milliseconds */\n  duration: number;\n  /** Error if operation failed */\n  error?: Error;\n}\n\n/**\n * Simple random sampler\n *\n * @example\n * ```typescript\n * new RandomSampler(0.1) // Sample 10% of requests\n * ```\n */\nexport class RandomSampler implements Sampler {\n  constructor(private readonly sampleRate: number) {\n    if (sampleRate < 0 || sampleRate > 1) {\n      throw new Error('Sample rate must be between 0 and 1');\n    }\n  }\n\n  // eslint-disable-next-line @typescript-eslint/no-unused-vars\n  shouldSample(_context: SamplingContext): boolean {\n    return Math.random() < this.sampleRate;\n  }\n}\n\n/**\n * Always sample (100% tracing)\n */\nexport class AlwaysSampler implements Sampler {\n  // eslint-disable-next-line @typescript-eslint/no-unused-vars\n  shouldSample(_context: SamplingContext): boolean {\n    return true;\n  }\n}\n\n/**\n * Never sample (0% tracing)\n */\nexport class NeverSampler implements Sampler {\n  // eslint-disable-next-line @typescript-eslint/no-unused-vars\n  shouldSample(_context: SamplingContext): boolean {\n    return false;\n  }\n}\n\n/**\n * Adaptive sampler that always traces errors and slow requests\n *\n * This is the recommended sampler for production use.\n * It ensures you never miss critical issues while keeping costs down.\n *\n * Strategy:\n * - Always trace errors (critical for debugging)\n * - Always trace slow requests (performance issues)\n * - Use baseline sample rate for successful fast requests\n *\n * **IMPORTANT - Tail Sampling Requirement:**\n * This sampler uses tail sampling (makes decisions AFTER execution).\n * You MUST use TailSamplingSpanProcessor for it to work correctly:\n *\n * - If using initInstrumentation(): TailSamplingSpanProcessor is auto-configured\n * - If using custom TracerProvider: You MUST manually register TailSamplingSpanProcessor\n *\n * Without TailSamplingSpanProcessor, ALL spans are exported (defeating the cost savings).\n *\n * @see TailSamplingSpanProcessor\n * @see README.md \"Tail Sampling with Custom Providers\" section\n *\n * @example\n * ```typescript\n * new AdaptiveSampler({\n *   baselineSampleRate: 0.1,    // 10% of normal requests\n *   slowThresholdMs: 1000,       // Requests > 1s are \"slow\"\n *   alwaysSampleErrors: true,    // Always trace errors\n *   alwaysSampleSlow: true       // Always trace slow requests\n * })\n * ```\n */\nexport class AdaptiveSampler implements Sampler {\n  private baselineSampleRate: number;\n  private slowThresholdMs: number;\n  private alwaysSampleErrors: boolean;\n  private alwaysSampleSlow: boolean;\n  private linksBased: boolean;\n  private linksRate: number;\n  private logger?: Logger;\n\n  // Track whether we should sample this request\n  private readonly samplingDecisions = new WeakMap<unknown[], boolean>();\n  // Track operation results to enable post-execution decision\n  private readonly operationResults = new WeakMap<unknown[], OperationResult>();\n\n  constructor(\n    options: {\n      baselineSampleRate?: number;\n      slowThresholdMs?: number;\n      alwaysSampleErrors?: boolean;\n      alwaysSampleSlow?: boolean;\n      /** Enable links-based sampling for event-driven architectures */\n      linksBased?: boolean;\n      /** Sampling rate for spans linked to sampled spans (0.0-1.0) */\n      linksRate?: number;\n      logger?: Logger;\n    } = {},\n  ) {\n    this.baselineSampleRate = options.baselineSampleRate ?? 0.1;\n    this.slowThresholdMs = options.slowThresholdMs ?? 1000;\n    this.alwaysSampleErrors = options.alwaysSampleErrors ?? true;\n    this.alwaysSampleSlow = options.alwaysSampleSlow ?? true;\n    this.linksBased = options.linksBased ?? false;\n    this.linksRate = options.linksRate ?? 1;\n    this.logger = options.logger;\n\n    if (this.baselineSampleRate < 0 || this.baselineSampleRate > 1) {\n      throw new Error('Baseline sample rate must be between 0 and 1');\n    }\n    if (this.linksRate < 0 || this.linksRate > 1) {\n      throw new Error('Links rate must be between 0 and 1');\n    }\n  }\n\n  needsTailSampling(): boolean {\n    // AdaptiveSampler ALWAYS needs tail sampling to implement error/slow capture\n    return true;\n  }\n\n  shouldSample(context: SamplingContext): boolean {\n    // For tail sampling, we optimistically create spans for all requests\n    // The real decision happens in shouldKeepTrace() after execution\n    // We still store the baseline decision for shouldKeepTrace() to use\n    const baselineDecision = Math.random() < this.baselineSampleRate;\n    this.samplingDecisions.set(context.args, baselineDecision);\n\n    // Always return true to create the span (tail sampling will decide if we keep it)\n    return true;\n  }\n\n  /**\n   * Check if any links point to sampled spans.\n   *\n   * A span is considered linked to a sampled span if any of its links\n   * have trace_flags with the sampled bit set (0x01).\n   *\n   * @param links - Array of span links to check\n   * @returns true if any linked span is sampled, false otherwise\n   */\n  hasSampledLink(links: Link[]): boolean {\n    if (!links || links.length === 0) {\n      return false;\n    }\n    return links.some(\n      (link) =>\n        link.context && (link.context.traceFlags & TraceFlags.SAMPLED) !== 0,\n    );\n  }\n\n  /**\n   * Re-evaluate sampling decision after operation completes\n   *\n   * This allows us to always capture errors and slow requests,\n   * even if they weren't initially sampled.\n   *\n   * @param context - Sampling context\n   * @param result - Operation result\n   * @returns true if this operation should be kept (not discarded)\n   */\n  shouldKeepTrace(context: SamplingContext, result: OperationResult): boolean {\n    const baselineDecision = this.samplingDecisions.get(context.args) ?? false;\n\n    // Always keep errors\n    if (this.alwaysSampleErrors && !result.success) {\n      if (!baselineDecision) {\n        this.logger?.debug(\n          {\n            operation: context.operationName,\n            error: result.error?.message,\n          },\n          'Adaptive sampling: Keeping error trace',\n        );\n      }\n      return true;\n    }\n\n    // Always keep slow requests\n    if (this.alwaysSampleSlow && result.duration >= this.slowThresholdMs) {\n      if (!baselineDecision) {\n        this.logger?.debug(\n          {\n            operation: context.operationName,\n            duration: result.duration,\n          },\n          'Adaptive sampling: Keeping slow trace',\n        );\n      }\n      return true;\n    }\n\n    // Check for sampled links (links-based sampling for event-driven systems)\n    if (\n      this.linksBased &&\n      context.links &&\n      this.hasSampledLink(context.links)\n    ) {\n      // Use linksRate to decide whether to keep the linked span\n      const keepLinked = Math.random() < this.linksRate;\n      if (keepLinked && !baselineDecision) {\n        this.logger?.debug(\n          {\n            operation: context.operationName,\n            linkCount: context.links.length,\n          },\n          'Adaptive sampling: Keeping trace due to sampled link',\n        );\n      }\n      return keepLinked;\n    }\n\n    // Otherwise, use baseline decision\n    return baselineDecision;\n  }\n}\n\n/**\n * User-based sampler for consistent tracing\n *\n * Always samples requests from specific user IDs.\n * Useful for debugging specific user issues or monitoring VIP users.\n *\n * @example\n * ```typescript\n * new UserIdSampler({\n *   baselineSampleRate: 0.01,      // 1% of normal users\n *   alwaysSampleUsers: ['vip_123'], // Always trace VIP users\n *   extractUserId: (args) => args[0]?.userId // Extract user ID from first arg\n * })\n * ```\n */\nexport class UserIdSampler implements Sampler {\n  private baselineSampleRate: number;\n  private alwaysSampleUsers: Set<string>;\n  private extractUserId: (args: unknown[]) => string | undefined;\n  private logger?: Logger;\n\n  constructor(options: {\n    baselineSampleRate?: number;\n    alwaysSampleUsers?: string[];\n    extractUserId: (args: unknown[]) => string | undefined;\n    logger?: Logger;\n  }) {\n    this.baselineSampleRate = options.baselineSampleRate ?? 0.1;\n    this.alwaysSampleUsers = new Set(options.alwaysSampleUsers || []);\n    this.extractUserId = options.extractUserId;\n    this.logger = options.logger;\n  }\n\n  shouldSample(context: SamplingContext): boolean {\n    const userId = this.extractUserId(context.args);\n\n    // Always sample specific users\n    if (userId && this.alwaysSampleUsers.has(userId)) {\n      this.logger?.debug(\n        {\n          operation: context.operationName,\n          userId,\n        },\n        'Sampling user request',\n      );\n      return true;\n    }\n\n    // For consistent per-user sampling, hash the user ID\n    if (userId) {\n      const hash = this.hashString(userId);\n      return hash < this.baselineSampleRate;\n    }\n\n    // Fallback to random sampling if no user ID\n    return Math.random() < this.baselineSampleRate;\n  }\n\n  /**\n   * Add user IDs to always-sample list\n   */\n  addAlwaysSampleUsers(...userIds: string[]): void {\n    for (const userId of userIds) {\n      this.alwaysSampleUsers.add(userId);\n    }\n  }\n\n  /**\n   * Remove user IDs from always-sample list\n   */\n  removeAlwaysSampleUsers(...userIds: string[]): void {\n    for (const userId of userIds) {\n      this.alwaysSampleUsers.delete(userId);\n    }\n  }\n\n  /**\n   * Simple hash function for consistent user sampling\n   */\n  private hashString(str: string): number {\n    let hash = 0;\n    for (let i = 0; i < str.length; i++) {\n      const char = str.codePointAt(i) ?? 0;\n      hash = (hash << 5) - hash + char;\n      hash = hash & hash; // Convert to 32-bit integer\n    }\n    return Math.abs(hash) / 2_147_483_647; // Normalize to 0-1\n  }\n}\n\n/**\n * Composite sampler that combines multiple samplers\n *\n * Samples if ANY of the child samplers returns true.\n *\n * @example\n * ```typescript\n * new CompositeSampler([\n *   new UserIdSampler({ extractUserId: (args) => args[0]?.userId }),\n *   new AdaptiveSampler({ baselineSampleRate: 0.1 })\n * ])\n * ```\n */\nexport class CompositeSampler implements Sampler {\n  constructor(private readonly samplers: Sampler[]) {\n    if (samplers.length === 0) {\n      throw new Error('CompositeSampler requires at least one child sampler');\n    }\n  }\n\n  shouldSample(context: SamplingContext): boolean {\n    return this.samplers.some((sampler) => sampler.shouldSample(context));\n  }\n}\n\n/**\n * Feature flag sampler\n *\n * Always samples requests with specific feature flags enabled.\n * Perfect for correlating A/B test experiments with metrics.\n *\n * @example\n * ```typescript\n * new FeatureFlagSampler({\n *   baselineSampleRate: 0.01,\n *   alwaysSampleFlags: ['new_checkout', 'experimental_ui'],\n *   extractFlags: (args, metadata) => metadata?.featureFlags\n * })\n * ```\n */\nexport class FeatureFlagSampler implements Sampler {\n  private baselineSampleRate: number;\n  private alwaysSampleFlags: Set<string>;\n  private extractFlags: (\n    args: unknown[],\n    metadata?: Record<string, unknown>,\n  ) => string[] | undefined;\n  private logger?: Logger;\n\n  constructor(options: {\n    baselineSampleRate?: number;\n    alwaysSampleFlags?: string[];\n    extractFlags: (\n      args: unknown[],\n      metadata?: Record<string, unknown>,\n    ) => string[] | undefined;\n    logger?: Logger;\n  }) {\n    this.baselineSampleRate = options.baselineSampleRate ?? 0.1;\n    this.alwaysSampleFlags = new Set(options.alwaysSampleFlags || []);\n    this.extractFlags = options.extractFlags;\n    this.logger = options.logger;\n  }\n\n  shouldSample(context: SamplingContext): boolean {\n    const flags = this.extractFlags(context.args, context.metadata);\n\n    // Always sample if any monitored flag is enabled\n    if (flags && flags.some((flag) => this.alwaysSampleFlags.has(flag))) {\n      this.logger?.debug(\n        {\n          operation: context.operationName,\n          flags,\n        },\n        'Sampling feature flag request',\n      );\n      return true;\n    }\n\n    // Fallback to random sampling\n    return Math.random() < this.baselineSampleRate;\n  }\n\n  /**\n   * Add feature flags to always-sample list\n   */\n  addAlwaysSampleFlags(...flags: string[]): void {\n    for (const flag of flags) {\n      this.alwaysSampleFlags.add(flag);\n    }\n  }\n\n  /**\n   * Remove feature flags from always-sample list\n   */\n  removeAlwaysSampleFlags(...flags: string[]): void {\n    for (const flag of flags) {\n      this.alwaysSampleFlags.delete(flag);\n    }\n  }\n}\n\n// ============================================================================\n// Link Helper Functions\n// ============================================================================\n\n/**\n * Create a Link from W3C trace context headers (e.g., from a message queue).\n *\n * This is useful for message consumers that need to link to the producer span.\n * The headers should contain at least a `traceparent` header in W3C format.\n *\n * @param headers - Dictionary containing traceparent/tracestate headers\n * @param attributes - Optional attributes for the link\n * @returns Link object if context could be extracted, null otherwise\n *\n * @example\n * ```typescript\n * // In a Kafka consumer\n * const headers = { traceparent: '00-abc123...-def456...-01' };\n * const link = createLinkFromHeaders(headers);\n * if (link) {\n *   // Use with tracer.startActiveSpan options or ctx.addLink()\n *   tracer.startActiveSpan('process.message', { links: [link] }, span => { ... });\n * }\n * ```\n */\nexport function createLinkFromHeaders(\n  headers: Record<string, string>,\n  attributes?: Attributes,\n): Link | null {\n  // Parse W3C traceparent header directly for reliability\n  // Format: version-traceId-spanId-traceFlags (e.g., 00-abc123...-def456...-01)\n  const traceparent = headers.traceparent || headers['traceparent'];\n  if (!traceparent) {\n    return null;\n  }\n\n  const spanContext = parseTraceparent(traceparent);\n  if (!spanContext || !isValidSpanContext(spanContext)) {\n    return null;\n  }\n\n  return {\n    context: spanContext,\n    attributes: attributes ?? {},\n  };\n}\n\n/**\n * Extract Links from a batch of messages for fan-in scenarios.\n *\n * Useful for batch processing where multiple producer spans should be linked.\n * This enables tracing causality in event-driven architectures where a single\n * consumer processes messages from multiple producers.\n *\n * @param messages - List of message objects\n * @param headersKey - Key in each message containing trace headers (default: 'headers')\n * @returns List of Link objects for all valid trace contexts\n *\n * @example\n * ```typescript\n * // Processing a batch of SQS/Kafka messages\n * const messages = [\n *   { body: '...', headers: { traceparent: '...' } },\n *   { body: '...', headers: { traceparent: '...' } },\n * ];\n * const links = extractLinksFromBatch(messages);\n *\n * tracer.startActiveSpan('process.batch', { links }, span => {\n *   for (const msg of messages) {\n *     processMessage(msg);\n *   }\n * });\n * ```\n */\nexport function extractLinksFromBatch(\n  messages: Array<{ [key: string]: unknown }>,\n  headersKey: string = 'headers',\n): Link[] {\n  const links: Link[] = [];\n\n  for (const msg of messages) {\n    const msgHeaders = msg[headersKey];\n    if (msgHeaders && typeof msgHeaders === 'object' && msgHeaders !== null) {\n      const link = createLinkFromHeaders(msgHeaders as Record<string, string>, {\n        'messaging.batch.message_index': links.length,\n      });\n      if (link) {\n        links.push(link);\n      }\n    }\n  }\n\n  return links;\n}\n\n/**\n * Parse W3C traceparent header into SpanContext\n * Format: version-traceId-spanId-traceFlags (e.g., 00-abc123...-def456...-01)\n *\n * @see https://www.w3.org/TR/trace-context/#traceparent-header\n */\nfunction parseTraceparent(\n  traceparent: string,\n): import('@opentelemetry/api').SpanContext | null {\n  // W3C traceparent format: version-traceId-parentId-traceFlags\n  // Example: 00-0af7651916cd43dd8448eb211c80319c-b7ad6b7169203331-01\n  const TRACEPARENT_REGEX =\n    /^([0-9a-f]{2})-([0-9a-f]{32})-([0-9a-f]{16})-([0-9a-f]{2})$/i;\n\n  const match = traceparent.match(TRACEPARENT_REGEX);\n  if (!match || match.length < 5) {\n    return null;\n  }\n\n  const version = match[1];\n  const traceId = match[2];\n  const spanId = match[3];\n  const flags = match[4];\n\n  // Validate all parts are present (TypeScript narrowing)\n  if (!version || !traceId || !spanId || !flags) {\n    return null;\n  }\n\n  // Version 00 is currently the only version, but we should be forward compatible\n  if (version === 'ff') {\n    // Version ff is invalid according to spec\n    return null;\n  }\n\n  return {\n    traceId,\n    spanId,\n    traceFlags: Number.parseInt(flags, 16),\n    isRemote: true,\n  };\n}\n\n/**\n * Check if a SpanContext is valid (has non-zero trace and span IDs)\n */\nfunction isValidSpanContext(\n  spanContext: import('@opentelemetry/api').SpanContext | null,\n): spanContext is import('@opentelemetry/api').SpanContext {\n  if (!spanContext) return false;\n  // TraceId should not be all zeros (00000000000000000000000000000000)\n  // SpanId should not be all zeros (0000000000000000)\n  return (\n    spanContext.traceId !== '00000000000000000000000000000000' &&\n    spanContext.spanId !== '0000000000000000'\n  );\n}\n"]}

package/dist/chunk-GVLK7YUU.cjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/tail-sampling-processor.ts"],"names":[],"mappings":";;;AAqBO,IAAM,4BAAN,MAAyD;AAAA,EACtD,gBAAA;AAAA,EAER,YAAY,gBAAA,EAAiC;AAC3C,IAAA,IAAA,CAAK,gBAAA,GAAmB,gBAAA;AAAA,EAC1B;AAAA,EAEA,OAAA,CAAQ,MAAY,aAAA,EAA8B;AAChD,IAAA,IAAA,CAAK,gBAAA,CAAiB,OAAA,CAAQ,IAAA,EAAM,aAAa,CAAA;AAAA,EACnD;AAAA,EAEA,MAAM,IAAA,EAA0B;AAC9B,IAAA,MAAM,aAAA,GAAgB,IAAA,CAAK,UAAA,CAAW,yBAAyB,CAAA;AAC/D,IAAA,MAAM,UAAA,GAAa,IAAA,CAAK,UAAA,CAAW,oBAAoB,CAAA;AAEvD,IAAA,IAAI,aAAA,KAAkB,IAAA,IAAQ,UAAA,KAAe,KAAA,EAAO;AAClD,MAAA;AAAA,IACF;AAEA,IAAA,IAAA,CAAK,gBAAA,CAAiB,MAAM,IAAI,CAAA;AAAA,EAClC;AAAA,EAEA,UAAA,GAA4B;AAC1B,IAAA,OAAO,IAAA,CAAK,iBAAiB,UAAA,EAAW;AAAA,EAC1C;AAAA,EAEA,QAAA,GAA0B;AACxB,IAAA,OAAO,IAAA,CAAK,iBAAiB,QAAA,EAAS;AAAA,EACxC;AACF","file":"chunk-GVLK7YUU.cjs","sourcesContent":["/**\n * Tail Sampling Span Processor\n *\n * Filters spans based on the `sampling.tail.keep` attribute set during execution.\n * This enables adaptive sampling where we decide whether to keep a span AFTER\n * the operation completes, based on criteria like errors, duration, etc.\n *\n * How it works:\n * 1. Decorator creates span optimistically (head sampling returns true)\n * 2. Operation executes and completes\n * 3. Decorator calls shouldKeepTrace() and sets sampling.tail.keep attribute\n * 4. This processor checks the attribute and drops spans marked as false\n */\n\nimport type {\n  SpanProcessor,\n  ReadableSpan,\n} from '@opentelemetry/sdk-trace-base';\nimport type { Context } from '@opentelemetry/api';\nimport type { Span } from '@opentelemetry/sdk-trace-base';\n\nexport class TailSamplingSpanProcessor implements SpanProcessor {\n  private wrappedProcessor: SpanProcessor;\n\n  constructor(wrappedProcessor: SpanProcessor) {\n    this.wrappedProcessor = wrappedProcessor;\n  }\n\n  onStart(span: Span, parentContext: Context): void {\n    this.wrappedProcessor.onStart(span, parentContext);\n  }\n\n  onEnd(span: ReadableSpan): void {\n    const tailEvaluated = span.attributes['sampling.tail.evaluated'];\n    const shouldKeep = span.attributes['sampling.tail.keep'];\n\n    if (tailEvaluated === true && shouldKeep === false) {\n      return;\n    }\n\n    this.wrappedProcessor.onEnd(span);\n  }\n\n  forceFlush(): Promise<void> {\n    return this.wrappedProcessor.forceFlush();\n  }\n\n  shutdown(): Promise<void> {\n    return this.wrappedProcessor.shutdown();\n  }\n}\n"]}