autotel-tanstack 1.13.30 → 1.13.32

package/dist/testing.js

@@ -1,169 +1,234 @@
-import './chunk-EGRHWZRV.js';
-import { InMemorySpanExporter } from 'autotel/exporters';
-import { SimpleSpanProcessor } from 'autotel/processors';
-import { init } from 'autotel';
+import { init } from "autotel";
+import { InMemorySpanExporter } from "autotel/exporters";
+import { SimpleSpanProcessor } from "autotel/processors";
 
+//#region src/testing.ts
+/**
+* Create a test harness for TanStack instrumentation testing
+*
+* This sets up autotel with an in-memory exporter for testing.
+* Call this in your test setup to capture and assert on spans.
+*
+* @returns Test harness with assertion helpers
+*
+* @example
+* ```typescript
+* import { describe, it, beforeEach } from 'vitest';
+* import { createTestHarness } from 'autotel-tanstack/testing';
+*
+* describe('MyServerFunction', () => {
+*   let harness: ReturnType<typeof createTestHarness>;
+*
+*   beforeEach(() => {
+*     harness = createTestHarness();
+*   });
+*
+*   afterEach(() => {
+*     harness.reset();
+*   });
+*
+*   it('should trace the server function', async () => {
+*     await myServerFunction({ id: '123' });
+*
+*     harness.assertServerFnTraced('myServerFunction');
+*     harness.assertSpanHasAttribute(
+*       /tanstack\.serverFn/,
+*       'tanstack.server_function.name',
+*       'myServerFunction'
+*     );
+*   });
+* });
+* ```
+*/
 function createTestHarness() {
-  const exporter = new InMemorySpanExporter();
-  init({
-    service: "test",
-    spanProcessors: [new SimpleSpanProcessor(exporter)]
-  });
-  function getSpans() {
-    return exporter.getFinishedSpans();
-  }
-  function getSpansByName(name) {
-    const spans = getSpans();
-    if (typeof name === "string") {
-      return spans.filter((s) => s.name === name);
-    }
-    return spans.filter((s) => name.test(s.name));
-  }
-  function getSpansByType(type) {
-    return getSpans().filter((s) => s.attributes["tanstack.type"] === type);
-  }
-  function reset() {
-    exporter.reset();
-  }
-  function assertSpanExists(name) {
-    const spans = getSpansByName(name);
-    if (spans.length === 0) {
-      const allSpanNames = getSpans().map((s) => s.name);
-      throw new Error(
-        `Expected span "${name}" to exist. Found spans: ${JSON.stringify(allSpanNames)}`
-      );
-    }
-  }
-  function assertSpanHasAttribute(name, attr, value) {
-    const spans = getSpansByName(name);
-    if (spans.length === 0) {
-      throw new Error(`Span "${name}" not found`);
-    }
-    const span = spans[0];
-    const attrValue = span.attributes[attr];
-    if (attrValue === void 0) {
-      throw new Error(
-        `Attribute "${attr}" not found on span "${span.name}". Available attributes: ${JSON.stringify(Object.keys(span.attributes))}`
-      );
-    }
-    if (value !== void 0 && attrValue !== value) {
-      throw new Error(
-        `Expected attribute "${attr}" to be "${value}", got "${attrValue}"`
-      );
-    }
-  }
-  function assertServerFnTraced(name) {
-    assertSpanExists(`tanstack.serverFn.${name}`);
-  }
-  function assertLoaderTraced(routeId) {
-    assertSpanExists(`tanstack.loader.${routeId}`);
-  }
-  function assertBeforeLoadTraced(routeId) {
-    assertSpanExists(`tanstack.beforeLoad.${routeId}`);
-  }
-  function assertRequestTraced(method, path) {
-    assertSpanExists(`${method} ${path}`);
-  }
-  return {
-    exporter,
-    getSpans,
-    getSpansByName,
-    getSpansByType,
-    reset,
-    assertSpanExists,
-    assertSpanHasAttribute,
-    assertServerFnTraced,
-    assertLoaderTraced,
-    assertBeforeLoadTraced,
-    assertRequestTraced
-  };
+	const exporter = new InMemorySpanExporter();
+	init({
+		service: "test",
+		spanProcessors: [new SimpleSpanProcessor(exporter)]
+	});
+	function getSpans() {
+		return exporter.getFinishedSpans();
+	}
+	function getSpansByName(name) {
+		const spans = getSpans();
+		if (typeof name === "string") return spans.filter((s) => s.name === name);
+		return spans.filter((s) => name.test(s.name));
+	}
+	function getSpansByType(type) {
+		return getSpans().filter((s) => s.attributes["tanstack.type"] === type);
+	}
+	function reset() {
+		exporter.reset();
+	}
+	function assertSpanExists(name) {
+		if (getSpansByName(name).length === 0) {
+			const allSpanNames = getSpans().map((s) => s.name);
+			throw new Error(`Expected span "${name}" to exist. Found spans: ${JSON.stringify(allSpanNames)}`);
+		}
+	}
+	function assertSpanHasAttribute(name, attr, value) {
+		const spans = getSpansByName(name);
+		if (spans.length === 0) throw new Error(`Span "${name}" not found`);
+		const span = spans[0];
+		const attrValue = span.attributes[attr];
+		if (attrValue === void 0) throw new Error(`Attribute "${attr}" not found on span "${span.name}". Available attributes: ${JSON.stringify(Object.keys(span.attributes))}`);
+		if (value !== void 0 && attrValue !== value) throw new Error(`Expected attribute "${attr}" to be "${value}", got "${attrValue}"`);
+	}
+	function assertServerFnTraced(name) {
+		assertSpanExists(`tanstack.serverFn.${name}`);
+	}
+	function assertLoaderTraced(routeId) {
+		assertSpanExists(`tanstack.loader.${routeId}`);
+	}
+	function assertBeforeLoadTraced(routeId) {
+		assertSpanExists(`tanstack.beforeLoad.${routeId}`);
+	}
+	function assertRequestTraced(method, path) {
+		assertSpanExists(`${method} ${path}`);
+	}
+	return {
+		exporter,
+		getSpans,
+		getSpansByName,
+		getSpansByType,
+		reset,
+		assertSpanExists,
+		assertSpanHasAttribute,
+		assertServerFnTraced,
+		assertLoaderTraced,
+		assertBeforeLoadTraced,
+		assertRequestTraced
+	};
 }
+/**
+* Mock request factory for testing
+*
+* Creates mock Request objects for testing middleware and handlers.
+*
+* @example
+* ```typescript
+* const request = createMockRequest('GET', '/api/users', {
+*   headers: { 'x-request-id': 'test-123' },
+* });
+* ```
+*/
 function createMockRequest(method, path, options = {}) {
-  const headers = new Headers(options.headers);
-  if (options.traceparent) {
-    headers.set("traceparent", options.traceparent);
-  }
-  return new Request(`http://localhost${path}`, {
-    method,
-    headers,
-    body: options.body
-  });
+	const headers = new Headers(options.headers);
+	if (options.traceparent) headers.set("traceparent", options.traceparent);
+	return new Request(`http://localhost${path}`, {
+		method,
+		headers,
+		body: options.body
+	});
 }
+/**
+* Generate a valid W3C traceparent header for testing
+*
+* @param traceId - Optional 32-char hex trace ID
+* @param spanId - Optional 16-char hex span ID
+* @returns Valid traceparent header string
+*
+* @example
+* ```typescript
+* const traceparent = generateTraceparent();
+* const request = createMockRequest('GET', '/api/users', { traceparent });
+* ```
+*/
 function generateTraceparent(traceId, spanId) {
-  const version = "00";
-  const trace = traceId || generateHex(32);
-  const span = spanId || generateHex(16);
-  const flags = "01";
-  return `${version}-${trace}-${span}-${flags}`;
+	return `00-${traceId || generateHex(32)}-${spanId || generateHex(16)}-01`;
 }
 function generateHex(length) {
-  const chars = "0123456789abcdef";
-  let result = "";
-  for (let i = 0; i < length; i++) {
-    result += chars[Math.floor(Math.random() * 16)];
-  }
-  return result;
+	const chars = "0123456789abcdef";
+	let result = "";
+	for (let i = 0; i < length; i++) result += chars[Math.floor(Math.random() * 16)];
+	return result;
 }
 function getExporter() {
-  return globalThis.__testSpanExporter;
+	return globalThis.__testSpanExporter;
 }
 function e2eGuard() {
-  if (process.env.E2E !== "1") {
-    return Response.json(
-      { error: "test-spans endpoint only available in E2E mode" },
-      { status: 404 }
-    );
-  }
-  return null;
+	if (process.env.E2E !== "1") return Response.json({ error: "test-spans endpoint only available in E2E mode" }, { status: 404 });
+	return null;
 }
 function exporterGuard() {
-  if (!getExporter()) {
-    return Response.json(
-      { error: "in-memory span exporter not initialized" },
-      { status: 500 }
-    );
-  }
-  return null;
+	if (!getExporter()) return Response.json({ error: "in-memory span exporter not initialized" }, { status: 500 });
+	return null;
 }
+/**
+* Creates GET and DELETE handlers for a test-spans HTTP endpoint.
+*
+* Use in a TanStack Start route to expose in-memory spans for Playwright assertions.
+* Only works when E2E=1 (set in webServer command).
+*
+* Handlers accept either a raw `Request` or a TanStack Router context
+* object `{ request: Request }`, so they work with both Router < 1.168
+* and Router >= 1.168.
+*
+* @example
+* ```typescript
+* // src/routes/api/test-spans.ts
+* import { createFileRoute } from "@tanstack/react-router";
+* import { createTestSpansHandlers } from 'autotel-tanstack/testing';
+* const { GET, DELETE } = createTestSpansHandlers();
+* export const Route = createFileRoute('/api/test-spans')({
+*   server: { handlers: { GET, DELETE } },
+* });
+* ```
+*/
+/**
+* Creates a pre-built TanStack Start route for the test-spans endpoint.
+*
+* Reduces E2E boilerplate to three lines. The handlers accept both
+* `Request` and `{ request: Request }` so they work with any Router version.
+*
+* @param createFileRoute - Pass `createFileRoute` from `@tanstack/react-router`
+* @param path - Route path (default: `/api/test-spans`)
+*
+* @example
+* ```typescript
+* // src/routes/api/test-spans.ts
+* import { createFileRoute } from "@tanstack/react-router";
+* import { createTestSpansRoute } from "autotel-tanstack/testing";
+*
+* export const Route = createTestSpansRoute(createFileRoute);
+* ```
+*/
 function createTestSpansRoute(createFileRoute, path = "/api/test-spans") {
-  const { GET, DELETE } = createTestSpansHandlers();
-  return createFileRoute(path)({
-    server: {
-      handlers: { GET, DELETE }
-    }
-  });
+	const { GET, DELETE } = createTestSpansHandlers();
+	return createFileRoute(path)({ server: { handlers: {
+		GET,
+		DELETE
+	} } });
 }
 function createTestSpansHandlers() {
-  return {
-    GET(_input) {
-      const guard = e2eGuard() ?? exporterGuard();
-      if (guard) return guard;
-      const spans = getExporter().getFinishedSpans().map((span) => {
-        const { spanId, traceId } = span.spanContext();
-        const serialized = {
-          name: span.name,
-          spanId,
-          traceId,
-          attributes: span.attributes,
-          status: span.status,
-          durationMs: span.duration[0] * 1e3 + span.duration[1] / 1e6
-        };
-        if (span.parentSpanContext?.spanId) {
-          serialized.parentSpanId = span.parentSpanContext.spanId;
-        }
-        return serialized;
-      });
-      return Response.json({ spans });
-    },
-    DELETE(_input) {
-      const guard = e2eGuard() ?? exporterGuard();
-      if (guard) return guard;
-      getExporter().reset();
-      return Response.json({ ok: true });
-    }
-  };
+	return {
+		GET(_input) {
+			const guard = e2eGuard() ?? exporterGuard();
+			if (guard) return guard;
+			const spans = getExporter().getFinishedSpans().map((span) => {
+				const { spanId, traceId } = span.spanContext();
+				const serialized = {
+					name: span.name,
+					spanId,
+					traceId,
+					attributes: span.attributes,
+					status: span.status,
+					durationMs: span.duration[0] * 1e3 + span.duration[1] / 1e6
+				};
+				if (span.parentSpanContext?.spanId) serialized.parentSpanId = span.parentSpanContext.spanId;
+				return serialized;
+			});
+			return Response.json({ spans });
+		},
+		DELETE(_input) {
+			const guard = e2eGuard() ?? exporterGuard();
+			if (guard) return guard;
+			getExporter().reset();
+			return Response.json({ ok: true });
+		}
+	};
 }
 
+//#endregion
 export { createMockRequest, createTestHarness, createTestSpansHandlers, createTestSpansRoute, generateTraceparent };
-//# sourceMappingURL=testing.js.map
 //# sourceMappingURL=testing.js.map

package/dist/testing.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/testing.ts"],"names":[],"mappings":"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","file":"testing.js","sourcesContent":["import { type ReadableSpan } from '@opentelemetry/sdk-trace-base';\nimport { InMemorySpanExporter } from 'autotel/exporters';\nimport { SimpleSpanProcessor } from 'autotel/processors';\nimport { init } from 'autotel';\n\n/**\n * Test harness for TanStack instrumentation testing\n *\n * Provides utilities for testing TanStack Start applications\n * with autotel-tanstack instrumentation.\n */\nexport interface TestHarness {\n  /**\n   * The in-memory span exporter\n   */\n  exporter: {\n    getFinishedSpans(): ReadableSpan[];\n    reset(): void;\n  };\n\n  /**\n   * Get all finished spans\n   */\n  getSpans(): ReadableSpan[];\n\n  /**\n   * Get spans by name (exact match or regex)\n   */\n  getSpansByName(name: string | RegExp): ReadableSpan[];\n\n  /**\n   * Get spans by TanStack type\n   */\n  getSpansByType(\n    type: 'request' | 'serverFn' | 'loader' | 'beforeLoad',\n  ): ReadableSpan[];\n\n  /**\n   * Reset collected spans\n   */\n  reset(): void;\n\n  /**\n   * Assert a span exists\n   */\n  assertSpanExists(name: string | RegExp): void;\n\n  /**\n   * Assert a span has a specific attribute\n   */\n  assertSpanHasAttribute(\n    name: string | RegExp,\n    attr: string,\n    value?: unknown,\n  ): void;\n\n  /**\n   * Assert a server function was traced\n   */\n  assertServerFnTraced(name: string): void;\n\n  /**\n   * Assert a loader was traced\n   */\n  assertLoaderTraced(routeId: string): void;\n\n  /**\n   * Assert a beforeLoad was traced\n   */\n  assertBeforeLoadTraced(routeId: string): void;\n\n  /**\n   * Assert an HTTP request was traced\n   */\n  assertRequestTraced(method: string, path: string): void;\n}\n\n/**\n * Create a test harness for TanStack instrumentation testing\n *\n * This sets up autotel with an in-memory exporter for testing.\n * Call this in your test setup to capture and assert on spans.\n *\n * @returns Test harness with assertion helpers\n *\n * @example\n * ```typescript\n * import { describe, it, beforeEach } from 'vitest';\n * import { createTestHarness } from 'autotel-tanstack/testing';\n *\n * describe('MyServerFunction', () => {\n *   let harness: ReturnType<typeof createTestHarness>;\n *\n *   beforeEach(() => {\n *     harness = createTestHarness();\n *   });\n *\n *   afterEach(() => {\n *     harness.reset();\n *   });\n *\n *   it('should trace the server function', async () => {\n *     await myServerFunction({ id: '123' });\n *\n *     harness.assertServerFnTraced('myServerFunction');\n *     harness.assertSpanHasAttribute(\n *       /tanstack\\.serverFn/,\n *       'tanstack.server_function.name',\n *       'myServerFunction'\n *     );\n *   });\n * });\n * ```\n */\nexport function createTestHarness(): TestHarness {\n  const exporter = new InMemorySpanExporter();\n\n  init({\n    service: 'test',\n    spanProcessors: [new SimpleSpanProcessor(exporter)],\n  });\n\n  function getSpans(): ReadableSpan[] {\n    return exporter.getFinishedSpans() as ReadableSpan[];\n  }\n\n  function getSpansByName(name: string | RegExp): ReadableSpan[] {\n    const spans = getSpans();\n    if (typeof name === 'string') {\n      return spans.filter((s) => s.name === name);\n    }\n    return spans.filter((s) => name.test(s.name));\n  }\n\n  function getSpansByType(\n    type: 'request' | 'serverFn' | 'loader' | 'beforeLoad',\n  ): ReadableSpan[] {\n    return getSpans().filter((s) => s.attributes['tanstack.type'] === type);\n  }\n\n  function reset(): void {\n    exporter.reset();\n  }\n\n  function assertSpanExists(name: string | RegExp): void {\n    const spans = getSpansByName(name);\n    if (spans.length === 0) {\n      const allSpanNames = getSpans().map((s) => s.name);\n      throw new Error(\n        `Expected span \"${name}\" to exist. Found spans: ${JSON.stringify(allSpanNames)}`,\n      );\n    }\n  }\n\n  function assertSpanHasAttribute(\n    name: string | RegExp,\n    attr: string,\n    value?: unknown,\n  ): void {\n    const spans = getSpansByName(name);\n    if (spans.length === 0) {\n      throw new Error(`Span \"${name}\" not found`);\n    }\n\n    const span = spans[0];\n    const attrValue = span.attributes[attr];\n\n    if (attrValue === undefined) {\n      throw new Error(\n        `Attribute \"${attr}\" not found on span \"${span.name}\". ` +\n          `Available attributes: ${JSON.stringify(Object.keys(span.attributes))}`,\n      );\n    }\n\n    if (value !== undefined && attrValue !== value) {\n      throw new Error(\n        `Expected attribute \"${attr}\" to be \"${value}\", got \"${attrValue}\"`,\n      );\n    }\n  }\n\n  function assertServerFnTraced(name: string): void {\n    assertSpanExists(`tanstack.serverFn.${name}`);\n  }\n\n  function assertLoaderTraced(routeId: string): void {\n    assertSpanExists(`tanstack.loader.${routeId}`);\n  }\n\n  function assertBeforeLoadTraced(routeId: string): void {\n    assertSpanExists(`tanstack.beforeLoad.${routeId}`);\n  }\n\n  function assertRequestTraced(method: string, path: string): void {\n    assertSpanExists(`${method} ${path}`);\n  }\n\n  return {\n    exporter,\n    getSpans,\n    getSpansByName,\n    getSpansByType,\n    reset,\n    assertSpanExists,\n    assertSpanHasAttribute,\n    assertServerFnTraced,\n    assertLoaderTraced,\n    assertBeforeLoadTraced,\n    assertRequestTraced,\n  };\n}\n\n/**\n * Mock request factory for testing\n *\n * Creates mock Request objects for testing middleware and handlers.\n *\n * @example\n * ```typescript\n * const request = createMockRequest('GET', '/api/users', {\n *   headers: { 'x-request-id': 'test-123' },\n * });\n * ```\n */\nexport function createMockRequest(\n  method: string,\n  path: string,\n  options: {\n    headers?: Record<string, string>;\n    body?: string;\n    traceparent?: string;\n  } = {},\n): Request {\n  const headers = new Headers(options.headers);\n\n  if (options.traceparent) {\n    headers.set('traceparent', options.traceparent);\n  }\n\n  return new Request(`http://localhost${path}`, {\n    method,\n    headers,\n    body: options.body,\n  });\n}\n\n/**\n * Generate a valid W3C traceparent header for testing\n *\n * @param traceId - Optional 32-char hex trace ID\n * @param spanId - Optional 16-char hex span ID\n * @returns Valid traceparent header string\n *\n * @example\n * ```typescript\n * const traceparent = generateTraceparent();\n * const request = createMockRequest('GET', '/api/users', { traceparent });\n * ```\n */\nexport function generateTraceparent(traceId?: string, spanId?: string): string {\n  const version = '00';\n  const trace = traceId || generateHex(32);\n  const span = spanId || generateHex(16);\n  const flags = '01'; // Sampled\n\n  return `${version}-${trace}-${span}-${flags}`;\n}\n\nfunction generateHex(length: number): string {\n  const chars = '0123456789abcdef';\n  let result = '';\n  for (let i = 0; i < length; i++) {\n    result += chars[Math.floor(Math.random() * 16)];\n  }\n  return result;\n}\n\n/**\n * Serialized span shape returned by the test-spans HTTP endpoint.\n * Mirrors the fields the Playwright side needs for assertions.\n *\n * Defined as a `type` (not `interface`) so it is assignable to\n * `Record<string, unknown>` in TypeScript 6+ strict mode.\n */\nexport type SerializedSpan = {\n  name: string;\n  spanId: string;\n  traceId: string;\n  parentSpanId?: string;\n  attributes?: Record<string, unknown>;\n  status: { code: number; message?: string };\n  durationMs: number;\n};\n\ninterface TestSpanExporter {\n  getFinishedSpans(): Array<{\n    name: string;\n    spanContext(): { spanId: string; traceId: string };\n    parentSpanContext?: { spanId: string };\n    attributes: Record<string, unknown>;\n    status: { code: number; message?: string };\n    duration: [number, number];\n  }>;\n  reset(): void;\n}\n\nfunction getExporter(): TestSpanExporter | undefined {\n  return (globalThis as Record<string, unknown>).__testSpanExporter as\n    | TestSpanExporter\n    | undefined;\n}\n\nfunction e2eGuard(): Response | null {\n  if (process.env.E2E !== '1') {\n    return Response.json(\n      { error: 'test-spans endpoint only available in E2E mode' },\n      { status: 404 },\n    );\n  }\n  return null;\n}\n\nfunction exporterGuard(): Response | null {\n  if (!getExporter()) {\n    return Response.json(\n      { error: 'in-memory span exporter not initialized' },\n      { status: 500 },\n    );\n  }\n  return null;\n}\n\n/**\n * Accepts either a raw `Request` (legacy) or a TanStack Router context\n * object containing `{ request: Request }` (Router 1.168+).\n */\ntype HandlerInput = Request | { request: Request };\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\ntype CreateFileRoute = (path: string) => (options: any) => any;\n\n/**\n * Creates GET and DELETE handlers for a test-spans HTTP endpoint.\n *\n * Use in a TanStack Start route to expose in-memory spans for Playwright assertions.\n * Only works when E2E=1 (set in webServer command).\n *\n * Handlers accept either a raw `Request` or a TanStack Router context\n * object `{ request: Request }`, so they work with both Router < 1.168\n * and Router >= 1.168.\n *\n * @example\n * ```typescript\n * // src/routes/api/test-spans.ts\n * import { createFileRoute } from \"@tanstack/react-router\";\n * import { createTestSpansHandlers } from 'autotel-tanstack/testing';\n * const { GET, DELETE } = createTestSpansHandlers();\n * export const Route = createFileRoute('/api/test-spans')({\n *   server: { handlers: { GET, DELETE } },\n * });\n * ```\n */\n/**\n * Creates a pre-built TanStack Start route for the test-spans endpoint.\n *\n * Reduces E2E boilerplate to three lines. The handlers accept both\n * `Request` and `{ request: Request }` so they work with any Router version.\n *\n * @param createFileRoute - Pass `createFileRoute` from `@tanstack/react-router`\n * @param path - Route path (default: `/api/test-spans`)\n *\n * @example\n * ```typescript\n * // src/routes/api/test-spans.ts\n * import { createFileRoute } from \"@tanstack/react-router\";\n * import { createTestSpansRoute } from \"autotel-tanstack/testing\";\n *\n * export const Route = createTestSpansRoute(createFileRoute);\n * ```\n */\nexport function createTestSpansRoute(\n  createFileRoute: CreateFileRoute,\n  path = '/api/test-spans',\n) {\n  const { GET, DELETE } = createTestSpansHandlers();\n  return createFileRoute(path)({\n    server: {\n      handlers: { GET, DELETE },\n    },\n  });\n}\n\nexport function createTestSpansHandlers(): {\n  GET: (input: HandlerInput) => Response;\n  DELETE: (input: HandlerInput) => Response;\n} {\n  return {\n    GET(_input: HandlerInput): Response {\n      const guard = e2eGuard() ?? exporterGuard();\n      if (guard) return guard;\n\n      const spans: SerializedSpan[] = getExporter()!\n        .getFinishedSpans()\n        .map((span) => {\n          const { spanId, traceId } = span.spanContext();\n          const serialized: SerializedSpan = {\n            name: span.name,\n            spanId,\n            traceId,\n            attributes: span.attributes,\n            status: span.status,\n            durationMs: span.duration[0] * 1000 + span.duration[1] / 1_000_000,\n          };\n          if (span.parentSpanContext?.spanId) {\n            serialized.parentSpanId = span.parentSpanContext.spanId;\n          }\n          return serialized;\n        });\n\n      return Response.json({ spans });\n    },\n\n    DELETE(_input: HandlerInput): Response {\n      const guard = e2eGuard() ?? exporterGuard();\n      if (guard) return guard;\n      getExporter()!.reset();\n      return Response.json({ ok: true });\n    },\n  };\n}\n"]}
+{"version":3,"file":"testing.js","names":[],"sources":["../src/testing.ts"],"sourcesContent":["import { type ReadableSpan } from '@opentelemetry/sdk-trace-base';\nimport { InMemorySpanExporter } from 'autotel/exporters';\nimport { SimpleSpanProcessor } from 'autotel/processors';\nimport { init } from 'autotel';\n\n/**\n * Test harness for TanStack instrumentation testing\n *\n * Provides utilities for testing TanStack Start applications\n * with autotel-tanstack instrumentation.\n */\nexport interface TestHarness {\n  /**\n   * The in-memory span exporter\n   */\n  exporter: {\n    getFinishedSpans(): ReadableSpan[];\n    reset(): void;\n  };\n\n  /**\n   * Get all finished spans\n   */\n  getSpans(): ReadableSpan[];\n\n  /**\n   * Get spans by name (exact match or regex)\n   */\n  getSpansByName(name: string | RegExp): ReadableSpan[];\n\n  /**\n   * Get spans by TanStack type\n   */\n  getSpansByType(\n    type: 'request' | 'serverFn' | 'loader' | 'beforeLoad',\n  ): ReadableSpan[];\n\n  /**\n   * Reset collected spans\n   */\n  reset(): void;\n\n  /**\n   * Assert a span exists\n   */\n  assertSpanExists(name: string | RegExp): void;\n\n  /**\n   * Assert a span has a specific attribute\n   */\n  assertSpanHasAttribute(\n    name: string | RegExp,\n    attr: string,\n    value?: unknown,\n  ): void;\n\n  /**\n   * Assert a server function was traced\n   */\n  assertServerFnTraced(name: string): void;\n\n  /**\n   * Assert a loader was traced\n   */\n  assertLoaderTraced(routeId: string): void;\n\n  /**\n   * Assert a beforeLoad was traced\n   */\n  assertBeforeLoadTraced(routeId: string): void;\n\n  /**\n   * Assert an HTTP request was traced\n   */\n  assertRequestTraced(method: string, path: string): void;\n}\n\n/**\n * Create a test harness for TanStack instrumentation testing\n *\n * This sets up autotel with an in-memory exporter for testing.\n * Call this in your test setup to capture and assert on spans.\n *\n * @returns Test harness with assertion helpers\n *\n * @example\n * ```typescript\n * import { describe, it, beforeEach } from 'vitest';\n * import { createTestHarness } from 'autotel-tanstack/testing';\n *\n * describe('MyServerFunction', () => {\n *   let harness: ReturnType<typeof createTestHarness>;\n *\n *   beforeEach(() => {\n *     harness = createTestHarness();\n *   });\n *\n *   afterEach(() => {\n *     harness.reset();\n *   });\n *\n *   it('should trace the server function', async () => {\n *     await myServerFunction({ id: '123' });\n *\n *     harness.assertServerFnTraced('myServerFunction');\n *     harness.assertSpanHasAttribute(\n *       /tanstack\\.serverFn/,\n *       'tanstack.server_function.name',\n *       'myServerFunction'\n *     );\n *   });\n * });\n * ```\n */\nexport function createTestHarness(): TestHarness {\n  const exporter = new InMemorySpanExporter();\n\n  init({\n    service: 'test',\n    spanProcessors: [new SimpleSpanProcessor(exporter)],\n  });\n\n  function getSpans(): ReadableSpan[] {\n    return exporter.getFinishedSpans() as ReadableSpan[];\n  }\n\n  function getSpansByName(name: string | RegExp): ReadableSpan[] {\n    const spans = getSpans();\n    if (typeof name === 'string') {\n      return spans.filter((s) => s.name === name);\n    }\n    return spans.filter((s) => name.test(s.name));\n  }\n\n  function getSpansByType(\n    type: 'request' | 'serverFn' | 'loader' | 'beforeLoad',\n  ): ReadableSpan[] {\n    return getSpans().filter((s) => s.attributes['tanstack.type'] === type);\n  }\n\n  function reset(): void {\n    exporter.reset();\n  }\n\n  function assertSpanExists(name: string | RegExp): void {\n    const spans = getSpansByName(name);\n    if (spans.length === 0) {\n      const allSpanNames = getSpans().map((s) => s.name);\n      throw new Error(\n        `Expected span \"${name}\" to exist. Found spans: ${JSON.stringify(allSpanNames)}`,\n      );\n    }\n  }\n\n  function assertSpanHasAttribute(\n    name: string | RegExp,\n    attr: string,\n    value?: unknown,\n  ): void {\n    const spans = getSpansByName(name);\n    if (spans.length === 0) {\n      throw new Error(`Span \"${name}\" not found`);\n    }\n\n    const span = spans[0];\n    const attrValue = span.attributes[attr];\n\n    if (attrValue === undefined) {\n      throw new Error(\n        `Attribute \"${attr}\" not found on span \"${span.name}\". ` +\n          `Available attributes: ${JSON.stringify(Object.keys(span.attributes))}`,\n      );\n    }\n\n    if (value !== undefined && attrValue !== value) {\n      throw new Error(\n        `Expected attribute \"${attr}\" to be \"${value}\", got \"${attrValue}\"`,\n      );\n    }\n  }\n\n  function assertServerFnTraced(name: string): void {\n    assertSpanExists(`tanstack.serverFn.${name}`);\n  }\n\n  function assertLoaderTraced(routeId: string): void {\n    assertSpanExists(`tanstack.loader.${routeId}`);\n  }\n\n  function assertBeforeLoadTraced(routeId: string): void {\n    assertSpanExists(`tanstack.beforeLoad.${routeId}`);\n  }\n\n  function assertRequestTraced(method: string, path: string): void {\n    assertSpanExists(`${method} ${path}`);\n  }\n\n  return {\n    exporter,\n    getSpans,\n    getSpansByName,\n    getSpansByType,\n    reset,\n    assertSpanExists,\n    assertSpanHasAttribute,\n    assertServerFnTraced,\n    assertLoaderTraced,\n    assertBeforeLoadTraced,\n    assertRequestTraced,\n  };\n}\n\n/**\n * Mock request factory for testing\n *\n * Creates mock Request objects for testing middleware and handlers.\n *\n * @example\n * ```typescript\n * const request = createMockRequest('GET', '/api/users', {\n *   headers: { 'x-request-id': 'test-123' },\n * });\n * ```\n */\nexport function createMockRequest(\n  method: string,\n  path: string,\n  options: {\n    headers?: Record<string, string>;\n    body?: string;\n    traceparent?: string;\n  } = {},\n): Request {\n  const headers = new Headers(options.headers);\n\n  if (options.traceparent) {\n    headers.set('traceparent', options.traceparent);\n  }\n\n  return new Request(`http://localhost${path}`, {\n    method,\n    headers,\n    body: options.body,\n  });\n}\n\n/**\n * Generate a valid W3C traceparent header for testing\n *\n * @param traceId - Optional 32-char hex trace ID\n * @param spanId - Optional 16-char hex span ID\n * @returns Valid traceparent header string\n *\n * @example\n * ```typescript\n * const traceparent = generateTraceparent();\n * const request = createMockRequest('GET', '/api/users', { traceparent });\n * ```\n */\nexport function generateTraceparent(traceId?: string, spanId?: string): string {\n  const version = '00';\n  const trace = traceId || generateHex(32);\n  const span = spanId || generateHex(16);\n  const flags = '01'; // Sampled\n\n  return `${version}-${trace}-${span}-${flags}`;\n}\n\nfunction generateHex(length: number): string {\n  const chars = '0123456789abcdef';\n  let result = '';\n  for (let i = 0; i < length; i++) {\n    result += chars[Math.floor(Math.random() * 16)];\n  }\n  return result;\n}\n\n/**\n * Serialized span shape returned by the test-spans HTTP endpoint.\n * Mirrors the fields the Playwright side needs for assertions.\n *\n * Defined as a `type` (not `interface`) so it is assignable to\n * `Record<string, unknown>` in TypeScript 6+ strict mode.\n */\nexport type SerializedSpan = {\n  name: string;\n  spanId: string;\n  traceId: string;\n  parentSpanId?: string;\n  attributes?: Record<string, unknown>;\n  status: { code: number; message?: string };\n  durationMs: number;\n};\n\ninterface TestSpanExporter {\n  getFinishedSpans(): Array<{\n    name: string;\n    spanContext(): { spanId: string; traceId: string };\n    parentSpanContext?: { spanId: string };\n    attributes: Record<string, unknown>;\n    status: { code: number; message?: string };\n    duration: [number, number];\n  }>;\n  reset(): void;\n}\n\nfunction getExporter(): TestSpanExporter | undefined {\n  return (globalThis as Record<string, unknown>).__testSpanExporter as\n    | TestSpanExporter\n    | undefined;\n}\n\nfunction e2eGuard(): Response | null {\n  if (process.env.E2E !== '1') {\n    return Response.json(\n      { error: 'test-spans endpoint only available in E2E mode' },\n      { status: 404 },\n    );\n  }\n  return null;\n}\n\nfunction exporterGuard(): Response | null {\n  if (!getExporter()) {\n    return Response.json(\n      { error: 'in-memory span exporter not initialized' },\n      { status: 500 },\n    );\n  }\n  return null;\n}\n\n/**\n * Accepts either a raw `Request` (legacy) or a TanStack Router context\n * object containing `{ request: Request }` (Router 1.168+).\n */\ntype HandlerInput = Request | { request: Request };\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\ntype CreateFileRoute = (path: string) => (options: any) => any;\n\n/**\n * Creates GET and DELETE handlers for a test-spans HTTP endpoint.\n *\n * Use in a TanStack Start route to expose in-memory spans for Playwright assertions.\n * Only works when E2E=1 (set in webServer command).\n *\n * Handlers accept either a raw `Request` or a TanStack Router context\n * object `{ request: Request }`, so they work with both Router < 1.168\n * and Router >= 1.168.\n *\n * @example\n * ```typescript\n * // src/routes/api/test-spans.ts\n * import { createFileRoute } from \"@tanstack/react-router\";\n * import { createTestSpansHandlers } from 'autotel-tanstack/testing';\n * const { GET, DELETE } = createTestSpansHandlers();\n * export const Route = createFileRoute('/api/test-spans')({\n *   server: { handlers: { GET, DELETE } },\n * });\n * ```\n */\n/**\n * Creates a pre-built TanStack Start route for the test-spans endpoint.\n *\n * Reduces E2E boilerplate to three lines. The handlers accept both\n * `Request` and `{ request: Request }` so they work with any Router version.\n *\n * @param createFileRoute - Pass `createFileRoute` from `@tanstack/react-router`\n * @param path - Route path (default: `/api/test-spans`)\n *\n * @example\n * ```typescript\n * // src/routes/api/test-spans.ts\n * import { createFileRoute } from \"@tanstack/react-router\";\n * import { createTestSpansRoute } from \"autotel-tanstack/testing\";\n *\n * export const Route = createTestSpansRoute(createFileRoute);\n * ```\n */\nexport function createTestSpansRoute(\n  createFileRoute: CreateFileRoute,\n  path = '/api/test-spans',\n) {\n  const { GET, DELETE } = createTestSpansHandlers();\n  return createFileRoute(path)({\n    server: {\n      handlers: { GET, DELETE },\n    },\n  });\n}\n\nexport function createTestSpansHandlers(): {\n  GET: (input: HandlerInput) => Response;\n  DELETE: (input: HandlerInput) => Response;\n} {\n  return {\n    GET(_input: HandlerInput): Response {\n      const guard = e2eGuard() ?? exporterGuard();\n      if (guard) return guard;\n\n      const spans: SerializedSpan[] = getExporter()!\n        .getFinishedSpans()\n        .map((span) => {\n          const { spanId, traceId } = span.spanContext();\n          const serialized: SerializedSpan = {\n            name: span.name,\n            spanId,\n            traceId,\n            attributes: span.attributes,\n            status: span.status,\n            durationMs: span.duration[0] * 1000 + span.duration[1] / 1_000_000,\n          };\n          if (span.parentSpanContext?.spanId) {\n            serialized.parentSpanId = span.parentSpanContext.spanId;\n          }\n          return serialized;\n        });\n\n      return Response.json({ spans });\n    },\n\n    DELETE(_input: HandlerInput): Response {\n      const guard = e2eGuard() ?? exporterGuard();\n      if (guard) return guard;\n      getExporter()!.reset();\n      return Response.json({ ok: true });\n    },\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAkHA,SAAgB,oBAAiC;CAC/C,MAAM,WAAW,IAAI,qBAAqB;CAE1C,KAAK;EACH,SAAS;EACT,gBAAgB,CAAC,IAAI,oBAAoB,QAAQ,CAAC;CACpD,CAAC;CAED,SAAS,WAA2B;EAClC,OAAO,SAAS,iBAAiB;CACnC;CAEA,SAAS,eAAe,MAAuC;EAC7D,MAAM,QAAQ,SAAS;EACvB,IAAI,OAAO,SAAS,UAClB,OAAO,MAAM,QAAQ,MAAM,EAAE,SAAS,IAAI;EAE5C,OAAO,MAAM,QAAQ,MAAM,KAAK,KAAK,EAAE,IAAI,CAAC;CAC9C;CAEA,SAAS,eACP,MACgB;EAChB,OAAO,SAAS,CAAC,CAAC,QAAQ,MAAM,EAAE,WAAW,qBAAqB,IAAI;CACxE;CAEA,SAAS,QAAc;EACrB,SAAS,MAAM;CACjB;CAEA,SAAS,iBAAiB,MAA6B;EAErD,IADc,eAAe,IACrB,CAAC,CAAC,WAAW,GAAG;GACtB,MAAM,eAAe,SAAS,CAAC,CAAC,KAAK,MAAM,EAAE,IAAI;GACjD,MAAM,IAAI,MACR,kBAAkB,KAAK,2BAA2B,KAAK,UAAU,YAAY,GAC/E;EACF;CACF;CAEA,SAAS,uBACP,MACA,MACA,OACM;EACN,MAAM,QAAQ,eAAe,IAAI;EACjC,IAAI,MAAM,WAAW,GACnB,MAAM,IAAI,MAAM,SAAS,KAAK,YAAY;EAG5C,MAAM,OAAO,MAAM;EACnB,MAAM,YAAY,KAAK,WAAW;EAElC,IAAI,cAAc,QAChB,MAAM,IAAI,MACR,cAAc,KAAK,uBAAuB,KAAK,KAAK,2BACzB,KAAK,UAAU,OAAO,KAAK,KAAK,UAAU,CAAC,GACxE;EAGF,IAAI,UAAU,UAAa,cAAc,OACvC,MAAM,IAAI,MACR,uBAAuB,KAAK,WAAW,MAAM,UAAU,UAAU,EACnE;CAEJ;CAEA,SAAS,qBAAqB,MAAoB;EAChD,iBAAiB,qBAAqB,MAAM;CAC9C;CAEA,SAAS,mBAAmB,SAAuB;EACjD,iBAAiB,mBAAmB,SAAS;CAC/C;CAEA,SAAS,uBAAuB,SAAuB;EACrD,iBAAiB,uBAAuB,SAAS;CACnD;CAEA,SAAS,oBAAoB,QAAgB,MAAoB;EAC/D,iBAAiB,GAAG,OAAO,GAAG,MAAM;CACtC;CAEA,OAAO;EACL;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;CACF;AACF;;;;;;;;;;;;;AAcA,SAAgB,kBACd,QACA,MACA,UAII,CAAC,GACI;CACT,MAAM,UAAU,IAAI,QAAQ,QAAQ,OAAO;CAE3C,IAAI,QAAQ,aACV,QAAQ,IAAI,eAAe,QAAQ,WAAW;CAGhD,OAAO,IAAI,QAAQ,mBAAmB,QAAQ;EAC5C;EACA;EACA,MAAM,QAAQ;CAChB,CAAC;AACH;;;;;;;;;;;;;;AAeA,SAAgB,oBAAoB,SAAkB,QAAyB;CAM7E,OAAO,MAJO,WAAW,YAAY,EAAE,EAIZ,GAHd,UAAU,YAAY,EAAE,EAGF;AACrC;AAEA,SAAS,YAAY,QAAwB;CAC3C,MAAM,QAAQ;CACd,IAAI,SAAS;CACb,KAAK,IAAI,IAAI,GAAG,IAAI,QAAQ,KAC1B,UAAU,MAAM,KAAK,MAAM,KAAK,OAAO,IAAI,EAAE;CAE/C,OAAO;AACT;AA+BA,SAAS,cAA4C;CACnD,OAAQ,WAAuC;AAGjD;AAEA,SAAS,WAA4B;CACnC,IAAI,QAAQ,IAAI,QAAQ,KACtB,OAAO,SAAS,KACd,EAAE,OAAO,iDAAiD,GAC1D,EAAE,QAAQ,IAAI,CAChB;CAEF,OAAO;AACT;AAEA,SAAS,gBAAiC;CACxC,IAAI,CAAC,YAAY,GACf,OAAO,SAAS,KACd,EAAE,OAAO,0CAA0C,GACnD,EAAE,QAAQ,IAAI,CAChB;CAEF,OAAO;AACT;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAkDA,SAAgB,qBACd,iBACA,OAAO,mBACP;CACA,MAAM,EAAE,KAAK,WAAW,wBAAwB;CAChD,OAAO,gBAAgB,IAAI,CAAC,CAAC,EAC3B,QAAQ,EACN,UAAU;EAAE;EAAK;CAAO,EAC1B,EACF,CAAC;AACH;AAEA,SAAgB,0BAGd;CACA,OAAO;EACL,IAAI,QAAgC;GAClC,MAAM,QAAQ,SAAS,KAAK,cAAc;GAC1C,IAAI,OAAO,OAAO;GAElB,MAAM,QAA0B,YAAY,CAAC,CAC1C,iBAAiB,CAAC,CAClB,KAAK,SAAS;IACb,MAAM,EAAE,QAAQ,YAAY,KAAK,YAAY;IAC7C,MAAM,aAA6B;KACjC,MAAM,KAAK;KACX;KACA;KACA,YAAY,KAAK;KACjB,QAAQ,KAAK;KACb,YAAY,KAAK,SAAS,KAAK,MAAO,KAAK,SAAS,KAAK;IAC3D;IACA,IAAI,KAAK,mBAAmB,QAC1B,WAAW,eAAe,KAAK,kBAAkB;IAEnD,OAAO;GACT,CAAC;GAEH,OAAO,SAAS,KAAK,EAAE,MAAM,CAAC;EAChC;EAEA,OAAO,QAAgC;GACrC,MAAM,QAAQ,SAAS,KAAK,cAAc;GAC1C,IAAI,OAAO,OAAO;GAClB,YAAY,CAAC,CAAE,MAAM;GACrB,OAAO,SAAS,KAAK,EAAE,IAAI,KAAK,CAAC;EACnC;CACF;AACF"}

package/dist/types-BJ7FyVoX.d.ts

@@ -0,0 +1,87 @@
+//#region src/browser/types.d.ts
+/**
+ * Browser stub for types module
+ *
+ * Provides type definitions without importing from @opentelemetry/api
+ */
+/**
+ * OpenTelemetry-compatible Attributes type (browser stub)
+ */
+type Attributes = Record<string, string | number | boolean | undefined>;
+/**
+ * Configuration options for TanStack Start instrumentation
+ */
+interface TanStackInstrumentationConfig {
+  service?: string;
+  captureArgs?: boolean;
+  captureResults?: boolean;
+  captureErrors?: boolean;
+  captureHeaders?: string[];
+  excludePaths?: (string | RegExp)[];
+  sampling?: 'always' | 'adaptive' | 'never';
+  customAttributes?: (context: {
+    type: 'request' | 'serverFn' | 'loader' | 'beforeLoad' | 'middleware';
+    name: string;
+    request?: Request;
+    args?: unknown;
+    result?: unknown;
+  }) => Attributes;
+}
+/**
+ * Configuration specific to tracing middleware
+ */
+interface TracingMiddlewareConfig extends TanStackInstrumentationConfig {
+  type?: 'request' | 'function';
+}
+/**
+ * Configuration for server function tracing
+ */
+interface TraceServerFnConfig {
+  name?: string;
+  captureArgs?: boolean;
+  captureResults?: boolean;
+}
+/**
+ * Configuration for loader tracing
+ */
+interface TraceLoaderConfig {
+  name?: string;
+  captureParams?: boolean;
+  captureResult?: boolean;
+}
+/**
+ * Configuration for handler wrapper
+ */
+interface WrapStartHandlerConfig extends TanStackInstrumentationConfig {
+  endpoint?: string;
+  headers?: Record<string, string>;
+}
+/**
+ * Default configuration values
+ */
+declare const DEFAULT_CONFIG: Required<Omit<TanStackInstrumentationConfig, 'customAttributes' | 'service'>>;
+/**
+ * Span attribute keys (stub - values are strings)
+ */
+declare const SPAN_ATTRIBUTES: {
+  readonly HTTP_REQUEST_METHOD: "http.request.method";
+  readonly HTTP_RESPONSE_STATUS_CODE: "http.response.status_code";
+  readonly URL_PATH: "url.path";
+  readonly URL_QUERY: "url.query";
+  readonly URL_FULL: "url.full";
+  readonly RPC_SYSTEM: "rpc.system";
+  readonly RPC_METHOD: "rpc.method";
+  readonly TANSTACK_TYPE: "tanstack.type";
+  readonly TANSTACK_SERVER_FN_NAME: "tanstack.server_function.name";
+  readonly TANSTACK_SERVER_FN_METHOD: "tanstack.server_function.method";
+  readonly TANSTACK_SERVER_FN_ARGS: "tanstack.server_function.args";
+  readonly TANSTACK_SERVER_FN_RESULT: "tanstack.server_function.result";
+  readonly TANSTACK_LOADER_ROUTE_ID: "tanstack.loader.route_id";
+  readonly TANSTACK_LOADER_TYPE: "tanstack.loader.type";
+  readonly TANSTACK_LOADER_PARAMS: "tanstack.loader.params";
+  readonly TANSTACK_MIDDLEWARE_NAME: "tanstack.middleware.name";
+  readonly TANSTACK_REQUEST_DURATION_MS: "tanstack.request.duration_ms";
+};
+//#endregion
+export { TraceLoaderConfig as a, WrapStartHandlerConfig as c, TanStackInstrumentationConfig as i, DEFAULT_CONFIG as n, TraceServerFnConfig as o, SPAN_ATTRIBUTES as r, TracingMiddlewareConfig as s, Attributes as t };
+//# sourceMappingURL=types-BJ7FyVoX.d.ts.map

package/dist/types-BJ7FyVoX.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types-BJ7FyVoX.d.ts","names":[],"sources":["../src/browser/types.ts"],"mappings":";;AASA;;;;AAA+B;AAK/B;;AAL+B,KAAnB,UAAA,GAAa,MAAM;;;;UAKd,6BAAA;EACf,OAAA;EACA,WAAA;EACA,cAAA;EACA,aAAA;EACA,cAAA;EACA,YAAA,aAAyB,MAAA;EACzB,QAAA;EACA,gBAAA,IAAoB,OAAA;IAClB,IAAA;IACA,IAAA;IACA,OAAA,GAAU,OAAA;IACV,IAAA;IACA,MAAA;EAAA,MACI,UAAA;AAAA;;;;UAMS,uBAAA,SAAgC,6BAA6B;EAC5E,IAAI;AAAA;;;;UAMW,mBAAA;EACf,IAAA;EACA,WAAA;EACA,cAAA;AAAA;;;;UAMe,iBAAA;EACf,IAAA;EACA,aAAA;EACA,aAAA;AAAA;;;;UAMe,sBAAA,SAA+B,6BAA6B;EAC3E,QAAA;EACA,OAAA,GAAU,MAAA;AAAA;;;;cAMC,cAAA,EAAgB,QAAA,CAC3B,IAAA,CAAK,6BAAA;;;;cAaM,eAAA;EAAA"}

package/dist/types-BrccP0yX.js

@@ -0,0 +1,38 @@
+//#region src/types.ts
+/**
+* Default configuration values
+*/
+const DEFAULT_CONFIG = {
+	captureArgs: true,
+	captureResults: false,
+	captureErrors: true,
+	captureHeaders: ["x-request-id"],
+	excludePaths: [],
+	sampling: "adaptive"
+};
+/**
+* Span attribute keys following OpenTelemetry semantic conventions
+*/
+const SPAN_ATTRIBUTES = {
+	HTTP_REQUEST_METHOD: "http.request.method",
+	HTTP_RESPONSE_STATUS_CODE: "http.response.status_code",
+	URL_PATH: "url.path",
+	URL_QUERY: "url.query",
+	URL_FULL: "url.full",
+	RPC_SYSTEM: "rpc.system",
+	RPC_METHOD: "rpc.method",
+	TANSTACK_TYPE: "tanstack.type",
+	TANSTACK_SERVER_FN_NAME: "tanstack.server_function.name",
+	TANSTACK_SERVER_FN_METHOD: "tanstack.server_function.method",
+	TANSTACK_SERVER_FN_ARGS: "tanstack.server_function.args",
+	TANSTACK_SERVER_FN_RESULT: "tanstack.server_function.result",
+	TANSTACK_LOADER_ROUTE_ID: "tanstack.loader.route_id",
+	TANSTACK_LOADER_TYPE: "tanstack.loader.type",
+	TANSTACK_LOADER_PARAMS: "tanstack.loader.params",
+	TANSTACK_MIDDLEWARE_NAME: "tanstack.middleware.name",
+	TANSTACK_REQUEST_DURATION_MS: "tanstack.request.duration_ms"
+};
+
+//#endregion
+export { SPAN_ATTRIBUTES as n, DEFAULT_CONFIG as t };
+//# sourceMappingURL=types-BrccP0yX.js.map

package/dist/types-BrccP0yX.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types-BrccP0yX.js","names":[],"sources":["../src/types.ts"],"sourcesContent":["import type { Attributes } from '@opentelemetry/api';\n\n/**\n * Configuration options for TanStack Start instrumentation\n */\nexport interface TanStackInstrumentationConfig {\n  /**\n   * Service name for spans\n   * @default process.env.OTEL_SERVICE_NAME || 'tanstack-start'\n   */\n  service?: string;\n\n  /**\n   * Whether to capture function arguments as span attributes\n   * Warning: May contain PII, review before enabling in production\n   * @default true\n   */\n  captureArgs?: boolean;\n\n  /**\n   * Whether to capture function results as span attributes\n   * Warning: May contain PII, disable in production\n   * @default false\n   */\n  captureResults?: boolean;\n\n  /**\n   * Whether to capture errors and record exceptions\n   * @default true\n   */\n  captureErrors?: boolean;\n\n  /**\n   * HTTP headers to capture as span attributes\n   * @default ['x-request-id']\n   */\n  captureHeaders?: string[];\n\n  /**\n   * URL paths to exclude from tracing (glob patterns)\n   * @default []\n   */\n  excludePaths?: (string | RegExp)[];\n\n  /**\n   * Sampling strategy\n   * - 'always': Sample all requests (100%)\n   * - 'adaptive': Use autotel's adaptive sampling (errors + slow = 100%, baseline 10%)\n   * - 'never': Disable sampling (for testing/debugging)\n   * @default 'adaptive'\n   */\n  sampling?: 'always' | 'adaptive' | 'never';\n\n  /**\n   * Custom function to extract additional span attributes\n   */\n  customAttributes?: (context: {\n    type: 'request' | 'serverFn' | 'loader' | 'beforeLoad' | 'middleware';\n    name: string;\n    request?: Request;\n    args?: unknown;\n    result?: unknown;\n  }) => Attributes;\n}\n\n/**\n * Configuration specific to tracing middleware\n */\nexport interface TracingMiddlewareConfig extends TanStackInstrumentationConfig {\n  /**\n   * Type of middleware\n   * - 'request': For global request middleware (routes, SSR)\n   * - 'function': For server function middleware\n   * @default 'request'\n   */\n  type?: 'request' | 'function';\n}\n\n/**\n * Configuration for server function tracing\n */\nexport interface TraceServerFnConfig {\n  /**\n   * Explicit name for the span\n   * If not provided, will attempt to infer from function name\n   */\n  name?: string;\n\n  /**\n   * Whether to capture function arguments\n   * @default true\n   */\n  captureArgs?: boolean;\n\n  /**\n   * Whether to capture function results\n   * @default false\n   */\n  captureResults?: boolean;\n}\n\n/**\n * Configuration for loader tracing\n */\nexport interface TraceLoaderConfig {\n  /**\n   * Explicit name for the span\n   * If not provided, will use route ID\n   */\n  name?: string;\n\n  /**\n   * Whether to capture route params\n   * @default true\n   */\n  captureParams?: boolean;\n\n  /**\n   * Whether to capture loader result\n   * @default false\n   */\n  captureResult?: boolean;\n}\n\n/**\n * Configuration for handler wrapper\n */\nexport interface WrapStartHandlerConfig extends TanStackInstrumentationConfig {\n  /**\n   * OTLP endpoint URL\n   * @default process.env.OTEL_EXPORTER_OTLP_ENDPOINT\n   */\n  endpoint?: string;\n\n  /**\n   * OTLP headers (e.g., for authentication)\n   * @default parsed from process.env.OTEL_EXPORTER_OTLP_HEADERS\n   */\n  headers?: Record<string, string>;\n}\n\n/**\n * Default configuration values\n */\nexport const DEFAULT_CONFIG: Required<\n  Omit<TanStackInstrumentationConfig, 'customAttributes' | 'service'>\n> = {\n  captureArgs: true,\n  captureResults: false,\n  captureErrors: true,\n  captureHeaders: ['x-request-id'],\n  excludePaths: [],\n  sampling: 'adaptive',\n};\n\n/**\n * Span attribute keys following OpenTelemetry semantic conventions\n */\nexport const SPAN_ATTRIBUTES = {\n  // HTTP semantic conventions\n  HTTP_REQUEST_METHOD: 'http.request.method',\n  HTTP_RESPONSE_STATUS_CODE: 'http.response.status_code',\n  URL_PATH: 'url.path',\n  URL_QUERY: 'url.query',\n  URL_FULL: 'url.full',\n\n  // RPC semantic conventions (for server functions)\n  RPC_SYSTEM: 'rpc.system',\n  RPC_METHOD: 'rpc.method',\n\n  // TanStack-specific attributes\n  TANSTACK_TYPE: 'tanstack.type',\n  TANSTACK_SERVER_FN_NAME: 'tanstack.server_function.name',\n  TANSTACK_SERVER_FN_METHOD: 'tanstack.server_function.method',\n  TANSTACK_SERVER_FN_ARGS: 'tanstack.server_function.args',\n  TANSTACK_SERVER_FN_RESULT: 'tanstack.server_function.result',\n  TANSTACK_LOADER_ROUTE_ID: 'tanstack.loader.route_id',\n  TANSTACK_LOADER_TYPE: 'tanstack.loader.type',\n  TANSTACK_LOADER_PARAMS: 'tanstack.loader.params',\n  TANSTACK_MIDDLEWARE_NAME: 'tanstack.middleware.name',\n  TANSTACK_REQUEST_DURATION_MS: 'tanstack.request.duration_ms',\n} as const;\n"],"mappings":";;;;AAgJA,MAAa,iBAET;CACF,aAAa;CACb,gBAAgB;CAChB,eAAe;CACf,gBAAgB,CAAC,cAAc;CAC/B,cAAc,CAAC;CACf,UAAU;AACZ;;;;AAKA,MAAa,kBAAkB;CAE7B,qBAAqB;CACrB,2BAA2B;CAC3B,UAAU;CACV,WAAW;CACX,UAAU;CAGV,YAAY;CACZ,YAAY;CAGZ,eAAe;CACf,yBAAyB;CACzB,2BAA2B;CAC3B,yBAAyB;CACzB,2BAA2B;CAC3B,0BAA0B;CAC1B,sBAAsB;CACtB,wBAAwB;CACxB,0BAA0B;CAC1B,8BAA8B;AAChC"}