feat(hook): add new create user hook

Author: bruno-at-breezy

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,12 @@ 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 {@link Auth#createUser}
+   */
+  createUser: (parameters: CreateUserOptions) => Promise<Partial<User>>;
 }
 
 export interface AuthState<TUser extends User = User> {
@@ -181,6 +188,7 @@ const initialContext = {
   authorizeWithExchangeNativeSocial: stub,
   revokeRefreshToken: stub,
   resetPassword: stub,
+  createUser: stub,
 };
 
 const Auth0Context = createContext<Auth0ContextInterface>(initialContext);

src/hooks/auth0-provider.tsx

@@ -24,6 +24,7 @@ import type {
   ExchangeNativeSocialOptions,
   RevokeOptions,
   ResetPasswordOptions,
+  CreateUserOptions,
 } from '../types';
 import type { CustomJwtPayload } from '../internal-types';
 import { convertUser } from '../utils/userConversion';
@@ -390,6 +391,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,
@@ -411,6 +425,7 @@ const Auth0Provider = ({
       authorizeWithExchangeNativeSocial,
       revokeRefreshToken,
       resetPassword,
+      createUser,
     }),
     [
       state,
@@ -432,6 +447,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();
  * ```
  *