autotel-tanstack 1.13.4 → 1.13.5

package/dist/auto.js

@@ -6,6 +6,8 @@ import './chunk-I4LX3LOG.js';
 import './chunk-NTY64BKS.js';
 import './chunk-EGRHWZRV.js';
 import { init } from 'autotel';
+import { InMemorySpanExporter } from 'autotel/exporters';
+import { SimpleSpanProcessor } from 'autotel/processors';
 
 var service = process.env.OTEL_SERVICE_NAME || "tanstack-start";
 var endpoint = process.env.OTEL_EXPORTER_OTLP_ENDPOINT;
@@ -28,16 +30,26 @@ function resolveDebug() {
   if (!endpoint && process.env.NODE_ENV === "development") return "pretty";
   return false;
 }
-init({
-  service,
-  endpoint,
-  headers,
-  debug: resolveDebug()
-});
+if (process.env.E2E === "1") {
+  const e2eExporter = new InMemorySpanExporter();
+  const e2eProcessor = new SimpleSpanProcessor(e2eExporter);
+  globalThis.__testSpanExporter = e2eExporter;
+  init({
+    service,
+    spanProcessors: [e2eProcessor]
+  });
+} else {
+  init({
+    service,
+    endpoint,
+    headers,
+    debug: resolveDebug()
+  });
+}
 if (process.env.NODE_ENV === "development" || process.env.AUTOTEL_DEBUG) {
   console.log("[autotel-tanstack] Auto-initialized with:", {
     service,
-    endpoint: endpoint || "(not configured)",
+    endpoint: process.env.E2E === "1" ? "(E2E: in-memory)" : endpoint || "(not configured)",
     hasHeaders: !!headers
   });
 }

package/dist/auto.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/auto.ts"],"names":[],"mappings":";;;;;;;;;AA4BA,IAAM,OAAA,GAAU,OAAA,CAAQ,GAAA,CAAI,iBAAA,IAAqB,gBAAA;AAGjD,IAAM,QAAA,GAAW,QAAQ,GAAA,CAAI,2BAAA;AAG7B,IAAI,OAAA;AACJ,IAAI,OAAA,CAAQ,IAAI,0BAAA,EAA4B;AAC1C,EAAA,OAAA,GAAU,EAAC;AACX,EAAA,MAAM,KAAA,GAAQ,OAAA,CAAQ,GAAA,CAAI,0BAAA,CAA2B,MAAM,GAAG,CAAA;AAC9D,EAAA,KAAA,MAAW,QAAQ,KAAA,EAAO;AACxB,IAAA,MAAM,CAAC,GAAA,EAAK,KAAK,CAAA,GAAI,IAAA,CAAK,MAAM,GAAG,CAAA;AACnC,IAAA,IAAI,OAAO,KAAA,EAAO;AAChB,MAAA,OAAA,CAAQ,GAAA,CAAI,IAAA,EAAM,CAAA,GAAI,MAAM,IAAA,EAAK;AAAA,IACnC;AAAA,EACF;AACF;AAIA,SAAS,YAAA,GAAmC;AAC1C,EAAA,MAAM,GAAA,GAAM,QAAQ,GAAA,CAAI,aAAA;AACxB,EAAA,IAAI,GAAA,KAAQ,UAAU,OAAO,QAAA;AAC7B,EAAA,IAAI,GAAA,KAAQ,MAAA,IAAU,GAAA,KAAQ,GAAA,EAAK,OAAO,IAAA;AAC1C,EAAA,IAAI,GAAA,KAAQ,OAAA,IAAW,GAAA,KAAQ,GAAA,EAAK,OAAO,KAAA;AAC3C,EAAA,IAAI,CAAC,QAAA,IAAY,OAAA,CAAQ,GAAA,CAAI,QAAA,KAAa,eAAe,OAAO,QAAA;AAChE,EAAA,OAAO,KAAA;AACT;AAGA,IAAA,CAAK;AAAA,EACH,OAAA;AAAA,EACA,QAAA;AAAA,EACA,OAAA;AAAA,EACA,OAAO,YAAA;AACT,CAAC,CAAA;AAGD,IAAI,QAAQ,GAAA,CAAI,QAAA,KAAa,aAAA,IAAiB,OAAA,CAAQ,IAAI,aAAA,EAAe;AACvE,EAAA,OAAA,CAAQ,IAAI,2CAAA,EAA6C;AAAA,IACvD,OAAA;AAAA,IACA,UAAU,QAAA,IAAY,kBAAA;AAAA,IACtB,UAAA,EAAY,CAAC,CAAC;AAAA,GACf,CAAA;AACH;AAUO,SAAS,2BAAA,GAAuC;AACrD,EAAA,OAAO,IAAA;AACT;AAKO,SAAS,cAAA,GAAyB;AACvC,EAAA,OAAO,OAAA;AACT;AAKO,SAAS,WAAA,GAAkC;AAChD,EAAA,OAAO,QAAA;AACT","file":"auto.js","sourcesContent":["/**\n * Zero-config auto-instrumentation for TanStack Start\n *\n * Import this module to automatically instrument TanStack Start applications\n * with OpenTelemetry tracing. Configuration is read from environment variables.\n *\n * Environment Variables:\n * - OTEL_SERVICE_NAME: Service name (default: 'tanstack-start')\n * - OTEL_EXPORTER_OTLP_ENDPOINT: OTLP collector URL\n * - OTEL_EXPORTER_OTLP_HEADERS: Authentication headers (key=value,key=value)\n * - AUTOTEL_DEBUG: Set to 'true' or 'pretty' to log spans to the server console\n *\n * @example\n * ```typescript\n * // app/start.ts\n * import 'autotel-tanstack/auto';\n * import { createStart } from '@tanstack/react-start';\n *\n * // Tracing is automatically configured!\n * export const startInstance = createStart(() => ({}));\n * ```\n *\n * @module\n */\n\nimport { init } from 'autotel';\n\n// Parse service name\nconst service = process.env.OTEL_SERVICE_NAME || 'tanstack-start';\n\n// Parse endpoint\nconst endpoint = process.env.OTEL_EXPORTER_OTLP_ENDPOINT;\n\n// Parse headers\nlet headers: Record<string, string> | undefined;\nif (process.env.OTEL_EXPORTER_OTLP_HEADERS) {\n  headers = {};\n  const pairs = process.env.OTEL_EXPORTER_OTLP_HEADERS.split(',');\n  for (const pair of pairs) {\n    const [key, value] = pair.split('=');\n    if (key && value) {\n      headers[key.trim()] = value.trim();\n    }\n  }\n}\n\n// Debug: span output to server console. AUTOTEL_DEBUG=pretty | true, or default\n// to pretty in dev when no OTLP endpoint is set so you see spans immediately.\nfunction resolveDebug(): boolean | 'pretty' {\n  const env = process.env.AUTOTEL_DEBUG;\n  if (env === 'pretty') return 'pretty';\n  if (env === 'true' || env === '1') return true;\n  if (env === 'false' || env === '0') return false;\n  if (!endpoint && process.env.NODE_ENV === 'development') return 'pretty';\n  return false;\n}\n\n// Initialize autotel\ninit({\n  service,\n  endpoint,\n  headers,\n  debug: resolveDebug(),\n});\n\n// Log initialization (only in development)\nif (process.env.NODE_ENV === 'development' || process.env.AUTOTEL_DEBUG) {\n  console.log('[autotel-tanstack] Auto-initialized with:', {\n    service,\n    endpoint: endpoint || '(not configured)',\n    hasHeaders: !!headers,\n  });\n}\n\n// Re-export middleware for convenience\nexport { tracingMiddleware, functionTracingMiddleware } from './middleware';\nexport { traceServerFn } from './server-functions';\nexport { traceLoader, traceBeforeLoad } from './loaders';\n\n/**\n * Check if auto-instrumentation is active\n */\nexport function isAutoInstrumentationActive(): boolean {\n  return true;\n}\n\n/**\n * Get the configured service name\n */\nexport function getServiceName(): string {\n  return service;\n}\n\n/**\n * Get the configured endpoint\n */\nexport function getEndpoint(): string | undefined {\n  return endpoint;\n}\n"]}
+{"version":3,"sources":["../src/auto.ts"],"names":[],"mappings":";;;;;;;;;;;AA8BA,IAAM,OAAA,GAAU,OAAA,CAAQ,GAAA,CAAI,iBAAA,IAAqB,gBAAA;AAGjD,IAAM,QAAA,GAAW,QAAQ,GAAA,CAAI,2BAAA;AAG7B,IAAI,OAAA;AACJ,IAAI,OAAA,CAAQ,IAAI,0BAAA,EAA4B;AAC1C,EAAA,OAAA,GAAU,EAAC;AACX,EAAA,MAAM,KAAA,GAAQ,OAAA,CAAQ,GAAA,CAAI,0BAAA,CAA2B,MAAM,GAAG,CAAA;AAC9D,EAAA,KAAA,MAAW,QAAQ,KAAA,EAAO;AACxB,IAAA,MAAM,CAAC,GAAA,EAAK,KAAK,CAAA,GAAI,IAAA,CAAK,MAAM,GAAG,CAAA;AACnC,IAAA,IAAI,OAAO,KAAA,EAAO;AAChB,MAAA,OAAA,CAAQ,GAAA,CAAI,IAAA,EAAM,CAAA,GAAI,MAAM,IAAA,EAAK;AAAA,IACnC;AAAA,EACF;AACF;AAIA,SAAS,YAAA,GAAmC;AAC1C,EAAA,MAAM,GAAA,GAAM,QAAQ,GAAA,CAAI,aAAA;AACxB,EAAA,IAAI,GAAA,KAAQ,UAAU,OAAO,QAAA;AAC7B,EAAA,IAAI,GAAA,KAAQ,MAAA,IAAU,GAAA,KAAQ,GAAA,EAAK,OAAO,IAAA;AAC1C,EAAA,IAAI,GAAA,KAAQ,OAAA,IAAW,GAAA,KAAQ,GAAA,EAAK,OAAO,KAAA;AAC3C,EAAA,IAAI,CAAC,QAAA,IAAY,OAAA,CAAQ,GAAA,CAAI,QAAA,KAAa,eAAe,OAAO,QAAA;AAChE,EAAA,OAAO,KAAA;AACT;AAMA,IAAI,OAAA,CAAQ,GAAA,CAAI,GAAA,KAAQ,GAAA,EAAK;AAC3B,EAAA,MAAM,WAAA,GAAc,IAAI,oBAAA,EAAqB;AAC7C,EAAA,MAAM,YAAA,GAAe,IAAI,mBAAA,CAAoB,WAAW,CAAA;AACxD,EAAC,WAAuC,kBAAA,GAAqB,WAAA;AAE7D,EAAA,IAAA,CAAK;AAAA,IACH,OAAA;AAAA,IACA,cAAA,EAAgB,CAAC,YAAY;AAAA,GAC9B,CAAA;AACH,CAAA,MAAO;AAEL,EAAA,IAAA,CAAK;AAAA,IACH,OAAA;AAAA,IACA,QAAA;AAAA,IACA,OAAA;AAAA,IACA,OAAO,YAAA;AAAa,GACrB,CAAA;AACH;AAGA,IAAI,QAAQ,GAAA,CAAI,QAAA,KAAa,aAAA,IAAiB,OAAA,CAAQ,IAAI,aAAA,EAAe;AACvE,EAAA,OAAA,CAAQ,IAAI,2CAAA,EAA6C;AAAA,IACvD,OAAA;AAAA,IACA,UACE,OAAA,CAAQ,GAAA,CAAI,GAAA,KAAQ,GAAA,GAChB,qBACA,QAAA,IAAY,kBAAA;AAAA,IAClB,UAAA,EAAY,CAAC,CAAC;AAAA,GACf,CAAA;AACH;AAUO,SAAS,2BAAA,GAAuC;AACrD,EAAA,OAAO,IAAA;AACT;AAKO,SAAS,cAAA,GAAyB;AACvC,EAAA,OAAO,OAAA;AACT;AAKO,SAAS,WAAA,GAAkC;AAChD,EAAA,OAAO,QAAA;AACT","file":"auto.js","sourcesContent":["/**\n * Zero-config auto-instrumentation for TanStack Start\n *\n * Import this module to automatically instrument TanStack Start applications\n * with OpenTelemetry tracing. Configuration is read from environment variables.\n *\n * Environment Variables:\n * - OTEL_SERVICE_NAME: Service name (default: 'tanstack-start')\n * - OTEL_EXPORTER_OTLP_ENDPOINT: OTLP collector URL\n * - OTEL_EXPORTER_OTLP_HEADERS: Authentication headers (key=value,key=value)\n * - AUTOTEL_DEBUG: Set to 'true' or 'pretty' to log spans to the server console\n *\n * @example\n * ```typescript\n * // app/start.ts\n * import 'autotel-tanstack/auto';\n * import { createStart } from '@tanstack/react-start';\n *\n * // Tracing is automatically configured!\n * export const startInstance = createStart(() => ({}));\n * ```\n *\n * @module\n */\n\nimport { init } from 'autotel';\nimport { InMemorySpanExporter } from 'autotel/exporters';\nimport { SimpleSpanProcessor } from 'autotel/processors';\n\n// Parse service name\nconst service = process.env.OTEL_SERVICE_NAME || 'tanstack-start';\n\n// Parse endpoint\nconst endpoint = process.env.OTEL_EXPORTER_OTLP_ENDPOINT;\n\n// Parse headers\nlet headers: Record<string, string> | undefined;\nif (process.env.OTEL_EXPORTER_OTLP_HEADERS) {\n  headers = {};\n  const pairs = process.env.OTEL_EXPORTER_OTLP_HEADERS.split(',');\n  for (const pair of pairs) {\n    const [key, value] = pair.split('=');\n    if (key && value) {\n      headers[key.trim()] = value.trim();\n    }\n  }\n}\n\n// Debug: span output to server console. AUTOTEL_DEBUG=pretty | true, or default\n// to pretty in dev when no OTLP endpoint is set so you see spans immediately.\nfunction resolveDebug(): boolean | 'pretty' {\n  const env = process.env.AUTOTEL_DEBUG;\n  if (env === 'pretty') return 'pretty';\n  if (env === 'true' || env === '1') return true;\n  if (env === 'false' || env === '0') return false;\n  if (!endpoint && process.env.NODE_ENV === 'development') return 'pretty';\n  return false;\n}\n\n// E2E mode: use InMemorySpanExporter so tests can capture and assert on spans.\n// When E2E=1, skip the normal OTLP path and use in-memory storage instead.\n// Note: combined E2E + OTLP (two processors) is handled at integration level\n// because constructing an OTLP processor requires deps not available here.\nif (process.env.E2E === '1') {\n  const e2eExporter = new InMemorySpanExporter();\n  const e2eProcessor = new SimpleSpanProcessor(e2eExporter);\n  (globalThis as Record<string, unknown>).__testSpanExporter = e2eExporter;\n\n  init({\n    service,\n    spanProcessors: [e2eProcessor],\n  });\n} else {\n  // Initialize autotel (production path — unchanged)\n  init({\n    service,\n    endpoint,\n    headers,\n    debug: resolveDebug(),\n  });\n}\n\n// Log initialization (only in development)\nif (process.env.NODE_ENV === 'development' || process.env.AUTOTEL_DEBUG) {\n  console.log('[autotel-tanstack] Auto-initialized with:', {\n    service,\n    endpoint:\n      process.env.E2E === '1'\n        ? '(E2E: in-memory)'\n        : endpoint || '(not configured)',\n    hasHeaders: !!headers,\n  });\n}\n\n// Re-export middleware for convenience\nexport { tracingMiddleware, functionTracingMiddleware } from './middleware';\nexport { traceServerFn } from './server-functions';\nexport { traceLoader, traceBeforeLoad } from './loaders';\n\n/**\n * Check if auto-instrumentation is active\n */\nexport function isAutoInstrumentationActive(): boolean {\n  return true;\n}\n\n/**\n * Get the configured service name\n */\nexport function getServiceName(): string {\n  return service;\n}\n\n/**\n * Get the configured endpoint\n */\nexport function getEndpoint(): string | undefined {\n  return endpoint;\n}\n"]}

package/dist/browser/index.js

@@ -6,7 +6,7 @@ export { createTracedServerFnFactory, traceServerFn } from '../chunk-CSFIPJC2.js
 export { createTracedRoute, traceBeforeLoad, traceLoader } from '../chunk-MNP65ZX7.js';
 export { createTracedHeaders, extractContextFromRequest, getActiveContext, getCurrentSpanId, getCurrentTraceId, getTraceParent, getTraceState, injectContextToHeaders, runInContext } from '../chunk-DTZCOB4W.js';
 export { wrapStartHandler } from '../chunk-V3RO5N2M.js';
-export { assertSpanCreated, assertSpanHasAttribute, createTestCollector } from '../chunk-Z3MJ3GZ6.js';
+export { assertSpanCreated, assertSpanHasAttribute, createTestCollector } from '../chunk-ZJTHTWHJ.js';
 export { debugHeadersMiddleware } from '../chunk-JXO7H6KO.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/browser/testing.js

@@ -1,3 +1,3 @@
-export { assertSpanCreated, assertSpanHasAttribute, createTestCollector } from '../chunk-Z3MJ3GZ6.js';
+export { assertSpanCreated, assertSpanHasAttribute, createTestCollector, createTestSpansHandlers } from '../chunk-ZJTHTWHJ.js';
 //# sourceMappingURL=testing.js.map
 //# sourceMappingURL=testing.js.map

package/dist/chunk-ZJTHTWHJ.js

@@ -0,0 +1,34 @@
+// src/browser/testing.ts
+function createTestCollector() {
+  return {
+    getSpans: () => [],
+    getSpansByName: () => [],
+    clear: () => {
+    },
+    waitForSpans: async () => []
+  };
+}
+function assertSpanCreated(collector, name) {
+}
+function assertSpanHasAttribute(collector, name, key, value) {
+}
+function createTestSpansHandlers() {
+  return {
+    GET(_request) {
+      return Response.json(
+        { error: "createTestSpansHandlers is server-only" },
+        { status: 404 }
+      );
+    },
+    DELETE(_request) {
+      return Response.json(
+        { error: "createTestSpansHandlers is server-only" },
+        { status: 404 }
+      );
+    }
+  };
+}
+
+export { assertSpanCreated, assertSpanHasAttribute, createTestCollector, createTestSpansHandlers };
+//# sourceMappingURL=chunk-ZJTHTWHJ.js.map
+//# sourceMappingURL=chunk-ZJTHTWHJ.js.map

package/dist/chunk-ZJTHTWHJ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/browser/testing.ts"],"names":[],"mappings":";AA+BO,SAAS,mBAAA,GAAqC;AACnD,EAAA,OAAO;AAAA,IACL,QAAA,EAAU,MAAM,EAAC;AAAA,IACjB,cAAA,EAAgB,MAAM,EAAC;AAAA,IACvB,OAAO,MAAM;AAAA,IAAC,CAAA;AAAA,IACd,YAAA,EAAc,YAAY;AAAC,GAC7B;AACF;AAKO,SAAS,iBAAA,CACd,WACA,IAAA,EACM;AAIR;AAKO,SAAS,sBAAA,CACd,SAAA,EACA,IAAA,EACA,GAAA,EACA,KAAA,EACM;AAMR;AAmBO,SAAS,uBAAA,GAGd;AACA,EAAA,OAAO;AAAA,IACL,IAAI,QAAA,EAA6B;AAG/B,MAAA,OAAO,QAAA,CAAS,IAAA;AAAA,QACd,EAAE,OAAO,wCAAA,EAAyC;AAAA,QAClD,EAAE,QAAQ,GAAA;AAAI,OAChB;AAAA,IACF,CAAA;AAAA,IACA,OAAO,QAAA,EAA6B;AAGlC,MAAA,OAAO,QAAA,CAAS,IAAA;AAAA,QACd,EAAE,OAAO,wCAAA,EAAyC;AAAA,QAClD,EAAE,QAAQ,GAAA;AAAI,OAChB;AAAA,IACF;AAAA,GACF;AACF","file":"chunk-ZJTHTWHJ.js","sourcesContent":["/**\n * Browser stub for testing module\n *\n * Testing utilities are server-side only.\n * In browser, these return no-op implementations.\n */\n\n/**\n * Test span structure (stub)\n */\nexport interface TestSpan {\n  name: string;\n  attributes: Record<string, unknown>;\n  status: { code: number; message?: string };\n  events: Array<{ name: string; attributes?: Record<string, unknown> }>;\n  duration: number;\n}\n\n/**\n * Test collector structure (stub)\n */\nexport interface TestCollector {\n  getSpans(): TestSpan[];\n  getSpansByName(name: string): TestSpan[];\n  clear(): void;\n  waitForSpans(count: number, timeout?: number): Promise<TestSpan[]>;\n}\n\n/**\n * Browser stub: Returns empty collector\n */\nexport function createTestCollector(): TestCollector {\n  return {\n    getSpans: () => [],\n    getSpansByName: () => [],\n    clear: () => {},\n    waitForSpans: async () => [],\n  };\n}\n\n/**\n * Browser stub: No-op\n */\nexport function assertSpanCreated(\n  collector: TestCollector,\n  name: string,\n): void {\n  void collector;\n  void name;\n  // No-op in browser\n}\n\n/**\n * Browser stub: No-op\n */\nexport function assertSpanHasAttribute(\n  collector: TestCollector,\n  name: string,\n  key: string,\n  value?: unknown,\n): void {\n  void collector;\n  void name;\n  void key;\n  void value;\n  // No-op in browser\n}\n\n/**\n * Serialized span interface (browser stub - mirrors server SerializedSpan).\n */\nexport interface 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\n/**\n * Browser stub: test-spans handlers are server-only.\n * Returns no-op handlers that always return 404.\n */\nexport function createTestSpansHandlers(): {\n  GET: (request: Request) => Response;\n  DELETE: (request: Request) => Response;\n} {\n  return {\n    GET(_request: Request): Response {\n      // eslint-disable-next-line @typescript-eslint/no-unused-vars\n      void _request;\n      return Response.json(\n        { error: 'createTestSpansHandlers is server-only' },\n        { status: 404 },\n      );\n    },\n    DELETE(_request: Request): Response {\n      // eslint-disable-next-line @typescript-eslint/no-unused-vars\n      void _request;\n      return Response.json(\n        { error: 'createTestSpansHandlers is server-only' },\n        { status: 404 },\n      );\n    },\n  };\n}\n"]}

package/dist/testing.d.ts

@@ -124,5 +124,42 @@ declare function createMockRequest(method: string, path: string, options?: {
  * ```
  */
 declare function generateTraceparent(traceId?: string, spanId?: string): string;
+/**
+ * Serialized span shape returned by the test-spans HTTP endpoint.
+ * Mirrors the fields the Playwright side needs for assertions.
+ */
+interface SerializedSpan {
+    name: string;
+    spanId: string;
+    traceId: string;
+    parentSpanId?: string;
+    attributes?: Record<string, unknown>;
+    status: {
+        code: number;
+        message?: string;
+    };
+    durationMs: number;
+}
+/**
+ * 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).
+ *
+ * @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 } },
+ * });
+ * ```
+ */
+declare function createTestSpansHandlers(): {
+    GET: (request: Request) => Response;
+    DELETE: (request: Request) => Response;
+};
 
-export { type TestHarness, createMockRequest, createTestHarness, generateTraceparent };
+export { type SerializedSpan, type TestHarness, createMockRequest, createTestHarness, createTestSpansHandlers, generateTraceparent };

package/dist/testing.js

@@ -104,7 +104,58 @@ function generateHex(length) {
   }
   return result;
 }
+function getExporter() {
+  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;
+}
+function exporterGuard() {
+  if (!getExporter()) {
+    return Response.json(
+      { error: "in-memory span exporter not initialized" },
+      { status: 500 }
+    );
+  }
+  return null;
+}
+function createTestSpansHandlers() {
+  return {
+    GET(_request) {
+      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(_request) {
+      const guard = e2eGuard() ?? exporterGuard();
+      if (guard) return guard;
+      getExporter().reset();
+      return Response.json({ ok: true });
+    }
+  };
+}
 
-export { createMockRequest, createTestHarness, generateTraceparent };
+export { createMockRequest, createTestHarness, createTestSpansHandlers, 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"]}
+{"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 */\nexport interface 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 * 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 * @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 */\nexport function createTestSpansHandlers(): {\n  GET: (request: Request) => Response;\n  DELETE: (request: Request) => Response;\n} {\n  return {\n    GET(_request: Request): 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(_request: Request): Response {\n      const guard = e2eGuard() ?? exporterGuard();\n      if (guard) return guard;\n      getExporter()!.reset();\n      return Response.json({ ok: true });\n    },\n  };\n}\n"]}

package/package.json

@@ -1,11 +1,13 @@
 {
   "name": "autotel-tanstack",
-  "version": "1.13.4",
+  "version": "1.13.5",
   "description": "OpenTelemetry instrumentation for TanStack Start - automatic tracing for server functions, middleware, and route loaders",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
-  "sideEffects": false,
+  "sideEffects": [
+    "./dist/auto.js"
+  ],
   "exports": {
     ".": {
       "browser": {

package/src/auto.test.ts

@@ -0,0 +1,107 @@
+import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
+
+// Must mock before importing auto.ts (which runs at module level)
+const mockInit = vi.fn();
+const mockReset = vi.fn();
+const mockGetFinishedSpans = vi.fn(() => []);
+
+vi.mock('autotel', () => ({
+  init: mockInit,
+}));
+
+const mockExporterInstance = {
+  reset: mockReset,
+  getFinishedSpans: mockGetFinishedSpans,
+};
+// Use regular function (not arrow) so vi.fn() can be called with `new` in vitest 4.x
+const MockInMemorySpanExporter = vi.fn(function () {
+  return mockExporterInstance;
+});
+const MockSimpleSpanProcessor = vi.fn(function (exp: unknown) {
+  return { exporter: exp };
+});
+
+vi.mock('autotel/exporters', () => ({
+  InMemorySpanExporter: MockInMemorySpanExporter,
+}));
+
+vi.mock('autotel/processors', () => ({
+  SimpleSpanProcessor: MockSimpleSpanProcessor,
+}));
+
+describe('auto.ts E2E mode', () => {
+  const originalEnv = { ...process.env };
+
+  beforeEach(() => {
+    vi.resetModules();
+    mockInit.mockReset();
+    MockInMemorySpanExporter.mockClear();
+    MockSimpleSpanProcessor.mockClear();
+    delete (globalThis as Record<string, unknown>).__testSpanExporter;
+  });
+
+  afterEach(() => {
+    process.env = { ...originalEnv };
+  });
+
+  it('uses InMemorySpanExporter when E2E=1', async () => {
+    process.env.E2E = '1';
+    delete process.env.OTEL_EXPORTER_OTLP_ENDPOINT;
+    await import('./auto');
+    expect(MockInMemorySpanExporter).toHaveBeenCalledOnce();
+    expect(MockSimpleSpanProcessor).toHaveBeenCalledOnce();
+    expect(mockInit).toHaveBeenCalledWith(
+      expect.objectContaining({ spanProcessors: expect.any(Array) }),
+    );
+  });
+
+  it('sets globalThis.__testSpanExporter when E2E=1', async () => {
+    process.env.E2E = '1';
+    delete process.env.OTEL_EXPORTER_OTLP_ENDPOINT;
+    await import('./auto');
+    expect((globalThis as Record<string, unknown>).__testSpanExporter).toBe(
+      mockExporterInstance,
+    );
+  });
+
+  it('does not set __testSpanExporter in production mode', async () => {
+    delete process.env.E2E;
+    delete process.env.OTEL_EXPORTER_OTLP_ENDPOINT;
+    await import('./auto');
+    expect(
+      (globalThis as Record<string, unknown>).__testSpanExporter,
+    ).toBeUndefined();
+  });
+
+  // Skipped: constructing a second OTLP BatchSpanProcessor requires
+  // @opentelemetry/exporter-trace-otlp-http which is not available in
+  // autotel-tanstack's direct dependencies. The combined E2E+OTLP path
+  // is tested at the integration level instead.
+  it.skip('adds both InMemory and OTLP processors when E2E=1 and endpoint set', async () => {
+    process.env.E2E = '1';
+    process.env.OTEL_EXPORTER_OTLP_ENDPOINT = 'http://localhost:4318';
+    await import('./auto');
+    const call = mockInit.mock.calls[0][0] as { spanProcessors?: unknown[] };
+    expect(call.spanProcessors).toHaveLength(2);
+  });
+
+  it('passes endpoint and debug to init in production mode', async () => {
+    delete process.env.E2E;
+    process.env.OTEL_EXPORTER_OTLP_ENDPOINT = 'http://localhost:4318';
+    await import('./auto');
+    expect(mockInit).toHaveBeenCalledWith(
+      expect.objectContaining({
+        endpoint: 'http://localhost:4318',
+      }),
+    );
+  });
+
+  it('uses OTEL_SERVICE_NAME env var', async () => {
+    process.env.E2E = '1';
+    process.env.OTEL_SERVICE_NAME = 'my-e2e-app';
+    await import('./auto');
+    expect(mockInit).toHaveBeenCalledWith(
+      expect.objectContaining({ service: 'my-e2e-app' }),
+    );
+  });
+});

package/src/auto.ts

@@ -24,6 +24,8 @@
  */
 
 import { init } from 'autotel';
+import { InMemorySpanExporter } from 'autotel/exporters';
+import { SimpleSpanProcessor } from 'autotel/processors';
 
 // Parse service name
 const service = process.env.OTEL_SERVICE_NAME || 'tanstack-start';
@@ -55,19 +57,37 @@ function resolveDebug(): boolean | 'pretty' {
   return false;
 }
 
-// Initialize autotel
-init({
-  service,
-  endpoint,
-  headers,
-  debug: resolveDebug(),
-});
+// E2E mode: use InMemorySpanExporter so tests can capture and assert on spans.
+// When E2E=1, skip the normal OTLP path and use in-memory storage instead.
+// Note: combined E2E + OTLP (two processors) is handled at integration level
+// because constructing an OTLP processor requires deps not available here.
+if (process.env.E2E === '1') {
+  const e2eExporter = new InMemorySpanExporter();
+  const e2eProcessor = new SimpleSpanProcessor(e2eExporter);
+  (globalThis as Record<string, unknown>).__testSpanExporter = e2eExporter;
+
+  init({
+    service,
+    spanProcessors: [e2eProcessor],
+  });
+} else {
+  // Initialize autotel (production path — unchanged)
+  init({
+    service,
+    endpoint,
+    headers,
+    debug: resolveDebug(),
+  });
+}
 
 // Log initialization (only in development)
 if (process.env.NODE_ENV === 'development' || process.env.AUTOTEL_DEBUG) {
   console.log('[autotel-tanstack] Auto-initialized with:', {
     service,
-    endpoint: endpoint || '(not configured)',
+    endpoint:
+      process.env.E2E === '1'
+        ? '(E2E: in-memory)'
+        : endpoint || '(not configured)',
     hasHeaders: !!headers,
   });
 }

package/src/browser/testing.ts

@@ -65,3 +65,44 @@ export function assertSpanHasAttribute(
   void value;
   // No-op in browser
 }
+
+/**
+ * Serialized span interface (browser stub - mirrors server SerializedSpan).
+ */
+export interface SerializedSpan {
+  name: string;
+  spanId: string;
+  traceId: string;
+  parentSpanId?: string;
+  attributes?: Record<string, unknown>;
+  status: { code: number; message?: string };
+  durationMs: number;
+}
+
+/**
+ * Browser stub: test-spans handlers are server-only.
+ * Returns no-op handlers that always return 404.
+ */
+export function createTestSpansHandlers(): {
+  GET: (request: Request) => Response;
+  DELETE: (request: Request) => Response;
+} {
+  return {
+    GET(_request: Request): Response {
+      // eslint-disable-next-line @typescript-eslint/no-unused-vars
+      void _request;
+      return Response.json(
+        { error: 'createTestSpansHandlers is server-only' },
+        { status: 404 },
+      );
+    },
+    DELETE(_request: Request): Response {
+      // eslint-disable-next-line @typescript-eslint/no-unused-vars
+      void _request;
+      return Response.json(
+        { error: 'createTestSpansHandlers is server-only' },
+        { status: 404 },
+      );
+    },
+  };
+}

package/src/testing.test.ts

@@ -1,5 +1,10 @@
-import { describe, it, expect } from 'vitest';
-import { createMockRequest, generateTraceparent } from './testing';
+import { describe, it, expect, vi, beforeEach } from 'vitest';
+import {
+  createMockRequest,
+  generateTraceparent,
+  createTestSpansHandlers,
+  type SerializedSpan,
+} from './testing';
 
 describe('testing utilities', () => {
   describe('createMockRequest', () => {
@@ -70,3 +75,113 @@ describe('testing utilities', () => {
     });
   });
 });
+
+// Helper to read Response JSON
+async function json(res: Response): Promise<unknown> {
+  return res.json();
+}
+
+describe('createTestSpansHandlers', () => {
+  beforeEach(() => {
+    delete (globalThis as Record<string, unknown>).__testSpanExporter;
+    delete process.env.E2E;
+  });
+
+  it('GET returns 404 when not in E2E mode', async () => {
+    const { GET } = createTestSpansHandlers();
+    const res = GET(new Request('http://localhost/api/test-spans'));
+    expect(res.status).toBe(404);
+  });
+
+  it('GET returns 500 when exporter not initialized', async () => {
+    process.env.E2E = '1';
+    const { GET } = createTestSpansHandlers();
+    const res = GET(new Request('http://localhost/api/test-spans'));
+    expect(res.status).toBe(500);
+  });
+
+  it('GET returns serialized spans', async () => {
+    process.env.E2E = '1';
+    const mockSpan = {
+      name: 'sendMoney.handler',
+      spanContext: () => ({ spanId: 'abc123', traceId: 'trace456' }),
+      parentSpanContext: { spanId: 'parent789' },
+      attributes: { 'transfer.amount': 100 },
+      status: { code: 0 },
+      duration: [0, 500_000_000], // 500ms in [seconds, nanoseconds]
+    };
+    (globalThis as Record<string, unknown>).__testSpanExporter = {
+      getFinishedSpans: () => [mockSpan],
+      reset: () => {},
+    };
+
+    const { GET } = createTestSpansHandlers();
+    const res = GET(new Request('http://localhost/api/test-spans'));
+    expect(res.status).toBe(200);
+    const body = (await json(res)) as { spans: SerializedSpan[] };
+    expect(body.spans).toHaveLength(1);
+    expect(body.spans[0].name).toBe('sendMoney.handler');
+    expect(body.spans[0].spanId).toBe('abc123');
+    expect(body.spans[0].traceId).toBe('trace456');
+    expect(body.spans[0].parentSpanId).toBe('parent789');
+    expect(body.spans[0].attributes?.['transfer.amount']).toBe(100);
+    expect(body.spans[0].durationMs).toBeCloseTo(500, 0);
+  });
+
+  it('GET omits parentSpanId when no parent', async () => {
+    process.env.E2E = '1';
+    const mockSpan = {
+      name: 'root',
+      spanContext: () => ({ spanId: 'abc123', traceId: 'trace456' }),
+      parentSpanContext: undefined,
+      attributes: {},
+      status: { code: 0 },
+      duration: [0, 0],
+    };
+    (globalThis as Record<string, unknown>).__testSpanExporter = {
+      getFinishedSpans: () => [mockSpan],
+      reset: () => {},
+    };
+
+    const { GET } = createTestSpansHandlers();
+    const body = (await json(
+      GET(new Request('http://localhost/api/test-spans')),
+    )) as { spans: SerializedSpan[] };
+    expect(body.spans[0].parentSpanId).toBeUndefined();
+  });
+
+  it('DELETE returns 404 when not in E2E mode', async () => {
+    const { DELETE } = createTestSpansHandlers();
+    const res = DELETE(
+      new Request('http://localhost/api/test-spans', { method: 'DELETE' }),
+    );
+    expect(res.status).toBe(404);
+  });
+
+  it('DELETE returns 500 when exporter not initialized', async () => {
+    process.env.E2E = '1';
+    const { DELETE } = createTestSpansHandlers();
+    const res = DELETE(
+      new Request('http://localhost/api/test-spans', { method: 'DELETE' }),
+    );
+    expect(res.status).toBe(500);
+  });
+
+  it('DELETE resets exporter and returns ok', async () => {
+    process.env.E2E = '1';
+    const reset = vi.fn();
+    (globalThis as Record<string, unknown>).__testSpanExporter = {
+      getFinishedSpans: () => [],
+      reset,
+    };
+
+    const { DELETE } = createTestSpansHandlers();
+    const res = DELETE(
+      new Request('http://localhost/api/test-spans', { method: 'DELETE' }),
+    );
+    expect(res.status).toBe(200);
+    expect(reset).toHaveBeenCalledOnce();
+    const body = (await json(res)) as { ok: boolean };
+    expect(body.ok).toBe(true);
+  });
+});

package/src/testing.ts

@@ -274,3 +274,111 @@ function generateHex(length: number): string {
   }
   return result;
 }
+
+/**
+ * Serialized span shape returned by the test-spans HTTP endpoint.
+ * Mirrors the fields the Playwright side needs for assertions.
+ */
+export interface SerializedSpan {
+  name: string;
+  spanId: string;
+  traceId: string;
+  parentSpanId?: string;
+  attributes?: Record<string, unknown>;
+  status: { code: number; message?: string };
+  durationMs: number;
+}
+
+interface TestSpanExporter {
+  getFinishedSpans(): Array<{
+    name: string;
+    spanContext(): { spanId: string; traceId: string };
+    parentSpanContext?: { spanId: string };
+    attributes: Record<string, unknown>;
+    status: { code: number; message?: string };
+    duration: [number, number];
+  }>;
+  reset(): void;
+}
+
+function getExporter(): TestSpanExporter | undefined {
+  return (globalThis as Record<string, unknown>).__testSpanExporter as
+    | TestSpanExporter
+    | undefined;
+}
+
+function e2eGuard(): Response | null {
+  if (process.env.E2E !== '1') {
+    return Response.json(
+      { error: 'test-spans endpoint only available in E2E mode' },
+      { status: 404 },
+    );
+  }
+  return null;
+}
+
+function exporterGuard(): Response | 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).
+ *
+ * @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 } },
+ * });
+ * ```
+ */
+export function createTestSpansHandlers(): {
+  GET: (request: Request) => Response;
+  DELETE: (request: Request) => Response;
+} {
+  return {
+    GET(_request: Request): Response {
+      const guard = e2eGuard() ?? exporterGuard();
+      if (guard) return guard;
+
+      const spans: SerializedSpan[] = getExporter()!
+        .getFinishedSpans()
+        .map((span) => {
+          const { spanId, traceId } = span.spanContext();
+          const serialized: SerializedSpan = {
+            name: span.name,
+            spanId,
+            traceId,
+            attributes: span.attributes,
+            status: span.status,
+            durationMs: span.duration[0] * 1000 + span.duration[1] / 1_000_000,
+          };
+          if (span.parentSpanContext?.spanId) {
+            serialized.parentSpanId = span.parentSpanContext.spanId;
+          }
+          return serialized;
+        });
+
+      return Response.json({ spans });
+    },
+
+    DELETE(_request: Request): Response {
+      const guard = e2eGuard() ?? exporterGuard();
+      if (guard) return guard;
+      getExporter()!.reset();
+      return Response.json({ ok: true });
+    },
+  };
+}

package/dist/chunk-Z3MJ3GZ6.js

@@ -1,18 +0,0 @@
-// src/browser/testing.ts
-function createTestCollector() {
-  return {
-    getSpans: () => [],
-    getSpansByName: () => [],
-    clear: () => {
-    },
-    waitForSpans: async () => []
-  };
-}
-function assertSpanCreated(collector, name) {
-}
-function assertSpanHasAttribute(collector, name, key, value) {
-}
-
-export { assertSpanCreated, assertSpanHasAttribute, createTestCollector };
-//# sourceMappingURL=chunk-Z3MJ3GZ6.js.map
-//# sourceMappingURL=chunk-Z3MJ3GZ6.js.map

package/dist/chunk-Z3MJ3GZ6.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/browser/testing.ts"],"names":[],"mappings":";AA+BO,SAAS,mBAAA,GAAqC;AACnD,EAAA,OAAO;AAAA,IACL,QAAA,EAAU,MAAM,EAAC;AAAA,IACjB,cAAA,EAAgB,MAAM,EAAC;AAAA,IACvB,OAAO,MAAM;AAAA,IAAC,CAAA;AAAA,IACd,YAAA,EAAc,YAAY;AAAC,GAC7B;AACF;AAKO,SAAS,iBAAA,CACd,WACA,IAAA,EACM;AAIR;AAKO,SAAS,sBAAA,CACd,SAAA,EACA,IAAA,EACA,GAAA,EACA,KAAA,EACM;AAMR","file":"chunk-Z3MJ3GZ6.js","sourcesContent":["/**\n * Browser stub for testing module\n *\n * Testing utilities are server-side only.\n * In browser, these return no-op implementations.\n */\n\n/**\n * Test span structure (stub)\n */\nexport interface TestSpan {\n  name: string;\n  attributes: Record<string, unknown>;\n  status: { code: number; message?: string };\n  events: Array<{ name: string; attributes?: Record<string, unknown> }>;\n  duration: number;\n}\n\n/**\n * Test collector structure (stub)\n */\nexport interface TestCollector {\n  getSpans(): TestSpan[];\n  getSpansByName(name: string): TestSpan[];\n  clear(): void;\n  waitForSpans(count: number, timeout?: number): Promise<TestSpan[]>;\n}\n\n/**\n * Browser stub: Returns empty collector\n */\nexport function createTestCollector(): TestCollector {\n  return {\n    getSpans: () => [],\n    getSpansByName: () => [],\n    clear: () => {},\n    waitForSpans: async () => [],\n  };\n}\n\n/**\n * Browser stub: No-op\n */\nexport function assertSpanCreated(\n  collector: TestCollector,\n  name: string,\n): void {\n  void collector;\n  void name;\n  // No-op in browser\n}\n\n/**\n * Browser stub: No-op\n */\nexport function assertSpanHasAttribute(\n  collector: TestCollector,\n  name: string,\n  key: string,\n  value?: unknown,\n): void {\n  void collector;\n  void name;\n  void key;\n  void value;\n  // No-op in browser\n}\n"]}