@langfuse/core 4.2.0 → 4.3.0

package/dist/index.cjs

@@ -48,6 +48,7 @@ __export(index_exports, {
   NotFoundError: () => NotFoundError,
   ObservationLevel: () => ObservationLevel,
   ObservationType: () => ObservationType,
+  PromptType: () => PromptType,
   ScoreDataType: () => ScoreDataType,
   ScoreSource: () => ScoreSource,
   ServiceUnavailableError: () => ServiceUnavailableError,
@@ -76,6 +77,7 @@ __export(index_exports, {
   metrics: () => metrics_exports,
   models: () => models_exports,
   observations: () => observations_exports,
+  opentelemetry: () => opentelemetry_exports,
   organizations: () => organizations_exports,
   projects: () => projects_exports,
   promptVersion: () => promptVersion_exports,
@@ -323,7 +325,7 @@ var resetGlobalLogger = () => {
 // package.json
 var package_default = {
   name: "@langfuse/core",
-  version: "4.2.0",
+  version: "4.3.0",
   description: "Core functions and utilities for Langfuse packages",
   type: "module",
   sideEffects: false,
@@ -406,7 +408,8 @@ var AnnotationQueueStatus = {
 // src/api/api/resources/annotationQueues/types/AnnotationQueueObjectType.ts
 var AnnotationQueueObjectType = {
   Trace: "TRACE",
-  Observation: "OBSERVATION"
+  Observation: "OBSERVATION",
+  Session: "SESSION"
 };
 
 // src/api/api/resources/blobStorageIntegrations/index.ts
@@ -736,6 +739,9 @@ var models_exports = {};
 // src/api/api/resources/observations/index.ts
 var observations_exports = {};
 
+// src/api/api/resources/opentelemetry/index.ts
+var opentelemetry_exports = {};
+
 // src/api/api/resources/organizations/index.ts
 var organizations_exports = {};
 __export(organizations_exports, {
@@ -755,6 +761,15 @@ var projects_exports = {};
 
 // src/api/api/resources/prompts/index.ts
 var prompts_exports = {};
+__export(prompts_exports, {
+  PromptType: () => PromptType
+});
+
+// src/api/api/resources/prompts/types/PromptType.ts
+var PromptType = {
+  Chat: "chat",
+  Text: "text"
+};
 
 // src/api/api/resources/scim/index.ts
 var scim_exports = {};
@@ -4822,7 +4837,7 @@ var Ingestion = class {
   /**
    * **Legacy endpoint for batch ingestion for Langfuse Observability.**
    *
-   * -> Please use the OpenTelemetry endpoint (`/api/public/otel`). Learn more: https://langfuse.com/integrations/native/opentelemetry
+   * -> Please use the OpenTelemetry endpoint (`/api/public/otel/v1/traces`). Learn more: https://langfuse.com/integrations/native/opentelemetry
    *
    * Within each batch, there can be multiple events.
    * Each event has a type, an id, a timestamp, metadata and a body.
@@ -5596,7 +5611,9 @@ var Metrics = class {
     this._options = _options;
   }
   /**
-   * Get metrics from the Langfuse project using a query object
+   * Get metrics from the Langfuse project using a query object.
+   *
+   * For more details, see the [Metrics API documentation](https://langfuse.com/docs/metrics/features/metrics-api).
    *
    * @param {LangfuseAPI.GetMetricsRequest} request
    * @param {Metrics.RequestOptions} requestOptions - Request-specific configuration.
@@ -6304,7 +6321,8 @@ var Observations = class {
       environment,
       fromStartTime,
       toStartTime,
-      version
+      version,
+      filter
     } = request;
     const _queryParams = {};
     if (page != null) {
@@ -6347,6 +6365,9 @@ var Observations = class {
     if (version != null) {
       _queryParams["version"] = version;
     }
+    if (filter != null) {
+      _queryParams["filter"] = filter;
+    }
     let _headers = mergeHeaders(
       (_a2 = this._options) == null ? void 0 : _a2.headers,
       mergeOnlyDefinedHeaders({
@@ -6441,6 +6462,182 @@ var Observations = class {
   }
 };
 
+// src/api/api/resources/opentelemetry/client/Client.ts
+var Opentelemetry = class {
+  constructor(_options) {
+    this._options = _options;
+  }
+  /**
+   * **OpenTelemetry Traces Ingestion Endpoint**
+   *
+   * This endpoint implements the OTLP/HTTP specification for trace ingestion, providing native OpenTelemetry integration for Langfuse Observability.
+   *
+   * **Supported Formats:**
+   * - Binary Protobuf: `Content-Type: application/x-protobuf`
+   * - JSON Protobuf: `Content-Type: application/json`
+   * - Supports gzip compression via `Content-Encoding: gzip` header
+   *
+   * **Specification Compliance:**
+   * - Conforms to [OTLP/HTTP Trace Export](https://opentelemetry.io/docs/specs/otlp/#otlphttp)
+   * - Implements `ExportTraceServiceRequest` message format
+   *
+   * **Documentation:**
+   * - Integration guide: https://langfuse.com/integrations/native/opentelemetry
+   * - Data model: https://langfuse.com/docs/observability/data-model
+   *
+   * @param {LangfuseAPI.OtelTraceRequest} request
+   * @param {Opentelemetry.RequestOptions} requestOptions - Request-specific configuration.
+   *
+   * @throws {@link LangfuseAPI.Error}
+   * @throws {@link LangfuseAPI.UnauthorizedError}
+   * @throws {@link LangfuseAPI.AccessDeniedError}
+   * @throws {@link LangfuseAPI.MethodNotAllowedError}
+   * @throws {@link LangfuseAPI.NotFoundError}
+   *
+   * @example
+   *     await client.opentelemetry.exportTraces({
+   *         resourceSpans: [{
+   *                 resource: {
+   *                     attributes: [{
+   *                             key: "service.name",
+   *                             value: {
+   *                                 stringValue: "my-service"
+   *                             }
+   *                         }, {
+   *                             key: "service.version",
+   *                             value: {
+   *                                 stringValue: "1.0.0"
+   *                             }
+   *                         }]
+   *                 },
+   *                 scopeSpans: [{
+   *                         scope: {
+   *                             name: "langfuse-sdk",
+   *                             version: "2.60.3"
+   *                         },
+   *                         spans: [{
+   *                                 traceId: "0123456789abcdef0123456789abcdef",
+   *                                 spanId: "0123456789abcdef",
+   *                                 name: "my-operation",
+   *                                 kind: 1,
+   *                                 startTimeUnixNano: "1747872000000000000",
+   *                                 endTimeUnixNano: "1747872001000000000",
+   *                                 attributes: [{
+   *                                         key: "langfuse.observation.type",
+   *                                         value: {
+   *                                             stringValue: "generation"
+   *                                         }
+   *                                     }],
+   *                                 status: {}
+   *                             }]
+   *                     }]
+   *             }]
+   *     })
+   */
+  exportTraces(request, requestOptions) {
+    return HttpResponsePromise.fromPromise(
+      this.__exportTraces(request, requestOptions)
+    );
+  }
+  async __exportTraces(request, requestOptions) {
+    var _a2, _b, _c, _d, _e, _f, _g, _h;
+    let _headers = mergeHeaders(
+      (_a2 = this._options) == null ? void 0 : _a2.headers,
+      mergeOnlyDefinedHeaders({
+        Authorization: await this._getAuthorizationHeader(),
+        "X-Langfuse-Sdk-Name": (_c = requestOptions == null ? void 0 : requestOptions.xLangfuseSdkName) != null ? _c : (_b = this._options) == null ? void 0 : _b.xLangfuseSdkName,
+        "X-Langfuse-Sdk-Version": (_e = requestOptions == null ? void 0 : requestOptions.xLangfuseSdkVersion) != null ? _e : (_d = this._options) == null ? void 0 : _d.xLangfuseSdkVersion,
+        "X-Langfuse-Public-Key": (_g = requestOptions == null ? void 0 : requestOptions.xLangfusePublicKey) != null ? _g : (_f = this._options) == null ? void 0 : _f.xLangfusePublicKey
+      }),
+      requestOptions == null ? void 0 : requestOptions.headers
+    );
+    const _response = await fetcher({
+      url: url_exports.join(
+        (_h = await Supplier.get(this._options.baseUrl)) != null ? _h : await Supplier.get(this._options.environment),
+        "/api/public/otel/v1/traces"
+      ),
+      method: "POST",
+      headers: _headers,
+      contentType: "application/json",
+      queryParameters: requestOptions == null ? void 0 : requestOptions.queryParams,
+      requestType: "json",
+      body: request,
+      timeoutMs: (requestOptions == null ? void 0 : requestOptions.timeoutInSeconds) != null ? requestOptions.timeoutInSeconds * 1e3 : 6e4,
+      maxRetries: requestOptions == null ? void 0 : requestOptions.maxRetries,
+      abortSignal: requestOptions == null ? void 0 : requestOptions.abortSignal
+    });
+    if (_response.ok) {
+      return {
+        data: _response.body,
+        rawResponse: _response.rawResponse
+      };
+    }
+    if (_response.error.reason === "status-code") {
+      switch (_response.error.statusCode) {
+        case 400:
+          throw new Error2(
+            _response.error.body,
+            _response.rawResponse
+          );
+        case 401:
+          throw new UnauthorizedError(
+            _response.error.body,
+            _response.rawResponse
+          );
+        case 403:
+          throw new AccessDeniedError(
+            _response.error.body,
+            _response.rawResponse
+          );
+        case 405:
+          throw new MethodNotAllowedError(
+            _response.error.body,
+            _response.rawResponse
+          );
+        case 404:
+          throw new NotFoundError(
+            _response.error.body,
+            _response.rawResponse
+          );
+        default:
+          throw new LangfuseAPIError({
+            statusCode: _response.error.statusCode,
+            body: _response.error.body,
+            rawResponse: _response.rawResponse
+          });
+      }
+    }
+    switch (_response.error.reason) {
+      case "non-json":
+        throw new LangfuseAPIError({
+          statusCode: _response.error.statusCode,
+          body: _response.error.rawBody,
+          rawResponse: _response.rawResponse
+        });
+      case "timeout":
+        throw new LangfuseAPITimeoutError(
+          "Timeout exceeded when calling POST /api/public/otel/v1/traces."
+        );
+      case "unknown":
+        throw new LangfuseAPIError({
+          message: _response.error.errorMessage,
+          rawResponse: _response.rawResponse
+        });
+    }
+  }
+  async _getAuthorizationHeader() {
+    const username = await Supplier.get(this._options.username);
+    const password = await Supplier.get(this._options.password);
+    if (username != null && password != null) {
+      return BasicAuth.toAuthorizationHeader({
+        username,
+        password
+      });
+    }
+    return void 0;
+  }
+};
+
 // src/api/api/resources/organizations/client/Client.ts
 var Organizations = class {
   constructor(_options) {
@@ -7749,7 +7946,9 @@ var Projects = class {
    *
    * @example
    *     await client.projects.createApiKey("projectId", {
-   *         note: undefined
+   *         note: undefined,
+   *         publicKey: undefined,
+   *         secretKey: undefined
    *     })
    */
   createApiKey(projectId, request = {}, requestOptions) {
@@ -9556,6 +9755,120 @@ var ScoreConfigs = class {
         });
     }
   }
+  /**
+   * Update a score config
+   *
+   * @param {string} configId - The unique langfuse identifier of a score config
+   * @param {LangfuseAPI.UpdateScoreConfigRequest} request
+   * @param {ScoreConfigs.RequestOptions} requestOptions - Request-specific configuration.
+   *
+   * @throws {@link LangfuseAPI.Error}
+   * @throws {@link LangfuseAPI.UnauthorizedError}
+   * @throws {@link LangfuseAPI.AccessDeniedError}
+   * @throws {@link LangfuseAPI.MethodNotAllowedError}
+   * @throws {@link LangfuseAPI.NotFoundError}
+   *
+   * @example
+   *     await client.scoreConfigs.update("configId", {
+   *         isArchived: undefined,
+   *         name: undefined,
+   *         categories: undefined,
+   *         minValue: undefined,
+   *         maxValue: undefined,
+   *         description: undefined
+   *     })
+   */
+  update(configId, request, requestOptions) {
+    return HttpResponsePromise.fromPromise(
+      this.__update(configId, request, requestOptions)
+    );
+  }
+  async __update(configId, request, requestOptions) {
+    var _a2, _b, _c, _d, _e, _f, _g, _h;
+    let _headers = mergeHeaders(
+      (_a2 = this._options) == null ? void 0 : _a2.headers,
+      mergeOnlyDefinedHeaders({
+        Authorization: await this._getAuthorizationHeader(),
+        "X-Langfuse-Sdk-Name": (_c = requestOptions == null ? void 0 : requestOptions.xLangfuseSdkName) != null ? _c : (_b = this._options) == null ? void 0 : _b.xLangfuseSdkName,
+        "X-Langfuse-Sdk-Version": (_e = requestOptions == null ? void 0 : requestOptions.xLangfuseSdkVersion) != null ? _e : (_d = this._options) == null ? void 0 : _d.xLangfuseSdkVersion,
+        "X-Langfuse-Public-Key": (_g = requestOptions == null ? void 0 : requestOptions.xLangfusePublicKey) != null ? _g : (_f = this._options) == null ? void 0 : _f.xLangfusePublicKey
+      }),
+      requestOptions == null ? void 0 : requestOptions.headers
+    );
+    const _response = await fetcher({
+      url: url_exports.join(
+        (_h = await Supplier.get(this._options.baseUrl)) != null ? _h : await Supplier.get(this._options.environment),
+        `/api/public/score-configs/${encodeURIComponent(configId)}`
+      ),
+      method: "PATCH",
+      headers: _headers,
+      contentType: "application/json",
+      queryParameters: requestOptions == null ? void 0 : requestOptions.queryParams,
+      requestType: "json",
+      body: request,
+      timeoutMs: (requestOptions == null ? void 0 : requestOptions.timeoutInSeconds) != null ? requestOptions.timeoutInSeconds * 1e3 : 6e4,
+      maxRetries: requestOptions == null ? void 0 : requestOptions.maxRetries,
+      abortSignal: requestOptions == null ? void 0 : requestOptions.abortSignal
+    });
+    if (_response.ok) {
+      return {
+        data: _response.body,
+        rawResponse: _response.rawResponse
+      };
+    }
+    if (_response.error.reason === "status-code") {
+      switch (_response.error.statusCode) {
+        case 400:
+          throw new Error2(
+            _response.error.body,
+            _response.rawResponse
+          );
+        case 401:
+          throw new UnauthorizedError(
+            _response.error.body,
+            _response.rawResponse
+          );
+        case 403:
+          throw new AccessDeniedError(
+            _response.error.body,
+            _response.rawResponse
+          );
+        case 405:
+          throw new MethodNotAllowedError(
+            _response.error.body,
+            _response.rawResponse
+          );
+        case 404:
+          throw new NotFoundError(
+            _response.error.body,
+            _response.rawResponse
+          );
+        default:
+          throw new LangfuseAPIError({
+            statusCode: _response.error.statusCode,
+            body: _response.error.body,
+            rawResponse: _response.rawResponse
+          });
+      }
+    }
+    switch (_response.error.reason) {
+      case "non-json":
+        throw new LangfuseAPIError({
+          statusCode: _response.error.statusCode,
+          body: _response.error.rawBody,
+          rawResponse: _response.rawResponse
+        });
+      case "timeout":
+        throw new LangfuseAPITimeoutError(
+          "Timeout exceeded when calling PATCH /api/public/score-configs/{configId}."
+        );
+      case "unknown":
+        throw new LangfuseAPIError({
+          message: _response.error.errorMessage,
+          rawResponse: _response.rawResponse
+        });
+    }
+  }
   async _getAuthorizationHeader() {
     const username = await Supplier.get(this._options.username);
     const password = await Supplier.get(this._options.password);
@@ -9897,6 +10210,7 @@ var Score = class {
    *         comment: undefined,
    *         metadata: undefined,
    *         environment: undefined,
+   *         queueId: undefined,
    *         dataType: undefined,
    *         configId: undefined
    *     })
@@ -10596,7 +10910,8 @@ var Trace = class {
       version,
       release,
       environment,
-      fields
+      fields,
+      filter
     } = request;
     const _queryParams = {};
     if (page != null) {
@@ -10646,6 +10961,9 @@ var Trace = class {
     if (fields != null) {
       _queryParams["fields"] = fields;
     }
+    if (filter != null) {
+      _queryParams["filter"] = filter;
+    }
     let _headers = mergeHeaders(
       (_a2 = this._options) == null ? void 0 : _a2.headers,
       mergeOnlyDefinedHeaders({
@@ -10917,6 +11235,10 @@ var LangfuseAPIClient = class {
     var _a2;
     return (_a2 = this._observations) != null ? _a2 : this._observations = new Observations(this._options);
   }
+  get opentelemetry() {
+    var _a2;
+    return (_a2 = this._opentelemetry) != null ? _a2 : this._opentelemetry = new Opentelemetry(this._options);
+  }
   get organizations() {
     var _a2;
     return (_a2 = this._organizations) != null ? _a2 : this._organizations = new Organizations(this._options);
@@ -11150,6 +11472,7 @@ var LangfuseMedia = class {
   NotFoundError,
   ObservationLevel,
   ObservationType,
+  PromptType,
   ScoreDataType,
   ScoreSource,
   ServiceUnavailableError,
@@ -11178,6 +11501,7 @@ var LangfuseMedia = class {
   metrics,
   models,
   observations,
+  opentelemetry,
   organizations,
   projects,
   promptVersion,