autotel-vitest 0.4.59 → 0.4.60

package/README.md

@@ -95,6 +95,7 @@ The fixture is `auto: true`, so every test gets a parent span automatically.
 - Span attributes: `test.name`, `test.file`, `test.suite`
 - If a test throws, the span is marked as error and records the exception
 - Any `trace()` / `span()` calls in the test flow become children of the active test span
+- An `otel-trace` annotation on every test, holding the trace URL (from `OTEL_TRACE_URL_TEMPLATE`) or the raw trace id, so reporters — including the browser trace view's step list — link back to the trace
 - The test's spans on `task.meta.otelSpans`, which
   [executable-stories](https://github.com/jagreehal/executable-stories) renders
   as a trace waterfall in its report with no extra wiring
@@ -120,6 +121,10 @@ Reporter spans:
 - test span: `test:${name}`
 - suite span: `suite:${name}`
 
+In browser mode, Vitest exposes a recorded Playwright trace to reporters as an
+annotation attachment; the reporter copies its path onto the test span as
+`test.trace.path`, so a failed span leads straight to the replay.
+
 ## Testing Utilities
 
 `autotel-vitest` re-exports helpers from `autotel/testing`:

package/dist/index.cjs

@@ -74,7 +74,7 @@ function ensureCollector() {
 *   // All trace()/span() calls become children of the test span
 * });
 */
-const test = vitest.test.extend({ _otelTestSpan: [async ({ task }, use) => {
+const test = vitest.test.extend({ _otelTestSpan: [async ({ task, annotate }, use) => {
 	ensureCollector();
 	const span = (0, autotel.getTracer)(TRACER_NAME, TRACER_VERSION).startSpan(`test:${task.name}`, { attributes: {
 		"test.name": task.name,
@@ -82,8 +82,13 @@ const test = vitest.test.extend({ _otelTestSpan: [async ({ task }, use) => {
 		"test.suite": task.suite?.name ?? ""
 	} });
 	const ctx = autotel.otelTrace.setSpan(autotel.context.active(), span);
+	const entered = enterContext(ctx);
+	if (annotate) {
+		const traceId = span.spanContext().traceId;
+		await annotate((0, autotel.resolveTraceUrl)(void 0, traceId) ?? traceId, "otel-trace").catch(() => {});
+	}
 	try {
-		await (enterContext(ctx) ? use(span) : autotel.context.with(ctx, () => use(span)));
+		await (entered ? use(span) : autotel.context.with(ctx, () => use(span)));
 	} catch (error) {
 		span.setStatus({ code: autotel.SpanStatusCode.ERROR });
 		span.recordException(error instanceof Error ? error : new Error(String(error)));

package/dist/index.js

@@ -1,5 +1,5 @@
 import { afterAll, afterEach, beforeAll, beforeEach, describe, expect, test as test$1 } from "vitest";
-import { SpanStatusCode, context, enrichWithTraceContext, flush, getAutotelTracerProvider, getTraceContext, getTracer, isTracing, otelTrace, resolveTraceUrl } from "autotel";
+import { SpanStatusCode, context, enrichWithTraceContext, flush, getAutotelTracerProvider, getTraceContext, getTracer, isTracing, otelTrace, resolveTraceUrl, resolveTraceUrl as resolveTraceUrl$1 } from "autotel";
 import { TestSpanCollector } from "autotel/test-span-collector";
 import { SimpleSpanProcessor } from "autotel/processors";
 import { assertNoErrors, assertTraceCreated, assertTraceDuration, assertTraceFailed, assertTraceSucceeded, createMockLogger, createTraceCollector, getTraceDuration, waitForTrace } from "autotel/testing";
@@ -73,7 +73,7 @@ function ensureCollector() {
 *   // All trace()/span() calls become children of the test span
 * });
 */
-const test = test$1.extend({ _otelTestSpan: [async ({ task }, use) => {
+const test = test$1.extend({ _otelTestSpan: [async ({ task, annotate }, use) => {
 	ensureCollector();
 	const span = getTracer(TRACER_NAME, TRACER_VERSION).startSpan(`test:${task.name}`, { attributes: {
 		"test.name": task.name,
@@ -81,8 +81,13 @@ const test = test$1.extend({ _otelTestSpan: [async ({ task }, use) => {
 		"test.suite": task.suite?.name ?? ""
 	} });
 	const ctx = otelTrace.setSpan(context.active(), span);
+	const entered = enterContext(ctx);
+	if (annotate) {
+		const traceId = span.spanContext().traceId;
+		await annotate(resolveTraceUrl$1(void 0, traceId) ?? traceId, "otel-trace").catch(() => {});
+	}
 	try {
-		await (enterContext(ctx) ? use(span) : context.with(ctx, () => use(span)));
+		await (entered ? use(span) : context.with(ctx, () => use(span)));
 	} catch (error) {
 		span.setStatus({ code: SpanStatusCode.ERROR });
 		span.recordException(error instanceof Error ? error : new Error(String(error)));

package/dist/reporter.cjs

@@ -35,6 +35,8 @@ var OtelReporter = class {
 	onTestCaseResult(testCase) {
 		const entry = this.testSpans.get(testCase.id);
 		if (!entry) return;
+		const tracePath = testCase.annotations().find((annotation) => annotation.attachment?.path?.endsWith(".trace.zip"))?.attachment?.path;
+		if (tracePath) entry.span.setAttribute("test.trace.path", tracePath);
 		const result = testCase.result();
 		if (result.state === "failed") {
 			entry.span.setStatus({ code: autotel.SpanStatusCode.ERROR });

package/dist/reporter.js

@@ -31,6 +31,8 @@ var OtelReporter = class {
 	onTestCaseResult(testCase) {
 		const entry = this.testSpans.get(testCase.id);
 		if (!entry) return;
+		const tracePath = testCase.annotations().find((annotation) => annotation.attachment?.path?.endsWith(".trace.zip"))?.attachment?.path;
+		if (tracePath) entry.span.setAttribute("test.trace.path", tracePath);
 		const result = testCase.result();
 		if (result.state === "failed") {
 			entry.span.setStatus({ code: SpanStatusCode.ERROR });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "autotel-vitest",
-  "version": "0.4.59",
+  "version": "0.4.60",
   "description": "Vitest fixture for OpenTelemetry: one span per test so all instrumented code is filterable by test run",
   "license": "Apache-2.0",
   "type": "module",