autotel 4.1.0 → 4.2.0

package/src/index.ts

@@ -1,433 +0,0 @@
-/**
- * autotel - Simplified OpenTelemetry instrumentation
- *
- * @example Minimal setup
- * ```typescript
- * import { init, trace, track } from 'autotel'
- *
- * init({ service: 'my-app' })
- *
- * export const createUser = trace(ctx => async (data: CreateUserData) => {
- *   track('user.signup', { userId: data.id, plan: data.plan })
- * })
- * ```
- *
- * @example With events
- * ```typescript
- * import { init, trace, track } from 'autotel'
- * import { PostHogSubscriber } from 'autotel-subscribers'
- *
- * init({
- *   service: 'my-app',
- *   subscribers: [new PostHogSubscriber({ apiKey: '...' })]
- * })
- *
- * export const createUser = trace(ctx => async (data: CreateUserData) => {
- *   track('user.signup', { userId: data.id })
- * })
- * ```
- */
-
-// Core initialization
-export {
-  init,
-  isInitialized,
-  lockLogger,
-  isLoggerLocked,
-  type AutotelConfig,
-} from './init';
-
-// Baggage span processor
-export {
-  BaggageSpanProcessor,
-  type BaggageSpanProcessorOptions,
-} from './baggage-span-processor';
-
-// Filtering span processor
-export {
-  FilteringSpanProcessor,
-  type SpanFilterPredicate,
-  type FilteringSpanProcessorOptions,
-} from './filtering-span-processor';
-
-// Span name normalizer
-export {
-  SpanNameNormalizingProcessor,
-  NORMALIZER_PATTERNS,
-  NORMALIZER_PRESETS,
-  type SpanNameNormalizerFn,
-  type SpanNameNormalizerPreset,
-  type SpanNameNormalizerConfig,
-  type SpanNameNormalizingProcessorOptions,
-} from './span-name-normalizer';
-
-// Attribute redacting processor
-export {
-  AttributeRedactingProcessor,
-  REDACTOR_PATTERNS,
-  REDACTOR_PRESETS,
-  builtinPatterns,
-  createAttributeRedactor,
-  createRedactedSpan,
-  normalizeAttributeRedactorConfig,
-  type AttributeRedactorFn,
-  type AttributeRedactorPreset,
-  type AttributeRedactorConfig,
-  type AttributeRedactingProcessorOptions,
-  type BuiltinPatternName,
-  type MaskFn,
-  type ValuePatternConfig,
-} from './attribute-redacting-processor';
-
-// String redaction utility
-export { createStringRedactor, type StringRedactor } from './redact-values';
-
-// Functional API (re-export for convenience)
-export type {
-  TraceContext,
-  SpanOptions,
-  WithNewContextOptions,
-  WithBaggageOptions,
-  InstrumentOptions,
-} from './functional';
-export {
-  instrument,
-  withTracing,
-  span,
-  withNewContext,
-  withBaggage,
-  ctx,
-  markAsImmediate,
-} from './functional';
-// `trace` is the hybrid: callable like autotel's `trace(fn)` AND carries the
-// full `@opentelemetry/api` TraceAPI surface (getActiveSpan, getTracer, etc).
-export { trace } from './trace-hybrid';
-
-// Operation context (for advanced usage)
-export type { OperationContext } from './operation-context';
-export {
-  getOperationContext,
-  runInOperationContext,
-} from './operation-context';
-
-// Global track function
-export { track, getEventQueue } from './track';
-export {
-  defineEvent,
-  type SchemaLike,
-  type DefineEventOptions,
-  type DefinedEvent,
-} from './define-event';
-
-// Correlation ID utilities
-export {
-  getCorrelationId,
-  getOrCreateCorrelationId,
-  generateCorrelationId,
-  runWithCorrelationId,
-  setCorrelationId,
-  setCorrelationIdInBaggage,
-  CORRELATION_ID_BAGGAGE_KEY,
-} from './correlation-id';
-
-// Graceful shutdown
-export { flush, shutdown } from './shutdown';
-
-// Request logger
-export {
-  getRequestLogger,
-  getRequestLoggerSafe,
-  createNoopRequestLogger,
-  hasRequestContext,
-  runWithRequestContext,
-  type RequestLogger,
-  type RequestLogSnapshot,
-  type RequestLoggerOptions,
-  type ForkLifecycle,
-  type ForkOptions,
-} from './request-logger';
-
-// Structured errors
-export {
-  createStructuredError,
-  structuredErrorToJSON,
-  getStructuredErrorAttributes,
-  recordStructuredError,
-  type StructuredError,
-  type StructuredErrorInput,
-} from './structured-error';
-
-// parseError
-export { parseError, type ParsedError } from './parse-error';
-
-// Typed error + audit catalogs
-export {
-  defineErrorCatalog,
-  defineAuditCatalog,
-  isCatalogError,
-  getCatalogCode,
-  type ErrorCatalog,
-  type ErrorCatalogEntry,
-  type ErrorBuilder,
-  type ErrorBuildOptions,
-  type AuditCatalog,
-  type AuditCatalogEntry,
-  type AuditDescriptor,
-  type AuditAction,
-  type AuditSeverity,
-} from './error-catalog';
-
-// Attribute flattening
-export { toAttributeValue, flattenToAttributes } from './flatten-attributes';
-
-// Drain pipeline
-export {
-  createDrainPipeline,
-  type DrainPipelineOptions,
-  type PipelineDrainFn,
-} from './drain-pipeline';
-export {
-  defineDrain,
-  defineHttpDrain,
-  type DrainOptions,
-  type HttpDrainOptions,
-  type HttpDrainRequest,
-} from './drain-toolkit';
-export {
-  defineEnricher,
-  type EnricherDefinition,
-  type EnrichContext,
-  type EnricherOptions,
-} from './enricher-toolkit';
-
-// Pretty log formatting
-export { formatDuration } from './pretty-log-formatter';
-
-// Re-export sampling strategies
-export {
-  type Sampler,
-  type SamplingContext,
-  type SamplingPreset,
-  AlwaysSampler,
-  NeverSampler,
-  RandomSampler,
-  AdaptiveSampler,
-  UserIdSampler,
-  createLinkFromHeaders,
-  extractLinksFromBatch,
-  samplingPresets,
-  resolveSamplingPreset,
-  AUTOTEL_SAMPLING_TAIL_KEEP,
-  AUTOTEL_SAMPLING_TAIL_EVALUATED,
-} from './sampling';
-
-// Events API
-export { Event, getEvents, resetEvents, type EventsOptions } from './event';
-
-// Metrics API
-export {
-  Metric,
-  getMetrics,
-  resetMetrics,
-  type MetricsOptions,
-} from './metric';
-
-// Meter helpers for custom metrics
-export {
-  getMeter,
-  createCounter,
-  createHistogram,
-  createUpDownCounter,
-  createObservableGauge,
-} from './metric-helpers';
-
-// GenAI / LLM instrumentation (cost, token usage, metric buckets, span event
-// helpers, traceLLM) lives in the dedicated `autotel-genai` package — canonical
-// `gen_ai.*` semantic conventions. Core stays generic and AI-free.
-
-// Tracer helpers for custom spans
-export {
-  getTracer,
-  getActiveSpan,
-  getActiveContext,
-  runWithSpan,
-  finalizeSpan,
-  createDeterministicTraceId,
-  flattenMetadata,
-  getTraceContext,
-  isTracing,
-  enrichWithTraceContext,
-  resolveTraceUrl,
-} from './trace-helpers';
-
-export type { TraceContext as OtelTraceContext } from './trace-helpers';
-
-// Isolated tracer provider support (advanced - for library authors)
-export {
-  setAutotelTracerProvider,
-  getAutotelTracerProvider,
-  getAutotelTracer,
-} from './tracer-provider';
-
-// Semantic convention helpers (GenAI/LLM helpers moved to `autotel-genai`).
-export {
-  traceDB,
-  traceHTTP,
-  traceMessaging,
-  type DBConfig,
-  type HTTPConfig,
-  type MessagingConfig,
-} from './semantic-helpers';
-
-// Re-export events types
-export type {
-  EventSubscriber,
-  EventAttributes,
-  FunnelStatus,
-  OutcomeStatus,
-} from './event-subscriber';
-
-// Re-export OpenTelemetry APIs for convenience
-// (Users shouldn't need to import @opentelemetry/api directly)
-// Note: OTel's trace is exported as 'otelTrace' to avoid naming conflict with autotel's trace()
-// Plugin developers can also access it directly: import { otelTrace } from 'autotel'
-export {
-  context,
-  propagation,
-  SpanStatusCode,
-  trace as otelTrace,
-} from '@opentelemetry/api';
-
-// Re-export common semantic-convention keys/builders for library instrumentation
-export {
-  HTTPAttributes,
-  ServiceAttributes,
-  URLAttributes,
-  httpRequestHeaderAttribute,
-  httpResponseHeaderAttribute,
-} from './semantic-conventions';
-
-// Re-export common OpenTelemetry types and utilities
-// This allows plugins and apps to use OTel without needing separate @opentelemetry/api installation
-
-// Semantic attribute builders and utilities
-// Provides autocomplete-first attribute construction with automatic PII redaction
-// and deprecation warnings
-export {
-  attrs,
-  setUser,
-  setSession,
-  setDevice,
-  httpServer,
-  httpClient,
-  dbClient,
-  mergeServiceResource,
-  identify,
-  request,
-  setError,
-  setException,
-  mergeAttrs,
-  safeSetAttributes,
-  validateAttribute,
-  autoRedactPII,
-  type AttributeGuardrails,
-  type AttributePolicy,
-  type UserAttrs,
-  type SessionAttrs,
-  type DeviceAttrs,
-  type HTTPServerAttrs,
-  type HTTPClientAttrs,
-  type DBAttrs,
-  type ServiceAttrs,
-  type NetworkAttrs,
-  type ErrorAttrs,
-  type ExceptionAttrs,
-  type FeatureFlagAttrs,
-  type MessagingAttrs,
-  type CloudAttrs,
-  type ServerAddressAttrs,
-  type URLAttrs,
-  type PeerAttrs,
-  type ProcessAttrs,
-  type ContainerAttrs,
-  type K8sAttrs,
-  type FaaSAttrs,
-  type ThreadAttrs,
-  type RPCAttrs,
-  type GraphQLAttrs,
-  type ClientAttrs,
-  type DeploymentAttrs,
-  type OTelAttrs,
-  type CodeAttrs,
-  type TLSAttrs,
-} from './attributes';
-
-// Re-export common OpenTelemetry types and utilities so plugins, apps, and
-// existing OTel code can `import { ... } from 'autotel'` without also taking
-// a separate `@opentelemetry/api` dependency.
-export type {
-  Span,
-  SpanContext,
-  SpanAttributes,
-  Tracer,
-  TracerProvider,
-  Context,
-  Attributes,
-  AttributeValue,
-  Link,
-  Link as SpanLink,
-  TimeInput,
-  HrTime,
-  Baggage,
-  BaggageEntry,
-  Exception,
-  TraceFlags,
-  TraceState,
-  TextMapSetter,
-  TextMapGetter,
-} from '@opentelemetry/api';
-export { SpanKind, ROOT_CONTEXT } from '@opentelemetry/api';
-// Note: trace, context, propagation, SpanStatusCode already exported above
-// (`trace` is the hybrid; `otelTrace` is the pure TraceAPI singleton).
-
-// Export typed baggage helper
-export { defineBaggageSchema } from './trace-context';
-
-// Messaging helpers for event-driven architectures
-export {
-  traceProducer,
-  traceConsumer,
-  type ProducerConfig,
-  type ConsumerConfig,
-  type ProducerContext,
-  type ConsumerContext,
-  type MessagingSystem,
-  type MessagingOperation,
-  type LagMetricsConfig,
-} from './messaging';
-
-// Safe baggage propagation with guardrails
-export {
-  createSafeBaggageSchema,
-  BusinessBaggage,
-  type SafeBaggageOptions,
-  type BaggageFieldDefinition,
-  type BaggageFieldType,
-  type BaggageError,
-  type SafeBaggageSchema,
-  type BusinessBaggageValues,
-} from './business-baggage';
-
-// Workflow and saga tracing
-export {
-  traceWorkflow,
-  traceStep,
-  getCurrentWorkflowContext,
-  isInWorkflow,
-  type WorkflowConfig,
-  type StepConfig,
-  type WorkflowContext,
-  type StepContext,
-  type WorkflowStatus,
-  type StepStatus,
-} from './workflow';

package/src/init-auto-redactor.test.ts

@@ -1,53 +0,0 @@
-import { describe, it, expect, afterEach } from 'vitest';
-import { resolveAttributeRedactor } from './init';
-
-const ORIGINAL = process.env.AUTOTEL_REDACT_PII;
-
-afterEach(() => {
-  if (ORIGINAL === undefined) {
-    delete process.env.AUTOTEL_REDACT_PII;
-  } else {
-    process.env.AUTOTEL_REDACT_PII = ORIGINAL;
-  }
-});
-
-describe('resolveAttributeRedactor', () => {
-  it('auto-enables the default preset in production', () => {
-    delete process.env.AUTOTEL_REDACT_PII;
-    expect(resolveAttributeRedactor(undefined, 'production')).toBe('default');
-  });
-
-  it('stays off in non-production environments', () => {
-    delete process.env.AUTOTEL_REDACT_PII;
-    expect(resolveAttributeRedactor(undefined, 'development')).toBeUndefined();
-    expect(resolveAttributeRedactor(undefined, 'test')).toBeUndefined();
-  });
-
-  it('honors an explicit preset in any environment', () => {
-    expect(resolveAttributeRedactor('strict', 'development')).toBe('strict');
-  });
-
-  it('honors an explicit custom config object', () => {
-    const config = { keyPatterns: [/password/i] };
-    expect(resolveAttributeRedactor(config, 'production')).toBe(config);
-  });
-
-  it('disables redaction when explicitly set to false, even in production', () => {
-    expect(resolveAttributeRedactor(false, 'production')).toBeUndefined();
-  });
-
-  it('lets AUTOTEL_REDACT_PII=off disable auto-enable in production', () => {
-    process.env.AUTOTEL_REDACT_PII = 'off';
-    expect(resolveAttributeRedactor(undefined, 'production')).toBeUndefined();
-  });
-
-  it('lets AUTOTEL_REDACT_PII select a preset in any environment', () => {
-    process.env.AUTOTEL_REDACT_PII = 'strict';
-    expect(resolveAttributeRedactor(undefined, 'development')).toBe('strict');
-  });
-
-  it('treats AUTOTEL_REDACT_PII truthy flags as the default preset', () => {
-    process.env.AUTOTEL_REDACT_PII = 'true';
-    expect(resolveAttributeRedactor(undefined, 'development')).toBe('default');
-  });
-});

package/src/init-redactor.test.ts

@@ -1,8 +0,0 @@
-import { describe, it, expect } from 'vitest';
-import { getStringRedactor } from './init';
-
-describe('getStringRedactor', () => {
-  it('returns null when no attributeRedactor configured', () => {
-    expect(getStringRedactor()).toBeNull();
-  });
-});