autotel 4.3.0 → 6.0.0

package/dist/testing.cjs

@@ -1,7 +1,11 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_rolldown_runtime = require('./rolldown-runtime-C_NdSu1c.cjs');
 const require_config = require('./config.cjs');
 const require_event_testing = require('./event-testing.cjs');
+const require_test_span_collector = require('./test-span-collector.cjs');
 let _opentelemetry_api = require("@opentelemetry/api");
+let node_async_hooks = require("node:async_hooks");
+node_async_hooks = require_rolldown_runtime.__toESM(node_async_hooks, 1);
 
 //#region src/testing.ts
 /**
@@ -54,19 +58,29 @@ let _opentelemetry_api = require("@opentelemetry/api");
 */
 function createTraceCollector() {
 	const spans = [];
-	const createMockSpan = (name, startTime) => {
+	const activeMockSpanStorage = new node_async_hooks.AsyncLocalStorage();
+	let nextTraceId = 1;
+	let nextSpanId = 1;
+	const hexId = (value, length) => value.toString(16).padStart(length, "0");
+	const createMockSpan = (name, startTime, parentSpanContext, options) => {
+		const spanContextData = {
+			traceId: parentSpanContext?.traceId ?? hexId(nextTraceId++, 32),
+			spanId: hexId(nextSpanId++, 16),
+			traceFlags: 1,
+			isRemote: false
+		};
 		const spanData = {
+			traceId: spanContextData.traceId,
+			spanId: spanContextData.spanId,
+			parentSpanId: parentSpanContext?.spanId,
+			kind: options?.kind,
 			name,
 			startTime,
 			attributes: {},
+			events: [],
+			links: [],
 			status: { code: _opentelemetry_api.SpanStatusCode.OK }
 		};
-		const spanContextData = {
-			traceId: "1234567890abcdef1234567890abcdef",
-			spanId: "1234567890abcdef",
-			traceFlags: 1,
-			isRemote: false
-		};
 		return {
 			spanContext: () => spanContextData,
 			setStatus(status) {
@@ -86,12 +100,19 @@ function createTraceCollector() {
 				return this;
 			},
 			addEvent(name, attributesOrStartTime, startTime) {
+				const attributes = attributesOrStartTime && !Array.isArray(attributesOrStartTime) && typeof attributesOrStartTime === "object" ? attributesOrStartTime : void 0;
+				spanData.events.push({
+					name,
+					attributes
+				});
 				return this;
 			},
 			addLink(link) {
+				spanData.links.push(link);
 				return this;
 			},
 			addLinks(links) {
+				spanData.links.push(...links);
 				return this;
 			},
 			updateName(newName) {
@@ -105,9 +126,15 @@ function createTraceCollector() {
 			end(endTimeArg) {
 				const endTime = performance.now();
 				spans.push({
+					traceId: spanData.traceId,
+					spanId: spanData.spanId,
+					parentSpanId: spanData.parentSpanId,
+					kind: spanData.kind,
 					name: spanData.name,
 					status: spanData.status,
 					attributes: spanData.attributes || {},
+					events: spanData.events || [],
+					links: spanData.links || [],
 					startTime: spanData.startTime,
 					endTime,
 					duration: endTime - spanData.startTime
@@ -118,7 +145,8 @@ function createTraceCollector() {
 	require_config.configure({ tracer: {
 		startSpan(name, options, ctx) {
 			const startTime = performance.now();
-			return createMockSpan(name, startTime);
+			const parent = (ctx ? _opentelemetry_api.trace.getSpan(ctx)?.spanContext() : void 0) ?? activeMockSpanStorage.getStore()?.spanContext();
+			return createMockSpan(name, startTime, parent, options);
 		},
 		startActiveSpan(name, optionsOrFn, contextOrFn, fn) {
 			const callback = (() => {
@@ -128,9 +156,13 @@ function createTraceCollector() {
 				throw new Error("startActiveSpan requires a callback");
 			})();
 			const startTime = performance.now();
-			const mockSpan = createMockSpan(name, startTime);
-			const ctx = _opentelemetry_api.trace.setSpan(_opentelemetry_api.context.active(), mockSpan);
-			return _opentelemetry_api.context.with(ctx, () => callback(mockSpan));
+			const suppliedContext = typeof optionsOrFn === "function" ? _opentelemetry_api.context.active() : typeof contextOrFn === "function" || contextOrFn === void 0 ? _opentelemetry_api.context.active() : contextOrFn;
+			const parent = _opentelemetry_api.trace.getSpan(suppliedContext)?.spanContext() ?? activeMockSpanStorage.getStore()?.spanContext();
+			const mockSpan = createMockSpan(name, startTime, parent, typeof optionsOrFn === "function" ? void 0 : optionsOrFn);
+			const ctx = _opentelemetry_api.trace.setSpan(suppliedContext, mockSpan);
+			return activeMockSpanStorage.run(mockSpan, () => {
+				return _opentelemetry_api.context.with(ctx, () => callback(mockSpan));
+			});
 		}
 	} });
 	return {
@@ -145,6 +177,37 @@ function createTraceCollector() {
 				return Object.entries(attributes).every(([key, value]) => span.attributes[key] === value);
 			});
 		},
+		getSpansByTraceId(traceId) {
+			return spans.filter((span) => span.traceId === traceId);
+		},
+		getRootSpans() {
+			return spans.filter((span) => span.parentSpanId === void 0);
+		},
+		getDescendants(rootSpanId) {
+			const included = /* @__PURE__ */ new Set([rootSpanId]);
+			let changed = true;
+			while (changed) {
+				changed = false;
+				for (const span of spans) if (span.parentSpanId && included.has(span.parentSpanId) && !included.has(span.spanId)) {
+					included.add(span.spanId);
+					changed = true;
+				}
+			}
+			included.delete(rootSpanId);
+			return spans.filter((span) => included.has(span.spanId));
+		},
+		expectSpan(criteria) {
+			const matches = typeof criteria === "string" ? spans.filter((span) => span.name === criteria) : spans.filter((span) => {
+				if (criteria.name !== void 0 && span.name !== criteria.name) return false;
+				if (criteria.traceId !== void 0 && span.traceId !== criteria.traceId) return false;
+				if (criteria.spanId !== void 0 && span.spanId !== criteria.spanId) return false;
+				if (criteria.parentSpanId !== void 0 && span.parentSpanId !== criteria.parentSpanId) return false;
+				if (criteria.kind !== void 0 && span.kind !== criteria.kind) return false;
+				return Object.entries(criteria.attributes ?? {}).every(([key, value]) => span.attributes[key] === value);
+			});
+			if (matches.length !== 1) throw new Error(`Expected exactly one span matching ${JSON.stringify(criteria)}, found ${matches.length}`);
+			return matches[0];
+		},
 		clear() {
 			spans.length = 0;
 		},
@@ -408,6 +471,7 @@ function assertTraceDuration(collector, operationName, maxDurationMs) {
 }
 
 //#endregion
+exports.TestSpanCollector = require_test_span_collector.TestSpanCollector;
 exports.assertEventTracked = require_event_testing.assertEventTracked;
 exports.assertNoErrors = assertNoErrors;
 exports.assertNoErrorsLogged = assertNoErrorsLogged;
@@ -420,5 +484,6 @@ exports.createEventCollector = require_event_testing.createEventCollector;
 exports.createMockLogger = createMockLogger;
 exports.createTraceCollector = createTraceCollector;
 exports.getTraceDuration = getTraceDuration;
+exports.serializeSpan = require_test_span_collector.serializeSpan;
 exports.waitForTrace = waitForTrace;
 //# sourceMappingURL=testing.cjs.map

package/dist/testing.cjs.map

@@ -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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"}
+{"version":3,"file":"testing.cjs","names":["nodeAsyncHooks","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 Link,\n  type SpanOptions,\n  type Context as OtelContext,\n  type Tracer,\n  type SpanKind,\n} from '@opentelemetry/api';\nimport * as nodeAsyncHooks from 'node:async_hooks';\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';\nexport {\n  TestSpanCollector,\n  serializeSpan,\n  type SerializedSpan,\n} from './test-span-collector';\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  traceId: string;\n  spanId: string;\n  parentSpanId?: string;\n  kind?: SpanKind;\n  name: string;\n  status: SpanStatus;\n  attributes: Attributes;\n  events: Array<{ name: string; attributes?: Attributes }>;\n  links: Link[];\n  startTime: number;\n  endTime: number;\n  duration: number;\n}\n\nexport interface SpanMatch {\n  name?: string;\n  traceId?: string;\n  spanId?: string;\n  parentSpanId?: string;\n  kind?: SpanKind;\n  attributes?: Record<string, unknown>;\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  /** Get spans belonging to a trace */\n  getSpansByTraceId(traceId: string): TestSpan[];\n  /** Get spans without a recorded parent */\n  getRootSpans(): TestSpan[];\n  /** Get all descendants of a span, ordered by completion */\n  getDescendants(rootSpanId: string): TestSpan[];\n  /** Find exactly one span or throw an actionable assertion error */\n  expectSpan(criteria: string | SpanMatch): 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  const activeMockSpanStorage = new nodeAsyncHooks.AsyncLocalStorage<Span>();\n  let nextTraceId = 1;\n  let nextSpanId = 1;\n\n  const hexId = (value: number, length: number) =>\n    value.toString(16).padStart(length, '0');\n\n  // Create mock span that captures data and implements full Span interface\n  const createMockSpan = (\n    name: string,\n    startTime: number,\n    parentSpanContext?: SpanContext,\n    options?: SpanOptions,\n  ): Span => {\n    const spanContextData: SpanContext = {\n      traceId: parentSpanContext?.traceId ?? hexId(nextTraceId++, 32),\n      spanId: hexId(nextSpanId++, 16),\n      traceFlags: 1,\n      isRemote: false,\n    };\n    const spanData: Partial<TestSpan> = {\n      traceId: spanContextData.traceId,\n      spanId: spanContextData.spanId,\n      parentSpanId: parentSpanContext?.spanId,\n      kind: options?.kind,\n      name,\n      startTime,\n      attributes: {},\n      events: [],\n      links: [],\n      status: { code: SpanStatusCode.OK },\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        const attributes =\n          attributesOrStartTime &&\n          !Array.isArray(attributesOrStartTime) &&\n          typeof attributesOrStartTime === 'object'\n            ? (attributesOrStartTime as Attributes)\n            : undefined;\n        spanData.events!.push({ name, attributes });\n        void startTime;\n        return this;\n      },\n\n      addLink(link: { context: SpanContext; attributes?: Attributes }) {\n        spanData.links!.push(link);\n        return this;\n      },\n\n      addLinks(\n        links: Array<{ context: SpanContext; attributes?: Attributes }>,\n      ) {\n        spanData.links!.push(...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          traceId: spanData.traceId!,\n          spanId: spanData.spanId!,\n          parentSpanId: spanData.parentSpanId,\n          kind: spanData.kind,\n          name: spanData.name!,\n          status: spanData.status!,\n          attributes: spanData.attributes || {},\n          events: spanData.events || [],\n          links: spanData.links || [],\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      const startTime = performance.now();\n      const parent =\n        (ctx ? otelTrace.getSpan(ctx)?.spanContext() : undefined) ??\n        activeMockSpanStorage.getStore()?.spanContext();\n      return createMockSpan(name, startTime, parent, options);\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 suppliedContext =\n        typeof optionsOrFn === 'function'\n          ? context.active()\n          : typeof contextOrFn === 'function' || contextOrFn === undefined\n            ? context.active()\n            : contextOrFn;\n      const parent =\n        otelTrace.getSpan(suppliedContext)?.spanContext() ??\n        activeMockSpanStorage.getStore()?.spanContext();\n      const spanOptions =\n        typeof optionsOrFn === 'function' ? undefined : optionsOrFn;\n      const mockSpan = createMockSpan(name, startTime, parent, spanOptions);\n\n      // Set span as active in context (makes otelTrace.getActiveSpan() work)\n      const ctx = otelTrace.setSpan(suppliedContext, mockSpan);\n      return activeMockSpanStorage.run(mockSpan, () => {\n        return context.with(ctx, () => callback(mockSpan)) as ReturnType<F>;\n      });\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    getSpansByTraceId(traceId: string): TestSpan[] {\n      return spans.filter((span) => span.traceId === traceId);\n    },\n\n    getRootSpans(): TestSpan[] {\n      return spans.filter((span) => span.parentSpanId === undefined);\n    },\n\n    getDescendants(rootSpanId: string): TestSpan[] {\n      const included = new Set([rootSpanId]);\n      let changed = true;\n      while (changed) {\n        changed = false;\n        for (const span of spans) {\n          if (\n            span.parentSpanId &&\n            included.has(span.parentSpanId) &&\n            !included.has(span.spanId)\n          ) {\n            included.add(span.spanId);\n            changed = true;\n          }\n        }\n      }\n      included.delete(rootSpanId);\n      return spans.filter((span) => included.has(span.spanId));\n    },\n\n    expectSpan(criteria: string | SpanMatch): TestSpan {\n      const matches =\n        typeof criteria === 'string'\n          ? spans.filter((span) => span.name === criteria)\n          : spans.filter((span) => {\n              if (criteria.name !== undefined && span.name !== criteria.name) {\n                return false;\n              }\n              if (\n                criteria.traceId !== undefined &&\n                span.traceId !== criteria.traceId\n              ) {\n                return false;\n              }\n              if (\n                criteria.spanId !== undefined &&\n                span.spanId !== criteria.spanId\n              ) {\n                return false;\n              }\n              if (\n                criteria.parentSpanId !== undefined &&\n                span.parentSpanId !== criteria.parentSpanId\n              ) {\n                return false;\n              }\n              if (criteria.kind !== undefined && span.kind !== criteria.kind) {\n                return false;\n              }\n              return Object.entries(criteria.attributes ?? {}).every(\n                ([key, value]) => span.attributes[key] === value,\n              );\n            });\n      if (matches.length !== 1) {\n        throw new Error(\n          `Expected exactly one span matching ${JSON.stringify(criteria)}, found ${matches.length}`,\n        );\n      }\n      return matches[0]!;\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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"}

package/dist/testing.d.cts

@@ -1,7 +1,7 @@
-import { s as Logger } from "./logger-BauSUhUv.cjs";
-import { a as EventsValue, c as createEventCollector, i as EventsOutcome, n as EventData, o as assertEventTracked, r as EventsFunnelStep, s as assertOutcomeTracked, t as EventCollector } from "./event-testing-BqRnI0z4.cjs";
-import { Attributes, SpanStatus, SpanStatusCode } from "@opentelemetry/api";
-
+import { s as Logger } from "./logger-CN4xpzMd.cjs";
+import { a as EventsValue, c as createEventCollector, i as EventsOutcome, n as EventData, o as assertEventTracked, r as EventsFunnelStep, s as assertOutcomeTracked, t as EventCollector } from "./event-testing-D0qWfqAy.cjs";
+import { SerializedSpan, TestSpanCollector, serializeSpan } from "./test-span-collector.cjs";
+import { Attributes, Link, SpanKind, SpanStatus, SpanStatusCode } from "@opentelemetry/api";
 //#region src/testing.d.ts
 /**
  * Note: OpenTelemetry exporters and processors have moved to dedicated modules
@@ -38,13 +38,30 @@ import { Attributes, SpanStatus, SpanStatusCode } from "@opentelemetry/api";
  * Simplified span representation for testing
  */
 interface TestSpan {
+  traceId: string;
+  spanId: string;
+  parentSpanId?: string;
+  kind?: SpanKind;
   name: string;
   status: SpanStatus;
   attributes: Attributes;
+  events: Array<{
+    name: string;
+    attributes?: Attributes;
+  }>;
+  links: Link[];
   startTime: number;
   endTime: number;
   duration: number;
 }
+interface SpanMatch {
+  name?: string;
+  traceId?: string;
+  spanId?: string;
+  parentSpanId?: string;
+  kind?: SpanKind;
+  attributes?: Record<string, unknown>;
+}
 /**
  * In-memory trace collector for testing
  */
@@ -55,6 +72,14 @@ interface TraceCollector {
   getSpansByName(name: string): TestSpan[];
   /** Get spans matching attributes */
   getSpansByAttributes(attributes: Record<string, unknown>): TestSpan[];
+  /** Get spans belonging to a trace */
+  getSpansByTraceId(traceId: string): TestSpan[];
+  /** Get spans without a recorded parent */
+  getRootSpans(): TestSpan[];
+  /** Get all descendants of a span, ordered by completion */
+  getDescendants(rootSpanId: string): TestSpan[];
+  /** Find exactly one span or throw an actionable assertion error */
+  expectSpan(criteria: string | SpanMatch): TestSpan;
   /** Clear all collected spans */
   clear(): void;
   /** Record a span (internal use) */
@@ -264,5 +289,5 @@ declare function getTraceDuration(collector: TraceCollector, operationName: stri
  */
 declare function assertTraceDuration(collector: TraceCollector, operationName: string, maxDurationMs: number): void;
 //#endregion
-export { type EventCollector, type EventData, type EventsFunnelStep, type EventsOutcome, type EventsValue, LogCollector, LogEntry, TestSpan, TraceCollector, assertEventTracked, assertNoErrors, assertNoErrorsLogged, assertOutcomeTracked, assertTraceCreated, assertTraceDuration, assertTraceFailed, assertTraceSucceeded, createEventCollector, createMockLogger, createTraceCollector, getTraceDuration, waitForTrace };
+export { type EventCollector, type EventData, type EventsFunnelStep, type EventsOutcome, type EventsValue, LogCollector, LogEntry, type SerializedSpan, SpanMatch, TestSpan, TestSpanCollector, TraceCollector, assertEventTracked, assertNoErrors, assertNoErrorsLogged, assertOutcomeTracked, assertTraceCreated, assertTraceDuration, assertTraceFailed, assertTraceSucceeded, createEventCollector, createMockLogger, createTraceCollector, getTraceDuration, serializeSpan, waitForTrace };
 //# sourceMappingURL=testing.d.cts.map

package/dist/testing.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"testing.d.cts","names":[],"sources":["../src/testing.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AA8G2B;AA6B3B;;;;AAAsD;AAkLtD;;;;;;;;;;UArOiB,QAAA;EACf,IAAA;EACA,MAAA,EAAQ,UAAA;EACR,UAAA,EAAY,UAAU;EACtB,SAAA;EACA,OAAA;EACA,QAAA;AAAA;;AAuOC;AA8DH;UA/RiB,cAAA;;EAEf,QAAA,IAAY,QAAA;EA6R0C;EA3RtD,cAAA,CAAe,IAAA,WAAe,QAAA;EAmTI;EAjTlC,oBAAA,CAAqB,UAAA,EAAY,MAAA,oBAA0B,QAAA;EAkTlC;EAhTzB,KAAA;EAgTA;EA9SA,UAAA,CAAW,IAAA,EAAM,QAAA;AAAA;AA+SI;AAiBvB;;;;;;;;;AAGuB;AA+BvB;;;;;;;;;;;;;;;AAnDuB,iBAlRP,oBAAA,IAAwB,cAAc;;;AA6U/C;AAMP;;;;;;;;;;;AAIe;AAoBf;;;;iBAzLgB,kBAAA,CACd,SAAA,EAAW,cAAA,EACX,aAAA,UACA,OAAA;EACE,QAAA;EACA,QAAA;EACA,MAAA,GAAS,cAAA;EACT,UAAA,GAAa,MAAA;AAAA;AA8SjB;;;;;;;;;;AAIU;AA6BV;;;;;;AAjCA,iBA/OgB,cAAA,CAAe,SAAyB,EAAd,cAAc;;AAkRjC;AA2BvB;;;;;;;;;iBArRgB,oBAAA,CACd,SAAA,EAAW,cAAc,EACzB,aAAA;;;;;;;;;;;;;iBAiBc,iBAAA,CACd,SAAA,EAAW,cAAc,EACzB,aAAA,UACA,YAAA;;;;UA+Be,YAAA;;EAEf,OAAA,IAAW,QAAA;;EAEX,cAAA,CAAe,KAAA,wCAA6C,QAAA;;EAE5D,gBAAA,CAAiB,OAAA,WAAkB,QAAA;;EAEnC,KAAA;AAAA;;;;UAMe,QAAA;EACf,KAAA;EACA,OAAA;EACA,KAAA,GAAQ,MAAA;EACR,KAAA,GAAQ,KAAK;AAAA;;;;;;;;;;;;;;;;;;iBAoBC,gBAAA,IAAoB,MAAA,GAAS,YAAY;;;;;;;;;;;;iBAwFzC,oBAAA,CAAqB,MAAoB,EAAZ,YAAY;;;;;;;;;;;;;;;;;;;;;;;;iBAoCnC,YAAA,CACpB,SAAA,EAAW,cAAA,EACX,aAAA,UACA,SAAA,YACC,OAAO;;;;;;;;;;;;;;iBA6BM,gBAAA,CACd,SAAA,EAAW,cAAc,EACzB,aAAA;;;;;;;;;;;;;;;;;;iBA2Bc,mBAAA,CACd,SAAA,EAAW,cAAc,EACzB,aAAA,UACA,aAAA"}
+{"version":3,"file":"testing.d.cts","names":[],"sources":["../src/testing.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;UAgGiB;EACf;EACA;EACA;EACA,OAAO;EACP;EACA,QAAQ;EACR,YAAY;EACZ,QAAQ;IAAQ;IAAc,aAAa;;EAC3C,OAAO;EACP;EACA;EACA;;UAGe;EACf;EACA;EACA;EACA;EACA,OAAO;EACP,aAAa;;;;;UAME;;EAEf,YAAY;;EAEZ,eAAe,eAAe;;EAE9B,qBAAqB,YAAY,0BAA0B;;EAE3D,kBAAkB,kBAAkB;;EAEpC,gBAAgB;;EAEhB,eAAe,qBAAqB;;EAEpC,WAAW,mBAAmB,YAAY;;EAE1C;;EAEA,WAAW,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA6BH,wBAAwB;;;;;;;;;;;;;;;;;;;;iBAgSxB,mBACd,WAAW,gBACX,uBACA;EACE;EACA;EACA,SAAS;EACT,aAAa;;;;;;;;;;;;;;;;;;;iBA+DD,eAAe,WAAW;;;;;;;;;;;;iBAwB1B,qBACd,WAAW,gBACX;;;;;;;;;;;;;iBAiBc,kBACd,WAAW,gBACX,uBACA;;;;UA+Be;;EAEf,WAAW;;EAEX,eAAe,6CAA6C;;EAE5D,iBAAiB,kBAAkB;;EAEnC;;;;;UAMe;EACf;EACA;EACA,QAAQ;EACR,QAAQ;;;;;;;;;;;;;;;;;;;iBAoBM,oBAAoB,SAAS;;;;;;;;;;;;iBAwF7B,qBAAqB,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;iBAoCvB,aACpB,WAAW,gBACX,uBACA,qBACC;;;;;;;;;;;;;;iBA6Ba,iBACd,WAAW,gBACX;;;;;;;;;;;;;;;;;;iBA2Bc,oBACd,WAAW,gBACX,uBACA"}

package/dist/testing.d.ts

@@ -1,7 +1,7 @@
-import { s as Logger } from "./logger-BauSUhUv.js";
-import { a as EventsValue, c as createEventCollector, i as EventsOutcome, n as EventData, o as assertEventTracked, r as EventsFunnelStep, s as assertOutcomeTracked, t as EventCollector } from "./event-testing-CfFs3to2.js";
-import { Attributes, SpanStatus, SpanStatusCode } from "@opentelemetry/api";
-
+import { s as Logger } from "./logger-CN4xpzMd.js";
+import { a as EventsValue, c as createEventCollector, i as EventsOutcome, n as EventData, o as assertEventTracked, r as EventsFunnelStep, s as assertOutcomeTracked, t as EventCollector } from "./event-testing-CA2mIx1E.js";
+import { SerializedSpan, TestSpanCollector, serializeSpan } from "./test-span-collector.js";
+import { Attributes, Link, SpanKind, SpanStatus, SpanStatusCode } from "@opentelemetry/api";
 //#region src/testing.d.ts
 /**
  * Note: OpenTelemetry exporters and processors have moved to dedicated modules
@@ -38,13 +38,30 @@ import { Attributes, SpanStatus, SpanStatusCode } from "@opentelemetry/api";
  * Simplified span representation for testing
  */
 interface TestSpan {
+  traceId: string;
+  spanId: string;
+  parentSpanId?: string;
+  kind?: SpanKind;
   name: string;
   status: SpanStatus;
   attributes: Attributes;
+  events: Array<{
+    name: string;
+    attributes?: Attributes;
+  }>;
+  links: Link[];
   startTime: number;
   endTime: number;
   duration: number;
 }
+interface SpanMatch {
+  name?: string;
+  traceId?: string;
+  spanId?: string;
+  parentSpanId?: string;
+  kind?: SpanKind;
+  attributes?: Record<string, unknown>;
+}
 /**
  * In-memory trace collector for testing
  */
@@ -55,6 +72,14 @@ interface TraceCollector {
   getSpansByName(name: string): TestSpan[];
   /** Get spans matching attributes */
   getSpansByAttributes(attributes: Record<string, unknown>): TestSpan[];
+  /** Get spans belonging to a trace */
+  getSpansByTraceId(traceId: string): TestSpan[];
+  /** Get spans without a recorded parent */
+  getRootSpans(): TestSpan[];
+  /** Get all descendants of a span, ordered by completion */
+  getDescendants(rootSpanId: string): TestSpan[];
+  /** Find exactly one span or throw an actionable assertion error */
+  expectSpan(criteria: string | SpanMatch): TestSpan;
   /** Clear all collected spans */
   clear(): void;
   /** Record a span (internal use) */
@@ -264,5 +289,5 @@ declare function getTraceDuration(collector: TraceCollector, operationName: stri
  */
 declare function assertTraceDuration(collector: TraceCollector, operationName: string, maxDurationMs: number): void;
 //#endregion
-export { type EventCollector, type EventData, type EventsFunnelStep, type EventsOutcome, type EventsValue, LogCollector, LogEntry, TestSpan, TraceCollector, assertEventTracked, assertNoErrors, assertNoErrorsLogged, assertOutcomeTracked, assertTraceCreated, assertTraceDuration, assertTraceFailed, assertTraceSucceeded, createEventCollector, createMockLogger, createTraceCollector, getTraceDuration, waitForTrace };
+export { type EventCollector, type EventData, type EventsFunnelStep, type EventsOutcome, type EventsValue, LogCollector, LogEntry, type SerializedSpan, SpanMatch, TestSpan, TestSpanCollector, TraceCollector, assertEventTracked, assertNoErrors, assertNoErrorsLogged, assertOutcomeTracked, assertTraceCreated, assertTraceDuration, assertTraceFailed, assertTraceSucceeded, createEventCollector, createMockLogger, createTraceCollector, getTraceDuration, serializeSpan, waitForTrace };
 //# sourceMappingURL=testing.d.ts.map

package/dist/testing.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"testing.d.ts","names":[],"sources":["../src/testing.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AA8G2B;AA6B3B;;;;AAAsD;AAkLtD;;;;;;;;;;UArOiB,QAAA;EACf,IAAA;EACA,MAAA,EAAQ,UAAA;EACR,UAAA,EAAY,UAAU;EACtB,SAAA;EACA,OAAA;EACA,QAAA;AAAA;;AAuOC;AA8DH;UA/RiB,cAAA;;EAEf,QAAA,IAAY,QAAA;EA6R0C;EA3RtD,cAAA,CAAe,IAAA,WAAe,QAAA;EAmTI;EAjTlC,oBAAA,CAAqB,UAAA,EAAY,MAAA,oBAA0B,QAAA;EAkTlC;EAhTzB,KAAA;EAgTA;EA9SA,UAAA,CAAW,IAAA,EAAM,QAAA;AAAA;AA+SI;AAiBvB;;;;;;;;;AAGuB;AA+BvB;;;;;;;;;;;;;;;AAnDuB,iBAlRP,oBAAA,IAAwB,cAAc;;;AA6U/C;AAMP;;;;;;;;;;;AAIe;AAoBf;;;;iBAzLgB,kBAAA,CACd,SAAA,EAAW,cAAA,EACX,aAAA,UACA,OAAA;EACE,QAAA;EACA,QAAA;EACA,MAAA,GAAS,cAAA;EACT,UAAA,GAAa,MAAA;AAAA;AA8SjB;;;;;;;;;;AAIU;AA6BV;;;;;;AAjCA,iBA/OgB,cAAA,CAAe,SAAyB,EAAd,cAAc;;AAkRjC;AA2BvB;;;;;;;;;iBArRgB,oBAAA,CACd,SAAA,EAAW,cAAc,EACzB,aAAA;;;;;;;;;;;;;iBAiBc,iBAAA,CACd,SAAA,EAAW,cAAc,EACzB,aAAA,UACA,YAAA;;;;UA+Be,YAAA;;EAEf,OAAA,IAAW,QAAA;;EAEX,cAAA,CAAe,KAAA,wCAA6C,QAAA;;EAE5D,gBAAA,CAAiB,OAAA,WAAkB,QAAA;;EAEnC,KAAA;AAAA;;;;UAMe,QAAA;EACf,KAAA;EACA,OAAA;EACA,KAAA,GAAQ,MAAA;EACR,KAAA,GAAQ,KAAK;AAAA;;;;;;;;;;;;;;;;;;iBAoBC,gBAAA,IAAoB,MAAA,GAAS,YAAY;;;;;;;;;;;;iBAwFzC,oBAAA,CAAqB,MAAoB,EAAZ,YAAY;;;;;;;;;;;;;;;;;;;;;;;;iBAoCnC,YAAA,CACpB,SAAA,EAAW,cAAA,EACX,aAAA,UACA,SAAA,YACC,OAAO;;;;;;;;;;;;;;iBA6BM,gBAAA,CACd,SAAA,EAAW,cAAc,EACzB,aAAA;;;;;;;;;;;;;;;;;;iBA2Bc,mBAAA,CACd,SAAA,EAAW,cAAc,EACzB,aAAA,UACA,aAAA"}
+{"version":3,"file":"testing.d.ts","names":[],"sources":["../src/testing.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;UAgGiB;EACf;EACA;EACA;EACA,OAAO;EACP;EACA,QAAQ;EACR,YAAY;EACZ,QAAQ;IAAQ;IAAc,aAAa;;EAC3C,OAAO;EACP;EACA;EACA;;UAGe;EACf;EACA;EACA;EACA;EACA,OAAO;EACP,aAAa;;;;;UAME;;EAEf,YAAY;;EAEZ,eAAe,eAAe;;EAE9B,qBAAqB,YAAY,0BAA0B;;EAE3D,kBAAkB,kBAAkB;;EAEpC,gBAAgB;;EAEhB,eAAe,qBAAqB;;EAEpC,WAAW,mBAAmB,YAAY;;EAE1C;;EAEA,WAAW,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA6BH,wBAAwB;;;;;;;;;;;;;;;;;;;;iBAgSxB,mBACd,WAAW,gBACX,uBACA;EACE;EACA;EACA,SAAS;EACT,aAAa;;;;;;;;;;;;;;;;;;;iBA+DD,eAAe,WAAW;;;;;;;;;;;;iBAwB1B,qBACd,WAAW,gBACX;;;;;;;;;;;;;iBAiBc,kBACd,WAAW,gBACX,uBACA;;;;UA+Be;;EAEf,WAAW;;EAEX,eAAe,6CAA6C;;EAE5D,iBAAiB,kBAAkB;;EAEnC;;;;;UAMe;EACf;EACA;EACA,QAAQ;EACR,QAAQ;;;;;;;;;;;;;;;;;;;iBAoBM,oBAAoB,SAAS;;;;;;;;;;;;iBAwF7B,qBAAqB,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;iBAoCvB,aACpB,WAAW,gBACX,uBACA,qBACC;;;;;;;;;;;;;;iBA6Ba,iBACd,WAAW,gBACX;;;;;;;;;;;;;;;;;;iBA2Bc,oBACd,WAAW,gBACX,uBACA"}

package/dist/testing.js

@@ -1,6 +1,8 @@
 import { configure } from "./config.js";
 import { assertEventTracked, assertOutcomeTracked, createEventCollector } from "./event-testing.js";
+import { TestSpanCollector, serializeSpan } from "./test-span-collector.js";
 import { SpanStatusCode, context, trace } from "@opentelemetry/api";
+import * as nodeAsyncHooks from "node:async_hooks";
 
 //#region src/testing.ts
 /**
@@ -53,19 +55,29 @@ import { SpanStatusCode, context, trace } from "@opentelemetry/api";
 */
 function createTraceCollector() {
 	const spans = [];
-	const createMockSpan = (name, startTime) => {
+	const activeMockSpanStorage = new nodeAsyncHooks.AsyncLocalStorage();
+	let nextTraceId = 1;
+	let nextSpanId = 1;
+	const hexId = (value, length) => value.toString(16).padStart(length, "0");
+	const createMockSpan = (name, startTime, parentSpanContext, options) => {
+		const spanContextData = {
+			traceId: parentSpanContext?.traceId ?? hexId(nextTraceId++, 32),
+			spanId: hexId(nextSpanId++, 16),
+			traceFlags: 1,
+			isRemote: false
+		};
 		const spanData = {
+			traceId: spanContextData.traceId,
+			spanId: spanContextData.spanId,
+			parentSpanId: parentSpanContext?.spanId,
+			kind: options?.kind,
 			name,
 			startTime,
 			attributes: {},
+			events: [],
+			links: [],
 			status: { code: SpanStatusCode.OK }
 		};
-		const spanContextData = {
-			traceId: "1234567890abcdef1234567890abcdef",
-			spanId: "1234567890abcdef",
-			traceFlags: 1,
-			isRemote: false
-		};
 		return {
 			spanContext: () => spanContextData,
 			setStatus(status) {
@@ -85,12 +97,19 @@ function createTraceCollector() {
 				return this;
 			},
 			addEvent(name, attributesOrStartTime, startTime) {
+				const attributes = attributesOrStartTime && !Array.isArray(attributesOrStartTime) && typeof attributesOrStartTime === "object" ? attributesOrStartTime : void 0;
+				spanData.events.push({
+					name,
+					attributes
+				});
 				return this;
 			},
 			addLink(link) {
+				spanData.links.push(link);
 				return this;
 			},
 			addLinks(links) {
+				spanData.links.push(...links);
 				return this;
 			},
 			updateName(newName) {
@@ -104,9 +123,15 @@ function createTraceCollector() {
 			end(endTimeArg) {
 				const endTime = performance.now();
 				spans.push({
+					traceId: spanData.traceId,
+					spanId: spanData.spanId,
+					parentSpanId: spanData.parentSpanId,
+					kind: spanData.kind,
 					name: spanData.name,
 					status: spanData.status,
 					attributes: spanData.attributes || {},
+					events: spanData.events || [],
+					links: spanData.links || [],
 					startTime: spanData.startTime,
 					endTime,
 					duration: endTime - spanData.startTime
@@ -117,7 +142,8 @@ function createTraceCollector() {
 	configure({ tracer: {
 		startSpan(name, options, ctx) {
 			const startTime = performance.now();
-			return createMockSpan(name, startTime);
+			const parent = (ctx ? trace.getSpan(ctx)?.spanContext() : void 0) ?? activeMockSpanStorage.getStore()?.spanContext();
+			return createMockSpan(name, startTime, parent, options);
 		},
 		startActiveSpan(name, optionsOrFn, contextOrFn, fn) {
 			const callback = (() => {
@@ -127,9 +153,13 @@ function createTraceCollector() {
 				throw new Error("startActiveSpan requires a callback");
 			})();
 			const startTime = performance.now();
-			const mockSpan = createMockSpan(name, startTime);
-			const ctx = trace.setSpan(context.active(), mockSpan);
-			return context.with(ctx, () => callback(mockSpan));
+			const suppliedContext = typeof optionsOrFn === "function" ? context.active() : typeof contextOrFn === "function" || contextOrFn === void 0 ? context.active() : contextOrFn;
+			const parent = trace.getSpan(suppliedContext)?.spanContext() ?? activeMockSpanStorage.getStore()?.spanContext();
+			const mockSpan = createMockSpan(name, startTime, parent, typeof optionsOrFn === "function" ? void 0 : optionsOrFn);
+			const ctx = trace.setSpan(suppliedContext, mockSpan);
+			return activeMockSpanStorage.run(mockSpan, () => {
+				return context.with(ctx, () => callback(mockSpan));
+			});
 		}
 	} });
 	return {
@@ -144,6 +174,37 @@ function createTraceCollector() {
 				return Object.entries(attributes).every(([key, value]) => span.attributes[key] === value);
 			});
 		},
+		getSpansByTraceId(traceId) {
+			return spans.filter((span) => span.traceId === traceId);
+		},
+		getRootSpans() {
+			return spans.filter((span) => span.parentSpanId === void 0);
+		},
+		getDescendants(rootSpanId) {
+			const included = /* @__PURE__ */ new Set([rootSpanId]);
+			let changed = true;
+			while (changed) {
+				changed = false;
+				for (const span of spans) if (span.parentSpanId && included.has(span.parentSpanId) && !included.has(span.spanId)) {
+					included.add(span.spanId);
+					changed = true;
+				}
+			}
+			included.delete(rootSpanId);
+			return spans.filter((span) => included.has(span.spanId));
+		},
+		expectSpan(criteria) {
+			const matches = typeof criteria === "string" ? spans.filter((span) => span.name === criteria) : spans.filter((span) => {
+				if (criteria.name !== void 0 && span.name !== criteria.name) return false;
+				if (criteria.traceId !== void 0 && span.traceId !== criteria.traceId) return false;
+				if (criteria.spanId !== void 0 && span.spanId !== criteria.spanId) return false;
+				if (criteria.parentSpanId !== void 0 && span.parentSpanId !== criteria.parentSpanId) return false;
+				if (criteria.kind !== void 0 && span.kind !== criteria.kind) return false;
+				return Object.entries(criteria.attributes ?? {}).every(([key, value]) => span.attributes[key] === value);
+			});
+			if (matches.length !== 1) throw new Error(`Expected exactly one span matching ${JSON.stringify(criteria)}, found ${matches.length}`);
+			return matches[0];
+		},
 		clear() {
 			spans.length = 0;
 		},
@@ -407,5 +468,5 @@ function assertTraceDuration(collector, operationName, maxDurationMs) {
 }
 
 //#endregion
-export { assertEventTracked, assertNoErrors, assertNoErrorsLogged, assertOutcomeTracked, assertTraceCreated, assertTraceDuration, assertTraceFailed, assertTraceSucceeded, createEventCollector, createMockLogger, createTraceCollector, getTraceDuration, waitForTrace };
+export { TestSpanCollector, assertEventTracked, assertNoErrors, assertNoErrorsLogged, assertOutcomeTracked, assertTraceCreated, assertTraceDuration, assertTraceFailed, assertTraceSucceeded, createEventCollector, createMockLogger, createTraceCollector, getTraceDuration, serializeSpan, waitForTrace };
 //# sourceMappingURL=testing.js.map