Node.js SDK

Node.js SDK Changelog

Below is the changelog of our Node.js SDK, oso-cloud:

2.3.0

  • Add support for context facts to the authorizeLocal, actionsLocal, and listLocal functions.

2.2.0

  • Use Fallback, if configured, for .get, .getPolicyMetadata, Query Builder, and local check APIs if Oso Cloud returns an error (Requires Fallback 1.0.0 or later)
  • Use Fallback, if configured, if Oso Cloud returns an HTTP 400 error

2.1.0

  • Add .evaluateLocalSelect and .evaluateLocalFilter functions to the Query Builder to support querying with Local Authorization.

2.0.2

  • Internal changes: remove deprecated API method.

2.0.1

  • Improve error message when using a list filtering method without providing a valid Local Authorization config YAML file.
  • More defensively handle non-JSON responses.

2.0.0

This release contains several breaking changes. There's a migration guide for upgrading from version 1.x, and don't hesitate to reach out if you run into any issues.

Generate TypeScript types from your policy

See the Node.js Client API for more details.

Simplified Fact Management API

Reduced the number of methods for managing facts in Oso Cloud from five to three:

  • tell is now insert.
  • delete has been upgraded to support wildcard deletions.
  • bulk, bulkTell, and bulkDelete have been replaced with a new transactional batch API.

See the [Centralized Authorization Data API doc] and the migration guide for more details.

Powerful new QueryBuilder API for querying arbitrary rules in your policy

See the [API docs][QueryBuilder] and the migration guide for more details.

1.7.1

  • Add X-Request-ID header to uniquely identify individual API requests; include this ID in error messages for better debugging.

1.7.0

  • Add new oso.actionsLocal() method.
  • Accept boolean, bigint, and number as fact args. These are converted to the appropriate Polar type.

1.6.2

  • Return an error if the request body is too large without sending a request to Oso Cloud.

1.6.1

  • Update error message wording: add "Oso Cloud error" prefix.

1.6.0

Added support for the local check api:

1.5.0

Add new oso.bulkActions() API.