autotel 4.1.0 → 4.2.1

package/dist/logger-thMPLpOG.cjs

@@ -1,487 +0,0 @@
-const require_config = require('./config.cjs');
-let _opentelemetry_api = require("@opentelemetry/api");
-
-//#region src/autotel-logger.ts
-/**
-* Zero-dependency structured logger for autotel
-*
-* This logger provides:
-* - Structured JSON logging (production) or pretty print (development)
-* - Auto trace context injection (traceId, spanId, correlationId)
-* - Dynamic log level control (per-request via OTel context)
-* - Level support (debug, info, warn, error, none)
-* - Zero additional dependencies (uses @opentelemetry/api, already a dep)
-*
-* Uses Pino-compatible signature supporting both patterns:
-* - `log.info('simple message')` - string-only
-* - `log.info({ userId: '123' }, 'message')` - object first with optional message
-*
-* Used as the default fallback when users don't provide Pino/Bunyan.
-* Can also be used directly: import { createBuiltinLogger } from 'autotel/logger'
-*
-* @example
-* ```typescript
-* import { createBuiltinLogger, runWithLogLevel } from 'autotel/logger';
-*
-* const log = createBuiltinLogger('my-service');
-*
-* // Simple message (no metadata)
-* log.info('Server started');
-*
-* // With metadata (Pino-style: object first, message second)
-* log.info({ userId: '123' }, 'User created');
-* // Output: {"level":"info","service":"my-service","msg":"User created","userId":"123","traceId":"..."}
-*
-* // Dynamic log level per-request
-* runWithLogLevel('debug', () => {
-*   log.debug('This will log even if default level is "info"');
-* });
-* ```
-*/
-/**
-* Context key for storing active log level (enables per-request log levels)
-*/
-const LOG_LEVEL_KEY = (0, _opentelemetry_api.createContextKey)("autotel-log-level");
-/**
-* Get the active log level from context (if set)
-* Falls back to undefined if no log level is set in context
-*/
-function getActiveLogLevel() {
-	return _opentelemetry_api.context.active().getValue(LOG_LEVEL_KEY);
-}
-/**
-* Run a function with a specific log level
-* The log level is stored in OpenTelemetry context and applies to all logger calls within the callback
-*
-* @example
-* ```typescript
-* // Enable debug logging for a specific request
-* runWithLogLevel('debug', () => {
-*   log.debug('This will be logged');
-*   processRequest();
-* });
-*
-* // Disable logging temporarily
-* runWithLogLevel('none', () => {
-*   log.info('This will NOT be logged');
-* });
-* ```
-*/
-function runWithLogLevel(level, callback) {
-	const ctx = _opentelemetry_api.context.active().setValue(LOG_LEVEL_KEY, level);
-	return _opentelemetry_api.context.with(ctx, callback);
-}
-/**
-* Get current trace context from active span
-* Returns null if no active span exists
-*/
-function getTraceContextInternal() {
-	const span = _opentelemetry_api.trace.getActiveSpan();
-	if (!span) return null;
-	const ctx = span.spanContext();
-	return {
-		traceId: ctx.traceId,
-		spanId: ctx.spanId,
-		correlationId: ctx.traceId.slice(0, 16)
-	};
-}
-/**
-* Helper to get trace context (useful for BYOL - Bring Your Own Logger)
-*
-* @example
-* ```typescript
-* import bunyan from 'bunyan';
-* import { getTraceContext } from 'autotel/logger';
-*
-* const bunyanLogger = bunyan.createLogger({ name: 'myapp' });
-* const ctx = getTraceContext();
-* bunyanLogger.info({ ...ctx, email: 'test@example.com' }, 'Creating user');
-* ```
-*/
-function getTraceContext() {
-	return getTraceContextInternal();
-}
-/**
-* Create a lightweight structured logger
-*
-* @param service - Service name for logging
-* @param options - Optional configuration
-*
-* @example
-* ```typescript
-* const log = createBuiltinLogger('user-service');
-*
-* log.info('Creating user', { email: 'test@example.com' });
-* // Output: {"level":"info","service":"user-service","msg":"Creating user",
-* //          "email":"test@example.com","traceId":"...","spanId":"..."}
-*
-* // Dynamic log level control per-request
-* runWithLogLevel('debug', () => {
-*   log.debug('This will be logged even if logger was created with level: "info"');
-* });
-* ```
-*/
-function createBuiltinLogger(service, options) {
-	const defaultLevel = options?.level || "info";
-	const pretty = options?.pretty || false;
-	const levelPriority = {
-		none: -1,
-		debug: 0,
-		info: 1,
-		warn: 2,
-		error: 3
-	};
-	const shouldLog = (level) => {
-		const activeLevel = getActiveLogLevel() ?? defaultLevel;
-		if (activeLevel === "none") return false;
-		return levelPriority[level] >= levelPriority[activeLevel];
-	};
-	const log = (level, msg, attrs) => {
-		if (!shouldLog(level)) return;
-		const ctx = getTraceContextInternal();
-		const logEntry = {
-			level,
-			service,
-			msg,
-			...attrs,
-			...ctx,
-			timestamp: (/* @__PURE__ */ new Date()).toISOString()
-		};
-		if (pretty) {
-			const traceInfo = ctx ? ` [${ctx.traceId.slice(0, 8)}.../${ctx.spanId.slice(0, 8)}...]` : "";
-			console.log(`[${level.toUpperCase()}]${traceInfo} ${service}: ${msg}`, attrs || "");
-		} else console.log(JSON.stringify(logEntry));
-	};
-	const createLogMethod = (level) => {
-		return (extraOrMessage, message) => {
-			if (typeof extraOrMessage === "string") if (message !== void 0 && typeof message === "object") {
-				if (process.env.NODE_ENV !== "production") console.warn(`[autotel] Legacy logger pattern detected: logger.${level}('message', metadata). Autotel recommends Pino signature: logger.${level}({ ...metadata }, 'message'). Auto-swapping arguments for compatibility.`);
-				log(level, extraOrMessage, message);
-			} else log(level, extraOrMessage);
-			else log(level, message || "", extraOrMessage);
-		};
-	};
-	return {
-		info: createLogMethod("info"),
-		warn: createLogMethod("warn"),
-		debug: createLogMethod("debug"),
-		error: (extraOrMessage, message) => {
-			if (typeof extraOrMessage === "string") {
-				if (message instanceof Error) {
-					if (process.env.NODE_ENV !== "production") console.warn("[autotel] Legacy logger pattern detected: logger.error('message', error). Autotel recommends Pino signature: logger.error({ err: error }, 'message'). Auto-swapping arguments for compatibility.");
-					log("error", extraOrMessage, {
-						error: message.message,
-						stack: message.stack,
-						name: message.name
-					});
-					return;
-				}
-				if (message !== void 0 && typeof message === "object") {
-					if (process.env.NODE_ENV !== "production") console.warn("[autotel] Legacy logger pattern detected: logger.error('message', metadata). Autotel recommends Pino signature: logger.error({ ...metadata }, 'message'). Auto-swapping arguments for compatibility.");
-					const { err, ...rest } = message;
-					let errorAttrs = rest;
-					if (err instanceof Error) errorAttrs = {
-						error: err.message,
-						stack: err.stack,
-						name: err.name,
-						...rest
-					};
-					else if (err !== void 0) errorAttrs = {
-						err,
-						...rest
-					};
-					log("error", extraOrMessage, errorAttrs);
-					return;
-				}
-				log("error", extraOrMessage);
-				return;
-			}
-			const { err, ...rest } = extraOrMessage;
-			let errorAttrs = rest;
-			if (err instanceof Error) errorAttrs = {
-				error: err.message,
-				stack: err.stack,
-				name: err.name,
-				...rest
-			};
-			else if (err !== void 0) errorAttrs = {
-				err,
-				...rest
-			};
-			log("error", message || "", errorAttrs);
-		}
-	};
-}
-/**
-* Pino-like factory function for creating an autotel logger
-*
-* @example
-* ```typescript
-* import { autotelLogger } from 'autotel/logger';
-*
-* const log = autotelLogger();
-*
-* // Simple message
-* log.info('Server started');
-*
-* // With metadata (Pino-style: object first, message second)
-* log.info({ userId: '123' }, 'User created');
-*
-* // With options
-* const devLog = autotelLogger({ service: 'my-app', level: 'debug', pretty: true });
-* ```
-*/
-function autotelLogger(options) {
-	return createBuiltinLogger(options?.service || "app", {
-		level: options?.level,
-		pretty: options?.pretty
-	});
-}
-
-//#endregion
-//#region src/logger.ts
-/**
-* Logger types and utilities for autotel
-*
-* **Zero-Config Option:** Don't provide a logger to `init()` and autotel uses
-* a built-in structured JSON logger with automatic trace context injection.
-*
-* **BYOL (Bring Your Own Logger):** Pass Pino or Bunyan to `init()` for
-* automatic instrumentation with trace context and OTLP log export.
-*
-* ## Logger Signature
-*
-* Autotel v2.10+ uses **Pino's signature**: `logger.info({ metadata }, 'message')`.
-*
-* ### Backward Compatibility
-*
-* The built-in logger auto-detects legacy Winston-style calls and swaps arguments:
-* ```typescript
-* // Legacy (auto-detected and handled)
-* logger.info('User created', { userId: '123' });
-* // → Internally treated as: logger.info({ userId: '123' }, 'User created')
-* // → Logs warning in development, works silently in production
-* ```
-*
-* ### Recommended Usage
-*
-* ```typescript
-* // ✅ Pino-style (preferred)
-* logger.info({ userId: '123' }, 'User created');
-*
-* // ✅ Simple message (no metadata)
-* logger.info('Server started');
-* ```
-*
-* **Note:** If you BYOL (bring your own logger), it must use Pino signature.
-* Winston and other `(message, meta)` loggers are NOT compatible.
-* For Winston, use `@opentelemetry/instrumentation-winston` instead.
-*
-* @example Zero-config (uses built-in logger)
-* ```typescript
-* import { init } from 'autotel';
-*
-* init({ service: 'my-app' });
-* // Internal logs: {"level":"info","service":"my-app","msg":"...","traceId":"..."}
-* ```
-*
-* @example Using built-in logger directly
-* ```typescript
-* import { createBuiltinLogger, runWithLogLevel } from 'autotel/logger';
-*
-* const log = createBuiltinLogger('my-service');
-*
-* // Simple message (no metadata)
-* log.info('Server started');
-*
-* // With metadata (Pino-style: object first, message second)
-* log.info({ userId: '123' }, 'User created');
-* // Output: {"level":"info","service":"my-service","msg":"User created","userId":"123","traceId":"..."}
-*
-* // Dynamic log level per-request
-* runWithLogLevel('debug', () => {
-*   log.debug('Debug info for this request only');
-* });
-* ```
-*
-* @example Using Pino (recommended for production, auto-instrumented)
-* ```typescript
-* import pino from 'pino';  // npm install pino
-* import { init } from 'autotel';
-*
-* const logger = pino({ level: 'info' });
-* init({ service: 'my-app', logger });
-*
-* // Logs automatically include traceId/spanId and export via OTLP!
-* logger.info({ userId: '123' }, 'User created');
-* ```
-*
-* @example Using Bunyan (auto-instrumented, same signature as Pino)
-* ```typescript
-* import bunyan from 'bunyan';  // npm install bunyan @opentelemetry/instrumentation-bunyan
-* import { init } from 'autotel';
-* import { BunyanInstrumentation } from '@opentelemetry/instrumentation-bunyan';
-*
-* const logger = bunyan.createLogger({ name: 'my-app' });
-* init({
-*   service: 'my-app',
-*   logger,
-*   instrumentations: [new BunyanInstrumentation()]
-* });
-* ```
-*
-* @example Custom logger (MUST use Pino-compatible signature)
-* ```typescript
-* // ⚠️ Your custom logger MUST accept (object, message?) signature
-* const logger = {
-*   info: (extra, msg) => console.log(msg || '', extra),
-*   warn: (extra, msg) => console.warn(msg || '', extra),
-*   error: (extra, msg) => console.error(msg || '', extra),
-*   debug: (extra, msg) => console.debug(msg || '', extra),
-* };
-* init({ service: 'my-app', logger });
-* ```
-*
-* @example BYOL helper: inject trace context into any logger
-* ```typescript
-* import bunyan from 'bunyan';
-* import { getTraceContext } from 'autotel/logger';
-*
-* const bunyanLogger = bunyan.createLogger({ name: 'myapp' });
-* const ctx = getTraceContext();
-* bunyanLogger.info({ ...ctx, userId: '123' }, 'Creating user');
-* ```
-*/
-/**
-* Log level constants
-*/
-const LOG_LEVEL = {
-	DEBUG: "debug",
-	INFO: "info",
-	WARN: "warn",
-	ERROR: "error"
-};
-/**
-* TS5+ Standard Decorator for logging and tracing operations
-* Uses TC39 Stage 3 decorator syntax
-*
-* This is the traditional per-method decorator approach.
-* For zero-boilerplate solution, see @Instrumented class decorator.
-*
-* @example
-* // Simple usage (Pino-style: object first, message second)
-* class OrderService {
-*   constructor(private readonly deps: { log: Logger }) {}
-*
-*   @LoggedOperation('order.create')
-*   async createOrder(data: CreateOrderData) {
-*     // ✅ Correct Pino-style logging
-*     this.deps.log.info({ orderId: data.id }, 'Creating order');
-*   }
-* }
-*
-* // Advanced usage (future-proof for options)
-* @LoggedOperation({ operationName: 'order.create' })
-* async createOrder(data: CreateOrderData) { }
-*/
-function LoggedOperation(operationNameOrOptions) {
-	const operationName = typeof operationNameOrOptions === "string" ? operationNameOrOptions : operationNameOrOptions.operationName;
-	return function(originalMethod, context) {
-		const methodName = String(context.name);
-		return async function(...args) {
-			const log = this.deps?.log;
-			const startTime = performance.now();
-			return require_config.getConfig().tracer.startActiveSpan(operationName, async (span) => {
-				try {
-					log?.info({
-						operation: operationName,
-						method: methodName,
-						args
-					}, "Operation started");
-					const result = await originalMethod.apply(this, args);
-					const duration = performance.now() - startTime;
-					log?.info({
-						operation: operationName,
-						method: methodName,
-						duration
-					}, "Operation completed");
-					span.setStatus({ code: _opentelemetry_api.SpanStatusCode.OK });
-					span.setAttributes({
-						"operation.name": operationName,
-						"operation.method": methodName,
-						"operation.duration": duration,
-						"operation.success": true
-					});
-					return result;
-				} catch (error) {
-					const duration = performance.now() - startTime;
-					log?.error({
-						err: error instanceof Error ? error : void 0,
-						operation: operationName,
-						method: methodName,
-						duration
-					}, "Operation failed");
-					span.setStatus({
-						code: _opentelemetry_api.SpanStatusCode.ERROR,
-						message: error instanceof Error ? error.message : "Unknown error"
-					});
-					span.setAttributes({
-						"operation.name": operationName,
-						"operation.method": methodName,
-						"operation.duration": duration,
-						"operation.success": false,
-						"error.type": error instanceof Error ? error.constructor.name : "Unknown"
-					});
-					throw error;
-				} finally {
-					span.end();
-				}
-			});
-		};
-	};
-}
-
-//#endregion
-Object.defineProperty(exports, 'LOG_LEVEL', {
-  enumerable: true,
-  get: function () {
-    return LOG_LEVEL;
-  }
-});
-Object.defineProperty(exports, 'LoggedOperation', {
-  enumerable: true,
-  get: function () {
-    return LoggedOperation;
-  }
-});
-Object.defineProperty(exports, 'autotelLogger', {
-  enumerable: true,
-  get: function () {
-    return autotelLogger;
-  }
-});
-Object.defineProperty(exports, 'createBuiltinLogger', {
-  enumerable: true,
-  get: function () {
-    return createBuiltinLogger;
-  }
-});
-Object.defineProperty(exports, 'getActiveLogLevel', {
-  enumerable: true,
-  get: function () {
-    return getActiveLogLevel;
-  }
-});
-Object.defineProperty(exports, 'getTraceContext', {
-  enumerable: true,
-  get: function () {
-    return getTraceContext;
-  }
-});
-Object.defineProperty(exports, 'runWithLogLevel', {
-  enumerable: true,
-  get: function () {
-    return runWithLogLevel;
-  }
-});
-//# sourceMappingURL=logger-thMPLpOG.cjs.map

package/dist/logger-thMPLpOG.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"logger-thMPLpOG.cjs","names":["api_context","trace","extra","getConfig","SpanStatusCode"],"sources":["../src/autotel-logger.ts","../src/logger.ts"],"sourcesContent":["/**\n * Zero-dependency structured logger for autotel\n *\n * This logger provides:\n * - Structured JSON logging (production) or pretty print (development)\n * - Auto trace context injection (traceId, spanId, correlationId)\n * - Dynamic log level control (per-request via OTel context)\n * - Level support (debug, info, warn, error, none)\n * - Zero additional dependencies (uses @opentelemetry/api, already a dep)\n *\n * Uses Pino-compatible signature supporting both patterns:\n * - `log.info('simple message')` - string-only\n * - `log.info({ userId: '123' }, 'message')` - object first with optional message\n *\n * Used as the default fallback when users don't provide Pino/Bunyan.\n * Can also be used directly: import { createBuiltinLogger } from 'autotel/logger'\n *\n * @example\n * ```typescript\n * import { createBuiltinLogger, runWithLogLevel } from 'autotel/logger';\n *\n * const log = createBuiltinLogger('my-service');\n *\n * // Simple message (no metadata)\n * log.info('Server started');\n *\n * // With metadata (Pino-style: object first, message second)\n * log.info({ userId: '123' }, 'User created');\n * // Output: {\"level\":\"info\",\"service\":\"my-service\",\"msg\":\"User created\",\"userId\":\"123\",\"traceId\":\"...\"}\n *\n * // Dynamic log level per-request\n * runWithLogLevel('debug', () => {\n *   log.debug('This will log even if default level is \"info\"');\n * });\n * ```\n */\n\nimport {\n  trace,\n  context as api_context,\n  createContextKey,\n} from '@opentelemetry/api';\nimport type { Logger } from './logger';\n\nexport type BuiltinLogLevel = 'debug' | 'info' | 'warn' | 'error' | 'none';\n\n/**\n * Context key for storing active log level (enables per-request log levels)\n */\nconst LOG_LEVEL_KEY = createContextKey('autotel-log-level');\n\n/**\n * Get the active log level from context (if set)\n * Falls back to undefined if no log level is set in context\n */\nexport function getActiveLogLevel(): BuiltinLogLevel | undefined {\n  return api_context.active().getValue(LOG_LEVEL_KEY) as\n    | BuiltinLogLevel\n    | undefined;\n}\n\n/**\n * Run a function with a specific log level\n * The log level is stored in OpenTelemetry context and applies to all logger calls within the callback\n *\n * @example\n * ```typescript\n * // Enable debug logging for a specific request\n * runWithLogLevel('debug', () => {\n *   log.debug('This will be logged');\n *   processRequest();\n * });\n *\n * // Disable logging temporarily\n * runWithLogLevel('none', () => {\n *   log.info('This will NOT be logged');\n * });\n * ```\n */\nexport function runWithLogLevel<T>(\n  level: BuiltinLogLevel,\n  callback: () => T,\n): T {\n  const ctx = api_context.active().setValue(LOG_LEVEL_KEY, level);\n  return api_context.with(ctx, callback);\n}\n\n/**\n * Get current trace context from active span\n * Returns null if no active span exists\n */\nfunction getTraceContextInternal(): {\n  traceId: string;\n  spanId: string;\n  correlationId: string;\n} | null {\n  const span = trace.getActiveSpan();\n  if (!span) return null;\n\n  const ctx = span.spanContext();\n  return {\n    traceId: ctx.traceId,\n    spanId: ctx.spanId,\n    correlationId: ctx.traceId.slice(0, 16), // First 16 chars for grouping\n  };\n}\n\n/**\n * Helper to get trace context (useful for BYOL - Bring Your Own Logger)\n *\n * @example\n * ```typescript\n * import bunyan from 'bunyan';\n * import { getTraceContext } from 'autotel/logger';\n *\n * const bunyanLogger = bunyan.createLogger({ name: 'myapp' });\n * const ctx = getTraceContext();\n * bunyanLogger.info({ ...ctx, email: 'test@example.com' }, 'Creating user');\n * ```\n */\nexport function getTraceContext() {\n  return getTraceContextInternal();\n}\n\nexport interface BuiltinLoggerOptions {\n  /** Minimum log level. Default: 'info' */\n  level?: BuiltinLogLevel;\n  /** Pretty print for development. Default: false (JSON output) */\n  pretty?: boolean;\n}\n\n/**\n * Create a lightweight structured logger\n *\n * @param service - Service name for logging\n * @param options - Optional configuration\n *\n * @example\n * ```typescript\n * const log = createBuiltinLogger('user-service');\n *\n * log.info('Creating user', { email: 'test@example.com' });\n * // Output: {\"level\":\"info\",\"service\":\"user-service\",\"msg\":\"Creating user\",\n * //          \"email\":\"test@example.com\",\"traceId\":\"...\",\"spanId\":\"...\"}\n *\n * // Dynamic log level control per-request\n * runWithLogLevel('debug', () => {\n *   log.debug('This will be logged even if logger was created with level: \"info\"');\n * });\n * ```\n */\nexport function createBuiltinLogger(\n  service: string,\n  options?: BuiltinLoggerOptions,\n): Logger {\n  const defaultLevel = options?.level || 'info';\n  const pretty = options?.pretty || false;\n\n  const levelPriority: Record<BuiltinLogLevel, number> = {\n    none: -1,\n    debug: 0,\n    info: 1,\n    warn: 2,\n    error: 3,\n  };\n\n  const shouldLog = (level: BuiltinLogLevel): boolean => {\n    // Priority: context level > options level > 'info' default\n    const activeLevel = getActiveLogLevel() ?? defaultLevel;\n\n    // 'none' means suppress all logging\n    if (activeLevel === 'none') return false;\n\n    return levelPriority[level] >= levelPriority[activeLevel];\n  };\n\n  const log = (\n    level: 'info' | 'error' | 'warn' | 'debug',\n    msg: string,\n    attrs?: Record<string, unknown>,\n  ) => {\n    if (!shouldLog(level)) return;\n\n    const ctx = getTraceContextInternal();\n    const logEntry: Record<string, unknown> = {\n      level,\n      service,\n      msg,\n      ...attrs,\n      ...ctx, // Auto-inject traceId, spanId, correlationId\n      timestamp: new Date().toISOString(),\n    };\n\n    if (pretty) {\n      // Pretty print for development\n      const traceInfo = ctx\n        ? ` [${ctx.traceId.slice(0, 8)}.../${ctx.spanId.slice(0, 8)}...]`\n        : '';\n      console.log(\n        `[${level.toUpperCase()}]${traceInfo} ${service}: ${msg}`,\n        attrs || '',\n      );\n    } else {\n      // Structured JSON for production\n      console.log(JSON.stringify(logEntry));\n    }\n  };\n\n  // Pino-compatible signature: supports both:\n  // - logger.info('message') - string-only\n  // - logger.info({ extra }, 'message') - Pino style with metadata\n  // Also auto-detects and handles legacy Winston-style: logger.info('message', { extra })\n  const createLogMethod = (level: 'info' | 'warn' | 'debug') => {\n    return (\n      extraOrMessage: Record<string, unknown> | string,\n      message?: string | Record<string, unknown>,\n    ) => {\n      if (typeof extraOrMessage === 'string') {\n        // First arg is string - could be:\n        // 1. String-only: logger.info('message')\n        // 2. Legacy Winston-style: logger.info('message', { extra })\n        if (message !== undefined && typeof message === 'object') {\n          // Legacy Winston-style detected - auto-swap for backward compatibility\n          if (process.env.NODE_ENV !== 'production') {\n            console.warn(\n              `[autotel] Legacy logger pattern detected: logger.${level}('message', metadata). ` +\n                `Autotel recommends Pino signature: logger.${level}({ ...metadata }, 'message'). ` +\n                `Auto-swapping arguments for compatibility.`,\n            );\n          }\n          // Swap: treat first arg as message, second as metadata\n          log(level, extraOrMessage, message as Record<string, unknown>);\n        } else {\n          // Pure string-only call: logger.info('message')\n          log(level, extraOrMessage);\n        }\n      } else {\n        // Pino style: logger.info({ extra }, 'message')\n        log(level, (message as string) || '', extraOrMessage);\n      }\n    };\n  };\n\n  return {\n    info: createLogMethod('info'),\n    warn: createLogMethod('warn'),\n    debug: createLogMethod('debug'),\n\n    error: (\n      extraOrMessage: Record<string, unknown> | string,\n      message?: string | Record<string, unknown> | Error,\n    ) => {\n      if (typeof extraOrMessage === 'string') {\n        // First arg is string - could be:\n        // 1. String-only: logger.error('message')\n        // 2. Legacy: logger.error('message', error) - Error as second arg\n        // 3. Legacy: logger.error('message', { extra }) - object as second arg\n\n        // Handle legacy logger.error('message', error) pattern\n        if (message instanceof Error) {\n          if (process.env.NODE_ENV !== 'production') {\n            console.warn(\n              `[autotel] Legacy logger pattern detected: logger.error('message', error). ` +\n                `Autotel recommends Pino signature: logger.error({ err: error }, 'message'). ` +\n                `Auto-swapping arguments for compatibility.`,\n            );\n          }\n          log('error', extraOrMessage, {\n            error: message.message,\n            stack: message.stack,\n            name: message.name,\n          });\n          return;\n        }\n\n        // Handle legacy logger.error('message', { extra }) pattern\n        if (message !== undefined && typeof message === 'object') {\n          if (process.env.NODE_ENV !== 'production') {\n            console.warn(\n              `[autotel] Legacy logger pattern detected: logger.error('message', metadata). ` +\n                `Autotel recommends Pino signature: logger.error({ ...metadata }, 'message'). ` +\n                `Auto-swapping arguments for compatibility.`,\n            );\n          }\n          // Swap: treat first arg as message, second as metadata (handle err extraction)\n          const extra = message as Record<string, unknown>;\n          const { err, ...rest } = extra as Record<string, unknown> & {\n            err?: unknown;\n          };\n          let errorAttrs: Record<string, unknown> = rest;\n          if (err instanceof Error) {\n            errorAttrs = {\n              error: err.message,\n              stack: err.stack,\n              name: err.name,\n              ...rest,\n            };\n          } else if (err !== undefined) {\n            errorAttrs = { err, ...rest };\n          }\n          log('error', extraOrMessage, errorAttrs);\n          return;\n        }\n\n        // Pure string-only call: logger.error('message')\n        log('error', extraOrMessage);\n        return;\n      }\n\n      // Pino style: logger.error({ err, ...extra }, 'message')\n      // Extract err from extra if present (Pino convention)\n      const { err, ...rest } = extraOrMessage as Record<string, unknown> & {\n        err?: unknown;\n      };\n      let errorAttrs: Record<string, unknown> = rest;\n      if (err instanceof Error) {\n        // err is an Error - extract message, stack, name for structured logging\n        errorAttrs = {\n          error: err.message,\n          stack: err.stack,\n          name: err.name,\n          ...rest,\n        };\n      } else if (err !== undefined) {\n        // err is not an Error but exists - preserve it as-is\n        errorAttrs = {\n          err,\n          ...rest,\n        };\n      }\n      log('error', (message as string) || '', errorAttrs);\n    },\n  };\n}\n\n/**\n * Pino-like factory function for creating an autotel logger\n *\n * @example\n * ```typescript\n * import { autotelLogger } from 'autotel/logger';\n *\n * const log = autotelLogger();\n *\n * // Simple message\n * log.info('Server started');\n *\n * // With metadata (Pino-style: object first, message second)\n * log.info({ userId: '123' }, 'User created');\n *\n * // With options\n * const devLog = autotelLogger({ service: 'my-app', level: 'debug', pretty: true });\n * ```\n */\nexport function autotelLogger(options?: {\n  service?: string;\n  level?: BuiltinLogLevel;\n  pretty?: boolean;\n}): Logger {\n  return createBuiltinLogger(options?.service || 'app', {\n    level: options?.level,\n    pretty: options?.pretty,\n  });\n}\n","/**\n * Logger types and utilities for autotel\n *\n * **Zero-Config Option:** Don't provide a logger to `init()` and autotel uses\n * a built-in structured JSON logger with automatic trace context injection.\n *\n * **BYOL (Bring Your Own Logger):** Pass Pino or Bunyan to `init()` for\n * automatic instrumentation with trace context and OTLP log export.\n *\n * ## Logger Signature\n *\n * Autotel v2.10+ uses **Pino's signature**: `logger.info({ metadata }, 'message')`.\n *\n * ### Backward Compatibility\n *\n * The built-in logger auto-detects legacy Winston-style calls and swaps arguments:\n * ```typescript\n * // Legacy (auto-detected and handled)\n * logger.info('User created', { userId: '123' });\n * // → Internally treated as: logger.info({ userId: '123' }, 'User created')\n * // → Logs warning in development, works silently in production\n * ```\n *\n * ### Recommended Usage\n *\n * ```typescript\n * // ✅ Pino-style (preferred)\n * logger.info({ userId: '123' }, 'User created');\n *\n * // ✅ Simple message (no metadata)\n * logger.info('Server started');\n * ```\n *\n * **Note:** If you BYOL (bring your own logger), it must use Pino signature.\n * Winston and other `(message, meta)` loggers are NOT compatible.\n * For Winston, use `@opentelemetry/instrumentation-winston` instead.\n *\n * @example Zero-config (uses built-in logger)\n * ```typescript\n * import { init } from 'autotel';\n *\n * init({ service: 'my-app' });\n * // Internal logs: {\"level\":\"info\",\"service\":\"my-app\",\"msg\":\"...\",\"traceId\":\"...\"}\n * ```\n *\n * @example Using built-in logger directly\n * ```typescript\n * import { createBuiltinLogger, runWithLogLevel } from 'autotel/logger';\n *\n * const log = createBuiltinLogger('my-service');\n *\n * // Simple message (no metadata)\n * log.info('Server started');\n *\n * // With metadata (Pino-style: object first, message second)\n * log.info({ userId: '123' }, 'User created');\n * // Output: {\"level\":\"info\",\"service\":\"my-service\",\"msg\":\"User created\",\"userId\":\"123\",\"traceId\":\"...\"}\n *\n * // Dynamic log level per-request\n * runWithLogLevel('debug', () => {\n *   log.debug('Debug info for this request only');\n * });\n * ```\n *\n * @example Using Pino (recommended for production, auto-instrumented)\n * ```typescript\n * import pino from 'pino';  // npm install pino\n * import { init } from 'autotel';\n *\n * const logger = pino({ level: 'info' });\n * init({ service: 'my-app', logger });\n *\n * // Logs automatically include traceId/spanId and export via OTLP!\n * logger.info({ userId: '123' }, 'User created');\n * ```\n *\n * @example Using Bunyan (auto-instrumented, same signature as Pino)\n * ```typescript\n * import bunyan from 'bunyan';  // npm install bunyan @opentelemetry/instrumentation-bunyan\n * import { init } from 'autotel';\n * import { BunyanInstrumentation } from '@opentelemetry/instrumentation-bunyan';\n *\n * const logger = bunyan.createLogger({ name: 'my-app' });\n * init({\n *   service: 'my-app',\n *   logger,\n *   instrumentations: [new BunyanInstrumentation()]\n * });\n * ```\n *\n * @example Custom logger (MUST use Pino-compatible signature)\n * ```typescript\n * // ⚠️ Your custom logger MUST accept (object, message?) signature\n * const logger = {\n *   info: (extra, msg) => console.log(msg || '', extra),\n *   warn: (extra, msg) => console.warn(msg || '', extra),\n *   error: (extra, msg) => console.error(msg || '', extra),\n *   debug: (extra, msg) => console.debug(msg || '', extra),\n * };\n * init({ service: 'my-app', logger });\n * ```\n *\n * @example BYOL helper: inject trace context into any logger\n * ```typescript\n * import bunyan from 'bunyan';\n * import { getTraceContext } from 'autotel/logger';\n *\n * const bunyanLogger = bunyan.createLogger({ name: 'myapp' });\n * const ctx = getTraceContext();\n * bunyanLogger.info({ ...ctx, userId: '123' }, 'Creating user');\n * ```\n */\n\nimport { SpanStatusCode } from '@opentelemetry/api';\nimport { getConfig } from './config';\n\n// ============================================================================\n// Logger Types\n// ============================================================================\n\n/**\n * Log level constants\n */\nexport const LOG_LEVEL = {\n  DEBUG: 'debug',\n  INFO: 'info',\n  WARN: 'warn',\n  ERROR: 'error',\n} as const;\n\nexport type LogLevel = (typeof LOG_LEVEL)[keyof typeof LOG_LEVEL];\n\n/**\n * Logger configuration (for reference - not needed with BYOL approach)\n */\nexport interface LoggerConfig {\n  service: string;\n  level?: LogLevel;\n  pretty?: boolean;\n  redact?: string[] | false;\n}\n\n/**\n * Pino-compatible log function signature\n *\n * Matches Pino's actual LogFn type which supports:\n * - `(msg: string)` - simple string message\n * - `(obj: object, msg?: string)` - object first with optional message\n *\n * @example\n * ```typescript\n * logger.info('User logged in');\n * logger.info({ userId: '123' }, 'User created');\n * logger.error({ err: error }, 'Operation failed');\n * ```\n */\nexport interface LogFn {\n  (msg: string): void;\n  (obj: Record<string, unknown>, msg?: string): void;\n}\n\n/**\n * Simple logger interface - Pino/Bunyan-compatible\n *\n * Uses Pino's LogFn signature which supports both:\n * - `logger.info('message')` - simple string message\n * - `logger.info({ extra }, 'message')` - object first with optional message\n *\n * This is compatible with Pino, Bunyan, and any logger following this pattern.\n *\n * @example Using Pino (just works!)\n * ```typescript\n * import pino from 'pino';\n * const logger = pino({ level: 'info' });\n * init({ service: 'my-app', logger });\n * ```\n *\n * @example Direct usage\n * ```typescript\n * logger.info('Simple message');\n * logger.info({ userId: '123' }, 'User created');\n * logger.error({ err: error }, 'Operation failed');\n * ```\n */\nexport interface Logger {\n  info: LogFn;\n  warn: LogFn;\n  error: LogFn;\n  debug: LogFn;\n}\n\n/**\n * Alias for Logger interface (backwards compatibility)\n * @deprecated Use Logger instead\n */\nexport type ILogger = Logger;\n\n/**\n * Pino logger type - re-exported for convenience\n *\n * Note: This is a type-only export. To use Pino, install it as a peer dependency:\n * `npm install pino`\n */\nexport type { Logger as PinoLogger } from 'pino';\n\n// ============================================================================\n// LoggedOperation Decorator\n// ============================================================================\n\nexport interface LoggedOperationOptions {\n  /** Operation name for tracing (e.g., 'user.createUser') */\n  operationName: string;\n}\n\n/**\n * TS5+ Standard Decorator for logging and tracing operations\n * Uses TC39 Stage 3 decorator syntax\n *\n * This is the traditional per-method decorator approach.\n * For zero-boilerplate solution, see @Instrumented class decorator.\n *\n * @example\n * // Simple usage (Pino-style: object first, message second)\n * class OrderService {\n *   constructor(private readonly deps: { log: Logger }) {}\n *\n *   @LoggedOperation('order.create')\n *   async createOrder(data: CreateOrderData) {\n *     // ✅ Correct Pino-style logging\n *     this.deps.log.info({ orderId: data.id }, 'Creating order');\n *   }\n * }\n *\n * // Advanced usage (future-proof for options)\n * @LoggedOperation({ operationName: 'order.create' })\n * async createOrder(data: CreateOrderData) { }\n */\nexport function LoggedOperation(\n  operationNameOrOptions: string | LoggedOperationOptions,\n) {\n  const operationName =\n    typeof operationNameOrOptions === 'string'\n      ? operationNameOrOptions\n      : operationNameOrOptions.operationName;\n\n  return function <This, Args extends unknown[], Return>(\n    originalMethod: (this: This, ...args: Args) => Promise<Return>,\n    context: ClassMethodDecoratorContext<\n      This,\n      (this: This, ...args: Args) => Promise<Return>\n    >,\n  ) {\n    const methodName = String(context.name);\n\n    return async function (this: This, ...args: Args): Promise<Return> {\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\n      const log = (this as any).deps?.log;\n      const startTime = performance.now();\n\n      const config = getConfig();\n      const tracer = config.tracer;\n\n      return tracer.startActiveSpan(operationName, async (span) => {\n        try {\n          log?.info(\n            {\n              operation: operationName,\n              method: methodName,\n              args,\n            },\n            'Operation started',\n          );\n\n          const result = await originalMethod.apply(this, args);\n\n          const duration = performance.now() - startTime;\n          log?.info(\n            {\n              operation: operationName,\n              method: methodName,\n              duration,\n            },\n            'Operation completed',\n          );\n\n          span.setStatus({ code: SpanStatusCode.OK });\n          span.setAttributes({\n            'operation.name': operationName,\n            'operation.method': methodName,\n            'operation.duration': duration,\n            'operation.success': true,\n          });\n\n          return result;\n        } catch (error) {\n          const duration = performance.now() - startTime;\n          log?.error(\n            {\n              err: error instanceof Error ? error : undefined,\n              operation: operationName,\n              method: methodName,\n              duration,\n            },\n            'Operation failed',\n          );\n\n          span.setStatus({\n            code: SpanStatusCode.ERROR,\n            message: error instanceof Error ? error.message : 'Unknown error',\n          });\n          span.setAttributes({\n            'operation.name': operationName,\n            'operation.method': methodName,\n            'operation.duration': duration,\n            'operation.success': false,\n            'error.type':\n              error instanceof Error ? error.constructor.name : 'Unknown',\n          });\n\n          throw error;\n        } finally {\n          span.end();\n        }\n      });\n    };\n  };\n}\n\n// ============================================================================\n// Built-in Logger (re-exports)\n// ============================================================================\n\nexport {\n  autotelLogger,\n  createBuiltinLogger,\n  runWithLogLevel,\n  getTraceContext,\n  getActiveLogLevel,\n  type BuiltinLogLevel,\n  type BuiltinLoggerOptions,\n} from './autotel-logger';\n"],"mappings":"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"}

package/dist/node-require-DF5QBX6z.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"node-require-DF5QBX6z.cjs","names":[],"sources":["../src/node-require.ts"],"sourcesContent":["/**\n * Cross-format require() helper for CJS and ESM compatibility\n *\n * Provides a synchronous `require()` function that works in both:\n * - CJS builds: Uses native `require`\n * - ESM builds: Uses `createRequire(import.meta.url)`\n *\n * This allows optional peer dependencies and dynamic module loading\n * to work synchronously in both module formats.\n */\n\nimport { createRequire } from 'node:module';\n\n// `__filename` is provided by CJS and by esbuild's CJS output wrapper, but\n// is undefined under pure ESM. `import.meta.url` is provided by ESM. Pick\n// whichever is available so the helper works in:\n//   - native CJS (autotel's published `.cjs`)\n//   - native ESM (autotel's published `.js`)\n//   - ESM-bundled-into-CJS by a downstream consumer (e.g. CDK's\n//     `aws-lambda-nodejs` → esbuild with `format: cjs`). esbuild rewrites\n//     `import.meta` to `{}` in this case, so `createRequire(import.meta.url)`\n//     alone collapses to `createRequire(undefined)` and crashes at load.\n// `typeof __filename` does NOT throw when the identifier is undeclared, so\n// the ESM build evaluates the conditional safely.\ndeclare const __filename: string | undefined;\n\n// Build the Node `require` lazily on first use. Calling `createRequire`\n// eagerly at module load crashes in runtimes where neither `__filename` nor\n// `import.meta.url` resolves to a path — e.g. Cloudflare Workers / workerd,\n// where the bundle has no module path and `createRequire(undefined)` throws\n// synchronously at import. Deferring the call keeps merely importing this\n// module (and therefore anything that re-exports it, such as `track`)\n// side-effect-free; Node/CJS/ESM still get a real `require` on first call.\nlet cachedRequire: NodeRequire | undefined;\n\nfunction getNodeRequire(): NodeRequire {\n  if (cachedRequire) return cachedRequire;\n  const base = typeof __filename === 'string' ? __filename : import.meta.url;\n  if (!base) {\n    // No module path in this runtime. Surface as a missing-module error so\n    // optional lookups via `safeRequire()` degrade gracefully to `undefined`.\n    throw Object.assign(\n      new Error('node require() is unavailable in this runtime'),\n      { code: 'MODULE_NOT_FOUND' },\n    );\n  }\n  cachedRequire = createRequire(base);\n  return cachedRequire;\n}\n\n/**\n * Synchronously require a module (works in both CJS and ESM)\n *\n * @param id - Module ID to require\n * @returns The required module\n * @throws Error if module cannot be loaded\n *\n * @example\n * ```typescript\n * import { safeRequire } from './node-require';\n *\n * const traceloop = safeRequire('@traceloop/node-server-sdk');\n * if (traceloop) {\n *   traceloop.initialize({ ... });\n * }\n * ```\n */\nexport function safeRequire<T = unknown>(id: string): T | undefined {\n  try {\n    return getNodeRequire()(id) as T;\n  } catch (error) {\n    if (error && (error as NodeJS.ErrnoException).code === 'MODULE_NOT_FOUND') {\n      // Optional dependency missing – return undefined\n      return undefined;\n    }\n    // Any other error is a real bug: rethrow\n    throw error;\n  }\n}\n\n/**\n * Synchronously require a module (throws if not found)\n *\n * Use this when the module is required (not optional).\n *\n * @param id - Module ID to require\n * @returns The required module\n * @throws Error if module cannot be loaded\n *\n * @example\n * ```typescript\n * import { requireModule } from './node-require';\n *\n * const fs = requireModule<typeof import('node:fs')>('node:fs');\n * const content = fs.readFileSync('file.txt', 'utf8');\n * ```\n */\nexport function requireModule<T = unknown>(id: string): T {\n  return getNodeRequire()(id) as T;\n}\n\n/**\n * Direct access to the nodeRequire function (for advanced use cases).\n *\n * Lazily resolves the underlying Node `require` on first call, so importing\n * this binding never triggers `createRequire` in runtimes that lack a module\n * path (e.g. Cloudflare Workers).\n *\n * Only the call signature and `resolve` (including `resolve.paths`) are\n * forwarded. The live, mutable members of a real `require` — `.cache`,\n * `.main`, `.extensions` — are intentionally NOT exposed: a lazy wrapper\n * can't mirror that shared state without resolving eagerly, which would\n * reintroduce the workerd crash. Use `createRequire` directly if you need\n * them.\n */\nconst nodeRequire = ((id: string) => getNodeRequire()(id)) as NodeRequire;\nconst lazyResolve = ((id: string, options?: { paths?: string[] }) =>\n  getNodeRequire().resolve(id, options)) as NodeRequire['resolve'];\nlazyResolve.paths = (request: string) =>\n  getNodeRequire().resolve.paths(request);\nnodeRequire.resolve = lazyResolve;\n\nexport { nodeRequire };\n"],"mappings":";;;;;;;;;;;;;AAiCA,IAAI;AAEJ,SAAS,iBAA8B;CACrC,IAAI,eAAe,OAAO;CAC1B,MAAM,OAAO,OAAO,eAAe,WAAW;CAC9C,IAAI,CAAC,MAGH,MAAM,OAAO,uBACX,IAAI,MAAM,+CAA+C,GACzD,EAAE,MAAM,mBAAmB,CAC7B;CAEF,+CAA8B,IAAI;CAClC,OAAO;AACT;;;;;;;;;;;;;;;;;;AAmBA,SAAgB,YAAyB,IAA2B;CAClE,IAAI;EACF,OAAO,eAAe,CAAC,CAAC,EAAE;CAC5B,SAAS,OAAO;EACd,IAAI,SAAU,MAAgC,SAAS,oBAErD;EAGF,MAAM;CACR;AACF;;;;;;;;;;;;;;;;;;AAmBA,SAAgB,cAA2B,IAAe;CACxD,OAAO,eAAe,CAAC,CAAC,EAAE;AAC5B;;;;;;;;;;;;;;;AAgBA,MAAM,gBAAgB,OAAe,eAAe,CAAC,CAAC,EAAE;AACxD,MAAM,gBAAgB,IAAY,YAChC,eAAe,CAAC,CAAC,QAAQ,IAAI,OAAO;AACtC,YAAY,SAAS,YACnB,eAAe,CAAC,CAAC,QAAQ,MAAM,OAAO;AACxC,YAAY,UAAU"}

package/dist/node-require-Db1oDpLj.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"node-require-Db1oDpLj.js","names":[],"sources":["../src/node-require.ts"],"sourcesContent":["/**\n * Cross-format require() helper for CJS and ESM compatibility\n *\n * Provides a synchronous `require()` function that works in both:\n * - CJS builds: Uses native `require`\n * - ESM builds: Uses `createRequire(import.meta.url)`\n *\n * This allows optional peer dependencies and dynamic module loading\n * to work synchronously in both module formats.\n */\n\nimport { createRequire } from 'node:module';\n\n// `__filename` is provided by CJS and by esbuild's CJS output wrapper, but\n// is undefined under pure ESM. `import.meta.url` is provided by ESM. Pick\n// whichever is available so the helper works in:\n//   - native CJS (autotel's published `.cjs`)\n//   - native ESM (autotel's published `.js`)\n//   - ESM-bundled-into-CJS by a downstream consumer (e.g. CDK's\n//     `aws-lambda-nodejs` → esbuild with `format: cjs`). esbuild rewrites\n//     `import.meta` to `{}` in this case, so `createRequire(import.meta.url)`\n//     alone collapses to `createRequire(undefined)` and crashes at load.\n// `typeof __filename` does NOT throw when the identifier is undeclared, so\n// the ESM build evaluates the conditional safely.\ndeclare const __filename: string | undefined;\n\n// Build the Node `require` lazily on first use. Calling `createRequire`\n// eagerly at module load crashes in runtimes where neither `__filename` nor\n// `import.meta.url` resolves to a path — e.g. Cloudflare Workers / workerd,\n// where the bundle has no module path and `createRequire(undefined)` throws\n// synchronously at import. Deferring the call keeps merely importing this\n// module (and therefore anything that re-exports it, such as `track`)\n// side-effect-free; Node/CJS/ESM still get a real `require` on first call.\nlet cachedRequire: NodeRequire | undefined;\n\nfunction getNodeRequire(): NodeRequire {\n  if (cachedRequire) return cachedRequire;\n  const base = typeof __filename === 'string' ? __filename : import.meta.url;\n  if (!base) {\n    // No module path in this runtime. Surface as a missing-module error so\n    // optional lookups via `safeRequire()` degrade gracefully to `undefined`.\n    throw Object.assign(\n      new Error('node require() is unavailable in this runtime'),\n      { code: 'MODULE_NOT_FOUND' },\n    );\n  }\n  cachedRequire = createRequire(base);\n  return cachedRequire;\n}\n\n/**\n * Synchronously require a module (works in both CJS and ESM)\n *\n * @param id - Module ID to require\n * @returns The required module\n * @throws Error if module cannot be loaded\n *\n * @example\n * ```typescript\n * import { safeRequire } from './node-require';\n *\n * const traceloop = safeRequire('@traceloop/node-server-sdk');\n * if (traceloop) {\n *   traceloop.initialize({ ... });\n * }\n * ```\n */\nexport function safeRequire<T = unknown>(id: string): T | undefined {\n  try {\n    return getNodeRequire()(id) as T;\n  } catch (error) {\n    if (error && (error as NodeJS.ErrnoException).code === 'MODULE_NOT_FOUND') {\n      // Optional dependency missing – return undefined\n      return undefined;\n    }\n    // Any other error is a real bug: rethrow\n    throw error;\n  }\n}\n\n/**\n * Synchronously require a module (throws if not found)\n *\n * Use this when the module is required (not optional).\n *\n * @param id - Module ID to require\n * @returns The required module\n * @throws Error if module cannot be loaded\n *\n * @example\n * ```typescript\n * import { requireModule } from './node-require';\n *\n * const fs = requireModule<typeof import('node:fs')>('node:fs');\n * const content = fs.readFileSync('file.txt', 'utf8');\n * ```\n */\nexport function requireModule<T = unknown>(id: string): T {\n  return getNodeRequire()(id) as T;\n}\n\n/**\n * Direct access to the nodeRequire function (for advanced use cases).\n *\n * Lazily resolves the underlying Node `require` on first call, so importing\n * this binding never triggers `createRequire` in runtimes that lack a module\n * path (e.g. Cloudflare Workers).\n *\n * Only the call signature and `resolve` (including `resolve.paths`) are\n * forwarded. The live, mutable members of a real `require` — `.cache`,\n * `.main`, `.extensions` — are intentionally NOT exposed: a lazy wrapper\n * can't mirror that shared state without resolving eagerly, which would\n * reintroduce the workerd crash. Use `createRequire` directly if you need\n * them.\n */\nconst nodeRequire = ((id: string) => getNodeRequire()(id)) as NodeRequire;\nconst lazyResolve = ((id: string, options?: { paths?: string[] }) =>\n  getNodeRequire().resolve(id, options)) as NodeRequire['resolve'];\nlazyResolve.paths = (request: string) =>\n  getNodeRequire().resolve.paths(request);\nnodeRequire.resolve = lazyResolve;\n\nexport { nodeRequire };\n"],"mappings":";;;;;;;;;;;;;AAiCA,IAAI;AAEJ,SAAS,iBAA8B;CACrC,IAAI,eAAe,OAAO;CAC1B,MAAM,OAAO,OAAO,eAAe,WAAW,aAAa,OAAO,KAAK;CACvE,IAAI,CAAC,MAGH,MAAM,OAAO,uBACX,IAAI,MAAM,+CAA+C,GACzD,EAAE,MAAM,mBAAmB,CAC7B;CAEF,gBAAgB,cAAc,IAAI;CAClC,OAAO;AACT;;;;;;;;;;;;;;;;;;AAmBA,SAAgB,YAAyB,IAA2B;CAClE,IAAI;EACF,OAAO,eAAe,CAAC,CAAC,EAAE;CAC5B,SAAS,OAAO;EACd,IAAI,SAAU,MAAgC,SAAS,oBAErD;EAGF,MAAM;CACR;AACF;;;;;;;;;;;;;;;;;;AAmBA,SAAgB,cAA2B,IAAe;CACxD,OAAO,eAAe,CAAC,CAAC,EAAE;AAC5B;;;;;;;;;;;;;;;AAgBA,MAAM,gBAAgB,OAAe,eAAe,CAAC,CAAC,EAAE;AACxD,MAAM,gBAAgB,IAAY,YAChC,eAAe,CAAC,CAAC,QAAQ,IAAI,OAAO;AACtC,YAAY,SAAS,YACnB,eAAe,CAAC,CAAC,QAAQ,MAAM,OAAO;AACxC,YAAY,UAAU"}

package/dist/operation-context-C-2hmmtP.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"operation-context-C-2hmmtP.js","names":[],"sources":["../src/operation-context.ts"],"sourcesContent":["/**\n * Operation context tracking using AsyncLocalStorage\n *\n * This module provides a way to track operation names across async boundaries\n * so they can be automatically captured in events events.\n *\n * We cannot read span attributes from OpenTelemetry's API (it's write-only),\n * so we maintain our own async context storage.\n */\n\nimport { AsyncLocalStorage } from 'node:async_hooks';\n\n/**\n * Operation context that flows through async operations\n */\nexport interface OperationContext {\n  /**\n   * The name of the current operation\n   * This is set by trace() or span() and can be read by events\n   */\n  name: string;\n}\n\n/**\n * AsyncLocalStorage instance for tracking operation context\n */\nconst operationStorage = new AsyncLocalStorage<OperationContext>();\n\n/**\n * Get the current operation context (if any)\n *\n * @returns The current operation context, or undefined if not in an operation\n *\n * @example\n * ```typescript\n * const ctx = getOperationContext();\n * if (ctx) {\n *   console.log('Current operation:', ctx.name);\n * }\n * ```\n */\nexport function getOperationContext(): OperationContext | undefined {\n  return operationStorage.getStore();\n}\n\n/**\n * Run a function within an operation context\n *\n * This sets the operation name for the duration of the function execution,\n * including all async operations spawned from it.\n *\n * @param name - The operation name to set\n * @param fn - The function to execute within the context\n * @returns The result of the function\n *\n * @example\n * ```typescript\n * const result = await runInOperationContext('user.create', async () => {\n *   // Any events.trackEvent() calls here will automatically capture\n *   // 'operation.name': 'user.create'\n *   await createUser();\n *   return 'success';\n * });\n * ```\n */\nexport function runInOperationContext<T>(name: string, fn: () => T): T {\n  return operationStorage.run({ name }, fn);\n}\n\n/**\n * Update the operation name in the current context\n *\n * This is useful when you want to change the operation name within\n * an already-established context (e.g., when entering a nested span).\n *\n * @param name - The new operation name\n *\n * @example\n * ```typescript\n * runInOperationContext('parent.operation', () => {\n *   // operation.name is 'parent.operation'\n *\n *   updateOperationName('nested.operation');\n *   // operation.name is now 'nested.operation'\n * });\n * ```\n */\nexport function updateOperationName(name: string): void {\n  const store = operationStorage.getStore();\n  if (store) {\n    store.name = name;\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;AA0BA,MAAM,mBAAmB,IAAI,kBAAoC;;;;;;;;;;;;;;AAejE,SAAgB,sBAAoD;CAClE,OAAO,iBAAiB,SAAS;AACnC;;;;;;;;;;;;;;;;;;;;;AAsBA,SAAgB,sBAAyB,MAAc,IAAgB;CACrE,OAAO,iBAAiB,IAAI,EAAE,KAAK,GAAG,EAAE;AAC1C"}

package/dist/operation-context-n4_obUwq.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"operation-context-n4_obUwq.cjs","names":["AsyncLocalStorage"],"sources":["../src/operation-context.ts"],"sourcesContent":["/**\n * Operation context tracking using AsyncLocalStorage\n *\n * This module provides a way to track operation names across async boundaries\n * so they can be automatically captured in events events.\n *\n * We cannot read span attributes from OpenTelemetry's API (it's write-only),\n * so we maintain our own async context storage.\n */\n\nimport { AsyncLocalStorage } from 'node:async_hooks';\n\n/**\n * Operation context that flows through async operations\n */\nexport interface OperationContext {\n  /**\n   * The name of the current operation\n   * This is set by trace() or span() and can be read by events\n   */\n  name: string;\n}\n\n/**\n * AsyncLocalStorage instance for tracking operation context\n */\nconst operationStorage = new AsyncLocalStorage<OperationContext>();\n\n/**\n * Get the current operation context (if any)\n *\n * @returns The current operation context, or undefined if not in an operation\n *\n * @example\n * ```typescript\n * const ctx = getOperationContext();\n * if (ctx) {\n *   console.log('Current operation:', ctx.name);\n * }\n * ```\n */\nexport function getOperationContext(): OperationContext | undefined {\n  return operationStorage.getStore();\n}\n\n/**\n * Run a function within an operation context\n *\n * This sets the operation name for the duration of the function execution,\n * including all async operations spawned from it.\n *\n * @param name - The operation name to set\n * @param fn - The function to execute within the context\n * @returns The result of the function\n *\n * @example\n * ```typescript\n * const result = await runInOperationContext('user.create', async () => {\n *   // Any events.trackEvent() calls here will automatically capture\n *   // 'operation.name': 'user.create'\n *   await createUser();\n *   return 'success';\n * });\n * ```\n */\nexport function runInOperationContext<T>(name: string, fn: () => T): T {\n  return operationStorage.run({ name }, fn);\n}\n\n/**\n * Update the operation name in the current context\n *\n * This is useful when you want to change the operation name within\n * an already-established context (e.g., when entering a nested span).\n *\n * @param name - The new operation name\n *\n * @example\n * ```typescript\n * runInOperationContext('parent.operation', () => {\n *   // operation.name is 'parent.operation'\n *\n *   updateOperationName('nested.operation');\n *   // operation.name is now 'nested.operation'\n * });\n * ```\n */\nexport function updateOperationName(name: string): void {\n  const store = operationStorage.getStore();\n  if (store) {\n    store.name = name;\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;AA0BA,MAAM,mBAAmB,IAAIA,mCAAoC;;;;;;;;;;;;;;AAejE,SAAgB,sBAAoD;CAClE,OAAO,iBAAiB,SAAS;AACnC;;;;;;;;;;;;;;;;;;;;;AAsBA,SAAgB,sBAAyB,MAAc,IAAgB;CACrE,OAAO,iBAAiB,IAAI,EAAE,KAAK,GAAG,EAAE;AAC1C"}

package/dist/stable-hash-BNTMrmdB.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"stable-hash-BNTMrmdB.cjs","names":[],"sources":["../src/stable-hash.ts"],"sourcesContent":["import { createHash } from 'node:crypto';\n\n/**\n * Deterministic JSON stringify with sorted object keys, so two structurally\n * equal values always produce the same string regardless of key insertion\n * order. Shared by `defineEvent` and the validation layer for stable schema\n * hashes.\n */\nexport function stableStringify(value: unknown): string {\n  if (value === null || value === undefined || typeof value !== 'object') {\n    return JSON.stringify(value);\n  }\n  if (Array.isArray(value)) {\n    return '[' + value.map((v) => stableStringify(v)).join(',') + ']';\n  }\n  const obj = value as Record<string, unknown>;\n  const body = Object.keys(obj)\n    .toSorted()\n    .map((k) => JSON.stringify(k) + ':' + stableStringify(obj[k]))\n    .join(',');\n  return '{' + body + '}';\n}\n\n/** Stable sha256 of any JSON-serializable value. */\nexport function hashJson(value: unknown): string {\n  return createHash('sha256').update(stableStringify(value)).digest('hex');\n}\n"],"mappings":";;;;;;;;;AAQA,SAAgB,gBAAgB,OAAwB;CACtD,IAAI,UAAU,QAAQ,UAAU,UAAa,OAAO,UAAU,UAC5D,OAAO,KAAK,UAAU,KAAK;CAE7B,IAAI,MAAM,QAAQ,KAAK,GACrB,OAAO,MAAM,MAAM,KAAK,MAAM,gBAAgB,CAAC,CAAC,CAAC,CAAC,KAAK,GAAG,IAAI;CAEhE,MAAM,MAAM;CAKZ,OAAO,MAJM,OAAO,KAAK,GAAG,CAAC,CAC1B,SAAS,CAAC,CACV,KAAK,MAAM,KAAK,UAAU,CAAC,IAAI,MAAM,gBAAgB,IAAI,EAAE,CAAC,CAAC,CAC7D,KAAK,GACQ,IAAI;AACtB;;AAGA,SAAgB,SAAS,OAAwB;CAC/C,mCAAkB,QAAQ,CAAC,CAAC,OAAO,gBAAgB,KAAK,CAAC,CAAC,CAAC,OAAO,KAAK;AACzE"}

package/dist/stable-hash-Cg5cT34Q.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"stable-hash-Cg5cT34Q.js","names":[],"sources":["../src/stable-hash.ts"],"sourcesContent":["import { createHash } from 'node:crypto';\n\n/**\n * Deterministic JSON stringify with sorted object keys, so two structurally\n * equal values always produce the same string regardless of key insertion\n * order. Shared by `defineEvent` and the validation layer for stable schema\n * hashes.\n */\nexport function stableStringify(value: unknown): string {\n  if (value === null || value === undefined || typeof value !== 'object') {\n    return JSON.stringify(value);\n  }\n  if (Array.isArray(value)) {\n    return '[' + value.map((v) => stableStringify(v)).join(',') + ']';\n  }\n  const obj = value as Record<string, unknown>;\n  const body = Object.keys(obj)\n    .toSorted()\n    .map((k) => JSON.stringify(k) + ':' + stableStringify(obj[k]))\n    .join(',');\n  return '{' + body + '}';\n}\n\n/** Stable sha256 of any JSON-serializable value. */\nexport function hashJson(value: unknown): string {\n  return createHash('sha256').update(stableStringify(value)).digest('hex');\n}\n"],"mappings":";;;;;;;;;AAQA,SAAgB,gBAAgB,OAAwB;CACtD,IAAI,UAAU,QAAQ,UAAU,UAAa,OAAO,UAAU,UAC5D,OAAO,KAAK,UAAU,KAAK;CAE7B,IAAI,MAAM,QAAQ,KAAK,GACrB,OAAO,MAAM,MAAM,KAAK,MAAM,gBAAgB,CAAC,CAAC,CAAC,CAAC,KAAK,GAAG,IAAI;CAEhE,MAAM,MAAM;CAKZ,OAAO,MAJM,OAAO,KAAK,GAAG,CAAC,CAC1B,SAAS,CAAC,CACV,KAAK,MAAM,KAAK,UAAU,CAAC,IAAI,MAAM,gBAAgB,IAAI,EAAE,CAAC,CAAC,CAC7D,KAAK,GACQ,IAAI;AACtB;;AAGA,SAAgB,SAAS,OAAwB;CAC/C,OAAO,WAAW,QAAQ,CAAC,CAAC,OAAO,gBAAgB,KAAK,CAAC,CAAC,CAAC,OAAO,KAAK;AACzE"}