@langfuse/core 4.5.1 → 4.6.0

package/LICENSE

@@ -1,5 +1,8 @@
-Copyright (c) 2023 Finto Technologies GmbH
+MIT License
 
+This repository is licensed under the MIT License. Portions of this codebase are derived from posthog/posthog-js-lite by PostHog, which is also licensed under the MIT License.
+
+Copyright (c) 2023-2026 Langfuse GmbH
 Copyright (c) 2022 PostHog (part of Hiberly Inc)
 
 Permission is hereby granted, free of charge, to any person obtaining a copy

package/dist/index.cjs

@@ -52,6 +52,7 @@ __export(index_exports, {
   ObservationType: () => ObservationType,
   PricingTierOperator: () => PricingTierOperator,
   PromptType: () => PromptType,
+  ScoreConfigDataType: () => ScoreConfigDataType,
   ScoreDataType: () => ScoreDataType,
   ScoreSource: () => ScoreSource,
   ServiceUnavailableError: () => ServiceUnavailableError,
@@ -299,6 +300,23 @@ var Logger = class {
   getLevel() {
     return this.config.level;
   }
+  /**
+   * Checks if a given log level is enabled.
+   * Use this to guard expensive operations (like JSON.stringify) before debug logging.
+   *
+   * @param level - The log level to check
+   * @returns True if the level is enabled, false otherwise
+   *
+   * @example
+   * ```typescript
+   * if (logger.isLevelEnabled(LogLevel.DEBUG)) {
+   *   logger.debug('Expensive data:', JSON.stringify(largeObject));
+   * }
+   * ```
+   */
+  isLevelEnabled(level) {
+    return this.shouldLog(level);
+  }
 };
 var _a;
 var _LoggerSingleton = class _LoggerSingleton {
@@ -353,7 +371,7 @@ var resetGlobalLogger = () => {
 // package.json
 var package_default = {
   name: "@langfuse/core",
-  version: "4.5.0",
+  version: "4.5.1",
   description: "Core functions and utilities for Langfuse packages",
   type: "module",
   sideEffects: false,
@@ -510,6 +528,7 @@ __export(commons_exports, {
   NotFoundError: () => NotFoundError,
   ObservationLevel: () => ObservationLevel,
   PricingTierOperator: () => PricingTierOperator,
+  ScoreConfigDataType: () => ScoreConfigDataType,
   ScoreDataType: () => ScoreDataType,
   ScoreSource: () => ScoreSource,
   UnauthorizedError: () => UnauthorizedError
@@ -564,11 +583,19 @@ var ScoreSource = {
   Eval: "EVAL"
 };
 
+// src/api/api/resources/commons/types/ScoreConfigDataType.ts
+var ScoreConfigDataType = {
+  Numeric: "NUMERIC",
+  Boolean: "BOOLEAN",
+  Categorical: "CATEGORICAL"
+};
+
 // src/api/api/resources/commons/types/ScoreDataType.ts
 var ScoreDataType = {
   Numeric: "NUMERIC",
   Boolean: "BOOLEAN",
-  Categorical: "CATEGORICAL"
+  Categorical: "CATEGORICAL",
+  Correction: "CORRECTION"
 };
 
 // src/api/core/json.ts
@@ -3650,7 +3677,8 @@ var DatasetItems = class {
     }
   }
   /**
-   * Get dataset items
+   * Get dataset items. Optionally specify a version to get the items as they existed at that point in time.
+   * Note: If version parameter is provided, datasetName must also be provided.
    *
    * @param {LangfuseAPI.GetDatasetItemsRequest} request
    * @param {DatasetItems.RequestOptions} requestOptions - Request-specific configuration.
@@ -3671,7 +3699,14 @@ var DatasetItems = class {
   }
   async __list(request = {}, requestOptions) {
     var _a2, _b, _c, _d, _e, _f, _g, _h;
-    const { datasetName, sourceTraceId, sourceObservationId, page, limit } = request;
+    const {
+      datasetName,
+      sourceTraceId,
+      sourceObservationId,
+      version,
+      page,
+      limit
+    } = request;
     const _queryParams = {};
     if (datasetName != null) {
       _queryParams["datasetName"] = datasetName;
@@ -3682,6 +3717,9 @@ var DatasetItems = class {
     if (sourceObservationId != null) {
       _queryParams["sourceObservationId"] = sourceObservationId;
     }
+    if (version != null) {
+      _queryParams["version"] = version;
+    }
     if (page != null) {
       _queryParams["page"] = page.toString();
     }
@@ -3909,7 +3947,8 @@ var DatasetRunItems = class {
    *         metadata: undefined,
    *         datasetItemId: "datasetItemId",
    *         observationId: undefined,
-   *         traceId: undefined
+   *         traceId: undefined,
+   *         datasetVersion: undefined
    *     })
    */
   create(request, requestOptions) {
@@ -5928,6 +5967,8 @@ var Metrics = class {
   /**
    * Get metrics from the Langfuse project using a query object.
    *
+   * Consider using the [v2 metrics endpoint](/api-reference#tag/metricsv2/GET/api/public/v2/metrics) for better performance.
+   *
    * For more details, see the [Metrics API documentation](https://langfuse.com/docs/metrics/features/metrics-api).
    *
    * @param {LangfuseAPI.GetMetricsRequest} request
@@ -6514,7 +6555,7 @@ var ObservationsV2 = class {
    * - `basic` - name, level, statusMessage, version, environment, bookmarked, public, userId, sessionId
    * - `time` - completionStartTime, createdAt, updatedAt
    * - `io` - input, output
-   * - `metadata` - metadata
+   * - `metadata` - metadata (truncated to 200 chars by default, use `expandMetadata` to get full values)
    * - `model` - providedModelName, internalModelId, modelParameters
    * - `usage` - usageDetails, costDetails, totalCost
    * - `prompt` - promptId, promptName, promptVersion
@@ -6547,6 +6588,7 @@ var ObservationsV2 = class {
     var _a2, _b, _c, _d, _e, _f, _g, _h;
     const {
       fields,
+      expandMetadata,
       limit,
       cursor,
       parseIoAsJson,
@@ -6566,6 +6608,9 @@ var ObservationsV2 = class {
     if (fields != null) {
       _queryParams["fields"] = fields;
     }
+    if (expandMetadata != null) {
+      _queryParams["expandMetadata"] = expandMetadata;
+    }
     if (limit != null) {
       _queryParams["limit"] = limit.toString();
     }
@@ -6815,7 +6860,9 @@ var Observations = class {
     }
   }
   /**
-   * Get a list of observations
+   * Get a list of observations.
+   *
+   * Consider using the [v2 observations endpoint](/api-reference#tag/observationsv2/GET/api/public/v2/observations) for cursor-based pagination and field selection.
    *
    * @param {LangfuseAPI.GetObservationsRequest} request
    * @param {Observations.RequestOptions} requestOptions - Request-specific configuration.
@@ -8260,7 +8307,7 @@ var Projects = class {
    *     await client.projects.update("projectId", {
    *         name: "name",
    *         metadata: undefined,
-   *         retention: 1
+   *         retention: undefined
    *     })
    */
   update(projectId, request, requestOptions) {
@@ -10667,7 +10714,8 @@ var ScoreV2 = class {
       traceId,
       queueId,
       dataType,
-      traceTags
+      traceTags,
+      fields
     } = request;
     const _queryParams = {};
     if (page != null) {
@@ -10732,6 +10780,9 @@ var ScoreV2 = class {
         _queryParams["traceTags"] = traceTags;
       }
     }
+    if (fields != null) {
+      _queryParams["fields"] = fields;
+    }
     let _headers = mergeHeaders(
       (_a2 = this._options) == null ? void 0 : _a2.headers,
       mergeOnlyDefinedHeaders({
@@ -12629,6 +12680,7 @@ function getSpanKeyFromBaggageKey(baggageKey) {
   ObservationType,
   PricingTierOperator,
   PromptType,
+  ScoreConfigDataType,
   ScoreDataType,
   ScoreSource,
   ServiceUnavailableError,