@telemetry-dev/tanstack-ai 0.1.0

package/package.json

@@ -0,0 +1,62 @@
+{
+  "name": "@telemetry-dev/tanstack-ai",
+  "version": "0.1.0",
+  "description": "TanStack AI telemetry integration for telemetry.dev: chat() middleware emitting OpenTelemetry GenAI spans.",
+  "keywords": [
+    "genai",
+    "llm",
+    "observability",
+    "opentelemetry",
+    "tanstack",
+    "telemetry",
+    "tracing"
+  ],
+  "homepage": "https://telemetry.dev",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/telemetry-dev/telemetry.dev.git",
+    "directory": "packages/tanstack-ai"
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.mts",
+      "import": "./dist/index.mjs",
+      "default": "./dist/index.mjs"
+    },
+    "./package.json": "./package.json"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@opentelemetry/api": "^1.9.1",
+    "@opentelemetry/otlp-transformer": "^0.218.0",
+    "@opentelemetry/resources": "^2.7.1",
+    "@opentelemetry/sdk-metrics": "^2.7.1",
+    "@opentelemetry/sdk-trace-base": "^2.7.1"
+  },
+  "devDependencies": {
+    "@opentelemetry/core": "^2.7.1",
+    "@tanstack/ai": "0.28.0",
+    "@types/node": "^25.5.0",
+    "@typescript/native-preview": "7.0.0-dev.20260328.1",
+    "typescript": "^6.0.2",
+    "vite-plus": "0.1.20",
+    "vitest": "npm:@voidzero-dev/vite-plus-test@0.1.20"
+  },
+  "peerDependencies": {
+    "@tanstack/ai": ">=0.28.0 <1"
+  },
+  "scripts": {
+    "build": "pnpm exec vp pack",
+    "dev": "pnpm exec vp pack --watch",
+    "test": "vp test",
+    "check": "vp check"
+  }
+}

package/src/config.ts

@@ -0,0 +1,48 @@
+export interface TelemetryDevOptions {
+  /** telemetry.dev ingest key (`td_live_…`). Falls back to `TELEMETRY_DEV_API_KEY`. When absent the integration is a no-op. */
+  apiKey?: string;
+  /** Ingest base URL. Falls back to `TELEMETRY_DEV_BASE_URL`, then `https://ingest.telemetry.dev`. */
+  baseUrl?: string;
+  /** Deployment environment label. Falls back to `TELEMETRY_DEV_ENVIRONMENT`, then `production`. */
+  environment?: string;
+  /** Service name attached to every trace. Falls back to `OTEL_SERVICE_NAME`, then `unknown_service`. */
+  serviceName?: string;
+  /** Injected fetch implementation. Defaults to `globalThis.fetch`. */
+  fetch?: typeof fetch;
+  /** Serverless extender (e.g. Cloudflare `ctx.waitUntil`). When provided, `onFinish` does not await the POST. */
+  waitUntil?: (p: Promise<unknown>) => void;
+  /** Receives any error raised while emitting telemetry; the integration never throws into the SDK. */
+  onError?: (error: unknown) => void;
+}
+
+export interface ResolvedConfig {
+  apiKey: string | undefined;
+  baseUrl: string;
+  environment: string;
+  serviceName: string;
+  fetchImpl: typeof fetch;
+  waitUntil?: (p: Promise<unknown>) => void;
+  onError?: (error: unknown) => void;
+}
+
+const DEFAULT_BASE_URL = "https://ingest.telemetry.dev";
+
+export function resolveConfig(options: TelemetryDevOptions = {}): ResolvedConfig {
+  const env =
+    typeof process !== "undefined" && process.env
+      ? process.env
+      : ({} as Record<string, string | undefined>);
+  const baseUrl = (options.baseUrl ?? env.TELEMETRY_DEV_BASE_URL ?? DEFAULT_BASE_URL).replace(
+    /\/+$/,
+    "",
+  );
+  return {
+    apiKey: options.apiKey ?? env.TELEMETRY_DEV_API_KEY,
+    baseUrl,
+    environment: options.environment ?? env.TELEMETRY_DEV_ENVIRONMENT ?? "production",
+    serviceName: options.serviceName ?? env.OTEL_SERVICE_NAME ?? "unknown_service",
+    fetchImpl: options.fetch ?? globalThis.fetch,
+    waitUntil: options.waitUntil,
+    onError: options.onError,
+  };
+}

package/src/index.ts

@@ -0,0 +1,2 @@
+export { telemetryDev } from "./middleware.ts";
+export type { TelemetryDevOptions } from "./config.ts";