npm - @lmnr-ai/client - Versions diffs - 0.8.24 → 0.8.26 - Mend

@lmnr-ai/client 0.8.24 → 0.8.26

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (7) hide show

package/dist/index.cjs CHANGED Viewed

@@ -29,7 +29,7 @@ pino = __toESM(pino);
 let pino_pretty = require("pino-pretty");
 let uuid = require("uuid");
 //#region package.json
-var version = "0.8.24";
+var version = "0.8.26";
 //#endregion
 //#region src/version.ts
 function getLangVersion() {
@@ -94,7 +94,7 @@ function initializeLogger(options) {
 		minimumLevel: level
 	}));
 }
-const logger$2 = initializeLogger();
+const logger$3 = initializeLogger();
 const isStringUUID = (id) => /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/.test(id);
 const newUUID = () => {
 	if (typeof crypto !== "undefined" && typeof crypto.randomUUID === "function") return crypto.randomUUID();
@@ -103,9 +103,9 @@ const newUUID = () => {
 const otelSpanIdToUUID = (spanId) => {
 	let id = spanId.toLowerCase();
 	if (id.startsWith("0x")) id = id.slice(2);
-	if (id.length !== 16) logger$2.warn(`Span ID ${spanId} is not 16 hex chars long. This is not a valid OpenTelemetry span ID.`);
+	if (id.length !== 16) logger$3.warn(`Span ID ${spanId} is not 16 hex chars long. This is not a valid OpenTelemetry span ID.`);
 	if (!/^[0-9a-f]+$/.test(id)) {
-		logger$2.error(`Span ID ${spanId} is not a valid hex string. Generating a random UUID instead.`);
+		logger$3.error(`Span ID ${spanId} is not a valid hex string. Generating a random UUID instead.`);
 		return newUUID();
 	}
 	return id.padStart(32, "0").replace(/^([0-9a-f]{8})([0-9a-f]{4})([0-9a-f]{4})([0-9a-f]{4})([0-9a-f]{12})$/, "$1-$2-$3-$4-$5");
@@ -113,9 +113,9 @@ const otelSpanIdToUUID = (spanId) => {
 const otelTraceIdToUUID = (traceId) => {
 	let id = traceId.toLowerCase();
 	if (id.startsWith("0x")) id = id.slice(2);
-	if (id.length !== 32) logger$2.warn(`Trace ID ${traceId} is not 32 hex chars long. This is not a valid OpenTelemetry trace ID.`);
+	if (id.length !== 32) logger$3.warn(`Trace ID ${traceId} is not 32 hex chars long. This is not a valid OpenTelemetry trace ID.`);
 	if (!/^[0-9a-f]+$/.test(id)) {
-		logger$2.error(`Trace ID ${traceId} is not a valid hex string. Generating a random UUID instead.`);
+		logger$3.error(`Trace ID ${traceId} is not a valid hex string. Generating a random UUID instead.`);
 		return newUUID();
 	}
 	return id.replace(/^([0-9a-f]{8})([0-9a-f]{4})([0-9a-f]{4})([0-9a-f]{4})([0-9a-f]{12})$/, "$1-$2-$3-$4-$5");
@@ -145,7 +145,7 @@ const loadEnv = (options) => {
 };
 //#endregion
 //#region src/resources/datasets.ts
-const logger$1 = initializeLogger();
+const logger$2 = initializeLogger();
 const DEFAULT_DATASET_PULL_LIMIT = 100;
 const DEFAULT_DATASET_PUSH_BATCH_SIZE = 100;
 var DatasetsResource = class extends BaseResource {
@@ -200,7 +200,7 @@ var DatasetsResource = class extends BaseResource {
 		let response;
 		for (let i = 0; i < points.length; i += batchSize) {
 			const batchNum = Math.floor(i / batchSize) + 1;
-			logger$1.debug(`Pushing batch ${batchNum} of ${totalBatches}`);
+			logger$2.debug(`Pushing batch ${batchNum} of ${totalBatches}`);
 			const batch = points.slice(i, i + batchSize);
 			const fetchResponse = await fetch(this.baseHttpUrl + "/v1/datasets/datapoints", {
 				method: "POST",
@@ -250,7 +250,7 @@ var DatasetsResource = class extends BaseResource {
 };
 //#endregion
 //#region src/resources/evals.ts
-const logger = initializeLogger();
+const logger$1 = initializeLogger();
 const INITIAL_EVALUATION_DATAPOINT_MAX_DATA_LENGTH = 16e6;
 var EvalsResource = class extends BaseResource {
 	constructor(baseHttpUrl, projectApiKey) {
@@ -386,7 +386,7 @@ var EvalsResource = class extends BaseResource {
 	* @returns {Promise<GetDatapointsResponse>} Response from the datapoint retrieval
 	*/
 	async getDatapoints({ datasetName, offset, limit }) {
-		logger.warn("evals.getDatapoints() is deprecated. Use client.datasets.pull() instead.");
+		logger$1.warn("evals.getDatapoints() is deprecated. Use client.datasets.pull() instead.");
 		const params = new URLSearchParams({
 			name: datasetName,
 			offset: offset.toString(),
@@ -403,7 +403,7 @@ var EvalsResource = class extends BaseResource {
 		let length = initialLength;
 		let lastResponse = null;
 		for (let i = 0; i < maxRetries; i++) {
-			logger.debug(`Retrying save datapoints... ${i + 1} of ${maxRetries}, length: ${length}`);
+			logger$1.debug(`Retrying save datapoints... ${i + 1} of ${maxRetries}, length: ${length}`);
 			const response = await fetch(this.baseHttpUrl + `/v1/evals/${evalId}/datapoints`, {
 				method: "POST",
 				headers: this.headers(),
@@ -426,11 +426,6 @@ var EvalsResource = class extends BaseResource {
 };
 //#endregion
 //#region src/resources/evaluators.ts
-var EvaluatorScoreSourceType = /* @__PURE__ */ function(EvaluatorScoreSourceType) {
-	EvaluatorScoreSourceType["Evaluator"] = "Evaluator";
-	EvaluatorScoreSourceType["Code"] = "Code";
-	return EvaluatorScoreSourceType;
-}(EvaluatorScoreSourceType || {});
 /**
 * Resource for creating evaluator scores
 */
@@ -469,25 +464,21 @@ var EvaluatorsResource = class extends BaseResource {
 	async score(options) {
 		const { name, metadata, score } = options;
 		let payload;
-		if ("traceId" in options && options.traceId) {
-			const formattedTraceId = isStringUUID(options.traceId) ? options.traceId : otelTraceIdToUUID(options.traceId);
-			payload = {
-				name,
-				metadata,
-				score,
-				source: EvaluatorScoreSourceType.Code,
-				traceId: formattedTraceId
-			};
-		} else if ("spanId" in options && options.spanId) {
-			const formattedSpanId = isStringUUID(options.spanId) ? options.spanId : otelSpanIdToUUID(options.spanId);
-			payload = {
-				name,
-				metadata,
-				score,
-				source: EvaluatorScoreSourceType.Code,
-				spanId: formattedSpanId
-			};
-		} else throw new Error("Either 'traceId' or 'spanId' must be provided.");
+		if ("traceId" in options && options.traceId) payload = {
+			name,
+			metadata,
+			score,
+			source: "Code",
+			traceId: isStringUUID(options.traceId) ? options.traceId : otelTraceIdToUUID(options.traceId)
+		};
+		else if ("spanId" in options && options.spanId) payload = {
+			name,
+			metadata,
+			score,
+			source: "Code",
+			spanId: isStringUUID(options.spanId) ? options.spanId : otelSpanIdToUUID(options.spanId)
+		};
+		else throw new Error("Either 'traceId' or 'spanId' must be provided.");
 		const response = await fetch(this.baseHttpUrl + "/v1/evaluators/score", {
 			method: "POST",
 			headers: this.headers(),
@@ -633,13 +624,89 @@ var TagsResource = class extends BaseResource {
 	}
 };
 //#endregion
+//#region src/resources/traces.ts
+/** Resource for post-factum operations on existing traces. */
+const logger = initializeLogger();
+var TracesResource = class extends BaseResource {
+	/** Resource for post-factum operations on existing traces. */
+	constructor(baseHttpUrl, projectApiKey) {
+		super(baseHttpUrl, projectApiKey);
+	}
+	/**
+	* Push a metadata patch to an existing trace.
+	*
+	* The patch is shallow-merged server-side into the trace's existing metadata
+	* (`existing || patch`, last-write-wins per top-level key). Useful for
+	* attaching post-factum signals — quality scores, human edits, triage labels —
+	* to a trace that has already finished. The patch does NOT extend `endTime`
+	* or change tokens / cost / top span / tags / span names. `numSpans` is
+	* incremented by 1 (paid by the virtual span that carried the patch through
+	* the ingestion queue) so the new ClickHouse row beats the prior version on
+	* `ReplacingMergeTree(numSpans)`. No row is added to the `spans` table.
+	*
+	* Compared to `Laminar.setTraceMetadata` (which sets metadata on the
+	* currently in-flight trace via OpenTelemetry attributes), this method
+	* operates on a finished trace by trace id, so it must be called after the
+	* trace has been flushed.
+	*
+	* A 404 response (the trace was not found in the project — typically because
+	* it has not been flushed yet) is logged as a warning and the call returns
+	* without throwing; any other non-OK status throws.
+	*
+	* @param traceId - The trace id to push metadata to. Accepts a UUID string
+	*   or a 32-char OTel hex trace id.
+	* @param metadata - The metadata patch. Top-level keys are merged into the
+	*   trace's existing metadata. Must be non-empty (the server rejects empty
+	*   patches with 400).
+	* @example
+	* ```typescript
+	* import { Laminar, observe, LaminarClient } from "@lmnr-ai/lmnr";
+	* Laminar.initialize();
+	* const client = new LaminarClient();
+	*
+	* let traceId: string | null = null;
+	* await observe({ name: "generate" }, async () => {
+	*   traceId = await Laminar.getTraceId();
+	* });
+	* await Laminar.flush();
+	*
+	* if (traceId) {
+	*   await client.traces.pushMetadata(traceId, {
+	*     score: 0.85,
+	*     reviewer: "alice",
+	*     needsReview: false,
+	*   });
+	* }
+	* ```
+	*/
+	async pushMetadata(traceId, metadata) {
+		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 response = await fetch(url, {
+			method: "POST",
+			headers: this.headers(),
+			body: JSON.stringify({
+				traceId: formattedTraceId,
+				metadata
+			})
+		});
+		if (response.status === 404) {
+			logger.warn(`Trace ${formattedTraceId} not found. The trace may not have been flushed yet — call await Laminar.flush() and retry.`);
+			return;
+		}
+		if (!response.ok) await this.handleError(response);
+	}
+};
+//#endregion
 //#region src/index.ts
 var LaminarClient = class {
 	constructor({ baseUrl, projectApiKey, port } = {}) {
 		loadEnv();
 		this.projectApiKey = projectApiKey ?? process.env.LMNR_PROJECT_API_KEY;
 		const httpPort = port ?? (baseUrl?.match(/:\d{1,5}$/g) ? parseInt(baseUrl.match(/:\d{1,5}$/g)[0].slice(1)) : 443);
-		this.baseUrl = `${(baseUrl ?? process.env.LMNR_BASE_URL)?.replace(/\/$/, "").replace(/:\d{1,5}$/g, "") ?? "https://api.lmnr.ai"}:${httpPort}`;
+		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);
@@ -647,6 +714,7 @@ var LaminarClient = class {
 		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);
 	}
 	get browserEvents() {
 		return this._browserEvents;
@@ -669,6 +737,9 @@ var LaminarClient = class {
 	get tags() {
 		return this._tags;
 	}
+	get traces() {
+		return this._traces;
+	}
 };
 //#endregion
 exports.LaminarClient = LaminarClient;

package/dist/index.cjs.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"index.cjs","names":["SDK_VERSION","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/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 RolloutParam, type SpanType } from \"@lmnr-ai/types\";\n\nimport { otelSpanIdToUUID, otelTraceIdToUUID } from \"../utils\";\nimport { BaseResource } from \"./index\";\n\nexport class RolloutSessionsResource extends BaseResource {\n constructor(baseHttpUrl: string, projectApiKey: string) {\n super(baseHttpUrl, projectApiKey);\n }\n\n /\n Connects to the SSE stream for rollout debugging sessions\n * Returns the Response object for streaming SSE events\n /\n public async connect({\n sessionId,\n name,\n params,\n signal,\n }: {\n sessionId: string;\n params: RolloutParam[];\n name: string;\n signal?: AbortSignal;\n }): Promise<Response> {\n const response = await fetch(`${this.baseHttpUrl}/v1/rollouts/${sessionId}`, {\n method: \"POST\",\n headers: {\n ...this.headers(),\n 'Accept': 'text/event-stream',\n },\n body: JSON.stringify({ name, params }),\n signal,\n });\n\n if (!response.ok) {\n throw new Error(`SSE connection failed: ${response.status} ${response.statusText}`);\n }\n\n if (!response.body) {\n throw new Error('No response body');\n }\n\n return response;\n }\n\n public async delete({\n sessionId,\n }: {\n sessionId: string;\n }) {\n const response = await fetch(`${this.baseHttpUrl}/v1/rollouts/${sessionId}`, {\n method: \"DELETE\",\n headers: this.headers(),\n });\n\n if (!response.ok) {\n await this.handleError(response);\n }\n }\n\n public async setStatus({\n sessionId,\n status,\n }: {\n sessionId: string;\n status: 'PENDING' \| 'RUNNING' \| 'FINISHED' \| 'STOPPED';\n }) {\n const response = await fetch(`${this.baseHttpUrl}/v1/rollouts/${sessionId}/status`, {\n method: \"PATCH\",\n headers: this.headers(),\n body: JSON.stringify({ status }),\n });\n\n if (!response.ok) {\n await this.handleError(response);\n }\n }\n\n public async sendSpanUpdate({\n sessionId,\n span,\n }: {\n sessionId: string;\n span: {\n name: string;\n startTime: string;\n spanId: string;\n traceId: string;\n parentSpanId: string \| undefined;\n attributes: Record<string, any>;\n spanType: SpanType;\n };\n }) {\n const response = await fetch(`${this.baseHttpUrl}/v1/rollouts/${sessionId}/update`, {\n method: \"PATCH\",\n headers: this.headers(),\n body: JSON.stringify({\n type: \"spanStart\",\n spanId: otelSpanIdToUUID(span.spanId),\n traceId: otelTraceIdToUUID(span.traceId),\n parentSpanId: span.parentSpanId ? otelSpanIdToUUID(span.parentSpanId) : undefined,\n attributes: span.attributes,\n startTime: span.startTime,\n name: span.name,\n spanType: span.spanType,\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","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 { 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\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 }\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"],"mappings":"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"}
1	+ {"version":3,"file":"index.cjs","names":["SDK_VERSION","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 RolloutParam, type SpanType } from \"@lmnr-ai/types\";\n\nimport { otelSpanIdToUUID, otelTraceIdToUUID } from \"../utils\";\nimport { BaseResource } from \"./index\";\n\nexport class RolloutSessionsResource extends BaseResource {\n constructor(baseHttpUrl: string, projectApiKey: string) {\n super(baseHttpUrl, projectApiKey);\n }\n\n /\n Connects to the SSE stream for rollout debugging sessions\n * Returns the Response object for streaming SSE events\n /\n public async connect({\n sessionId,\n name,\n params,\n signal,\n }: {\n sessionId: string;\n params: RolloutParam[];\n name: string;\n signal?: AbortSignal;\n }): Promise<Response> {\n const response = await fetch(`${this.baseHttpUrl}/v1/rollouts/${sessionId}`, {\n method: \"POST\",\n headers: {\n ...this.headers(),\n 'Accept': 'text/event-stream',\n },\n body: JSON.stringify({ name, params }),\n signal,\n });\n\n if (!response.ok) {\n throw new Error(`SSE connection failed: ${response.status} ${response.statusText}`);\n }\n\n if (!response.body) {\n throw new Error('No response body');\n }\n\n return response;\n }\n\n public async delete({\n sessionId,\n }: {\n sessionId: string;\n }) {\n const response = await fetch(`${this.baseHttpUrl}/v1/rollouts/${sessionId}`, {\n method: \"DELETE\",\n headers: this.headers(),\n });\n\n if (!response.ok) {\n await this.handleError(response);\n }\n }\n\n public async setStatus({\n sessionId,\n status,\n }: {\n sessionId: string;\n status: 'PENDING' \| 'RUNNING' \| 'FINISHED' \| 'STOPPED';\n }) {\n const response = await fetch(`${this.baseHttpUrl}/v1/rollouts/${sessionId}/status`, {\n method: \"PATCH\",\n headers: this.headers(),\n body: JSON.stringify({ status }),\n });\n\n if (!response.ok) {\n await this.handleError(response);\n }\n }\n\n public async sendSpanUpdate({\n sessionId,\n span,\n }: {\n sessionId: string;\n span: {\n name: string;\n startTime: string;\n spanId: string;\n traceId: string;\n parentSpanId: string \| undefined;\n attributes: Record<string, any>;\n spanType: SpanType;\n };\n }) {\n const response = await fetch(`${this.baseHttpUrl}/v1/rollouts/${sessionId}/update`, {\n method: \"PATCH\",\n headers: this.headers(),\n body: JSON.stringify({\n type: \"spanStart\",\n spanId: otelSpanIdToUUID(span.spanId),\n traceId: otelTraceIdToUUID(span.traceId),\n parentSpanId: span.parentSpanId ? otelSpanIdToUUID(span.parentSpanId) : undefined,\n attributes: span.attributes,\n startTime: span.startTime,\n name: span.name,\n spanType: span.spanType,\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; 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 * @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 ): 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 // 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(\n `Trace ${formattedTraceId} not found. The trace may not have been ` +\n \"flushed yet — call await Laminar.flush() and retry.\",\n );\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"],"mappings":"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"}

package/dist/index.d.cts CHANGED Viewed

@@ -348,6 +348,60 @@ declare class TagsResource extends BaseResource {
   tag(trace_id: string, tags: string[] | string): Promise<any>;
 }
 //#endregion
+//#region src/resources/traces.d.ts
+declare class TracesResource extends BaseResource {
+  /** Resource for post-factum operations on existing traces. */
+  constructor(baseHttpUrl: string, projectApiKey: string);
+  /**
+   * Push a metadata patch to an existing trace.
+   *
+   * The patch is shallow-merged server-side into the trace's existing metadata
+   * (`existing || patch`, last-write-wins per top-level key). Useful for
+   * attaching post-factum signals — quality scores, human edits, triage labels —
+   * to a trace that has already finished. The patch does NOT extend `endTime`
+   * or change tokens / cost / top span / tags / span names. `numSpans` is
+   * incremented by 1 (paid by the virtual span that carried the patch through
+   * the ingestion queue) so the new ClickHouse row beats the prior version on
+   * `ReplacingMergeTree(numSpans)`. No row is added to the `spans` table.
+   *
+   * Compared to `Laminar.setTraceMetadata` (which sets metadata on the
+   * currently in-flight trace via OpenTelemetry attributes), this method
+   * operates on a finished trace by trace id, so it must be called after the
+   * trace has been flushed.
+   *
+   * A 404 response (the trace was not found in the project — typically because
+   * it has not been flushed yet) is logged as a warning and the call returns
+   * without throwing; any other non-OK status throws.
+   *
+   * @param traceId - The trace id to push metadata to. Accepts a UUID string
+   *   or a 32-char OTel hex trace id.
+   * @param metadata - The metadata patch. Top-level keys are merged into the
+   *   trace's existing metadata. Must be non-empty (the server rejects empty
+   *   patches with 400).
+   * @example
+   * ```typescript
+   * import { Laminar, observe, LaminarClient } from "@lmnr-ai/lmnr";
+   * Laminar.initialize();
+   * const client = new LaminarClient();
+   *
+   * let traceId: string | null = null;
+   * await observe({ name: "generate" }, async () => {
+   *   traceId = await Laminar.getTraceId();
+   * });
+   * await Laminar.flush();
+   *
+   * if (traceId) {
+   *   await client.traces.pushMetadata(traceId, {
+   *     score: 0.85,
+   *     reviewer: "alice",
+   *     needsReview: false,
+   *   });
+   * }
+   * ```
+   */
+  pushMetadata(traceId: string, metadata: Record<string, unknown>): Promise<void>;
+}
+//#endregion
 //#region src/index.d.ts
 declare class LaminarClient {
   private baseUrl;
@@ -359,6 +413,7 @@ declare class LaminarClient {
   private _rolloutSessions;
   private _sql;
   private _tags;
+  private _traces;
   constructor({
     baseUrl,
     projectApiKey,
@@ -375,6 +430,7 @@ declare class LaminarClient {
   get rolloutSessions(): RolloutSessionsResource;
   get sql(): SqlResource;
   get tags(): TagsResource;
+  get traces(): TracesResource;
 }
 //#endregion
 export { LaminarClient };

package/dist/index.d.mts CHANGED Viewed

@@ -348,6 +348,60 @@ declare class TagsResource extends BaseResource {
   tag(trace_id: string, tags: string[] | string): Promise<any>;
 }
 //#endregion
+//#region src/resources/traces.d.ts
+declare class TracesResource extends BaseResource {
+  /** Resource for post-factum operations on existing traces. */
+  constructor(baseHttpUrl: string, projectApiKey: string);
+  /**
+   * Push a metadata patch to an existing trace.
+   *
+   * The patch is shallow-merged server-side into the trace's existing metadata
+   * (`existing || patch`, last-write-wins per top-level key). Useful for
+   * attaching post-factum signals — quality scores, human edits, triage labels —
+   * to a trace that has already finished. The patch does NOT extend `endTime`
+   * or change tokens / cost / top span / tags / span names. `numSpans` is
+   * incremented by 1 (paid by the virtual span that carried the patch through
+   * the ingestion queue) so the new ClickHouse row beats the prior version on
+   * `ReplacingMergeTree(numSpans)`. No row is added to the `spans` table.
+   *
+   * Compared to `Laminar.setTraceMetadata` (which sets metadata on the
+   * currently in-flight trace via OpenTelemetry attributes), this method
+   * operates on a finished trace by trace id, so it must be called after the
+   * trace has been flushed.
+   *
+   * A 404 response (the trace was not found in the project — typically because
+   * it has not been flushed yet) is logged as a warning and the call returns
+   * without throwing; any other non-OK status throws.
+   *
+   * @param traceId - The trace id to push metadata to. Accepts a UUID string
+   *   or a 32-char OTel hex trace id.
+   * @param metadata - The metadata patch. Top-level keys are merged into the
+   *   trace's existing metadata. Must be non-empty (the server rejects empty
+   *   patches with 400).
+   * @example
+   * ```typescript
+   * import { Laminar, observe, LaminarClient } from "@lmnr-ai/lmnr";
+   * Laminar.initialize();
+   * const client = new LaminarClient();
+   *
+   * let traceId: string | null = null;
+   * await observe({ name: "generate" }, async () => {
+   *   traceId = await Laminar.getTraceId();
+   * });
+   * await Laminar.flush();
+   *
+   * if (traceId) {
+   *   await client.traces.pushMetadata(traceId, {
+   *     score: 0.85,
+   *     reviewer: "alice",
+   *     needsReview: false,
+   *   });
+   * }
+   * ```
+   */
+  pushMetadata(traceId: string, metadata: Record<string, unknown>): Promise<void>;
+}
+//#endregion
 //#region src/index.d.ts
 declare class LaminarClient {
   private baseUrl;
@@ -359,6 +413,7 @@ declare class LaminarClient {
   private _rolloutSessions;
   private _sql;
   private _tags;
+  private _traces;
   constructor({
     baseUrl,
     projectApiKey,
@@ -375,6 +430,7 @@ declare class LaminarClient {
   get rolloutSessions(): RolloutSessionsResource;
   get sql(): SqlResource;
   get tags(): TagsResource;
+  get traces(): TracesResource;
 }
 //#endregion
 export { LaminarClient };

package/dist/index.mjs CHANGED Viewed

@@ -4,7 +4,7 @@ import pino from "pino";
 import { PinoPretty } from "pino-pretty";
 import { v4 } from "uuid";
 //#region package.json
-var version = "0.8.24";
+var version = "0.8.26";
 //#endregion
 //#region src/version.ts
 function getLangVersion() {
@@ -69,7 +69,7 @@ function initializeLogger(options) {
 		minimumLevel: level
 	}));
 }
-const logger$2 = initializeLogger();
+const logger$3 = initializeLogger();
 const isStringUUID = (id) => /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/.test(id);
 const newUUID = () => {
 	if (typeof crypto !== "undefined" && typeof crypto.randomUUID === "function") return crypto.randomUUID();
@@ -78,9 +78,9 @@ const newUUID = () => {
 const otelSpanIdToUUID = (spanId) => {
 	let id = spanId.toLowerCase();
 	if (id.startsWith("0x")) id = id.slice(2);
-	if (id.length !== 16) logger$2.warn(`Span ID ${spanId} is not 16 hex chars long. This is not a valid OpenTelemetry span ID.`);
+	if (id.length !== 16) logger$3.warn(`Span ID ${spanId} is not 16 hex chars long. This is not a valid OpenTelemetry span ID.`);
 	if (!/^[0-9a-f]+$/.test(id)) {
-		logger$2.error(`Span ID ${spanId} is not a valid hex string. Generating a random UUID instead.`);
+		logger$3.error(`Span ID ${spanId} is not a valid hex string. Generating a random UUID instead.`);
 		return newUUID();
 	}
 	return id.padStart(32, "0").replace(/^([0-9a-f]{8})([0-9a-f]{4})([0-9a-f]{4})([0-9a-f]{4})([0-9a-f]{12})$/, "$1-$2-$3-$4-$5");
@@ -88,9 +88,9 @@ const otelSpanIdToUUID = (spanId) => {
 const otelTraceIdToUUID = (traceId) => {
 	let id = traceId.toLowerCase();
 	if (id.startsWith("0x")) id = id.slice(2);
-	if (id.length !== 32) logger$2.warn(`Trace ID ${traceId} is not 32 hex chars long. This is not a valid OpenTelemetry trace ID.`);
+	if (id.length !== 32) logger$3.warn(`Trace ID ${traceId} is not 32 hex chars long. This is not a valid OpenTelemetry trace ID.`);
 	if (!/^[0-9a-f]+$/.test(id)) {
-		logger$2.error(`Trace ID ${traceId} is not a valid hex string. Generating a random UUID instead.`);
+		logger$3.error(`Trace ID ${traceId} is not a valid hex string. Generating a random UUID instead.`);
 		return newUUID();
 	}
 	return id.replace(/^([0-9a-f]{8})([0-9a-f]{4})([0-9a-f]{4})([0-9a-f]{4})([0-9a-f]{12})$/, "$1-$2-$3-$4-$5");
@@ -120,7 +120,7 @@ const loadEnv = (options) => {
 };
 //#endregion
 //#region src/resources/datasets.ts
-const logger$1 = initializeLogger();
+const logger$2 = initializeLogger();
 const DEFAULT_DATASET_PULL_LIMIT = 100;
 const DEFAULT_DATASET_PUSH_BATCH_SIZE = 100;
 var DatasetsResource = class extends BaseResource {
@@ -175,7 +175,7 @@ var DatasetsResource = class extends BaseResource {
 		let response;
 		for (let i = 0; i < points.length; i += batchSize) {
 			const batchNum = Math.floor(i / batchSize) + 1;
-			logger$1.debug(`Pushing batch ${batchNum} of ${totalBatches}`);
+			logger$2.debug(`Pushing batch ${batchNum} of ${totalBatches}`);
 			const batch = points.slice(i, i + batchSize);
 			const fetchResponse = await fetch(this.baseHttpUrl + "/v1/datasets/datapoints", {
 				method: "POST",
@@ -225,7 +225,7 @@ var DatasetsResource = class extends BaseResource {
 };
 //#endregion
 //#region src/resources/evals.ts
-const logger = initializeLogger();
+const logger$1 = initializeLogger();
 const INITIAL_EVALUATION_DATAPOINT_MAX_DATA_LENGTH = 16e6;
 var EvalsResource = class extends BaseResource {
 	constructor(baseHttpUrl, projectApiKey) {
@@ -361,7 +361,7 @@ var EvalsResource = class extends BaseResource {
 	* @returns {Promise<GetDatapointsResponse>} Response from the datapoint retrieval
 	*/
 	async getDatapoints({ datasetName, offset, limit }) {
-		logger.warn("evals.getDatapoints() is deprecated. Use client.datasets.pull() instead.");
+		logger$1.warn("evals.getDatapoints() is deprecated. Use client.datasets.pull() instead.");
 		const params = new URLSearchParams({
 			name: datasetName,
 			offset: offset.toString(),
@@ -378,7 +378,7 @@ var EvalsResource = class extends BaseResource {
 		let length = initialLength;
 		let lastResponse = null;
 		for (let i = 0; i < maxRetries; i++) {
-			logger.debug(`Retrying save datapoints... ${i + 1} of ${maxRetries}, length: ${length}`);
+			logger$1.debug(`Retrying save datapoints... ${i + 1} of ${maxRetries}, length: ${length}`);
 			const response = await fetch(this.baseHttpUrl + `/v1/evals/${evalId}/datapoints`, {
 				method: "POST",
 				headers: this.headers(),
@@ -401,11 +401,6 @@ var EvalsResource = class extends BaseResource {
 };
 //#endregion
 //#region src/resources/evaluators.ts
-var EvaluatorScoreSourceType = /* @__PURE__ */ function(EvaluatorScoreSourceType) {
-	EvaluatorScoreSourceType["Evaluator"] = "Evaluator";
-	EvaluatorScoreSourceType["Code"] = "Code";
-	return EvaluatorScoreSourceType;
-}(EvaluatorScoreSourceType || {});
 /**
 * Resource for creating evaluator scores
 */
@@ -444,25 +439,21 @@ var EvaluatorsResource = class extends BaseResource {
 	async score(options) {
 		const { name, metadata, score } = options;
 		let payload;
-		if ("traceId" in options && options.traceId) {
-			const formattedTraceId = isStringUUID(options.traceId) ? options.traceId : otelTraceIdToUUID(options.traceId);
-			payload = {
-				name,
-				metadata,
-				score,
-				source: EvaluatorScoreSourceType.Code,
-				traceId: formattedTraceId
-			};
-		} else if ("spanId" in options && options.spanId) {
-			const formattedSpanId = isStringUUID(options.spanId) ? options.spanId : otelSpanIdToUUID(options.spanId);
-			payload = {
-				name,
-				metadata,
-				score,
-				source: EvaluatorScoreSourceType.Code,
-				spanId: formattedSpanId
-			};
-		} else throw new Error("Either 'traceId' or 'spanId' must be provided.");
+		if ("traceId" in options && options.traceId) payload = {
+			name,
+			metadata,
+			score,
+			source: "Code",
+			traceId: isStringUUID(options.traceId) ? options.traceId : otelTraceIdToUUID(options.traceId)
+		};
+		else if ("spanId" in options && options.spanId) payload = {
+			name,
+			metadata,
+			score,
+			source: "Code",
+			spanId: isStringUUID(options.spanId) ? options.spanId : otelSpanIdToUUID(options.spanId)
+		};
+		else throw new Error("Either 'traceId' or 'spanId' must be provided.");
 		const response = await fetch(this.baseHttpUrl + "/v1/evaluators/score", {
 			method: "POST",
 			headers: this.headers(),
@@ -608,13 +599,89 @@ var TagsResource = class extends BaseResource {
 	}
 };
 //#endregion
+//#region src/resources/traces.ts
+/** Resource for post-factum operations on existing traces. */
+const logger = initializeLogger();
+var TracesResource = class extends BaseResource {
+	/** Resource for post-factum operations on existing traces. */
+	constructor(baseHttpUrl, projectApiKey) {
+		super(baseHttpUrl, projectApiKey);
+	}
+	/**
+	* Push a metadata patch to an existing trace.
+	*
+	* The patch is shallow-merged server-side into the trace's existing metadata
+	* (`existing || patch`, last-write-wins per top-level key). Useful for
+	* attaching post-factum signals — quality scores, human edits, triage labels —
+	* to a trace that has already finished. The patch does NOT extend `endTime`
+	* or change tokens / cost / top span / tags / span names. `numSpans` is
+	* incremented by 1 (paid by the virtual span that carried the patch through
+	* the ingestion queue) so the new ClickHouse row beats the prior version on
+	* `ReplacingMergeTree(numSpans)`. No row is added to the `spans` table.
+	*
+	* Compared to `Laminar.setTraceMetadata` (which sets metadata on the
+	* currently in-flight trace via OpenTelemetry attributes), this method
+	* operates on a finished trace by trace id, so it must be called after the
+	* trace has been flushed.
+	*
+	* A 404 response (the trace was not found in the project — typically because
+	* it has not been flushed yet) is logged as a warning and the call returns
+	* without throwing; any other non-OK status throws.
+	*
+	* @param traceId - The trace id to push metadata to. Accepts a UUID string
+	*   or a 32-char OTel hex trace id.
+	* @param metadata - The metadata patch. Top-level keys are merged into the
+	*   trace's existing metadata. Must be non-empty (the server rejects empty
+	*   patches with 400).
+	* @example
+	* ```typescript
+	* import { Laminar, observe, LaminarClient } from "@lmnr-ai/lmnr";
+	* Laminar.initialize();
+	* const client = new LaminarClient();
+	*
+	* let traceId: string | null = null;
+	* await observe({ name: "generate" }, async () => {
+	*   traceId = await Laminar.getTraceId();
+	* });
+	* await Laminar.flush();
+	*
+	* if (traceId) {
+	*   await client.traces.pushMetadata(traceId, {
+	*     score: 0.85,
+	*     reviewer: "alice",
+	*     needsReview: false,
+	*   });
+	* }
+	* ```
+	*/
+	async pushMetadata(traceId, metadata) {
+		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 response = await fetch(url, {
+			method: "POST",
+			headers: this.headers(),
+			body: JSON.stringify({
+				traceId: formattedTraceId,
+				metadata
+			})
+		});
+		if (response.status === 404) {
+			logger.warn(`Trace ${formattedTraceId} not found. The trace may not have been flushed yet — call await Laminar.flush() and retry.`);
+			return;
+		}
+		if (!response.ok) await this.handleError(response);
+	}
+};
+//#endregion
 //#region src/index.ts
 var LaminarClient = class {
 	constructor({ baseUrl, projectApiKey, port } = {}) {
 		loadEnv();
 		this.projectApiKey = projectApiKey ?? process.env.LMNR_PROJECT_API_KEY;
 		const httpPort = port ?? (baseUrl?.match(/:\d{1,5}$/g) ? parseInt(baseUrl.match(/:\d{1,5}$/g)[0].slice(1)) : 443);
-		this.baseUrl = `${(baseUrl ?? process.env.LMNR_BASE_URL)?.replace(/\/$/, "").replace(/:\d{1,5}$/g, "") ?? "https://api.lmnr.ai"}:${httpPort}`;
+		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);
@@ -622,6 +689,7 @@ var LaminarClient = class {
 		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);
 	}
 	get browserEvents() {
 		return this._browserEvents;
@@ -644,6 +712,9 @@ var LaminarClient = class {
 	get tags() {
 		return this._tags;
 	}
+	get traces() {
+		return this._traces;
+	}
 };
 //#endregion
 export { LaminarClient };

package/dist/index.mjs.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"index.mjs","names":["SDK_VERSION","logger","uuidv4","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/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 RolloutParam, type SpanType } from \"@lmnr-ai/types\";\n\nimport { otelSpanIdToUUID, otelTraceIdToUUID } from \"../utils\";\nimport { BaseResource } from \"./index\";\n\nexport class RolloutSessionsResource extends BaseResource {\n constructor(baseHttpUrl: string, projectApiKey: string) {\n super(baseHttpUrl, projectApiKey);\n }\n\n /\n Connects to the SSE stream for rollout debugging sessions\n * Returns the Response object for streaming SSE events\n /\n public async connect({\n sessionId,\n name,\n params,\n signal,\n }: {\n sessionId: string;\n params: RolloutParam[];\n name: string;\n signal?: AbortSignal;\n }): Promise<Response> {\n const response = await fetch(`${this.baseHttpUrl}/v1/rollouts/${sessionId}`, {\n method: \"POST\",\n headers: {\n ...this.headers(),\n 'Accept': 'text/event-stream',\n },\n body: JSON.stringify({ name, params }),\n signal,\n });\n\n if (!response.ok) {\n throw new Error(`SSE connection failed: ${response.status} ${response.statusText}`);\n }\n\n if (!response.body) {\n throw new Error('No response body');\n }\n\n return response;\n }\n\n public async delete({\n sessionId,\n }: {\n sessionId: string;\n }) {\n const response = await fetch(`${this.baseHttpUrl}/v1/rollouts/${sessionId}`, {\n method: \"DELETE\",\n headers: this.headers(),\n });\n\n if (!response.ok) {\n await this.handleError(response);\n }\n }\n\n public async setStatus({\n sessionId,\n status,\n }: {\n sessionId: string;\n status: 'PENDING' \| 'RUNNING' \| 'FINISHED' \| 'STOPPED';\n }) {\n const response = await fetch(`${this.baseHttpUrl}/v1/rollouts/${sessionId}/status`, {\n method: \"PATCH\",\n headers: this.headers(),\n body: JSON.stringify({ status }),\n });\n\n if (!response.ok) {\n await this.handleError(response);\n }\n }\n\n public async sendSpanUpdate({\n sessionId,\n span,\n }: {\n sessionId: string;\n span: {\n name: string;\n startTime: string;\n spanId: string;\n traceId: string;\n parentSpanId: string \| undefined;\n attributes: Record<string, any>;\n spanType: SpanType;\n };\n }) {\n const response = await fetch(`${this.baseHttpUrl}/v1/rollouts/${sessionId}/update`, {\n method: \"PATCH\",\n headers: this.headers(),\n body: JSON.stringify({\n type: \"spanStart\",\n spanId: otelSpanIdToUUID(span.spanId),\n traceId: otelTraceIdToUUID(span.traceId),\n parentSpanId: span.parentSpanId ? otelSpanIdToUUID(span.parentSpanId) : undefined,\n attributes: span.attributes,\n startTime: span.startTime,\n name: span.name,\n spanType: span.spanType,\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","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 { 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\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 }\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"],"mappings":"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"}
1	+ {"version":3,"file":"index.mjs","names":["SDK_VERSION","logger","uuidv4","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 RolloutParam, type SpanType } from \"@lmnr-ai/types\";\n\nimport { otelSpanIdToUUID, otelTraceIdToUUID } from \"../utils\";\nimport { BaseResource } from \"./index\";\n\nexport class RolloutSessionsResource extends BaseResource {\n constructor(baseHttpUrl: string, projectApiKey: string) {\n super(baseHttpUrl, projectApiKey);\n }\n\n /\n Connects to the SSE stream for rollout debugging sessions\n * Returns the Response object for streaming SSE events\n /\n public async connect({\n sessionId,\n name,\n params,\n signal,\n }: {\n sessionId: string;\n params: RolloutParam[];\n name: string;\n signal?: AbortSignal;\n }): Promise<Response> {\n const response = await fetch(`${this.baseHttpUrl}/v1/rollouts/${sessionId}`, {\n method: \"POST\",\n headers: {\n ...this.headers(),\n 'Accept': 'text/event-stream',\n },\n body: JSON.stringify({ name, params }),\n signal,\n });\n\n if (!response.ok) {\n throw new Error(`SSE connection failed: ${response.status} ${response.statusText}`);\n }\n\n if (!response.body) {\n throw new Error('No response body');\n }\n\n return response;\n }\n\n public async delete({\n sessionId,\n }: {\n sessionId: string;\n }) {\n const response = await fetch(`${this.baseHttpUrl}/v1/rollouts/${sessionId}`, {\n method: \"DELETE\",\n headers: this.headers(),\n });\n\n if (!response.ok) {\n await this.handleError(response);\n }\n }\n\n public async setStatus({\n sessionId,\n status,\n }: {\n sessionId: string;\n status: 'PENDING' \| 'RUNNING' \| 'FINISHED' \| 'STOPPED';\n }) {\n const response = await fetch(`${this.baseHttpUrl}/v1/rollouts/${sessionId}/status`, {\n method: \"PATCH\",\n headers: this.headers(),\n body: JSON.stringify({ status }),\n });\n\n if (!response.ok) {\n await this.handleError(response);\n }\n }\n\n public async sendSpanUpdate({\n sessionId,\n span,\n }: {\n sessionId: string;\n span: {\n name: string;\n startTime: string;\n spanId: string;\n traceId: string;\n parentSpanId: string \| undefined;\n attributes: Record<string, any>;\n spanType: SpanType;\n };\n }) {\n const response = await fetch(`${this.baseHttpUrl}/v1/rollouts/${sessionId}/update`, {\n method: \"PATCH\",\n headers: this.headers(),\n body: JSON.stringify({\n type: \"spanStart\",\n spanId: otelSpanIdToUUID(span.spanId),\n traceId: otelTraceIdToUUID(span.traceId),\n parentSpanId: span.parentSpanId ? otelSpanIdToUUID(span.parentSpanId) : undefined,\n attributes: span.attributes,\n startTime: span.startTime,\n name: span.name,\n spanType: span.spanType,\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; 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 * @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 ): 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 // 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(\n `Trace ${formattedTraceId} not found. The trace may not have been ` +\n \"flushed yet — call await Laminar.flush() and retry.\",\n );\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"],"mappings":"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"}

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@lmnr-ai/client",
-  "version": "0.8.24",
+  "version": "0.8.26",
   "description": "HTTP client for Laminar AI API",
   "main": "dist/index.cjs",
   "module": "dist/index.mjs",
@@ -39,7 +39,7 @@
   "devDependencies": {
     "nock": "^14.0.8",
     "tsx": "^4.20.3",
-    "@lmnr-ai/types": "0.8.24"
+    "@lmnr-ai/types": "0.8.26"
   },
   "scripts": {
     "build": "tsdown",