Release v2.0.0-beta.0

[developerkunal]

Auth0 Go SDK v2.0.0-beta.0 🚀

⚠️ BREAKING CHANGES - Major Rewrite

This is a complete rewrite of the Auth0 Go SDK generated from OpenAPI specifications with significant improvements and breaking changes.

🎯 What's New

• 🔧 OpenAPI-Generated: Complete rewrite generated from Auth0's OpenAPI specifications
• 📦 Better Organization: Hierarchical package structure with logical subpackages
• 🛡️ Type Safety: Strongly typed request/response objects replace generic interfaces
• ✨ Enhanced Developer Experience: Better IntelliSense, code completion, and documentation
• 🚀 Future-Proof: Easier maintenance and updates as Auth0's API evolves

💥 Breaking Changes

Change	v1	v2
Module Import	github.com/auth0/go-auth0	github.com/auth0/go-auth0/v2
Initialization	management.New()	client.New()
Manager Access	mgmt.User.List()	mgmt.Users.List()
Request Types	Generic &management.Client{}	Specific &management.CreateClientRequestContent{}
Configuration	String options	Typed option.RequestOption

📝 Quick Migration Example

Before (v1):

import "github.com/auth0/go-auth0/management"

mgmt, err := management.New(domain,
    management.WithClientCredentials(ctx, clientID, clientSecret))

client := &management.Client{
    Name: auth0.String("My App"),
    AppType: auth0.String("spa"),
}
err := mgmt.Client.Create(ctx, client)

After (v2):

import (
    "github.com/auth0/go-auth0/v2/management"
    "github.com/auth0/go-auth0/v2/management/client"
    "github.com/auth0/go-auth0/v2/option"
)

mgmt, err := client.New("your-domain.auth0.com",
    option.WithClientCredentials(ctx, clientID, clientSecret))

request := &management.CreateClientRequestContent{
    Name: "My App",
    AppType: &management.ClientAppTypeEnumSpa,
}
response, err := mgmt.Clients.Create(ctx, request)

🔧 Migration Steps

1. Update imports: Change to github.com/auth0/go-auth0/v2
2. Client initialization: Use client.New() with new option pattern
3. Manager names: mgmt.User → mgmt.Users, mgmt.Client → mgmt.Clients
4. Request objects: Use specific request types instead of generic structs
5. Type safety: Use provided enums instead of string literals

✅ What's NOT Affected

The authentication package remains unchanged! All authentication APIs work the same way between v1 and v2.

📚 Resources

• Migration Guide: Detailed migration instructions
• Full Changelog: Complete list of changes
• Documentation: Updated examples and API reference

⚠️ Beta Release

This is a beta release. While core functionality is stable, minor API adjustments may occur before the final v2.0.0 release. Please test thoroughly and provide feedback!

---

Install: go get github.com/auth0/go-auth0/v2

[codecov-commenter]

Codecov Report

✅ All modified and coverable lines are covered by tests.
⚠️ Please upload report for BASE (v2@434e794). Learn more about missing BASE report.

Additional details and impacted files

@@         Coverage Diff          @@
##             v2    #601   +/-   ##
====================================
  Coverage      ?   2.02%           
====================================
  Files         ?     287           
  Lines         ?   83610           
  Branches      ?       0           
====================================
  Hits          ?    1690           
  Misses        ?   81806           
  Partials      ?     114           

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

[arpit-jn]

LGTM