TypeScript SDK reference

import { TruLayer } from "@trulayer/sdk";

const tl = new TruLayer({
  apiKey: string,
  projectName: string,          // human-readable project name
  projectId?: string,           // @deprecated — use projectName. Removed in 0.3.x.
  endpoint?: string,
  batchSize?: number,
  flushInterval?: number,
  sampleRate?: number | (() => boolean),
  redact?: (value: unknown) => unknown,
  relayUrl?: string,
});

await tl.trace(
  name: string,
  fn: (trace: TraceContext) => Promise<T> | T,
  options?: { sessionId?: string; metadata?: Record<string, unknown> },
): Promise<T>

await trace.span(
  name: string,
  type: "llm" | "retrieval" | "tool" | "other",
  fn: (span: SpanContext) => Promise<T> | T,
): Promise<T>

import OpenAI from "openai";
import { instrumentOpenAI } from "@trulayer/sdk";

const openai = instrumentOpenAI(new OpenAI(), tl);

import Anthropic from "@anthropic-ai/sdk";
import { instrumentAnthropic } from "@trulayer/sdk";

const anthropic = instrumentAnthropic(new Anthropic(), tl);

import { instrumentVercelAI } from "@trulayer/sdk";

instrumentVercelAI(tl);
// every generateText/streamText/generateObject/streamObject from "ai" is now traced

import { init, getClient } from "@trulayer/sdk";

init({ apiKey: "...", projectName: "..." });

const tl = getClient();

import type {
  TruLayerConfig,
  TraceData,
  SpanData,
  SpanType,       // "llm" | "retrieval" | "tool" | "other"
  FeedbackData,
  EvalResult,
  Metrics,
} from "@trulayer/sdk";

tl.onError((err) => {
  console.error("trulayer:", err);
});