Skip to content

Release v5.0.0#1185

Merged
developerkunal merged 5 commits into
masterfrom
release/v5.0.0
Sep 17, 2025
Merged

Release v5.0.0#1185
developerkunal merged 5 commits into
masterfrom
release/v5.0.0

Conversation

@developerkunal
Copy link
Copy Markdown
Contributor

Important: v5.0.0 is now the stable release.
It introduces breaking changes, particularly in the Management API client.
Please review 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

  • General Availability: v5 graduates from beta and is now the stable release.
  • Complete rewrite of the Management API client using Fern code generation.
  • Stronger TypeScript support with standardized error handling and improved developer ergonomics.
  • Modular sub-client architecture for better API discoverability and consistency.
  • The Authentication API client remains fully compatible — no breaking changes.
  • Optional 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

@developerkunal developerkunal requested a review from a team as a code owner September 15, 2025 18:21
frederikprijck
frederikprijck previously approved these changes Sep 15, 2025
@codecov
Copy link
Copy Markdown

codecov Bot commented Sep 15, 2025

Welcome to Codecov 🎉

Once you merge this PR into your default branch, you're all set! Codecov will compare coverage reports and display results in all future pull requests.

Thanks for integrating Codecov - We've got you covered ☂️

frederikprijck
frederikprijck previously approved these changes Sep 15, 2025
@developerkunal developerkunal changed the title Release v5.0.0 Release v5.0.0 (DO NOT MERGE) Sep 16, 2025
@developerkunal developerkunal changed the title Release v5.0.0 (DO NOT MERGE) Release v5.0.0 Sep 16, 2025
@developerkunal developerkunal changed the title Release v5.0.0 Release v5.0.0 (DO NOT MERGE) Sep 16, 2025
@developerkunal developerkunal changed the title Release v5.0.0 (DO NOT MERGE) Release v5.0.0 Sep 17, 2025
@developerkunal developerkunal merged commit 3fda381 into master Sep 17, 2025
14 checks passed
@developerkunal developerkunal deleted the release/v5.0.0 branch September 17, 2025 06:50
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.

3 participants