fix: warn when client prop is used with domain/clientId

Author: yogeshchoudhary147

__tests__/auth-provider.test.tsx

@@ -155,6 +155,31 @@ describe('Auth0Provider', () => {
     );
   });
 
+  it('should warn when client prop is used alongside domain or clientId', async () => {
+    const warn = jest.spyOn(console, 'warn').mockImplementation(() => undefined);
+    const wrapper = createWrapper({ client: clientMock, domain: 'foo', clientId: 'bar' } as any);
+    renderHook(() => useContext(Auth0Context), { wrapper });
+    await waitFor(() => {
+      expect(warn).toHaveBeenCalledWith(
+        expect.stringContaining('the `client` prop takes precedence')
+      );
+    });
+    warn.mockRestore();
+  });
+
+  it('should not warn when only client prop is provided', async () => {
+    const warn = jest.spyOn(console, 'warn').mockImplementation(() => undefined);
+    const wrapper = createWrapper({ client: clientMock });
+    renderHook(() => useContext(Auth0Context), { wrapper });
+    await waitFor(() => {
+      expect(clientMock.checkSession).toHaveBeenCalled();
+    });
+    expect(warn).not.toHaveBeenCalledWith(
+      expect.stringContaining('the `client` prop takes precedence')
+    );
+    warn.mockRestore();
+  });
+
   it('should check session when logged out', async () => {
     const wrapper = createWrapper();
     const { result } = renderHook(

src/auth0-provider.tsx

@@ -198,6 +198,13 @@ const Auth0Provider = <TUser extends User = User>(opts: Auth0ProviderOptions<TUs
     client: providedClient,
     ...clientOpts
   } = opts as Auth0ProviderBaseOptions<TUser> & Auth0ClientOptions & { client?: Auth0Client };
+  if (providedClient && (clientOpts.domain || clientOpts.clientId)) {
+    console.warn(
+      'Auth0Provider: the `client` prop takes precedence over `domain`/`clientId` and other ' +
+      'configuration options. Remove `domain`, `clientId`, and any other Auth0Client configuration ' +
+      'props when using the `client` prop.'
+    );
+  }
   const [client] = useState(
     () => providedClient ?? new Auth0Client(toAuth0ClientOptions(clientOpts))
   );