autotel-tanstack 1.4.0 → 1.4.2

package/README.md

@@ -1,11 +1,11 @@
 # autotel-tanstack
 
-OpenTelemetry instrumentation for TanStack Start applications. Automatic tracing for server functions, middleware, and route loaders.
+OpenTelemetry instrumentation for TanStack Start applications. Automatic tracing for server functions, middleware, and route loaders using TanStack's native patterns.
 
 ## Features
 
-- **Zero-Config Option** - Just import `autotel-tanstack/auto` and you're done
-- **Framework-Aligned API** - Uses TanStack's middleware patterns
+- **TanStack-Native** - Uses `createMiddleware().server()` builder pattern
+- **Zero Boilerplate** - Global middleware traces all server functions automatically
 - **Full Coverage** - Server functions, loaders, beforeLoad, HTTP requests
 - **Tree-Shakeable** - Only bundle what you use
 - **Type-Safe** - Full TypeScript support
@@ -17,91 +17,120 @@ OpenTelemetry instrumentation for TanStack Start applications. Automatic tracing
 npm install autotel-tanstack autotel
 # or
 pnpm add autotel-tanstack autotel
-# or
-yarn add autotel-tanstack autotel
 ```
 
 ## Quick Start
 
-### Option 1: Zero-Config (Recommended)
+### TanStack-Native Setup (Recommended)
+
+Configure global middleware in `start.ts` using TanStack's native patterns:
 
 ```typescript
-// app/start.ts (React) or app/start.ts (Solid)
-import 'autotel-tanstack/auto';
-import { createStart } from '@tanstack/react-start';
+// src/start.ts
+import { createStart, createMiddleware } from '@tanstack/react-start';
+import { createTracingServerHandler } from 'autotel-tanstack/middleware';
+import './instrumentation'; // Initialize autotel
+
+// Global request tracing middleware
+const requestTracingMiddleware = createMiddleware().server(
+  createTracingServerHandler({
+    captureHeaders: ['x-request-id', 'user-agent'],
+    excludePaths: ['/health', '/metrics'],
+  }),
+);
 
-// Set env vars: OTEL_SERVICE_NAME, OTEL_EXPORTER_OTLP_ENDPOINT
-export const startInstance = createStart(() => ({}));
-```
+// Global server function tracing middleware
+const functionTracingMiddleware = createMiddleware({ type: 'function' }).server(
+  createTracingServerHandler({
+    type: 'function',
+    captureArgs: true,
+  }),
+);
 
-### Option 2: Middleware-Based
+export const startInstance = createStart(() => ({
+  requestMiddleware: [requestTracingMiddleware],
+  functionMiddleware: [functionTracingMiddleware],
+}));
+```
 
 ```typescript
-// app/start.ts
-import { createStart } from '@tanstack/react-start';
-import { tracingMiddleware } from 'autotel-tanstack/middleware';
+// src/instrumentation.ts
 import { init } from 'autotel';
 
-// Initialize autotel
 init({
   service: 'my-app',
-  endpoint: 'https://api.honeycomb.io',
-  headers: { 'x-honeycomb-team': process.env.HONEYCOMB_API_KEY },
+  endpoint: process.env.OTEL_EXPORTER_OTLP_ENDPOINT,
 });
-
-export const startInstance = createStart(() => ({
-  requestMiddleware: [tracingMiddleware()],
-}));
 ```
 
-### Option 3: Handler Wrapper (Full Control)
+That's it! All server functions and requests are now automatically traced.
+
+### Zero-Config Alternative
+
+For quick setup using environment variables:
 
 ```typescript
-// server.ts
-import {
-  createStartHandler,
-  defaultStreamHandler,
-} from '@tanstack/react-start/server';
-import { wrapStartHandler } from 'autotel-tanstack/handlers';
+// src/start.ts
+import 'autotel-tanstack/auto';
+import { createStart } from '@tanstack/react-start';
 
-export default wrapStartHandler({
-  service: 'my-app',
-  endpoint: process.env.OTEL_EXPORTER_OTLP_ENDPOINT,
-  headers: { 'x-honeycomb-team': process.env.HONEYCOMB_API_KEY },
-})(createStartHandler(defaultStreamHandler));
+// Set env vars: OTEL_SERVICE_NAME, OTEL_EXPORTER_OTLP_ENDPOINT
+export const startInstance = createStart(() => ({}));
 ```
 
 ## Usage
 
-### Tracing Server Functions
+### Server Functions (Auto-Traced)
+
+With global `functionMiddleware` configured in `start.ts`, server functions are automatically traced:
 
 ```typescript
 import { createServerFn } from '@tanstack/react-start';
-import { functionTracingMiddleware } from 'autotel-tanstack/middleware';
 
-// Using middleware (recommended)
-export const getUser = createServerFn({ method: 'GET' })
-  .middleware([functionTracingMiddleware()])
-  .handler(async ({ data: id }) => {
+// Automatically traced - no middleware needed per-function!
+export const getUser = createServerFn({ method: 'GET' }).handler(
+  async ({ data: id }) => {
     return await db.users.findUnique({ where: { id } });
+  },
+);
+
+export const createUser = createServerFn({ method: 'POST' })
+  .inputValidator((d: UserInput) => d)
+  .handler(async ({ data }) => {
+    return await db.users.create({ data });
   });
+```
 
-// Or using explicit wrapper
-import { traceServerFn } from 'autotel-tanstack/server-functions';
+### Per-Function Middleware (When Needed)
 
-const getUserBase = createServerFn({ method: 'GET' }).handler(
-  async ({ data: id }) => {
-    return await db.users.findUnique({ where: { id } });
-  },
+For function-specific middleware, use TanStack's `.middleware()` chaining:
+
+```typescript
+import { createServerFn, createMiddleware } from '@tanstack/react-start';
+import { createTracingServerHandler } from 'autotel-tanstack/middleware';
+
+// Custom middleware for this function only
+const customTracing = createMiddleware({ type: 'function' }).server(
+  createTracingServerHandler({
+    type: 'function',
+    captureArgs: true,
+    captureResults: true, // Capture results for this specific function
+  }),
 );
 
-export const getUser = traceServerFn(getUserBase, { name: 'getUser' });
+export const sensitiveOperation = createServerFn({ method: 'POST' })
+  .middleware([customTracing])
+  .handler(async ({ data }) => {
+    // ...
+  });
 ```
 
-### Tracing Route Loaders
+### Route Loaders
+
+Use `traceLoader` and `traceBeforeLoad` for route-level tracing:
 
 ```typescript
-import { createFileRoute } from '@tanstack/react-router';
+import { createFileRoute, redirect } from '@tanstack/react-router';
 import { traceLoader, traceBeforeLoad } from 'autotel-tanstack/loaders';
 
 export const Route = createFileRoute('/users/$userId')({
@@ -116,32 +145,14 @@ export const Route = createFileRoute('/users/$userId')({
 });
 ```
 
-### Using createTracedRoute Helper
-
-```typescript
-import { createFileRoute } from '@tanstack/react-router';
-import { createTracedRoute } from 'autotel-tanstack/loaders';
-
-const traced = createTracedRoute('/users/$userId');
-
-export const Route = createFileRoute('/users/$userId')({
-  beforeLoad: traced.beforeLoad(async ({ context }) => {
-    // Auth check
-  }),
-  loader: traced.loader(async ({ params }) => {
-    return await getUser(params.userId);
-  }),
-});
-```
-
 ## Configuration
 
-### Middleware Configuration
+### createTracingServerHandler Options
 
 ```typescript
-import { createTracingMiddleware } from 'autotel-tanstack/middleware';
+import { createTracingServerHandler } from 'autotel-tanstack/middleware';
 
-const middleware = createTracingMiddleware({
+const handler = createTracingServerHandler({
   // Type: 'request' for global middleware, 'function' for server functions
   type: 'request',
 
@@ -167,27 +178,6 @@ const middleware = createTracingMiddleware({
 });
 ```
 
-### Handler Configuration
-
-```typescript
-import { wrapStartHandler } from 'autotel-tanstack/handlers';
-
-const handler = wrapStartHandler({
-  // Service name (default: OTEL_SERVICE_NAME or 'tanstack-start')
-  service: 'my-app',
-
-  // OTLP endpoint (default: OTEL_EXPORTER_OTLP_ENDPOINT)
-  endpoint: 'https://api.honeycomb.io',
-
-  // OTLP headers (default: parsed from OTEL_EXPORTER_OTLP_HEADERS)
-  headers: { 'x-honeycomb-team': 'YOUR_API_KEY' },
-
-  // All middleware config options also available
-  captureHeaders: ['x-request-id'],
-  excludePaths: ['/health'],
-});
-```
-
 ## Environment Variables
 
 | Variable                      | Description                        | Example                     |
@@ -221,51 +211,6 @@ const handler = wrapStartHandler({
 - `tanstack.loader.type` - "loader" or "beforeLoad"
 - `tanstack.loader.params` - Route params (if enabled)
 
-## Testing
-
-```typescript
-import { describe, it, beforeEach, afterEach } 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',
-    );
-  });
-});
-```
-
-### Mock Utilities
-
-```typescript
-import {
-  createMockRequest,
-  generateTraceparent,
-} from 'autotel-tanstack/testing';
-
-// Create mock request
-const request = createMockRequest('GET', '/api/users', {
-  headers: { 'x-request-id': 'test-123' },
-  traceparent: generateTraceparent(),
-});
-```
-
 ## Context Propagation
 
 For distributed tracing across services:
@@ -284,6 +229,25 @@ await fetch('https://api.example.com', { headers, method: 'POST', body });
 const parentContext = extractContextFromRequest(request);
 ```
 
+## Testing
+
+```typescript
+import { describe, it, expect } from 'vitest';
+import { createTestCollector } from 'autotel-tanstack/testing';
+
+describe('MyServerFunction', () => {
+  it('should trace the server function', async () => {
+    const collector = createTestCollector();
+
+    await myServerFunction({ id: '123' });
+
+    const spans = collector.getSpans();
+    expect(spans).toHaveLength(1);
+    expect(spans[0].name).toContain('myServerFunction');
+  });
+});
+```
+
 ## Supported Frameworks
 
 - **@tanstack/react-start** ^1.139.14

package/dist/auto.js

@@ -1,4 +1,4 @@
-export { functionTracingMiddleware, tracingMiddleware } from './chunk-OLBHLVLE.js';
+export { functionTracingMiddleware, tracingMiddleware } from './chunk-ETD6SGPH.js';
 export { traceServerFn } from './chunk-TNOQTZ3N.js';
 export { traceBeforeLoad, traceLoader } from './chunk-HKM7LMO6.js';
 import './chunk-EUYFVNYE.js';

package/dist/browser/index.js

@@ -1,7 +1,7 @@
 export { createMetricsHandler, getMetrics, metricsCollector, recordError, recordTiming, resetMetrics } from '../chunk-UMEJU65Q.js';
 export { clearErrors, createErrorReportingHandler, getRecentErrors, reportError, withErrorReporting } from '../chunk-HIQYW2HB.js';
 export { DEFAULT_CONFIG, SPAN_ATTRIBUTES } from '../chunk-MFYOV2SF.js';
-export { createTracingMiddleware, functionTracingMiddleware, tracingMiddleware } from '../chunk-4C7T5ZIM.js';
+export { createTracingMiddleware, createTracingServerHandler, functionTracingMiddleware, tracingMiddleware } from '../chunk-A7WMQ2BC.js';
 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';

package/dist/browser/middleware.js

@@ -1,3 +1,3 @@
-export { createTracingMiddleware, functionTracingMiddleware, tracingMiddleware } from '../chunk-4C7T5ZIM.js';
+export { createTracingMiddleware, createTracingServerHandler, functionTracingMiddleware, tracingMiddleware } from '../chunk-A7WMQ2BC.js';
 //# sourceMappingURL=middleware.js.map
 //# sourceMappingURL=middleware.js.map

package/dist/{chunk-4C7T5ZIM.js → chunk-A7WMQ2BC.js}

@@ -14,7 +14,12 @@ function functionTracingMiddleware(config) {
     return opts.next();
   };
 }
+function createTracingServerHandler(config) {
+  return async function noopHandler(opts) {
+    return opts.next();
+  };
+}
 
-export { createTracingMiddleware, functionTracingMiddleware, tracingMiddleware };
-//# sourceMappingURL=chunk-4C7T5ZIM.js.map
-//# sourceMappingURL=chunk-4C7T5ZIM.js.map
+export { createTracingMiddleware, createTracingServerHandler, functionTracingMiddleware, tracingMiddleware };
+//# sourceMappingURL=chunk-A7WMQ2BC.js.map
+//# sourceMappingURL=chunk-A7WMQ2BC.js.map

package/dist/chunk-A7WMQ2BC.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/browser/middleware.ts"],"names":[],"mappings":";AA6BO,SAAS,wBACd,MAAA,EAC6B;AAE7B,EAAA,OAAO,eAAe,eAAe,IAAA,EAAM;AACzC,IAAA,OAAO,KAAK,IAAA,EAAK;AAAA,EACnB,CAAA;AACF;AAKO,SAAS,kBACd,MAAA,EAC6B;AAE7B,EAAA,OAAO,eAAe,eAAe,IAAA,EAAM;AACzC,IAAA,OAAO,KAAK,IAAA,EAAK;AAAA,EACnB,CAAA;AACF;AAKO,SAAS,0BACd,MAAA,EAC6B;AAE7B,EAAA,OAAO,eAAe,eAAe,IAAA,EAAM;AACzC,IAAA,OAAO,KAAK,IAAA,EAAK;AAAA,EACnB,CAAA;AACF;AAKO,SAAS,2BACd,MAAA,EAKsB;AAEtB,EAAA,OAAO,eAAe,YAAY,IAAA,EAAM;AACtC,IAAA,OAAO,KAAK,IAAA,EAAK;AAAA,EACnB,CAAA;AACF","file":"chunk-A7WMQ2BC.js","sourcesContent":["/**\n * Browser stub for middleware module\n *\n * In browser environments, these functions return pass-through middleware\n * that just calls next() without any tracing overhead.\n */\n\nimport type { TracingMiddlewareConfig } from './types';\n\n/**\n * Generic middleware handler type\n */\nexport interface MiddlewareHandler<TContext = unknown> {\n  (opts: {\n    next: (ctx?: Partial<TContext>) => Promise<TContext>;\n    context: TContext;\n    request?: Request;\n    pathname?: string;\n    data?: unknown;\n    method?: string;\n    filename?: string;\n    functionId?: string;\n    signal?: AbortSignal;\n  }): Promise<TContext>;\n}\n\n/**\n * Browser stub: Returns pass-through middleware\n */\nexport function createTracingMiddleware<TContext = unknown>(\n  config?: TracingMiddlewareConfig,\n): MiddlewareHandler<TContext> {\n  void config;\n  return async function noopMiddleware(opts) {\n    return opts.next();\n  };\n}\n\n/**\n * Browser stub: Returns pass-through middleware\n */\nexport function tracingMiddleware<TContext = unknown>(\n  config?: TracingMiddlewareConfig,\n): MiddlewareHandler<TContext> {\n  void config;\n  return async function noopMiddleware(opts) {\n    return opts.next();\n  };\n}\n\n/**\n * Browser stub: Returns pass-through middleware\n */\nexport function functionTracingMiddleware<TContext = unknown>(\n  config?: Omit<TracingMiddlewareConfig, 'type'>,\n): MiddlewareHandler<TContext> {\n  void config;\n  return async function noopMiddleware(opts) {\n    return opts.next();\n  };\n}\n\n/**\n * Browser stub: Returns pass-through handler for createMiddleware().server()\n */\nexport function createTracingServerHandler<TContext = unknown>(\n  config?: TracingMiddlewareConfig,\n): (opts: {\n  next: (ctx?: Partial<TContext>) => Promise<TContext>;\n  context: TContext;\n  request?: Request;\n}) => Promise<TContext> {\n  void config;\n  return async function noopHandler(opts) {\n    return opts.next();\n  };\n}\n"]}

package/dist/{chunk-OLBHLVLE.js → chunk-ETD6SGPH.js}

@@ -214,7 +214,13 @@ function functionTracingMiddleware(config) {
     type: "function"
   });
 }
+function createTracingServerHandler(config) {
+  const handler = createTracingMiddleware(config);
+  return async (opts) => {
+    return handler(opts);
+  };
+}
 
-export { createTracingMiddleware, functionTracingMiddleware, tracingMiddleware };
-//# sourceMappingURL=chunk-OLBHLVLE.js.map
-//# sourceMappingURL=chunk-OLBHLVLE.js.map
+export { createTracingMiddleware, createTracingServerHandler, functionTracingMiddleware, tracingMiddleware };
+//# sourceMappingURL=chunk-ETD6SGPH.js.map
+//# sourceMappingURL=chunk-ETD6SGPH.js.map

package/dist/chunk-ETD6SGPH.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/middleware.ts"],"names":["tracingMiddleware"],"mappings":"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","file":"chunk-ETD6SGPH.js","sourcesContent":["import { context, SpanStatusCode, type Attributes } from '@opentelemetry/api';\nimport { trace, type TraceContext } from 'autotel';\nimport { extractContextFromRequest } from './context';\nimport { isServerSide } from './env';\nimport {\n  type TracingMiddlewareConfig,\n  DEFAULT_CONFIG,\n  SPAN_ATTRIBUTES,\n} from './types';\n\n/**\n * Check if a path should be excluded from tracing\n */\nfunction shouldExcludePath(\n  pathname: string,\n  excludePaths: (string | RegExp)[],\n): boolean {\n  for (const pattern of excludePaths) {\n    if (typeof pattern === 'string') {\n      // Simple glob matching\n      if (pattern.includes('*')) {\n        const regex = new RegExp(\n          '^' + pattern.replaceAll('*', '.*').replaceAll('?', '.') + '$',\n        );\n        if (regex.test(pathname)) return true;\n      } else {\n        if (pathname === pattern || pathname.startsWith(pattern)) return true;\n      }\n    } else {\n      if (pattern.test(pathname)) return true;\n    }\n  }\n  return false;\n}\n\n/**\n * Build span attributes for HTTP requests\n */\nfunction buildRequestAttributes(\n  request: Request,\n  config: Required<\n    Omit<TracingMiddlewareConfig, 'customAttributes' | 'service' | 'type'>\n  >,\n): Attributes {\n  const url = new URL(request.url);\n  const attrs: Attributes = {\n    [SPAN_ATTRIBUTES.HTTP_REQUEST_METHOD]: request.method,\n    [SPAN_ATTRIBUTES.URL_PATH]: url.pathname,\n    [SPAN_ATTRIBUTES.TANSTACK_TYPE]: 'request',\n  };\n\n  if (url.search) {\n    attrs[SPAN_ATTRIBUTES.URL_QUERY] = url.search;\n  }\n\n  // Capture configured headers\n  if (config.captureHeaders) {\n    for (const header of config.captureHeaders) {\n      const value = request.headers.get(header);\n      if (value) {\n        attrs[`http.request.header.${header.toLowerCase()}`] = value;\n      }\n    }\n  }\n\n  return attrs;\n}\n\n/**\n * Build span attributes for server functions\n */\nfunction buildServerFnAttributes(\n  functionName: string,\n  method: string,\n  args: unknown,\n  config: Required<\n    Omit<TracingMiddlewareConfig, 'customAttributes' | 'service' | 'type'>\n  >,\n): Attributes {\n  const attrs: Attributes = {\n    [SPAN_ATTRIBUTES.RPC_SYSTEM]: 'tanstack-start',\n    [SPAN_ATTRIBUTES.RPC_METHOD]: functionName,\n    [SPAN_ATTRIBUTES.TANSTACK_TYPE]: 'serverFn',\n    [SPAN_ATTRIBUTES.TANSTACK_SERVER_FN_NAME]: functionName,\n    [SPAN_ATTRIBUTES.TANSTACK_SERVER_FN_METHOD]: method,\n  };\n\n  if (config.captureArgs && args !== undefined) {\n    try {\n      attrs[SPAN_ATTRIBUTES.TANSTACK_SERVER_FN_ARGS] = JSON.stringify(args);\n    } catch {\n      attrs[SPAN_ATTRIBUTES.TANSTACK_SERVER_FN_ARGS] = '[non-serializable]';\n    }\n  }\n\n  return attrs;\n}\n\n/**\n * Generic middleware handler type (compatible with TanStack's middleware pattern)\n *\n * This type represents the shape of TanStack middleware handlers.\n * We use a generic type to avoid direct dependency on TanStack packages.\n */\nexport interface MiddlewareHandler<TContext = unknown> {\n  (opts: {\n    next: (ctx?: Partial<TContext>) => Promise<TContext>;\n    context: TContext;\n    request?: Request;\n    pathname?: string;\n    data?: unknown;\n    method?: string;\n    filename?: string;\n    functionId?: string;\n    signal?: AbortSignal;\n  }): Promise<TContext>;\n}\n\n/**\n * Create a TanStack-compatible tracing middleware\n *\n * This creates middleware that automatically traces all requests/server functions\n * with OpenTelemetry spans. Use with TanStack Start's middleware system.\n *\n * @param config - Configuration options\n * @returns Middleware handler compatible with TanStack Start\n *\n * @example\n * ```typescript\n * // Global request middleware in app/start.ts\n * import { createStart } from '@tanstack/react-start';\n * import { createTracingMiddleware } from 'autotel-tanstack/middleware';\n *\n * export const startInstance = createStart(() => ({\n *   requestMiddleware: [\n *     createTracingMiddleware({\n *       captureHeaders: ['x-request-id', 'user-agent'],\n *       excludePaths: ['/health', '/metrics'],\n *     }),\n *   ],\n * }));\n * ```\n *\n * @example\n * ```typescript\n * // Server function middleware\n * import { createServerFn } from '@tanstack/react-start';\n * import { createTracingMiddleware } from 'autotel-tanstack/middleware';\n *\n * export const getUser = createServerFn({ method: 'GET' })\n *   .middleware([createTracingMiddleware({ type: 'function' })])\n *   .handler(async ({ data: id }) => {\n *     return await db.users.findUnique({ where: { id } });\n *   });\n * ```\n */\nexport function createTracingMiddleware<TContext = unknown>(\n  config?: TracingMiddlewareConfig,\n): MiddlewareHandler<TContext> {\n  const mergedConfig = {\n    ...DEFAULT_CONFIG,\n    ...config,\n    type: config?.type ?? 'request',\n  };\n\n  return async function tracingMiddleware(opts) {\n    // If we're in the browser, return a no-op middleware\n    // This prevents autotel (which uses Node.js APIs) from being bundled/executed in the browser\n    if (!isServerSide()) {\n      return opts.next();\n    }\n    const { next, request, pathname, data, functionId } = opts;\n\n    // For function middleware\n    if (mergedConfig.type === 'function') {\n      const fnName = functionId || 'unknown';\n      const method = (opts as { method?: string }).method || 'POST';\n\n      return trace(`tanstack.serverFn.${fnName}`, async (ctx: TraceContext) => {\n        const attrs = buildServerFnAttributes(\n          fnName,\n          method,\n          data,\n          mergedConfig,\n        );\n        ctx.setAttributes(attrs as Record<string, string | number | boolean>);\n\n        // Add custom attributes if provided\n        if (config?.customAttributes) {\n          const customAttrs = config.customAttributes({\n            type: 'serverFn',\n            name: fnName,\n            args: data,\n          });\n          ctx.setAttributes(\n            customAttrs as Record<string, string | number | boolean>,\n          );\n        }\n\n        try {\n          const result = await next();\n\n          // Capture result if configured\n          if (mergedConfig.captureResults && result !== undefined) {\n            try {\n              ctx.setAttribute(\n                SPAN_ATTRIBUTES.TANSTACK_SERVER_FN_RESULT,\n                JSON.stringify(result),\n              );\n            } catch {\n              ctx.setAttribute(\n                SPAN_ATTRIBUTES.TANSTACK_SERVER_FN_RESULT,\n                '[non-serializable]',\n              );\n            }\n          }\n\n          ctx.setStatus({ code: SpanStatusCode.OK });\n          return result;\n        } catch (error) {\n          if (mergedConfig.captureErrors) {\n            ctx.recordException(error as Error);\n            ctx.setStatus({\n              code: SpanStatusCode.ERROR,\n              message: (error as Error).message,\n            });\n\n            // Report error to error store\n            try {\n              const { reportError } = await import('./error-reporting');\n              reportError(error as Error, {\n                type: 'serverFn',\n                name: fnName,\n                method,\n              });\n            } catch {\n              // Error reporting not available, skip\n            }\n          }\n          throw error;\n        }\n      }) as Promise<TContext>;\n    }\n\n    // For request middleware\n    if (!request) {\n      // No request available, just pass through\n      return next();\n    }\n\n    const url = new URL(request.url);\n\n    // Check if path should be excluded\n    if (shouldExcludePath(url.pathname, mergedConfig.excludePaths)) {\n      return next();\n    }\n\n    // Extract parent context from request headers\n    const parentContext = extractContextFromRequest(request);\n\n    // Run within parent context for distributed tracing\n    return context.with(parentContext, async () => {\n      const spanName = `${request.method} ${pathname || url.pathname}`;\n\n      return trace(spanName, async (ctx: TraceContext) => {\n        const attrs = buildRequestAttributes(request, mergedConfig);\n        ctx.setAttributes(attrs as Record<string, string | number | boolean>);\n\n        // Add custom attributes if provided\n        if (config?.customAttributes) {\n          const customAttrs = config.customAttributes({\n            type: 'request',\n            name: spanName,\n            request,\n          });\n          ctx.setAttributes(\n            customAttrs as Record<string, string | number | boolean>,\n          );\n        }\n\n        const startTime = Date.now();\n\n        try {\n          const result = await next();\n\n          const duration = Date.now() - startTime;\n          ctx.setAttribute(\n            SPAN_ATTRIBUTES.TANSTACK_REQUEST_DURATION_MS,\n            duration,\n          );\n\n          // Record timing in metrics collector\n          try {\n            const { metricsCollector } = await import('./metrics');\n            metricsCollector.recordTiming(spanName, duration);\n          } catch {\n            // Metrics not available, skip\n          }\n\n          // Try to get response status from result if it's a Response\n          if (result && typeof result === 'object' && 'status' in result) {\n            ctx.setAttribute(\n              SPAN_ATTRIBUTES.HTTP_RESPONSE_STATUS_CODE,\n              (result as { status: number }).status,\n            );\n          }\n\n          ctx.setStatus({ code: SpanStatusCode.OK });\n          return result;\n        } catch (error) {\n          const duration = Date.now() - startTime;\n          ctx.setAttribute(\n            SPAN_ATTRIBUTES.TANSTACK_REQUEST_DURATION_MS,\n            duration,\n          );\n\n          if (mergedConfig.captureErrors) {\n            ctx.recordException(error as Error);\n            ctx.setStatus({\n              code: SpanStatusCode.ERROR,\n              message: (error as Error).message,\n            });\n\n            // Report error to error store\n            try {\n              const { reportError } = await import('./error-reporting');\n              reportError(error as Error, {\n                type: 'request',\n                method: request.method,\n                pathname: url.pathname,\n              });\n            } catch {\n              // Error reporting not available, skip\n            }\n          }\n          throw error;\n        }\n      }) as Promise<TContext>;\n    });\n  };\n}\n\n/**\n * Pre-configured tracing middleware with sensible defaults\n *\n * Convenience export for quick setup. Uses adaptive sampling,\n * captures x-request-id header, and excludes common health check paths.\n *\n * @param config - Optional configuration overrides\n * @returns Middleware handler\n *\n * @example\n * ```typescript\n * import { createStart } from '@tanstack/react-start';\n * import { tracingMiddleware } from 'autotel-tanstack/middleware';\n *\n * export const startInstance = createStart(() => ({\n *   requestMiddleware: [tracingMiddleware()],\n * }));\n * ```\n */\nexport function tracingMiddleware<TContext = unknown>(\n  config?: TracingMiddlewareConfig,\n): MiddlewareHandler<TContext> {\n  return createTracingMiddleware({\n    sampling: 'adaptive',\n    captureHeaders: ['x-request-id', 'user-agent'],\n    excludePaths: ['/health', '/healthz', '/ready', '/metrics', '/_ping'],\n    ...config,\n  });\n}\n\n/**\n * Create function-specific tracing middleware\n *\n * Convenience wrapper for server function middleware.\n *\n * @param config - Optional configuration\n * @returns Middleware handler for server functions\n *\n * @example\n * ```typescript\n * import { createServerFn } from '@tanstack/react-start';\n * import { functionTracingMiddleware } from 'autotel-tanstack/middleware';\n *\n * export const getUser = createServerFn({ method: 'GET' })\n *   .middleware([functionTracingMiddleware()])\n *   .handler(async ({ data: id }) => {\n *     return await db.users.findUnique({ where: { id } });\n *   });\n * ```\n */\nexport function functionTracingMiddleware<TContext = unknown>(\n  config?: Omit<TracingMiddlewareConfig, 'type'>,\n): MiddlewareHandler<TContext> {\n  return createTracingMiddleware({\n    ...config,\n    type: 'function',\n  });\n}\n\n/**\n * Create a tracing handler for use with TanStack's native createMiddleware()\n *\n * This provides the raw tracing logic that you can pass to createMiddleware().server().\n * Use this when you want full control over the middleware builder pattern.\n *\n * The handler accepts TanStack's middleware signature `{ next, context, request }`\n * and internally adapts it to our more flexible MiddlewareHandler interface.\n *\n * @param config - Configuration options\n * @returns Server handler function compatible with createMiddleware().server()\n *\n * @example\n * ```typescript\n * import { createStart, createMiddleware } from '@tanstack/react-start';\n * import { createTracingServerHandler } from 'autotel-tanstack/middleware';\n *\n * // TanStack-native middleware creation\n * const requestTracingMiddleware = createMiddleware().server(\n *   createTracingServerHandler({ captureHeaders: ['x-request-id'] })\n * );\n *\n * export const start = createStart(() => ({\n *   requestMiddleware: [requestTracingMiddleware],\n * }));\n * ```\n *\n * @example\n * ```typescript\n * // For server functions - use createMiddleware({ type: 'function' })\n * import { createStart, createMiddleware } from '@tanstack/react-start';\n * import { createTracingServerHandler } from 'autotel-tanstack/middleware';\n *\n * const functionTracingMiddleware = createMiddleware({ type: 'function' }).server(\n *   createTracingServerHandler({ type: 'function', captureArgs: true })\n * );\n *\n * export const start = createStart(() => ({\n *   functionMiddleware: [functionTracingMiddleware],\n * }));\n * ```\n */\nexport function createTracingServerHandler<TContext = unknown>(\n  config?: TracingMiddlewareConfig,\n): (opts: {\n  next: (ctx?: Partial<TContext>) => Promise<TContext>;\n  context: TContext;\n  request?: Request;\n}) => Promise<TContext> {\n  const handler = createTracingMiddleware<TContext>(config);\n\n  // Adapt TanStack's signature to our handler\n  return async (opts) => {\n    return handler(opts);\n  };\n}\n"]}

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 export { D as DEFAULT_CONFIG, S as SPAN_ATTRIBUTES, T as TanStackInstrumentationConfig, c as TraceLoaderConfig, b as TraceServerFnConfig, a as TracingMiddlewareConfig, W as WrapStartHandlerConfig } from './types-C37KSxMN.js';
-export { MiddlewareHandler, createTracingMiddleware, functionTracingMiddleware, tracingMiddleware } from './middleware.js';
+export { MiddlewareHandler, createTracingMiddleware, createTracingServerHandler, functionTracingMiddleware, tracingMiddleware } from './middleware.js';
 export { createTracedServerFnFactory, traceServerFn } from './server-functions.js';
 export { createTracedRoute, traceBeforeLoad, traceLoader } from './loaders.js';
 export { createTracedHandler, wrapStartHandler } from './handlers.js';

package/dist/index.js

@@ -1,7 +1,7 @@
 export { debugHeadersMiddleware } from './chunk-UTPW3QRT.js';
 export { createMetricsHandler, metricsCollector, recordTiming } from './chunk-JSI6QG7M.js';
 export { createErrorReportingHandler, errorStore, reportError, withErrorReporting } from './chunk-XXBHZR3M.js';
-export { createTracingMiddleware, functionTracingMiddleware, tracingMiddleware } from './chunk-OLBHLVLE.js';
+export { createTracingMiddleware, createTracingServerHandler, functionTracingMiddleware, tracingMiddleware } from './chunk-ETD6SGPH.js';
 export { createTracedServerFnFactory, traceServerFn } from './chunk-TNOQTZ3N.js';
 export { createTracedRoute, traceBeforeLoad, traceLoader } from './chunk-HKM7LMO6.js';
 export { isBrowser, isNode, isServerSide } from './chunk-EUYFVNYE.js';

package/dist/middleware.d.ts

@@ -100,5 +100,52 @@ declare function tracingMiddleware<TContext = unknown>(config?: TracingMiddlewar
  * ```
  */
 declare function functionTracingMiddleware<TContext = unknown>(config?: Omit<TracingMiddlewareConfig, 'type'>): MiddlewareHandler<TContext>;
+/**
+ * Create a tracing handler for use with TanStack's native createMiddleware()
+ *
+ * This provides the raw tracing logic that you can pass to createMiddleware().server().
+ * Use this when you want full control over the middleware builder pattern.
+ *
+ * The handler accepts TanStack's middleware signature `{ next, context, request }`
+ * and internally adapts it to our more flexible MiddlewareHandler interface.
+ *
+ * @param config - Configuration options
+ * @returns Server handler function compatible with createMiddleware().server()
+ *
+ * @example
+ * ```typescript
+ * import { createStart, createMiddleware } from '@tanstack/react-start';
+ * import { createTracingServerHandler } from 'autotel-tanstack/middleware';
+ *
+ * // TanStack-native middleware creation
+ * const requestTracingMiddleware = createMiddleware().server(
+ *   createTracingServerHandler({ captureHeaders: ['x-request-id'] })
+ * );
+ *
+ * export const start = createStart(() => ({
+ *   requestMiddleware: [requestTracingMiddleware],
+ * }));
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // For server functions - use createMiddleware({ type: 'function' })
+ * import { createStart, createMiddleware } from '@tanstack/react-start';
+ * import { createTracingServerHandler } from 'autotel-tanstack/middleware';
+ *
+ * const functionTracingMiddleware = createMiddleware({ type: 'function' }).server(
+ *   createTracingServerHandler({ type: 'function', captureArgs: true })
+ * );
+ *
+ * export const start = createStart(() => ({
+ *   functionMiddleware: [functionTracingMiddleware],
+ * }));
+ * ```
+ */
+declare function createTracingServerHandler<TContext = unknown>(config?: TracingMiddlewareConfig): (opts: {
+    next: (ctx?: Partial<TContext>) => Promise<TContext>;
+    context: TContext;
+    request?: Request;
+}) => Promise<TContext>;
 
-export { type MiddlewareHandler, createTracingMiddleware, functionTracingMiddleware, tracingMiddleware };
+export { type MiddlewareHandler, createTracingMiddleware, createTracingServerHandler, functionTracingMiddleware, tracingMiddleware };

package/dist/middleware.js

@@ -1,4 +1,4 @@
-export { createTracingMiddleware, functionTracingMiddleware, tracingMiddleware } from './chunk-OLBHLVLE.js';
+export { createTracingMiddleware, createTracingServerHandler, functionTracingMiddleware, tracingMiddleware } from './chunk-ETD6SGPH.js';
 import './chunk-EUYFVNYE.js';
 import './chunk-I4LX3LOG.js';
 import './chunk-NTY64BKS.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "autotel-tanstack",
-  "version": "1.4.0",
+  "version": "1.4.2",
   "description": "OpenTelemetry instrumentation for TanStack Start - automatic tracing for server functions, middleware, and route loaders",
   "type": "module",
   "main": "./dist/index.js",
@@ -117,7 +117,7 @@
   "license": "MIT",
   "dependencies": {
     "@opentelemetry/api": "^1.9.0",
-    "autotel": "2.10.0"
+    "autotel": "2.11.0"
   },
   "peerDependencies": {
     "@tanstack/react-start": "^1.139.14",

package/src/browser/index.ts

@@ -23,6 +23,7 @@ export {
   createTracingMiddleware,
   tracingMiddleware,
   functionTracingMiddleware,
+  createTracingServerHandler,
   type MiddlewareHandler,
 } from './middleware';
 export {

package/src/browser/middleware.ts

@@ -59,3 +59,19 @@ export function functionTracingMiddleware<TContext = unknown>(
     return opts.next();
   };
 }
+
+/**
+ * Browser stub: Returns pass-through handler for createMiddleware().server()
+ */
+export function createTracingServerHandler<TContext = unknown>(
+  config?: TracingMiddlewareConfig,
+): (opts: {
+  next: (ctx?: Partial<TContext>) => Promise<TContext>;
+  context: TContext;
+  request?: Request;
+}) => Promise<TContext> {
+  void config;
+  return async function noopHandler(opts) {
+    return opts.next();
+  };
+}

package/src/index.ts

@@ -39,6 +39,7 @@ export {
   createTracingMiddleware,
   tracingMiddleware,
   functionTracingMiddleware,
+  createTracingServerHandler,
   type MiddlewareHandler,
 } from './middleware';
 

package/src/middleware.ts

@@ -398,3 +398,60 @@ export function functionTracingMiddleware<TContext = unknown>(
     type: 'function',
   });
 }
+
+/**
+ * Create a tracing handler for use with TanStack's native createMiddleware()
+ *
+ * This provides the raw tracing logic that you can pass to createMiddleware().server().
+ * Use this when you want full control over the middleware builder pattern.
+ *
+ * The handler accepts TanStack's middleware signature `{ next, context, request }`
+ * and internally adapts it to our more flexible MiddlewareHandler interface.
+ *
+ * @param config - Configuration options
+ * @returns Server handler function compatible with createMiddleware().server()
+ *
+ * @example
+ * ```typescript
+ * import { createStart, createMiddleware } from '@tanstack/react-start';
+ * import { createTracingServerHandler } from 'autotel-tanstack/middleware';
+ *
+ * // TanStack-native middleware creation
+ * const requestTracingMiddleware = createMiddleware().server(
+ *   createTracingServerHandler({ captureHeaders: ['x-request-id'] })
+ * );
+ *
+ * export const start = createStart(() => ({
+ *   requestMiddleware: [requestTracingMiddleware],
+ * }));
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // For server functions - use createMiddleware({ type: 'function' })
+ * import { createStart, createMiddleware } from '@tanstack/react-start';
+ * import { createTracingServerHandler } from 'autotel-tanstack/middleware';
+ *
+ * const functionTracingMiddleware = createMiddleware({ type: 'function' }).server(
+ *   createTracingServerHandler({ type: 'function', captureArgs: true })
+ * );
+ *
+ * export const start = createStart(() => ({
+ *   functionMiddleware: [functionTracingMiddleware],
+ * }));
+ * ```
+ */
+export function createTracingServerHandler<TContext = unknown>(
+  config?: TracingMiddlewareConfig,
+): (opts: {
+  next: (ctx?: Partial<TContext>) => Promise<TContext>;
+  context: TContext;
+  request?: Request;
+}) => Promise<TContext> {
+  const handler = createTracingMiddleware<TContext>(config);
+
+  // Adapt TanStack's signature to our handler
+  return async (opts) => {
+    return handler(opts);
+  };
+}

package/dist/chunk-4C7T5ZIM.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/browser/middleware.ts"],"names":[],"mappings":";AA6BO,SAAS,wBACd,MAAA,EAC6B;AAE7B,EAAA,OAAO,eAAe,eAAe,IAAA,EAAM;AACzC,IAAA,OAAO,KAAK,IAAA,EAAK;AAAA,EACnB,CAAA;AACF;AAKO,SAAS,kBACd,MAAA,EAC6B;AAE7B,EAAA,OAAO,eAAe,eAAe,IAAA,EAAM;AACzC,IAAA,OAAO,KAAK,IAAA,EAAK;AAAA,EACnB,CAAA;AACF;AAKO,SAAS,0BACd,MAAA,EAC6B;AAE7B,EAAA,OAAO,eAAe,eAAe,IAAA,EAAM;AACzC,IAAA,OAAO,KAAK,IAAA,EAAK;AAAA,EACnB,CAAA;AACF","file":"chunk-4C7T5ZIM.js","sourcesContent":["/**\n * Browser stub for middleware module\n *\n * In browser environments, these functions return pass-through middleware\n * that just calls next() without any tracing overhead.\n */\n\nimport type { TracingMiddlewareConfig } from './types';\n\n/**\n * Generic middleware handler type\n */\nexport interface MiddlewareHandler<TContext = unknown> {\n  (opts: {\n    next: (ctx?: Partial<TContext>) => Promise<TContext>;\n    context: TContext;\n    request?: Request;\n    pathname?: string;\n    data?: unknown;\n    method?: string;\n    filename?: string;\n    functionId?: string;\n    signal?: AbortSignal;\n  }): Promise<TContext>;\n}\n\n/**\n * Browser stub: Returns pass-through middleware\n */\nexport function createTracingMiddleware<TContext = unknown>(\n  config?: TracingMiddlewareConfig,\n): MiddlewareHandler<TContext> {\n  void config;\n  return async function noopMiddleware(opts) {\n    return opts.next();\n  };\n}\n\n/**\n * Browser stub: Returns pass-through middleware\n */\nexport function tracingMiddleware<TContext = unknown>(\n  config?: TracingMiddlewareConfig,\n): MiddlewareHandler<TContext> {\n  void config;\n  return async function noopMiddleware(opts) {\n    return opts.next();\n  };\n}\n\n/**\n * Browser stub: Returns pass-through middleware\n */\nexport function functionTracingMiddleware<TContext = unknown>(\n  config?: Omit<TracingMiddlewareConfig, 'type'>,\n): MiddlewareHandler<TContext> {\n  void config;\n  return async function noopMiddleware(opts) {\n    return opts.next();\n  };\n}\n"]}

package/dist/chunk-OLBHLVLE.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/middleware.ts"],"names":["tracingMiddleware"],"mappings":";;;;;;AAaA,SAAS,iBAAA,CACP,UACA,YAAA,EACS;AACT,EAAA,KAAA,MAAW,WAAW,YAAA,EAAc;AAClC,IAAA,IAAI,OAAO,YAAY,QAAA,EAAU;AAE/B,MAAA,IAAI,OAAA,CAAQ,QAAA,CAAS,GAAG,CAAA,EAAG;AACzB,QAAA,MAAM,QAAQ,IAAI,MAAA;AAAA,UAChB,GAAA,GAAM,QAAQ,UAAA,CAAW,GAAA,EAAK,IAAI,CAAA,CAAE,UAAA,CAAW,GAAA,EAAK,GAAG,CAAA,GAAI;AAAA,SAC7D;AACA,QAAA,IAAI,KAAA,CAAM,IAAA,CAAK,QAAQ,CAAA,EAAG,OAAO,IAAA;AAAA,MACnC,CAAA,MAAO;AACL,QAAA,IAAI,aAAa,OAAA,IAAW,QAAA,CAAS,UAAA,CAAW,OAAO,GAAG,OAAO,IAAA;AAAA,MACnE;AAAA,IACF,CAAA,MAAO;AACL,MAAA,IAAI,OAAA,CAAQ,IAAA,CAAK,QAAQ,CAAA,EAAG,OAAO,IAAA;AAAA,IACrC;AAAA,EACF;AACA,EAAA,OAAO,KAAA;AACT;AAKA,SAAS,sBAAA,CACP,SACA,MAAA,EAGY;AACZ,EAAA,MAAM,GAAA,GAAM,IAAI,GAAA,CAAI,OAAA,CAAQ,GAAG,CAAA;AAC/B,EAAA,MAAM,KAAA,GAAoB;AAAA,IACxB,CAAC,eAAA,CAAgB,mBAAmB,GAAG,OAAA,CAAQ,MAAA;AAAA,IAC/C,CAAC,eAAA,CAAgB,QAAQ,GAAG,GAAA,CAAI,QAAA;AAAA,IAChC,CAAC,eAAA,CAAgB,aAAa,GAAG;AAAA,GACnC;AAEA,EAAA,IAAI,IAAI,MAAA,EAAQ;AACd,IAAA,KAAA,CAAM,eAAA,CAAgB,SAAS,CAAA,GAAI,GAAA,CAAI,MAAA;AAAA,EACzC;AAGA,EAAA,IAAI,OAAO,cAAA,EAAgB;AACzB,IAAA,KAAA,MAAW,MAAA,IAAU,OAAO,cAAA,EAAgB;AAC1C,MAAA,MAAM,KAAA,GAAQ,OAAA,CAAQ,OAAA,CAAQ,GAAA,CAAI,MAAM,CAAA;AACxC,MAAA,IAAI,KAAA,EAAO;AACT,QAAA,KAAA,CAAM,CAAA,oBAAA,EAAuB,MAAA,CAAO,WAAA,EAAa,EAAE,CAAA,GAAI,KAAA;AAAA,MACzD;AAAA,IACF;AAAA,EACF;AAEA,EAAA,OAAO,KAAA;AACT;AAKA,SAAS,uBAAA,CACP,YAAA,EACA,MAAA,EACA,IAAA,EACA,MAAA,EAGY;AACZ,EAAA,MAAM,KAAA,GAAoB;AAAA,IACxB,CAAC,eAAA,CAAgB,UAAU,GAAG,gBAAA;AAAA,IAC9B,CAAC,eAAA,CAAgB,UAAU,GAAG,YAAA;AAAA,IAC9B,CAAC,eAAA,CAAgB,aAAa,GAAG,UAAA;AAAA,IACjC,CAAC,eAAA,CAAgB,uBAAuB,GAAG,YAAA;AAAA,IAC3C,CAAC,eAAA,CAAgB,yBAAyB,GAAG;AAAA,GAC/C;AAEA,EAAA,IAAI,MAAA,CAAO,WAAA,IAAe,IAAA,KAAS,MAAA,EAAW;AAC5C,IAAA,IAAI;AACF,MAAA,KAAA,CAAM,eAAA,CAAgB,uBAAuB,CAAA,GAAI,IAAA,CAAK,UAAU,IAAI,CAAA;AAAA,IACtE,CAAA,CAAA,MAAQ;AACN,MAAA,KAAA,CAAM,eAAA,CAAgB,uBAAuB,CAAA,GAAI,oBAAA;AAAA,IACnD;AAAA,EACF;AAEA,EAAA,OAAO,KAAA;AACT;AA4DO,SAAS,wBACd,MAAA,EAC6B;AAC7B,EAAA,MAAM,YAAA,GAAe;AAAA,IACnB,GAAG,cAAA;AAAA,IACH,GAAG,MAAA;AAAA,IACH,IAAA,EAAM,QAAQ,IAAA,IAAQ;AAAA,GACxB;AAEA,EAAA,OAAO,eAAeA,mBAAkB,IAAA,EAAM;AAG5C,IAAA,IAAI,CAAC,cAAa,EAAG;AACnB,MAAA,OAAO,KAAK,IAAA,EAAK;AAAA,IACnB;AACA,IAAA,MAAM,EAAE,IAAA,EAAM,OAAA,EAAS,QAAA,EAAU,IAAA,EAAM,YAAW,GAAI,IAAA;AAGtD,IAAA,IAAI,YAAA,CAAa,SAAS,UAAA,EAAY;AACpC,MAAA,MAAM,SAAS,UAAA,IAAc,SAAA;AAC7B,MAAA,MAAM,MAAA,GAAU,KAA6B,MAAA,IAAU,MAAA;AAEvD,MAAA,OAAO,KAAA,CAAM,CAAA,kBAAA,EAAqB,MAAM,CAAA,CAAA,EAAI,OAAO,GAAA,KAAsB;AACvE,QAAA,MAAM,KAAA,GAAQ,uBAAA;AAAA,UACZ,MAAA;AAAA,UACA,MAAA;AAAA,UACA,IAAA;AAAA,UACA;AAAA,SACF;AACA,QAAA,GAAA,CAAI,cAAc,KAAkD,CAAA;AAGpE,QAAA,IAAI,QAAQ,gBAAA,EAAkB;AAC5B,UAAA,MAAM,WAAA,GAAc,OAAO,gBAAA,CAAiB;AAAA,YAC1C,IAAA,EAAM,UAAA;AAAA,YACN,IAAA,EAAM,MAAA;AAAA,YACN,IAAA,EAAM;AAAA,WACP,CAAA;AACD,UAAA,GAAA,CAAI,aAAA;AAAA,YACF;AAAA,WACF;AAAA,QACF;AAEA,QAAA,IAAI;AACF,UAAA,MAAM,MAAA,GAAS,MAAM,IAAA,EAAK;AAG1B,UAAA,IAAI,YAAA,CAAa,cAAA,IAAkB,MAAA,KAAW,KAAA,CAAA,EAAW;AACvD,YAAA,IAAI;AACF,cAAA,GAAA,CAAI,YAAA;AAAA,gBACF,eAAA,CAAgB,yBAAA;AAAA,gBAChB,IAAA,CAAK,UAAU,MAAM;AAAA,eACvB;AAAA,YACF,CAAA,CAAA,MAAQ;AACN,cAAA,GAAA,CAAI,YAAA;AAAA,gBACF,eAAA,CAAgB,yBAAA;AAAA,gBAChB;AAAA,eACF;AAAA,YACF;AAAA,UACF;AAEA,UAAA,GAAA,CAAI,SAAA,CAAU,EAAE,IAAA,EAAM,cAAA,CAAe,IAAI,CAAA;AACzC,UAAA,OAAO,MAAA;AAAA,QACT,SAAS,KAAA,EAAO;AACd,UAAA,IAAI,aAAa,aAAA,EAAe;AAC9B,YAAA,GAAA,CAAI,gBAAgB,KAAc,CAAA;AAClC,YAAA,GAAA,CAAI,SAAA,CAAU;AAAA,cACZ,MAAM,cAAA,CAAe,KAAA;AAAA,cACrB,SAAU,KAAA,CAAgB;AAAA,aAC3B,CAAA;AAGD,YAAA,IAAI;AACF,cAAA,MAAM,EAAE,WAAA,EAAY,GAAI,MAAM,OAAO,sBAAmB,CAAA;AACxD,cAAA,WAAA,CAAY,KAAA,EAAgB;AAAA,gBAC1B,IAAA,EAAM,UAAA;AAAA,gBACN,IAAA,EAAM,MAAA;AAAA,gBACN;AAAA,eACD,CAAA;AAAA,YACH,CAAA,CAAA,MAAQ;AAAA,YAER;AAAA,UACF;AACA,UAAA,MAAM,KAAA;AAAA,QACR;AAAA,MACF,CAAC,CAAA;AAAA,IACH;AAGA,IAAA,IAAI,CAAC,OAAA,EAAS;AAEZ,MAAA,OAAO,IAAA,EAAK;AAAA,IACd;AAEA,IAAA,MAAM,GAAA,GAAM,IAAI,GAAA,CAAI,OAAA,CAAQ,GAAG,CAAA;AAG/B,IAAA,IAAI,iBAAA,CAAkB,GAAA,CAAI,QAAA,EAAU,YAAA,CAAa,YAAY,CAAA,EAAG;AAC9D,MAAA,OAAO,IAAA,EAAK;AAAA,IACd;AAGA,IAAA,MAAM,aAAA,GAAgB,0BAA0B,OAAO,CAAA;AAGvD,IAAA,OAAO,OAAA,CAAQ,IAAA,CAAK,aAAA,EAAe,YAAY;AAC7C,MAAA,MAAM,WAAW,CAAA,EAAG,OAAA,CAAQ,MAAM,CAAA,CAAA,EAAI,QAAA,IAAY,IAAI,QAAQ,CAAA,CAAA;AAE9D,MAAA,OAAO,KAAA,CAAM,QAAA,EAAU,OAAO,GAAA,KAAsB;AAClD,QAAA,MAAM,KAAA,GAAQ,sBAAA,CAAuB,OAAA,EAAS,YAAY,CAAA;AAC1D,QAAA,GAAA,CAAI,cAAc,KAAkD,CAAA;AAGpE,QAAA,IAAI,QAAQ,gBAAA,EAAkB;AAC5B,UAAA,MAAM,WAAA,GAAc,OAAO,gBAAA,CAAiB;AAAA,YAC1C,IAAA,EAAM,SAAA;AAAA,YACN,IAAA,EAAM,QAAA;AAAA,YACN;AAAA,WACD,CAAA;AACD,UAAA,GAAA,CAAI,aAAA;AAAA,YACF;AAAA,WACF;AAAA,QACF;AAEA,QAAA,MAAM,SAAA,GAAY,KAAK,GAAA,EAAI;AAE3B,QAAA,IAAI;AACF,UAAA,MAAM,MAAA,GAAS,MAAM,IAAA,EAAK;AAE1B,UAAA,MAAM,QAAA,GAAW,IAAA,CAAK,GAAA,EAAI,GAAI,SAAA;AAC9B,UAAA,GAAA,CAAI,YAAA;AAAA,YACF,eAAA,CAAgB,4BAAA;AAAA,YAChB;AAAA,WACF;AAGA,UAAA,IAAI;AACF,YAAA,MAAM,EAAE,gBAAA,EAAiB,GAAI,MAAM,OAAO,cAAW,CAAA;AACrD,YAAA,gBAAA,CAAiB,YAAA,CAAa,UAAU,QAAQ,CAAA;AAAA,UAClD,CAAA,CAAA,MAAQ;AAAA,UAER;AAGA,UAAA,IAAI,MAAA,IAAU,OAAO,MAAA,KAAW,QAAA,IAAY,YAAY,MAAA,EAAQ;AAC9D,YAAA,GAAA,CAAI,YAAA;AAAA,cACF,eAAA,CAAgB,yBAAA;AAAA,cACf,MAAA,CAA8B;AAAA,aACjC;AAAA,UACF;AAEA,UAAA,GAAA,CAAI,SAAA,CAAU,EAAE,IAAA,EAAM,cAAA,CAAe,IAAI,CAAA;AACzC,UAAA,OAAO,MAAA;AAAA,QACT,SAAS,KAAA,EAAO;AACd,UAAA,MAAM,QAAA,GAAW,IAAA,CAAK,GAAA,EAAI,GAAI,SAAA;AAC9B,UAAA,GAAA,CAAI,YAAA;AAAA,YACF,eAAA,CAAgB,4BAAA;AAAA,YAChB;AAAA,WACF;AAEA,UAAA,IAAI,aAAa,aAAA,EAAe;AAC9B,YAAA,GAAA,CAAI,gBAAgB,KAAc,CAAA;AAClC,YAAA,GAAA,CAAI,SAAA,CAAU;AAAA,cACZ,MAAM,cAAA,CAAe,KAAA;AAAA,cACrB,SAAU,KAAA,CAAgB;AAAA,aAC3B,CAAA;AAGD,YAAA,IAAI;AACF,cAAA,MAAM,EAAE,WAAA,EAAY,GAAI,MAAM,OAAO,sBAAmB,CAAA;AACxD,cAAA,WAAA,CAAY,KAAA,EAAgB;AAAA,gBAC1B,IAAA,EAAM,SAAA;AAAA,gBACN,QAAQ,OAAA,CAAQ,MAAA;AAAA,gBAChB,UAAU,GAAA,CAAI;AAAA,eACf,CAAA;AAAA,YACH,CAAA,CAAA,MAAQ;AAAA,YAER;AAAA,UACF;AACA,UAAA,MAAM,KAAA;AAAA,QACR;AAAA,MACF,CAAC,CAAA;AAAA,IACH,CAAC,CAAA;AAAA,EACH,CAAA;AACF;AAqBO,SAAS,kBACd,MAAA,EAC6B;AAC7B,EAAA,OAAO,uBAAA,CAAwB;AAAA,IAC7B,QAAA,EAAU,UAAA;AAAA,IACV,cAAA,EAAgB,CAAC,cAAA,EAAgB,YAAY,CAAA;AAAA,IAC7C,cAAc,CAAC,SAAA,EAAW,UAAA,EAAY,QAAA,EAAU,YAAY,QAAQ,CAAA;AAAA,IACpE,GAAG;AAAA,GACJ,CAAA;AACH;AAsBO,SAAS,0BACd,MAAA,EAC6B;AAC7B,EAAA,OAAO,uBAAA,CAAwB;AAAA,IAC7B,GAAG,MAAA;AAAA,IACH,IAAA,EAAM;AAAA,GACP,CAAA;AACH","file":"chunk-OLBHLVLE.js","sourcesContent":["import { context, SpanStatusCode, type Attributes } from '@opentelemetry/api';\nimport { trace, type TraceContext } from 'autotel';\nimport { extractContextFromRequest } from './context';\nimport { isServerSide } from './env';\nimport {\n  type TracingMiddlewareConfig,\n  DEFAULT_CONFIG,\n  SPAN_ATTRIBUTES,\n} from './types';\n\n/**\n * Check if a path should be excluded from tracing\n */\nfunction shouldExcludePath(\n  pathname: string,\n  excludePaths: (string | RegExp)[],\n): boolean {\n  for (const pattern of excludePaths) {\n    if (typeof pattern === 'string') {\n      // Simple glob matching\n      if (pattern.includes('*')) {\n        const regex = new RegExp(\n          '^' + pattern.replaceAll('*', '.*').replaceAll('?', '.') + '$',\n        );\n        if (regex.test(pathname)) return true;\n      } else {\n        if (pathname === pattern || pathname.startsWith(pattern)) return true;\n      }\n    } else {\n      if (pattern.test(pathname)) return true;\n    }\n  }\n  return false;\n}\n\n/**\n * Build span attributes for HTTP requests\n */\nfunction buildRequestAttributes(\n  request: Request,\n  config: Required<\n    Omit<TracingMiddlewareConfig, 'customAttributes' | 'service' | 'type'>\n  >,\n): Attributes {\n  const url = new URL(request.url);\n  const attrs: Attributes = {\n    [SPAN_ATTRIBUTES.HTTP_REQUEST_METHOD]: request.method,\n    [SPAN_ATTRIBUTES.URL_PATH]: url.pathname,\n    [SPAN_ATTRIBUTES.TANSTACK_TYPE]: 'request',\n  };\n\n  if (url.search) {\n    attrs[SPAN_ATTRIBUTES.URL_QUERY] = url.search;\n  }\n\n  // Capture configured headers\n  if (config.captureHeaders) {\n    for (const header of config.captureHeaders) {\n      const value = request.headers.get(header);\n      if (value) {\n        attrs[`http.request.header.${header.toLowerCase()}`] = value;\n      }\n    }\n  }\n\n  return attrs;\n}\n\n/**\n * Build span attributes for server functions\n */\nfunction buildServerFnAttributes(\n  functionName: string,\n  method: string,\n  args: unknown,\n  config: Required<\n    Omit<TracingMiddlewareConfig, 'customAttributes' | 'service' | 'type'>\n  >,\n): Attributes {\n  const attrs: Attributes = {\n    [SPAN_ATTRIBUTES.RPC_SYSTEM]: 'tanstack-start',\n    [SPAN_ATTRIBUTES.RPC_METHOD]: functionName,\n    [SPAN_ATTRIBUTES.TANSTACK_TYPE]: 'serverFn',\n    [SPAN_ATTRIBUTES.TANSTACK_SERVER_FN_NAME]: functionName,\n    [SPAN_ATTRIBUTES.TANSTACK_SERVER_FN_METHOD]: method,\n  };\n\n  if (config.captureArgs && args !== undefined) {\n    try {\n      attrs[SPAN_ATTRIBUTES.TANSTACK_SERVER_FN_ARGS] = JSON.stringify(args);\n    } catch {\n      attrs[SPAN_ATTRIBUTES.TANSTACK_SERVER_FN_ARGS] = '[non-serializable]';\n    }\n  }\n\n  return attrs;\n}\n\n/**\n * Generic middleware handler type (compatible with TanStack's middleware pattern)\n *\n * This type represents the shape of TanStack middleware handlers.\n * We use a generic type to avoid direct dependency on TanStack packages.\n */\nexport interface MiddlewareHandler<TContext = unknown> {\n  (opts: {\n    next: (ctx?: Partial<TContext>) => Promise<TContext>;\n    context: TContext;\n    request?: Request;\n    pathname?: string;\n    data?: unknown;\n    method?: string;\n    filename?: string;\n    functionId?: string;\n    signal?: AbortSignal;\n  }): Promise<TContext>;\n}\n\n/**\n * Create a TanStack-compatible tracing middleware\n *\n * This creates middleware that automatically traces all requests/server functions\n * with OpenTelemetry spans. Use with TanStack Start's middleware system.\n *\n * @param config - Configuration options\n * @returns Middleware handler compatible with TanStack Start\n *\n * @example\n * ```typescript\n * // Global request middleware in app/start.ts\n * import { createStart } from '@tanstack/react-start';\n * import { createTracingMiddleware } from 'autotel-tanstack/middleware';\n *\n * export const startInstance = createStart(() => ({\n *   requestMiddleware: [\n *     createTracingMiddleware({\n *       captureHeaders: ['x-request-id', 'user-agent'],\n *       excludePaths: ['/health', '/metrics'],\n *     }),\n *   ],\n * }));\n * ```\n *\n * @example\n * ```typescript\n * // Server function middleware\n * import { createServerFn } from '@tanstack/react-start';\n * import { createTracingMiddleware } from 'autotel-tanstack/middleware';\n *\n * export const getUser = createServerFn({ method: 'GET' })\n *   .middleware([createTracingMiddleware({ type: 'function' })])\n *   .handler(async ({ data: id }) => {\n *     return await db.users.findUnique({ where: { id } });\n *   });\n * ```\n */\nexport function createTracingMiddleware<TContext = unknown>(\n  config?: TracingMiddlewareConfig,\n): MiddlewareHandler<TContext> {\n  const mergedConfig = {\n    ...DEFAULT_CONFIG,\n    ...config,\n    type: config?.type ?? 'request',\n  };\n\n  return async function tracingMiddleware(opts) {\n    // If we're in the browser, return a no-op middleware\n    // This prevents autotel (which uses Node.js APIs) from being bundled/executed in the browser\n    if (!isServerSide()) {\n      return opts.next();\n    }\n    const { next, request, pathname, data, functionId } = opts;\n\n    // For function middleware\n    if (mergedConfig.type === 'function') {\n      const fnName = functionId || 'unknown';\n      const method = (opts as { method?: string }).method || 'POST';\n\n      return trace(`tanstack.serverFn.${fnName}`, async (ctx: TraceContext) => {\n        const attrs = buildServerFnAttributes(\n          fnName,\n          method,\n          data,\n          mergedConfig,\n        );\n        ctx.setAttributes(attrs as Record<string, string | number | boolean>);\n\n        // Add custom attributes if provided\n        if (config?.customAttributes) {\n          const customAttrs = config.customAttributes({\n            type: 'serverFn',\n            name: fnName,\n            args: data,\n          });\n          ctx.setAttributes(\n            customAttrs as Record<string, string | number | boolean>,\n          );\n        }\n\n        try {\n          const result = await next();\n\n          // Capture result if configured\n          if (mergedConfig.captureResults && result !== undefined) {\n            try {\n              ctx.setAttribute(\n                SPAN_ATTRIBUTES.TANSTACK_SERVER_FN_RESULT,\n                JSON.stringify(result),\n              );\n            } catch {\n              ctx.setAttribute(\n                SPAN_ATTRIBUTES.TANSTACK_SERVER_FN_RESULT,\n                '[non-serializable]',\n              );\n            }\n          }\n\n          ctx.setStatus({ code: SpanStatusCode.OK });\n          return result;\n        } catch (error) {\n          if (mergedConfig.captureErrors) {\n            ctx.recordException(error as Error);\n            ctx.setStatus({\n              code: SpanStatusCode.ERROR,\n              message: (error as Error).message,\n            });\n\n            // Report error to error store\n            try {\n              const { reportError } = await import('./error-reporting');\n              reportError(error as Error, {\n                type: 'serverFn',\n                name: fnName,\n                method,\n              });\n            } catch {\n              // Error reporting not available, skip\n            }\n          }\n          throw error;\n        }\n      }) as Promise<TContext>;\n    }\n\n    // For request middleware\n    if (!request) {\n      // No request available, just pass through\n      return next();\n    }\n\n    const url = new URL(request.url);\n\n    // Check if path should be excluded\n    if (shouldExcludePath(url.pathname, mergedConfig.excludePaths)) {\n      return next();\n    }\n\n    // Extract parent context from request headers\n    const parentContext = extractContextFromRequest(request);\n\n    // Run within parent context for distributed tracing\n    return context.with(parentContext, async () => {\n      const spanName = `${request.method} ${pathname || url.pathname}`;\n\n      return trace(spanName, async (ctx: TraceContext) => {\n        const attrs = buildRequestAttributes(request, mergedConfig);\n        ctx.setAttributes(attrs as Record<string, string | number | boolean>);\n\n        // Add custom attributes if provided\n        if (config?.customAttributes) {\n          const customAttrs = config.customAttributes({\n            type: 'request',\n            name: spanName,\n            request,\n          });\n          ctx.setAttributes(\n            customAttrs as Record<string, string | number | boolean>,\n          );\n        }\n\n        const startTime = Date.now();\n\n        try {\n          const result = await next();\n\n          const duration = Date.now() - startTime;\n          ctx.setAttribute(\n            SPAN_ATTRIBUTES.TANSTACK_REQUEST_DURATION_MS,\n            duration,\n          );\n\n          // Record timing in metrics collector\n          try {\n            const { metricsCollector } = await import('./metrics');\n            metricsCollector.recordTiming(spanName, duration);\n          } catch {\n            // Metrics not available, skip\n          }\n\n          // Try to get response status from result if it's a Response\n          if (result && typeof result === 'object' && 'status' in result) {\n            ctx.setAttribute(\n              SPAN_ATTRIBUTES.HTTP_RESPONSE_STATUS_CODE,\n              (result as { status: number }).status,\n            );\n          }\n\n          ctx.setStatus({ code: SpanStatusCode.OK });\n          return result;\n        } catch (error) {\n          const duration = Date.now() - startTime;\n          ctx.setAttribute(\n            SPAN_ATTRIBUTES.TANSTACK_REQUEST_DURATION_MS,\n            duration,\n          );\n\n          if (mergedConfig.captureErrors) {\n            ctx.recordException(error as Error);\n            ctx.setStatus({\n              code: SpanStatusCode.ERROR,\n              message: (error as Error).message,\n            });\n\n            // Report error to error store\n            try {\n              const { reportError } = await import('./error-reporting');\n              reportError(error as Error, {\n                type: 'request',\n                method: request.method,\n                pathname: url.pathname,\n              });\n            } catch {\n              // Error reporting not available, skip\n            }\n          }\n          throw error;\n        }\n      }) as Promise<TContext>;\n    });\n  };\n}\n\n/**\n * Pre-configured tracing middleware with sensible defaults\n *\n * Convenience export for quick setup. Uses adaptive sampling,\n * captures x-request-id header, and excludes common health check paths.\n *\n * @param config - Optional configuration overrides\n * @returns Middleware handler\n *\n * @example\n * ```typescript\n * import { createStart } from '@tanstack/react-start';\n * import { tracingMiddleware } from 'autotel-tanstack/middleware';\n *\n * export const startInstance = createStart(() => ({\n *   requestMiddleware: [tracingMiddleware()],\n * }));\n * ```\n */\nexport function tracingMiddleware<TContext = unknown>(\n  config?: TracingMiddlewareConfig,\n): MiddlewareHandler<TContext> {\n  return createTracingMiddleware({\n    sampling: 'adaptive',\n    captureHeaders: ['x-request-id', 'user-agent'],\n    excludePaths: ['/health', '/healthz', '/ready', '/metrics', '/_ping'],\n    ...config,\n  });\n}\n\n/**\n * Create function-specific tracing middleware\n *\n * Convenience wrapper for server function middleware.\n *\n * @param config - Optional configuration\n * @returns Middleware handler for server functions\n *\n * @example\n * ```typescript\n * import { createServerFn } from '@tanstack/react-start';\n * import { functionTracingMiddleware } from 'autotel-tanstack/middleware';\n *\n * export const getUser = createServerFn({ method: 'GET' })\n *   .middleware([functionTracingMiddleware()])\n *   .handler(async ({ data: id }) => {\n *     return await db.users.findUnique({ where: { id } });\n *   });\n * ```\n */\nexport function functionTracingMiddleware<TContext = unknown>(\n  config?: Omit<TracingMiddlewareConfig, 'type'>,\n): MiddlewareHandler<TContext> {\n  return createTracingMiddleware({\n    ...config,\n    type: 'function',\n  });\n}\n"]}