@telemetry-dev/sdk 0.1.12 → 0.2.0

package/README.md

@@ -2,7 +2,7 @@
 
 Pure TypeScript SDK for [telemetry.dev](https://telemetry.dev): add LLM traces, logs, and GenAI
 metrics to any app. Built on OpenTelemetry — spans use the `gen_ai.*` semantic conventions and
-ship as OTLP protobuf to `https://ingest.telemetry.dev`. Works on Node >= 20.19 and edge runtimes
+ship as OTLP protobuf to `https://api.telemetry.dev`. Works on Node >= 20.19 and edge runtimes
 (Vercel Edge, and Cloudflare Workers with Node.js compatibility, which is on by default for
 compatibility dates of 2026-08-04 or later; earlier dates need the `nodejs_compat` flag). ESM-only;
 CJS consumers can `require()` it on Node >= 20.19.
@@ -59,12 +59,16 @@ Without an API key every call is a silent no-op — the SDK never throws into yo
 
 ## Configuration
 
-| Option        | Env var                     | Default                        |
-| ------------- | --------------------------- | ------------------------------ |
-| `apiKey`      | `TELEMETRY_DEV_API_KEY`     | — (absent ⇒ no-op)             |
-| `baseUrl`     | `TELEMETRY_DEV_BASE_URL`    | `https://ingest.telemetry.dev` |
-| `environment` | `TELEMETRY_DEV_ENVIRONMENT` | `production`                   |
-| `serviceName` | `OTEL_SERVICE_NAME`         | `unknown_service`              |
+| Option        | Env var                     | Default                     |
+| ------------- | --------------------------- | --------------------------- |
+| `apiKey`      | `TELEMETRY_DEV_API_KEY`     | — (absent ⇒ no-op)          |
+| `baseUrl`     | `TELEMETRY_DEV_BASE_URL`    | `https://api.telemetry.dev` |
+| `environment` | `TELEMETRY_DEV_ENVIRONMENT` | `production`                |
+| `serviceName` | `OTEL_SERVICE_NAME`         | `unknown_service`           |
+
+Earlier versions sent data to `https://ingest.telemetry.dev` by default. That hostname reaches the
+same service and stays supported: if a firewall allows only it, set `TELEMETRY_DEV_BASE_URL` or
+`baseUrl` to it.
 
 Other `init()` options: `enabled` (kill switch), `registerGlobal`, `exportMode: "batched" |
 "immediate"`, `captureInput` / `captureOutput`, `mask(value, { key })` redaction hook,
@@ -157,7 +161,7 @@ const pinned = await getPrompt("support/reply", { version: 13 });
   its prompt.
 - getPrompt uses the API key and base URL of an enabled `init()`, or `TELEMETRY_DEV_API_KEY` and
   `TELEMETRY_DEV_BASE_URL`, or its own `apiKey`, `baseUrl`, and `fetch` options. It reads the same
-  host that telemetry goes to, `https://ingest.telemetry.dev` by default. The key needs the read
+  host that telemetry goes to, `https://api.telemetry.dev` by default. The key needs the read
   scope for prompts.
 - When a label sends part of the traffic to a second version, each session keeps one version: the
   choice uses the session id of `propagateAttributes` (or of `sessionMode: "process"`). Without a
@@ -268,7 +272,7 @@ Alternatively `init({ registerGlobal: true })` makes the SDK's provider the app'
 that mode only this SDK's spans are exported by default.
 
 Any vanilla OTel app can also skip the SDK entirely: point a stock OTLP/HTTP protobuf exporter at
-`https://ingest.telemetry.dev/v1/traces` with an `Authorization: Bearer td_live_...` header.
+`https://api.telemetry.dev/v1/traces` with an `Authorization: Bearer td_live_...` header.
 
 ### Native Claude SDK spans
 

package/dist/index.d.mts

@@ -16,7 +16,7 @@ type MaskFn<T = unknown> = (value: T, ctx: {
 interface TelemetryOptions {
   /** telemetry.dev ingest key (`td_live_…`). Falls back to `TELEMETRY_DEV_API_KEY`. When absent the SDK is a no-op. */
   apiKey?: string;
-  /** Base URL for telemetry export and getPrompt. Falls back to `TELEMETRY_DEV_BASE_URL`, then `https://ingest.telemetry.dev`. */
+  /** Base URL for telemetry export and getPrompt. Falls back to `TELEMETRY_DEV_BASE_URL`, then `https://api.telemetry.dev`. */
   baseUrl?: string;
   /** Deployment environment label. Falls back to `TELEMETRY_DEV_ENVIRONMENT`, then `production`. */
   environment?: string;
@@ -355,7 +355,7 @@ interface GetPromptOptionsBase {
   cacheTtlSeconds?: number;
   /** API key with the prompts:read scope. Falls back to the initialized client, then `TELEMETRY_DEV_API_KEY`. */
   apiKey?: string;
-  /** Falls back to the initialized client, then `TELEMETRY_DEV_BASE_URL`, then `https://ingest.telemetry.dev`. */
+  /** Falls back to the initialized client, then `TELEMETRY_DEV_BASE_URL`, then `https://api.telemetry.dev`. */
   baseUrl?: string;
   /** Falls back to the initialized client's `fetch`, then `globalThis.fetch`. */
   fetch?: typeof fetch;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@telemetry-dev/sdk",
-  "version": "0.1.12",
+  "version": "0.2.0",
   "description": "Pure TypeScript SDK for telemetry.dev: LLM traces, logs, and GenAI metrics on OpenTelemetry, for Node and edge runtimes.",
   "keywords": [
     "genai",
@@ -42,7 +42,7 @@
     "@opentelemetry/sdk-logs": "^0.223.0",
     "@opentelemetry/sdk-metrics": "^2.12.0",
     "@opentelemetry/sdk-trace-base": "^2.12.0",
-    "@telemetry-dev/otel": "^0.1.7"
+    "@telemetry-dev/otel": "^0.2.0"
   },
   "devDependencies": {
     "@opentelemetry/api": "^1.9.1",

package/src/config.ts

@@ -22,7 +22,7 @@ export type MaskFn<T = unknown> = (value: T, ctx: { key: string }) => T;
 export interface TelemetryOptions {
   /** telemetry.dev ingest key (`td_live_…`). Falls back to `TELEMETRY_DEV_API_KEY`. When absent the SDK is a no-op. */
   apiKey?: string;
-  /** Base URL for telemetry export and getPrompt. Falls back to `TELEMETRY_DEV_BASE_URL`, then `https://ingest.telemetry.dev`. */
+  /** Base URL for telemetry export and getPrompt. Falls back to `TELEMETRY_DEV_BASE_URL`, then `https://api.telemetry.dev`. */
   baseUrl?: string;
   /** Deployment environment label. Falls back to `TELEMETRY_DEV_ENVIRONMENT`, then `production`. */
   environment?: string;

package/src/prompts.ts

@@ -118,7 +118,7 @@ interface GetPromptOptionsBase {
   cacheTtlSeconds?: number;
   /** API key with the prompts:read scope. Falls back to the initialized client, then `TELEMETRY_DEV_API_KEY`. */
   apiKey?: string;
-  /** Falls back to the initialized client, then `TELEMETRY_DEV_BASE_URL`, then `https://ingest.telemetry.dev`. */
+  /** Falls back to the initialized client, then `TELEMETRY_DEV_BASE_URL`, then `https://api.telemetry.dev`. */
   baseUrl?: string;
   /** Falls back to the initialized client's `fetch`, then `globalThis.fetch`. */
   fetch?: typeof fetch;