feat(hook): add new create user hook

src/hooks/__tests__/use-auth0.spec.jsx

@@ -67,6 +67,7 @@ const mockAuth0 = {
     passwordRealm: jest.fn().mockResolvedValue(mockCredentials),
     exchangeNativeSocial: jest.fn().mockResolvedValue(mockCredentials),
     revoke: jest.fn().mockResolvedValue(mockCredentials),
+    createUser: jest.fn(),
   },
   credentialsManager: {
     getCredentials: jest.fn().mockResolvedValue(mockCredentials),
@@ -114,6 +115,11 @@ describe('The useAuth0 hook', () => {
     expect(result.current.cancelWebAuth()).toBeDefined();
   });
 
+  it('defines createUser', () => {
+    const { result } = renderHook(() => useAuth0());
+    expect(result.current.createUser).toBeDefined();
+  });
+
   it('isLoading is true until initialization finishes', async () => {
     const { result } = renderHook(() => useAuth0(), {
       wrapper,
@@ -1215,6 +1221,57 @@ describe('The useAuth0 hook', () => {
       mockAuth0.credentialsManager.hasValidCredentials
     ).toHaveBeenCalledWith(100);
   });
+
+  it('throws an error when createUser is called without a wrapper', () => {
+    const { result } = renderHook(() => useAuth0());
+    expect(() =>
+      result.current.createUser({
+        email: '[email protected]',
+        password: 'pass',
+        connection: 'Username-Password-Authentication',
+      })
+    ).toThrowError(/no provider was set/i);
+  });
+
+  it('can create a user', async () => {
+    const mockUser = { email: '[email protected]', user_id: 'user123' };
+    mockAuth0.auth.createUser = jest.fn().mockResolvedValue(mockUser);
+    const { result } = renderHook(() => useAuth0(), { wrapper });
+    let user;
+    await act(async () => {
+      user = await result.current.createUser({
+        email: '[email protected]',
+        password: 'pass',
+        connection: 'Username-Password-Authentication',
+      });
+    });
+    expect(mockAuth0.auth.createUser).toHaveBeenCalledWith({
+      email: '[email protected]',
+      password: 'pass',
+      connection: 'Username-Password-Authentication',
+    });
+    expect(user).toEqual(mockUser);
+  });
+
+  it('sets the error property when an error is raised in createUser', async () => {
+    const errorToThrow = new Error('Create user error');
+    mockAuth0.auth.createUser = jest.fn().mockRejectedValue(errorToThrow);
+    const { result } = renderHook(() => useAuth0(), { wrapper });
+    let thrown;
+    await act(async () => {
+      try {
+        await result.current.createUser({
+          email: '[email protected]',
+          password: 'pass',
+          connection: 'Username-Password-Authentication',
+        });
+      } catch (e) {
+        thrown = e;
+      }
+    });
+    expect(result.current.error).toBe(errorToThrow);
+    expect(thrown).toBe(errorToThrow);
+  });
 });
 
 describe('The Auth0Provider component', () => {

src/hooks/auth0-context.ts

@@ -18,6 +18,7 @@ import type {
   ExchangeNativeSocialOptions,
   RevokeOptions,
   ResetPasswordOptions,
+  CreateUserOptions,
 } from '../types';
 import BaseError from '../utils/baseError';
 
@@ -138,6 +139,11 @@ export interface Auth0ContextInterface<TUser extends User = User>
    *Request an email with instructions to change password of a user {@link Auth#resetPassword}
    */
   resetPassword: (parameters: ResetPasswordOptions) => Promise<void>;
+
+  /**
+   *Creates a new user with the given email and password {@link Auth#createUser}
+   */
+  createUser: (parameters: CreateUserOptions) => Promise<Partial<User>>;
 }
 
 export interface AuthState<TUser extends User = User> {
@@ -181,6 +187,7 @@ const initialContext = {
   authorizeWithExchangeNativeSocial: stub,
   revokeRefreshToken: stub,
   resetPassword: stub,
+  createUser: stub,
 };
 
 const Auth0Context = createContext<Auth0ContextInterface>(initialContext);

src/hooks/auth0-provider.tsx

@@ -25,6 +25,7 @@ import type {
   ExchangeNativeSocialOptions,
   RevokeOptions,
   ResetPasswordOptions,
+  CreateUserOptions,
 } from '../types';
 import type { CustomJwtPayload } from '../internal-types';
 import { convertUser } from '../utils/userConversion';
@@ -386,6 +387,19 @@ const Auth0Provider = ({
     }
   }, [client]);
 
+  const createUser = useCallback(
+    async (parameters: CreateUserOptions) => {
+      try {
+        const user = await client.auth.createUser(parameters);
+        return user;
+      } catch (error) {
+        dispatch({ type: 'ERROR', error: error as BaseError });
+        throw error;
+      }
+    },
+    [client]
+  );
+
   const contextValue = useMemo(
     () => ({
       ...state,
@@ -407,6 +421,7 @@ const Auth0Provider = ({
       authorizeWithExchangeNativeSocial,
       revokeRefreshToken,
       resetPassword,
+      createUser,
     }),
     [
       state,
@@ -428,6 +443,7 @@ const Auth0Provider = ({
       authorizeWithExchangeNativeSocial,
       revokeRefreshToken,
       resetPassword,
+      createUser,
     ]
   );
 

src/hooks/use-auth0.ts

@@ -30,6 +30,7 @@ import type { Auth0ContextInterface } from './auth0-context';
  *   authorizeWithPasswordRealm,
  *   authorizeWithExchangeNativeSocial,
  *   revokeRefreshToken
+ *   createUser
  * } = useAuth0();
  * ```
  *