autotel-playwright 0.4.34 → 0.4.36

package/dist/index.d.cts

@@ -1,22 +1,19 @@
-import * as _playwright_test from '@playwright/test';
-import { APIRequestContext, Page, TestInfo } from '@playwright/test';
-export { expect } from '@playwright/test';
-import { AutotelConfig } from 'autotel';
-export { OtelTraceContext, enrichWithTraceContext, getTraceContext, isTracing, resolveTraceUrl } from 'autotel';
+import { APIRequestContext, Page, TestInfo, expect } from "@playwright/test";
+import { AutotelConfig, OtelTraceContext, enrichWithTraceContext, getTraceContext, isTracing, resolveTraceUrl } from "autotel";
 
+//#region src/index.d.ts
 /** Annotation type for custom span attributes: description should be "key=value" or "key=value1;key2=value2". */
 declare const AUTOTEL_ATTRIBUTE_ANNOTATION = "autotel.attribute";
 type OtelTestSpan = {
-    carrier: Record<string, string>;
-    apiBaseUrls: string[];
-    testInfo: TestInfo;
+  carrier: Record<string, string>;
+  apiBaseUrls: string[];
+  testInfo: TestInfo;
 };
-declare const test: _playwright_test.TestType<_playwright_test.PlaywrightTestArgs & _playwright_test.PlaywrightTestOptions & {
-    page: Page;
-    requestWithTrace: APIRequestContext;
-    _otelTestSpan: OtelTestSpan;
-}, _playwright_test.PlaywrightWorkerArgs & _playwright_test.PlaywrightWorkerOptions>;
-
+declare const test: import("@playwright/test").TestType<import("@playwright/test").PlaywrightTestArgs & import("@playwright/test").PlaywrightTestOptions & {
+  page: Page;
+  requestWithTrace: APIRequestContext;
+  _otelTestSpan: OtelTestSpan;
+}, import("@playwright/test").PlaywrightWorkerArgs & import("@playwright/test").PlaywrightWorkerOptions>;
 /**
  * Runs a named step as a child span of the current test span. Use inside a test to get
  * step-level spans (e.g. "step:login", "step:navigate") under the test span in the same trace.
@@ -41,16 +38,16 @@ declare function createGlobalSetup(initOptions?: AutotelConfig): () => Promise<v
  * Serialized span returned by the test-spans endpoint (matches autotel-tanstack/testing SerializedSpan).
  */
 interface SerializedSpan {
-    name: string;
-    spanId: string;
-    traceId: string;
-    parentSpanId?: string;
-    attributes?: Record<string, unknown>;
-    status: {
-        code: number;
-        message?: string;
-    };
-    durationMs: number;
+  name: string;
+  spanId: string;
+  traceId: string;
+  parentSpanId?: string;
+  attributes?: Record<string, unknown>;
+  status: {
+    code: number;
+    message?: string;
+  };
+  durationMs: number;
 }
 /**
  * Creates a typed client for the test-spans HTTP endpoint.
@@ -74,10 +71,11 @@ interface SerializedSpan {
  * ```
  */
 declare function createTestSpansClient(baseUrl: string, options?: {
-    path?: string;
+  path?: string;
 }): {
-    getSpans(request: APIRequestContext): Promise<SerializedSpan[]>;
-    clearSpans(request: APIRequestContext): Promise<void>;
+  getSpans(request: APIRequestContext): Promise<SerializedSpan[]>;
+  clearSpans(request: APIRequestContext): Promise<void>;
 };
-
-export { AUTOTEL_ATTRIBUTE_ANNOTATION, type SerializedSpan, createGlobalSetup, createTestSpansClient, step, test };
+//#endregion
+export { AUTOTEL_ATTRIBUTE_ANNOTATION, type OtelTraceContext, SerializedSpan, createGlobalSetup, createTestSpansClient, enrichWithTraceContext, expect, getTraceContext, isTracing, resolveTraceUrl, step, test };
+//# sourceMappingURL=index.d.cts.map

package/dist/index.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.cts","names":[],"sources":["../src/index.ts"],"mappings":";;;;;cAqGa,4BAAA;AAAA,KA8DR,YAAA;EACH,OAAA,EAAS,MAAA;EACT,WAAA;EACA,QAAA,EAAU,QAAQ;AAAA;AAAA,cAGP,IAAA,6BAAI,QAAA,4BAAA,kBAAA,8BAAA,qBAAA;QACT,IAAA;oBACY,iBAAA;iBACH,YAAA;AAAA;;;;;AAuGjB;;;;;;;;;;iBAAsB,IAAA,IAAQ,IAAA,UAAc,EAAA,QAAU,OAAA,CAAQ,CAAA,IAAK,OAAA,CAAQ,CAAA;;;;;iBAoB3D,iBAAA,CAAkB,WAAA,GAAc,aAAA,SAAsB,OAAO;;AApBD;AAoB5E;UAciB,cAAA;EACf,IAAA;EACA,MAAA;EACA,OAAA;EACA,YAAA;EACA,UAAA,GAAa,MAAM;EACnB,MAAA;IAAU,IAAA;IAAc,OAAA;EAAA;EACxB,UAAA;AAAA;;;;;;;;;;;;AAAU;AAwBZ;;;;;;;;;iBAAgB,qBAAA,CACd,OAAA,UACA,OAAA;EAAY,IAAA;AAAA;EAEZ,QAAA,CAAS,OAAA,EAAS,iBAAA,GAAoB,OAAA,CAAQ,cAAA;EAC9C,UAAA,CAAW,OAAA,EAAS,iBAAA,GAAoB,OAAA;AAAA"}

package/dist/index.d.ts

@@ -1,22 +1,19 @@
-import * as _playwright_test from '@playwright/test';
-import { APIRequestContext, Page, TestInfo } from '@playwright/test';
-export { expect } from '@playwright/test';
-import { AutotelConfig } from 'autotel';
-export { OtelTraceContext, enrichWithTraceContext, getTraceContext, isTracing, resolveTraceUrl } from 'autotel';
+import { APIRequestContext, Page, TestInfo, expect } from "@playwright/test";
+import { AutotelConfig, OtelTraceContext, enrichWithTraceContext, getTraceContext, isTracing, resolveTraceUrl } from "autotel";
 
+//#region src/index.d.ts
 /** Annotation type for custom span attributes: description should be "key=value" or "key=value1;key2=value2". */
 declare const AUTOTEL_ATTRIBUTE_ANNOTATION = "autotel.attribute";
 type OtelTestSpan = {
-    carrier: Record<string, string>;
-    apiBaseUrls: string[];
-    testInfo: TestInfo;
+  carrier: Record<string, string>;
+  apiBaseUrls: string[];
+  testInfo: TestInfo;
 };
-declare const test: _playwright_test.TestType<_playwright_test.PlaywrightTestArgs & _playwright_test.PlaywrightTestOptions & {
-    page: Page;
-    requestWithTrace: APIRequestContext;
-    _otelTestSpan: OtelTestSpan;
-}, _playwright_test.PlaywrightWorkerArgs & _playwright_test.PlaywrightWorkerOptions>;
-
+declare const test: import("@playwright/test").TestType<import("@playwright/test").PlaywrightTestArgs & import("@playwright/test").PlaywrightTestOptions & {
+  page: Page;
+  requestWithTrace: APIRequestContext;
+  _otelTestSpan: OtelTestSpan;
+}, import("@playwright/test").PlaywrightWorkerArgs & import("@playwright/test").PlaywrightWorkerOptions>;
 /**
  * Runs a named step as a child span of the current test span. Use inside a test to get
  * step-level spans (e.g. "step:login", "step:navigate") under the test span in the same trace.
@@ -41,16 +38,16 @@ declare function createGlobalSetup(initOptions?: AutotelConfig): () => Promise<v
  * Serialized span returned by the test-spans endpoint (matches autotel-tanstack/testing SerializedSpan).
  */
 interface SerializedSpan {
-    name: string;
-    spanId: string;
-    traceId: string;
-    parentSpanId?: string;
-    attributes?: Record<string, unknown>;
-    status: {
-        code: number;
-        message?: string;
-    };
-    durationMs: number;
+  name: string;
+  spanId: string;
+  traceId: string;
+  parentSpanId?: string;
+  attributes?: Record<string, unknown>;
+  status: {
+    code: number;
+    message?: string;
+  };
+  durationMs: number;
 }
 /**
  * Creates a typed client for the test-spans HTTP endpoint.
@@ -74,10 +71,11 @@ interface SerializedSpan {
  * ```
  */
 declare function createTestSpansClient(baseUrl: string, options?: {
-    path?: string;
+  path?: string;
 }): {
-    getSpans(request: APIRequestContext): Promise<SerializedSpan[]>;
-    clearSpans(request: APIRequestContext): Promise<void>;
+  getSpans(request: APIRequestContext): Promise<SerializedSpan[]>;
+  clearSpans(request: APIRequestContext): Promise<void>;
 };
-
-export { AUTOTEL_ATTRIBUTE_ANNOTATION, type SerializedSpan, createGlobalSetup, createTestSpansClient, step, test };
+//#endregion
+export { AUTOTEL_ATTRIBUTE_ANNOTATION, type OtelTraceContext, SerializedSpan, createGlobalSetup, createTestSpansClient, enrichWithTraceContext, expect, getTraceContext, isTracing, resolveTraceUrl, step, test };
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":[],"sources":["../src/index.ts"],"mappings":";;;;;cAqGa,4BAAA;AAAA,KA8DR,YAAA;EACH,OAAA,EAAS,MAAA;EACT,WAAA;EACA,QAAA,EAAU,QAAQ;AAAA;AAAA,cAGP,IAAA,6BAAI,QAAA,4BAAA,kBAAA,8BAAA,qBAAA;QACT,IAAA;oBACY,iBAAA;iBACH,YAAA;AAAA;;;;;AAuGjB;;;;;;;;;;iBAAsB,IAAA,IAAQ,IAAA,UAAc,EAAA,QAAU,OAAA,CAAQ,CAAA,IAAK,OAAA,CAAQ,CAAA;;;;;iBAoB3D,iBAAA,CAAkB,WAAA,GAAc,aAAA,SAAsB,OAAO;;AApBD;AAoB5E;UAciB,cAAA;EACf,IAAA;EACA,MAAA;EACA,OAAA;EACA,YAAA;EACA,UAAA,GAAa,MAAM;EACnB,MAAA;IAAU,IAAA;IAAc,OAAA;EAAA;EACxB,UAAA;AAAA;;;;;;;;;;;;AAAU;AAwBZ;;;;;;;;;iBAAgB,qBAAA,CACd,OAAA,UACA,OAAA;EAAY,IAAA;AAAA;EAEZ,QAAA,CAAS,OAAA,EAAS,iBAAA,GAAoB,OAAA,CAAQ,cAAA;EAC9C,UAAA,CAAW,OAAA,EAAS,iBAAA,GAAoB,OAAA;AAAA"}

package/dist/index.js

@@ -1,214 +1,261 @@
-import { test as test$1 } from '@playwright/test';
-export { expect } from '@playwright/test';
-import { getTracer, otelTrace, context, propagation, SpanStatusCode, getAutotelTracerProvider } from 'autotel';
-export { enrichWithTraceContext, getTraceContext, isTracing, resolveTraceUrl } from 'autotel';
-import { TestSpanCollector } from 'autotel/test-span-collector';
-import { SimpleSpanProcessor } from 'autotel/processors';
-
-// src/index.ts
-var TRACER_NAME = "playwright-tests";
-var TRACER_VERSION = "0.1.0";
-var collector = null;
+import { expect, test as test$1 } from "@playwright/test";
+import { SpanStatusCode, context, enrichWithTraceContext, getAutotelTracerProvider, getTraceContext, getTracer, isTracing, otelTrace, propagation, resolveTraceUrl } from "autotel";
+import { TestSpanCollector } from "autotel/test-span-collector";
+import { SimpleSpanProcessor } from "autotel/processors";
+//#region src/index.ts
+/**
+* autotel-playwright
+*
+* Playwright fixture that creates one OTel span per test and injects W3C trace
+* context into requests to your API so "test → API" appears as one trace.
+*
+* @example
+* // globalSetup.ts: init({ service: 'e2e-tests' });
+* // In spec:
+* import { test, expect } from 'autotel-playwright';
+* test('checks health', async ({ page }) => {
+*   await page.goto(API_BASE_URL + '/health'); // request gets traceparent
+* });
+* // Node-side API calls with trace context:
+* test('api health', async ({ requestWithTrace }) => {
+*   const res = await requestWithTrace.get(API_BASE_URL + '/health');
+*   expect(res.ok()).toBeTruthy();
+* });
+*/
+const TRACER_NAME = "playwright-tests";
+const TRACER_VERSION = "0.1.0";
+let collector = null;
 function ensureCollector() {
-  if (!collector) {
-    collector = new TestSpanCollector();
-    const provider = getAutotelTracerProvider();
-    if ("addSpanProcessor" in provider) {
-      provider.addSpanProcessor(
-        new SimpleSpanProcessor(collector)
-      );
-    }
-  }
-  return collector;
+	if (!collector) {
+		collector = new TestSpanCollector();
+		const provider = getAutotelTracerProvider();
+		if ("addSpanProcessor" in provider) provider.addSpanProcessor(new SimpleSpanProcessor(collector));
+	}
+	return collector;
 }
-var ENV_API_BASE_URL = "API_BASE_URL";
-var ENV_API_ORIGIN = "AUTOTEL_PLAYWRIGHT_API_ORIGIN";
+/** Env keys for API base URL (requests to this origin get trace context injected). */
+const ENV_API_BASE_URL = "API_BASE_URL";
+const ENV_API_ORIGIN = "AUTOTEL_PLAYWRIGHT_API_ORIGIN";
 function getApiBaseUrls() {
-  const a = process.env[ENV_API_BASE_URL];
-  const b = process.env[ENV_API_ORIGIN];
-  const urls = [];
-  if (a) urls.push(a.replace(/\/$/, ""));
-  if (b) urls.push(b.replace(/\/$/, ""));
-  return [...new Set(urls)];
+	const a = process.env[ENV_API_BASE_URL];
+	const b = process.env[ENV_API_ORIGIN];
+	const urls = [];
+	if (a) urls.push(a.replace(/\/$/, ""));
+	if (b) urls.push(b.replace(/\/$/, ""));
+	return [...new Set(urls)];
 }
+/**
+* Returns true if requestUrl should receive trace headers for the given apiBaseUrls.
+* When a base URL includes a path (e.g. http://localhost:3000/api), only requests
+* whose path starts with that path segment match; same-origin but different path
+* (e.g. /health) must not match to avoid leaking trace context to unrelated endpoints.
+*/
 function urlMatchesApiOrigin(requestUrl, apiBaseUrls) {
-  if (apiBaseUrls.length === 0) return false;
-  try {
-    const u = new URL(requestUrl);
-    const requestOrigin = u.origin;
-    const requestPathname = u.pathname;
-    return apiBaseUrls.some((base2) => {
-      try {
-        const b = new URL(base2);
-        if (requestOrigin !== b.origin) return false;
-        const basePathname = b.pathname.replace(/\/$/, "") || "/";
-        if (basePathname === "/") return true;
-        return requestPathname === basePathname || requestPathname.startsWith(basePathname + "/");
-      } catch {
-        return requestUrl.startsWith(base2);
-      }
-    });
-  } catch {
-    return apiBaseUrls.some((base2) => requestUrl.startsWith(base2));
-  }
+	if (apiBaseUrls.length === 0) return false;
+	try {
+		const u = new URL(requestUrl);
+		const requestOrigin = u.origin;
+		const requestPathname = u.pathname;
+		return apiBaseUrls.some((base) => {
+			try {
+				const b = new URL(base);
+				if (requestOrigin !== b.origin) return false;
+				const basePathname = b.pathname.replace(/\/$/, "") || "/";
+				if (basePathname === "/") return true;
+				return requestPathname === basePathname || requestPathname.startsWith(basePathname + "/");
+			} catch {
+				return requestUrl.startsWith(base);
+			}
+		});
+	} catch {
+		return apiBaseUrls.some((base) => requestUrl.startsWith(base));
+	}
 }
-var AUTOTEL_ATTRIBUTE_ANNOTATION = "autotel.attribute";
+/** Annotation type for custom span attributes: description should be "key=value" or "key=value1;key2=value2". */
+const AUTOTEL_ATTRIBUTE_ANNOTATION = "autotel.attribute";
 function setAttributesFromAnnotations(span, testInfo) {
-  for (const a of testInfo.annotations) {
-    if (a.type !== AUTOTEL_ATTRIBUTE_ANNOTATION || !a.description) continue;
-    const entries = a.description.split(";");
-    for (const entry of entries) {
-      const parts = entry.split("=");
-      if (parts.length >= 2) {
-        const key = parts[0].trim();
-        const value = parts.slice(1).join("=").trim();
-        span.setAttribute(key, value);
-      }
-    }
-  }
+	for (const a of testInfo.annotations) {
+		if (a.type !== "autotel.attribute" || !a.description) continue;
+		const entries = a.description.split(";");
+		for (const entry of entries) {
+			const parts = entry.split("=");
+			if (parts.length >= 2) {
+				const key = parts[0].trim();
+				const value = parts.slice(1).join("=").trim();
+				span.setAttribute(key, value);
+			}
+		}
+	}
 }
 function mergeTraceHeaders(url, options, apiBaseUrls, carrier, testName) {
-  const opts = options ?? {};
-  if (!urlMatchesApiOrigin(url, apiBaseUrls)) return opts;
-  return {
-    ...opts,
-    headers: { ...opts.headers, ...carrier, "x-test-name": testName }
-  };
+	const opts = options ?? {};
+	if (!urlMatchesApiOrigin(url, apiBaseUrls)) return opts;
+	return {
+		...opts,
+		headers: {
+			...opts.headers,
+			...carrier,
+			"x-test-name": testName
+		}
+	};
 }
+/** Wraps APIRequestContext so requests to API_BASE_URL get trace context injected. */
 function createRequestWithTrace(request, apiBaseUrls, carrier, testInfo) {
-  const merge = (url, options) => mergeTraceHeaders(url, options, apiBaseUrls, carrier, testInfo.title);
-  return {
-    get: (url, options) => request.get(url, merge(url, options)),
-    post: (url, options) => request.post(url, merge(url, options)),
-    put: (url, options) => request.put(url, merge(url, options)),
-    patch: (url, options) => request.patch(url, merge(url, options)),
-    delete: (url, options) => request.delete(url, merge(url, options)),
-    head: (url, options) => request.head(url, merge(url, options)),
-    fetch: (urlOrRequest, options) => request.fetch(urlOrRequest, merge(typeof urlOrRequest === "string" ? urlOrRequest : urlOrRequest.url(), options)),
-    storageState: (options) => request.storageState(options),
-    dispose: () => request.dispose()
-  };
+	const merge = (url, options) => mergeTraceHeaders(url, options, apiBaseUrls, carrier, testInfo.title);
+	return {
+		get: (url, options) => request.get(url, merge(url, options)),
+		post: (url, options) => request.post(url, merge(url, options)),
+		put: (url, options) => request.put(url, merge(url, options)),
+		patch: (url, options) => request.patch(url, merge(url, options)),
+		delete: (url, options) => request.delete(url, merge(url, options)),
+		head: (url, options) => request.head(url, merge(url, options)),
+		fetch: (urlOrRequest, options) => request.fetch(urlOrRequest, merge(typeof urlOrRequest === "string" ? urlOrRequest : urlOrRequest.url(), options)),
+		storageState: (options) => request.storageState(options),
+		dispose: () => request.dispose()
+	};
 }
-var test = test$1.extend({
-  _otelTestSpan: [
-    // eslint-disable-next-line no-empty-pattern
-    async ({}, use, testInfo) => {
-      ensureCollector();
-      const apiBaseUrls = getApiBaseUrls();
-      const tracer = getTracer(TRACER_NAME, TRACER_VERSION);
-      const spanName = `e2e:${testInfo.title}`;
-      const span = tracer.startSpan(spanName, {
-        attributes: {
-          "test.title": testInfo.title,
-          "test.project": testInfo.project.name,
-          "test.file": testInfo.file ?? "",
-          "test.line": testInfo.line ?? 0
-        }
-      });
-      setAttributesFromAnnotations(span, testInfo);
-      const ctx = otelTrace.setSpan(context.active(), span);
-      const carrier = {};
-      context.with(ctx, () => {
-        propagation.inject(context.active(), carrier);
-      });
-      try {
-        await context.with(ctx, () => use({ carrier, apiBaseUrls, testInfo }));
-      } catch (error) {
-        span.setStatus({ code: SpanStatusCode.ERROR, message: error instanceof Error ? error.message : "Unknown error" });
-        span.recordException(error instanceof Error ? error : new Error(String(error)));
-        throw error;
-      } finally {
-        span.end();
-        const traceId = span.spanContext().traceId;
-        const rootSpanId = span.spanContext().spanId;
-        const spans = collector.drainTrace(traceId, rootSpanId);
-        if (spans.length > 0) {
-          testInfo.annotations.push({
-            type: "otel-spans",
-            description: JSON.stringify(spans)
-          });
-        }
-      }
-    },
-    { scope: "test" }
-  ],
-  page: async ({ page, _otelTestSpan }, use) => {
-    const { carrier, apiBaseUrls, testInfo } = _otelTestSpan;
-    if (apiBaseUrls.length > 0) {
-      await page.route("**/*", async (route) => {
-        const request = route.request();
-        const url = request.url();
-        if (urlMatchesApiOrigin(url, apiBaseUrls)) {
-          const headers = {
-            ...request.headers(),
-            ...carrier,
-            "x-test-name": testInfo.title
-          };
-          await route.continue({ headers });
-        } else {
-          await route.continue();
-        }
-      });
-    }
-    await use(page);
-  },
-  requestWithTrace: async ({ request, _otelTestSpan }, use) => {
-    const wrapped = createRequestWithTrace(
-      request,
-      _otelTestSpan.apiBaseUrls,
-      _otelTestSpan.carrier,
-      _otelTestSpan.testInfo
-    );
-    await use(wrapped);
-  }
+const test = test$1.extend({
+	_otelTestSpan: [async ({}, use, testInfo) => {
+		ensureCollector();
+		const apiBaseUrls = getApiBaseUrls();
+		const tracer = getTracer(TRACER_NAME, TRACER_VERSION);
+		const spanName = `e2e:${testInfo.title}`;
+		const span = tracer.startSpan(spanName, { attributes: {
+			"test.title": testInfo.title,
+			"test.project": testInfo.project.name,
+			"test.file": testInfo.file ?? "",
+			"test.line": testInfo.line ?? 0
+		} });
+		setAttributesFromAnnotations(span, testInfo);
+		const ctx = otelTrace.setSpan(context.active(), span);
+		const carrier = {};
+		context.with(ctx, () => {
+			propagation.inject(context.active(), carrier);
+		});
+		try {
+			await context.with(ctx, () => use({
+				carrier,
+				apiBaseUrls,
+				testInfo
+			}));
+		} catch (error) {
+			span.setStatus({
+				code: SpanStatusCode.ERROR,
+				message: error instanceof Error ? error.message : "Unknown error"
+			});
+			span.recordException(error instanceof Error ? error : new Error(String(error)));
+			throw error;
+		} finally {
+			span.end();
+			const traceId = span.spanContext().traceId;
+			const rootSpanId = span.spanContext().spanId;
+			const spans = collector.drainTrace(traceId, rootSpanId);
+			if (spans.length > 0) testInfo.annotations.push({
+				type: "otel-spans",
+				description: JSON.stringify(spans)
+			});
+		}
+	}, { scope: "test" }],
+	page: async ({ page, _otelTestSpan }, use) => {
+		const { carrier, apiBaseUrls, testInfo } = _otelTestSpan;
+		if (apiBaseUrls.length > 0) await page.route("**/*", async (route) => {
+			const request = route.request();
+			if (urlMatchesApiOrigin(request.url(), apiBaseUrls)) {
+				const headers = {
+					...request.headers(),
+					...carrier,
+					"x-test-name": testInfo.title
+				};
+				await route.continue({ headers });
+			} else await route.continue();
+		});
+		await use(page);
+	},
+	requestWithTrace: async ({ request, _otelTestSpan }, use) => {
+		await use(createRequestWithTrace(request, _otelTestSpan.apiBaseUrls, _otelTestSpan.carrier, _otelTestSpan.testInfo));
+	}
 });
+/**
+* Runs a named step as a child span of the current test span. Use inside a test to get
+* step-level spans (e.g. "step:login", "step:navigate") under the test span in the same trace.
+*
+* @example
+* test('user flow', async ({ page }) => {
+*   await step('login', async () => {
+*     await page.click('button[type=submit]');
+*   });
+*   await step('open profile', async () => {
+*     await page.goto('/profile');
+*   });
+* });
+*/
 async function step(name, fn) {
-  const tracer = getTracer(TRACER_NAME, TRACER_VERSION);
-  const span = tracer.startSpan(`step:${name}`, {
-    attributes: { "step.name": name }
-  });
-  try {
-    return await context.with(otelTrace.setSpan(context.active(), span), fn);
-  } catch (error) {
-    span.setStatus({ code: SpanStatusCode.ERROR, message: error instanceof Error ? error.message : "Unknown error" });
-    span.recordException(error instanceof Error ? error : new Error(String(error)));
-    throw error;
-  } finally {
-    span.end();
-  }
+	const span = getTracer(TRACER_NAME, TRACER_VERSION).startSpan(`step:${name}`, { attributes: { "step.name": name } });
+	try {
+		return await context.with(otelTrace.setSpan(context.active(), span), fn);
+	} catch (error) {
+		span.setStatus({
+			code: SpanStatusCode.ERROR,
+			message: error instanceof Error ? error.message : "Unknown error"
+		});
+		span.recordException(error instanceof Error ? error : new Error(String(error)));
+		throw error;
+	} finally {
+		span.end();
+	}
 }
+/**
+* Returns a function suitable for Playwright globalSetup that inits autotel.
+* Call autotel.init() with the given options (or defaults) so test spans are exported.
+*/
 function createGlobalSetup(initOptions) {
-  return async () => {
-    const { init } = await import('autotel');
-    init({
-      service: "e2e-tests",
-      debug: true,
-      ...initOptions
-    });
-  };
+	return async () => {
+		const { init } = await import("autotel");
+		init({
+			service: "e2e-tests",
+			debug: true,
+			...initOptions
+		});
+	};
 }
+/**
+* Creates a typed client for the test-spans HTTP endpoint.
+*
+* Pairs with `createTestSpansHandlers()` from `autotel-tanstack/testing`.
+*
+* @param baseUrl - Base URL of the app under test (e.g. 'http://localhost:3100')
+* @param options.path - Path of the test-spans endpoint (default: '/api/test-spans')
+*
+* @example
+* ```typescript
+* const spansClient = createTestSpansClient('http://localhost:3100');
+*
+* test('server function is traced', async ({ request }) => {
+*   await spansClient.clearSpans(request);
+*   await page.goto('/');
+*   // ... trigger action ...
+*   const spans = await spansClient.getSpans(request);
+*   expect(spans.find(s => s.name === 'sendMoney.handler')).toBeDefined();
+* });
+* ```
+*/
 function createTestSpansClient(baseUrl, options) {
-  const base2 = baseUrl.replace(/\/$/, "");
-  const path = options?.path ?? "/api/test-spans";
-  const url = `${base2}${path}`;
-  return {
-    async getSpans(request) {
-      const res = await request.get(url);
-      if (!res.ok()) {
-        throw new Error(`GET ${path} failed: ${res.status()}`);
-      }
-      const body = await res.json();
-      return body.spans;
-    },
-    async clearSpans(request) {
-      const res = await request.delete(url);
-      if (!res.ok()) {
-        throw new Error(`DELETE ${path} failed: ${res.status()}`);
-      }
-    }
-  };
+	const base = baseUrl.replace(/\/$/, "");
+	const path = options?.path ?? "/api/test-spans";
+	const url = `${base}${path}`;
+	return {
+		async getSpans(request) {
+			const res = await request.get(url);
+			if (!res.ok()) throw new Error(`GET ${path} failed: ${res.status()}`);
+			return (await res.json()).spans;
+		},
+		async clearSpans(request) {
+			const res = await request.delete(url);
+			if (!res.ok()) throw new Error(`DELETE ${path} failed: ${res.status()}`);
+		}
+	};
 }
+//#endregion
+export { AUTOTEL_ATTRIBUTE_ANNOTATION, createGlobalSetup, createTestSpansClient, enrichWithTraceContext, expect, getTraceContext, isTracing, resolveTraceUrl, step, test };
 
-export { AUTOTEL_ATTRIBUTE_ANNOTATION, createGlobalSetup, createTestSpansClient, step, test };
-//# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map