autotel 4.2.3 → 4.2.4
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/{attributes-CmYpdqCN.js → attributes-B7wix2VG.js} +2 -2
- package/dist/{attributes-CmYpdqCN.js.map → attributes-B7wix2VG.js.map} +1 -1
- package/dist/{attributes-PZ5doLgw.cjs → attributes-aDmJYral.cjs} +2 -2
- package/dist/{attributes-PZ5doLgw.cjs.map → attributes-aDmJYral.cjs.map} +1 -1
- package/dist/attributes.cjs +1 -1
- package/dist/attributes.js +1 -1
- package/dist/auto.cjs +3 -3
- package/dist/auto.js +1 -1
- package/dist/{canonical-log-line-processor--RlFDHhm.cjs → canonical-log-line-processor-CcrDi6TO.cjs} +2 -2
- package/dist/{canonical-log-line-processor--RlFDHhm.cjs.map → canonical-log-line-processor-CcrDi6TO.cjs.map} +1 -1
- package/dist/{canonical-log-line-processor-DbBQT5vY.js → canonical-log-line-processor-FLezvFCB.js} +2 -2
- package/dist/{canonical-log-line-processor-DbBQT5vY.js.map → canonical-log-line-processor-FLezvFCB.js.map} +1 -1
- package/dist/correlation-id.cjs +1 -1
- package/dist/correlation-id.js +1 -1
- package/dist/decorators.cjs +1 -1
- package/dist/decorators.js +1 -1
- package/dist/diagnostics.cjs +1 -1
- package/dist/drain-pipeline.cjs +8 -2
- package/dist/drain-pipeline.cjs.map +1 -1
- package/dist/drain-pipeline.js +8 -2
- package/dist/drain-pipeline.js.map +1 -1
- package/dist/{event-531asIM6.js → event-BEm5IJ8U.js} +3 -3
- package/dist/{event-531asIM6.js.map → event-BEm5IJ8U.js.map} +1 -1
- package/dist/{event-CcZYwp50.cjs → event-rzA1X5h3.cjs} +4 -4
- package/dist/{event-CcZYwp50.cjs.map → event-rzA1X5h3.cjs.map} +1 -1
- package/dist/event.cjs +1 -1
- package/dist/event.js +1 -1
- package/dist/{functional-C8B0Qa7o.cjs → functional-BCtxvYir.cjs} +9 -9
- package/dist/{functional-C8B0Qa7o.cjs.map → functional-BCtxvYir.cjs.map} +1 -1
- package/dist/{functional-r-AUIRy_.js → functional-CrAq8Az8.js} +4 -4
- package/dist/{functional-r-AUIRy_.js.map → functional-CrAq8Az8.js.map} +1 -1
- package/dist/functional.cjs +1 -1
- package/dist/functional.js +1 -1
- package/dist/http.cjs +1 -1
- package/dist/http.js +1 -1
- package/dist/index.cjs +17 -14
- package/dist/index.cjs.map +1 -1
- package/dist/index.js +12 -9
- package/dist/index.js.map +1 -1
- package/dist/{init-BS2JVkrL.js → init-BvBB45-T.js} +4 -4
- package/dist/{init-BS2JVkrL.js.map → init-BvBB45-T.js.map} +1 -1
- package/dist/{init-BXiuPK6j.cjs → init-BxJEJ9Tn.cjs} +5 -5
- package/dist/{init-BXiuPK6j.cjs.map → init-BxJEJ9Tn.cjs.map} +1 -1
- package/dist/instrumentation.cjs +4 -4
- package/dist/instrumentation.cjs.map +1 -1
- package/dist/instrumentation.js +3 -3
- package/dist/instrumentation.js.map +1 -1
- package/dist/logger-thMPLpOG.cjs +487 -0
- package/dist/logger-thMPLpOG.cjs.map +1 -0
- package/dist/logger.cjs +8 -236
- package/dist/messaging.cjs +1 -1
- package/dist/messaging.js +1 -1
- package/dist/{node-require-CZ_PU448.cjs → node-require-PFqDihze.cjs} +3 -3
- package/dist/{node-require-CZ_PU448.cjs.map → node-require-PFqDihze.cjs.map} +1 -1
- package/dist/{operation-context-D6LDf4W_.cjs → operation-context-hzKbTKnt.cjs} +3 -3
- package/dist/{operation-context-D6LDf4W_.cjs.map → operation-context-hzKbTKnt.cjs.map} +1 -1
- package/dist/processors.cjs +1 -1
- package/dist/processors.js +1 -1
- package/dist/register.cjs +2 -2
- package/dist/semantic-helpers.cjs +1 -1
- package/dist/semantic-helpers.js +1 -1
- package/dist/{stable-hash-brKISGf1.cjs → stable-hash-CS9BxvVQ.cjs} +3 -3
- package/dist/{stable-hash-brKISGf1.cjs.map → stable-hash-CS9BxvVQ.cjs.map} +1 -1
- package/dist/testing.cjs +4 -2
- package/dist/testing.cjs.map +1 -1
- package/dist/testing.js +4 -2
- package/dist/testing.js.map +1 -1
- package/dist/trace-helpers.cjs +1 -1
- package/dist/{track-COUuU48p.js → track-D7O7oIZa.js} +9 -5
- package/dist/{track-COUuU48p.js.map → track-D7O7oIZa.js.map} +1 -1
- package/dist/{track-Cb3Q4QmS.cjs → track-eovhCJ-I.cjs} +11 -7
- package/dist/{track-Cb3Q4QmS.cjs.map → track-eovhCJ-I.cjs.map} +1 -1
- package/dist/validate.cjs +1 -1
- package/dist/webhook.cjs +1 -1
- package/dist/webhook.js +1 -1
- package/dist/workflow-distributed.cjs +1 -1
- package/dist/workflow-distributed.js +1 -1
- package/dist/workflow.cjs +3 -3
- package/dist/workflow.js +1 -1
- package/dist/yaml-config.cjs +4 -4
- package/package.json +40 -40
- package/dist/logger.cjs.map +0 -1
- /package/dist/{chunk-C_NdSu1c.cjs → rolldown-runtime-C_NdSu1c.cjs} +0 -0
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"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/logger.cjs
CHANGED
|
@@ -1,238 +1,10 @@
|
|
|
1
1
|
Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
|
|
2
|
+
const require_logger = require('./logger-thMPLpOG.cjs');
|
|
2
3
|
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
* **BYOL (Bring Your Own Logger):** Pass Pino or Bunyan to `init()` for
|
|
11
|
-
* automatic instrumentation with trace context and OTLP log export.
|
|
12
|
-
*
|
|
13
|
-
* ## Logger Signature
|
|
14
|
-
*
|
|
15
|
-
* Autotel v2.10+ uses **Pino's signature**: `logger.info({ metadata }, 'message')`.
|
|
16
|
-
*
|
|
17
|
-
* ### Backward Compatibility
|
|
18
|
-
*
|
|
19
|
-
* The built-in logger auto-detects legacy Winston-style calls and swaps arguments:
|
|
20
|
-
* ```typescript
|
|
21
|
-
* // Legacy (auto-detected and handled)
|
|
22
|
-
* logger.info('User created', { userId: '123' });
|
|
23
|
-
* // → Internally treated as: logger.info({ userId: '123' }, 'User created')
|
|
24
|
-
* // → Logs warning in development, works silently in production
|
|
25
|
-
* ```
|
|
26
|
-
*
|
|
27
|
-
* ### Recommended Usage
|
|
28
|
-
*
|
|
29
|
-
* ```typescript
|
|
30
|
-
* // ✅ Pino-style (preferred)
|
|
31
|
-
* logger.info({ userId: '123' }, 'User created');
|
|
32
|
-
*
|
|
33
|
-
* // ✅ Simple message (no metadata)
|
|
34
|
-
* logger.info('Server started');
|
|
35
|
-
* ```
|
|
36
|
-
*
|
|
37
|
-
* **Note:** If you BYOL (bring your own logger), it must use Pino signature.
|
|
38
|
-
* Winston and other `(message, meta)` loggers are NOT compatible.
|
|
39
|
-
* For Winston, use `@opentelemetry/instrumentation-winston` instead.
|
|
40
|
-
*
|
|
41
|
-
* @example Zero-config (uses built-in logger)
|
|
42
|
-
* ```typescript
|
|
43
|
-
* import { init } from 'autotel';
|
|
44
|
-
*
|
|
45
|
-
* init({ service: 'my-app' });
|
|
46
|
-
* // Internal logs: {"level":"info","service":"my-app","msg":"...","traceId":"..."}
|
|
47
|
-
* ```
|
|
48
|
-
*
|
|
49
|
-
* @example Using built-in logger directly
|
|
50
|
-
* ```typescript
|
|
51
|
-
* import { createBuiltinLogger, runWithLogLevel } from 'autotel/logger';
|
|
52
|
-
*
|
|
53
|
-
* const log = createBuiltinLogger('my-service');
|
|
54
|
-
*
|
|
55
|
-
* // Simple message (no metadata)
|
|
56
|
-
* log.info('Server started');
|
|
57
|
-
*
|
|
58
|
-
* // With metadata (Pino-style: object first, message second)
|
|
59
|
-
* log.info({ userId: '123' }, 'User created');
|
|
60
|
-
* // Output: {"level":"info","service":"my-service","msg":"User created","userId":"123","traceId":"..."}
|
|
61
|
-
*
|
|
62
|
-
* // Dynamic log level per-request
|
|
63
|
-
* runWithLogLevel('debug', () => {
|
|
64
|
-
* log.debug('Debug info for this request only');
|
|
65
|
-
* });
|
|
66
|
-
* ```
|
|
67
|
-
*
|
|
68
|
-
* @example Using Pino (recommended for production, auto-instrumented)
|
|
69
|
-
* ```typescript
|
|
70
|
-
* import pino from 'pino'; // npm install pino
|
|
71
|
-
* import { init } from 'autotel';
|
|
72
|
-
*
|
|
73
|
-
* const logger = pino({ level: 'info' });
|
|
74
|
-
* init({ service: 'my-app', logger });
|
|
75
|
-
*
|
|
76
|
-
* // Logs automatically include traceId/spanId and export via OTLP!
|
|
77
|
-
* logger.info({ userId: '123' }, 'User created');
|
|
78
|
-
* ```
|
|
79
|
-
*
|
|
80
|
-
* @example Using Bunyan (auto-instrumented, same signature as Pino)
|
|
81
|
-
* ```typescript
|
|
82
|
-
* import bunyan from 'bunyan'; // npm install bunyan @opentelemetry/instrumentation-bunyan
|
|
83
|
-
* import { init } from 'autotel';
|
|
84
|
-
* import { BunyanInstrumentation } from '@opentelemetry/instrumentation-bunyan';
|
|
85
|
-
*
|
|
86
|
-
* const logger = bunyan.createLogger({ name: 'my-app' });
|
|
87
|
-
* init({
|
|
88
|
-
* service: 'my-app',
|
|
89
|
-
* logger,
|
|
90
|
-
* instrumentations: [new BunyanInstrumentation()]
|
|
91
|
-
* });
|
|
92
|
-
* ```
|
|
93
|
-
*
|
|
94
|
-
* @example Custom logger (MUST use Pino-compatible signature)
|
|
95
|
-
* ```typescript
|
|
96
|
-
* // ⚠️ Your custom logger MUST accept (object, message?) signature
|
|
97
|
-
* const logger = {
|
|
98
|
-
* info: (extra, msg) => console.log(msg || '', extra),
|
|
99
|
-
* warn: (extra, msg) => console.warn(msg || '', extra),
|
|
100
|
-
* error: (extra, msg) => console.error(msg || '', extra),
|
|
101
|
-
* debug: (extra, msg) => console.debug(msg || '', extra),
|
|
102
|
-
* };
|
|
103
|
-
* init({ service: 'my-app', logger });
|
|
104
|
-
* ```
|
|
105
|
-
*
|
|
106
|
-
* @example BYOL helper: inject trace context into any logger
|
|
107
|
-
* ```typescript
|
|
108
|
-
* import bunyan from 'bunyan';
|
|
109
|
-
* import { getTraceContext } from 'autotel/logger';
|
|
110
|
-
*
|
|
111
|
-
* const bunyanLogger = bunyan.createLogger({ name: 'myapp' });
|
|
112
|
-
* const ctx = getTraceContext();
|
|
113
|
-
* bunyanLogger.info({ ...ctx, userId: '123' }, 'Creating user');
|
|
114
|
-
* ```
|
|
115
|
-
*/
|
|
116
|
-
/**
|
|
117
|
-
* Log level constants
|
|
118
|
-
*/
|
|
119
|
-
const LOG_LEVEL = {
|
|
120
|
-
DEBUG: "debug",
|
|
121
|
-
INFO: "info",
|
|
122
|
-
WARN: "warn",
|
|
123
|
-
ERROR: "error"
|
|
124
|
-
};
|
|
125
|
-
/**
|
|
126
|
-
* TS5+ Standard Decorator for logging and tracing operations
|
|
127
|
-
* Uses TC39 Stage 3 decorator syntax
|
|
128
|
-
*
|
|
129
|
-
* This is the traditional per-method decorator approach.
|
|
130
|
-
* For zero-boilerplate solution, see @Instrumented class decorator.
|
|
131
|
-
*
|
|
132
|
-
* @example
|
|
133
|
-
* // Simple usage (Pino-style: object first, message second)
|
|
134
|
-
* class OrderService {
|
|
135
|
-
* constructor(private readonly deps: { log: Logger }) {}
|
|
136
|
-
*
|
|
137
|
-
* @LoggedOperation('order.create')
|
|
138
|
-
* async createOrder(data: CreateOrderData) {
|
|
139
|
-
* // ✅ Correct Pino-style logging
|
|
140
|
-
* this.deps.log.info({ orderId: data.id }, 'Creating order');
|
|
141
|
-
* }
|
|
142
|
-
* }
|
|
143
|
-
*
|
|
144
|
-
* // Advanced usage (future-proof for options)
|
|
145
|
-
* @LoggedOperation({ operationName: 'order.create' })
|
|
146
|
-
* async createOrder(data: CreateOrderData) { }
|
|
147
|
-
*/
|
|
148
|
-
function LoggedOperation(operationNameOrOptions) {
|
|
149
|
-
const operationName = typeof operationNameOrOptions === "string" ? operationNameOrOptions : operationNameOrOptions.operationName;
|
|
150
|
-
return function(originalMethod, context) {
|
|
151
|
-
const methodName = String(context.name);
|
|
152
|
-
return async function(...args) {
|
|
153
|
-
const log = this.deps?.log;
|
|
154
|
-
const startTime = performance.now();
|
|
155
|
-
return getConfig().tracer.startActiveSpan(operationName, async (span) => {
|
|
156
|
-
try {
|
|
157
|
-
log?.info({
|
|
158
|
-
operation: operationName,
|
|
159
|
-
method: methodName,
|
|
160
|
-
args
|
|
161
|
-
}, "Operation started");
|
|
162
|
-
const result = await originalMethod.apply(this, args);
|
|
163
|
-
const duration = performance.now() - startTime;
|
|
164
|
-
log?.info({
|
|
165
|
-
operation: operationName,
|
|
166
|
-
method: methodName,
|
|
167
|
-
duration
|
|
168
|
-
}, "Operation completed");
|
|
169
|
-
span.setStatus({ code: SpanStatusCode.OK });
|
|
170
|
-
span.setAttributes({
|
|
171
|
-
"operation.name": operationName,
|
|
172
|
-
"operation.method": methodName,
|
|
173
|
-
"operation.duration": duration,
|
|
174
|
-
"operation.success": true
|
|
175
|
-
});
|
|
176
|
-
return result;
|
|
177
|
-
} catch (error) {
|
|
178
|
-
const duration = performance.now() - startTime;
|
|
179
|
-
log?.error({
|
|
180
|
-
err: error instanceof Error ? error : void 0,
|
|
181
|
-
operation: operationName,
|
|
182
|
-
method: methodName,
|
|
183
|
-
duration
|
|
184
|
-
}, "Operation failed");
|
|
185
|
-
span.setStatus({
|
|
186
|
-
code: SpanStatusCode.ERROR,
|
|
187
|
-
message: error instanceof Error ? error.message : "Unknown error"
|
|
188
|
-
});
|
|
189
|
-
span.setAttributes({
|
|
190
|
-
"operation.name": operationName,
|
|
191
|
-
"operation.method": methodName,
|
|
192
|
-
"operation.duration": duration,
|
|
193
|
-
"operation.success": false,
|
|
194
|
-
"error.type": error instanceof Error ? error.constructor.name : "Unknown"
|
|
195
|
-
});
|
|
196
|
-
throw error;
|
|
197
|
-
} finally {
|
|
198
|
-
span.end();
|
|
199
|
-
}
|
|
200
|
-
});
|
|
201
|
-
};
|
|
202
|
-
};
|
|
203
|
-
}
|
|
204
|
-
|
|
205
|
-
//#endregion
|
|
206
|
-
exports.LOG_LEVEL = LOG_LEVEL;
|
|
207
|
-
exports.LoggedOperation = LoggedOperation;
|
|
208
|
-
Object.defineProperty(exports, 'autotelLogger', {
|
|
209
|
-
enumerable: true,
|
|
210
|
-
get: function () {
|
|
211
|
-
return autotelLogger;
|
|
212
|
-
}
|
|
213
|
-
});
|
|
214
|
-
Object.defineProperty(exports, 'createBuiltinLogger', {
|
|
215
|
-
enumerable: true,
|
|
216
|
-
get: function () {
|
|
217
|
-
return createBuiltinLogger;
|
|
218
|
-
}
|
|
219
|
-
});
|
|
220
|
-
Object.defineProperty(exports, 'getActiveLogLevel', {
|
|
221
|
-
enumerable: true,
|
|
222
|
-
get: function () {
|
|
223
|
-
return getActiveLogLevel;
|
|
224
|
-
}
|
|
225
|
-
});
|
|
226
|
-
Object.defineProperty(exports, 'getTraceContext', {
|
|
227
|
-
enumerable: true,
|
|
228
|
-
get: function () {
|
|
229
|
-
return getTraceContext;
|
|
230
|
-
}
|
|
231
|
-
});
|
|
232
|
-
Object.defineProperty(exports, 'runWithLogLevel', {
|
|
233
|
-
enumerable: true,
|
|
234
|
-
get: function () {
|
|
235
|
-
return runWithLogLevel;
|
|
236
|
-
}
|
|
237
|
-
});
|
|
238
|
-
//# sourceMappingURL=logger.cjs.map
|
|
4
|
+
exports.LOG_LEVEL = require_logger.LOG_LEVEL;
|
|
5
|
+
exports.LoggedOperation = require_logger.LoggedOperation;
|
|
6
|
+
exports.autotelLogger = require_logger.autotelLogger;
|
|
7
|
+
exports.createBuiltinLogger = require_logger.createBuiltinLogger;
|
|
8
|
+
exports.getActiveLogLevel = require_logger.getActiveLogLevel;
|
|
9
|
+
exports.getTraceContext = require_logger.getTraceContext;
|
|
10
|
+
exports.runWithLogLevel = require_logger.runWithLogLevel;
|
package/dist/messaging.cjs
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
|
|
2
2
|
const require_sampling = require('./sampling.cjs');
|
|
3
|
-
const require_functional = require('./functional-
|
|
3
|
+
const require_functional = require('./functional-BCtxvYir.cjs');
|
|
4
4
|
const require_correlated_events = require('./correlated-events-kSwLo3mi.cjs');
|
|
5
5
|
let _opentelemetry_api = require("@opentelemetry/api");
|
|
6
6
|
|
package/dist/messaging.js
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
import { createLinkFromHeaders, extractLinksFromBatch } from "./sampling.js";
|
|
2
|
-
import { a as trace$1 } from "./functional-
|
|
2
|
+
import { a as trace$1 } from "./functional-CrAq8Az8.js";
|
|
3
3
|
import { t as emitCorrelatedEvent } from "./correlated-events-Bzh5y-UB.js";
|
|
4
4
|
import { SpanKind, context, propagation } from "@opentelemetry/api";
|
|
5
5
|
|
|
@@ -1,6 +1,6 @@
|
|
|
1
|
-
const
|
|
1
|
+
const require_rolldown_runtime = require('./rolldown-runtime-C_NdSu1c.cjs');
|
|
2
2
|
let node_module = require("node:module");
|
|
3
|
-
node_module =
|
|
3
|
+
node_module = require_rolldown_runtime.__toESM(node_module, 1);
|
|
4
4
|
|
|
5
5
|
//#region src/node-require.ts
|
|
6
6
|
/**
|
|
@@ -98,4 +98,4 @@ Object.defineProperty(exports, 'safeRequire', {
|
|
|
98
98
|
return safeRequire;
|
|
99
99
|
}
|
|
100
100
|
});
|
|
101
|
-
//# sourceMappingURL=node-require-
|
|
101
|
+
//# sourceMappingURL=node-require-PFqDihze.cjs.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"node-require-
|
|
1
|
+
{"version":3,"file":"node-require-PFqDihze.cjs","names":["nodeModule"],"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\n// Namespace import, not `import { createRequire }`. A static *named* import of a\n// Node builtin breaks browser bundlers: tools like Vite rewrite `node:module`\n// to a stub (`__vite-browser-external`) that exports nothing, and Rollup hard-\n// errors on the unresolved named binding (\"createRequire is not exported by\n// __vite-browser-external\") — failing the consumer's build even though this\n// code never runs in the browser. A namespace import has no named binding to\n// resolve, so it bundles cleanly; `.createRequire` is read lazily below and is\n// only ever touched in a real Node runtime.\nimport * as nodeModule 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 = nodeModule.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 `nodeModule.createRequire` directly if\n * you need 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":";;;;;;;;;;;;;;;AAyCA,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,gBAAgBA,YAAW,cAAc,IAAI;CAC7C,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"}
|
|
@@ -1,6 +1,6 @@
|
|
|
1
|
-
const
|
|
1
|
+
const require_rolldown_runtime = require('./rolldown-runtime-C_NdSu1c.cjs');
|
|
2
2
|
let node_async_hooks = require("node:async_hooks");
|
|
3
|
-
node_async_hooks =
|
|
3
|
+
node_async_hooks = require_rolldown_runtime.__toESM(node_async_hooks, 1);
|
|
4
4
|
|
|
5
5
|
//#region src/operation-context.ts
|
|
6
6
|
/**
|
|
@@ -69,4 +69,4 @@ Object.defineProperty(exports, 'runInOperationContext', {
|
|
|
69
69
|
return runInOperationContext;
|
|
70
70
|
}
|
|
71
71
|
});
|
|
72
|
-
//# sourceMappingURL=operation-context-
|
|
72
|
+
//# sourceMappingURL=operation-context-hzKbTKnt.cjs.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"operation-context-
|
|
1
|
+
{"version":3,"file":"operation-context-hzKbTKnt.cjs","names":["nodeAsyncHooks"],"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\n// namespace import for browser-bundler compat — see node-require.ts\nimport * as nodeAsyncHooks 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 =\n new nodeAsyncHooks.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":";;;;;;;;;;;;;;;;;AA2BA,MAAM,mBACJ,IAAIA,iBAAe,kBAAoC;;;;;;;;;;;;;;AAezD,SAAgB,sBAAoD;CAClE,OAAO,iBAAiB,SAAS;AACnC;;;;;;;;;;;;;;;;;;;;;AAsBA,SAAgB,sBAAyB,MAAc,IAAgB;CACrE,OAAO,iBAAiB,IAAI,EAAE,KAAK,GAAG,EAAE;AAC1C"}
|
package/dist/processors.cjs
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
|
|
2
|
-
const require_canonical_log_line_processor = require('./canonical-log-line-processor
|
|
2
|
+
const require_canonical_log_line_processor = require('./canonical-log-line-processor-CcrDi6TO.cjs');
|
|
3
3
|
let _opentelemetry_sdk_trace_base = require("@opentelemetry/sdk-trace-base");
|
|
4
4
|
|
|
5
5
|
Object.defineProperty(exports, 'BatchSpanProcessor', {
|
package/dist/processors.js
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import { t as CanonicalLogLineProcessor } from "./canonical-log-line-processor-
|
|
1
|
+
import { t as CanonicalLogLineProcessor } from "./canonical-log-line-processor-FLezvFCB.js";
|
|
2
2
|
import { BatchSpanProcessor, SimpleSpanProcessor } from "@opentelemetry/sdk-trace-base";
|
|
3
3
|
|
|
4
4
|
export { BatchSpanProcessor, CanonicalLogLineProcessor, SimpleSpanProcessor };
|
package/dist/register.cjs
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
|
-
const
|
|
1
|
+
const require_rolldown_runtime = require('./rolldown-runtime-C_NdSu1c.cjs');
|
|
2
2
|
let node_module = require("node:module");
|
|
3
|
-
node_module =
|
|
3
|
+
node_module = require_rolldown_runtime.__toESM(node_module, 1);
|
|
4
4
|
|
|
5
5
|
//#region src/register.ts
|
|
6
6
|
/**
|
package/dist/semantic-helpers.js
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
|
-
const
|
|
1
|
+
const require_rolldown_runtime = require('./rolldown-runtime-C_NdSu1c.cjs');
|
|
2
2
|
let node_crypto = require("node:crypto");
|
|
3
|
-
node_crypto =
|
|
3
|
+
node_crypto = require_rolldown_runtime.__toESM(node_crypto, 1);
|
|
4
4
|
|
|
5
5
|
//#region src/stable-hash.ts
|
|
6
6
|
/**
|
|
@@ -27,4 +27,4 @@ Object.defineProperty(exports, 'hashJson', {
|
|
|
27
27
|
return hashJson;
|
|
28
28
|
}
|
|
29
29
|
});
|
|
30
|
-
//# sourceMappingURL=stable-hash-
|
|
30
|
+
//# sourceMappingURL=stable-hash-CS9BxvVQ.cjs.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"stable-hash-
|
|
1
|
+
{"version":3,"file":"stable-hash-CS9BxvVQ.cjs","names":["nodeCrypto"],"sources":["../src/stable-hash.ts"],"sourcesContent":["// namespace import for browser-bundler compat — see node-require.ts\nimport * as nodeCrypto 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 nodeCrypto\n .createHash('sha256')\n .update(stableStringify(value))\n .digest('hex');\n}\n"],"mappings":";;;;;;;;;;;AASA,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,OAAOA,YACJ,WAAW,QAAQ,CAAC,CACpB,OAAO,gBAAgB,KAAK,CAAC,CAAC,CAC9B,OAAO,KAAK;AACjB"}
|
package/dist/testing.cjs
CHANGED
|
@@ -117,7 +117,8 @@ function createTraceCollector() {
|
|
|
117
117
|
};
|
|
118
118
|
require_config.configure({ tracer: {
|
|
119
119
|
startSpan(name, options, ctx) {
|
|
120
|
-
|
|
120
|
+
const startTime = performance.now();
|
|
121
|
+
return createMockSpan(name, startTime);
|
|
121
122
|
},
|
|
122
123
|
startActiveSpan(name, optionsOrFn, contextOrFn, fn) {
|
|
123
124
|
const callback = (() => {
|
|
@@ -126,7 +127,8 @@ function createTraceCollector() {
|
|
|
126
127
|
if (fn) return fn;
|
|
127
128
|
throw new Error("startActiveSpan requires a callback");
|
|
128
129
|
})();
|
|
129
|
-
const
|
|
130
|
+
const startTime = performance.now();
|
|
131
|
+
const mockSpan = createMockSpan(name, startTime);
|
|
130
132
|
const ctx = _opentelemetry_api.trace.setSpan(_opentelemetry_api.context.active(), mockSpan);
|
|
131
133
|
return _opentelemetry_api.context.with(ctx, () => callback(mockSpan));
|
|
132
134
|
}
|
package/dist/testing.cjs.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"testing.cjs","names":["SpanStatusCode","otelTrace","context"],"sources":["../src/testing.ts"],"sourcesContent":["/**\n * Testing Utilities\n *\n * Helpers for testing instrumented code and verifying telemetry.\n * Perfect for integration tests and QA in production validation.\n *\n * @example Verify traces are created\n * ```typescript\n * import { assertTraceCreated, collectTraces } from '@your-org/otel-decorators/testing'\n *\n * describe('UserService', () => {\n * it('should create trace for user creation', async () => {\n * const collector = collectTraces()\n *\n * const service = new UserService()\n * await service.createUser({ email: 'test@example.com' })\n *\n * assertTraceCreated(collector, 'user.createUser')\n * })\n * })\n * ```\n */\n\nimport {\n SpanStatusCode,\n type SpanStatus,\n type Attributes,\n type AttributeValue,\n context,\n trace as otelTrace,\n type Span,\n type SpanContext,\n type TimeInput,\n type Exception,\n type SpanOptions,\n type Context as OtelContext,\n type Tracer,\n} from '@opentelemetry/api';\nimport { type Logger } from './logger';\nimport { configure } from './config';\n\n// Re-export events testing utilities\nexport {\n createEventCollector,\n assertEventTracked,\n assertOutcomeTracked,\n type EventCollector,\n type EventData,\n type EventsFunnelStep,\n type EventsOutcome,\n type EventsValue,\n} from './event-testing';\n\n/**\n * Note: OpenTelemetry exporters and processors have moved to dedicated modules\n * for better semantic clarity.\n *\n * For exporters (ConsoleSpanExporter, InMemorySpanExporter):\n * @see {@link autotel/exporters}\n *\n * For processors (SimpleSpanProcessor, BatchSpanProcessor):\n * @see {@link autotel/processors}\n *\n * This module focuses on high-level testing utilities with assertion helpers\n * and trace collectors.\n *\n * @example High-level testing (recommended)\n * ```typescript\n * import { createTraceCollector, assertTraceCreated } from 'autotel/testing'\n *\n * const collector = createTraceCollector()\n * await myService.doSomething()\n * assertTraceCreated(collector, 'myService.doSomething')\n * ```\n *\n * @example Low-level testing (when you need raw OTel spans)\n * ```typescript\n * import { InMemorySpanExporter } from 'autotel/exporters'\n * import { SimpleSpanProcessor } from 'autotel/processors'\n *\n * const exporter = new InMemorySpanExporter()\n * init({ service: 'test', spanProcessor: new SimpleSpanProcessor(exporter) })\n * ```\n */\n\n/**\n * Simplified span representation for testing\n */\nexport interface TestSpan {\n name: string;\n status: SpanStatus;\n attributes: Attributes;\n startTime: number;\n endTime: number;\n duration: number;\n}\n\n/**\n * In-memory trace collector for testing\n */\nexport interface TraceCollector {\n /** Get all collected spans */\n getSpans(): TestSpan[];\n /** Get spans matching a name */\n getSpansByName(name: string): TestSpan[];\n /** Get spans matching attributes */\n getSpansByAttributes(attributes: Record<string, unknown>): TestSpan[];\n /** Clear all collected spans */\n clear(): void;\n /** Record a span (internal use) */\n recordSpan(span: TestSpan): void;\n}\n\n/**\n * Create an in-memory trace collector for testing\n *\n * IMPORTANT: This automatically configures the global tracer to record spans.\n * Call this in your test's beforeEach() to ensure proper setup.\n *\n * @example\n * ```typescript\n * import { createTraceCollector } from 'autotel/testing'\n *\n * describe('MyService', () => {\n * let collector: TraceCollector\n *\n * beforeEach(() => {\n * collector = createTraceCollector()\n * })\n *\n * it('should trace operations', async () => {\n * await myService.doSomething()\n *\n * const spans = collector.getSpansByName('myService.doSomething')\n * expect(spans).toHaveLength(1)\n * })\n * })\n * ```\n */\nexport function createTraceCollector(): TraceCollector {\n const spans: TestSpan[] = [];\n\n // Create mock span that captures data and implements full Span interface\n const createMockSpan = (name: string, startTime: number): Span => {\n const spanData: Partial<TestSpan> = {\n name,\n startTime,\n attributes: {},\n status: { code: SpanStatusCode.OK },\n };\n\n const spanContextData: SpanContext = {\n traceId: '1234567890abcdef1234567890abcdef', // 128-bit trace ID (32 hex chars)\n spanId: '1234567890abcdef', // 64-bit span ID (16 hex chars)\n traceFlags: 1,\n isRemote: false,\n };\n\n const mockSpan: Span = {\n spanContext: () => spanContextData,\n\n setStatus(status: SpanStatus) {\n spanData.status = status;\n return this;\n },\n\n setAttributes(attributes: Attributes) {\n spanData.attributes = { ...spanData.attributes, ...attributes };\n return this;\n },\n\n setAttribute(key: string, value: AttributeValue) {\n spanData.attributes = spanData.attributes || {};\n spanData.attributes[key] = value;\n return this;\n },\n\n addEvent(\n name: string,\n attributesOrStartTime?: Attributes | TimeInput,\n startTime?: TimeInput,\n ) {\n void name;\n void attributesOrStartTime;\n void startTime;\n return this;\n },\n\n addLink(link: { context: SpanContext; attributes?: Attributes }) {\n void link;\n return this;\n },\n\n addLinks(\n links: Array<{ context: SpanContext; attributes?: Attributes }>,\n ) {\n void links;\n return this;\n },\n\n updateName(newName: string) {\n spanData.name = newName;\n return this;\n },\n\n isRecording() {\n return true;\n },\n\n recordException(exception: Exception, time?: TimeInput) {\n void exception;\n void time;\n },\n\n end(endTimeArg?: TimeInput) {\n void endTimeArg;\n const endTime = performance.now();\n spans.push({\n name: spanData.name!,\n status: spanData.status!,\n attributes: spanData.attributes || {},\n startTime: spanData.startTime!,\n endTime,\n duration: endTime - spanData.startTime!,\n });\n },\n };\n\n return mockSpan;\n };\n\n // Create mock tracer\n const mockTracer: Tracer = {\n startSpan(name: string, options?: SpanOptions, ctx?: OtelContext): Span {\n void options;\n void ctx;\n const startTime = performance.now();\n return createMockSpan(name, startTime);\n },\n\n startActiveSpan<F extends (span: Span) => unknown>(\n name: string,\n optionsOrFn: SpanOptions | F,\n contextOrFn?: OtelContext | F,\n fn?: F,\n ): ReturnType<F> {\n const callback = (() => {\n if (typeof optionsOrFn === 'function') {\n return optionsOrFn;\n }\n if (typeof contextOrFn === 'function') {\n return contextOrFn;\n }\n if (fn) {\n return fn;\n }\n throw new Error('startActiveSpan requires a callback');\n })();\n\n const startTime = performance.now();\n const mockSpan = createMockSpan(name, startTime);\n\n // Set span as active in context (makes otelTrace.getActiveSpan() work)\n const ctx = otelTrace.setSpan(context.active(), mockSpan);\n return context.with(ctx, () => callback(mockSpan)) as ReturnType<F>;\n },\n };\n\n // Auto-configure global tracer\n configure({ tracer: mockTracer });\n\n return {\n getSpans(): TestSpan[] {\n return [...spans];\n },\n\n getSpansByName(name: string): TestSpan[] {\n return spans.filter((span) => span.name === name);\n },\n\n getSpansByAttributes(attributes: Record<string, unknown>): TestSpan[] {\n return spans.filter((span) => {\n return Object.entries(attributes).every(\n ([key, value]) => span.attributes[key] === value,\n );\n });\n },\n\n clear(): void {\n spans.length = 0;\n },\n\n recordSpan(span: TestSpan): void {\n spans.push(span);\n },\n };\n}\n\n/**\n * Assert that a trace was created for an operation\n *\n * @param collector - Trace collector\n * @param operationName - Expected operation name\n * @param options - Optional assertion options\n * @throws Error if trace was not found or doesn't match expectations\n *\n * @example\n * ```typescript\n * assertTraceCreated(collector, 'user.createUser')\n * assertTraceCreated(collector, 'user.createUser', {\n * minCount: 1,\n * maxCount: 1,\n * status: SpanStatusCode.OK,\n * attributes: { 'user.email': 'test@example.com' }\n * })\n * ```\n */\nexport function assertTraceCreated(\n collector: TraceCollector,\n operationName: string,\n options?: {\n minCount?: number;\n maxCount?: number;\n status?: SpanStatusCode;\n attributes?: Record<string, unknown>;\n },\n): void {\n const spans = collector.getSpansByName(operationName);\n\n if (options?.minCount !== undefined && spans.length < options.minCount) {\n throw new Error(\n `Expected at least ${options.minCount} traces for ${operationName}, got ${spans.length}`,\n );\n }\n\n if (options?.maxCount !== undefined && spans.length > options.maxCount) {\n throw new Error(\n `Expected at most ${options.maxCount} traces for ${operationName}, got ${spans.length}`,\n );\n }\n\n if (spans.length === 0) {\n throw new Error(`No traces found for operation: ${operationName}`);\n }\n\n if (options?.status !== undefined) {\n const matchingSpans = spans.filter(\n (span) => span.status.code === options.status,\n );\n if (matchingSpans.length === 0) {\n throw new Error(\n `No traces with status ${options.status} found for ${operationName}`,\n );\n }\n }\n\n if (options?.attributes) {\n const matchingSpans = spans.filter((span) => {\n return Object.entries(options.attributes!).every(\n ([key, value]) => span.attributes[key] === value,\n );\n });\n if (matchingSpans.length === 0) {\n throw new Error(\n `No traces with attributes ${JSON.stringify(options.attributes)} found for ${operationName}`,\n );\n }\n }\n}\n\n/**\n * Assert that no errors were logged\n *\n * Use this in smoke tests to verify critical paths don't have errors.\n *\n * @param collector - Trace collector\n * @throws Error if any error traces are found\n *\n * @example\n * ```typescript\n * // Run critical user flows\n * await runSmokeTests()\n *\n * // Verify no errors occurred\n * assertNoErrors(collector)\n * ```\n */\nexport function assertNoErrors(collector: TraceCollector): void {\n const errorSpans = collector\n .getSpans()\n .filter((span) => span.status.code === SpanStatusCode.ERROR);\n\n if (errorSpans.length > 0) {\n const errorSummary = errorSpans\n .map((span) => `${span.name}: ${span.status.message}`)\n .join('\\n');\n throw new Error(`Found ${errorSpans.length} error spans:\\n${errorSummary}`);\n }\n}\n\n/**\n * Assert that a trace was created and succeeded\n *\n * @param collector - Trace collector\n * @param operationName - Expected operation name\n *\n * @example\n * ```typescript\n * assertTraceSucceeded(collector, 'user.createUser')\n * ```\n */\nexport function assertTraceSucceeded(\n collector: TraceCollector,\n operationName: string,\n): void {\n assertTraceCreated(collector, operationName, { status: SpanStatusCode.OK });\n}\n\n/**\n * Assert that a trace was created and failed\n *\n * @param collector - Trace collector\n * @param operationName - Expected operation name\n * @param errorMessage - Optional expected error message\n *\n * @example\n * ```typescript\n * assertTraceFailed(collector, 'user.createUser', 'Invalid email')\n * ```\n */\nexport function assertTraceFailed(\n collector: TraceCollector,\n operationName: string,\n errorMessage?: string,\n): void {\n const spans = collector.getSpansByName(operationName);\n\n if (spans.length === 0) {\n throw new Error(`No traces found for operation: ${operationName}`);\n }\n\n const errorSpans = spans.filter(\n (span) => span.status.code === SpanStatusCode.ERROR,\n );\n\n if (errorSpans.length === 0) {\n throw new Error(`No error traces found for operation: ${operationName}`);\n }\n\n if (errorMessage) {\n const matchingSpans = errorSpans.filter(\n (span) => span.status.message === errorMessage,\n );\n if (matchingSpans.length === 0) {\n throw new Error(\n `No error traces with message \"${errorMessage}\" found for ${operationName}`,\n );\n }\n }\n}\n\n/**\n * In-memory log collector for testing\n */\nexport interface LogCollector {\n /** Get all collected logs */\n getLogs(): LogEntry[];\n /** Get logs by level */\n getLogsByLevel(level: 'info' | 'warn' | 'error' | 'debug'): LogEntry[];\n /** Get logs containing a message */\n getLogsByMessage(message: string): LogEntry[];\n /** Clear all collected logs */\n clear(): void;\n}\n\n/**\n * Log entry\n */\nexport interface LogEntry {\n level: 'info' | 'warn' | 'error' | 'debug';\n message: string;\n extra?: Record<string, unknown>;\n error?: Error;\n}\n\n/**\n * Create an in-memory log collector for testing\n *\n * @example\n * ```typescript\n * const logger = createMockLogger()\n *\n * // Use logger in your code\n * service.log = logger\n * await service.doSomething()\n *\n * // Assert logs were created\n * const logs = logger.getLogs()\n * expect(logs).toHaveLength(2)\n * expect(logs[0].message).toBe('Operation started')\n * ```\n */\nexport function createMockLogger(): Logger & LogCollector {\n const logs: LogEntry[] = [];\n\n // Pino-compatible signature: supports both:\n // - logger.info('message') - string only\n // - logger.info({ extra }, 'message') - object first with optional message\n const createLogMethod = (level: 'info' | 'warn' | 'debug') => {\n return (objOrMsg: Record<string, unknown> | string, msg?: string): void => {\n if (typeof objOrMsg === 'string') {\n // String-only call: logger.info('message')\n logs.push({\n level,\n message: objOrMsg,\n extra: undefined,\n });\n } else {\n // Pino style: logger.info({ extra }, 'message')\n logs.push({\n level,\n message: msg || '',\n extra: objOrMsg,\n });\n }\n };\n };\n\n return {\n info: createLogMethod('info'),\n warn: createLogMethod('warn'),\n debug: createLogMethod('debug'),\n\n error(objOrMsg: Record<string, unknown> | string, msg?: string): void {\n if (typeof objOrMsg === 'string') {\n // String-only call: logger.error('message')\n logs.push({\n level: 'error',\n message: objOrMsg,\n extra: undefined,\n error: undefined,\n });\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 } = objOrMsg as Record<string, unknown> & {\n err?: unknown;\n };\n logs.push({\n level: 'error',\n message: msg || '',\n error: err instanceof Error ? err : undefined,\n extra:\n err !== undefined && !(err instanceof Error)\n ? { err, ...rest }\n : rest,\n });\n },\n\n getLogs(): LogEntry[] {\n return [...logs];\n },\n\n getLogsByLevel(level: 'info' | 'warn' | 'error' | 'debug'): LogEntry[] {\n return logs.filter((log) => log.level === level);\n },\n\n getLogsByMessage(message: string): LogEntry[] {\n return logs.filter((log) => log.message.includes(message));\n },\n\n clear(): void {\n logs.length = 0;\n },\n };\n}\n\n/**\n * Assert that no error logs were created\n *\n * @param logger - Log collector\n * @throws Error if any error logs are found\n *\n * @example\n * ```typescript\n * assertNoErrorsLogged(logger)\n * ```\n */\nexport function assertNoErrorsLogged(logger: LogCollector): void {\n const errorLogs = logger.getLogsByLevel('error');\n\n if (errorLogs.length > 0) {\n const errorSummary = errorLogs\n .map(\n (log) => `${log.message}${log.error ? ': ' + log.error.message : ''}`,\n )\n .join('\\n');\n throw new Error(`Found ${errorLogs.length} error logs:\\n${errorSummary}`);\n }\n}\n\n/**\n * Wait for a specific trace to be created\n *\n * Useful for async operations where you need to wait for telemetry.\n *\n * @param collector - Trace collector\n * @param operationName - Expected operation name\n * @param timeoutMs - Timeout in milliseconds (default 5000)\n * @returns Promise that resolves when trace is found\n * @throws Error if timeout is reached\n *\n * @example\n * ```typescript\n * // Start async operation\n * const promise = service.doAsyncWork()\n *\n * // Wait for trace\n * await waitForTrace(collector, 'service.doAsyncWork', 1000)\n *\n * // Now you can assert on the trace\n * assertTraceSucceeded(collector, 'service.doAsyncWork')\n * ```\n */\nexport async function waitForTrace(\n collector: TraceCollector,\n operationName: string,\n timeoutMs: number = 5000,\n): Promise<void> {\n const startTime = Date.now();\n\n while (Date.now() - startTime < timeoutMs) {\n const spans = collector.getSpansByName(operationName);\n if (spans.length > 0) {\n return;\n }\n await new Promise((resolve) => setTimeout(resolve, 10));\n }\n\n throw new Error(\n `Timeout waiting for trace ${operationName} after ${timeoutMs}ms`,\n );\n}\n\n/**\n * Get trace duration in milliseconds\n *\n * @param collector - Trace collector\n * @param operationName - Operation name\n * @returns Duration in milliseconds, or undefined if trace not found\n *\n * @example\n * ```typescript\n * const duration = getTraceDuration(collector, 'user.createUser')\n * expect(duration).toBeLessThan(1000) // Should be < 1s\n * ```\n */\nexport function getTraceDuration(\n collector: TraceCollector,\n operationName: string,\n): number | undefined {\n const spans = collector.getSpansByName(operationName);\n if (spans.length === 0) {\n return undefined;\n }\n\n return spans[0]?.duration;\n}\n\n/**\n * Assert that an operation completed within a time threshold\n *\n * Perfect for performance testing and SLO validation.\n *\n * @param collector - Trace collector\n * @param operationName - Operation name\n * @param maxDurationMs - Maximum allowed duration in milliseconds\n * @throws Error if operation took too long\n *\n * @example\n * ```typescript\n * // Verify operation meets SLO\n * await service.createUser({ email: 'test@example.com' })\n * assertTraceDuration(collector, 'user.createUser', 500) // Must be < 500ms\n * ```\n */\nexport function assertTraceDuration(\n collector: TraceCollector,\n operationName: string,\n maxDurationMs: number,\n): void {\n const duration = getTraceDuration(collector, operationName);\n\n if (duration === undefined) {\n throw new Error(`No trace found for operation: ${operationName}`);\n }\n\n if (duration > maxDurationMs) {\n throw new Error(\n `Operation ${operationName} took ${duration.toFixed(2)}ms, exceeding ${maxDurationMs}ms threshold`,\n );\n }\n}\n"],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"testing.cjs","names":["SpanStatusCode","otelTrace","context"],"sources":["../src/testing.ts"],"sourcesContent":["/**\n * Testing Utilities\n *\n * Helpers for testing instrumented code and verifying telemetry.\n * Perfect for integration tests and QA in production validation.\n *\n * @example Verify traces are created\n * ```typescript\n * import { assertTraceCreated, collectTraces } from '@your-org/otel-decorators/testing'\n *\n * describe('UserService', () => {\n * it('should create trace for user creation', async () => {\n * const collector = collectTraces()\n *\n * const service = new UserService()\n * await service.createUser({ email: 'test@example.com' })\n *\n * assertTraceCreated(collector, 'user.createUser')\n * })\n * })\n * ```\n */\n\nimport {\n SpanStatusCode,\n type SpanStatus,\n type Attributes,\n type AttributeValue,\n context,\n trace as otelTrace,\n type Span,\n type SpanContext,\n type TimeInput,\n type Exception,\n type SpanOptions,\n type Context as OtelContext,\n type Tracer,\n} from '@opentelemetry/api';\nimport { type Logger } from './logger';\nimport { configure } from './config';\n\n// Re-export events testing utilities\nexport {\n createEventCollector,\n assertEventTracked,\n assertOutcomeTracked,\n type EventCollector,\n type EventData,\n type EventsFunnelStep,\n type EventsOutcome,\n type EventsValue,\n} from './event-testing';\n\n/**\n * Note: OpenTelemetry exporters and processors have moved to dedicated modules\n * for better semantic clarity.\n *\n * For exporters (ConsoleSpanExporter, InMemorySpanExporter):\n * @see {@link autotel/exporters}\n *\n * For processors (SimpleSpanProcessor, BatchSpanProcessor):\n * @see {@link autotel/processors}\n *\n * This module focuses on high-level testing utilities with assertion helpers\n * and trace collectors.\n *\n * @example High-level testing (recommended)\n * ```typescript\n * import { createTraceCollector, assertTraceCreated } from 'autotel/testing'\n *\n * const collector = createTraceCollector()\n * await myService.doSomething()\n * assertTraceCreated(collector, 'myService.doSomething')\n * ```\n *\n * @example Low-level testing (when you need raw OTel spans)\n * ```typescript\n * import { InMemorySpanExporter } from 'autotel/exporters'\n * import { SimpleSpanProcessor } from 'autotel/processors'\n *\n * const exporter = new InMemorySpanExporter()\n * init({ service: 'test', spanProcessor: new SimpleSpanProcessor(exporter) })\n * ```\n */\n\n/**\n * Simplified span representation for testing\n */\nexport interface TestSpan {\n name: string;\n status: SpanStatus;\n attributes: Attributes;\n startTime: number;\n endTime: number;\n duration: number;\n}\n\n/**\n * In-memory trace collector for testing\n */\nexport interface TraceCollector {\n /** Get all collected spans */\n getSpans(): TestSpan[];\n /** Get spans matching a name */\n getSpansByName(name: string): TestSpan[];\n /** Get spans matching attributes */\n getSpansByAttributes(attributes: Record<string, unknown>): TestSpan[];\n /** Clear all collected spans */\n clear(): void;\n /** Record a span (internal use) */\n recordSpan(span: TestSpan): void;\n}\n\n/**\n * Create an in-memory trace collector for testing\n *\n * IMPORTANT: This automatically configures the global tracer to record spans.\n * Call this in your test's beforeEach() to ensure proper setup.\n *\n * @example\n * ```typescript\n * import { createTraceCollector } from 'autotel/testing'\n *\n * describe('MyService', () => {\n * let collector: TraceCollector\n *\n * beforeEach(() => {\n * collector = createTraceCollector()\n * })\n *\n * it('should trace operations', async () => {\n * await myService.doSomething()\n *\n * const spans = collector.getSpansByName('myService.doSomething')\n * expect(spans).toHaveLength(1)\n * })\n * })\n * ```\n */\nexport function createTraceCollector(): TraceCollector {\n const spans: TestSpan[] = [];\n\n // Create mock span that captures data and implements full Span interface\n const createMockSpan = (name: string, startTime: number): Span => {\n const spanData: Partial<TestSpan> = {\n name,\n startTime,\n attributes: {},\n status: { code: SpanStatusCode.OK },\n };\n\n const spanContextData: SpanContext = {\n traceId: '1234567890abcdef1234567890abcdef', // 128-bit trace ID (32 hex chars)\n spanId: '1234567890abcdef', // 64-bit span ID (16 hex chars)\n traceFlags: 1,\n isRemote: false,\n };\n\n const mockSpan: Span = {\n spanContext: () => spanContextData,\n\n setStatus(status: SpanStatus) {\n spanData.status = status;\n return this;\n },\n\n setAttributes(attributes: Attributes) {\n spanData.attributes = { ...spanData.attributes, ...attributes };\n return this;\n },\n\n setAttribute(key: string, value: AttributeValue) {\n spanData.attributes = spanData.attributes || {};\n spanData.attributes[key] = value;\n return this;\n },\n\n addEvent(\n name: string,\n attributesOrStartTime?: Attributes | TimeInput,\n startTime?: TimeInput,\n ) {\n void name;\n void attributesOrStartTime;\n void startTime;\n return this;\n },\n\n addLink(link: { context: SpanContext; attributes?: Attributes }) {\n void link;\n return this;\n },\n\n addLinks(\n links: Array<{ context: SpanContext; attributes?: Attributes }>,\n ) {\n void links;\n return this;\n },\n\n updateName(newName: string) {\n spanData.name = newName;\n return this;\n },\n\n isRecording() {\n return true;\n },\n\n recordException(exception: Exception, time?: TimeInput) {\n void exception;\n void time;\n },\n\n end(endTimeArg?: TimeInput) {\n void endTimeArg;\n const endTime = performance.now();\n spans.push({\n name: spanData.name!,\n status: spanData.status!,\n attributes: spanData.attributes || {},\n startTime: spanData.startTime!,\n endTime,\n duration: endTime - spanData.startTime!,\n });\n },\n };\n\n return mockSpan;\n };\n\n // Create mock tracer\n const mockTracer: Tracer = {\n startSpan(name: string, options?: SpanOptions, ctx?: OtelContext): Span {\n void options;\n void ctx;\n const startTime = performance.now();\n return createMockSpan(name, startTime);\n },\n\n startActiveSpan<F extends (span: Span) => unknown>(\n name: string,\n optionsOrFn: SpanOptions | F,\n contextOrFn?: OtelContext | F,\n fn?: F,\n ): ReturnType<F> {\n const callback = (() => {\n if (typeof optionsOrFn === 'function') {\n return optionsOrFn;\n }\n if (typeof contextOrFn === 'function') {\n return contextOrFn;\n }\n if (fn) {\n return fn;\n }\n throw new Error('startActiveSpan requires a callback');\n })();\n\n const startTime = performance.now();\n const mockSpan = createMockSpan(name, startTime);\n\n // Set span as active in context (makes otelTrace.getActiveSpan() work)\n const ctx = otelTrace.setSpan(context.active(), mockSpan);\n return context.with(ctx, () => callback(mockSpan)) as ReturnType<F>;\n },\n };\n\n // Auto-configure global tracer\n configure({ tracer: mockTracer });\n\n return {\n getSpans(): TestSpan[] {\n return [...spans];\n },\n\n getSpansByName(name: string): TestSpan[] {\n return spans.filter((span) => span.name === name);\n },\n\n getSpansByAttributes(attributes: Record<string, unknown>): TestSpan[] {\n return spans.filter((span) => {\n return Object.entries(attributes).every(\n ([key, value]) => span.attributes[key] === value,\n );\n });\n },\n\n clear(): void {\n spans.length = 0;\n },\n\n recordSpan(span: TestSpan): void {\n spans.push(span);\n },\n };\n}\n\n/**\n * Assert that a trace was created for an operation\n *\n * @param collector - Trace collector\n * @param operationName - Expected operation name\n * @param options - Optional assertion options\n * @throws Error if trace was not found or doesn't match expectations\n *\n * @example\n * ```typescript\n * assertTraceCreated(collector, 'user.createUser')\n * assertTraceCreated(collector, 'user.createUser', {\n * minCount: 1,\n * maxCount: 1,\n * status: SpanStatusCode.OK,\n * attributes: { 'user.email': 'test@example.com' }\n * })\n * ```\n */\nexport function assertTraceCreated(\n collector: TraceCollector,\n operationName: string,\n options?: {\n minCount?: number;\n maxCount?: number;\n status?: SpanStatusCode;\n attributes?: Record<string, unknown>;\n },\n): void {\n const spans = collector.getSpansByName(operationName);\n\n if (options?.minCount !== undefined && spans.length < options.minCount) {\n throw new Error(\n `Expected at least ${options.minCount} traces for ${operationName}, got ${spans.length}`,\n );\n }\n\n if (options?.maxCount !== undefined && spans.length > options.maxCount) {\n throw new Error(\n `Expected at most ${options.maxCount} traces for ${operationName}, got ${spans.length}`,\n );\n }\n\n if (spans.length === 0) {\n throw new Error(`No traces found for operation: ${operationName}`);\n }\n\n if (options?.status !== undefined) {\n const matchingSpans = spans.filter(\n (span) => span.status.code === options.status,\n );\n if (matchingSpans.length === 0) {\n throw new Error(\n `No traces with status ${options.status} found for ${operationName}`,\n );\n }\n }\n\n if (options?.attributes) {\n const matchingSpans = spans.filter((span) => {\n return Object.entries(options.attributes!).every(\n ([key, value]) => span.attributes[key] === value,\n );\n });\n if (matchingSpans.length === 0) {\n throw new Error(\n `No traces with attributes ${JSON.stringify(options.attributes)} found for ${operationName}`,\n );\n }\n }\n}\n\n/**\n * Assert that no errors were logged\n *\n * Use this in smoke tests to verify critical paths don't have errors.\n *\n * @param collector - Trace collector\n * @throws Error if any error traces are found\n *\n * @example\n * ```typescript\n * // Run critical user flows\n * await runSmokeTests()\n *\n * // Verify no errors occurred\n * assertNoErrors(collector)\n * ```\n */\nexport function assertNoErrors(collector: TraceCollector): void {\n const errorSpans = collector\n .getSpans()\n .filter((span) => span.status.code === SpanStatusCode.ERROR);\n\n if (errorSpans.length > 0) {\n const errorSummary = errorSpans\n .map((span) => `${span.name}: ${span.status.message}`)\n .join('\\n');\n throw new Error(`Found ${errorSpans.length} error spans:\\n${errorSummary}`);\n }\n}\n\n/**\n * Assert that a trace was created and succeeded\n *\n * @param collector - Trace collector\n * @param operationName - Expected operation name\n *\n * @example\n * ```typescript\n * assertTraceSucceeded(collector, 'user.createUser')\n * ```\n */\nexport function assertTraceSucceeded(\n collector: TraceCollector,\n operationName: string,\n): void {\n assertTraceCreated(collector, operationName, { status: SpanStatusCode.OK });\n}\n\n/**\n * Assert that a trace was created and failed\n *\n * @param collector - Trace collector\n * @param operationName - Expected operation name\n * @param errorMessage - Optional expected error message\n *\n * @example\n * ```typescript\n * assertTraceFailed(collector, 'user.createUser', 'Invalid email')\n * ```\n */\nexport function assertTraceFailed(\n collector: TraceCollector,\n operationName: string,\n errorMessage?: string,\n): void {\n const spans = collector.getSpansByName(operationName);\n\n if (spans.length === 0) {\n throw new Error(`No traces found for operation: ${operationName}`);\n }\n\n const errorSpans = spans.filter(\n (span) => span.status.code === SpanStatusCode.ERROR,\n );\n\n if (errorSpans.length === 0) {\n throw new Error(`No error traces found for operation: ${operationName}`);\n }\n\n if (errorMessage) {\n const matchingSpans = errorSpans.filter(\n (span) => span.status.message === errorMessage,\n );\n if (matchingSpans.length === 0) {\n throw new Error(\n `No error traces with message \"${errorMessage}\" found for ${operationName}`,\n );\n }\n }\n}\n\n/**\n * In-memory log collector for testing\n */\nexport interface LogCollector {\n /** Get all collected logs */\n getLogs(): LogEntry[];\n /** Get logs by level */\n getLogsByLevel(level: 'info' | 'warn' | 'error' | 'debug'): LogEntry[];\n /** Get logs containing a message */\n getLogsByMessage(message: string): LogEntry[];\n /** Clear all collected logs */\n clear(): void;\n}\n\n/**\n * Log entry\n */\nexport interface LogEntry {\n level: 'info' | 'warn' | 'error' | 'debug';\n message: string;\n extra?: Record<string, unknown>;\n error?: Error;\n}\n\n/**\n * Create an in-memory log collector for testing\n *\n * @example\n * ```typescript\n * const logger = createMockLogger()\n *\n * // Use logger in your code\n * service.log = logger\n * await service.doSomething()\n *\n * // Assert logs were created\n * const logs = logger.getLogs()\n * expect(logs).toHaveLength(2)\n * expect(logs[0].message).toBe('Operation started')\n * ```\n */\nexport function createMockLogger(): Logger & LogCollector {\n const logs: LogEntry[] = [];\n\n // Pino-compatible signature: supports both:\n // - logger.info('message') - string only\n // - logger.info({ extra }, 'message') - object first with optional message\n const createLogMethod = (level: 'info' | 'warn' | 'debug') => {\n return (objOrMsg: Record<string, unknown> | string, msg?: string): void => {\n if (typeof objOrMsg === 'string') {\n // String-only call: logger.info('message')\n logs.push({\n level,\n message: objOrMsg,\n extra: undefined,\n });\n } else {\n // Pino style: logger.info({ extra }, 'message')\n logs.push({\n level,\n message: msg || '',\n extra: objOrMsg,\n });\n }\n };\n };\n\n return {\n info: createLogMethod('info'),\n warn: createLogMethod('warn'),\n debug: createLogMethod('debug'),\n\n error(objOrMsg: Record<string, unknown> | string, msg?: string): void {\n if (typeof objOrMsg === 'string') {\n // String-only call: logger.error('message')\n logs.push({\n level: 'error',\n message: objOrMsg,\n extra: undefined,\n error: undefined,\n });\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 } = objOrMsg as Record<string, unknown> & {\n err?: unknown;\n };\n logs.push({\n level: 'error',\n message: msg || '',\n error: err instanceof Error ? err : undefined,\n extra:\n err !== undefined && !(err instanceof Error)\n ? { err, ...rest }\n : rest,\n });\n },\n\n getLogs(): LogEntry[] {\n return [...logs];\n },\n\n getLogsByLevel(level: 'info' | 'warn' | 'error' | 'debug'): LogEntry[] {\n return logs.filter((log) => log.level === level);\n },\n\n getLogsByMessage(message: string): LogEntry[] {\n return logs.filter((log) => log.message.includes(message));\n },\n\n clear(): void {\n logs.length = 0;\n },\n };\n}\n\n/**\n * Assert that no error logs were created\n *\n * @param logger - Log collector\n * @throws Error if any error logs are found\n *\n * @example\n * ```typescript\n * assertNoErrorsLogged(logger)\n * ```\n */\nexport function assertNoErrorsLogged(logger: LogCollector): void {\n const errorLogs = logger.getLogsByLevel('error');\n\n if (errorLogs.length > 0) {\n const errorSummary = errorLogs\n .map(\n (log) => `${log.message}${log.error ? ': ' + log.error.message : ''}`,\n )\n .join('\\n');\n throw new Error(`Found ${errorLogs.length} error logs:\\n${errorSummary}`);\n }\n}\n\n/**\n * Wait for a specific trace to be created\n *\n * Useful for async operations where you need to wait for telemetry.\n *\n * @param collector - Trace collector\n * @param operationName - Expected operation name\n * @param timeoutMs - Timeout in milliseconds (default 5000)\n * @returns Promise that resolves when trace is found\n * @throws Error if timeout is reached\n *\n * @example\n * ```typescript\n * // Start async operation\n * const promise = service.doAsyncWork()\n *\n * // Wait for trace\n * await waitForTrace(collector, 'service.doAsyncWork', 1000)\n *\n * // Now you can assert on the trace\n * assertTraceSucceeded(collector, 'service.doAsyncWork')\n * ```\n */\nexport async function waitForTrace(\n collector: TraceCollector,\n operationName: string,\n timeoutMs: number = 5000,\n): Promise<void> {\n const startTime = Date.now();\n\n while (Date.now() - startTime < timeoutMs) {\n const spans = collector.getSpansByName(operationName);\n if (spans.length > 0) {\n return;\n }\n await new Promise((resolve) => setTimeout(resolve, 10));\n }\n\n throw new Error(\n `Timeout waiting for trace ${operationName} after ${timeoutMs}ms`,\n );\n}\n\n/**\n * Get trace duration in milliseconds\n *\n * @param collector - Trace collector\n * @param operationName - Operation name\n * @returns Duration in milliseconds, or undefined if trace not found\n *\n * @example\n * ```typescript\n * const duration = getTraceDuration(collector, 'user.createUser')\n * expect(duration).toBeLessThan(1000) // Should be < 1s\n * ```\n */\nexport function getTraceDuration(\n collector: TraceCollector,\n operationName: string,\n): number | undefined {\n const spans = collector.getSpansByName(operationName);\n if (spans.length === 0) {\n return undefined;\n }\n\n return spans[0]?.duration;\n}\n\n/**\n * Assert that an operation completed within a time threshold\n *\n * Perfect for performance testing and SLO validation.\n *\n * @param collector - Trace collector\n * @param operationName - Operation name\n * @param maxDurationMs - Maximum allowed duration in milliseconds\n * @throws Error if operation took too long\n *\n * @example\n * ```typescript\n * // Verify operation meets SLO\n * await service.createUser({ email: 'test@example.com' })\n * assertTraceDuration(collector, 'user.createUser', 500) // Must be < 500ms\n * ```\n */\nexport function assertTraceDuration(\n collector: TraceCollector,\n operationName: string,\n maxDurationMs: number,\n): void {\n const duration = getTraceDuration(collector, operationName);\n\n if (duration === undefined) {\n throw new Error(`No trace found for operation: ${operationName}`);\n }\n\n if (duration > maxDurationMs) {\n throw new Error(\n `Operation ${operationName} took ${duration.toFixed(2)}ms, exceeding ${maxDurationMs}ms threshold`,\n );\n }\n}\n"],"mappings":"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"}
|