Navigation

API (Node.js) SDK changelog

The server-side SDK for Node.js, published as @ruptjs/api. It replaces the earlier @ruptjs/core package.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

[3.0.1] - 2026-07-27

Breaking type changes in a patch release, which isn't how we like to do it, and we're sorry for the odd bump. The old fields described a response the API had already stopped sending, so leaving them in place only produced type errors against real data. We checked with every customer on the SDK before shipping and none of them read category or risk_summary.

Changed

  • EvaluationRisk now has id, definition, and name in place of category, matching the API. Branch on definition, the id of the risk definition the risk was raised against. name is a display label and can be renamed in the dashboard.

Removed

  • Evaluation.risk_summary. The API no longer returns it, and it repeated risks one for one.

[3.0.0] - 2026-06-02

Added

  • Initial release as @ruptjs/api, targeting the Rupt V3 API.
  • getEvaluation and consumeEvaluation to confirm evaluations server-side. Consuming is single-use: a replayed evaluation returns a 409.
  • getChallenge to retrieve a challenge and its status.
  • getUserDevices to list a user's devices.
  • updateUser for partial updates to email, phone, metadata, and groups.
  • Automatic retries with exponential backoff on network errors and 5xx responses, plus typed errors: RuptApiError, RuptNetworkError, and RuptTimeoutError.
  • Configurable domain, timeout, retries, and maxRetryDelay.

Changed

  • Package renamed from @ruptjs/core to @ruptjs/api.

Removed

  • evaluate. In V3, evaluations are created by the client SDKs and confirmed server-side with getEvaluation or consumeEvaluation.

The versions below shipped as @ruptjs/core against the V2 API.

[0.1.0] - 2025-08-25

Added

  • updateUser method to update a user.

[0.0.13] - 2024-11-11

Added

  • evaluate method now accepts email, phone, ip, and metadata parameters.

[0.0.12] - 2024-11-05

Changed

  • Updated readme.

[0.0.11] - 2024-11-05

Added

  • evaluate method to evaluate an action for a user.

[0.0.10] - 2024-09-16

Changed

  • Initial release of the Core SDK.