autotel-tanstack 1.12.0 → 1.12.1

package/bin/intent.js

@@ -0,0 +1,6 @@
+#!/usr/bin/env node
+// Auto-generated by @tanstack/intent setup
+// Exposes the intent end-user CLI for consumers of this library.
+// Commit this file, then add to your package.json:
+//   "bin": { "intent": "./bin/intent.js" }
+await import('@tanstack/intent/intent-library');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "autotel-tanstack",
-  "version": "1.12.0",
+  "version": "1.12.1",
   "description": "OpenTelemetry instrumentation for TanStack Start - automatic tracing for server functions, middleware, and route loaders",
   "type": "module",
   "main": "./dist/index.js",
@@ -95,7 +95,10 @@
   "files": [
     "dist",
     "src",
-    "README.md"
+    "README.md",
+    "skills",
+    "!skills/_artifacts",
+    "bin"
   ],
   "keywords": [
     "opentelemetry",
@@ -117,12 +120,13 @@
   "license": "MIT",
   "dependencies": {
     "@opentelemetry/api": "^1.9.0",
-    "autotel": "2.23.0",
-    "autotel-adapters": "0.1.1"
+    "@tanstack/intent": "^0.0.13",
+    "autotel": "2.23.1",
+    "autotel-adapters": "0.1.2"
   },
   "peerDependencies": {
-    "@tanstack/react-start": "^1.166.1",
-    "@tanstack/solid-start": "^1.166.1"
+    "@tanstack/react-start": "^1.166.2",
+    "@tanstack/solid-start": "^1.166.2"
   },
   "peerDependenciesMeta": {
     "@tanstack/react-start": {
@@ -133,9 +137,9 @@
     }
   },
   "devDependencies": {
-    "@opentelemetry/sdk-trace-base": "^2.5.1",
-    "@tanstack/react-router": "^1.163.3",
-    "@types/node": "^25.3.3",
+    "@opentelemetry/sdk-trace-base": "^2.6.0",
+    "@tanstack/react-router": "^1.166.2",
+    "@types/node": "^25.3.5",
     "rimraf": "^6.1.3",
     "tsup": "^8.5.1",
     "typescript": "^5.9.3",
@@ -151,6 +155,9 @@
     "url": "https://github.com/jagreehal/autotel/issues"
   },
   "homepage": "https://github.com/jagreehal/autotel/tree/main/packages/autotel-tanstack#readme",
+  "bin": {
+    "intent": "./bin/intent.js"
+  },
   "scripts": {
     "build": "tsup",
     "dev": "tsup --watch",

package/skills/autotel-tanstack/SKILL.md

@@ -0,0 +1,99 @@
+---
+name: autotel-tanstack
+description: >
+  OpenTelemetry for TanStack Start. Trace server functions, route loaders, middleware, and request handlers. Supports zero-config, middleware-based, and explicit wrapper patterns.
+type: integration
+library: autotel-tanstack
+library_version: '1.12.0'
+sources:
+  - jagreehal/autotel:packages/autotel-tanstack/CLAUDE.md
+---
+
+# autotel-tanstack
+
+OpenTelemetry instrumentation for TanStack Start (React Start and Solid Start).
+
+## Quick Start — pick one approach
+
+### Zero-config
+
+```typescript
+import 'autotel-tanstack/auto';
+// Set env: OTEL_SERVICE_NAME, OTEL_EXPORTER_OTLP_ENDPOINT, OTEL_EXPORTER_OTLP_HEADERS
+```
+
+### Middleware (recommended)
+
+```typescript
+import { tracingMiddleware } from 'autotel-tanstack/middleware';
+
+// Request-level tracing
+export const startInstance = createStart(() => ({
+  requestMiddleware: [tracingMiddleware()],
+}));
+
+// Server function tracing
+export const getUser = createServerFn({ method: 'GET' })
+  .middleware([tracingMiddleware({ type: 'function' })])
+  .handler(async ({ data: id }) => db.users.findUnique({ where: { id } }));
+```
+
+### Explicit wrappers
+
+```typescript
+import { traceServerFn } from 'autotel-tanstack/server-functions';
+import { traceLoader } from 'autotel-tanstack/loaders';
+import { wrapStartHandler } from 'autotel-tanstack/handlers';
+
+// Server function
+export const getUser = traceServerFn(
+  createServerFn({ method: 'GET' }).handler(async ({ data }) => { ... }),
+  { name: 'getUser', captureArgs: true },
+);
+
+// Route loader
+export const Route = createFileRoute('/users/$userId')({
+  loader: traceLoader(async ({ params }) => {
+    return db.users.findUnique({ where: { id: params.userId } });
+  }),
+});
+
+// Request handler
+export default wrapStartHandler({
+  service: 'my-app',
+  endpoint: process.env.OTEL_EXPORTER_OTLP_ENDPOINT,
+})(createStartHandler(defaultStreamHandler));
+```
+
+## Configuration Options
+
+```typescript
+tracingMiddleware({
+  captureHeaders: ['x-request-id'], // Request headers to capture
+  captureArgs: true, // Capture server function arguments
+  captureResults: false, // Capture return values
+  captureParams: true, // Capture route params
+  excludePaths: ['/health', /^\/api\/internal/],
+  sampling: 'adaptive', // 'adaptive' | 'always' | 'never'
+  customAttributes: (ctx) => ({ 'app.tenant': ctx.tenant }),
+});
+```
+
+## Entry Points (tree-shaking)
+
+| Import                              | What                      |
+| ----------------------------------- | ------------------------- |
+| `autotel-tanstack`                  | Everything                |
+| `autotel-tanstack/auto`             | Zero-config               |
+| `autotel-tanstack/middleware`       | Middleware only           |
+| `autotel-tanstack/server-functions` | Server function wrappers  |
+| `autotel-tanstack/loaders`          | Loader wrappers           |
+| `autotel-tanstack/handlers`         | Handler wrappers          |
+| `autotel-tanstack/context`          | Trace context propagation |
+
+## Common Mistakes
+
+- Do NOT use `tracingMiddleware()` in browser — it no-ops. Server functions run server-side only.
+- Do NOT forget to wrap the start handler — without it, there's no root span for requests.
+- Use `captureArgs: true` carefully — it serializes function arguments into span attributes. Avoid for large payloads.
+- Prefer middleware over explicit wrappers — middleware composes with TanStack's built-in patterns.