@23blocks/react 3.0.4 → 4.0.0

package/dist/index.esm.js

@@ -697,7 +697,7 @@ const Blocks23Context = /*#__PURE__*/ createContext(null);
 /**
  * Hook for authentication operations with automatic token management.
  *
- * @example
+ * @example Basic login/logout
  * ```tsx
  * function LoginPage() {
  *   const { signIn, signOut, isAuthenticated } = useAuth();
@@ -718,6 +718,22 @@ const Blocks23Context = /*#__PURE__*/ createContext(null);
  * }
  * ```
  *
+ * @example Validate email before registration
+ * ```tsx
+ * function SignUpForm() {
+ *   const { validateEmail, signUp } = useAuth();
+ *
+ *   const checkEmail = async (email: string) => {
+ *     const result = await validateEmail({ email });
+ *     if (result.exists) {
+ *       alert('Email already registered');
+ *     } else if (!result.wellFormed) {
+ *       alert('Invalid email format');
+ *     }
+ *   };
+ * }
+ * ```
+ *
  * @example React Native - wait for tokens to load
  * ```tsx
  * function App() {
@@ -730,20 +746,48 @@ const Blocks23Context = /*#__PURE__*/ createContext(null);
  *   return isAuthenticated() ? <HomeScreen /> : <LoginScreen />;
  * }
  * ```
- */ function useAuth$1() {
+ */ function useAuth() {
     const context = useClient();
+    const auth = context.authentication.auth;
     return {
+        // Core auth with automatic token management
         signIn: context.signIn,
         signUp: context.signUp,
         signOut: context.signOut,
+        // Token utilities
         getAccessToken: context.getAccessToken,
         getRefreshToken: context.getRefreshToken,
         setTokens: context.setTokens,
         clearTokens: context.clearTokens,
         isAuthenticated: context.isAuthenticated,
         onStorageChange: context.onStorageChange,
-        authentication: context.authentication,
-        isReady: context.isReady
+        isReady: context.isReady,
+        // Password management
+        requestPasswordReset: auth.requestPasswordReset.bind(auth),
+        updatePassword: auth.updatePassword.bind(auth),
+        // Token refresh
+        refreshToken: auth.refreshToken.bind(auth),
+        // Magic link (passwordless)
+        requestMagicLink: auth.requestMagicLink.bind(auth),
+        verifyMagicLink: auth.verifyMagicLink.bind(auth),
+        // Invitations
+        sendInvitation: auth.sendInvitation.bind(auth),
+        acceptInvitation: auth.acceptInvitation.bind(auth),
+        resendInvitation: auth.resendInvitation.bind(auth),
+        // Email confirmation
+        confirmEmail: auth.confirmEmail.bind(auth),
+        resendConfirmation: auth.resendConfirmation.bind(auth),
+        // Validation (pre-registration checks)
+        validateEmail: auth.validateEmail.bind(auth),
+        validateDocument: auth.validateDocument.bind(auth),
+        // Account recovery
+        requestAccountRecovery: auth.requestAccountRecovery.bind(auth),
+        completeAccountRecovery: auth.completeAccountRecovery.bind(auth),
+        // Token validation
+        validateToken: auth.validateToken.bind(auth),
+        getCurrentUser: auth.getCurrentUser.bind(auth),
+        // Full block access for advanced usage
+        authentication: context.authentication
     };
 }
 // ─────────────────────────────────────────────────────────────────────────────
@@ -751,7 +795,7 @@ const Blocks23Context = /*#__PURE__*/ createContext(null);
 // ─────────────────────────────────────────────────────────────────────────────
 /** @deprecated Use `Provider` instead */ const SimpleBlocks23Provider = Provider;
 /** @deprecated Use `useClient` instead */ const useSimpleBlocks23 = useClient;
-/** @deprecated Use `useAuth` instead */ const useSimpleAuth = useAuth$1;
+/** @deprecated Use `useAuth` instead */ const useSimpleAuth = useAuth;
 
 // ─────────────────────────────────────────────────────────────────────────────
 // Context
@@ -944,49 +988,41 @@ function useUniversityBlock() {
 // Hook
 // ─────────────────────────────────────────────────────────────────────────────
 /**
- * Hook for authentication operations with state management.
+ * Hook for user management operations.
  *
  * @example
  * ```tsx
- * function LoginForm() {
- *   const { signIn, isLoading, error, user } = useAuth();
+ * function UserList() {
+ *   const { users, listUsers, isLoading, error } = useUsers();
  *
- *   const handleSubmit = async (e: FormEvent) => {
- *     e.preventDefault();
- *     try {
- *       await signIn({ email, password });
- *       navigate('/dashboard');
- *     } catch (err) {
- *       // Error is automatically captured in `error` state
- *     }
- *   };
+ *   useEffect(() => {
+ *     listUsers({ page: 1, perPage: 20 });
+ *   }, [listUsers]);
  *
- *   if (user) {
- *     return <p>Welcome, {user.email}!</p>;
- *   }
+ *   if (isLoading) return <Spinner />;
+ *   if (error) return <Error message={error.message} />;
  *
  *   return (
- *     <form onSubmit={handleSubmit}>
- *       {error && <p className="error">{error.message}</p>}
- *       <button disabled={isLoading}>
- *         {isLoading ? 'Signing in...' : 'Sign In'}
- *       </button>
- *     </form>
+ *     <ul>
+ *       {users.map(user => (
+ *         <li key={user.id}>{user.email}</li>
+ *       ))}
+ *     </ul>
  *   );
  * }
  * ```
- */ function useAuth() {
+ */ function useUsers() {
     const block = useAuthenticationBlock();
-    const [user, setUser] = useState(null);
+    const [users, setUsers] = useState([]);
     const [isLoading, setIsLoading] = useState(false);
     const [error, setError] = useState(null);
-    const signIn = useCallback(async (request)=>{
+    const listUsers = useCallback(async (params)=>{
         setIsLoading(true);
         setError(null);
         try {
-            const response = await block.auth.signIn(request);
-            setUser(response.user);
-            return response;
+            const result = await block.users.list(params);
+            setUsers(result.data);
+            return result;
         } catch (err) {
             const error = err instanceof Error ? err : new Error(String(err));
             setError(error);
@@ -995,15 +1031,13 @@ function useUniversityBlock() {
             setIsLoading(false);
         }
     }, [
-        block.auth
+        block.users
     ]);
-    const signUp = useCallback(async (request)=>{
+    const getUser = useCallback(async (id)=>{
         setIsLoading(true);
         setError(null);
         try {
-            const response = await block.auth.signUp(request);
-            setUser(response.user);
-            return response;
+            return await block.users.get(id);
         } catch (err) {
             const error = err instanceof Error ? err : new Error(String(err));
             setError(error);
@@ -1012,14 +1046,13 @@ function useUniversityBlock() {
             setIsLoading(false);
         }
     }, [
-        block.auth
+        block.users
     ]);
-    const signOut = useCallback(async ()=>{
+    const getUserByUniqueId = useCallback(async (uniqueId)=>{
         setIsLoading(true);
         setError(null);
         try {
-            await block.auth.signOut();
-            setUser(null);
+            return await block.users.getByUniqueId(uniqueId);
         } catch (err) {
             const error = err instanceof Error ? err : new Error(String(err));
             setError(error);
@@ -1028,13 +1061,15 @@ function useUniversityBlock() {
             setIsLoading(false);
         }
     }, [
-        block.auth
+        block.users
     ]);
-    const requestPasswordReset = useCallback(async (request)=>{
+    const updateUser = useCallback(async (id, request)=>{
         setIsLoading(true);
         setError(null);
         try {
-            await block.auth.requestPasswordReset(request);
+            const updated = await block.users.update(id, request);
+            setUsers((prev)=>prev.map((u)=>u.id === id ? updated : u));
+            return updated;
         } catch (err) {
             const error = err instanceof Error ? err : new Error(String(err));
             setError(error);
@@ -1043,13 +1078,13 @@ function useUniversityBlock() {
             setIsLoading(false);
         }
     }, [
-        block.auth
+        block.users
     ]);
-    const updatePassword = useCallback(async (request)=>{
+    const updateUserProfile = useCallback(async (userId, request)=>{
         setIsLoading(true);
         setError(null);
         try {
-            await block.auth.updatePassword(request);
+            return await block.users.updateProfile(userId, request);
         } catch (err) {
             const error = err instanceof Error ? err : new Error(String(err));
             setError(error);
@@ -1058,14 +1093,14 @@ function useUniversityBlock() {
             setIsLoading(false);
         }
     }, [
-        block.auth
+        block.users
     ]);
-    const refreshUser = useCallback(async ()=>{
+    const deleteUser = useCallback(async (id)=>{
         setIsLoading(true);
         setError(null);
         try {
-            const currentUser = await block.auth.getCurrentUser();
-            setUser(currentUser);
+            await block.users.delete(id);
+            setUsers((prev)=>prev.filter((u)=>u.id !== id));
         } catch (err) {
             const error = err instanceof Error ? err : new Error(String(err));
             setError(error);
@@ -1074,67 +1109,15 @@ function useUniversityBlock() {
             setIsLoading(false);
         }
     }, [
-        block.auth
+        block.users
     ]);
-    const clearError = useCallback(()=>{
-        setError(null);
-    }, []);
-    return {
-        // State
-        user,
-        isLoading,
-        error,
-        isAuthenticated: user !== null,
-        // Actions
-        signIn,
-        signUp,
-        signOut,
-        requestPasswordReset,
-        updatePassword,
-        refreshUser,
-        clearError
-    };
-}
-
-// ─────────────────────────────────────────────────────────────────────────────
-// Hook
-// ─────────────────────────────────────────────────────────────────────────────
-/**
- * Hook for user management operations.
- *
- * @example
- * ```tsx
- * function UserList() {
- *   const { users, listUsers, isLoading, error } = useUsers();
- *
- *   useEffect(() => {
- *     listUsers({ page: 1, perPage: 20 });
- *   }, [listUsers]);
- *
- *   if (isLoading) return <Spinner />;
- *   if (error) return <Error message={error.message} />;
- *
- *   return (
- *     <ul>
- *       {users.map(user => (
- *         <li key={user.id}>{user.email}</li>
- *       ))}
- *     </ul>
- *   );
- * }
- * ```
- */ function useUsers() {
-    const block = useAuthenticationBlock();
-    const [users, setUsers] = useState([]);
-    const [isLoading, setIsLoading] = useState(false);
-    const [error, setError] = useState(null);
-    const listUsers = useCallback(async (params)=>{
+    const activateUser = useCallback(async (id)=>{
         setIsLoading(true);
         setError(null);
         try {
-            const result = await block.users.list(params);
-            setUsers(result);
-            return result;
+            const activated = await block.users.activate(id);
+            setUsers((prev)=>prev.map((u)=>u.id === id ? activated : u));
+            return activated;
         } catch (err) {
             const error = err instanceof Error ? err : new Error(String(err));
             setError(error);
@@ -1145,11 +1128,13 @@ function useUniversityBlock() {
     }, [
         block.users
     ]);
-    const getUser = useCallback(async (id)=>{
+    const deactivateUser = useCallback(async (id)=>{
         setIsLoading(true);
         setError(null);
         try {
-            return await block.users.get(id);
+            const deactivated = await block.users.deactivate(id);
+            setUsers((prev)=>prev.map((u)=>u.id === id ? deactivated : u));
+            return deactivated;
         } catch (err) {
             const error = err instanceof Error ? err : new Error(String(err));
             setError(error);
@@ -1160,11 +1145,11 @@ function useUniversityBlock() {
     }, [
         block.users
     ]);
-    const updateUser = useCallback(async (id, request)=>{
+    const changeUserRole = useCallback(async (id, roleUniqueId, reason, forceReauth)=>{
         setIsLoading(true);
         setError(null);
         try {
-            const updated = await block.users.update(id, request);
+            const updated = await block.users.changeRole(id, roleUniqueId, reason, forceReauth);
             setUsers((prev)=>prev.map((u)=>u.id === id ? updated : u));
             return updated;
         } catch (err) {
@@ -1177,12 +1162,165 @@ function useUniversityBlock() {
     }, [
         block.users
     ]);
-    const deleteUser = useCallback(async (id)=>{
+    const searchUsers = useCallback(async (query, params)=>{
         setIsLoading(true);
         setError(null);
         try {
-            await block.users.delete(id);
-            setUsers((prev)=>prev.filter((u)=>u.id !== id));
+            const result = await block.users.search(query, params);
+            setUsers(result.data);
+            return result;
+        } catch (err) {
+            const error = err instanceof Error ? err : new Error(String(err));
+            setError(error);
+            throw error;
+        } finally{
+            setIsLoading(false);
+        }
+    }, [
+        block.users
+    ]);
+    const searchUsersAdvanced = useCallback(async (request, params)=>{
+        setIsLoading(true);
+        setError(null);
+        try {
+            const result = await block.users.searchAdvanced(request, params);
+            setUsers(result.data);
+            return result;
+        } catch (err) {
+            const error = err instanceof Error ? err : new Error(String(err));
+            setError(error);
+            throw error;
+        } finally{
+            setIsLoading(false);
+        }
+    }, [
+        block.users
+    ]);
+    const getUserProfile = useCallback(async (userUniqueId)=>{
+        setIsLoading(true);
+        setError(null);
+        try {
+            return await block.users.getProfile(userUniqueId);
+        } catch (err) {
+            const error = err instanceof Error ? err : new Error(String(err));
+            setError(error);
+            throw error;
+        } finally{
+            setIsLoading(false);
+        }
+    }, [
+        block.users
+    ]);
+    const createUserProfile = useCallback(async (request)=>{
+        setIsLoading(true);
+        setError(null);
+        try {
+            return await block.users.createProfile(request);
+        } catch (err) {
+            const error = err instanceof Error ? err : new Error(String(err));
+            setError(error);
+            throw error;
+        } finally{
+            setIsLoading(false);
+        }
+    }, [
+        block.users
+    ]);
+    const updateUserEmail = useCallback(async (userUniqueId, request)=>{
+        setIsLoading(true);
+        setError(null);
+        try {
+            return await block.users.updateEmail(userUniqueId, request);
+        } catch (err) {
+            const error = err instanceof Error ? err : new Error(String(err));
+            setError(error);
+            throw error;
+        } finally{
+            setIsLoading(false);
+        }
+    }, [
+        block.users
+    ]);
+    const getUserDevices = useCallback(async (userUniqueId, params)=>{
+        setIsLoading(true);
+        setError(null);
+        try {
+            return await block.users.getDevices(userUniqueId, params);
+        } catch (err) {
+            const error = err instanceof Error ? err : new Error(String(err));
+            setError(error);
+            throw error;
+        } finally{
+            setIsLoading(false);
+        }
+    }, [
+        block.users
+    ]);
+    const addUserDevice = useCallback(async (request)=>{
+        setIsLoading(true);
+        setError(null);
+        try {
+            return await block.users.addDevice(request);
+        } catch (err) {
+            const error = err instanceof Error ? err : new Error(String(err));
+            setError(error);
+            throw error;
+        } finally{
+            setIsLoading(false);
+        }
+    }, [
+        block.users
+    ]);
+    const getUserCompanies = useCallback(async (userUniqueId)=>{
+        setIsLoading(true);
+        setError(null);
+        try {
+            return await block.users.getCompanies(userUniqueId);
+        } catch (err) {
+            const error = err instanceof Error ? err : new Error(String(err));
+            setError(error);
+            throw error;
+        } finally{
+            setIsLoading(false);
+        }
+    }, [
+        block.users
+    ]);
+    const addUserSubscription = useCallback(async (userUniqueId, request)=>{
+        setIsLoading(true);
+        setError(null);
+        try {
+            return await block.users.addSubscription(userUniqueId, request);
+        } catch (err) {
+            const error = err instanceof Error ? err : new Error(String(err));
+            setError(error);
+            throw error;
+        } finally{
+            setIsLoading(false);
+        }
+    }, [
+        block.users
+    ]);
+    const updateUserSubscription = useCallback(async (userUniqueId, request)=>{
+        setIsLoading(true);
+        setError(null);
+        try {
+            return await block.users.updateSubscription(userUniqueId, request);
+        } catch (err) {
+            const error = err instanceof Error ? err : new Error(String(err));
+            setError(error);
+            throw error;
+        } finally{
+            setIsLoading(false);
+        }
+    }, [
+        block.users
+    ]);
+    const resendConfirmationByUniqueId = useCallback(async (userUniqueId)=>{
+        setIsLoading(true);
+        setError(null);
+        try {
+            await block.users.resendConfirmationByUniqueId(userUniqueId);
         } catch (err) {
             const error = err instanceof Error ? err : new Error(String(err));
             setError(error);
@@ -1202,8 +1340,713 @@ function useUniversityBlock() {
         error,
         listUsers,
         getUser,
+        getUserByUniqueId,
         updateUser,
+        updateUserProfile,
         deleteUser,
+        activateUser,
+        deactivateUser,
+        changeUserRole,
+        searchUsers,
+        searchUsersAdvanced,
+        getUserProfile,
+        createUserProfile,
+        updateUserEmail,
+        getUserDevices,
+        addUserDevice,
+        getUserCompanies,
+        addUserSubscription,
+        updateUserSubscription,
+        resendConfirmationByUniqueId,
+        clearError
+    };
+}
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Hook
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * Hook for Multi-Factor Authentication operations.
+ *
+ * @example
+ * ```tsx
+ * function MfaSettings() {
+ *   const { setup, enable, disable, getStatus, status, isLoading, error } = useMfa();
+ *
+ *   useEffect(() => {
+ *     getStatus();
+ *   }, [getStatus]);
+ *
+ *   const handleSetup = async () => {
+ *     const data = await setup();
+ *     // Show QR code from data.qrCodeUri
+ *   };
+ *
+ *   const handleEnable = async (code: string) => {
+ *     await enable({ totpCode: code });
+ *   };
+ *
+ *   return (
+ *     <div>
+ *       {status?.enabled ? (
+ *         <button onClick={() => disable({ password: 'xxx' })}>Disable MFA</button>
+ *       ) : (
+ *         <button onClick={handleSetup}>Setup MFA</button>
+ *       )}
+ *     </div>
+ *   );
+ * }
+ * ```
+ */ function useMfa() {
+    const block = useAuthenticationBlock();
+    const [isLoading, setIsLoading] = useState(false);
+    const [error, setError] = useState(null);
+    const [status, setStatus] = useState(null);
+    const [setupData, setSetupData] = useState(null);
+    const setup = useCallback(async ()=>{
+        setIsLoading(true);
+        setError(null);
+        try {
+            const result = await block.mfa.setup();
+            setSetupData(result);
+            return result;
+        } catch (err) {
+            const error = err instanceof Error ? err : new Error(String(err));
+            setError(error);
+            throw error;
+        } finally{
+            setIsLoading(false);
+        }
+    }, [
+        block.mfa
+    ]);
+    const enable = useCallback(async (request)=>{
+        setIsLoading(true);
+        setError(null);
+        try {
+            const result = await block.mfa.enable(request);
+            setSetupData(null);
+            // Refresh status after enabling
+            const newStatus = await block.mfa.status();
+            setStatus(newStatus);
+            return result;
+        } catch (err) {
+            const error = err instanceof Error ? err : new Error(String(err));
+            setError(error);
+            throw error;
+        } finally{
+            setIsLoading(false);
+        }
+    }, [
+        block.mfa
+    ]);
+    const disable = useCallback(async (request)=>{
+        setIsLoading(true);
+        setError(null);
+        try {
+            const result = await block.mfa.disable(request);
+            // Refresh status after disabling
+            const newStatus = await block.mfa.status();
+            setStatus(newStatus);
+            return result;
+        } catch (err) {
+            const error = err instanceof Error ? err : new Error(String(err));
+            setError(error);
+            throw error;
+        } finally{
+            setIsLoading(false);
+        }
+    }, [
+        block.mfa
+    ]);
+    const verify = useCallback(async (request)=>{
+        setIsLoading(true);
+        setError(null);
+        try {
+            return await block.mfa.verify(request);
+        } catch (err) {
+            const error = err instanceof Error ? err : new Error(String(err));
+            setError(error);
+            throw error;
+        } finally{
+            setIsLoading(false);
+        }
+    }, [
+        block.mfa
+    ]);
+    const getStatus = useCallback(async ()=>{
+        setIsLoading(true);
+        setError(null);
+        try {
+            const result = await block.mfa.status();
+            setStatus(result);
+            return result;
+        } catch (err) {
+            const error = err instanceof Error ? err : new Error(String(err));
+            setError(error);
+            throw error;
+        } finally{
+            setIsLoading(false);
+        }
+    }, [
+        block.mfa
+    ]);
+    const clearError = useCallback(()=>{
+        setError(null);
+    }, []);
+    return {
+        isLoading,
+        error,
+        status,
+        setupData,
+        setup,
+        enable,
+        disable,
+        verify,
+        getStatus,
+        clearError
+    };
+}
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Hook
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * Hook for OAuth and token management operations.
+ *
+ * @example
+ * ```tsx
+ * function SocialLogin() {
+ *   const { loginWithGoogle, loginWithFacebook, isLoading, error } = useOAuth();
+ *
+ *   const handleGoogleLogin = async (googleToken: string) => {
+ *     try {
+ *       const response = await loginWithGoogle({ token: googleToken });
+ *       // User is now logged in
+ *     } catch (err) {
+ *       // Handle error
+ *     }
+ *   };
+ *
+ *   return (
+ *     <div>
+ *       <button onClick={() => handleGoogleLogin('...')} disabled={isLoading}>
+ *         Login with Google
+ *       </button>
+ *     </div>
+ *   );
+ * }
+ * ```
+ */ function useOAuth() {
+    const block = useAuthenticationBlock();
+    const [isLoading, setIsLoading] = useState(false);
+    const [error, setError] = useState(null);
+    const [tenantContext, setTenantContext] = useState(null);
+    const loginWithFacebook = useCallback(async (request)=>{
+        setIsLoading(true);
+        setError(null);
+        try {
+            return await block.oauth.loginWithFacebook(request);
+        } catch (err) {
+            const error = err instanceof Error ? err : new Error(String(err));
+            setError(error);
+            throw error;
+        } finally{
+            setIsLoading(false);
+        }
+    }, [
+        block.oauth
+    ]);
+    const loginWithGoogle = useCallback(async (request)=>{
+        setIsLoading(true);
+        setError(null);
+        try {
+            return await block.oauth.loginWithGoogle(request);
+        } catch (err) {
+            const error = err instanceof Error ? err : new Error(String(err));
+            setError(error);
+            throw error;
+        } finally{
+            setIsLoading(false);
+        }
+    }, [
+        block.oauth
+    ]);
+    const loginWithTenant = useCallback(async (request)=>{
+        setIsLoading(true);
+        setError(null);
+        try {
+            return await block.oauth.loginWithTenant(request);
+        } catch (err) {
+            const error = err instanceof Error ? err : new Error(String(err));
+            setError(error);
+            throw error;
+        } finally{
+            setIsLoading(false);
+        }
+    }, [
+        block.oauth
+    ]);
+    const introspectToken = useCallback(async (token)=>{
+        setIsLoading(true);
+        setError(null);
+        try {
+            return await block.oauth.introspectToken(token);
+        } catch (err) {
+            const error = err instanceof Error ? err : new Error(String(err));
+            setError(error);
+            throw error;
+        } finally{
+            setIsLoading(false);
+        }
+    }, [
+        block.oauth
+    ]);
+    const revokeToken = useCallback(async (request)=>{
+        setIsLoading(true);
+        setError(null);
+        try {
+            return await block.oauth.revokeToken(request);
+        } catch (err) {
+            const error = err instanceof Error ? err : new Error(String(err));
+            setError(error);
+            throw error;
+        } finally{
+            setIsLoading(false);
+        }
+    }, [
+        block.oauth
+    ]);
+    const revokeAllTokens = useCallback(async (request)=>{
+        setIsLoading(true);
+        setError(null);
+        try {
+            return await block.oauth.revokeAllTokens(request);
+        } catch (err) {
+            const error = err instanceof Error ? err : new Error(String(err));
+            setError(error);
+            throw error;
+        } finally{
+            setIsLoading(false);
+        }
+    }, [
+        block.oauth
+    ]);
+    const createTenantContext = useCallback(async (request)=>{
+        setIsLoading(true);
+        setError(null);
+        try {
+            const result = await block.oauth.createTenantContext(request);
+            setTenantContext(result);
+            return result;
+        } catch (err) {
+            const error = err instanceof Error ? err : new Error(String(err));
+            setError(error);
+            throw error;
+        } finally{
+            setIsLoading(false);
+        }
+    }, [
+        block.oauth
+    ]);
+    const revokeTenantContext = useCallback(async ()=>{
+        setIsLoading(true);
+        setError(null);
+        try {
+            await block.oauth.revokeTenantContext();
+            setTenantContext(null);
+        } catch (err) {
+            const error = err instanceof Error ? err : new Error(String(err));
+            setError(error);
+            throw error;
+        } finally{
+            setIsLoading(false);
+        }
+    }, [
+        block.oauth
+    ]);
+    const auditTenantContext = useCallback(async ()=>{
+        setIsLoading(true);
+        setError(null);
+        try {
+            return await block.oauth.auditTenantContext();
+        } catch (err) {
+            const error = err instanceof Error ? err : new Error(String(err));
+            setError(error);
+            throw error;
+        } finally{
+            setIsLoading(false);
+        }
+    }, [
+        block.oauth
+    ]);
+    const clearError = useCallback(()=>{
+        setError(null);
+    }, []);
+    return {
+        isLoading,
+        error,
+        tenantContext,
+        loginWithFacebook,
+        loginWithGoogle,
+        loginWithTenant,
+        introspectToken,
+        revokeToken,
+        revokeAllTokens,
+        createTenantContext,
+        revokeTenantContext,
+        auditTenantContext,
+        clearError
+    };
+}
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Hook
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * Hook for user avatar management.
+ *
+ * @example
+ * ```tsx
+ * function AvatarUpload({ userUniqueId }: { userUniqueId: string }) {
+ *   const { presignUpload, create, isLoading, error } = useAvatars();
+ *
+ *   const handleUpload = async (file: File) => {
+ *     // Get presigned URL
+ *     const { uploadUrl, publicUrl } = await presignUpload(userUniqueId, file.name);
+ *
+ *     // Upload directly to S3
+ *     await fetch(uploadUrl, { method: 'PUT', body: file });
+ *
+ *     // Save avatar record
+ *     await create(userUniqueId, {
+ *       originalName: file.name,
+ *       name: file.name,
+ *       url: publicUrl,
+ *       fileType: file.type,
+ *       fileSize: file.size,
+ *     });
+ *   };
+ *
+ *   return (
+ *     <input type="file" onChange={(e) => e.target.files?.[0] && handleUpload(e.target.files[0])} />
+ *   );
+ * }
+ * ```
+ */ function useAvatars() {
+    const block = useAuthenticationBlock();
+    const [avatars, setAvatars] = useState([]);
+    const [currentAvatar, setCurrentAvatar] = useState(null);
+    const [isLoading, setIsLoading] = useState(false);
+    const [error, setError] = useState(null);
+    const list = useCallback(async (userUniqueId, params)=>{
+        setIsLoading(true);
+        setError(null);
+        try {
+            const result = await block.avatars.list(userUniqueId, params);
+            setAvatars(result.data);
+            return result;
+        } catch (err) {
+            const error = err instanceof Error ? err : new Error(String(err));
+            setError(error);
+            throw error;
+        } finally{
+            setIsLoading(false);
+        }
+    }, [
+        block.avatars
+    ]);
+    const get = useCallback(async (userUniqueId)=>{
+        setIsLoading(true);
+        setError(null);
+        try {
+            const result = await block.avatars.get(userUniqueId);
+            setCurrentAvatar(result);
+            return result;
+        } catch (err) {
+            const error = err instanceof Error ? err : new Error(String(err));
+            setError(error);
+            throw error;
+        } finally{
+            setIsLoading(false);
+        }
+    }, [
+        block.avatars
+    ]);
+    const create = useCallback(async (userUniqueId, request)=>{
+        setIsLoading(true);
+        setError(null);
+        try {
+            const result = await block.avatars.create(userUniqueId, request);
+            setCurrentAvatar(result);
+            setAvatars((prev)=>[
+                    ...prev,
+                    result
+                ]);
+            return result;
+        } catch (err) {
+            const error = err instanceof Error ? err : new Error(String(err));
+            setError(error);
+            throw error;
+        } finally{
+            setIsLoading(false);
+        }
+    }, [
+        block.avatars
+    ]);
+    const update = useCallback(async (userUniqueId, request)=>{
+        setIsLoading(true);
+        setError(null);
+        try {
+            const result = await block.avatars.update(userUniqueId, request);
+            setCurrentAvatar(result);
+            setAvatars((prev)=>prev.map((a)=>a.userUniqueId === userUniqueId ? result : a));
+            return result;
+        } catch (err) {
+            const error = err instanceof Error ? err : new Error(String(err));
+            setError(error);
+            throw error;
+        } finally{
+            setIsLoading(false);
+        }
+    }, [
+        block.avatars
+    ]);
+    const remove = useCallback(async (userUniqueId)=>{
+        setIsLoading(true);
+        setError(null);
+        try {
+            await block.avatars.delete(userUniqueId);
+            setCurrentAvatar(null);
+            setAvatars((prev)=>prev.filter((a)=>a.userUniqueId !== userUniqueId));
+        } catch (err) {
+            const error = err instanceof Error ? err : new Error(String(err));
+            setError(error);
+            throw error;
+        } finally{
+            setIsLoading(false);
+        }
+    }, [
+        block.avatars
+    ]);
+    const presignUpload = useCallback(async (userUniqueId, filename)=>{
+        setIsLoading(true);
+        setError(null);
+        try {
+            return await block.avatars.presignUpload(userUniqueId, filename);
+        } catch (err) {
+            const error = err instanceof Error ? err : new Error(String(err));
+            setError(error);
+            throw error;
+        } finally{
+            setIsLoading(false);
+        }
+    }, [
+        block.avatars
+    ]);
+    const multipartPresign = useCallback(async (userUniqueId, request)=>{
+        setIsLoading(true);
+        setError(null);
+        try {
+            return await block.avatars.multipartPresign(userUniqueId, request);
+        } catch (err) {
+            const error = err instanceof Error ? err : new Error(String(err));
+            setError(error);
+            throw error;
+        } finally{
+            setIsLoading(false);
+        }
+    }, [
+        block.avatars
+    ]);
+    const multipartComplete = useCallback(async (userUniqueId, request)=>{
+        setIsLoading(true);
+        setError(null);
+        try {
+            return await block.avatars.multipartComplete(userUniqueId, request);
+        } catch (err) {
+            const error = err instanceof Error ? err : new Error(String(err));
+            setError(error);
+            throw error;
+        } finally{
+            setIsLoading(false);
+        }
+    }, [
+        block.avatars
+    ]);
+    const clearError = useCallback(()=>{
+        setError(null);
+    }, []);
+    return {
+        avatars,
+        currentAvatar,
+        isLoading,
+        error,
+        list,
+        get,
+        create,
+        update,
+        remove,
+        presignUpload,
+        multipartPresign,
+        multipartComplete,
+        clearError
+    };
+}
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Hook
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * Hook for tenant management operations.
+ *
+ * @example
+ * ```tsx
+ * function TenantList() {
+ *   const { tenants, listChildren, isLoading, error } = useTenants();
+ *
+ *   useEffect(() => {
+ *     listChildren();
+ *   }, [listChildren]);
+ *
+ *   if (isLoading) return <Spinner />;
+ *   if (error) return <Error message={error.message} />;
+ *
+ *   return (
+ *     <ul>
+ *       {tenants.map(tenant => (
+ *         <li key={tenant.id}>{tenant.name}</li>
+ *       ))}
+ *     </ul>
+ *   );
+ * }
+ * ```
+ */ function useTenants() {
+    const block = useAuthenticationBlock();
+    const [tenants, setTenants] = useState([]);
+    const [isLoading, setIsLoading] = useState(false);
+    const [error, setError] = useState(null);
+    const listChildren = useCallback(async (params)=>{
+        setIsLoading(true);
+        setError(null);
+        try {
+            const result = await block.tenants.listChildren(params);
+            setTenants(result.data);
+            return result;
+        } catch (err) {
+            const error = err instanceof Error ? err : new Error(String(err));
+            setError(error);
+            throw error;
+        } finally{
+            setIsLoading(false);
+        }
+    }, [
+        block.tenants
+    ]);
+    const validateCode = useCallback(async (request)=>{
+        setIsLoading(true);
+        setError(null);
+        try {
+            return await block.tenants.validateCode(request);
+        } catch (err) {
+            const error = err instanceof Error ? err : new Error(String(err));
+            setError(error);
+            throw error;
+        } finally{
+            setIsLoading(false);
+        }
+    }, [
+        block.tenants
+    ]);
+    const searchByName = useCallback(async (request)=>{
+        setIsLoading(true);
+        setError(null);
+        try {
+            return await block.tenants.searchByName(request);
+        } catch (err) {
+            const error = err instanceof Error ? err : new Error(String(err));
+            setError(error);
+            throw error;
+        } finally{
+            setIsLoading(false);
+        }
+    }, [
+        block.tenants
+    ]);
+    const searchByCode = useCallback(async (request)=>{
+        setIsLoading(true);
+        setError(null);
+        try {
+            return await block.tenants.searchByCode(request);
+        } catch (err) {
+            const error = err instanceof Error ? err : new Error(String(err));
+            setError(error);
+            throw error;
+        } finally{
+            setIsLoading(false);
+        }
+    }, [
+        block.tenants
+    ]);
+    const createTenantUser = useCallback(async (userUniqueId, request)=>{
+        setIsLoading(true);
+        setError(null);
+        try {
+            return await block.tenants.createTenantUser(userUniqueId, request);
+        } catch (err) {
+            const error = err instanceof Error ? err : new Error(String(err));
+            setError(error);
+            throw error;
+        } finally{
+            setIsLoading(false);
+        }
+    }, [
+        block.tenants
+    ]);
+    const updateOnboarding = useCallback(async (userUniqueId, urlId, request)=>{
+        setIsLoading(true);
+        setError(null);
+        try {
+            return await block.tenants.updateOnboarding(userUniqueId, urlId, request);
+        } catch (err) {
+            const error = err instanceof Error ? err : new Error(String(err));
+            setError(error);
+            throw error;
+        } finally{
+            setIsLoading(false);
+        }
+    }, [
+        block.tenants
+    ]);
+    const updateSales = useCallback(async (userUniqueId, urlId, request)=>{
+        setIsLoading(true);
+        setError(null);
+        try {
+            return await block.tenants.updateSales(userUniqueId, urlId, request);
+        } catch (err) {
+            const error = err instanceof Error ? err : new Error(String(err));
+            setError(error);
+            throw error;
+        } finally{
+            setIsLoading(false);
+        }
+    }, [
+        block.tenants
+    ]);
+    const clearError = useCallback(()=>{
+        setError(null);
+    }, []);
+    return {
+        tenants,
+        isLoading,
+        error,
+        listChildren,
+        validateCode,
+        searchByName,
+        searchByCode,
+        createTenantUser,
+        updateOnboarding,
+        updateSales,
         clearError
     };
 }
@@ -1436,4 +2279,4 @@ function useUniversityBlock() {
     };
 }
 
-export { Blocks23Provider, Provider, SimpleBlocks23Provider, use23Blocks, useAssetsBlock, useAuth$1 as useAuth, useAuth as useAuthState, useAuthenticationBlock, useCampaignsBlock, useClient, useCompanyBlock, useContentBlock, useConversationsBlock, useCrmBlock, useFavorites, useFilesBlock, useFormsBlock, useGeolocationBlock, useJarvisBlock, useOnboardingBlock, useProductsBlock, useRewardsBlock, useSalesBlock, useSearch, useSearchBlock, useSimpleAuth, useSimpleBlocks23, useUniversityBlock, useUsers, useWalletBlock };
+export { Blocks23Provider, Provider, SimpleBlocks23Provider, use23Blocks, useAssetsBlock, useAuth, useAuthenticationBlock, useAvatars, useCampaignsBlock, useClient, useCompanyBlock, useContentBlock, useConversationsBlock, useCrmBlock, useFavorites, useFilesBlock, useFormsBlock, useGeolocationBlock, useJarvisBlock, useMfa, useOAuth, useOnboardingBlock, useProductsBlock, useRewardsBlock, useSalesBlock, useSearch, useSearchBlock, useSimpleAuth, useSimpleBlocks23, useTenants, useUniversityBlock, useUsers, useWalletBlock };