@lmnr-ai/client 0.8.28 → 0.8.29

package/dist/index.cjs

@@ -30,7 +30,7 @@ let pino_pretty = require("pino-pretty");
 let uuid = require("uuid");
 let _lmnr_ai_types = require("@lmnr-ai/types");
 //#region package.json
-var version = "0.8.28";
+var version = "0.8.29";
 //#endregion
 //#region src/version.ts
 function getLangVersion() {
@@ -41,15 +41,21 @@ function getLangVersion() {
 //#endregion
 //#region src/resources/index.ts
 var BaseResource = class {
-	constructor(baseHttpUrl, projectApiKey) {
+	constructor(baseHttpUrl, auth) {
 		this.baseHttpUrl = baseHttpUrl;
-		this.projectApiKey = projectApiKey;
+		this.auth = auth;
+		this.credential = auth.type === "apiKey" ? auth.key : auth.token;
+	}
+	/** API path prefix: `/v1/cli` for CLI user-token auth, `/v1` otherwise. */
+	get apiPrefix() {
+		return this.auth.type === "userToken" ? "/v1/cli" : "/v1";
 	}
 	headers() {
 		return {
-			Authorization: `Bearer ${this.projectApiKey}`,
+			Authorization: `Bearer ${this.credential}`,
 			"Content-Type": "application/json",
-			Accept: "application/json"
+			Accept: "application/json",
+			...this.auth.type === "userToken" ? { "x-lmnr-project-id": this.auth.projectId } : {}
 		};
 	}
 	async handleError(response) {
@@ -60,8 +66,8 @@ var BaseResource = class {
 //#endregion
 //#region src/resources/browser-events.ts
 var BrowserEventsResource = class extends BaseResource {
-	constructor(baseHttpUrl, projectApiKey) {
-		super(baseHttpUrl, projectApiKey);
+	constructor(baseHttpUrl, auth) {
+		super(baseHttpUrl, auth);
 	}
 	async send({ sessionId, traceId, events }) {
 		const payload = {
@@ -86,6 +92,35 @@ var BrowserEventsResource = class extends BaseResource {
 	}
 };
 //#endregion
+//#region src/resources/cli.ts
+/**
+* User-scoped CLI endpoints that don't target a specific project. Authed by the
+* BetterAuth user JWT (the `credential`); deliberately does NOT send an
+* `x-lmnr-project-id` header (these routes are project discovery, pre-selection).
+*
+* Discovery exception: this resource always hits `/v1/cli/projects` with the
+* bare bearer and overrides `BaseResource.headers()`/`apiPrefix`, so it works
+* even when constructed with a `userToken` auth that has no real project id yet.
+*/
+var CliResource = class extends BaseResource {
+	constructor(baseHttpUrl, auth) {
+		super(baseHttpUrl, auth);
+	}
+	/** Workspaces + projects the authenticated user can access. */
+	async listProjects() {
+		const response = await fetch(`${this.baseHttpUrl}/v1/cli/projects`, {
+			method: "GET",
+			headers: {
+				Authorization: `Bearer ${this.credential}`,
+				Accept: "application/json"
+			}
+		});
+		if (!response.ok) await this.handleError(response);
+		const body = await response.json();
+		return Array.isArray(body?.projects) ? body.projects : [];
+	}
+};
+//#endregion
 //#region src/utils.ts
 function initializeLogger(options) {
 	const colorize = options?.colorize ?? true;
@@ -150,8 +185,8 @@ const logger$3 = initializeLogger();
 const DEFAULT_DATASET_PULL_LIMIT = 100;
 const DEFAULT_DATASET_PUSH_BATCH_SIZE = 100;
 var DatasetsResource = class extends BaseResource {
-	constructor(baseHttpUrl, projectApiKey) {
-		super(baseHttpUrl, projectApiKey);
+	constructor(baseHttpUrl, auth) {
+		super(baseHttpUrl, auth);
 	}
 	/**
 	* List all datasets.
@@ -159,7 +194,7 @@ var DatasetsResource = class extends BaseResource {
 	* @returns {Promise<Dataset[]>} Array of datasets
 	*/
 	async listDatasets() {
-		const response = await fetch(this.baseHttpUrl + "/v1/datasets", {
+		const response = await fetch(this.baseHttpUrl + this.apiPrefix + "/datasets", {
 			method: "GET",
 			headers: this.headers()
 		});
@@ -174,7 +209,7 @@ var DatasetsResource = class extends BaseResource {
 	*/
 	async getDatasetByName(name) {
 		const params = new URLSearchParams({ name });
-		const response = await fetch(this.baseHttpUrl + `/v1/datasets?${params.toString()}`, {
+		const response = await fetch(this.baseHttpUrl + `${this.apiPrefix}/datasets?${params.toString()}`, {
 			method: "GET",
 			headers: this.headers()
 		});
@@ -203,7 +238,7 @@ var DatasetsResource = class extends BaseResource {
 			const batchNum = Math.floor(i / batchSize) + 1;
 			logger$3.debug(`Pushing batch ${batchNum} of ${totalBatches}`);
 			const batch = points.slice(i, i + batchSize);
-			const fetchResponse = await fetch(this.baseHttpUrl + "/v1/datasets/datapoints", {
+			const fetchResponse = await fetch(this.baseHttpUrl + this.apiPrefix + "/datasets/datapoints", {
 				method: "POST",
 				headers: this.headers(),
 				body: JSON.stringify({
@@ -241,7 +276,7 @@ var DatasetsResource = class extends BaseResource {
 		if (name) paramsObj.name = name;
 		else paramsObj.datasetId = id;
 		const params = new URLSearchParams(paramsObj);
-		const response = await fetch(this.baseHttpUrl + `/v1/datasets/datapoints?${params.toString()}`, {
+		const response = await fetch(this.baseHttpUrl + `${this.apiPrefix}/datasets/datapoints?${params.toString()}`, {
 			method: "GET",
 			headers: this.headers()
 		});
@@ -254,8 +289,8 @@ var DatasetsResource = class extends BaseResource {
 const logger$2 = initializeLogger();
 const INITIAL_EVALUATION_DATAPOINT_MAX_DATA_LENGTH = 16e6;
 var EvalsResource = class extends BaseResource {
-	constructor(baseHttpUrl, projectApiKey) {
-		super(baseHttpUrl, projectApiKey);
+	constructor(baseHttpUrl, auth) {
+		super(baseHttpUrl, auth);
 	}
 	/**
 	* Initialize an evaluation.
@@ -431,8 +466,8 @@ var EvalsResource = class extends BaseResource {
 * Resource for creating evaluator scores
 */
 var EvaluatorsResource = class extends BaseResource {
-	constructor(baseHttpUrl, projectApiKey) {
-		super(baseHttpUrl, projectApiKey);
+	constructor(baseHttpUrl, auth) {
+		super(baseHttpUrl, auth);
 	}
 	/**
 	* Create a score for a span or trace
@@ -512,8 +547,8 @@ const toCachedSpan = (response) => {
 	};
 };
 var RolloutSessionsResource = class extends BaseResource {
-	constructor(baseHttpUrl, projectApiKey) {
-		super(baseHttpUrl, projectApiKey);
+	constructor(baseHttpUrl, auth) {
+		super(baseHttpUrl, auth);
 	}
 	/**
 	* Idempotently register (upsert) a debug session on the backend, keyed on the
@@ -524,7 +559,7 @@ var RolloutSessionsResource = class extends BaseResource {
 	* caller can build the debugger URL; null if the body can't be parsed.
 	*/
 	async register({ sessionId, name }) {
-		const response = await fetch(`${this.baseHttpUrl}/v1/rollouts/${sessionId}`, {
+		const response = await fetch(`${this.baseHttpUrl}${this.apiPrefix}/rollouts/${sessionId}`, {
 			method: "POST",
 			headers: this.headers(),
 			body: JSON.stringify({ name })
@@ -544,7 +579,7 @@ var RolloutSessionsResource = class extends BaseResource {
 	* stays the SDK's job via {@link register}.
 	*/
 	async setName({ sessionId, name }) {
-		const response = await fetch(`${this.baseHttpUrl}/v1/rollouts/${sessionId}/name`, {
+		const response = await fetch(`${this.baseHttpUrl}${this.apiPrefix}/rollouts/${sessionId}/name`, {
 			method: "PATCH",
 			headers: this.headers(),
 			body: JSON.stringify({ name })
@@ -568,7 +603,7 @@ var RolloutSessionsResource = class extends BaseResource {
 	async cache({ sessionId, replayTraceId, cacheUntil, inputHash }) {
 		let response;
 		try {
-			response = await fetch(`${this.baseHttpUrl}/v1/rollouts/${sessionId}/cache`, {
+			response = await fetch(`${this.baseHttpUrl}${this.apiPrefix}/rollouts/${sessionId}/cache`, {
 				method: "POST",
 				headers: this.headers(),
 				body: JSON.stringify({
@@ -610,7 +645,7 @@ var RolloutSessionsResource = class extends BaseResource {
 		}
 	}
 	async delete({ sessionId }) {
-		const response = await fetch(`${this.baseHttpUrl}/v1/rollouts/${sessionId}`, {
+		const response = await fetch(`${this.baseHttpUrl}${this.apiPrefix}/rollouts/${sessionId}`, {
 			method: "DELETE",
 			headers: this.headers()
 		});
@@ -620,11 +655,11 @@ var RolloutSessionsResource = class extends BaseResource {
 //#endregion
 //#region src/resources/sql.ts
 var SqlResource = class extends BaseResource {
-	constructor(baseHttpUrl, projectApiKey) {
-		super(baseHttpUrl, projectApiKey);
+	constructor(baseHttpUrl, auth) {
+		super(baseHttpUrl, auth);
 	}
 	async query(sql, parameters = {}) {
-		const response = await fetch(`${this.baseHttpUrl}/v1/sql/query`, {
+		const response = await fetch(`${this.baseHttpUrl}${this.apiPrefix}/sql/query`, {
 			method: "POST",
 			headers: { ...this.headers() },
 			body: JSON.stringify({
@@ -641,8 +676,8 @@ var SqlResource = class extends BaseResource {
 /** Resource for tagging traces. */
 var TagsResource = class extends BaseResource {
 	/** Resource for tagging traces. */
-	constructor(baseHttpUrl, projectApiKey) {
-		super(baseHttpUrl, projectApiKey);
+	constructor(baseHttpUrl, auth) {
+		super(baseHttpUrl, auth);
 	}
 	/**
 	* Tag a trace with a list of tags. Note that the trace must be ended before
@@ -699,8 +734,8 @@ var TagsResource = class extends BaseResource {
 const logger = initializeLogger();
 var TracesResource = class extends BaseResource {
 	/** Resource for post-factum operations on existing traces. */
-	constructor(baseHttpUrl, projectApiKey) {
-		super(baseHttpUrl, projectApiKey);
+	constructor(baseHttpUrl, auth) {
+		super(baseHttpUrl, auth);
 	}
 	/**
 	* Push a metadata patch to an existing trace.
@@ -755,7 +790,7 @@ var TracesResource = class extends BaseResource {
 	async pushMetadata(traceId, metadata, options) {
 		if (!metadata || Object.keys(metadata).length === 0) throw new Error("metadata must be a non-empty object");
 		const formattedTraceId = isStringUUID(traceId) ? traceId : otelTraceIdToUUID(traceId);
-		const url = this.baseHttpUrl + "/v1/traces/metadata";
+		const url = this.baseHttpUrl + this.apiPrefix + "/traces/metadata";
 		const response = await fetch(url, {
 			method: "POST",
 			headers: this.headers(),
@@ -775,25 +810,49 @@ var TracesResource = class extends BaseResource {
 };
 //#endregion
 //#region src/index.ts
-var LaminarClient = class {
-	constructor({ baseUrl, projectApiKey, port } = {}) {
+var LaminarClient = class LaminarClient {
+	constructor({ baseUrl, port, auth, projectApiKey, cliUserProjectId } = {}) {
 		loadEnv();
-		this.projectApiKey = projectApiKey ?? process.env.LMNR_PROJECT_API_KEY;
+		this.auth = LaminarClient.normalizeAuth(auth, projectApiKey, cliUserProjectId);
 		const httpPort = port ?? (baseUrl?.match(/:\d{1,5}$/g) ? parseInt(baseUrl.match(/:\d{1,5}$/g)[0].slice(1)) : 443);
 		const baseUrlNoPort = (baseUrl ?? process.env.LMNR_BASE_URL)?.replace(/\/$/, "").replace(/:\d{1,5}$/g, "");
 		this.baseUrl = `${baseUrlNoPort ?? "https://api.lmnr.ai"}:${httpPort}`;
-		this._browserEvents = new BrowserEventsResource(this.baseUrl, this.projectApiKey);
-		this._datasets = new DatasetsResource(this.baseUrl, this.projectApiKey);
-		this._evals = new EvalsResource(this.baseUrl, this.projectApiKey);
-		this._evaluators = new EvaluatorsResource(this.baseUrl, this.projectApiKey);
-		this._rolloutSessions = new RolloutSessionsResource(this.baseUrl, this.projectApiKey);
-		this._sql = new SqlResource(this.baseUrl, this.projectApiKey);
-		this._tags = new TagsResource(this.baseUrl, this.projectApiKey);
-		this._traces = new TracesResource(this.baseUrl, this.projectApiKey);
+		this._browserEvents = new BrowserEventsResource(this.baseUrl, this.auth);
+		this._cli = new CliResource(this.baseUrl, this.auth);
+		this._datasets = new DatasetsResource(this.baseUrl, this.auth);
+		this._evals = new EvalsResource(this.baseUrl, this.auth);
+		this._evaluators = new EvaluatorsResource(this.baseUrl, this.auth);
+		this._rolloutSessions = new RolloutSessionsResource(this.baseUrl, this.auth);
+		this._sql = new SqlResource(this.baseUrl, this.auth);
+		this._tags = new TagsResource(this.baseUrl, this.auth);
+		this._traces = new TracesResource(this.baseUrl, this.auth);
+	}
+	/**
+	* Normalize the constructor's auth inputs into a {@link LaminarAuth} union.
+	* Precedence: an explicit `auth` wins; otherwise the legacy
+	* `projectApiKey` (+ optional `cliUserProjectId`) is mapped — a present
+	* `cliUserProjectId` selects the user-token surface, otherwise the project
+	* key surface. Falls back to `LMNR_PROJECT_API_KEY` as a project key.
+	*/
+	static normalizeAuth(auth, projectApiKey, cliUserProjectId) {
+		if (auth) return auth;
+		const key = projectApiKey ?? process.env.LMNR_PROJECT_API_KEY;
+		if (cliUserProjectId) return {
+			type: "userToken",
+			token: key,
+			projectId: cliUserProjectId
+		};
+		return {
+			type: "apiKey",
+			key
+		};
 	}
 	get browserEvents() {
 		return this._browserEvents;
 	}
+	get cli() {
+		return this._cli;
+	}
 	get datasets() {
 		return this._datasets;
 	}

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","names":["SDK_VERSION","logger","logger","logger","logger"],"sources":["../package.json","../src/version.ts","../src/resources/index.ts","../src/resources/browser-events.ts","../src/utils.ts","../src/resources/datasets.ts","../src/resources/evals.ts","../src/resources/evaluators.ts","../src/resources/rollout-sessions.ts","../src/resources/sql.ts","../src/resources/tags.ts","../src/resources/traces.ts","../src/index.ts"],"sourcesContent":["","// Version detection for runtime environment\nexport function getLangVersion(): string | null {\n  if (typeof process !== 'undefined' && process.versions && process.versions.node) {\n    return `node-${process.versions.node}`;\n  }\n  if (typeof navigator !== 'undefined' && navigator.userAgent) {\n    return `browser-${navigator.userAgent}`;\n  }\n  return null;\n}\n","class BaseResource {\n  protected readonly baseHttpUrl: string;\n  protected readonly projectApiKey: string;\n\n  constructor(baseHttpUrl: string, projectApiKey: string) {\n    this.baseHttpUrl = baseHttpUrl;\n    this.projectApiKey = projectApiKey;\n  }\n\n  protected headers() {\n    return {\n      Authorization: `Bearer ${this.projectApiKey}`,\n      \"Content-Type\": \"application/json\",\n      Accept: \"application/json\",\n    };\n  }\n\n  protected async handleError(response: Response) {\n    const errorMsg = await response.text();\n    throw new Error(`${response.status} ${errorMsg}`);\n  }\n}\n\nexport { BaseResource };\n","import { version as SDK_VERSION } from '../../package.json';\nimport { getLangVersion } from \"../version\";\nimport { BaseResource } from \"./index\";\n\nexport class BrowserEventsResource extends BaseResource {\n  constructor(baseHttpUrl: string, projectApiKey: string) {\n    super(baseHttpUrl, projectApiKey);\n  }\n\n  public async send({\n    sessionId,\n    traceId,\n    events,\n  }: {\n    sessionId: string;\n    traceId: string;\n    events: Record<string, any>[];\n  }): Promise<void> {\n    const payload = {\n      sessionId,\n      traceId,\n      events,\n      source: getLangVersion() ?? 'javascript',\n      sdkVersion: SDK_VERSION,\n    };\n\n    const jsonString = JSON.stringify(payload);\n    const blob = new Blob([jsonString], { type: 'application/json' });\n    const compressedStream = blob.stream().pipeThrough(new CompressionStream('gzip'));\n    const compressedResponse = new Response(compressedStream);\n    const compressedData = await compressedResponse.arrayBuffer();\n\n    const response = await fetch(this.baseHttpUrl + \"/v1/browser-sessions/events\", {\n      method: \"POST\",\n      headers: {\n        ...this.headers(),\n        'Content-Encoding': 'gzip',\n      },\n      body: compressedData,\n    });\n\n    if (!response.ok) {\n      await this.handleError(response);\n    }\n  }\n}\n","import { type StringUUID } from '@lmnr-ai/types';\nimport { config } from 'dotenv';\nimport * as path from 'path';\nimport pino, { Level } from 'pino';\nimport { PinoPretty } from 'pino-pretty';\nimport { v4 as uuidv4 } from 'uuid';\n\nexport function initializeLogger(options?: { colorize?: boolean; level?: Level }) {\n  const colorize = options?.colorize ?? true;\n  const level =\n    options?.level ??\n    (process.env.LMNR_LOG_LEVEL?.toLowerCase()?.trim() as Level) ??\n    'info';\n\n  return pino(\n    {\n      level,\n    },\n    PinoPretty({\n      colorize,\n      minimumLevel: level,\n    }),\n  );\n}\n\nconst logger = initializeLogger();\n\nexport const isStringUUID = (id: string): id is StringUUID =>\n  /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/.test(id);\n\nexport const NIL_UUID: StringUUID = '00000000-0000-0000-0000-000000000000';\n\nexport const newUUID = (): StringUUID => {\n  // crypto.randomUUID is available in most of the modern browsers and node,\n  // but is not available in \"insecure\" contexts, e.g. not https, not localhost\n  // so we fallback to uuidv4 in those cases, which is less secure, but works\n  // just fine.\n  if (typeof crypto !== 'undefined' && typeof crypto.randomUUID === 'function') {\n    return crypto.randomUUID();\n  } else {\n    return uuidv4() as `${string}-${string}-${string}-${string}-${string}`;\n  }\n};\n\nexport const otelSpanIdToUUID = (spanId: string): string => {\n  let id = spanId.toLowerCase();\n  if (id.startsWith('0x')) {\n    id = id.slice(2);\n  }\n  if (id.length !== 16) {\n    logger.warn(\n      `Span ID ${spanId} is not 16 hex chars long. ` +\n      'This is not a valid OpenTelemetry span ID.',\n    );\n  }\n\n  if (!/^[0-9a-f]+$/.test(id)) {\n    logger.error(\n      `Span ID ${spanId} is not a valid hex string. ` +\n      'Generating a random UUID instead.',\n    );\n    return newUUID();\n  }\n\n  return id.padStart(32, '0').replace(\n    /^([0-9a-f]{8})([0-9a-f]{4})([0-9a-f]{4})([0-9a-f]{4})([0-9a-f]{12})$/,\n    '$1-$2-$3-$4-$5',\n  );\n};\n\nexport const otelTraceIdToUUID = (traceId: string): StringUUID => {\n  let id = traceId.toLowerCase();\n  if (id.startsWith('0x')) {\n    id = id.slice(2);\n  }\n  if (id.length !== 32) {\n    logger.warn(\n      `Trace ID ${traceId} is not 32 hex chars long. ` +\n      'This is not a valid OpenTelemetry trace ID.',\n    );\n  }\n  if (!/^[0-9a-f]+$/.test(id)) {\n    logger.error(\n      `Trace ID ${traceId} is not a valid hex string. ` +\n      'Generating a random UUID instead.',\n    );\n    return newUUID();\n  }\n\n  return id.replace(\n    /^([0-9a-f]{8})([0-9a-f]{4})([0-9a-f]{4})([0-9a-f]{4})([0-9a-f]{12})$/,\n    '$1-$2-$3-$4-$5',\n  ) as StringUUID;\n};\n\nexport const slicePayload = <T>(value: T, length: number) => {\n  if (value === null || value === undefined) {\n    return value;\n  }\n\n  const str = JSON.stringify(value);\n  if (str.length <= length) {\n    return value;\n  }\n\n  return str.slice(0, length) + '...';\n};\n\nexport const loadEnv = (\n  options?: {\n    quiet?: boolean;\n    paths?: string[];\n  },\n): void => {\n  const nodeEnv = process.env.NODE_ENV || 'development';\n  const envDir = process.cwd();\n\n  // Files to load in order (lowest to highest priority)\n  // Later files override earlier ones\n  const envFiles = [\n    '.env',\n    '.env.local',\n    `.env.${nodeEnv}`,\n    `.env.${nodeEnv}.local`,\n  ];\n\n  const logLevel = process.env.LMNR_LOG_LEVEL ?? 'info';\n  const verbose = ['debug', 'trace'].includes(logLevel.trim().toLowerCase());\n\n  const quiet = options?.quiet ?? !verbose;\n\n  config({\n    path: options?.paths ?? envFiles.map((envFile) => path.resolve(envDir, envFile)),\n    quiet,\n  });\n};\n","import {\n  type Datapoint,\n  type Dataset,\n  type GetDatapointsResponse,\n  type PushDatapointsResponse,\n  type StringUUID,\n} from \"@lmnr-ai/types\";\n\nimport { initializeLogger } from \"../utils\";\nimport { BaseResource } from \".\";\n\nconst logger = initializeLogger();\nconst DEFAULT_DATASET_PULL_LIMIT = 100;\nconst DEFAULT_DATASET_PUSH_BATCH_SIZE = 100;\n\nexport class DatasetsResource extends BaseResource {\n  constructor(baseHttpUrl: string, projectApiKey: string) {\n    super(baseHttpUrl, projectApiKey);\n  }\n\n  /**\n   * List all datasets.\n   *\n   * @returns {Promise<Dataset[]>} Array of datasets\n   */\n  public async listDatasets(): Promise<Dataset[]> {\n    const response = await fetch(this.baseHttpUrl + \"/v1/datasets\", {\n      method: \"GET\",\n      headers: this.headers(),\n    });\n\n    if (!response.ok) {\n      await this.handleError(response);\n    }\n\n    return response.json() as Promise<Dataset[]>;\n  }\n\n  /**\n   * Get a dataset by name.\n   *\n   * @param {string} name - Name of the dataset\n   * @returns {Promise<Dataset[]>} Array of datasets with matching name\n   */\n  public async getDatasetByName(name: string): Promise<Dataset[]> {\n    const params = new URLSearchParams({ name });\n    const response = await fetch(\n      this.baseHttpUrl + `/v1/datasets?${params.toString()}`,\n      {\n        method: \"GET\",\n        headers: this.headers(),\n      },\n    );\n\n    if (!response.ok) {\n      await this.handleError(response);\n    }\n\n    return response.json() as Promise<Dataset[]>;\n  }\n\n  /**\n   * Push datapoints to a dataset.\n   *\n   * @param {Object} options - Push options\n   * @param {Datapoint<D, T>[]} options.points - Datapoints to push\n   * @param {string} [options.name] - Name of the dataset (either name or id must be provided)\n   * @param {StringUUID} [options.id] - ID of the dataset (either name or id must be provided)\n   * @param {number} [options.batchSize] - Batch size for pushing (default: 100)\n   * @param {boolean} [options.createDataset] - Whether to create the dataset if it doesn't exist\n   * @returns {Promise<PushDatapointsResponse | undefined>}\n   */\n  public async push<D, T>({\n    points,\n    name,\n    id,\n    batchSize = DEFAULT_DATASET_PUSH_BATCH_SIZE,\n    createDataset = false,\n  }: {\n    points: Datapoint<D, T>[];\n    name?: string;\n    id?: StringUUID;\n    batchSize?: number;\n    createDataset?: boolean;\n  }): Promise<PushDatapointsResponse | undefined> {\n    if (!name && !id) {\n      throw new Error(\"Either name or id must be provided\");\n    }\n\n    if (name && id) {\n      throw new Error(\"Only one of name or id must be provided\");\n    }\n\n    if (createDataset && !name) {\n      throw new Error(\"Name must be provided when creating a new dataset\");\n    }\n\n    const identifier = name ? { name } : { datasetId: id! };\n    const totalBatches = Math.ceil(points.length / batchSize);\n\n    let response: PushDatapointsResponse | undefined;\n    for (let i = 0; i < points.length; i += batchSize) {\n      const batchNum = Math.floor(i / batchSize) + 1;\n      logger.debug(`Pushing batch ${batchNum} of ${totalBatches}`);\n\n      const batch = points.slice(i, i + batchSize);\n      const fetchResponse = await fetch(\n        this.baseHttpUrl + \"/v1/datasets/datapoints\",\n        {\n          method: \"POST\",\n          headers: this.headers(),\n          body: JSON.stringify({\n            ...identifier,\n            datapoints: batch.map((point) => ({\n              data: point.data,\n              target: point.target ?? {},\n              metadata: point.metadata ?? {},\n            })),\n            createDataset,\n          }),\n        },\n      );\n\n      // 201 when creating a new dataset\n      if (fetchResponse.status !== 200 && fetchResponse.status !== 201) {\n        await this.handleError(fetchResponse);\n      }\n\n      response = (await fetchResponse.json()) as PushDatapointsResponse;\n    }\n\n    return response;\n  }\n\n  /**\n   * Pull datapoints from a dataset.\n   *\n   * @param {Object} options - Pull options\n   * @param {string} [options.name] - Name of the dataset (either name or id must be provided)\n   * @param {StringUUID} [options.id] - ID of the dataset (either name or id must be provided)\n   * @param {number} [options.limit] - Maximum number of datapoints to return (default: 100)\n   * @param {number} [options.offset] - Offset for pagination (default: 0)\n   * @returns {Promise<GetDatapointsResponse<D, T>>}\n   */\n  public async pull<D, T>({\n    name,\n    id,\n    limit = DEFAULT_DATASET_PULL_LIMIT,\n    offset = 0,\n  }: {\n    name?: string;\n    id?: StringUUID;\n    limit?: number;\n    offset?: number;\n  }): Promise<GetDatapointsResponse<D, T>> {\n    if (!name && !id) {\n      throw new Error(\"Either name or id must be provided\");\n    }\n\n    if (name && id) {\n      throw new Error(\"Only one of name or id must be provided\");\n    }\n\n    const paramsObj: Record<string, string> = {\n      offset: offset.toString(),\n      limit: limit.toString(),\n    };\n\n    if (name) {\n      paramsObj.name = name;\n    } else {\n      paramsObj.datasetId = id!;\n    }\n\n    const params = new URLSearchParams(paramsObj);\n\n    const response = await fetch(\n      this.baseHttpUrl + `/v1/datasets/datapoints?${params.toString()}`,\n      {\n        method: \"GET\",\n        headers: this.headers(),\n      },\n    );\n\n    if (!response.ok) {\n      await this.handleError(response);\n    }\n\n    return response.json() as Promise<GetDatapointsResponse<D, T>>;\n  }\n}\n","import {\n  type EvaluationDatapoint,\n  type GetDatapointsResponse,\n  type InitEvaluationResponse,\n  type StringUUID,\n} from \"@lmnr-ai/types\";\n\nimport { initializeLogger, newUUID, slicePayload } from \"../utils\";\nimport { BaseResource } from \".\";\n\nconst logger = initializeLogger();\nconst INITIAL_EVALUATION_DATAPOINT_MAX_DATA_LENGTH = 16_000_000; // 16MB\n\nexport class EvalsResource extends BaseResource {\n  constructor(baseHttpUrl: string, projectApiKey: string) {\n    super(baseHttpUrl, projectApiKey);\n  }\n\n  /**\n   * Initialize an evaluation.\n   *\n   * @param {string} name - Name of the evaluation\n   * @param {string} groupName - Group name of the evaluation\n   * @param {Record<string, any>} metadata - Optional metadata\n   * @returns {Promise<InitEvaluationResponse>} Response from the evaluation initialization\n   */\n  public async init(\n    name?: string,\n    groupName?: string,\n    metadata?: Record<string, any>,\n  ): Promise<InitEvaluationResponse> {\n    const response = await fetch(this.baseHttpUrl + \"/v1/evals\", {\n      method: \"POST\",\n      headers: this.headers(),\n      body: JSON.stringify({\n        name: name ?? null,\n        groupName: groupName ?? null,\n        metadata: metadata ?? null,\n      }),\n    });\n\n    if (!response.ok) {\n      await this.handleError(response);\n    }\n\n    return response.json() as Promise<InitEvaluationResponse>;\n  }\n\n  /**\n   * Create a new evaluation and return its ID.\n   *\n   * @param {string} [name] - Optional name of the evaluation\n   * @param {string} [groupName] - An identifier to group evaluations\n   * @param {Record<string, any>} [metadata] - Optional metadata\n   * @returns {Promise<StringUUID>} The evaluation ID\n   */\n\n  public async create(args?: {\n    name?: string, groupName?: string, metadata?: Record<string, any>\n  }): Promise<StringUUID> {\n    const evaluation = await this.init(args?.name, args?.groupName, args?.metadata);\n    return evaluation.id;\n  }\n\n  /**\n   * Create a new evaluation and return its ID.\n   * @deprecated use `create` instead.\n   */\n  public async createEvaluation(\n    name?: string,\n    groupName?: string,\n    metadata?: Record<string, any>,\n  ): Promise<StringUUID> {\n    const evaluation = await this.init(name, groupName, metadata);\n    return evaluation.id;\n  }\n\n  /**\n   * Create a datapoint for an evaluation.\n   *\n   * @param {Object} options - Create datapoint options\n   * @param {string} options.evalId - The evaluation ID\n   * @param {D} options.data - The input data for the executor\n   * @param {T} [options.target] - The target/expected output for evaluators\n   * @param {Record<string, any>} [options.metadata] - Optional metadata\n   * @param {number} [options.index] - Optional index of the datapoint\n   * @param {string} [options.traceId] - Optional trace ID\n   * @returns {Promise<StringUUID>} The datapoint ID\n   */\n  public async createDatapoint<D, T>({\n    evalId,\n    data,\n    target,\n    metadata,\n    index,\n    traceId,\n  }: {\n    evalId: string;\n    data: D;\n    target?: T;\n    metadata?: Record<string, any>;\n    index?: number;\n    traceId?: string;\n  }): Promise<StringUUID> {\n    const datapointId = newUUID();\n\n    const partialDatapoint: EvaluationDatapoint<D, T, any> = {\n      id: datapointId,\n      data,\n      target,\n      index: index ?? 0,\n      traceId: traceId ?? newUUID(),\n      executorSpanId: newUUID(),\n      metadata,\n    };\n\n    await this.saveDatapoints({\n      evalId,\n      datapoints: [partialDatapoint],\n    });\n\n    return datapointId;\n  }\n\n  /**\n   * Update a datapoint with evaluation results.\n   *\n   * @param {Object} options - Update datapoint options\n   * @param {string} options.evalId - The evaluation ID\n   * @param {string} options.datapointId - The datapoint ID\n   * @param {Record<string, number>} options.scores - The scores\n   * @param {O} [options.executorOutput] - The executor output\n   * @returns {Promise<void>}\n   */\n  public async updateDatapoint<O>({\n    evalId,\n    datapointId,\n    scores,\n    executorOutput,\n  }: {\n    evalId: string;\n    datapointId: string;\n    scores: Record<string, number>;\n    executorOutput?: O;\n  }): Promise<void> {\n    const response = await fetch(\n      this.baseHttpUrl + `/v1/evals/${evalId}/datapoints/${datapointId}`,\n      {\n        method: \"POST\",\n        headers: this.headers(),\n        body: JSON.stringify({\n          executorOutput,\n          scores,\n        }),\n      },\n    );\n\n    if (!response.ok) {\n      await this.handleError(response);\n    }\n  }\n\n  /**\n   * Save evaluation datapoints.\n   *\n   * @param {Object} options - Save datapoints options\n   * @param {string} options.evalId - ID of the evaluation\n   * @param {EvaluationDatapoint<D, T, O>[]} options.datapoints - Datapoint to add\n   * @param {string} [options.groupName] - Group name of the evaluation\n   * @returns {Promise<void>} Response from the datapoint addition\n   */\n  public async saveDatapoints<D, T, O>({\n    evalId,\n    datapoints,\n    groupName,\n  }: {\n    evalId: string;\n    datapoints: EvaluationDatapoint<D, T, O>[];\n    groupName?: string;\n  }): Promise<void> {\n    const response = await fetch(this.baseHttpUrl + `/v1/evals/${evalId}/datapoints`, {\n      method: \"POST\",\n      headers: this.headers(),\n      body: JSON.stringify({\n        points: datapoints.map((d) => (\n          {\n            ...d,\n            data: slicePayload(d.data, INITIAL_EVALUATION_DATAPOINT_MAX_DATA_LENGTH),\n            target: slicePayload(d.target, INITIAL_EVALUATION_DATAPOINT_MAX_DATA_LENGTH),\n            executorOutput: slicePayload(\n              d.executorOutput,\n              INITIAL_EVALUATION_DATAPOINT_MAX_DATA_LENGTH,\n            ),\n          })),\n        groupName: groupName ?? null,\n      }),\n    });\n\n    if (response.status === 413) {\n      return await this.retrySaveDatapoints({\n        evalId,\n        datapoints,\n        groupName,\n      });\n    }\n\n    if (!response.ok) {\n      await this.handleError(response);\n    }\n  }\n\n  /**\n   * Get evaluation datapoints.\n   *\n   * @deprecated Use `client.datasets.pull()` instead.\n   * @param {Object} options - Get datapoints options\n   * @param {string} options.datasetName - Name of the dataset\n   * @param {number} options.offset - Offset at which to start the query\n   * @param {number} options.limit - Maximum number of datapoints to return\n   * @returns {Promise<GetDatapointsResponse>} Response from the datapoint retrieval\n   */\n  public async getDatapoints<D, T>({\n    datasetName,\n    offset,\n    limit,\n  }: {\n    datasetName: string;\n    offset: number;\n    limit: number;\n  }): Promise<GetDatapointsResponse<D, T>> {\n    logger.warn(\n      'evals.getDatapoints() is deprecated. Use client.datasets.pull() instead.',\n    );\n\n    const params = new URLSearchParams({\n      name: datasetName,\n      offset: offset.toString(),\n      limit: limit.toString(),\n    });\n    const response = await fetch(\n      this.baseHttpUrl + `/v1/datasets/datapoints?${params.toString()}`,\n      {\n        method: \"GET\",\n        headers: this.headers(),\n      },\n    );\n\n    if (!response.ok) {\n      await this.handleError(response);\n    }\n\n    return (await response.json()) as GetDatapointsResponse<D, T>;\n  }\n\n  private async retrySaveDatapoints<D, T, O>({\n    evalId,\n    datapoints,\n    groupName,\n    maxRetries = 25,\n    initialLength = INITIAL_EVALUATION_DATAPOINT_MAX_DATA_LENGTH,\n  }: {\n    evalId: string;\n    datapoints: EvaluationDatapoint<D, T, O>[];\n    groupName?: string;\n    maxRetries?: number;\n    initialLength?: number;\n  }): Promise<void> {\n    let length = initialLength;\n    let lastResponse: Response | null = null;\n    for (let i = 0; i < maxRetries; i++) {\n      logger.debug(`Retrying save datapoints... ${i + 1} of ${maxRetries}, length: ${length}`);\n      const response = await fetch(this.baseHttpUrl + `/v1/evals/${evalId}/datapoints`, {\n        method: \"POST\",\n        headers: this.headers(),\n        body: JSON.stringify({\n          points: datapoints.map((d) => (\n            {\n              ...d,\n              data: slicePayload(d.data, length),\n              target: slicePayload(d.target, length),\n              executorOutput: slicePayload(d.executorOutput, length),\n            })),\n          groupName: groupName ?? null,\n        }),\n      });\n      lastResponse = response;\n      length = Math.floor(length / 2);\n      if (response.status !== 413) {\n        break;\n      }\n    }\n    if (lastResponse && !lastResponse.ok) {\n      await this.handleError(lastResponse);\n    }\n  }\n}\n","import { type StringUUID } from \"@lmnr-ai/types\";\n\nimport { isStringUUID, otelSpanIdToUUID, otelTraceIdToUUID } from \"../utils\";\nimport { BaseResource } from \".\";\n\nenum EvaluatorScoreSourceType {\n  Evaluator = \"Evaluator\",\n  Code = \"Code\",\n}\n\ninterface CreateEvaluatorScoreBase {\n  name: string;\n  metadata?: Record<string, any>;\n  score: number;\n  source: EvaluatorScoreSourceType;\n}\n\ninterface CreateEvaluatorScoreRequestWithTraceId extends CreateEvaluatorScoreBase {\n  traceId: string;\n}\n\ninterface CreateEvaluatorScoreRequestWithSpanId extends CreateEvaluatorScoreBase {\n  spanId: string;\n}\n\ntype ScoreOptions =\n  | { name: string; metadata?: Record<string, any>; score: number; traceId: string; }\n  | { name: string; metadata?: Record<string, any>; score: number; spanId: string; };\n\n/**\n * Resource for creating evaluator scores\n */\nexport class EvaluatorsResource extends BaseResource {\n  constructor(baseHttpUrl: string, projectApiKey: string) {\n    super(baseHttpUrl, projectApiKey);\n  }\n\n  /**\n   * Create a score for a span or trace\n   *\n   * @param {ScoreOptions} options - Score creation options\n   * @param {string} options.name - Name of the score\n   * @param {string} [options.traceId] - The trace ID to score (will be attached to top-level span)\n   * @param {string} [options.spanId] - The span ID to score\n   * @param {Record<string, any>} [options.metadata] - Additional metadata\n   * @param {number} options.score - The score value (float)\n   * @returns {Promise<void>}\n   *\n   * @example\n   * // Score by trace ID (will attach to root span)\n   * await evaluators.score({\n   *   name: \"quality\",\n   *   traceId: \"trace-id-here\",\n   *   score: 0.95,\n   *   metadata: { model: \"gpt-4\" }\n   * });\n   *\n   * @example\n   * // Score by span ID\n   * await evaluators.score({\n   *   name: \"relevance\",\n   *   spanId: \"span-id-here\",\n   *   score: 0.87\n   * });\n   */\n  public async score(options: ScoreOptions): Promise<void> {\n    const { name, metadata, score } = options;\n\n    let payload: CreateEvaluatorScoreRequestWithTraceId | CreateEvaluatorScoreRequestWithSpanId;\n\n    if ('traceId' in options && options.traceId) {\n      const formattedTraceId = isStringUUID(options.traceId)\n        ? options.traceId\n        : otelTraceIdToUUID(options.traceId);\n\n      payload = {\n        name,\n        metadata,\n        score,\n        source: EvaluatorScoreSourceType.Code,\n        traceId: formattedTraceId,\n      };\n    } else if ('spanId' in options && options.spanId) {\n      const formattedSpanId = isStringUUID(options.spanId)\n        ? options.spanId\n        : otelSpanIdToUUID(options.spanId) as StringUUID;\n\n      payload = {\n        name,\n        metadata,\n        score,\n        source: EvaluatorScoreSourceType.Code,\n        spanId: formattedSpanId,\n      };\n    } else {\n      throw new Error(\"Either 'traceId' or 'spanId' must be provided.\");\n    }\n\n    const response = await fetch(this.baseHttpUrl + \"/v1/evaluators/score\", {\n      method: \"POST\",\n      headers: this.headers(),\n      body: JSON.stringify(payload),\n    });\n\n    if (!response.ok) {\n      await this.handleError(response);\n    }\n  }\n}\n","import { type CachedSpan, errorMessage } from \"@lmnr-ai/types\";\n\nimport { initializeLogger } from \"../utils\";\nimport { BaseResource } from \"./index\";\n\nconst logger = initializeLogger();\n\n/**\n * Result of a debug-replay cache lookup (debug-replay v2).\n *\n *  - `hit`  — the server served a cached response for this input hash; replay it\n *             and mark the span CACHED.\n *  - `miss` — no cache entry; the caller latches process-wide live mode and runs\n *             every subsequent call live.\n *  - `live` — run THIS call live without latching (server COLD warmup-timeout\n *             degrade, or any non-OK / transport error here).\n */\nexport type CacheOutcome =\n  | { kind: \"hit\"; cached: CachedSpan }\n  | { kind: \"miss\" }\n  | { kind: \"live\" };\n\n/**\n * Map the opaque HIT `response` payload onto a {@link CachedSpan} the provider\n * wrappers can replay. The server-side shape of `response` is not yet frozen\n * (app-server plan 01 leaves it as a `serde_json::Value`), so this stays\n * deliberately tolerant: the whole payload is serialized into `output` (the only\n * field the AI SDK wrapper's `parseCachedSpan` actually reads, via\n * `JSON.parse`), and a `finishReason` is surfaced into `attributes` when the\n * payload carries one. `name`/`input` are irrelevant to replay and left empty.\n */\nconst toCachedSpan = (response: unknown): CachedSpan => {\n  const output =\n    typeof response === \"string\" ? response : JSON.stringify(response ?? null);\n  const attributes: Record<string, any> = {};\n  if (\n    response !== null &&\n    typeof response === \"object\" &&\n    typeof (response as Record<string, unknown>).finishReason === \"string\"\n  ) {\n    attributes[\"ai.response.finishReason\"] = (\n      response as Record<string, unknown>\n    ).finishReason;\n  }\n  return { name: \"\", input: \"\", output, attributes };\n};\n\nexport class RolloutSessionsResource extends BaseResource {\n  constructor(baseHttpUrl: string, projectApiKey: string) {\n    super(baseHttpUrl, projectApiKey);\n  }\n\n  /**\n   * Idempotently register (upsert) a debug session on the backend, keyed on the\n   * SDK-supplied session id. The backend stores the row so the session is\n   * visible in the UI; a null/omitted name never clobbers a name set elsewhere.\n   *\n   * Returns the backend-resolved `projectId` (derived from the API key) so the\n   * caller can build the debugger URL; null if the body can't be parsed.\n   */\n  public async register({\n    sessionId,\n    name,\n  }: {\n    sessionId: string;\n    name?: string;\n  }): Promise<string | null> {\n    const response = await fetch(\n      `${this.baseHttpUrl}/v1/rollouts/${sessionId}`,\n      {\n        method: \"POST\",\n        headers: this.headers(),\n        body: JSON.stringify({ name }),\n      },\n    );\n\n    if (!response.ok) {\n      await this.handleError(response);\n    }\n\n    try {\n      const body = (await response.json()) as { projectId?: string };\n      return body.projectId ?? null;\n    } catch (e) {\n      logger.warn(\n        `Failed to parse rollout register response: ${errorMessage(e)}`,\n      );\n      return null;\n    }\n  }\n\n  /**\n   * Rename an existing debug session. Update-only: the backend returns 404 (and\n   * this throws) when the session id is unknown for the project, so a mistyped\n   * id surfaces as an error rather than silently creating a session. Creation\n   * stays the SDK's job via {@link register}.\n   */\n  public async setName({\n    sessionId,\n    name,\n  }: {\n    sessionId: string;\n    name: string;\n  }): Promise<void> {\n    const response = await fetch(\n      `${this.baseHttpUrl}/v1/rollouts/${sessionId}/name`,\n      {\n        method: \"PATCH\",\n        headers: this.headers(),\n        body: JSON.stringify({ name }),\n      },\n    );\n\n    if (!response.ok) {\n      await this.handleError(response);\n    }\n  }\n\n  /**\n   * Look up the debug-replay cache for a single LLM call (debug-replay v2).\n   *\n   * The server is keyed by `inputHash` (hex blake3 of the canonicalized,\n   * system-stripped input messages). It returns one of three outcomes:\n   *   - `{ outcome: \"hit\", response }` — a cached response to replay.\n   *   - `{ outcome: \"miss\" }`          — no entry; caller latches live mode.\n   *   - `{ outcome: \"live\" }`          — run this call live (COLD degrade).\n   *\n   * Error posture: a non-OK response or a transport error degrades to\n   * `{ kind: \"live\" }` for THIS call only — it never throws and never latches\n   * the process-wide live flag (only a real MISS does that). This keeps a flaky\n   * cache backend from turning a replay into a crash.\n   */\n  public async cache({\n    sessionId,\n    replayTraceId,\n    cacheUntil,\n    inputHash,\n  }: {\n    sessionId: string;\n    replayTraceId: string;\n    cacheUntil: string;\n    inputHash: string;\n  }): Promise<CacheOutcome> {\n    let response: Response;\n    try {\n      response = await fetch(\n        `${this.baseHttpUrl}/v1/rollouts/${sessionId}/cache`,\n        {\n          method: \"POST\",\n          headers: this.headers(),\n          body: JSON.stringify({ replayTraceId, cacheUntil, inputHash }),\n        },\n      );\n    } catch (e) {\n      logger.warn(`Debug cache lookup failed, running live: ${errorMessage(e)}`);\n      return { kind: \"live\" };\n    }\n\n    if (!response.ok) {\n      logger.warn(\n        `Debug cache lookup returned ${response.status}, running live`,\n      );\n      return { kind: \"live\" };\n    }\n\n    let body: { outcome?: string; response?: unknown };\n    try {\n      body = (await response.json()) as { outcome?: string; response?: unknown };\n    } catch (e) {\n      logger.warn(\n        `Failed to parse debug cache response, running live: ${errorMessage(e)}`,\n      );\n      return { kind: \"live\" };\n    }\n\n    switch (body.outcome) {\n      case \"hit\":\n        // A HIT with no replayable payload (missing / JSON `null` response) is\n        // useless: serializing it would store the string \"null\", which parses\n        // back to `null` and crashes reconstruction. Degrade to live instead.\n        if (body.response === null || body.response === undefined) {\n          logger.warn(\"Debug cache HIT had no response payload, running live\");\n          return { kind: \"live\" };\n        }\n        return { kind: \"hit\", cached: toCachedSpan(body.response) };\n      case \"miss\":\n        return { kind: \"miss\" };\n      case \"live\":\n        return { kind: \"live\" };\n      default:\n        logger.warn(\n          `Unknown debug cache outcome \"${body.outcome}\", running live`,\n        );\n        return { kind: \"live\" };\n    }\n  }\n\n  public async delete({ sessionId }: { sessionId: string }): Promise<void> {\n    const response = await fetch(\n      `${this.baseHttpUrl}/v1/rollouts/${sessionId}`,\n      {\n        method: \"DELETE\",\n        headers: this.headers(),\n      },\n    );\n\n    if (!response.ok) {\n      await this.handleError(response);\n    }\n  }\n}\n","import { BaseResource } from \"./index\";\n\nexport class SqlResource extends BaseResource {\n  constructor(baseHttpUrl: string, projectApiKey: string) {\n    super(baseHttpUrl, projectApiKey);\n  }\n\n  public async query(\n    sql: string,\n    parameters: Record<string, any> = {},\n  ): Promise<Array<Record<string, any>>> {\n    const response = await fetch(`${this.baseHttpUrl}/v1/sql/query`, {\n      method: \"POST\",\n      headers: {\n        ...this.headers(),\n      },\n      body: JSON.stringify({\n        query: sql,\n        parameters,\n      }),\n    });\n\n    if (!response.ok) {\n      await this.handleError(response);\n    }\n\n    return (await response.json()).data as Array<Record<string, any>>;\n  }\n}\n","/** Resource for tagging traces. */\n\n\nimport { isStringUUID, otelTraceIdToUUID } from \"../utils\";\nimport { BaseResource } from \"./index\";\n\nexport class TagsResource extends BaseResource {\n  /** Resource for tagging traces. */\n  constructor(baseHttpUrl: string, projectApiKey: string) {\n    super(baseHttpUrl, projectApiKey);\n  }\n\n  /**\n   * Tag a trace with a list of tags. Note that the trace must be ended before\n   * tagging it. You may want to call `await Laminar.flush()` after the trace\n   * that you want to tag.\n   *\n   * @param {string | StringUUID} trace_id - The trace id to tag.\n   * @param {string[] | string} tags - The tag or list of tags to add to the trace.\n   * @returns {Promise<any>} The response from the server.\n   * @example\n   * ```javascript\n   * import { Laminar, observe, LaminarClient } from \"@lmnr-ai/lmnr\";\n   * Laminar.initialize();\n   * const client = new LaminarClient();\n   * let traceId: StringUUID | null = null;\n   * // Make sure this is called outside of traced context.\n   * await observe(\n   *   {\n   *     name: \"my-trace\",\n   *   },\n   *   async () => {\n   *     traceId = await Laminar.getTraceId();\n   *     await foo();\n   *   },\n   * );\n   *\n   * // or make sure the trace is ended by this point.\n   * await Laminar.flush();\n   * if (traceId) {\n   *   await client.tags.tag(traceId, [\"tag1\", \"tag2\"]);\n   * }\n   * ```\n   */\n  public async tag(\n    trace_id: string,\n    tags: string[] | string,\n  ): Promise<any> {\n    const traceTags = Array.isArray(tags) ? tags : [tags];\n    const formattedTraceId = isStringUUID(trace_id)\n      ? trace_id\n      : otelTraceIdToUUID(trace_id);\n\n    const url = this.baseHttpUrl + \"/v1/tag\";\n    const payload = {\n      \"traceId\": formattedTraceId,\n      \"names\": traceTags,\n    };\n    const response = await fetch(\n      url,\n      {\n        method: \"POST\",\n        headers: this.headers(),\n        body: JSON.stringify(payload),\n      },\n    );\n    if (!response.ok) {\n      await this.handleError(response);\n    }\n    return response.json();\n  }\n}\n","/** Resource for post-factum operations on existing traces. */\n\nimport { initializeLogger, isStringUUID, otelTraceIdToUUID } from \"../utils\";\nimport { BaseResource } from \"./index\";\n\nconst logger = initializeLogger();\n\nexport class TracesResource extends BaseResource {\n  /** Resource for post-factum operations on existing traces. */\n  constructor(baseHttpUrl: string, projectApiKey: string) {\n    super(baseHttpUrl, projectApiKey);\n  }\n\n  /**\n   * Push a metadata patch to an existing trace.\n   *\n   * The patch is shallow-merged server-side into the trace's existing metadata\n   * (`existing || patch`, last-write-wins per top-level key). Useful for\n   * attaching post-factum signals — quality scores, human edits, triage labels —\n   * to a trace that has already finished. The patch does NOT extend `endTime`\n   * or change tokens / cost / top span / tags / span names. `numSpans` is\n   * incremented by 1 (paid by the virtual span that carried the patch through\n   * the ingestion queue) so the new ClickHouse row beats the prior version on\n   * `ReplacingMergeTree(numSpans)`. No row is added to the `spans` table.\n   *\n   * Compared to `Laminar.setTraceMetadata` (which sets metadata on the\n   * currently in-flight trace via OpenTelemetry attributes), this method\n   * operates on a finished trace by trace id, so it must be called after the\n   * trace has been flushed.\n   *\n   * A 404 response (the trace was not found in the project — typically because\n   * it has not been flushed yet) is logged as a warning and the call returns\n   * without throwing, since the 404 may be expected when pushing too soon\n   * after the trace run. Pass `failOnNotFound: true` to throw instead (e.g.\n   * CLI callers that must report the failure). Any other non-OK status throws.\n   *\n   * @param traceId - The trace id to push metadata to. Accepts a UUID string\n   *   or a 32-char OTel hex trace id.\n   * @param metadata - The metadata patch. Top-level keys are merged into the\n   *   trace's existing metadata. Must be non-empty (the server rejects empty\n   *   patches with 400).\n   * @param options - `failOnNotFound`: throw on 404 instead of warn-and-return.\n   * @example\n   * ```typescript\n   * import { Laminar, observe, LaminarClient } from \"@lmnr-ai/lmnr\";\n   * Laminar.initialize();\n   * const client = new LaminarClient();\n   *\n   * let traceId: string | null = null;\n   * await observe({ name: \"generate\" }, async () => {\n   *   traceId = await Laminar.getTraceId();\n   * });\n   * await Laminar.flush();\n   *\n   * if (traceId) {\n   *   await client.traces.pushMetadata(traceId, {\n   *     score: 0.85,\n   *     reviewer: \"alice\",\n   *     needsReview: false,\n   *   });\n   * }\n   * ```\n   */\n  public async pushMetadata(\n    traceId: string,\n    metadata: Record<string, unknown>,\n    options?: { failOnNotFound?: boolean },\n  ): Promise<void> {\n    if (!metadata || Object.keys(metadata).length === 0) {\n      throw new Error(\"metadata must be a non-empty object\");\n    }\n\n    const formattedTraceId = isStringUUID(traceId)\n      ? traceId\n      : otelTraceIdToUUID(traceId);\n\n    const url = this.baseHttpUrl + \"/v1/traces/metadata\";\n    const response = await fetch(url, {\n      method: \"POST\",\n      headers: this.headers(),\n      body: JSON.stringify({\n        traceId: formattedTraceId,\n        metadata,\n      }),\n    });\n\n    if (response.status === 404) {\n      const message =\n        `Trace ${formattedTraceId} not found. The trace may not have been ` +\n        \"flushed yet — call await Laminar.flush() and retry.\";\n      if (options?.failOnNotFound) {\n        throw new Error(message);\n      }\n      // Trace not found in this project — likely not flushed yet. Don't throw,\n      // but surface a warning so callers debugging an empty patch see it.\n      logger.warn(message);\n      return;\n    }\n\n    if (!response.ok) {\n      await this.handleError(response);\n    }\n  }\n}\n","import { BrowserEventsResource } from \"./resources/browser-events\";\nimport { DatasetsResource } from \"./resources/datasets\";\nimport { EvalsResource } from \"./resources/evals\";\nimport { EvaluatorsResource } from \"./resources/evaluators\";\nimport { RolloutSessionsResource } from \"./resources/rollout-sessions\";\nimport { SqlResource } from \"./resources/sql\";\nimport { TagsResource } from \"./resources/tags\";\nimport { TracesResource } from \"./resources/traces\";\nimport { loadEnv } from \"./utils\";\n\nexport class LaminarClient {\n  private baseUrl: string;\n  private projectApiKey: string;\n  private _browserEvents: BrowserEventsResource;\n  private _datasets: DatasetsResource;\n  private _evals: EvalsResource;\n  private _evaluators: EvaluatorsResource;\n  private _rolloutSessions: RolloutSessionsResource;\n  private _sql: SqlResource;\n  private _tags: TagsResource;\n  private _traces: TracesResource;\n\n  constructor({\n    baseUrl,\n    projectApiKey,\n    port,\n  }: {\n    baseUrl?: string,\n    projectApiKey?: string,\n    port?: number,\n  } = {}) {\n    loadEnv();\n    this.projectApiKey = projectApiKey ?? process.env.LMNR_PROJECT_API_KEY!;\n    const httpPort = port ?? (\n      baseUrl?.match(/:\\d{1,5}$/g)\n        ? parseInt(baseUrl.match(/:\\d{1,5}$/g)![0].slice(1))\n        : 443);\n    const baseUrlNoPort = (baseUrl ?? process.env.LMNR_BASE_URL)\n      ?.replace(/\\/$/, '').replace(/:\\d{1,5}$/g, '');\n    this.baseUrl = `${baseUrlNoPort ?? 'https://api.lmnr.ai'}:${httpPort}`;\n    this._browserEvents = new BrowserEventsResource(this.baseUrl, this.projectApiKey);\n    this._datasets = new DatasetsResource(this.baseUrl, this.projectApiKey);\n    this._evals = new EvalsResource(this.baseUrl, this.projectApiKey);\n    this._evaluators = new EvaluatorsResource(this.baseUrl, this.projectApiKey);\n    this._rolloutSessions = new RolloutSessionsResource(this.baseUrl, this.projectApiKey);\n    this._sql = new SqlResource(this.baseUrl, this.projectApiKey);\n    this._tags = new TagsResource(this.baseUrl, this.projectApiKey);\n    this._traces = new TracesResource(this.baseUrl, this.projectApiKey);\n  }\n\n  public get browserEvents() {\n    return this._browserEvents;\n  }\n\n  public get datasets() {\n    return this._datasets;\n  }\n\n  public get evals() {\n    return this._evals;\n  }\n\n  public get evaluators() {\n    return this._evaluators;\n  }\n\n  public get rolloutSessions() {\n    return this._rolloutSessions;\n  }\n\n  public get sql() {\n    return this._sql;\n  }\n\n  public get tags() {\n    return this._tags;\n  }\n\n  public get traces() {\n    return this._traces;\n  }\n}\n\nexport {\n  type CacheOutcome,\n  RolloutSessionsResource,\n} from \"./resources/rollout-sessions\";\n"],"mappings":"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"}
+{"version":3,"file":"index.cjs","names":["SDK_VERSION","logger","logger","logger","logger"],"sources":["../package.json","../src/version.ts","../src/resources/index.ts","../src/resources/browser-events.ts","../src/resources/cli.ts","../src/utils.ts","../src/resources/datasets.ts","../src/resources/evals.ts","../src/resources/evaluators.ts","../src/resources/rollout-sessions.ts","../src/resources/sql.ts","../src/resources/tags.ts","../src/resources/traces.ts","../src/index.ts"],"sourcesContent":["","// Version detection for runtime environment\nexport function getLangVersion(): string | null {\n  if (typeof process !== 'undefined' && process.versions && process.versions.node) {\n    return `node-${process.versions.node}`;\n  }\n  if (typeof navigator !== 'undefined' && navigator.userAgent) {\n    return `browser-${navigator.userAgent}`;\n  }\n  return null;\n}\n","/**\n * Unified auth for every resource. A discriminated union so a single object\n * drives both the URL prefix and the request headers:\n *\n *  - `apiKey`    → project API key (SDK / app surfaces). Routes to `/v1/*`,\n *    Bearer is the project key, no `x-lmnr-project-id` header.\n *  - `userToken` → BetterAuth user access JWT (the CLI user-token surface).\n *    Routes to `/v1/cli/*`, Bearer is the JWT, carries the target project in\n *    the `x-lmnr-project-id` header.\n */\nexport type LaminarAuth =\n  | { type: \"apiKey\"; key: string }\n  | { type: \"userToken\"; token: string; projectId: string };\n\nclass BaseResource {\n  protected readonly baseHttpUrl: string;\n  protected readonly auth: LaminarAuth;\n  /** The bearer credential, regardless of auth type (project key or user JWT). */\n  protected readonly credential: string;\n\n  constructor(baseHttpUrl: string, auth: LaminarAuth) {\n    this.baseHttpUrl = baseHttpUrl;\n    this.auth = auth;\n    this.credential = auth.type === \"apiKey\" ? auth.key : auth.token;\n  }\n\n  /** API path prefix: `/v1/cli` for CLI user-token auth, `/v1` otherwise. */\n  protected get apiPrefix(): string {\n    return this.auth.type === \"userToken\" ? \"/v1/cli\" : \"/v1\";\n  }\n\n  protected headers() {\n    return {\n      Authorization: `Bearer ${this.credential}`,\n      \"Content-Type\": \"application/json\",\n      Accept: \"application/json\",\n      ...(this.auth.type === \"userToken\"\n        ? { \"x-lmnr-project-id\": this.auth.projectId }\n        : {}),\n    };\n  }\n\n  protected async handleError(response: Response) {\n    const errorMsg = await response.text();\n    throw new Error(`${response.status} ${errorMsg}`);\n  }\n}\n\nexport { BaseResource };\n","import { version as SDK_VERSION } from '../../package.json';\nimport { getLangVersion } from \"../version\";\nimport { BaseResource, type LaminarAuth } from \"./index\";\n\nexport class BrowserEventsResource extends BaseResource {\n  constructor(baseHttpUrl: string, auth: LaminarAuth) {\n    super(baseHttpUrl, auth);\n  }\n\n  public async send({\n    sessionId,\n    traceId,\n    events,\n  }: {\n    sessionId: string;\n    traceId: string;\n    events: Record<string, any>[];\n  }): Promise<void> {\n    const payload = {\n      sessionId,\n      traceId,\n      events,\n      source: getLangVersion() ?? 'javascript',\n      sdkVersion: SDK_VERSION,\n    };\n\n    const jsonString = JSON.stringify(payload);\n    const blob = new Blob([jsonString], { type: 'application/json' });\n    const compressedStream = blob.stream().pipeThrough(new CompressionStream('gzip'));\n    const compressedResponse = new Response(compressedStream);\n    const compressedData = await compressedResponse.arrayBuffer();\n\n    const response = await fetch(this.baseHttpUrl + \"/v1/browser-sessions/events\", {\n      method: \"POST\",\n      headers: {\n        ...this.headers(),\n        'Content-Encoding': 'gzip',\n      },\n      body: compressedData,\n    });\n\n    if (!response.ok) {\n      await this.handleError(response);\n    }\n  }\n}\n","import { BaseResource, type LaminarAuth } from \"./index\";\n\nexport interface CliProject {\n  id: string;\n  name: string;\n  workspaceId: string;\n  workspaceName: string;\n}\n\n/**\n * User-scoped CLI endpoints that don't target a specific project. Authed by the\n * BetterAuth user JWT (the `credential`); deliberately does NOT send an\n * `x-lmnr-project-id` header (these routes are project discovery, pre-selection).\n *\n * Discovery exception: this resource always hits `/v1/cli/projects` with the\n * bare bearer and overrides `BaseResource.headers()`/`apiPrefix`, so it works\n * even when constructed with a `userToken` auth that has no real project id yet.\n */\nexport class CliResource extends BaseResource {\n  constructor(baseHttpUrl: string, auth: LaminarAuth) {\n    super(baseHttpUrl, auth);\n  }\n\n  /** Workspaces + projects the authenticated user can access. */\n  public async listProjects(): Promise<CliProject[]> {\n    const response = await fetch(`${this.baseHttpUrl}/v1/cli/projects`, {\n      method: \"GET\",\n      headers: {\n        Authorization: `Bearer ${this.credential}`,\n        Accept: \"application/json\",\n      },\n    });\n    if (!response.ok) {\n      await this.handleError(response);\n    }\n    // Coerce a missing/non-array `projects` to [] so callers (.length/.map)\n    // don't throw. A malformed body on a 2xx is exceptional — let it surface.\n    const body = (await response.json()) as { projects?: CliProject[] };\n    return Array.isArray(body?.projects) ? body.projects : [];\n  }\n}\n","import { type StringUUID } from '@lmnr-ai/types';\nimport { config } from 'dotenv';\nimport * as path from 'path';\nimport pino, { Level } from 'pino';\nimport { PinoPretty } from 'pino-pretty';\nimport { v4 as uuidv4 } from 'uuid';\n\nexport function initializeLogger(options?: { colorize?: boolean; level?: Level }) {\n  const colorize = options?.colorize ?? true;\n  const level =\n    options?.level ??\n    (process.env.LMNR_LOG_LEVEL?.toLowerCase()?.trim() as Level) ??\n    'info';\n\n  return pino(\n    {\n      level,\n    },\n    PinoPretty({\n      colorize,\n      minimumLevel: level,\n    }),\n  );\n}\n\nconst logger = initializeLogger();\n\nexport const isStringUUID = (id: string): id is StringUUID =>\n  /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/.test(id);\n\nexport const NIL_UUID: StringUUID = '00000000-0000-0000-0000-000000000000';\n\nexport const newUUID = (): StringUUID => {\n  // crypto.randomUUID is available in most of the modern browsers and node,\n  // but is not available in \"insecure\" contexts, e.g. not https, not localhost\n  // so we fallback to uuidv4 in those cases, which is less secure, but works\n  // just fine.\n  if (typeof crypto !== 'undefined' && typeof crypto.randomUUID === 'function') {\n    return crypto.randomUUID();\n  } else {\n    return uuidv4() as `${string}-${string}-${string}-${string}-${string}`;\n  }\n};\n\nexport const otelSpanIdToUUID = (spanId: string): string => {\n  let id = spanId.toLowerCase();\n  if (id.startsWith('0x')) {\n    id = id.slice(2);\n  }\n  if (id.length !== 16) {\n    logger.warn(\n      `Span ID ${spanId} is not 16 hex chars long. ` +\n      'This is not a valid OpenTelemetry span ID.',\n    );\n  }\n\n  if (!/^[0-9a-f]+$/.test(id)) {\n    logger.error(\n      `Span ID ${spanId} is not a valid hex string. ` +\n      'Generating a random UUID instead.',\n    );\n    return newUUID();\n  }\n\n  return id.padStart(32, '0').replace(\n    /^([0-9a-f]{8})([0-9a-f]{4})([0-9a-f]{4})([0-9a-f]{4})([0-9a-f]{12})$/,\n    '$1-$2-$3-$4-$5',\n  );\n};\n\nexport const otelTraceIdToUUID = (traceId: string): StringUUID => {\n  let id = traceId.toLowerCase();\n  if (id.startsWith('0x')) {\n    id = id.slice(2);\n  }\n  if (id.length !== 32) {\n    logger.warn(\n      `Trace ID ${traceId} is not 32 hex chars long. ` +\n      'This is not a valid OpenTelemetry trace ID.',\n    );\n  }\n  if (!/^[0-9a-f]+$/.test(id)) {\n    logger.error(\n      `Trace ID ${traceId} is not a valid hex string. ` +\n      'Generating a random UUID instead.',\n    );\n    return newUUID();\n  }\n\n  return id.replace(\n    /^([0-9a-f]{8})([0-9a-f]{4})([0-9a-f]{4})([0-9a-f]{4})([0-9a-f]{12})$/,\n    '$1-$2-$3-$4-$5',\n  ) as StringUUID;\n};\n\nexport const slicePayload = <T>(value: T, length: number) => {\n  if (value === null || value === undefined) {\n    return value;\n  }\n\n  const str = JSON.stringify(value);\n  if (str.length <= length) {\n    return value;\n  }\n\n  return str.slice(0, length) + '...';\n};\n\nexport const loadEnv = (\n  options?: {\n    quiet?: boolean;\n    paths?: string[];\n  },\n): void => {\n  const nodeEnv = process.env.NODE_ENV || 'development';\n  const envDir = process.cwd();\n\n  // Files to load in order (lowest to highest priority)\n  // Later files override earlier ones\n  const envFiles = [\n    '.env',\n    '.env.local',\n    `.env.${nodeEnv}`,\n    `.env.${nodeEnv}.local`,\n  ];\n\n  const logLevel = process.env.LMNR_LOG_LEVEL ?? 'info';\n  const verbose = ['debug', 'trace'].includes(logLevel.trim().toLowerCase());\n\n  const quiet = options?.quiet ?? !verbose;\n\n  config({\n    path: options?.paths ?? envFiles.map((envFile) => path.resolve(envDir, envFile)),\n    quiet,\n  });\n};\n","import {\n  type Datapoint,\n  type Dataset,\n  type GetDatapointsResponse,\n  type PushDatapointsResponse,\n  type StringUUID,\n} from \"@lmnr-ai/types\";\n\nimport { initializeLogger } from \"../utils\";\nimport { BaseResource, type LaminarAuth } from \".\";\n\nconst logger = initializeLogger();\nconst DEFAULT_DATASET_PULL_LIMIT = 100;\nconst DEFAULT_DATASET_PUSH_BATCH_SIZE = 100;\n\nexport class DatasetsResource extends BaseResource {\n  constructor(baseHttpUrl: string, auth: LaminarAuth) {\n    super(baseHttpUrl, auth);\n  }\n\n  /**\n   * List all datasets.\n   *\n   * @returns {Promise<Dataset[]>} Array of datasets\n   */\n  public async listDatasets(): Promise<Dataset[]> {\n    const response = await fetch(this.baseHttpUrl + this.apiPrefix + \"/datasets\", {\n      method: \"GET\",\n      headers: this.headers(),\n    });\n\n    if (!response.ok) {\n      await this.handleError(response);\n    }\n\n    return response.json() as Promise<Dataset[]>;\n  }\n\n  /**\n   * Get a dataset by name.\n   *\n   * @param {string} name - Name of the dataset\n   * @returns {Promise<Dataset[]>} Array of datasets with matching name\n   */\n  public async getDatasetByName(name: string): Promise<Dataset[]> {\n    const params = new URLSearchParams({ name });\n    const response = await fetch(\n      this.baseHttpUrl + `${this.apiPrefix}/datasets?${params.toString()}`,\n      {\n        method: \"GET\",\n        headers: this.headers(),\n      },\n    );\n\n    if (!response.ok) {\n      await this.handleError(response);\n    }\n\n    return response.json() as Promise<Dataset[]>;\n  }\n\n  /**\n   * Push datapoints to a dataset.\n   *\n   * @param {Object} options - Push options\n   * @param {Datapoint<D, T>[]} options.points - Datapoints to push\n   * @param {string} [options.name] - Name of the dataset (either name or id must be provided)\n   * @param {StringUUID} [options.id] - ID of the dataset (either name or id must be provided)\n   * @param {number} [options.batchSize] - Batch size for pushing (default: 100)\n   * @param {boolean} [options.createDataset] - Whether to create the dataset if it doesn't exist\n   * @returns {Promise<PushDatapointsResponse | undefined>}\n   */\n  public async push<D, T>({\n    points,\n    name,\n    id,\n    batchSize = DEFAULT_DATASET_PUSH_BATCH_SIZE,\n    createDataset = false,\n  }: {\n    points: Datapoint<D, T>[];\n    name?: string;\n    id?: StringUUID;\n    batchSize?: number;\n    createDataset?: boolean;\n  }): Promise<PushDatapointsResponse | undefined> {\n    if (!name && !id) {\n      throw new Error(\"Either name or id must be provided\");\n    }\n\n    if (name && id) {\n      throw new Error(\"Only one of name or id must be provided\");\n    }\n\n    if (createDataset && !name) {\n      throw new Error(\"Name must be provided when creating a new dataset\");\n    }\n\n    const identifier = name ? { name } : { datasetId: id! };\n    const totalBatches = Math.ceil(points.length / batchSize);\n\n    let response: PushDatapointsResponse | undefined;\n    for (let i = 0; i < points.length; i += batchSize) {\n      const batchNum = Math.floor(i / batchSize) + 1;\n      logger.debug(`Pushing batch ${batchNum} of ${totalBatches}`);\n\n      const batch = points.slice(i, i + batchSize);\n      const fetchResponse = await fetch(\n        this.baseHttpUrl + this.apiPrefix + \"/datasets/datapoints\",\n        {\n          method: \"POST\",\n          headers: this.headers(),\n          body: JSON.stringify({\n            ...identifier,\n            datapoints: batch.map((point) => ({\n              data: point.data,\n              target: point.target ?? {},\n              metadata: point.metadata ?? {},\n            })),\n            createDataset,\n          }),\n        },\n      );\n\n      // 201 when creating a new dataset\n      if (fetchResponse.status !== 200 && fetchResponse.status !== 201) {\n        await this.handleError(fetchResponse);\n      }\n\n      response = (await fetchResponse.json()) as PushDatapointsResponse;\n    }\n\n    return response;\n  }\n\n  /**\n   * Pull datapoints from a dataset.\n   *\n   * @param {Object} options - Pull options\n   * @param {string} [options.name] - Name of the dataset (either name or id must be provided)\n   * @param {StringUUID} [options.id] - ID of the dataset (either name or id must be provided)\n   * @param {number} [options.limit] - Maximum number of datapoints to return (default: 100)\n   * @param {number} [options.offset] - Offset for pagination (default: 0)\n   * @returns {Promise<GetDatapointsResponse<D, T>>}\n   */\n  public async pull<D, T>({\n    name,\n    id,\n    limit = DEFAULT_DATASET_PULL_LIMIT,\n    offset = 0,\n  }: {\n    name?: string;\n    id?: StringUUID;\n    limit?: number;\n    offset?: number;\n  }): Promise<GetDatapointsResponse<D, T>> {\n    if (!name && !id) {\n      throw new Error(\"Either name or id must be provided\");\n    }\n\n    if (name && id) {\n      throw new Error(\"Only one of name or id must be provided\");\n    }\n\n    const paramsObj: Record<string, string> = {\n      offset: offset.toString(),\n      limit: limit.toString(),\n    };\n\n    if (name) {\n      paramsObj.name = name;\n    } else {\n      paramsObj.datasetId = id!;\n    }\n\n    const params = new URLSearchParams(paramsObj);\n\n    const response = await fetch(\n      this.baseHttpUrl + `${this.apiPrefix}/datasets/datapoints?${params.toString()}`,\n      {\n        method: \"GET\",\n        headers: this.headers(),\n      },\n    );\n\n    if (!response.ok) {\n      await this.handleError(response);\n    }\n\n    return response.json() as Promise<GetDatapointsResponse<D, T>>;\n  }\n}\n","import {\n  type EvaluationDatapoint,\n  type GetDatapointsResponse,\n  type InitEvaluationResponse,\n  type StringUUID,\n} from \"@lmnr-ai/types\";\n\nimport { initializeLogger, newUUID, slicePayload } from \"../utils\";\nimport { BaseResource, type LaminarAuth } from \".\";\n\nconst logger = initializeLogger();\nconst INITIAL_EVALUATION_DATAPOINT_MAX_DATA_LENGTH = 16_000_000; // 16MB\n\nexport class EvalsResource extends BaseResource {\n  constructor(baseHttpUrl: string, auth: LaminarAuth) {\n    super(baseHttpUrl, auth);\n  }\n\n  /**\n   * Initialize an evaluation.\n   *\n   * @param {string} name - Name of the evaluation\n   * @param {string} groupName - Group name of the evaluation\n   * @param {Record<string, any>} metadata - Optional metadata\n   * @returns {Promise<InitEvaluationResponse>} Response from the evaluation initialization\n   */\n  public async init(\n    name?: string,\n    groupName?: string,\n    metadata?: Record<string, any>,\n  ): Promise<InitEvaluationResponse> {\n    const response = await fetch(this.baseHttpUrl + \"/v1/evals\", {\n      method: \"POST\",\n      headers: this.headers(),\n      body: JSON.stringify({\n        name: name ?? null,\n        groupName: groupName ?? null,\n        metadata: metadata ?? null,\n      }),\n    });\n\n    if (!response.ok) {\n      await this.handleError(response);\n    }\n\n    return response.json() as Promise<InitEvaluationResponse>;\n  }\n\n  /**\n   * Create a new evaluation and return its ID.\n   *\n   * @param {string} [name] - Optional name of the evaluation\n   * @param {string} [groupName] - An identifier to group evaluations\n   * @param {Record<string, any>} [metadata] - Optional metadata\n   * @returns {Promise<StringUUID>} The evaluation ID\n   */\n\n  public async create(args?: {\n    name?: string, groupName?: string, metadata?: Record<string, any>\n  }): Promise<StringUUID> {\n    const evaluation = await this.init(args?.name, args?.groupName, args?.metadata);\n    return evaluation.id;\n  }\n\n  /**\n   * Create a new evaluation and return its ID.\n   * @deprecated use `create` instead.\n   */\n  public async createEvaluation(\n    name?: string,\n    groupName?: string,\n    metadata?: Record<string, any>,\n  ): Promise<StringUUID> {\n    const evaluation = await this.init(name, groupName, metadata);\n    return evaluation.id;\n  }\n\n  /**\n   * Create a datapoint for an evaluation.\n   *\n   * @param {Object} options - Create datapoint options\n   * @param {string} options.evalId - The evaluation ID\n   * @param {D} options.data - The input data for the executor\n   * @param {T} [options.target] - The target/expected output for evaluators\n   * @param {Record<string, any>} [options.metadata] - Optional metadata\n   * @param {number} [options.index] - Optional index of the datapoint\n   * @param {string} [options.traceId] - Optional trace ID\n   * @returns {Promise<StringUUID>} The datapoint ID\n   */\n  public async createDatapoint<D, T>({\n    evalId,\n    data,\n    target,\n    metadata,\n    index,\n    traceId,\n  }: {\n    evalId: string;\n    data: D;\n    target?: T;\n    metadata?: Record<string, any>;\n    index?: number;\n    traceId?: string;\n  }): Promise<StringUUID> {\n    const datapointId = newUUID();\n\n    const partialDatapoint: EvaluationDatapoint<D, T, any> = {\n      id: datapointId,\n      data,\n      target,\n      index: index ?? 0,\n      traceId: traceId ?? newUUID(),\n      executorSpanId: newUUID(),\n      metadata,\n    };\n\n    await this.saveDatapoints({\n      evalId,\n      datapoints: [partialDatapoint],\n    });\n\n    return datapointId;\n  }\n\n  /**\n   * Update a datapoint with evaluation results.\n   *\n   * @param {Object} options - Update datapoint options\n   * @param {string} options.evalId - The evaluation ID\n   * @param {string} options.datapointId - The datapoint ID\n   * @param {Record<string, number>} options.scores - The scores\n   * @param {O} [options.executorOutput] - The executor output\n   * @returns {Promise<void>}\n   */\n  public async updateDatapoint<O>({\n    evalId,\n    datapointId,\n    scores,\n    executorOutput,\n  }: {\n    evalId: string;\n    datapointId: string;\n    scores: Record<string, number>;\n    executorOutput?: O;\n  }): Promise<void> {\n    const response = await fetch(\n      this.baseHttpUrl + `/v1/evals/${evalId}/datapoints/${datapointId}`,\n      {\n        method: \"POST\",\n        headers: this.headers(),\n        body: JSON.stringify({\n          executorOutput,\n          scores,\n        }),\n      },\n    );\n\n    if (!response.ok) {\n      await this.handleError(response);\n    }\n  }\n\n  /**\n   * Save evaluation datapoints.\n   *\n   * @param {Object} options - Save datapoints options\n   * @param {string} options.evalId - ID of the evaluation\n   * @param {EvaluationDatapoint<D, T, O>[]} options.datapoints - Datapoint to add\n   * @param {string} [options.groupName] - Group name of the evaluation\n   * @returns {Promise<void>} Response from the datapoint addition\n   */\n  public async saveDatapoints<D, T, O>({\n    evalId,\n    datapoints,\n    groupName,\n  }: {\n    evalId: string;\n    datapoints: EvaluationDatapoint<D, T, O>[];\n    groupName?: string;\n  }): Promise<void> {\n    const response = await fetch(this.baseHttpUrl + `/v1/evals/${evalId}/datapoints`, {\n      method: \"POST\",\n      headers: this.headers(),\n      body: JSON.stringify({\n        points: datapoints.map((d) => (\n          {\n            ...d,\n            data: slicePayload(d.data, INITIAL_EVALUATION_DATAPOINT_MAX_DATA_LENGTH),\n            target: slicePayload(d.target, INITIAL_EVALUATION_DATAPOINT_MAX_DATA_LENGTH),\n            executorOutput: slicePayload(\n              d.executorOutput,\n              INITIAL_EVALUATION_DATAPOINT_MAX_DATA_LENGTH,\n            ),\n          })),\n        groupName: groupName ?? null,\n      }),\n    });\n\n    if (response.status === 413) {\n      return await this.retrySaveDatapoints({\n        evalId,\n        datapoints,\n        groupName,\n      });\n    }\n\n    if (!response.ok) {\n      await this.handleError(response);\n    }\n  }\n\n  /**\n   * Get evaluation datapoints.\n   *\n   * @deprecated Use `client.datasets.pull()` instead.\n   * @param {Object} options - Get datapoints options\n   * @param {string} options.datasetName - Name of the dataset\n   * @param {number} options.offset - Offset at which to start the query\n   * @param {number} options.limit - Maximum number of datapoints to return\n   * @returns {Promise<GetDatapointsResponse>} Response from the datapoint retrieval\n   */\n  public async getDatapoints<D, T>({\n    datasetName,\n    offset,\n    limit,\n  }: {\n    datasetName: string;\n    offset: number;\n    limit: number;\n  }): Promise<GetDatapointsResponse<D, T>> {\n    logger.warn(\n      'evals.getDatapoints() is deprecated. Use client.datasets.pull() instead.',\n    );\n\n    const params = new URLSearchParams({\n      name: datasetName,\n      offset: offset.toString(),\n      limit: limit.toString(),\n    });\n    const response = await fetch(\n      this.baseHttpUrl + `/v1/datasets/datapoints?${params.toString()}`,\n      {\n        method: \"GET\",\n        headers: this.headers(),\n      },\n    );\n\n    if (!response.ok) {\n      await this.handleError(response);\n    }\n\n    return (await response.json()) as GetDatapointsResponse<D, T>;\n  }\n\n  private async retrySaveDatapoints<D, T, O>({\n    evalId,\n    datapoints,\n    groupName,\n    maxRetries = 25,\n    initialLength = INITIAL_EVALUATION_DATAPOINT_MAX_DATA_LENGTH,\n  }: {\n    evalId: string;\n    datapoints: EvaluationDatapoint<D, T, O>[];\n    groupName?: string;\n    maxRetries?: number;\n    initialLength?: number;\n  }): Promise<void> {\n    let length = initialLength;\n    let lastResponse: Response | null = null;\n    for (let i = 0; i < maxRetries; i++) {\n      logger.debug(`Retrying save datapoints... ${i + 1} of ${maxRetries}, length: ${length}`);\n      const response = await fetch(this.baseHttpUrl + `/v1/evals/${evalId}/datapoints`, {\n        method: \"POST\",\n        headers: this.headers(),\n        body: JSON.stringify({\n          points: datapoints.map((d) => (\n            {\n              ...d,\n              data: slicePayload(d.data, length),\n              target: slicePayload(d.target, length),\n              executorOutput: slicePayload(d.executorOutput, length),\n            })),\n          groupName: groupName ?? null,\n        }),\n      });\n      lastResponse = response;\n      length = Math.floor(length / 2);\n      if (response.status !== 413) {\n        break;\n      }\n    }\n    if (lastResponse && !lastResponse.ok) {\n      await this.handleError(lastResponse);\n    }\n  }\n}\n","import { type StringUUID } from \"@lmnr-ai/types\";\n\nimport { isStringUUID, otelSpanIdToUUID, otelTraceIdToUUID } from \"../utils\";\nimport { BaseResource, type LaminarAuth } from \".\";\n\nenum EvaluatorScoreSourceType {\n  Evaluator = \"Evaluator\",\n  Code = \"Code\",\n}\n\ninterface CreateEvaluatorScoreBase {\n  name: string;\n  metadata?: Record<string, any>;\n  score: number;\n  source: EvaluatorScoreSourceType;\n}\n\ninterface CreateEvaluatorScoreRequestWithTraceId extends CreateEvaluatorScoreBase {\n  traceId: string;\n}\n\ninterface CreateEvaluatorScoreRequestWithSpanId extends CreateEvaluatorScoreBase {\n  spanId: string;\n}\n\ntype ScoreOptions =\n  | { name: string; metadata?: Record<string, any>; score: number; traceId: string; }\n  | { name: string; metadata?: Record<string, any>; score: number; spanId: string; };\n\n/**\n * Resource for creating evaluator scores\n */\nexport class EvaluatorsResource extends BaseResource {\n  constructor(baseHttpUrl: string, auth: LaminarAuth) {\n    super(baseHttpUrl, auth);\n  }\n\n  /**\n   * Create a score for a span or trace\n   *\n   * @param {ScoreOptions} options - Score creation options\n   * @param {string} options.name - Name of the score\n   * @param {string} [options.traceId] - The trace ID to score (will be attached to top-level span)\n   * @param {string} [options.spanId] - The span ID to score\n   * @param {Record<string, any>} [options.metadata] - Additional metadata\n   * @param {number} options.score - The score value (float)\n   * @returns {Promise<void>}\n   *\n   * @example\n   * // Score by trace ID (will attach to root span)\n   * await evaluators.score({\n   *   name: \"quality\",\n   *   traceId: \"trace-id-here\",\n   *   score: 0.95,\n   *   metadata: { model: \"gpt-4\" }\n   * });\n   *\n   * @example\n   * // Score by span ID\n   * await evaluators.score({\n   *   name: \"relevance\",\n   *   spanId: \"span-id-here\",\n   *   score: 0.87\n   * });\n   */\n  public async score(options: ScoreOptions): Promise<void> {\n    const { name, metadata, score } = options;\n\n    let payload: CreateEvaluatorScoreRequestWithTraceId | CreateEvaluatorScoreRequestWithSpanId;\n\n    if ('traceId' in options && options.traceId) {\n      const formattedTraceId = isStringUUID(options.traceId)\n        ? options.traceId\n        : otelTraceIdToUUID(options.traceId);\n\n      payload = {\n        name,\n        metadata,\n        score,\n        source: EvaluatorScoreSourceType.Code,\n        traceId: formattedTraceId,\n      };\n    } else if ('spanId' in options && options.spanId) {\n      const formattedSpanId = isStringUUID(options.spanId)\n        ? options.spanId\n        : otelSpanIdToUUID(options.spanId) as StringUUID;\n\n      payload = {\n        name,\n        metadata,\n        score,\n        source: EvaluatorScoreSourceType.Code,\n        spanId: formattedSpanId,\n      };\n    } else {\n      throw new Error(\"Either 'traceId' or 'spanId' must be provided.\");\n    }\n\n    const response = await fetch(this.baseHttpUrl + \"/v1/evaluators/score\", {\n      method: \"POST\",\n      headers: this.headers(),\n      body: JSON.stringify(payload),\n    });\n\n    if (!response.ok) {\n      await this.handleError(response);\n    }\n  }\n}\n","import { type CachedSpan, errorMessage } from \"@lmnr-ai/types\";\n\nimport { initializeLogger } from \"../utils\";\nimport { BaseResource, type LaminarAuth } from \"./index\";\n\nconst logger = initializeLogger();\n\n/**\n * Result of a debug-replay cache lookup (debug-replay v2).\n *\n *  - `hit`  — the server served a cached response for this input hash; replay it\n *             and mark the span CACHED.\n *  - `miss` — no cache entry; the caller latches process-wide live mode and runs\n *             every subsequent call live.\n *  - `live` — run THIS call live without latching (server COLD warmup-timeout\n *             degrade, or any non-OK / transport error here).\n */\nexport type CacheOutcome =\n  | { kind: \"hit\"; cached: CachedSpan }\n  | { kind: \"miss\" }\n  | { kind: \"live\" };\n\n/**\n * Map the opaque HIT `response` payload onto a {@link CachedSpan} the provider\n * wrappers can replay. The server-side shape of `response` is not yet frozen\n * (app-server plan 01 leaves it as a `serde_json::Value`), so this stays\n * deliberately tolerant: the whole payload is serialized into `output` (the only\n * field the AI SDK wrapper's `parseCachedSpan` actually reads, via\n * `JSON.parse`), and a `finishReason` is surfaced into `attributes` when the\n * payload carries one. `name`/`input` are irrelevant to replay and left empty.\n */\nconst toCachedSpan = (response: unknown): CachedSpan => {\n  const output =\n    typeof response === \"string\" ? response : JSON.stringify(response ?? null);\n  const attributes: Record<string, any> = {};\n  if (\n    response !== null &&\n    typeof response === \"object\" &&\n    typeof (response as Record<string, unknown>).finishReason === \"string\"\n  ) {\n    attributes[\"ai.response.finishReason\"] = (\n      response as Record<string, unknown>\n    ).finishReason;\n  }\n  return { name: \"\", input: \"\", output, attributes };\n};\n\nexport class RolloutSessionsResource extends BaseResource {\n  constructor(baseHttpUrl: string, auth: LaminarAuth) {\n    super(baseHttpUrl, auth);\n  }\n\n  /**\n   * Idempotently register (upsert) a debug session on the backend, keyed on the\n   * SDK-supplied session id. The backend stores the row so the session is\n   * visible in the UI; a null/omitted name never clobbers a name set elsewhere.\n   *\n   * Returns the backend-resolved `projectId` (derived from the API key) so the\n   * caller can build the debugger URL; null if the body can't be parsed.\n   */\n  public async register({\n    sessionId,\n    name,\n  }: {\n    sessionId: string;\n    name?: string;\n  }): Promise<string | null> {\n    const response = await fetch(\n      `${this.baseHttpUrl}${this.apiPrefix}/rollouts/${sessionId}`,\n      {\n        method: \"POST\",\n        headers: this.headers(),\n        body: JSON.stringify({ name }),\n      },\n    );\n\n    if (!response.ok) {\n      await this.handleError(response);\n    }\n\n    try {\n      const body = (await response.json()) as { projectId?: string };\n      return body.projectId ?? null;\n    } catch (e) {\n      logger.warn(\n        `Failed to parse rollout register response: ${errorMessage(e)}`,\n      );\n      return null;\n    }\n  }\n\n  /**\n   * Rename an existing debug session. Update-only: the backend returns 404 (and\n   * this throws) when the session id is unknown for the project, so a mistyped\n   * id surfaces as an error rather than silently creating a session. Creation\n   * stays the SDK's job via {@link register}.\n   */\n  public async setName({\n    sessionId,\n    name,\n  }: {\n    sessionId: string;\n    name: string;\n  }): Promise<void> {\n    const response = await fetch(\n      `${this.baseHttpUrl}${this.apiPrefix}/rollouts/${sessionId}/name`,\n      {\n        method: \"PATCH\",\n        headers: this.headers(),\n        body: JSON.stringify({ name }),\n      },\n    );\n\n    if (!response.ok) {\n      await this.handleError(response);\n    }\n  }\n\n  /**\n   * Look up the debug-replay cache for a single LLM call (debug-replay v2).\n   *\n   * The server is keyed by `inputHash` (hex blake3 of the canonicalized,\n   * system-stripped input messages). It returns one of three outcomes:\n   *   - `{ outcome: \"hit\", response }` — a cached response to replay.\n   *   - `{ outcome: \"miss\" }`          — no entry; caller latches live mode.\n   *   - `{ outcome: \"live\" }`          — run this call live (COLD degrade).\n   *\n   * Error posture: a non-OK response or a transport error degrades to\n   * `{ kind: \"live\" }` for THIS call only — it never throws and never latches\n   * the process-wide live flag (only a real MISS does that). This keeps a flaky\n   * cache backend from turning a replay into a crash.\n   */\n  public async cache({\n    sessionId,\n    replayTraceId,\n    cacheUntil,\n    inputHash,\n  }: {\n    sessionId: string;\n    replayTraceId: string;\n    cacheUntil: string;\n    inputHash: string;\n  }): Promise<CacheOutcome> {\n    let response: Response;\n    try {\n      response = await fetch(\n        `${this.baseHttpUrl}${this.apiPrefix}/rollouts/${sessionId}/cache`,\n        {\n          method: \"POST\",\n          headers: this.headers(),\n          body: JSON.stringify({ replayTraceId, cacheUntil, inputHash }),\n        },\n      );\n    } catch (e) {\n      logger.warn(`Debug cache lookup failed, running live: ${errorMessage(e)}`);\n      return { kind: \"live\" };\n    }\n\n    if (!response.ok) {\n      logger.warn(\n        `Debug cache lookup returned ${response.status}, running live`,\n      );\n      return { kind: \"live\" };\n    }\n\n    let body: { outcome?: string; response?: unknown };\n    try {\n      body = (await response.json()) as { outcome?: string; response?: unknown };\n    } catch (e) {\n      logger.warn(\n        `Failed to parse debug cache response, running live: ${errorMessage(e)}`,\n      );\n      return { kind: \"live\" };\n    }\n\n    switch (body.outcome) {\n      case \"hit\":\n        // A HIT with no replayable payload (missing / JSON `null` response) is\n        // useless: serializing it would store the string \"null\", which parses\n        // back to `null` and crashes reconstruction. Degrade to live instead.\n        if (body.response === null || body.response === undefined) {\n          logger.warn(\"Debug cache HIT had no response payload, running live\");\n          return { kind: \"live\" };\n        }\n        return { kind: \"hit\", cached: toCachedSpan(body.response) };\n      case \"miss\":\n        return { kind: \"miss\" };\n      case \"live\":\n        return { kind: \"live\" };\n      default:\n        logger.warn(\n          `Unknown debug cache outcome \"${body.outcome}\", running live`,\n        );\n        return { kind: \"live\" };\n    }\n  }\n\n  public async delete({ sessionId }: { sessionId: string }): Promise<void> {\n    const response = await fetch(\n      `${this.baseHttpUrl}${this.apiPrefix}/rollouts/${sessionId}`,\n      {\n        method: \"DELETE\",\n        headers: this.headers(),\n      },\n    );\n\n    if (!response.ok) {\n      await this.handleError(response);\n    }\n  }\n}\n","import { BaseResource, type LaminarAuth } from \"./index\";\n\nexport class SqlResource extends BaseResource {\n  constructor(baseHttpUrl: string, auth: LaminarAuth) {\n    super(baseHttpUrl, auth);\n  }\n\n  public async query(\n    sql: string,\n    parameters: Record<string, any> = {},\n  ): Promise<Array<Record<string, any>>> {\n    const response = await fetch(`${this.baseHttpUrl}${this.apiPrefix}/sql/query`, {\n      method: \"POST\",\n      headers: {\n        ...this.headers(),\n      },\n      body: JSON.stringify({\n        query: sql,\n        parameters,\n      }),\n    });\n\n    if (!response.ok) {\n      await this.handleError(response);\n    }\n\n    return (await response.json()).data as Array<Record<string, any>>;\n  }\n}\n","/** Resource for tagging traces. */\n\n\nimport { isStringUUID, otelTraceIdToUUID } from \"../utils\";\nimport { BaseResource, type LaminarAuth } from \"./index\";\n\nexport class TagsResource extends BaseResource {\n  /** Resource for tagging traces. */\n  constructor(baseHttpUrl: string, auth: LaminarAuth) {\n    super(baseHttpUrl, auth);\n  }\n\n  /**\n   * Tag a trace with a list of tags. Note that the trace must be ended before\n   * tagging it. You may want to call `await Laminar.flush()` after the trace\n   * that you want to tag.\n   *\n   * @param {string | StringUUID} trace_id - The trace id to tag.\n   * @param {string[] | string} tags - The tag or list of tags to add to the trace.\n   * @returns {Promise<any>} The response from the server.\n   * @example\n   * ```javascript\n   * import { Laminar, observe, LaminarClient } from \"@lmnr-ai/lmnr\";\n   * Laminar.initialize();\n   * const client = new LaminarClient();\n   * let traceId: StringUUID | null = null;\n   * // Make sure this is called outside of traced context.\n   * await observe(\n   *   {\n   *     name: \"my-trace\",\n   *   },\n   *   async () => {\n   *     traceId = await Laminar.getTraceId();\n   *     await foo();\n   *   },\n   * );\n   *\n   * // or make sure the trace is ended by this point.\n   * await Laminar.flush();\n   * if (traceId) {\n   *   await client.tags.tag(traceId, [\"tag1\", \"tag2\"]);\n   * }\n   * ```\n   */\n  public async tag(\n    trace_id: string,\n    tags: string[] | string,\n  ): Promise<any> {\n    const traceTags = Array.isArray(tags) ? tags : [tags];\n    const formattedTraceId = isStringUUID(trace_id)\n      ? trace_id\n      : otelTraceIdToUUID(trace_id);\n\n    const url = this.baseHttpUrl + \"/v1/tag\";\n    const payload = {\n      \"traceId\": formattedTraceId,\n      \"names\": traceTags,\n    };\n    const response = await fetch(\n      url,\n      {\n        method: \"POST\",\n        headers: this.headers(),\n        body: JSON.stringify(payload),\n      },\n    );\n    if (!response.ok) {\n      await this.handleError(response);\n    }\n    return response.json();\n  }\n}\n","/** Resource for post-factum operations on existing traces. */\n\nimport { initializeLogger, isStringUUID, otelTraceIdToUUID } from \"../utils\";\nimport { BaseResource, type LaminarAuth } from \"./index\";\n\nconst logger = initializeLogger();\n\nexport class TracesResource extends BaseResource {\n  /** Resource for post-factum operations on existing traces. */\n  constructor(baseHttpUrl: string, auth: LaminarAuth) {\n    super(baseHttpUrl, auth);\n  }\n\n  /**\n   * Push a metadata patch to an existing trace.\n   *\n   * The patch is shallow-merged server-side into the trace's existing metadata\n   * (`existing || patch`, last-write-wins per top-level key). Useful for\n   * attaching post-factum signals — quality scores, human edits, triage labels —\n   * to a trace that has already finished. The patch does NOT extend `endTime`\n   * or change tokens / cost / top span / tags / span names. `numSpans` is\n   * incremented by 1 (paid by the virtual span that carried the patch through\n   * the ingestion queue) so the new ClickHouse row beats the prior version on\n   * `ReplacingMergeTree(numSpans)`. No row is added to the `spans` table.\n   *\n   * Compared to `Laminar.setTraceMetadata` (which sets metadata on the\n   * currently in-flight trace via OpenTelemetry attributes), this method\n   * operates on a finished trace by trace id, so it must be called after the\n   * trace has been flushed.\n   *\n   * A 404 response (the trace was not found in the project — typically because\n   * it has not been flushed yet) is logged as a warning and the call returns\n   * without throwing, since the 404 may be expected when pushing too soon\n   * after the trace run. Pass `failOnNotFound: true` to throw instead (e.g.\n   * CLI callers that must report the failure). Any other non-OK status throws.\n   *\n   * @param traceId - The trace id to push metadata to. Accepts a UUID string\n   *   or a 32-char OTel hex trace id.\n   * @param metadata - The metadata patch. Top-level keys are merged into the\n   *   trace's existing metadata. Must be non-empty (the server rejects empty\n   *   patches with 400).\n   * @param options - `failOnNotFound`: throw on 404 instead of warn-and-return.\n   * @example\n   * ```typescript\n   * import { Laminar, observe, LaminarClient } from \"@lmnr-ai/lmnr\";\n   * Laminar.initialize();\n   * const client = new LaminarClient();\n   *\n   * let traceId: string | null = null;\n   * await observe({ name: \"generate\" }, async () => {\n   *   traceId = await Laminar.getTraceId();\n   * });\n   * await Laminar.flush();\n   *\n   * if (traceId) {\n   *   await client.traces.pushMetadata(traceId, {\n   *     score: 0.85,\n   *     reviewer: \"alice\",\n   *     needsReview: false,\n   *   });\n   * }\n   * ```\n   */\n  public async pushMetadata(\n    traceId: string,\n    metadata: Record<string, unknown>,\n    options?: { failOnNotFound?: boolean },\n  ): Promise<void> {\n    if (!metadata || Object.keys(metadata).length === 0) {\n      throw new Error(\"metadata must be a non-empty object\");\n    }\n\n    const formattedTraceId = isStringUUID(traceId)\n      ? traceId\n      : otelTraceIdToUUID(traceId);\n\n    const url = this.baseHttpUrl + this.apiPrefix + \"/traces/metadata\";\n    const response = await fetch(url, {\n      method: \"POST\",\n      headers: this.headers(),\n      body: JSON.stringify({\n        traceId: formattedTraceId,\n        metadata,\n      }),\n    });\n\n    if (response.status === 404) {\n      const message =\n        `Trace ${formattedTraceId} not found. The trace may not have been ` +\n        \"flushed yet — call await Laminar.flush() and retry.\";\n      if (options?.failOnNotFound) {\n        throw new Error(message);\n      }\n      // Trace not found in this project — likely not flushed yet. Don't throw,\n      // but surface a warning so callers debugging an empty patch see it.\n      logger.warn(message);\n      return;\n    }\n\n    if (!response.ok) {\n      await this.handleError(response);\n    }\n  }\n}\n","import { BrowserEventsResource } from \"./resources/browser-events\";\nimport { CliResource } from \"./resources/cli\";\nimport { DatasetsResource } from \"./resources/datasets\";\nimport { EvalsResource } from \"./resources/evals\";\nimport { EvaluatorsResource } from \"./resources/evaluators\";\nimport { type LaminarAuth } from \"./resources/index\";\nimport { RolloutSessionsResource } from \"./resources/rollout-sessions\";\nimport { SqlResource } from \"./resources/sql\";\nimport { TagsResource } from \"./resources/tags\";\nimport { TracesResource } from \"./resources/traces\";\nimport { loadEnv } from \"./utils\";\n\nexport class LaminarClient {\n  private baseUrl: string;\n  private auth: LaminarAuth;\n  private _browserEvents: BrowserEventsResource;\n  private _cli: CliResource;\n  private _datasets: DatasetsResource;\n  private _evals: EvalsResource;\n  private _evaluators: EvaluatorsResource;\n  private _rolloutSessions: RolloutSessionsResource;\n  private _sql: SqlResource;\n  private _tags: TagsResource;\n  private _traces: TracesResource;\n\n  constructor({\n    baseUrl,\n    port,\n    auth,\n    projectApiKey,\n    cliUserProjectId,\n  }: {\n    baseUrl?: string,\n    port?: number,\n    /**\n     * Unified auth. A discriminated union that drives both the URL prefix and\n     * the request headers:\n     *  - `{ type: \"apiKey\", key }`               → project key, `/v1/*`.\n     *  - `{ type: \"userToken\", token, projectId }` → user JWT, `/v1/cli/*` with\n     *    `x-lmnr-project-id`.\n     * When omitted, the legacy `projectApiKey` / `cliUserProjectId` fields (or\n     * `LMNR_PROJECT_API_KEY`) are normalized into this union.\n     */\n    auth?: LaminarAuth,\n    /**\n     * @deprecated Pass `auth: { type: \"apiKey\", key }` instead. Kept for\n     * backward compatibility — normalized into the unified `auth` union.\n     */\n    projectApiKey?: string,\n    /**\n     * @deprecated Pass `auth: { type: \"userToken\", token, projectId }` instead.\n     * Kept for backward compatibility: when set, the legacy `projectApiKey` is\n     * treated as a user JWT and routes to `/v1/cli/*` with this project id.\n     */\n    cliUserProjectId?: string,\n  } = {}) {\n    loadEnv();\n    this.auth = LaminarClient.normalizeAuth(auth, projectApiKey, cliUserProjectId);\n    const httpPort = port ?? (\n      baseUrl?.match(/:\\d{1,5}$/g)\n        ? parseInt(baseUrl.match(/:\\d{1,5}$/g)![0].slice(1))\n        : 443);\n    const baseUrlNoPort = (baseUrl ?? process.env.LMNR_BASE_URL)\n      ?.replace(/\\/$/, '').replace(/:\\d{1,5}$/g, '');\n    this.baseUrl = `${baseUrlNoPort ?? 'https://api.lmnr.ai'}:${httpPort}`;\n    this._browserEvents = new BrowserEventsResource(this.baseUrl, this.auth);\n    this._cli = new CliResource(this.baseUrl, this.auth);\n    this._datasets = new DatasetsResource(this.baseUrl, this.auth);\n    this._evals = new EvalsResource(this.baseUrl, this.auth);\n    this._evaluators = new EvaluatorsResource(this.baseUrl, this.auth);\n    this._rolloutSessions = new RolloutSessionsResource(this.baseUrl, this.auth);\n    this._sql = new SqlResource(this.baseUrl, this.auth);\n    this._tags = new TagsResource(this.baseUrl, this.auth);\n    this._traces = new TracesResource(this.baseUrl, this.auth);\n  }\n\n  /**\n   * Normalize the constructor's auth inputs into a {@link LaminarAuth} union.\n   * Precedence: an explicit `auth` wins; otherwise the legacy\n   * `projectApiKey` (+ optional `cliUserProjectId`) is mapped — a present\n   * `cliUserProjectId` selects the user-token surface, otherwise the project\n   * key surface. Falls back to `LMNR_PROJECT_API_KEY` as a project key.\n   */\n  private static normalizeAuth(\n    auth: LaminarAuth | undefined,\n    projectApiKey: string | undefined,\n    cliUserProjectId: string | undefined,\n  ): LaminarAuth {\n    if (auth) {\n      return auth;\n    }\n    const key = projectApiKey ?? process.env.LMNR_PROJECT_API_KEY!;\n    if (cliUserProjectId) {\n      return { type: \"userToken\", token: key, projectId: cliUserProjectId };\n    }\n    return { type: \"apiKey\", key };\n  }\n\n  public get browserEvents() {\n    return this._browserEvents;\n  }\n\n  public get cli() {\n    return this._cli;\n  }\n\n  public get datasets() {\n    return this._datasets;\n  }\n\n  public get evals() {\n    return this._evals;\n  }\n\n  public get evaluators() {\n    return this._evaluators;\n  }\n\n  public get rolloutSessions() {\n    return this._rolloutSessions;\n  }\n\n  public get sql() {\n    return this._sql;\n  }\n\n  public get tags() {\n    return this._tags;\n  }\n\n  public get traces() {\n    return this._traces;\n  }\n}\n\nexport type { CliProject } from \"./resources/cli\";\nexport type { LaminarAuth } from \"./resources/index\";\nexport {\n  type CacheOutcome,\n  RolloutSessionsResource,\n} from \"./resources/rollout-sessions\";\n"],"mappings":"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"}