Skip to content

Release v5.0.0-beta.0#1153

Merged
developerkunal merged 1 commit into
v5from
release/v5.0.0-beta.0
Aug 8, 2025
Merged

Release v5.0.0-beta.0#1153
developerkunal merged 1 commit into
v5from
release/v5.0.0-beta.0

Conversation

@developerkunal
Copy link
Copy Markdown
Contributor

@developerkunal developerkunal commented Aug 8, 2025

Important: This is a beta release of the upcoming major version. It introduces breaking changes, particularly in the Management API client. Please refer to the v5 Migration Guide for detailed upgrade instructions.

💥 Breaking Changes

Node.js Version Support

  • The SDK now requires Node.js ^20.19.0, ^22.12.0, or ^24.0.0.
  • Support for earlier Node.js versions has been dropped.

Management API Client Redesign

  • The Management API client has been fully restructured using Fern for code generation.
  • Methods are now organized into modular sub-clients, improving structure and maintainability.
  • Method names and signatures have changed, adopting consistent and predictable naming conventions.
  • These changes are not backward compatible with the v4.x client.

✨ Highlights

  • Full rewrite of the Management API client using Fern
  • Stronger TypeScript support with standardized error handling and improved developer ergonomics
  • Modular sub-client architecture for better discoverability and consistency
  • The Authentication API client remains fully compatible — no breaking changes
  • Introduced a v4.x-compatible legacy client available via auth0/legacy
  • Introduced modern package exports with support for both CommonJS and ESM
  • Updated minimum Node.js requirement as noted above

📘 Migration Guide: v5_MIGRATION_GUIDE.md
🔀 Compare Changes: Full Changelog

@developerkunal developerkunal requested a review from a team as a code owner August 8, 2025 15:12
@developerkunal developerkunal merged commit 1b1f8c0 into v5 Aug 8, 2025
11 checks passed
@developerkunal developerkunal deleted the release/v5.0.0-beta.0 branch August 8, 2025 18:24
developerkunal added a commit that referenced this pull request Aug 8, 2025
developerkunal added a commit that referenced this pull request Sep 5, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant