diff --git a/.version b/.version index 5c77d55e..9773998b 100644 --- a/.version +++ b/.version @@ -1 +1 @@ -v6.0.0.beta.5 +v6.0.0 diff --git a/CHANGELOG.md b/CHANGELOG.md index b8535646..4f23e6f0 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,5 +1,35 @@ # Change Log +## [v6.0.0](https://github.com/auth0/ruby-auth0/tree/v6.0.0) (2026-08-13) +[Full Changelog](https://github.com/auth0/ruby-auth0/compare/v5.20.0...v6.0.0) + +Note: As this is a major release it is recommended to understand the **Breaking Changes** section before upgrading. The [v6 Migration Guide](v6_MIGRATION_GUIDE.md) contains detailed upgrade instructions. + +v6.0.0 is the first stable release of the v6 line. The Management API client is now generated from Auth0's OpenAPI specification via [Fern](https://buildwithfern.com/), with strongly-typed requests and responses, built-in pagination, and automatic token management through the unified `Auth0::Client`. The Authentication API is ported from v5 and maintains full feature parity. + +**Breaking Changes** +- Management API client rewritten using Fern code generation +- `Auth0Client` replaced by `Auth0::Client` (unified client for Authentication + Management APIs; `Auth0Client` remains as a backward-compatible alias) +- Management API methods accessed via namespaced sub-clients (`client.users.list` instead of `client.users`) +- Method names follow a consistent pattern (`list`, `create`, `get`, `update`, `delete`), and sub-resource operations moved to dedicated sub-clients +- All Management API methods use keyword arguments instead of positional parameters +- API methods return strongly-typed response objects instead of raw hashes +- List methods return paginated iterators instead of arrays +- Non-2xx responses raise typed exceptions (`Auth0::Errors::NotFoundError`, etc.) instead of returning error hashes +- The `api_version` parameter has been removed (v6 supports Management API v2 only) +- `rest-client` dependency removed; uses `net/http` internally +- Minimum Ruby version raised to 3.3 + +**Added** +- Auto-generated Management API with complete endpoint coverage from Auth0's OpenAPI spec +- Automatic OAuth 2.0 client credentials token management, with a new `token_provider` option for supplying tokens from an external source +- Built-in retry with exponential backoff for transient failures (408, 429, 5xx) +- Automatic pagination through iterator objects for all list endpoints +- `v6_MIGRATION_GUIDE.md` for upgrading from v5 + +**Unchanged** +- Authentication API (login, signup, token exchange, passwordless, MFA) + ## [v6.0.0.beta.5](https://github.com/auth0/ruby-auth0/tree/v6.0.0.beta.5) (2026-08-05) [Full Changelog](https://github.com/auth0/ruby-auth0/compare/v6.0.0.beta.4...v6.0.0.beta.5) diff --git a/Gemfile.lock b/Gemfile.lock index a2c19e73..b443713f 100644 --- a/Gemfile.lock +++ b/Gemfile.lock @@ -1,7 +1,7 @@ PATH remote: . specs: - auth0 (6.0.0.beta.5) + auth0 (6.0.0) addressable (~> 2.8) jwt (>= 2.7, < 4.0) rest-client (~> 2.1) diff --git a/examples/ruby-api/Gemfile.lock b/examples/ruby-api/Gemfile.lock index 3cbd3563..61a18f88 100644 --- a/examples/ruby-api/Gemfile.lock +++ b/examples/ruby-api/Gemfile.lock @@ -1,7 +1,7 @@ PATH remote: ../.. specs: - auth0 (6.0.0.beta.5) + auth0 (6.0.0) addressable (~> 2.8) jwt (>= 2.7, < 4.0) rest-client (~> 2.1) diff --git a/lib/auth0/version.rb b/lib/auth0/version.rb index 364705d5..29b2103b 100644 --- a/lib/auth0/version.rb +++ b/lib/auth0/version.rb @@ -1,5 +1,5 @@ # frozen_string_literal: true module Auth0 - VERSION = "6.0.0.beta.5" + VERSION = "6.0.0" end