@breadcrumb-sdk/core 0.0.2

package/README.md

@@ -0,0 +1,143 @@
+# @breadcrumb-sdk/core
+
+Trace your AI agents and pipelines with Breadcrumb.
+
+## Install
+
+```bash
+npm install @breadcrumb-sdk/core
+```
+
+## Quick start
+
+```ts
+import { init } from "@breadcrumb-sdk/core";
+
+const bc = init({
+  apiKey: "bc_...",
+  baseUrl: "https://your-breadcrumb-instance.com",
+});
+
+const answer = await bc.trace("answer-question", async (root) => {
+  root.set({ input: "What is TypeScript?" });
+
+  const docs = await bc.span("retrieve", async (span) => {
+    span.set({ metadata: { source: "docs", top_k: 5 } });
+    return await fetchDocs(query);
+  }, { type: "retrieval" });
+
+  const result = await bc.span("generate", async (span) => {
+    const output = await callLlm(docs);
+    span.set({
+      input: docs.join("\n"),
+      output: output.text,
+      model: "claude-opus-4-6",
+      provider: "anthropic",
+      input_tokens: output.inputTokens,
+      output_tokens: output.outputTokens,
+    });
+    return output.text;
+  }, { type: "llm" });
+
+  root.set({ output: result });
+  return result;
+});
+```
+
+## API
+
+### `init(options)`
+
+Call once at startup. Returns a `bc` instance you use to create traces and spans.
+
+```ts
+const bc = init({
+  apiKey: string,
+  baseUrl: string,
+  batching?: false | {
+    flushInterval?: number,  // ms between sends (default: 5000)
+    maxBatchSize?: number,   // spans per send (default: 100)
+  }
+})
+```
+
+Set `batching: false` to send each span as it finishes. The default batches them. Either way, everything is flushed before the process exits.
+
+---
+
+### `bc.trace(name, fn)`
+
+Starts a new top-level trace. Everything you call inside `fn` that uses `bc.span()` will be nested under it in the UI.
+
+```ts
+await bc.trace("my-agent", async (span) => {
+  span.set({ input: userMessage });
+  // ... your agent logic
+});
+```
+
+Always creates a fresh trace — if you call `bc.trace()` inside another `bc.trace()`, you get two separate traces, not a nested one. Use `bc.span()` for nesting.
+
+The span closes automatically when `fn` returns. If `fn` throws, the span is marked as failed and the error is rethrown.
+
+---
+
+### `bc.span(name, fn, options?)`
+
+Adds a step inside the currently running trace. Spans nest automatically — a span inside a span inside a trace shows as a tree in the UI.
+
+If called outside any trace, it starts its own trace.
+
+```ts
+const result = await bc.span(
+  "classify",
+  async (span) => {
+    span.set({ model: "gpt-4o", provider: "openai" });
+    return await classify(input);
+  },
+  { type: "llm" }
+);
+```
+
+**Options:**
+
+| Option | Values |
+|--------|--------|
+| `type` | `"llm"` `"tool"` `"retrieval"` `"step"` |
+
+---
+
+### `span.set(data)`
+
+Attach data to a span. Call it any time while the span is open.
+
+```ts
+span.set({
+  input: "What is TypeScript?",        // shown in the UI
+  output: "A typed superset of JS.",   // shown in the UI
+  model: "claude-opus-4-6",
+  provider: "anthropic",
+  input_tokens: 312,
+  output_tokens: 58,
+  input_cost_usd: 0.00093,
+  output_cost_usd: 0.00087,
+  metadata: {
+    score: 0.95,
+    environment: "production",
+  },
+});
+```
+
+All fields are optional. `null` and `undefined` are ignored.
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `input` | `unknown` | Input passed to this step |
+| `output` | `unknown` | Output produced by this step |
+| `model` | `string` | Model name, e.g. `"gpt-4o"` |
+| `provider` | `string` | Provider, e.g. `"openai"` |
+| `input_tokens` | `number` | Input token count |
+| `output_tokens` | `number` | Output token count |
+| `input_cost_usd` | `number` | Input cost in USD |
+| `output_cost_usd` | `number` | Output cost in USD |
+| `metadata` | `Record<string, string \| number \| boolean>` | Any extra data |

package/dist/index.cjs

@@ -0,0 +1,319 @@
+"use strict";
+//#region rolldown:runtime
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+	if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
+		key = keys[i];
+		if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
+			get: ((k) => from[k]).bind(null, key),
+			enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+		});
+	}
+	return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
+	value: mod,
+	enumerable: true
+}) : target, mod));
+
+//#endregion
+const __opentelemetry_api = __toESM(require("@opentelemetry/api"));
+const __opentelemetry_sdk_trace_node = __toESM(require("@opentelemetry/sdk-trace-node"));
+const __opentelemetry_sdk_trace_base = __toESM(require("@opentelemetry/sdk-trace-base"));
+const __opentelemetry_core = __toESM(require("@opentelemetry/core"));
+
+//#region src/exporter.ts
+const LLM_SPAN_NAMES = new Set([
+	"ai.generateText",
+	"ai.generateText.doGenerate",
+	"ai.streamText",
+	"ai.streamText.doStream",
+	"ai.generateObject",
+	"ai.generateObject.doGenerate",
+	"ai.generateObject.doStream"
+]);
+const TOOL_SPAN_NAMES = new Set([
+	"ai.toolCall",
+	"ai.toolExecution",
+	"ai.executeToolCall"
+]);
+const HANDLED_ATTRS = new Set([
+	"breadcrumb.span.type",
+	"breadcrumb.input",
+	"breadcrumb.output",
+	"breadcrumb.model",
+	"breadcrumb.provider",
+	"breadcrumb.input_tokens",
+	"breadcrumb.output_tokens",
+	"breadcrumb.input_cost_usd",
+	"breadcrumb.output_cost_usd",
+	"ai.prompt.messages",
+	"ai.response.text",
+	"ai.model.id",
+	"ai.model.provider",
+	"ai.response.model",
+	"gen_ai.request.model",
+	"gen_ai.system",
+	"ai.usage.inputTokens",
+	"ai.usage.promptTokens",
+	"ai.usage.outputTokens",
+	"ai.usage.completionTokens",
+	"gen_ai.usage.input_tokens",
+	"gen_ai.usage.output_tokens",
+	"ai.response.providerMetadata",
+	"ai.response.finishReason"
+]);
+const DROP_ATTRS = new Set([
+	"operation.name",
+	"resource.name",
+	"ai.operationId",
+	"ai.telemetry.functionId",
+	"gen_ai.response.finish_reasons",
+	"gen_ai.response.id",
+	"gen_ai.response.model",
+	"ai.response.id",
+	"ai.response.timestamp"
+]);
+function hrTimeToISO(hrTime) {
+	return new Date(hrTime[0] * 1e3 + hrTime[1] / 1e6).toISOString();
+}
+function spanStatus(span) {
+	return span.status.code === __opentelemetry_api.SpanStatusCode.ERROR ? "error" : "ok";
+}
+function strAttr(span, ...keys) {
+	for (const key of keys) {
+		const v = span.attributes[key];
+		if (typeof v === "string" && v !== "") return v;
+	}
+	return void 0;
+}
+function intAttr(span, ...keys) {
+	for (const key of keys) {
+		const v = span.attributes[key];
+		if (typeof v === "number") return Math.round(v);
+	}
+	return void 0;
+}
+function floatAttr(span, ...keys) {
+	for (const key of keys) {
+		const v = span.attributes[key];
+		if (typeof v === "number") return v;
+	}
+	return void 0;
+}
+function tryJson(s) {
+	try {
+		return JSON.parse(s);
+	} catch {
+		return void 0;
+	}
+}
+function inferSpanType(span) {
+	const explicit = span.attributes["breadcrumb.span.type"];
+	if (typeof explicit === "string" && explicit !== "") return explicit;
+	if (LLM_SPAN_NAMES.has(span.name)) return "llm";
+	if (TOOL_SPAN_NAMES.has(span.name)) return "tool";
+	return "custom";
+}
+function extractCost(span) {
+	const raw = span.attributes["ai.response.providerMetadata"];
+	if (typeof raw !== "string") return {};
+	try {
+		const parsed = tryJson(raw);
+		if (!parsed || typeof parsed !== "object") return {};
+		for (const providerData of Object.values(parsed)) {
+			const usage = providerData?.usage;
+			if (!usage) continue;
+			const totalCost = usage["cost"];
+			if (typeof totalCost !== "number") continue;
+			const prompt = typeof usage["promptTokens"] === "number" ? usage["promptTokens"] : 0;
+			const completion = typeof usage["completionTokens"] === "number" ? usage["completionTokens"] : 0;
+			const total = prompt + completion;
+			if (total > 0) return {
+				input_cost_usd: totalCost * (prompt / total),
+				output_cost_usd: totalCost * (completion / total)
+			};
+			return { input_cost_usd: totalCost };
+		}
+	} catch {}
+	return {};
+}
+var BreadcrumbSpanExporter = class {
+	constructor(apiKey, baseUrl) {
+		this.apiKey = apiKey;
+		this.baseUrl = baseUrl;
+	}
+	export(spans, resultCallback) {
+		this._export(spans).then(() => resultCallback({ code: __opentelemetry_core.ExportResultCode.SUCCESS }), () => resultCallback({ code: __opentelemetry_core.ExportResultCode.SUCCESS }));
+	}
+	async _export(spans) {
+		try {
+			const roots = spans.filter((s) => !s.parentSpanId);
+			const spanPayloads = spans.map((s) => this._mapSpan(s));
+			const sends = roots.map((s) => this._sendTrace(s));
+			if (spanPayloads.length > 0) sends.push(this._post("/v1/spans", spanPayloads));
+			await Promise.all(sends);
+		} catch {}
+	}
+	_mapSpan(span) {
+		const ctx = span.spanContext();
+		const attrs = span.attributes;
+		let input;
+		const bcInput = attrs["breadcrumb.input"];
+		const aiMessages = attrs["ai.prompt.messages"];
+		if (bcInput != null) input = typeof bcInput === "string" ? tryJson(bcInput) ?? bcInput : bcInput;
+		else if (typeof aiMessages === "string") input = tryJson(aiMessages) ?? aiMessages;
+		let output;
+		const bcOutput = attrs["breadcrumb.output"];
+		const aiText = attrs["ai.response.text"];
+		if (bcOutput != null) output = typeof bcOutput === "string" ? tryJson(bcOutput) ?? bcOutput : bcOutput;
+		else if (typeof aiText === "string") output = aiText;
+		const model = strAttr(span, "breadcrumb.model", "ai.model.id", "ai.response.model", "gen_ai.request.model");
+		const provider = strAttr(span, "breadcrumb.provider", "ai.model.provider", "gen_ai.system");
+		const input_tokens = intAttr(span, "breadcrumb.input_tokens", "ai.usage.inputTokens", "ai.usage.promptTokens", "gen_ai.usage.input_tokens");
+		const output_tokens = intAttr(span, "breadcrumb.output_tokens", "ai.usage.outputTokens", "ai.usage.completionTokens", "gen_ai.usage.output_tokens");
+		let input_cost_usd = floatAttr(span, "breadcrumb.input_cost_usd");
+		let output_cost_usd = floatAttr(span, "breadcrumb.output_cost_usd");
+		if (input_cost_usd == null && output_cost_usd == null) {
+			const cost = extractCost(span);
+			input_cost_usd = cost.input_cost_usd;
+			output_cost_usd = cost.output_cost_usd;
+		}
+		const metadata = {};
+		for (const [k, v] of Object.entries(attrs)) {
+			if (v == null) continue;
+			if (HANDLED_ATTRS.has(k) || DROP_ATTRS.has(k)) continue;
+			if (k.startsWith("ai.settings.")) continue;
+			if (k.startsWith("ai.request.headers.")) continue;
+			if (k.startsWith("breadcrumb.")) {
+				if (k.startsWith("breadcrumb.meta.")) metadata[k.slice(16)] = String(v);
+				continue;
+			}
+			if (k.startsWith("ai.telemetry.metadata.")) {
+				metadata[k.slice(22)] = String(v);
+				continue;
+			}
+			if (k === "ai.response.finishReason") {
+				metadata["finish_reason"] = String(v);
+				continue;
+			}
+			metadata[k] = String(v);
+		}
+		return {
+			id: ctx.spanId,
+			trace_id: ctx.traceId,
+			parent_span_id: span.parentSpanId || void 0,
+			name: span.name,
+			type: inferSpanType(span),
+			start_time: hrTimeToISO(span.startTime),
+			end_time: hrTimeToISO(span.endTime),
+			status: spanStatus(span),
+			status_message: span.status.message || void 0,
+			input: input !== void 0 ? input : void 0,
+			output: output !== void 0 ? output : void 0,
+			provider,
+			model,
+			input_tokens,
+			output_tokens,
+			input_cost_usd,
+			output_cost_usd,
+			metadata: Object.keys(metadata).length > 0 ? metadata : void 0
+		};
+	}
+	async _sendTrace(span) {
+		const ctx = span.spanContext();
+		await this._post("/v1/traces", {
+			id: ctx.traceId,
+			name: span.name,
+			start_time: hrTimeToISO(span.startTime),
+			end_time: hrTimeToISO(span.endTime),
+			status: spanStatus(span),
+			status_message: span.status.message || void 0
+		});
+	}
+	async _post(path, body) {
+		try {
+			await fetch(`${this.baseUrl}${path}`, {
+				method: "POST",
+				headers: {
+					"Content-Type": "application/json",
+					Authorization: `Bearer ${this.apiKey}`
+				},
+				body: JSON.stringify(body)
+			});
+		} catch {}
+	}
+	shutdown() {
+		return Promise.resolve();
+	}
+	forceFlush() {
+		return Promise.resolve();
+	}
+};
+
+//#endregion
+//#region src/index.ts
+function init(options) {
+	const exporter = new BreadcrumbSpanExporter(options.apiKey, options.baseUrl);
+	const batchOpts = typeof options.batching === "object" ? options.batching : void 0;
+	const processor = options.batching === false ? new __opentelemetry_sdk_trace_base.SimpleSpanProcessor(exporter) : new __opentelemetry_sdk_trace_base.BatchSpanProcessor(exporter, {
+		scheduledDelayMillis: batchOpts?.flushInterval ?? 5e3,
+		maxExportBatchSize: batchOpts?.maxBatchSize ?? 100
+	});
+	const provider = new __opentelemetry_sdk_trace_node.NodeTracerProvider({ spanProcessors: [processor] });
+	provider.register();
+	process.once("beforeExit", async () => {
+		await provider.shutdown().catch(() => {});
+	});
+	const tracer = provider.getTracer("@breadcrumb-sdk/core");
+	function runSpan(otelSpan, activeCtx, fn) {
+		const bcSpan = { set(data) {
+			const { metadata,...semantic } = data;
+			for (const [key, value] of Object.entries(semantic)) {
+				if (value == null) continue;
+				const attrKey = `breadcrumb.${key}`;
+				if (typeof value === "string" || typeof value === "number" || typeof value === "boolean") otelSpan.setAttribute(attrKey, value);
+				else otelSpan.setAttribute(attrKey, JSON.stringify(value));
+			}
+			if (metadata) for (const [key, value] of Object.entries(metadata)) {
+				if (value == null) continue;
+				otelSpan.setAttribute(`breadcrumb.meta.${key}`, value);
+			}
+		} };
+		return __opentelemetry_api.context.with(__opentelemetry_api.trace.setSpan(activeCtx, otelSpan), async () => {
+			try {
+				const result = await fn(bcSpan);
+				otelSpan.setStatus({ code: __opentelemetry_api.SpanStatusCode.OK });
+				otelSpan.end();
+				return result;
+			} catch (err) {
+				otelSpan.setStatus({
+					code: __opentelemetry_api.SpanStatusCode.ERROR,
+					message: err instanceof Error ? err.message : String(err)
+				});
+				otelSpan.end();
+				throw err;
+			}
+		});
+	}
+	return {
+		trace(name, fn) {
+			const otelSpan = tracer.startSpan(name, {}, __opentelemetry_api.ROOT_CONTEXT);
+			return runSpan(otelSpan, __opentelemetry_api.ROOT_CONTEXT, fn);
+		},
+		span(name, fn, options$1) {
+			const activeCtx = __opentelemetry_api.context.active();
+			const otelSpan = tracer.startSpan(name, {}, activeCtx);
+			if (options$1?.type) otelSpan.setAttribute("breadcrumb.span.type", options$1.type);
+			return runSpan(otelSpan, activeCtx, fn);
+		}
+	};
+}
+
+//#endregion
+exports.init = init

package/dist/index.d.cts

@@ -0,0 +1,39 @@
+//#region src/types.d.ts
+interface SpanData {
+  input?: unknown;
+  output?: unknown;
+  model?: string;
+  provider?: string;
+  input_tokens?: number;
+  output_tokens?: number;
+  input_cost_usd?: number;
+  output_cost_usd?: number;
+  metadata?: Record<string, string | number | boolean>;
+}
+interface BreadcrumbSpan {
+  set(data: SpanData): void;
+}
+interface SpanOptions {
+  type?: "llm" | "tool" | "retrieval" | "step";
+}
+interface Breadcrumb {
+  trace<T>(name: string, fn: (span: BreadcrumbSpan) => Promise<T>): Promise<T>;
+  span<T>(name: string, fn: (span: BreadcrumbSpan) => Promise<T>, options?: SpanOptions): Promise<T>;
+} //#endregion
+//#region src/index.d.ts
+//# sourceMappingURL=types.d.ts.map
+interface InitOptions {
+  apiKey: string;
+  baseUrl: string;
+  batching?: false | {
+    flushInterval?: number;
+    maxBatchSize?: number;
+  };
+}
+declare function init(options: InitOptions): Breadcrumb;
+
+//#endregion
+//# sourceMappingURL=index.d.ts.map
+
+export { Breadcrumb, BreadcrumbSpan, InitOptions, SpanOptions, init };
+//# sourceMappingURL=index.d.cts.map

package/dist/index.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.cts","names":[],"sources":["../src/types.ts","../src/index.ts"],"sourcesContent":null,"mappings":";UAAiB,QAAA;EAAA,KAAA,CAAA,EAAA,OAAQ;EAYR,MAAA,CAAA,EAAA,OAAA;EAIA,KAAA,CAAA,EAAA,MAAW;EAIX,QAAA,CAAA,EAAA,MAAU;EAAA,YAAA,CAAA,EAAA,MAAA;EAAA,aACS,CAAA,EAAA,MAAA;EAAc,cAAa,CAAA,EAAA,MAAA;EAAC,eAAT,CAAA,EAAA,MAAA;EAAO,QAAc,CAAA,EAZ/D,MAY+D,CAAA,MAAA,EAAA,MAAA,GAAA,MAAA,GAAA,OAAA,CAAA;;AAG7D,UAZE,cAAA,CAYF;EAAc,GAAa,CAAA,IAAA,EAX9B,QAW8B,CAAA,EAAA,IAAA;;AAC5B,UATG,WAAA,CASH;EAAW,IACZ,CAAA,EAAA,KAAA,GAAA,MAAA,GAAA,WAAA,GAAA,MAAA;;AAAD,UANK,UAAA,CAML;oCALwB,mBAAmB,QAAQ,KAAK,QAAQ;mCAG7D,mBAAmB,QAAQ,cAC5B,cACT,QAAQ;;;ACTb;ADLiB,UCKA,WAAA,CDLc;EAId,MAAA,EAAA,MAAW;EAIX,OAAA,EAAA,MAAU;EAAA,QAAA,CAAA,EAAA,KAAA,GAAA;IACS,aAAA,CAAA,EAAA,MAAA;IAA2B,YAAA,CAAA,EAAA,MAAA;EAAC,CAAA;;AAAI,iBCOpD,IAAA,CDPoD,OAAA,ECOtC,WDPsC,CAAA,ECOxB,UDPwB"}

package/dist/index.d.ts

@@ -0,0 +1,39 @@
+//#region src/types.d.ts
+interface SpanData {
+  input?: unknown;
+  output?: unknown;
+  model?: string;
+  provider?: string;
+  input_tokens?: number;
+  output_tokens?: number;
+  input_cost_usd?: number;
+  output_cost_usd?: number;
+  metadata?: Record<string, string | number | boolean>;
+}
+interface BreadcrumbSpan {
+  set(data: SpanData): void;
+}
+interface SpanOptions {
+  type?: "llm" | "tool" | "retrieval" | "step";
+}
+interface Breadcrumb {
+  trace<T>(name: string, fn: (span: BreadcrumbSpan) => Promise<T>): Promise<T>;
+  span<T>(name: string, fn: (span: BreadcrumbSpan) => Promise<T>, options?: SpanOptions): Promise<T>;
+} //#endregion
+//#region src/index.d.ts
+//# sourceMappingURL=types.d.ts.map
+interface InitOptions {
+  apiKey: string;
+  baseUrl: string;
+  batching?: false | {
+    flushInterval?: number;
+    maxBatchSize?: number;
+  };
+}
+declare function init(options: InitOptions): Breadcrumb;
+
+//#endregion
+//# sourceMappingURL=index.d.ts.map
+
+export { Breadcrumb, BreadcrumbSpan, InitOptions, SpanOptions, init };
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":[],"sources":["../src/types.ts","../src/index.ts"],"sourcesContent":null,"mappings":";UAAiB,QAAA;EAAA,KAAA,CAAA,EAAA,OAAQ;EAYR,MAAA,CAAA,EAAA,OAAA;EAIA,KAAA,CAAA,EAAA,MAAW;EAIX,QAAA,CAAA,EAAA,MAAU;EAAA,YAAA,CAAA,EAAA,MAAA;EAAA,aACS,CAAA,EAAA,MAAA;EAAc,cAAa,CAAA,EAAA,MAAA;EAAC,eAAT,CAAA,EAAA,MAAA;EAAO,QAAc,CAAA,EAZ/D,MAY+D,CAAA,MAAA,EAAA,MAAA,GAAA,MAAA,GAAA,OAAA,CAAA;;AAG7D,UAZE,cAAA,CAYF;EAAc,GAAa,CAAA,IAAA,EAX9B,QAW8B,CAAA,EAAA,IAAA;;AAC5B,UATG,WAAA,CASH;EAAW,IACZ,CAAA,EAAA,KAAA,GAAA,MAAA,GAAA,WAAA,GAAA,MAAA;;AAAD,UANK,UAAA,CAML;oCALwB,mBAAmB,QAAQ,KAAK,QAAQ;mCAG7D,mBAAmB,QAAQ,cAC5B,cACT,QAAQ;;;ACTb;ADLiB,UCKA,WAAA,CDLc;EAId,MAAA,EAAA,MAAW;EAIX,OAAA,EAAA,MAAU;EAAA,QAAA,CAAA,EAAA,KAAA,GAAA;IACS,aAAA,CAAA,EAAA,MAAA;IAA2B,YAAA,CAAA,EAAA,MAAA;EAAC,CAAA;;AAAI,iBCOpD,IAAA,CDPoD,OAAA,ECOtC,WDPsC,CAAA,ECOxB,UDPwB"}

package/dist/index.js

@@ -0,0 +1,296 @@
+import { ROOT_CONTEXT, SpanStatusCode, context, trace } from "@opentelemetry/api";
+import { NodeTracerProvider } from "@opentelemetry/sdk-trace-node";
+import { BatchSpanProcessor, SimpleSpanProcessor } from "@opentelemetry/sdk-trace-base";
+import { ExportResultCode } from "@opentelemetry/core";
+
+//#region src/exporter.ts
+const LLM_SPAN_NAMES = new Set([
+	"ai.generateText",
+	"ai.generateText.doGenerate",
+	"ai.streamText",
+	"ai.streamText.doStream",
+	"ai.generateObject",
+	"ai.generateObject.doGenerate",
+	"ai.generateObject.doStream"
+]);
+const TOOL_SPAN_NAMES = new Set([
+	"ai.toolCall",
+	"ai.toolExecution",
+	"ai.executeToolCall"
+]);
+const HANDLED_ATTRS = new Set([
+	"breadcrumb.span.type",
+	"breadcrumb.input",
+	"breadcrumb.output",
+	"breadcrumb.model",
+	"breadcrumb.provider",
+	"breadcrumb.input_tokens",
+	"breadcrumb.output_tokens",
+	"breadcrumb.input_cost_usd",
+	"breadcrumb.output_cost_usd",
+	"ai.prompt.messages",
+	"ai.response.text",
+	"ai.model.id",
+	"ai.model.provider",
+	"ai.response.model",
+	"gen_ai.request.model",
+	"gen_ai.system",
+	"ai.usage.inputTokens",
+	"ai.usage.promptTokens",
+	"ai.usage.outputTokens",
+	"ai.usage.completionTokens",
+	"gen_ai.usage.input_tokens",
+	"gen_ai.usage.output_tokens",
+	"ai.response.providerMetadata",
+	"ai.response.finishReason"
+]);
+const DROP_ATTRS = new Set([
+	"operation.name",
+	"resource.name",
+	"ai.operationId",
+	"ai.telemetry.functionId",
+	"gen_ai.response.finish_reasons",
+	"gen_ai.response.id",
+	"gen_ai.response.model",
+	"ai.response.id",
+	"ai.response.timestamp"
+]);
+function hrTimeToISO(hrTime) {
+	return new Date(hrTime[0] * 1e3 + hrTime[1] / 1e6).toISOString();
+}
+function spanStatus(span) {
+	return span.status.code === SpanStatusCode.ERROR ? "error" : "ok";
+}
+function strAttr(span, ...keys) {
+	for (const key of keys) {
+		const v = span.attributes[key];
+		if (typeof v === "string" && v !== "") return v;
+	}
+	return void 0;
+}
+function intAttr(span, ...keys) {
+	for (const key of keys) {
+		const v = span.attributes[key];
+		if (typeof v === "number") return Math.round(v);
+	}
+	return void 0;
+}
+function floatAttr(span, ...keys) {
+	for (const key of keys) {
+		const v = span.attributes[key];
+		if (typeof v === "number") return v;
+	}
+	return void 0;
+}
+function tryJson(s) {
+	try {
+		return JSON.parse(s);
+	} catch {
+		return void 0;
+	}
+}
+function inferSpanType(span) {
+	const explicit = span.attributes["breadcrumb.span.type"];
+	if (typeof explicit === "string" && explicit !== "") return explicit;
+	if (LLM_SPAN_NAMES.has(span.name)) return "llm";
+	if (TOOL_SPAN_NAMES.has(span.name)) return "tool";
+	return "custom";
+}
+function extractCost(span) {
+	const raw = span.attributes["ai.response.providerMetadata"];
+	if (typeof raw !== "string") return {};
+	try {
+		const parsed = tryJson(raw);
+		if (!parsed || typeof parsed !== "object") return {};
+		for (const providerData of Object.values(parsed)) {
+			const usage = providerData?.usage;
+			if (!usage) continue;
+			const totalCost = usage["cost"];
+			if (typeof totalCost !== "number") continue;
+			const prompt = typeof usage["promptTokens"] === "number" ? usage["promptTokens"] : 0;
+			const completion = typeof usage["completionTokens"] === "number" ? usage["completionTokens"] : 0;
+			const total = prompt + completion;
+			if (total > 0) return {
+				input_cost_usd: totalCost * (prompt / total),
+				output_cost_usd: totalCost * (completion / total)
+			};
+			return { input_cost_usd: totalCost };
+		}
+	} catch {}
+	return {};
+}
+var BreadcrumbSpanExporter = class {
+	constructor(apiKey, baseUrl) {
+		this.apiKey = apiKey;
+		this.baseUrl = baseUrl;
+	}
+	export(spans, resultCallback) {
+		this._export(spans).then(() => resultCallback({ code: ExportResultCode.SUCCESS }), () => resultCallback({ code: ExportResultCode.SUCCESS }));
+	}
+	async _export(spans) {
+		try {
+			const roots = spans.filter((s) => !s.parentSpanId);
+			const spanPayloads = spans.map((s) => this._mapSpan(s));
+			const sends = roots.map((s) => this._sendTrace(s));
+			if (spanPayloads.length > 0) sends.push(this._post("/v1/spans", spanPayloads));
+			await Promise.all(sends);
+		} catch {}
+	}
+	_mapSpan(span) {
+		const ctx = span.spanContext();
+		const attrs = span.attributes;
+		let input;
+		const bcInput = attrs["breadcrumb.input"];
+		const aiMessages = attrs["ai.prompt.messages"];
+		if (bcInput != null) input = typeof bcInput === "string" ? tryJson(bcInput) ?? bcInput : bcInput;
+		else if (typeof aiMessages === "string") input = tryJson(aiMessages) ?? aiMessages;
+		let output;
+		const bcOutput = attrs["breadcrumb.output"];
+		const aiText = attrs["ai.response.text"];
+		if (bcOutput != null) output = typeof bcOutput === "string" ? tryJson(bcOutput) ?? bcOutput : bcOutput;
+		else if (typeof aiText === "string") output = aiText;
+		const model = strAttr(span, "breadcrumb.model", "ai.model.id", "ai.response.model", "gen_ai.request.model");
+		const provider = strAttr(span, "breadcrumb.provider", "ai.model.provider", "gen_ai.system");
+		const input_tokens = intAttr(span, "breadcrumb.input_tokens", "ai.usage.inputTokens", "ai.usage.promptTokens", "gen_ai.usage.input_tokens");
+		const output_tokens = intAttr(span, "breadcrumb.output_tokens", "ai.usage.outputTokens", "ai.usage.completionTokens", "gen_ai.usage.output_tokens");
+		let input_cost_usd = floatAttr(span, "breadcrumb.input_cost_usd");
+		let output_cost_usd = floatAttr(span, "breadcrumb.output_cost_usd");
+		if (input_cost_usd == null && output_cost_usd == null) {
+			const cost = extractCost(span);
+			input_cost_usd = cost.input_cost_usd;
+			output_cost_usd = cost.output_cost_usd;
+		}
+		const metadata = {};
+		for (const [k, v] of Object.entries(attrs)) {
+			if (v == null) continue;
+			if (HANDLED_ATTRS.has(k) || DROP_ATTRS.has(k)) continue;
+			if (k.startsWith("ai.settings.")) continue;
+			if (k.startsWith("ai.request.headers.")) continue;
+			if (k.startsWith("breadcrumb.")) {
+				if (k.startsWith("breadcrumb.meta.")) metadata[k.slice(16)] = String(v);
+				continue;
+			}
+			if (k.startsWith("ai.telemetry.metadata.")) {
+				metadata[k.slice(22)] = String(v);
+				continue;
+			}
+			if (k === "ai.response.finishReason") {
+				metadata["finish_reason"] = String(v);
+				continue;
+			}
+			metadata[k] = String(v);
+		}
+		return {
+			id: ctx.spanId,
+			trace_id: ctx.traceId,
+			parent_span_id: span.parentSpanId || void 0,
+			name: span.name,
+			type: inferSpanType(span),
+			start_time: hrTimeToISO(span.startTime),
+			end_time: hrTimeToISO(span.endTime),
+			status: spanStatus(span),
+			status_message: span.status.message || void 0,
+			input: input !== void 0 ? input : void 0,
+			output: output !== void 0 ? output : void 0,
+			provider,
+			model,
+			input_tokens,
+			output_tokens,
+			input_cost_usd,
+			output_cost_usd,
+			metadata: Object.keys(metadata).length > 0 ? metadata : void 0
+		};
+	}
+	async _sendTrace(span) {
+		const ctx = span.spanContext();
+		await this._post("/v1/traces", {
+			id: ctx.traceId,
+			name: span.name,
+			start_time: hrTimeToISO(span.startTime),
+			end_time: hrTimeToISO(span.endTime),
+			status: spanStatus(span),
+			status_message: span.status.message || void 0
+		});
+	}
+	async _post(path, body) {
+		try {
+			await fetch(`${this.baseUrl}${path}`, {
+				method: "POST",
+				headers: {
+					"Content-Type": "application/json",
+					Authorization: `Bearer ${this.apiKey}`
+				},
+				body: JSON.stringify(body)
+			});
+		} catch {}
+	}
+	shutdown() {
+		return Promise.resolve();
+	}
+	forceFlush() {
+		return Promise.resolve();
+	}
+};
+
+//#endregion
+//#region src/index.ts
+function init(options) {
+	const exporter = new BreadcrumbSpanExporter(options.apiKey, options.baseUrl);
+	const batchOpts = typeof options.batching === "object" ? options.batching : void 0;
+	const processor = options.batching === false ? new SimpleSpanProcessor(exporter) : new BatchSpanProcessor(exporter, {
+		scheduledDelayMillis: batchOpts?.flushInterval ?? 5e3,
+		maxExportBatchSize: batchOpts?.maxBatchSize ?? 100
+	});
+	const provider = new NodeTracerProvider({ spanProcessors: [processor] });
+	provider.register();
+	process.once("beforeExit", async () => {
+		await provider.shutdown().catch(() => {});
+	});
+	const tracer = provider.getTracer("@breadcrumb-sdk/core");
+	function runSpan(otelSpan, activeCtx, fn) {
+		const bcSpan = { set(data) {
+			const { metadata,...semantic } = data;
+			for (const [key, value] of Object.entries(semantic)) {
+				if (value == null) continue;
+				const attrKey = `breadcrumb.${key}`;
+				if (typeof value === "string" || typeof value === "number" || typeof value === "boolean") otelSpan.setAttribute(attrKey, value);
+				else otelSpan.setAttribute(attrKey, JSON.stringify(value));
+			}
+			if (metadata) for (const [key, value] of Object.entries(metadata)) {
+				if (value == null) continue;
+				otelSpan.setAttribute(`breadcrumb.meta.${key}`, value);
+			}
+		} };
+		return context.with(trace.setSpan(activeCtx, otelSpan), async () => {
+			try {
+				const result = await fn(bcSpan);
+				otelSpan.setStatus({ code: SpanStatusCode.OK });
+				otelSpan.end();
+				return result;
+			} catch (err) {
+				otelSpan.setStatus({
+					code: SpanStatusCode.ERROR,
+					message: err instanceof Error ? err.message : String(err)
+				});
+				otelSpan.end();
+				throw err;
+			}
+		});
+	}
+	return {
+		trace(name, fn) {
+			const otelSpan = tracer.startSpan(name, {}, ROOT_CONTEXT);
+			return runSpan(otelSpan, ROOT_CONTEXT, fn);
+		},
+		span(name, fn, options$1) {
+			const activeCtx = context.active();
+			const otelSpan = tracer.startSpan(name, {}, activeCtx);
+			if (options$1?.type) otelSpan.setAttribute("breadcrumb.span.type", options$1.type);
+			return runSpan(otelSpan, activeCtx, fn);
+		}
+	};
+}
+
+//#endregion
+export { init };
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":["hrTime: [number, number]","span: ReadableSpan","s: string","apiKey: string","baseUrl: string","spans: ReadableSpan[]","resultCallback: (result: ExportResult) => void","sends: Promise<void>[]","input: unknown","output: unknown","metadata: Record<string, string>","path: string","body: unknown","options: InitOptions","otelSpan: OtelSpan","activeCtx: typeof ROOT_CONTEXT","fn: (span: BreadcrumbSpan) => Promise<T>","bcSpan: BreadcrumbSpan","name: string","options?: SpanOptions","options"],"sources":["../src/exporter.ts","../src/index.ts"],"sourcesContent":["import type { ExportResult } from \"@opentelemetry/core\";\nimport { ExportResultCode } from \"@opentelemetry/core\";\nimport type { SpanExporter, ReadableSpan } from \"@opentelemetry/sdk-trace-base\";\nimport { SpanStatusCode } from \"@opentelemetry/api\";\n\ntype SpanType = \"llm\" | \"tool\" | \"retrieval\" | \"step\" | \"custom\";\n\nconst LLM_SPAN_NAMES = new Set([\n  \"ai.generateText\",\n  \"ai.generateText.doGenerate\",\n  \"ai.streamText\",\n  \"ai.streamText.doStream\",\n  \"ai.generateObject\",\n  \"ai.generateObject.doGenerate\",\n  \"ai.generateObject.doStream\",\n]);\n\nconst TOOL_SPAN_NAMES = new Set([\n  \"ai.toolCall\",\n  \"ai.toolExecution\",\n  \"ai.executeToolCall\",\n]);\n\n// Attributes handled explicitly — excluded from metadata pass-through\nconst HANDLED_ATTRS = new Set([\n  // Breadcrumb native\n  \"breadcrumb.span.type\",\n  \"breadcrumb.input\",\n  \"breadcrumb.output\",\n  \"breadcrumb.model\",\n  \"breadcrumb.provider\",\n  \"breadcrumb.input_tokens\",\n  \"breadcrumb.output_tokens\",\n  \"breadcrumb.input_cost_usd\",\n  \"breadcrumb.output_cost_usd\",\n  // AI SDK - input/output\n  \"ai.prompt.messages\",\n  \"ai.response.text\",\n  // AI SDK - model/provider\n  \"ai.model.id\",\n  \"ai.model.provider\",\n  \"ai.response.model\",\n  \"gen_ai.request.model\",\n  \"gen_ai.system\",\n  // AI SDK - tokens\n  \"ai.usage.inputTokens\",\n  \"ai.usage.promptTokens\",\n  \"ai.usage.outputTokens\",\n  \"ai.usage.completionTokens\",\n  \"gen_ai.usage.input_tokens\",\n  \"gen_ai.usage.output_tokens\",\n  // AI SDK - cost source\n  \"ai.response.providerMetadata\",\n  // AI SDK - finish reason (renamed in metadata)\n  \"ai.response.finishReason\",\n]);\n\n// Attributes to drop entirely\nconst DROP_ATTRS = new Set([\n  \"operation.name\",\n  \"resource.name\",\n  \"ai.operationId\",\n  \"ai.telemetry.functionId\",\n  \"gen_ai.response.finish_reasons\",\n  \"gen_ai.response.id\",\n  \"gen_ai.response.model\",\n  \"ai.response.id\",\n  \"ai.response.timestamp\",\n]);\n\nfunction hrTimeToISO(hrTime: [number, number]): string {\n  return new Date(hrTime[0] * 1000 + hrTime[1] / 1_000_000).toISOString();\n}\n\nfunction spanStatus(span: ReadableSpan): \"ok\" | \"error\" {\n  return span.status.code === SpanStatusCode.ERROR ? \"error\" : \"ok\";\n}\n\nfunction strAttr(span: ReadableSpan, ...keys: string[]): string | undefined {\n  for (const key of keys) {\n    const v = span.attributes[key];\n    if (typeof v === \"string\" && v !== \"\") return v;\n  }\n  return undefined;\n}\n\nfunction intAttr(span: ReadableSpan, ...keys: string[]): number | undefined {\n  for (const key of keys) {\n    const v = span.attributes[key];\n    if (typeof v === \"number\") return Math.round(v);\n  }\n  return undefined;\n}\n\nfunction floatAttr(span: ReadableSpan, ...keys: string[]): number | undefined {\n  for (const key of keys) {\n    const v = span.attributes[key];\n    if (typeof v === \"number\") return v;\n  }\n  return undefined;\n}\n\nfunction tryJson(s: string): unknown {\n  try {\n    return JSON.parse(s);\n  } catch {\n    return undefined;\n  }\n}\n\nfunction inferSpanType(span: ReadableSpan): SpanType {\n  const explicit = span.attributes[\"breadcrumb.span.type\"];\n  if (typeof explicit === \"string\" && explicit !== \"\") return explicit as SpanType;\n  if (LLM_SPAN_NAMES.has(span.name)) return \"llm\";\n  if (TOOL_SPAN_NAMES.has(span.name)) return \"tool\";\n  return \"custom\";\n}\n\nfunction extractCost(\n  span: ReadableSpan,\n): { input_cost_usd?: number; output_cost_usd?: number } {\n  const raw = span.attributes[\"ai.response.providerMetadata\"];\n  if (typeof raw !== \"string\") return {};\n  try {\n    const parsed = tryJson(raw) as Record<string, unknown> | null;\n    if (!parsed || typeof parsed !== \"object\") return {};\n    for (const providerData of Object.values(parsed)) {\n      const usage = (providerData as Record<string, unknown>)?.usage as\n        | Record<string, unknown>\n        | undefined;\n      if (!usage) continue;\n      const totalCost = usage[\"cost\"];\n      if (typeof totalCost !== \"number\") continue;\n      const prompt = typeof usage[\"promptTokens\"] === \"number\" ? usage[\"promptTokens\"] : 0;\n      const completion =\n        typeof usage[\"completionTokens\"] === \"number\" ? usage[\"completionTokens\"] : 0;\n      const total = prompt + completion;\n      if (total > 0) {\n        return {\n          input_cost_usd: totalCost * (prompt / total),\n          output_cost_usd: totalCost * (completion / total),\n        };\n      }\n      return { input_cost_usd: totalCost };\n    }\n  } catch {\n    // ignore\n  }\n  return {};\n}\n\nexport class BreadcrumbSpanExporter implements SpanExporter {\n  constructor(\n    private readonly apiKey: string,\n    private readonly baseUrl: string,\n  ) {}\n\n  export(\n    spans: ReadableSpan[],\n    resultCallback: (result: ExportResult) => void,\n  ): void {\n    this._export(spans).then(\n      () => resultCallback({ code: ExportResultCode.SUCCESS }),\n      () => resultCallback({ code: ExportResultCode.SUCCESS }), // fail silently\n    );\n  }\n\n  private async _export(spans: ReadableSpan[]): Promise<void> {\n    try {\n      const roots = spans.filter((s) => !s.parentSpanId);\n      const spanPayloads = spans.map((s) => this._mapSpan(s));\n\n      const sends: Promise<void>[] = roots.map((s) => this._sendTrace(s));\n      if (spanPayloads.length > 0) {\n        sends.push(this._post(\"/v1/spans\", spanPayloads));\n      }\n\n      await Promise.all(sends);\n    } catch {\n      // Fail silently\n    }\n  }\n\n  private _mapSpan(span: ReadableSpan) {\n    const ctx = span.spanContext();\n    const attrs = span.attributes;\n\n    // ── Input ────────────────────────────────────────────────────────────────\n    let input: unknown;\n    const bcInput = attrs[\"breadcrumb.input\"];\n    const aiMessages = attrs[\"ai.prompt.messages\"];\n    if (bcInput != null) {\n      input = typeof bcInput === \"string\" ? (tryJson(bcInput) ?? bcInput) : bcInput;\n    } else if (typeof aiMessages === \"string\") {\n      input = tryJson(aiMessages) ?? aiMessages;\n    }\n\n    // ── Output ───────────────────────────────────────────────────────────────\n    let output: unknown;\n    const bcOutput = attrs[\"breadcrumb.output\"];\n    const aiText = attrs[\"ai.response.text\"];\n    if (bcOutput != null) {\n      output = typeof bcOutput === \"string\" ? (tryJson(bcOutput) ?? bcOutput) : bcOutput;\n    } else if (typeof aiText === \"string\") {\n      output = aiText;\n    }\n\n    // ── Model / provider ─────────────────────────────────────────────────────\n    const model = strAttr(span, \"breadcrumb.model\", \"ai.model.id\", \"ai.response.model\", \"gen_ai.request.model\");\n    const provider = strAttr(span, \"breadcrumb.provider\", \"ai.model.provider\", \"gen_ai.system\");\n\n    // ── Tokens ───────────────────────────────────────────────────────────────\n    const input_tokens = intAttr(\n      span,\n      \"breadcrumb.input_tokens\",\n      \"ai.usage.inputTokens\",\n      \"ai.usage.promptTokens\",\n      \"gen_ai.usage.input_tokens\",\n    );\n    const output_tokens = intAttr(\n      span,\n      \"breadcrumb.output_tokens\",\n      \"ai.usage.outputTokens\",\n      \"ai.usage.completionTokens\",\n      \"gen_ai.usage.output_tokens\",\n    );\n\n    // ── Cost ─────────────────────────────────────────────────────────────────\n    let input_cost_usd = floatAttr(span, \"breadcrumb.input_cost_usd\");\n    let output_cost_usd = floatAttr(span, \"breadcrumb.output_cost_usd\");\n    if (input_cost_usd == null && output_cost_usd == null) {\n      const cost = extractCost(span);\n      input_cost_usd = cost.input_cost_usd;\n      output_cost_usd = cost.output_cost_usd;\n    }\n\n    // ── Metadata ─────────────────────────────────────────────────────────────\n    const metadata: Record<string, string> = {};\n    for (const [k, v] of Object.entries(attrs)) {\n      if (v == null) continue;\n      if (HANDLED_ATTRS.has(k) || DROP_ATTRS.has(k)) continue;\n      if (k.startsWith(\"ai.settings.\")) continue;\n      if (k.startsWith(\"ai.request.headers.\")) continue;\n      if (k.startsWith(\"breadcrumb.\")) {\n        // breadcrumb.meta.* keys from span.set({ metadata: {...} })\n        if (k.startsWith(\"breadcrumb.meta.\")) {\n          metadata[k.slice(\"breadcrumb.meta.\".length)] = String(v);\n        }\n        continue;\n      }\n      if (k.startsWith(\"ai.telemetry.metadata.\")) {\n        metadata[k.slice(\"ai.telemetry.metadata.\".length)] = String(v);\n        continue;\n      }\n      if (k === \"ai.response.finishReason\") {\n        metadata[\"finish_reason\"] = String(v);\n        continue;\n      }\n      metadata[k] = String(v);\n    }\n\n    return {\n      id: ctx.spanId,\n      trace_id: ctx.traceId,\n      parent_span_id: span.parentSpanId || undefined,\n      name: span.name,\n      type: inferSpanType(span),\n      start_time: hrTimeToISO(span.startTime),\n      end_time: hrTimeToISO(span.endTime),\n      status: spanStatus(span),\n      status_message: span.status.message || undefined,\n      input: input !== undefined ? input : undefined,\n      output: output !== undefined ? output : undefined,\n      provider,\n      model,\n      input_tokens,\n      output_tokens,\n      input_cost_usd,\n      output_cost_usd,\n      metadata: Object.keys(metadata).length > 0 ? metadata : undefined,\n    };\n  }\n\n  private async _sendTrace(span: ReadableSpan): Promise<void> {\n    const ctx = span.spanContext();\n    await this._post(\"/v1/traces\", {\n      id: ctx.traceId,\n      name: span.name,\n      start_time: hrTimeToISO(span.startTime),\n      end_time: hrTimeToISO(span.endTime),\n      status: spanStatus(span),\n      status_message: span.status.message || undefined,\n    });\n  }\n\n  private async _post(path: string, body: unknown): Promise<void> {\n    try {\n      await fetch(`${this.baseUrl}${path}`, {\n        method: \"POST\",\n        headers: {\n          \"Content-Type\": \"application/json\",\n          Authorization: `Bearer ${this.apiKey}`,\n        },\n        body: JSON.stringify(body),\n      });\n    } catch {\n      // Fail silently — backend unreachable\n    }\n  }\n\n  shutdown(): Promise<void> {\n    return Promise.resolve();\n  }\n\n  forceFlush(): Promise<void> {\n    return Promise.resolve();\n  }\n}\n","import {\n  context,\n  trace,\n  ROOT_CONTEXT,\n  SpanStatusCode,\n  type Span as OtelSpan,\n} from \"@opentelemetry/api\";\nimport { NodeTracerProvider } from \"@opentelemetry/sdk-trace-node\";\nimport {\n  SimpleSpanProcessor,\n  BatchSpanProcessor,\n} from \"@opentelemetry/sdk-trace-base\";\nimport { BreadcrumbSpanExporter } from \"./exporter.js\";\nimport type { Breadcrumb, BreadcrumbSpan, SpanOptions } from \"./types.js\";\n\nexport type { Breadcrumb, BreadcrumbSpan, SpanOptions };\n\nexport interface InitOptions {\n  apiKey: string;\n  baseUrl: string;\n  batching?:\n    | false\n    | {\n        flushInterval?: number;\n        maxBatchSize?: number;\n      };\n}\n\nexport function init(options: InitOptions): Breadcrumb {\n  const exporter = new BreadcrumbSpanExporter(options.apiKey, options.baseUrl);\n\n  const batchOpts =\n    typeof options.batching === \"object\" ? options.batching : undefined;\n\n  const processor =\n    options.batching === false\n      ? new SimpleSpanProcessor(exporter)\n      : new BatchSpanProcessor(exporter, {\n          scheduledDelayMillis: batchOpts?.flushInterval ?? 5000,\n          maxExportBatchSize: batchOpts?.maxBatchSize ?? 100,\n        });\n\n  const provider = new NodeTracerProvider({ spanProcessors: [processor] });\n  provider.register();\n\n  process.once(\"beforeExit\", async () => {\n    await provider.shutdown().catch(() => {});\n  });\n\n  const tracer = provider.getTracer(\"@breadcrumb-sdk/core\");\n\n  function runSpan<T>(\n    otelSpan: OtelSpan,\n    activeCtx: typeof ROOT_CONTEXT,\n    fn: (span: BreadcrumbSpan) => Promise<T>,\n  ): Promise<T> {\n    const bcSpan: BreadcrumbSpan = {\n      set(data) {\n        const { metadata, ...semantic } = data;\n        for (const [key, value] of Object.entries(semantic)) {\n          if (value == null) continue;\n          const attrKey = `breadcrumb.${key}`;\n          if (typeof value === \"string\" || typeof value === \"number\" || typeof value === \"boolean\") {\n            otelSpan.setAttribute(attrKey, value);\n          } else {\n            otelSpan.setAttribute(attrKey, JSON.stringify(value));\n          }\n        }\n        if (metadata) {\n          for (const [key, value] of Object.entries(metadata)) {\n            if (value == null) continue;\n            otelSpan.setAttribute(`breadcrumb.meta.${key}`, value);\n          }\n        }\n      },\n    };\n\n    return context.with(trace.setSpan(activeCtx, otelSpan), async () => {\n      try {\n        const result = await fn(bcSpan);\n        otelSpan.setStatus({ code: SpanStatusCode.OK });\n        otelSpan.end();\n        return result;\n      } catch (err) {\n        otelSpan.setStatus({\n          code: SpanStatusCode.ERROR,\n          message: err instanceof Error ? err.message : String(err),\n        });\n        otelSpan.end();\n        throw err;\n      }\n    });\n  }\n\n  return {\n    trace<T>(\n      name: string,\n      fn: (span: BreadcrumbSpan) => Promise<T>,\n    ): Promise<T> {\n      const otelSpan = tracer.startSpan(name, {}, ROOT_CONTEXT);\n      return runSpan(otelSpan, ROOT_CONTEXT, fn);\n    },\n\n    span<T>(\n      name: string,\n      fn: (span: BreadcrumbSpan) => Promise<T>,\n      options?: SpanOptions,\n    ): Promise<T> {\n      const activeCtx = context.active();\n      const otelSpan = tracer.startSpan(name, {}, activeCtx);\n      if (options?.type) {\n        otelSpan.setAttribute(\"breadcrumb.span.type\", options.type);\n      }\n      return runSpan(otelSpan, activeCtx, fn);\n    },\n  };\n}\n"],"mappings":"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"}

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "@breadcrumb-sdk/core",
+  "version": "0.0.2",
+  "type": "module",
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "scripts": {
+    "build": "tsdown",
+    "dev": "tsdown --watch",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run"
+  },
+  "dependencies": {
+    "@opentelemetry/api": "^1.9.0",
+    "@opentelemetry/core": "^1.26.0",
+    "@opentelemetry/sdk-trace-base": "^1.26.0",
+    "@opentelemetry/sdk-trace-node": "^1.26.0"
+  },
+  "devDependencies": {
+    "tsdown": "^0.9",
+    "typescript": "^5.7",
+    "vitest": "^3"
+  }
+}