Reference
Client SDK
Changelog

[Oso Cloud CLI] 0.19.0

  • Add a --preview flag for policy updates to return a diff of the changes. See CLI reference for more.
  • Add support for Linux arm64
  • Bugfix: UNION queries in data bindings now validate correctly.

[Oso Cloud CLI] 0.18.7

  • Add --summarized-output flag to the experimental reconcile command.

[Oso Cloud CLI] 0.18.6

  • Adjust the format of types generated by generate-types so that it's more pleasant to pass union types into the 2.0 TypeScript client.

[Oso Cloud CLI] 0.18.5

  • Bugfix: in the LSP, exit the process when there's nothing left to read on stdin. This should prevent orphaned LSP processes when (for example) closing workspaces while using the VSCode extension.

[Oso Cloud CLI] 0.18.4

  • Bugfix: in the LSP, clear diagnostics when deleting or closing Polar files.

[Oso Cloud CLI] 0.18.3

  • Bugfix: in the LSP, fix several bugs related to running tests.

[Oso Cloud CLI] 0.18.2

  • Bugfix: in the LSP, correctly handle deleting Polar files.

[Oso Cloud CLI] 0.18.1

  • Bugfix: in the LSP, mark passing tests as hints, rather than informational, so that editors don't display them as problems.

[Oso Cloud CLI] 0.18.0

  • Promote the lsp command out of the experimental namespace. This command starts a new Language Server Protocol server for Polar files.
  • Add the ability to run tests and get suggestions on how to fix failing tests via the LSP.

[Oso Cloud CLI] 0.17.0

  • Breaking changes in the experimental reconcile command, old versions will no longer work.

[Oso Cloud CLI] 0.16.1

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

[Oso Cloud CLI] 0.16.0

  • Breaking: Policy validation errors and warnings previously went to STDOUT. Now, they go to STDERR. Success messages still go to STDOUT.
  • Added new oso generate-types command to generate rich SDK types from your policy for use in your application. Currently we support TypeScript, with other languages coming soon.

[Local Development Binary] 1.7.0

  • Support passing in policy files as input to the local development binary, and --watch-for-changes to automatically refresh files.

[Local Development Binary] 1.6.2

  • Various improvements to Polar query evaluation, including a bug fix causing certain Local Authorization queries to fail.

[Local Development Binary] 1.6.1

Support for larger imports when used with reconcile.

[Local Development Binary] 1.6.0

Add support for breaking changes to the experimental reconcile command.

[Local Development Binary] 1.5.0

Add support for to-be-released Batch and QueryBuilder APIs.

[Local Development Binary] 1.4.1

Fix broken configuration option.

[Local Development Binary] 1.4.0

Add support for to-be-released QueryBuilder API.

[Local Development Binary] 1.3.2

Add validation for keywords used in global blocks.

[Local Development Binary] 1.3.1

Removed undocumented & no longer in-use built-in Float type.

[Local Development Binary] 1.3.0

Added endpoints supporting the distributed check api. See this guide for more info.

[Local Development Binary] 1.2.0

NOTE: Version 1.2 includes changes to the underlying data schema used by the local binary. Any existing data should be deleted + recreated before using this.

In local development, data is stored in $(pwd)/.oso by default and so we recommend deleting the .oso directory if it exists.

Additional fixes:

  • Fixes bug where local binary was not ensuring writes were persisted before returning, resulting in race conditions and inconsistent response

[NodeJS] oso-cloud 2.0.1

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

[NodeJS] oso-cloud 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 Management API docs and the migration guide for more details.

Powerful new QueryBuilder API for querying arbitrary rules in your policy

See the API docs and the migration guide for more details.

[NodeJS] oso-cloud 1.7.1

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

[NodeJS] oso-cloud 1.7.0

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

[NodeJS] oso-cloud 1.6.2

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

[NodeJS] oso-cloud 1.6.1

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

[NodeJS] oso-cloud 1.6.0

Added support for the distributed check api:

[NodeJS] oso-cloud 1.5.0

Add new oso.bulkActions() API.

[Python] oso-cloud 1.5.1

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

[Python] oso-cloud 1.5.0

  • Added new oso.actions_local() method.
  • Accept bool and int as fact args. These are converted to the appropriate Polar type.

[Python] oso-cloud 1.4.1

Update error message wording.

[Python] oso-cloud 1.4.0

Added support for the distributed check api:

[Python] oso-cloud 1.3.x

Along with support for fetching policy metadata, oso-cloud 1.3.0 introduced more specific parameter and return types for the Python client to be used with typecheckers like mypy.

Releases 1.3.1 - 1.3.3 addressed bugs or gaps found with the new types that were added.

[.NET] OsoCloud 1.6.1

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

[.NET] OsoCloud 1.6.0

  • Added new oso.ActionsLocal() method.
  • Added new Value convenience constructors for string, long, and bool.

[.NET] OsoCloud 1.5.1

  • Update error message wording.
  • Fix error when fetching missing header.

[.NET] OsoCloud 1.5.0

Added support for the distributed check api:

[Java] oso-cloud 0.5.1

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

[Java] oso-cloud 0.5.0

[Java] oso-cloud 0.4.1

Removed undocumented & no longer in-use built-in Float type.

[Java] oso-cloud 0.4.0

Added support for the distributed check api:

[Go] oso v1.7.1

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

[Go] oso v1.7.0

  • Added new oso.ActionsLocal() method.
  • Add Instance convenience constructors for Integer and Boolean

[Go] oso v1.6.1

Update error message wording.

[Go] oso v1.6.0

Added support for the distributed check api:

[Ruby] oso-cloud 1.7.1

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

[Ruby] oso-cloud 1.7.0

  • Added new oso.actions_local() method.
  • Accept true, false, and Integer values as fact args. These are converted to the appropriate Polar type.

[Ruby] oso-cloud 1.6.0

Added support for the distributed check api:

[VSCode Extension] 0.39.0

  • Removed support for the deprecated OSS library.
  • Added a dependency on the Oso Cloud CLI for Language Server Protocol support.
Explain