@langfuse/core 5.5.0-beta.2 → 5.5.0

package/dist/index.cjs

@@ -387,7 +387,7 @@ var resetGlobalLogger = () => {
 // package.json
 var package_default = {
   name: "@langfuse/core",
-  version: "5.5.0-beta.2",
+  version: "5.5.0",
   description: "Core functions and utilities for Langfuse packages",
   type: "module",
   sideEffects: false,
@@ -11557,15 +11557,22 @@ var ScoresV3 = class {
   /**
    * Get a list of scores with a polymorphic `value` field (v3).
    *
-   * This endpoint requires Langfuse v4 or later.
-   *
    * The `value` field type depends on `dataType`:
    * - `NUMERIC` → number
    * - `BOOLEAN` → boolean
    * - `CATEGORICAL`, `TEXT`, `CORRECTION` → string
    *
-   * Use the `fields` parameter to include optional field groups beyond the
-   * default `core`. Unknown group names return HTTP 400.
+   * The response always includes the core fields: id, projectId, name,
+   * value, dataType, source, timestamp, environment, createdAt, updatedAt.
+   *
+   * Additional field groups can be requested via the `fields` parameter:
+   * - `details` — adds comment, configId, metadata
+   * - `subject` — adds the subject object describing the entity the score
+   *   is attached to: kind (trace, observation, session, or experiment),
+   *   id, and traceId for observation-level scores
+   * - `annotation` — adds authorUserId, queueId
+   *
+   * Unknown group names return HTTP 400.
    *
    * @param {LangfuseAPI.GetScoresV3Request} request
    * @param {ScoresV3.RequestOptions} requestOptions - Request-specific configuration.
@@ -11769,6 +11776,9 @@ var Scores = class {
     this._options = _options;
   }
   /**
+   * **Deprecated.** Use `GET /api/public/v3/scores` instead. This endpoint
+   * is no longer available on Langfuse v4 and later.
+   *
    * Get a list of scores (supports both trace and session scores)
    *
    * @param {LangfuseAPI.GetScoresRequest} request
@@ -11967,6 +11977,9 @@ var Scores = class {
     }
   }
   /**
+   * **Deprecated.** Use `GET /api/public/v3/scores` with the `id` filter
+   * instead. This endpoint is no longer available on Langfuse v4 and later.
+   *
    * Get a score (supports both trace and session scores)
    *
    * @param {string} scoreId - The unique langfuse identifier of a score
@@ -14262,6 +14275,163 @@ var Evaluators = class {
         });
     }
   }
+  /**
+   * Delete an evaluator.
+   *
+   * Important behavior:
+   * - This deletes the evaluator including all of its stored versions; `evaluatorId` may reference any version.
+   * - The API returns `409` while evaluation rules still reference the evaluator. Delete those evaluation rules first.
+   * - Langfuse-managed evaluators (`scope=managed`) cannot be deleted; the API returns `403`.
+   * - Scores already produced by the evaluator are not deleted.
+   *
+   * @param {string} evaluatorId - Evaluator identifier returned by the evaluator endpoints.
+   * @param {Evaluators.RequestOptions} requestOptions - Request-specific configuration.
+   *
+   * @throws {@link LangfuseAPI.unstable.BadRequestError}
+   * @throws {@link LangfuseAPI.unstable.UnauthorizedError}
+   * @throws {@link LangfuseAPI.unstable.AccessDeniedError}
+   * @throws {@link LangfuseAPI.unstable.NotFoundError}
+   * @throws {@link LangfuseAPI.unstable.MethodNotAllowedError}
+   * @throws {@link LangfuseAPI.unstable.ConflictError}
+   * @throws {@link LangfuseAPI.unstable.TooManyRequestsError}
+   * @throws {@link LangfuseAPI.unstable.InternalServerError}
+   * @throws {@link LangfuseAPI.Error}
+   * @throws {@link LangfuseAPI.UnauthorizedError}
+   * @throws {@link LangfuseAPI.AccessDeniedError}
+   * @throws {@link LangfuseAPI.MethodNotAllowedError}
+   * @throws {@link LangfuseAPI.NotFoundError}
+   *
+   * @example
+   *     await client.unstable.evaluators.delete("evaluatorId")
+   */
+  delete(evaluatorId, requestOptions) {
+    return HttpResponsePromise.fromPromise(
+      this.__delete(evaluatorId, requestOptions)
+    );
+  }
+  async __delete(evaluatorId, 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/unstable/evaluators/${encodeURIComponent(evaluatorId)}`
+      ),
+      method: "DELETE",
+      headers: _headers,
+      queryParameters: requestOptions == null ? void 0 : requestOptions.queryParams,
+      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 unstable_exports.BadRequestError(
+            _response.error.body,
+            _response.rawResponse
+          );
+        case 401:
+          throw new unstable_exports.UnauthorizedError(
+            _response.error.body,
+            _response.rawResponse
+          );
+        case 403:
+          throw new unstable_exports.AccessDeniedError(
+            _response.error.body,
+            _response.rawResponse
+          );
+        case 404:
+          throw new unstable_exports.NotFoundError(
+            _response.error.body,
+            _response.rawResponse
+          );
+        case 405:
+          throw new unstable_exports.MethodNotAllowedError(
+            _response.error.body,
+            _response.rawResponse
+          );
+        case 409:
+          throw new unstable_exports.ConflictError(
+            _response.error.body,
+            _response.rawResponse
+          );
+        case 429:
+          throw new unstable_exports.TooManyRequestsError(
+            _response.error.body,
+            _response.rawResponse
+          );
+        case 500:
+          throw new unstable_exports.InternalServerError(
+            _response.error.body,
+            _response.rawResponse
+          );
+        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 DELETE /api/public/unstable/evaluators/{evaluatorId}."
+        );
+      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);