refactor!: rename androidNetworkingOptions to networkingOptions

Every other platform-specific option on Auth0Options (maxRetries,
credentialsManagerStorageKey) documents its platform restriction via
@remarks rather than baking the platform name into the identifier.
androidNetworkingOptions was the one exception. Since v6 hasn't shipped
yet, rename it now while it's free, ahead of adding iOS networking
config under its own umbrella later.

Author: NandanPrabhu

EXAMPLES.md

@@ -644,10 +644,10 @@ function MyComponent() {
 
 > **Platform Support:** Android only. Accepted on iOS for API compatibility but has no effect.
 
-The `androidNetworkingOptions` configuration option lets you tune the native networking client (`DefaultClient` from Auth0.Android's OkHttp-based stack) used for every request the native SDK makes on your behalf — web auth token exchange, credential renewal, MFA, passkeys, and My Account API calls.
+The `networkingOptions` configuration option lets you tune the native networking client (`DefaultClient` from Auth0.Android's OkHttp-based stack) used for every request the native SDK makes on your behalf — web auth token exchange, credential renewal, MFA, passkeys, and My Account API calls.
 
 ```ts
-androidNetworkingOptions?: {
+networkingOptions?: {
   connectTimeout?: number; // seconds, default 10
   readTimeout?: number; // seconds, default 10
   writeTimeout?: number; // seconds, default 10
@@ -673,7 +673,7 @@ function App() {
     <Auth0Provider
       domain="YOUR_AUTH0_DOMAIN"
       clientId="YOUR_AUTH0_CLIENT_ID"
-      androidNetworkingOptions={{
+      networkingOptions={{
         connectTimeout: 30,
         readTimeout: 30,
         defaultHeaders: { 'X-App-Version': '1.2.3' },
@@ -693,7 +693,7 @@ import Auth0 from 'react-native-auth0';
 const auth0 = new Auth0({
   domain: 'YOUR_AUTH0_DOMAIN',
   clientId: 'YOUR_AUTH0_CLIENT_ID',
-  androidNetworkingOptions: {
+  networkingOptions: {
     connectTimeout: 30,
     readTimeout: 30,
   },

android/src/main/java/com/auth0/react/A0Auth0Module.kt

@@ -93,10 +93,10 @@ class A0Auth0Module(private val reactContext: ReactApplicationContext) : A0Auth0
         // config, so this always resolves to a fresh DefaultClient() when options are absent
         // rather than leaving the previous networkingClient in place.
         internal fun resolveNetworkingClient(
-            androidNetworkingOptions: ReadableMap?,
+            networkingOptions: ReadableMap?,
             isDebuggable: Boolean
         ): DefaultClient =
-            androidNetworkingOptions?.let { buildNetworkingClient(it, isDebuggable) } ?: DefaultClient()
+            networkingOptions?.let { buildNetworkingClient(it, isDebuggable) } ?: DefaultClient()
     }
 
     private val errorCodeMap = mapOf(
@@ -315,7 +315,7 @@ class A0Auth0Module(private val reactContext: ReactApplicationContext) : A0Auth0
         useDPoP: Boolean?,
         maxRetries: Double,
         credentialsManagerStorageKey: String?,
-        androidNetworkingOptions: ReadableMap?,
+        networkingOptions: ReadableMap?,
         promise: Promise
     ) {
         // Note: maxRetries parameter is ignored on Android as the Auth0.Android SDK
@@ -326,7 +326,7 @@ class A0Auth0Module(private val reactContext: ReactApplicationContext) : A0Auth0
         val auth0Instance = Auth0.getInstance(clientId, domain)
         auth0 = auth0Instance
         val isDebuggable = (reactContext.applicationInfo.flags and ApplicationInfo.FLAG_DEBUGGABLE) != 0
-        auth0Instance.networkingClient = resolveNetworkingClient(androidNetworkingOptions, isDebuggable)
+        auth0Instance.networkingClient = resolveNetworkingClient(networkingOptions, isDebuggable)
         mfaClient = MfaClient(auth0Instance, this.useDPoP, reactContext)
         myAccount = MyAccount(auth0Instance, this.useDPoP, reactContext)
         passwordless = Passwordless(auth0Instance, this.useDPoP, reactContext)

android/src/test/java/com/auth0/react/A0Auth0ModuleNetworkingOptionsTest.kt

@@ -14,7 +14,7 @@ import java.io.IOException
 import java.util.concurrent.TimeUnit
 import kotlin.system.measureTimeMillis
 
-// Proves that A0Auth0Module.buildNetworkingClient() genuinely threads androidNetworkingOptions
+// Proves that A0Auth0Module.buildNetworkingClient() genuinely threads networkingOptions
 // into the DefaultClient it builds, rather than just compiling. Exercises the client against a
 // real (local) server so the OkHttp timeout machinery actually runs.
 class A0Auth0ModuleNetworkingOptionsTest {
@@ -33,7 +33,7 @@ class A0Auth0ModuleNetworkingOptionsTest {
     }
 
     @Test
-    fun `readTimeout from androidNetworkingOptions is applied to the built DefaultClient`() {
+    fun `readTimeout from networkingOptions is applied to the built DefaultClient`() {
         val configuredTimeoutSeconds = 1
         // Stall the response well past the configured timeout.
         server.enqueue(MockResponse().setHeadersDelay(3, TimeUnit.SECONDS).setBody("{}"))
@@ -62,7 +62,7 @@ class A0Auth0ModuleNetworkingOptionsTest {
     }
 
     @Test
-    fun `defaultHeaders from androidNetworkingOptions are sent on every request`() {
+    fun `defaultHeaders from networkingOptions are sent on every request`() {
         server.enqueue(MockResponse().setBody("{}"))
 
         val client = A0Auth0Module.buildNetworkingClient(
@@ -103,7 +103,7 @@ class A0Auth0ModuleNetworkingOptionsTest {
             isDebuggable = true
         )
 
-        // Re-initialization with the same clientId/domain but androidNetworkingOptions omitted
+        // Re-initialization with the same clientId/domain but networkingOptions omitted
         // must not carry the previous readTimeout forward - it should behave like a fresh
         // DefaultClient() (10s default readTimeout).
         val reset = A0Auth0Module.resolveNetworkingClient(null, isDebuggable = true)

ios/A0Auth0.mm

@@ -100,10 +100,10 @@ - (dispatch_queue_t)methodQueue
                                   useDPoP:(nonnull NSNumber *)useDPoP
                                maxRetries:(double)maxRetries
             credentialsManagerStorageKey:(NSString * _Nullable)credentialsManagerStorageKey
-                  androidNetworkingOptions:(NSDictionary * _Nullable)androidNetworkingOptions
+                  networkingOptions:(NSDictionary * _Nullable)networkingOptions
                                  resolve:(RCTPromiseResolveBlock)resolve
                                   reject:(RCTPromiseRejectBlock)reject) {
-    // androidNetworkingOptions is Android-only; intentionally not forwarded to NativeBridge.
+    // networkingOptions is Android-only; intentionally not forwarded to NativeBridge.
     [self tryAndInitializeNativeBridge:clientId domain:domain withLocalAuthenticationOptions:localAuthenticationOptions useDPoP:useDPoP maxRetries:(NSInteger)maxRetries credentialsManagerStorageKey:credentialsManagerStorageKey resolve:resolve reject:reject];
 }
 

src/core/utils/__tests__/configSignature.spec.ts

@@ -85,28 +85,28 @@ describe('getConfigSignature', () => {
     );
   });
 
-  it('differs when androidNetworkingOptions changes', () => {
+  it('differs when networkingOptions changes', () => {
     expect(
       getConfigSignature({
         ...base,
-        androidNetworkingOptions: { connectTimeout: 10 },
+        networkingOptions: { connectTimeout: 10 },
       })
     ).not.toBe(
       getConfigSignature({
         ...base,
-        androidNetworkingOptions: { connectTimeout: 30 },
+        networkingOptions: { connectTimeout: 30 },
       })
     );
   });
 
-  it('is insensitive to androidNetworkingOptions key order', () => {
+  it('is insensitive to networkingOptions key order', () => {
     const a = getConfigSignature({
       ...base,
-      androidNetworkingOptions: { connectTimeout: 10, readTimeout: 20 },
+      networkingOptions: { connectTimeout: 10, readTimeout: 20 },
     });
     const b = getConfigSignature({
       ...base,
-      androidNetworkingOptions: { readTimeout: 20, connectTimeout: 10 },
+      networkingOptions: { readTimeout: 20, connectTimeout: 10 },
     });
     expect(a).toBe(b);
   });

src/core/utils/configSignature.ts

@@ -9,7 +9,7 @@ const SIGNIFICANT_KEYS = [
   'useDPoP',
   'maxRetries',
   'credentialsManagerStorageKey',
-  'androidNetworkingOptions',
+  'networkingOptions',
 ] as const satisfies ReadonlyArray<keyof Auth0Options>;
 
 // Stable, order-independent identity string for a config: keys the factory cache, the provider memo, and the native re-init decision. Object values are sorted so key order doesn't matter.

src/platforms/native/adapters/NativeAuth0Client.ts

@@ -109,7 +109,7 @@ export class NativeAuth0Client implements Auth0Client {
       useDPoP = false,
       maxRetries,
       credentialsManagerStorageKey,
-      androidNetworkingOptions,
+      networkingOptions,
     } = options;
     // Re-init when domain/clientId differ (hasValidInstance) or any other
     // identity option drifted from what was last applied to the native side.
@@ -127,7 +127,7 @@ export class NativeAuth0Client implements Auth0Client {
         useDPoP,
         maxRetries,
         credentialsManagerStorageKey,
-        androidNetworkingOptions
+        networkingOptions
       );
     }
     // Record even on the skip path so siblings differing only in a

src/platforms/native/adapters/__tests__/NativeAuth0Client.spec.ts

@@ -121,7 +121,7 @@ describe('NativeAuth0Client', () => {
       false, // useDPoP defaults to false
       undefined, // maxRetries not provided
       undefined, // credentialsManagerStorageKey not provided
-      undefined // androidNetworkingOptions not provided
+      undefined // networkingOptions not provided
     );
 
     // Use client to avoid unused variable warning
@@ -166,20 +166,20 @@ describe('NativeAuth0Client', () => {
       false, // useDPoP defaults to false
       undefined, // maxRetries not provided
       undefined, // credentialsManagerStorageKey not provided
-      undefined // androidNetworkingOptions not provided
+      undefined // networkingOptions not provided
     );
 
     // Use client to avoid unused variable warning
     expect(client).toBeDefined();
   });
 
-  it('should pass androidNetworkingOptions to initialize when provided', async () => {
+  it('should pass networkingOptions to initialize when provided', async () => {
     mockBridgeInstance.hasValidInstance.mockResolvedValue(false);
-    const androidNetworkingOptions = { connectTimeout: 30, readTimeout: 30 };
+    const networkingOptions = { connectTimeout: 30, readTimeout: 30 };
 
     const client = new NativeAuth0Client({
       ...options,
-      androidNetworkingOptions,
+      networkingOptions,
     });
     await new Promise(process.nextTick);
 
@@ -190,7 +190,7 @@ describe('NativeAuth0Client', () => {
       false,
       undefined,
       undefined,
-      androidNetworkingOptions
+      networkingOptions
     );
 
     expect(client).toBeDefined();

src/platforms/native/bridge/NativeBridge.ts

@@ -9,7 +9,7 @@ import type {
   MfaEnrollmentChallenge,
   MfaChallengeResult,
   PasskeyChallengeResponse,
-  AndroidNetworkingOptions,
+  NetworkingOptions,
 } from '../../../types';
 import type {
   LocalAuthenticationOptions,
@@ -40,7 +40,7 @@ export interface NativeBridge {
    * @param useDPoP Whether to enable DPoP (Demonstrating Proof-of-Possession) for token requests.
    * @param maxRetries The maximum number of retry attempts for transient errors during credential renewal. **iOS only** - ignored on Android. Defaults to 0.
    * @param credentialsManagerStorageKey Namespaces the credentials store. **Android only** SharedPreferences file name. **iOS only** Keychain service name. Defaults to the shared store when omitted.
-   * @param androidNetworkingOptions Configures the native networking client. **Android only** - ignored on iOS.
+   * @param networkingOptions Configures the native networking client. **Android only** - ignored on iOS.
    */
   initialize(
     clientId: string,
@@ -49,7 +49,7 @@ export interface NativeBridge {
     useDPoP?: boolean,
     maxRetries?: number,
     credentialsManagerStorageKey?: string,
-    androidNetworkingOptions?: AndroidNetworkingOptions
+    networkingOptions?: NetworkingOptions
   ): Promise<void>;
 
   /**

src/platforms/native/bridge/NativeBridgeManager.ts

@@ -11,7 +11,7 @@ import type {
   MfaEnrollmentChallenge,
   MfaChallengeResult,
   PasskeyChallengeResponse,
-  AndroidNetworkingOptions,
+  NetworkingOptions,
 } from '../../../types';
 import {
   SafariViewControllerPresentationStyle,
@@ -62,7 +62,7 @@ export class NativeBridgeManager implements NativeBridge {
     useDPoP: boolean = false,
     maxRetries: number = 0,
     credentialsManagerStorageKey?: string,
-    androidNetworkingOptions?: AndroidNetworkingOptions
+    networkingOptions?: NetworkingOptions
   ): Promise<void> {
     // This is a new method we'd add to the native side to ensure the
     // underlying Auth0.swift/Auth0.android SDKs are configured.
@@ -76,7 +76,7 @@ export class NativeBridgeManager implements NativeBridge {
       useDPoP,
       maxRetries,
       credentialsManagerStorageKey,
-      androidNetworkingOptions
+      networkingOptions
     );
   }