Merge branch 'main' into main

Author: pmathew92

EXAMPLES.md

@@ -1288,12 +1288,9 @@ account.networkingClient = netClient
   <summary>Using Java</summary>
 
 ```java
-DefaultClient netClient = new DefaultClient(
-   connectTimeout = 30,
-   readTimeout = 30
-);
+DefaultClient netClient = new DefaultClient(30, 30);
 Auth0 account = Auth0.getInstance("client id", "domain");
-account.networkingClient = netClient;
+account.setNetworkingClient(netClient);
 ```
 </details>
 
@@ -1312,11 +1309,13 @@ account.networkingClient = netClient
   <summary>Using Java</summary>
 
 ```java
+import java.util.HashMap;
+
 DefaultClient netClient = new DefaultClient(
-    enableLogging = true
+        10, 10, new HashMap<>() ,true
 );
 Auth0 account = Auth0.getInstance("client id", "domain");
-account.networkingClient = netClient;
+account.setNetworkingClient(netClient);
 ```
 </details>
 
@@ -1339,10 +1338,10 @@ Map<String, String> defaultHeaders = new HashMap<>();
 defaultHeaders.put("{HEADER-NAME}", "{HEADER-VALUE}");
 
 DefaultClient netClient = new DefaultClient(
-    defaultHeaders = defaultHeaders
+        10,10 , defaultHeaders
 );
 Auth0 account = Auth0.getInstance("client id", "domain");
-account.networkingClient = netClient;
+account.setNetworkingClient(netClient);
 ```
 </details>
 
@@ -1376,7 +1375,7 @@ class CustomNetClient extends NetworkingClient {
       ServerResponse response = // ...
 
       // Return a ServerResponse from the received response data
-      return ServerResponse(responseCode, responseBody, responseHeaders)
+      return new ServerResponse(responseCode, responseBody, responseHeaders);
    }  
 };
 

README.md

@@ -197,6 +197,8 @@ The callback will get invoked when the user returns to your application. There a
 
 ##### A note about App Deep Linking:
 
+> Whenever possible, Auth0 recommends using [Android App Links](https://auth0.com/docs/applications/enable-android-app-links) as a secure way to link directly to content within your app. Custom URL schemes can be subject to [client impersonation attacks](https://datatracker.ietf.org/doc/html/rfc8252#section-8.6).
+
 If you followed the configuration steps documented here, you may have noticed the default scheme used for the Callback URI is `https`. This works best for Android API 23 or newer if you're using [Android App Links](https://auth0.com/docs/applications/enable-android-app-links), but in previous Android versions this _may_ show the intent chooser dialog prompting the user to choose either your application or the browser. You can change this behaviour by using a custom unique scheme so that the OS opens directly the link with your app.
 
 1. Update the `auth0Scheme` Manifest Placeholder on the `app/build.gradle` file or update the intent-filter declaration in the `AndroidManifest.xml` to use the new scheme.

auth0/src/main/java/com/auth0/android/request/DefaultClient.kt

@@ -37,6 +37,7 @@ public class DefaultClient @VisibleForTesting(otherwise = VisibleForTesting.PRIV
      * @param defaultHeaders any headers that should be sent on all requests. If a specific request specifies a header with the same key as any header in the default headers, the header specified on the request will take precedence. Default is an empty map.
      * @param enableLogging whether HTTP request and response info should be logged. This should only be set to `true` for debugging purposes in non-production environments, as sensitive information is included in the logs. Defaults to `false`.
      */
+    @JvmOverloads
     public constructor(
         connectTimeout: Int = DEFAULT_TIMEOUT_SECONDS,
         readTimeout: Int = DEFAULT_TIMEOUT_SECONDS,