@langfuse/client 4.5.1 → 4.6.1

package/dist/index.d.cts

@@ -177,6 +177,12 @@ type ExperimentParams<Input = any, ExpectedOutput = any, Metadata extends Record
      * Set lower values for expensive operations or rate-limited services.
      */
     maxConcurrency?: number;
+    /**
+     * Optional ISO 8601 timestamp (RFC 3339, Section 5.6) in UTC (e.g., "2026-01-21T14:35:42Z").
+     * If provided, returns state of dataset at this timestamp.
+     * If not provided, returns the latest version.
+     */
+    datasetVersion?: string;
 };
 type ExperimentItemResult<Input = any, ExpectedOutput = any, Metadata extends Record<string, any> = Record<string, any>> = Pick<ExperimentItem<Input, ExpectedOutput, Metadata>, "input" | "expectedOutput"> & {
     /**
@@ -364,6 +370,11 @@ type FetchedDataset = Dataset & {
     items: (DatasetItem & {
         link: LinkDatasetItemFunction;
     })[];
+    /** ISO 8601 timestamp (RFC 3339, Section 5.6) in UTC (e.g., "2026-01-21T14:35:42Z").
+     * If provided, returns state of dataset at this timestamp.
+     * If not provided, returns the latest version.
+     */
+    version?: string;
     /** Function to run experiments directly on this dataset */
     runExperiment: RunExperimentOnDataset;
 };
@@ -521,7 +532,13 @@ declare class DatasetManager {
      * @since 4.0.0
      */
     get(name: string, options?: {
-        fetchItemsPageSize: number;
+        fetchItemsPageSize?: number;
+        /**
+         * ISO 8601 timestamp (RFC 3339, Section 5.6) in UTC (e.g., "2026-01-21T14:35:42Z").
+         * If provided, returns state of dataset at this timestamp.
+         * If not provided, returns the latest version.
+         */
+        version?: string;
     }): Promise<FetchedDataset>;
     /**
      * Creates a link function for a specific dataset item.

package/dist/index.d.ts

@@ -177,6 +177,12 @@ type ExperimentParams<Input = any, ExpectedOutput = any, Metadata extends Record
      * Set lower values for expensive operations or rate-limited services.
      */
     maxConcurrency?: number;
+    /**
+     * Optional ISO 8601 timestamp (RFC 3339, Section 5.6) in UTC (e.g., "2026-01-21T14:35:42Z").
+     * If provided, returns state of dataset at this timestamp.
+     * If not provided, returns the latest version.
+     */
+    datasetVersion?: string;
 };
 type ExperimentItemResult<Input = any, ExpectedOutput = any, Metadata extends Record<string, any> = Record<string, any>> = Pick<ExperimentItem<Input, ExpectedOutput, Metadata>, "input" | "expectedOutput"> & {
     /**
@@ -364,6 +370,11 @@ type FetchedDataset = Dataset & {
     items: (DatasetItem & {
         link: LinkDatasetItemFunction;
     })[];
+    /** ISO 8601 timestamp (RFC 3339, Section 5.6) in UTC (e.g., "2026-01-21T14:35:42Z").
+     * If provided, returns state of dataset at this timestamp.
+     * If not provided, returns the latest version.
+     */
+    version?: string;
     /** Function to run experiments directly on this dataset */
     runExperiment: RunExperimentOnDataset;
 };
@@ -521,7 +532,13 @@ declare class DatasetManager {
      * @since 4.0.0
      */
     get(name: string, options?: {
-        fetchItemsPageSize: number;
+        fetchItemsPageSize?: number;
+        /**
+         * ISO 8601 timestamp (RFC 3339, Section 5.6) in UTC (e.g., "2026-01-21T14:35:42Z").
+         * If provided, returns state of dataset at this timestamp.
+         * If not provided, returns the latest version.
+         */
+        version?: string;
     }): Promise<FetchedDataset>;
     /**
      * Creates a link function for a specific dataset item.

package/dist/index.mjs

@@ -103,7 +103,8 @@ var DatasetManager = class {
       const itemsResponse = await this.langfuseClient.api.datasetItems.list({
         datasetName: name,
         limit: (_a = options == null ? void 0 : options.fetchItemsPageSize) != null ? _a : 50,
-        page
+        page,
+        ...(options == null ? void 0 : options.version) && { version: options.version }
       });
       items.push(...itemsResponse.data);
       if (itemsResponse.meta.totalPages <= page) {
@@ -118,12 +119,14 @@ var DatasetManager = class {
     const runExperiment = (params) => {
       return this.langfuseClient.experiment.run({
         data: items,
+        datasetVersion: options == null ? void 0 : options.version,
         ...params
       });
     };
     const returnDataset = {
       ...dataset,
       items: itemsWithLinkMethod,
+      version: options == null ? void 0 : options.version,
       runExperiment
     };
     return returnDataset;
@@ -286,7 +289,8 @@ var ExperimentManager = class {
           experimentName: name,
           experimentRunName: runName,
           experimentDescription: description,
-          experimentMetadata: metadata
+          experimentMetadata: metadata,
+          datasetVersion: config.datasetVersion
         });
       });
       const settledResults = await Promise.allSettled(promises);
@@ -410,7 +414,10 @@ var ExperimentManager = class {
               metadata: params.experimentMetadata,
               datasetItemId,
               traceId: traceId2,
-              observationId: observationId2
+              observationId: observationId2,
+              ...params.datasetVersion && {
+                datasetVersion: params.datasetVersion
+              }
             }
           );
           datasetRunId2 = result.datasetRunId;
@@ -1579,6 +1586,7 @@ import {
   getEnv,
   generateUUID,
   getGlobalLogger as getGlobalLogger5,
+  LogLevel,
   safeSetTimeout
 } from "@langfuse/core";
 import { trace as trace2 } from "@opentelemetry/api";
@@ -1643,10 +1651,12 @@ var ScoreManager = class {
       return;
     }
     this.eventQueue.push(scoreIngestionEvent);
-    this.logger.debug(
-      "Added score event to queue:\n",
-      JSON.stringify(scoreIngestionEvent, null, 2)
-    );
+    if (this.logger.isLevelEnabled(LogLevel.DEBUG)) {
+      this.logger.debug(
+        "Added score event to queue:\n",
+        JSON.stringify(scoreIngestionEvent, null, 2)
+      );
+    }
     if (this.eventQueue.length >= this.flushAtCount) {
       this.flushPromise = this.flush();
     } else if (!this.flushTimer) {