Adding v3 changes

.fernignore

@@ -0,0 +1,90 @@
+# Specify files that shouldn't be modified by Fern
+
+# README should not be overwritten as it combines both SDKs
+README.md
+
+# Examples and Migration Guide from auth0-real
+EXAMPLES.md
+v3_MIGRATION_GUIDE.md
+MIGRATION_GUIDE.md
+LICENSE
+CHANGELOG.md
+
+# Legacy management API from auth0-real
+src/main/java/com/auth0/client/legacy/
+
+# Authentication API (manually maintained from auth0-real)
+src/main/java/com/auth0/client/auth/
+src/test/java/com/auth0/client/auth/
+
+# Supporting packages from auth0-real
+src/main/java/com/auth0/net/
+src/main/java/com/auth0/exception/
+src/main/java/com/auth0/utils/
+src/main/java/com/auth0/json/auth/
+src/main/java/com/auth0/json/mgmt/
+src/main/java/com/auth0/json/ObjectMapperProvider.java
+
+# Client options from auth0-real
+src/main/java/com/auth0/client/HttpOptions.java
+src/main/java/com/auth0/client/ProxyOptions.java
+src/main/java/com/auth0/client/LoggingOptions.java
+
+# TokenProvider interface (shared between Fern-generated Management API and auth0-provided Authentication API)
+src/main/java/com/auth0/client/mgmt/TokenProvider.java
+
+# Test infrastructure from auth0-real
+src/test/java/com/auth0/net/
+src/test/java/com/auth0/exception/
+src/test/java/com/auth0/utils/
+src/test/java/com/auth0/json/
+src/test/resources/
+src/test/resources/auth/
+src/test/resources/keys/
+src/test/resources/mgmt/
+src/test/resources/mockito-extensions/
+src/test/java/com/auth0/client/legacy/
+
+# Custom client builder and examples
+src/main/java/com/auth0/client/Auth0ClientBuilder.java
+src/main/java/com/auth0/client/ClientCredentialsTokenProvider.java
+src/main/java/com/auth0/client/ManagementApiWithTokenProvider.java
+src/main/java/com/auth0/client/TokenProvider.java
+src/main/java/com/auth0/client/interceptors/
+
+# Custom OAuth client credentials support
+src/main/java/com/auth0/client/mgmt/core/RequestOptions.java
+src/main/java/com/auth0/client/mgmt/core/ClientOptions.java
+src/main/java/com/auth0/client/mgmt/core/OAuthTokenSupplier.java
+src/main/java/com/auth0/client/mgmt/core/OAuthTokenException.java
+
+# Custom builder with domain-based initialization
+src/main/java/com/auth0/client/mgmt/ManagementApiBuilder.java
+
+# Custom tests
+src/test/java/com/auth0/client/mgmt/DynamicTokenManagementTest.java
+src/test/java/com/auth0/client/mgmt/OAuthTokenSupplierTest.java
+src/test/java/com/auth0/client/mgmt/ManagementApiBuilderTest.java
+
+# Configuration files from auth0-real
+.codecov.yml
+.editorconfig
+.semgrepignore
+.shiprc
+.snyk
+.version
+opslevel.yml
+.fern/
+
+# GitHub workflows
+.github/
+
+# Build files and configs
+gradle/
+gradlew
+gradlew.bat
+gradle.properties
+settings.gradle
+build.gradle
+sample-app/
+

.github/workflows/build-and-test.yml

@@ -4,7 +4,7 @@ on:
   pull_request:
   merge_group:
   push:
-    branches: ["master", "main", "v1"]
+    branches: ["master", "main", "v3"]
 
 jobs:
   gradle:
@@ -19,8 +19,8 @@ jobs:
       - name: Set up Gradle
         uses: gradle/actions/setup-gradle@4d9f0ba0025fe599b4ebab900eb7f3a1d93ef4c2 # v5.0.0
 
-      - name: Test and Assemble and ApiDiff with Gradle
-        run: ./gradlew assemble apiDiff check jacocoTestReport --continue --console=plain
+      - name: Test and Assemble with Gradle
+        run: ./gradlew assemble check --continue --console=plain
 
       - uses: codecov/codecov-action@5a1091511ad55cbe89839c7260b706298ca349f7 # v5.5.1
         with:

.github/workflows/rl-scanner.yml

@@ -42,8 +42,8 @@ jobs:
       - name: Set up Gradle
         uses: gradle/actions/setup-gradle@4d9f0ba0025fe599b4ebab900eb7f3a1d93ef4c2 # v5.0.0
 
-      - name: Test and Assemble and ApiDiff with Gradle
-        run: ./gradlew assemble apiDiff check jacocoTestReport --continue --console=plain
+      - name: Test and Assemble with Gradle
+        run: ./gradlew assemble check --continue --console=plain
 
       - id: get_version
         uses: ./.github/actions/get-version

.gitignore

@@ -1,122 +1,24 @@
-bin/
-
-# Created by https://www.gitignore.io/api/java,gradle,osx,windows,intellij+iml
-
-### OSX ###
-*.DS_Store
-.AppleDouble
-.LSOverride
-
-# Icon must end with two \r
-Icon
-# Thumbnails
-._*
-# Files that might appear in the root of a volume
-.DocumentRevisions-V100
-.fseventsd
-.Spotlight-V100
-.TemporaryItems
-.Trashes
-.VolumeIcon.icns
-.com.apple.timemachine.donotpresent
-# Directories potentially created on remote AFP share
-.AppleDB
-.AppleDesktop
-Network Trash Folder
-Temporary Items
-.apdisk
-
-
-### Windows ###
-# Windows thumbnail cache files
-Thumbs.db
-ehthumbs.db
-ehthumbs_vista.db
-
-# Folder config file
-Desktop.ini
-
-# Recycle Bin used on file shares
-$RECYCLE.BIN/
-
-# Windows Installer files
-*.cab
-*.msi
-*.msm
-*.msp
-
-# Windows shortcuts
-*.lnk
-
-
-### Java ###
 *.class
-
-# BlueJ files
-*.ctxt
-
-# Mobile Tools for Java (J2ME)
-.mtj.tmp/
-
-# Package Files #
-*.jar
-*.war
-*.ear
-
-# virtual machine crash logs, see http://www.java.com/en/download/help/error_hotspot.xml
-hs_err_pid*
-
-
-### Gradle ###
+.project
 .gradle
-/build/
-
-# Ignore Gradle GUI config
-gradle-app.setting
-
-# Avoid ignoring Gradle wrapper jar file (.jar files are usually ignored)
-!gradle-wrapper.jar
-
-# Cache of project
-.gradletasknamecache
-
-# # Work around https://youtrack.jetbrains.com/issue/IDEA-116898
-# gradle/wrapper/gradle-wrapper.properties
-
-# End of https://www.gitignore.io/api/java,gradle,osx,windows
-
-
-### Intellij+iml ###
-# Covers JetBrains IDEs: IntelliJ, RubyMine, PhpStorm, AppCode, PyCharm, CLion, Android Studio and Webstorm
-# Reference: https://intellij-support.jetbrains.com/hc/en-us/articles/206544839
-
-# User-specific stuff:
-.idea/workspace.xml
-.idea/tasks.xml
-
-# Sensitive or high-churn files:
-.idea/
-
-# Gradle:
-.idea/gradle.xml
-.idea/libraries
-
-# Mongo Explorer plugin:
-.idea/mongoSettings.xml
-
-## File-based project format:
-*.iws
-
-### Intellij+iml Patch ###
-# Reason: https://github.com/joeblau/gitignore.io/issues/186#issuecomment-249601023
-
+?
+.classpath
+.checkstyle
+.settings
+.node
+build
+
+# IntelliJ
 *.iml
-modules.xml
-.idea/misc.xml
 *.ipr
-/out/
+*.iws
+.idea/
+out/
 
-# End of https://www.gitignore.io/api/intellij+iml
+# Eclipse/IntelliJ APT
+generated_src/
+generated_testSrc/
+generated/
 
-# NetBeans IDE files
-/.nb-gradle/
+bin
+build

.version

@@ -1 +1 @@
-2.27.0
+3.0.0-beta.0

CHANGELOG.md

@@ -1,5 +1,20 @@
 # Change Log
 
+## [3.0.0-beta.0](https://github.com/auth0/auth0-java/tree/3.0.0-beta.0) (2025-12-18)
+[Full Changelog](https://github.com/auth0/auth0-java/compare/2.27.0...3.0.0-beta.0)
+
+> **Warning** This SDK is in beta and is subject to breaking changes. It is not recommended for production use, but your feedback and help in testing is appreciated!
+
+**Added**
+- Complete rewrite of the **Management API client** using Fern code generation
+- Update OkHttp to 5.2.1
+- API attributes can set null for patch operations
+- Nullability annotations to POJO classes
+- Fully compatible **Authentication API client** — no breaking changes
+
+- [Migration guide](MIGRATION_GUIDE) available for upgrading from v2.x
+
+
 ## [2.27.0](https://github.com/auth0/auth0-java/tree/2.27.0) (2025-12-18)
 [Full Changelog](https://github.com/auth0/auth0-java/compare/2.26.0...2.27.0)
 
@@ -160,7 +175,7 @@
 
 **Added**
 - Support organization in client credentials [\#582](https://github.com/auth0/auth0-java/pull/582) ([jimmyjames](https://github.com/jimmyjames))
- 
+
 # [2.8.0](https://github.com/auth0/auth0-java/tree/2.8.0) (2023-11-07)
 [Full Changelog](https://github.com/auth0/auth0-java/compare/2.7.0...2.8.0)
 
@@ -218,7 +233,7 @@
 [Full Changelog](https://github.com/auth0/auth0-java/compare/2.1.0...2.2.0)
 
 **Added**
-- Add support for client credential management [\#525](https://github.com/auth0/auth0-java/pull/525) ([jimmyjames](https://github.com/jimmyjames)) 
+- Add support for client credential management [\#525](https://github.com/auth0/auth0-java/pull/525) ([jimmyjames](https://github.com/jimmyjames))
 
 **Fixed**
 - Fix headers to lowercase [\#528](https://github.com/auth0/auth0-java/pull/528) ([alexz75](https://github.com/alexz75))
@@ -228,7 +243,7 @@
 [Full Changelog](https://github.com/auth0/auth0-java/compare/2.0.0...2.1.0)
 
 **Added**
-- Add missing LogEvent fields [\#521](https://github.com/auth0/auth0-java/pull/521) ([jimmyjames](https://github.com/jimmyjames)) 
+- Add missing LogEvent fields [\#521](https://github.com/auth0/auth0-java/pull/521) ([jimmyjames](https://github.com/jimmyjames))
 
 **Changed**
 - authentication_methods is an object, not a string [\#520](https://github.com/auth0/auth0-java/pull/520) ([jimmyjames](https://github.com/jimmyjames))
@@ -247,7 +262,6 @@
 - ... and more!
 
 As a major version release, 2.0.0 does include breaking changes.
-Please see the [Migration Guide](MIGRATION_GUIDE.md) for additional details as well as guidance for updating your application.
 
 ## [2.0.0 Beta 2](https://github.com/auth0/auth0-java/tree/2.0.0-beta.2) (2023-02-13)
 [Full Changelog](https://github.com/auth0/auth0-java/compare/2.0.0-beta.1...2.0.0-beta.2)
@@ -274,8 +288,6 @@ This release introduces several enhancement, including:
 - Authentication API improvements to not require a client secret
 - ... and more!
 
-Please see the [Migration Guide](MIGRATION_GUIDE.md) for guidance on updating your application.
-
 ## [1.44.2](https://github.com/auth0/auth0-java/tree/1.44.2) (2023-01-11)
 [Full Changelog](https://github.com/auth0/auth0-java/compare/1.44.1...1.44.2)
 
@@ -839,18 +851,17 @@ ManagementAPI mgmt = new ManagementAPI("{YOUR_DOMAIN}", "{YOUR_API_TOKEN}");
 
 The Management API is divided into different entities. Each of them have the list, create, update, delete and update methods plus a few more if corresponds. The calls are authenticated using the API Token given in the `ManagementAPI` instance creation and must contain the `scope` required by each entity. See the javadoc for details on which `scope` is expected for each call.
 
-* **Client Grants:** See [Docs](https://auth0.com/docs/api/management/v2#!/Client_Grants/get_client_grants). Access the methods by calling `mgmt.clientGrants()`. 
-* **Clients:** See [Docs](https://auth0.com/docs/api/management/v2#!/Clients/get_clients). Access the methods by calling `mgmt.clients()`. 
-* **Connections:** See [Docs](https://auth0.com/docs/api/management/v2#!/Connections/get_connections). Access the methods by calling `mgmt.connections()`. 
-* **Device Credentials:** See [Docs](https://auth0.com/docs/api/management/v2#!/Device_Credentials/get_device_credentials). Access the methods by calling `mgmt.deviceCredentials()`. 
-* **Logs:** See [Docs](https://auth0.com/docs/api/management/v2#!/Logs/get_logs). Access the methods by calling `mgmt.logEvents()`. 
-* **Rules:** See [Docs](https://auth0.com/docs/api/management/v2#!/Rules/get_rules). Access the methods by calling `mgmt.rules()`. 
-* **User Blocks:** See [Docs](https://auth0.com/docs/api/management/v2#!/User_Blocks/get_user_blocks). Access the methods by calling `mgmt.userBlocks()`. 
-* **Users:** See [Docs](https://auth0.com/docs/api/management/v2#!/Users/get_users). Access the methods by calling `mgmt.users()`. 
-* **Blacklists:** See [Docs](https://auth0.com/docs/api/management/v2#!/Blacklists/get_tokens). Access the methods by calling `mgmt.blacklists()`. 
-* **Emails:** See [Docs](https://auth0.com/docs/api/management/v2#!/Emails/get_provider). Access the methods by calling `mgmt.emailProvider()`. 
-* **Guardian:** See [Docs](https://auth0.com/docs/api/management/v2#!/Guardian/get_factors). Access the methods by calling `mgmt.guardian()`. 
-* **Stats:** See [Docs](https://auth0.com/docs/api/management/v2#!/Stats/get_active_users). Access the methods by calling `mgmt.stats()`. 
-* **Tenants:** See [Docs](https://auth0.com/docs/api/management/v2#!/Tenants/get_settings). Access the methods by calling `mgmt.tenants()`. 
+* **Client Grants:** See [Docs](https://auth0.com/docs/api/management/v2#!/Client_Grants/get_client_grants). Access the methods by calling `mgmt.clientGrants()`.
+* **Clients:** See [Docs](https://auth0.com/docs/api/management/v2#!/Clients/get_clients). Access the methods by calling `mgmt.clients()`.
+* **Connections:** See [Docs](https://auth0.com/docs/api/management/v2#!/Connections/get_connections). Access the methods by calling `mgmt.connections()`.
+* **Device Credentials:** See [Docs](https://auth0.com/docs/api/management/v2#!/Device_Credentials/get_device_credentials). Access the methods by calling `mgmt.deviceCredentials()`.
+* **Logs:** See [Docs](https://auth0.com/docs/api/management/v2#!/Logs/get_logs). Access the methods by calling `mgmt.logEvents()`.
+* **Rules:** See [Docs](https://auth0.com/docs/api/management/v2#!/Rules/get_rules). Access the methods by calling `mgmt.rules()`.
+* **User Blocks:** See [Docs](https://auth0.com/docs/api/management/v2#!/User_Blocks/get_user_blocks). Access the methods by calling `mgmt.userBlocks()`.
+* **Users:** See [Docs](https://auth0.com/docs/api/management/v2#!/Users/get_users). Access the methods by calling `mgmt.users()`.
+* **Blacklists:** See [Docs](https://auth0.com/docs/api/management/v2#!/Blacklists/get_tokens). Access the methods by calling `mgmt.blacklists()`.
+* **Emails:** See [Docs](https://auth0.com/docs/api/management/v2#!/Emails/get_provider). Access the methods by calling `mgmt.emailProvider()`.
+* **Guardian:** See [Docs](https://auth0.com/docs/api/management/v2#!/Guardian/get_factors). Access the methods by calling `mgmt.guardian()`.
+* **Stats:** See [Docs](https://auth0.com/docs/api/management/v2#!/Stats/get_active_users). Access the methods by calling `mgmt.stats()`.
+* **Tenants:** See [Docs](https://auth0.com/docs/api/management/v2#!/Tenants/get_settings). Access the methods by calling `mgmt.tenants()`.
 * **Tickets:** See [Docs](https://auth0.com/docs/api/management/v2#!/Tickets/post_email_verification). Access the methods by calling `mgmt.tickets()`. 
-

LICENSE

@@ -18,4 +18,4 @@ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
 AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+SOFTWARE.