@23blocks/react 3.1.0 → 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,30 @@ function useUniversityBlock() {
             setIsLoading(false);
         }
     }, [
-        block.auth
+        block.users
     ]);
-    const signOut = useCallback(async ()=>{
+    const getUserByUniqueId = useCallback(async (uniqueId)=>{
+        setIsLoading(true);
+        setError(null);
+        try {
+            return await block.users.getByUniqueId(uniqueId);
+        } catch (err) {
+            const error = err instanceof Error ? err : new Error(String(err));
+            setError(error);
+            throw error;
+        } finally{
+            setIsLoading(false);
+        }
+    }, [
+        block.users
+    ]);
+    const updateUser = useCallback(async (id, request)=>{
         setIsLoading(true);
         setError(null);
         try {
-            await block.auth.signOut();
-            setUser(null);
+            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);
@@ -1028,13 +1078,13 @@ function useUniversityBlock() {
             setIsLoading(false);
         }
     }, [
-        block.auth
+        block.users
     ]);
-    const requestPasswordReset = useCallback(async (request)=>{
+    const updateUserProfile = useCallback(async (userId, request)=>{
         setIsLoading(true);
         setError(null);
         try {
-            await block.auth.requestPasswordReset(request);
+            return await block.users.updateProfile(userId, request);
         } catch (err) {
             const error = err instanceof Error ? err : new Error(String(err));
             setError(error);
@@ -1043,13 +1093,14 @@ function useUniversityBlock() {
             setIsLoading(false);
         }
     }, [
-        block.auth
+        block.users
     ]);
-    const updatePassword = useCallback(async (request)=>{
+    const deleteUser = useCallback(async (id)=>{
         setIsLoading(true);
         setError(null);
         try {
-            await block.auth.updatePassword(request);
+            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);
@@ -1058,14 +1109,15 @@ function useUniversityBlock() {
             setIsLoading(false);
         }
     }, [
-        block.auth
+        block.users
     ]);
-    const refreshUser = useCallback(async ()=>{
+    const activateUser = useCallback(async (id)=>{
         setIsLoading(true);
         setError(null);
         try {
-            const currentUser = await block.auth.getCurrentUser();
-            setUser(currentUser);
+            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);
@@ -1074,13 +1126,15 @@ function useUniversityBlock() {
             setIsLoading(false);
         }
     }, [
-        block.auth
+        block.users
     ]);
-    const refreshToken = useCallback(async (request)=>{
+    const deactivateUser = useCallback(async (id)=>{
         setIsLoading(true);
         setError(null);
         try {
-            return await block.auth.refreshToken(request);
+            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);
@@ -1089,13 +1143,15 @@ function useUniversityBlock() {
             setIsLoading(false);
         }
     }, [
-        block.auth
+        block.users
     ]);
-    const requestMagicLink = useCallback(async (request)=>{
+    const changeUserRole = useCallback(async (id, roleUniqueId, reason, forceReauth)=>{
         setIsLoading(true);
         setError(null);
         try {
-            await block.auth.requestMagicLink(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) {
             const error = err instanceof Error ? err : new Error(String(err));
             setError(error);
@@ -1104,15 +1160,15 @@ function useUniversityBlock() {
             setIsLoading(false);
         }
     }, [
-        block.auth
+        block.users
     ]);
-    const verifyMagicLink = useCallback(async (request)=>{
+    const searchUsers = useCallback(async (query, params)=>{
         setIsLoading(true);
         setError(null);
         try {
-            const response = await block.auth.verifyMagicLink(request);
-            setUser(response.user);
-            return response;
+            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);
@@ -1121,13 +1177,15 @@ function useUniversityBlock() {
             setIsLoading(false);
         }
     }, [
-        block.auth
+        block.users
     ]);
-    const sendInvitation = useCallback(async (request)=>{
+    const searchUsersAdvanced = useCallback(async (request, params)=>{
         setIsLoading(true);
         setError(null);
         try {
-            await block.auth.sendInvitation(request);
+            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);
@@ -1136,15 +1194,28 @@ function useUniversityBlock() {
             setIsLoading(false);
         }
     }, [
-        block.auth
+        block.users
     ]);
-    const acceptInvitation = useCallback(async (request)=>{
+    const getUserProfile = useCallback(async (userUniqueId)=>{
         setIsLoading(true);
         setError(null);
         try {
-            const response = await block.auth.acceptInvitation(request);
-            setUser(response.user);
-            return response;
+            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);
@@ -1153,15 +1224,13 @@ function useUniversityBlock() {
             setIsLoading(false);
         }
     }, [
-        block.auth
+        block.users
     ]);
-    const confirmEmail = useCallback(async (token)=>{
+    const updateUserEmail = useCallback(async (userUniqueId, request)=>{
         setIsLoading(true);
         setError(null);
         try {
-            const confirmedUser = await block.auth.confirmEmail(token);
-            setUser(confirmedUser);
-            return confirmedUser;
+            return await block.users.updateEmail(userUniqueId, request);
         } catch (err) {
             const error = err instanceof Error ? err : new Error(String(err));
             setError(error);
@@ -1170,13 +1239,13 @@ function useUniversityBlock() {
             setIsLoading(false);
         }
     }, [
-        block.auth
+        block.users
     ]);
-    const resendConfirmation = useCallback(async (request)=>{
+    const getUserDevices = useCallback(async (userUniqueId, params)=>{
         setIsLoading(true);
         setError(null);
         try {
-            await block.auth.resendConfirmation(request);
+            return await block.users.getDevices(userUniqueId, params);
         } catch (err) {
             const error = err instanceof Error ? err : new Error(String(err));
             setError(error);
@@ -1185,13 +1254,13 @@ function useUniversityBlock() {
             setIsLoading(false);
         }
     }, [
-        block.auth
+        block.users
     ]);
-    const validateEmail = useCallback(async (request)=>{
+    const addUserDevice = useCallback(async (request)=>{
         setIsLoading(true);
         setError(null);
         try {
-            return await block.auth.validateEmail(request);
+            return await block.users.addDevice(request);
         } catch (err) {
             const error = err instanceof Error ? err : new Error(String(err));
             setError(error);
@@ -1200,13 +1269,13 @@ function useUniversityBlock() {
             setIsLoading(false);
         }
     }, [
-        block.auth
+        block.users
     ]);
-    const validateDocument = useCallback(async (request)=>{
+    const getUserCompanies = useCallback(async (userUniqueId)=>{
         setIsLoading(true);
         setError(null);
         try {
-            return await block.auth.validateDocument(request);
+            return await block.users.getCompanies(userUniqueId);
         } catch (err) {
             const error = err instanceof Error ? err : new Error(String(err));
             setError(error);
@@ -1215,13 +1284,13 @@ function useUniversityBlock() {
             setIsLoading(false);
         }
     }, [
-        block.auth
+        block.users
     ]);
-    const resendInvitation = useCallback(async (request)=>{
+    const addUserSubscription = useCallback(async (userUniqueId, request)=>{
         setIsLoading(true);
         setError(null);
         try {
-            return await block.auth.resendInvitation(request);
+            return await block.users.addSubscription(userUniqueId, request);
         } catch (err) {
             const error = err instanceof Error ? err : new Error(String(err));
             setError(error);
@@ -1230,13 +1299,13 @@ function useUniversityBlock() {
             setIsLoading(false);
         }
     }, [
-        block.auth
+        block.users
     ]);
-    const requestAccountRecovery = useCallback(async (request)=>{
+    const updateUserSubscription = useCallback(async (userUniqueId, request)=>{
         setIsLoading(true);
         setError(null);
         try {
-            return await block.auth.requestAccountRecovery(request);
+            return await block.users.updateSubscription(userUniqueId, request);
         } catch (err) {
             const error = err instanceof Error ? err : new Error(String(err));
             setError(error);
@@ -1245,15 +1314,13 @@ function useUniversityBlock() {
             setIsLoading(false);
         }
     }, [
-        block.auth
+        block.users
     ]);
-    const completeAccountRecovery = useCallback(async (request)=>{
+    const resendConfirmationByUniqueId = useCallback(async (userUniqueId)=>{
         setIsLoading(true);
         setError(null);
         try {
-            const recoveredUser = await block.auth.completeAccountRecovery(request);
-            setUser(recoveredUser);
-            return recoveredUser;
+            await block.users.resendConfirmationByUniqueId(userUniqueId);
         } catch (err) {
             const error = err instanceof Error ? err : new Error(String(err));
             setError(error);
@@ -1262,36 +1329,35 @@ function useUniversityBlock() {
             setIsLoading(false);
         }
     }, [
-        block.auth
+        block.users
     ]);
     const clearError = useCallback(()=>{
         setError(null);
     }, []);
     return {
-        // State
-        user,
+        users,
         isLoading,
         error,
-        isAuthenticated: user !== null,
-        // Actions
-        signIn,
-        signUp,
-        signOut,
-        requestPasswordReset,
-        updatePassword,
-        refreshUser,
-        refreshToken,
-        requestMagicLink,
-        verifyMagicLink,
-        sendInvitation,
-        acceptInvitation,
-        confirmEmail,
-        resendConfirmation,
-        validateEmail,
-        validateDocument,
-        resendInvitation,
-        requestAccountRecovery,
-        completeAccountRecovery,
+        listUsers,
+        getUser,
+        getUserByUniqueId,
+        updateUser,
+        updateUserProfile,
+        deleteUser,
+        activateUser,
+        deactivateUser,
+        changeUserRole,
+        searchUsers,
+        searchUsersAdvanced,
+        getUserProfile,
+        createUserProfile,
+        updateUserEmail,
+        getUserDevices,
+        addUserDevice,
+        getUserCompanies,
+        addUserSubscription,
+        updateUserSubscription,
+        resendConfirmationByUniqueId,
         clearError
     };
 }
@@ -1300,40 +1366,49 @@ function useUniversityBlock() {
 // Hook
 // ─────────────────────────────────────────────────────────────────────────────
 /**
- * Hook for user management operations.
+ * Hook for Multi-Factor Authentication operations.
  *
  * @example
  * ```tsx
- * function UserList() {
- *   const { users, listUsers, isLoading, error } = useUsers();
+ * function MfaSettings() {
+ *   const { setup, enable, disable, getStatus, status, isLoading, error } = useMfa();
  *
  *   useEffect(() => {
- *     listUsers({ page: 1, perPage: 20 });
- *   }, [listUsers]);
+ *     getStatus();
+ *   }, [getStatus]);
  *
- *   if (isLoading) return <Spinner />;
- *   if (error) return <Error message={error.message} />;
+ *   const handleSetup = async () => {
+ *     const data = await setup();
+ *     // Show QR code from data.qrCodeUri
+ *   };
+ *
+ *   const handleEnable = async (code: string) => {
+ *     await enable({ totpCode: code });
+ *   };
  *
  *   return (
- *     <ul>
- *       {users.map(user => (
- *         <li key={user.id}>{user.email}</li>
- *       ))}
- *     </ul>
+ *     <div>
+ *       {status?.enabled ? (
+ *         <button onClick={() => disable({ password: 'xxx' })}>Disable MFA</button>
+ *       ) : (
+ *         <button onClick={handleSetup}>Setup MFA</button>
+ *       )}
+ *     </div>
  *   );
  * }
  * ```
- */ function useUsers() {
+ */ function useMfa() {
     const block = useAuthenticationBlock();
-    const [users, setUsers] = useState([]);
     const [isLoading, setIsLoading] = useState(false);
     const [error, setError] = useState(null);
-    const listUsers = useCallback(async (params)=>{
+    const [status, setStatus] = useState(null);
+    const [setupData, setSetupData] = useState(null);
+    const setup = useCallback(async ()=>{
         setIsLoading(true);
         setError(null);
         try {
-            const result = await block.users.list(params);
-            setUsers(result.data);
+            const result = await block.mfa.setup();
+            setSetupData(result);
             return result;
         } catch (err) {
             const error = err instanceof Error ? err : new Error(String(err));
@@ -1343,13 +1418,18 @@ function useUniversityBlock() {
             setIsLoading(false);
         }
     }, [
-        block.users
+        block.mfa
     ]);
-    const getUser = useCallback(async (id)=>{
+    const enable = useCallback(async (request)=>{
         setIsLoading(true);
         setError(null);
         try {
-            return await block.users.get(id);
+            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);
@@ -1358,13 +1438,17 @@ function useUniversityBlock() {
             setIsLoading(false);
         }
     }, [
-        block.users
+        block.mfa
     ]);
-    const getUserByUniqueId = useCallback(async (uniqueId)=>{
+    const disable = useCallback(async (request)=>{
         setIsLoading(true);
         setError(null);
         try {
-            return await block.users.getByUniqueId(uniqueId);
+            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);
@@ -1373,15 +1457,13 @@ function useUniversityBlock() {
             setIsLoading(false);
         }
     }, [
-        block.users
+        block.mfa
     ]);
-    const updateUser = useCallback(async (id, request)=>{
+    const verify = useCallback(async (request)=>{
         setIsLoading(true);
         setError(null);
         try {
-            const updated = await block.users.update(id, request);
-            setUsers((prev)=>prev.map((u)=>u.id === id ? updated : u));
-            return updated;
+            return await block.mfa.verify(request);
         } catch (err) {
             const error = err instanceof Error ? err : new Error(String(err));
             setError(error);
@@ -1390,13 +1472,15 @@ function useUniversityBlock() {
             setIsLoading(false);
         }
     }, [
-        block.users
+        block.mfa
     ]);
-    const updateUserProfile = useCallback(async (userId, request)=>{
+    const getStatus = useCallback(async ()=>{
         setIsLoading(true);
         setError(null);
         try {
-            return await block.users.updateProfile(userId, request);
+            const result = await block.mfa.status();
+            setStatus(result);
+            return result;
         } catch (err) {
             const error = err instanceof Error ? err : new Error(String(err));
             setError(error);
@@ -1405,14 +1489,64 @@ function useUniversityBlock() {
             setIsLoading(false);
         }
     }, [
-        block.users
+        block.mfa
     ]);
-    const deleteUser = useCallback(async (id)=>{
+    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 {
-            await block.users.delete(id);
-            setUsers((prev)=>prev.filter((u)=>u.id !== id));
+            return await block.oauth.loginWithFacebook(request);
         } catch (err) {
             const error = err instanceof Error ? err : new Error(String(err));
             setError(error);
@@ -1421,15 +1555,13 @@ function useUniversityBlock() {
             setIsLoading(false);
         }
     }, [
-        block.users
+        block.oauth
     ]);
-    const activateUser = useCallback(async (id)=>{
+    const loginWithGoogle = useCallback(async (request)=>{
         setIsLoading(true);
         setError(null);
         try {
-            const activated = await block.users.activate(id);
-            setUsers((prev)=>prev.map((u)=>u.id === id ? activated : u));
-            return activated;
+            return await block.oauth.loginWithGoogle(request);
         } catch (err) {
             const error = err instanceof Error ? err : new Error(String(err));
             setError(error);
@@ -1438,15 +1570,13 @@ function useUniversityBlock() {
             setIsLoading(false);
         }
     }, [
-        block.users
+        block.oauth
     ]);
-    const deactivateUser = useCallback(async (id)=>{
+    const loginWithTenant = useCallback(async (request)=>{
         setIsLoading(true);
         setError(null);
         try {
-            const deactivated = await block.users.deactivate(id);
-            setUsers((prev)=>prev.map((u)=>u.id === id ? deactivated : u));
-            return deactivated;
+            return await block.oauth.loginWithTenant(request);
         } catch (err) {
             const error = err instanceof Error ? err : new Error(String(err));
             setError(error);
@@ -1455,15 +1585,13 @@ function useUniversityBlock() {
             setIsLoading(false);
         }
     }, [
-        block.users
+        block.oauth
     ]);
-    const changeUserRole = useCallback(async (id, roleUniqueId, reason, forceReauth)=>{
+    const introspectToken = useCallback(async (token)=>{
         setIsLoading(true);
         setError(null);
         try {
-            const updated = await block.users.changeRole(id, roleUniqueId, reason, forceReauth);
-            setUsers((prev)=>prev.map((u)=>u.id === id ? updated : u));
-            return updated;
+            return await block.oauth.introspectToken(token);
         } catch (err) {
             const error = err instanceof Error ? err : new Error(String(err));
             setError(error);
@@ -1472,14 +1600,44 @@ function useUniversityBlock() {
             setIsLoading(false);
         }
     }, [
-        block.users
+        block.oauth
     ]);
-    const searchUsers = useCallback(async (query, params)=>{
+    const revokeToken = useCallback(async (request)=>{
         setIsLoading(true);
         setError(null);
         try {
-            const result = await block.users.search(query, params);
-            setUsers(result.data);
+            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));
@@ -1489,14 +1647,104 @@ function useUniversityBlock() {
             setIsLoading(false);
         }
     }, [
-        block.users
+        block.oauth
     ]);
-    const searchUsersAdvanced = useCallback(async (request, params)=>{
+    const revokeTenantContext = useCallback(async ()=>{
         setIsLoading(true);
         setError(null);
         try {
-            const result = await block.users.searchAdvanced(request, params);
-            setUsers(result.data);
+            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));
@@ -1506,13 +1754,15 @@ function useUniversityBlock() {
             setIsLoading(false);
         }
     }, [
-        block.users
+        block.avatars
     ]);
-    const getUserProfile = useCallback(async (userUniqueId)=>{
+    const get = useCallback(async (userUniqueId)=>{
         setIsLoading(true);
         setError(null);
         try {
-            return await block.users.getProfile(userUniqueId);
+            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);
@@ -1521,13 +1771,19 @@ function useUniversityBlock() {
             setIsLoading(false);
         }
     }, [
-        block.users
+        block.avatars
     ]);
-    const createUserProfile = useCallback(async (request)=>{
+    const create = useCallback(async (userUniqueId, request)=>{
         setIsLoading(true);
         setError(null);
         try {
-            return await block.users.createProfile(request);
+            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);
@@ -1536,13 +1792,16 @@ function useUniversityBlock() {
             setIsLoading(false);
         }
     }, [
-        block.users
+        block.avatars
     ]);
-    const updateUserEmail = useCallback(async (userUniqueId, request)=>{
+    const update = useCallback(async (userUniqueId, request)=>{
         setIsLoading(true);
         setError(null);
         try {
-            return await block.users.updateEmail(userUniqueId, request);
+            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);
@@ -1551,13 +1810,15 @@ function useUniversityBlock() {
             setIsLoading(false);
         }
     }, [
-        block.users
+        block.avatars
     ]);
-    const getUserDevices = useCallback(async (userUniqueId, params)=>{
+    const remove = useCallback(async (userUniqueId)=>{
         setIsLoading(true);
         setError(null);
         try {
-            return await block.users.getDevices(userUniqueId, params);
+            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);
@@ -1566,13 +1827,13 @@ function useUniversityBlock() {
             setIsLoading(false);
         }
     }, [
-        block.users
+        block.avatars
     ]);
-    const addUserDevice = useCallback(async (request)=>{
+    const presignUpload = useCallback(async (userUniqueId, filename)=>{
         setIsLoading(true);
         setError(null);
         try {
-            return await block.users.addDevice(request);
+            return await block.avatars.presignUpload(userUniqueId, filename);
         } catch (err) {
             const error = err instanceof Error ? err : new Error(String(err));
             setError(error);
@@ -1581,13 +1842,13 @@ function useUniversityBlock() {
             setIsLoading(false);
         }
     }, [
-        block.users
+        block.avatars
     ]);
-    const getUserCompanies = useCallback(async (userUniqueId)=>{
+    const multipartPresign = useCallback(async (userUniqueId, request)=>{
         setIsLoading(true);
         setError(null);
         try {
-            return await block.users.getCompanies(userUniqueId);
+            return await block.avatars.multipartPresign(userUniqueId, request);
         } catch (err) {
             const error = err instanceof Error ? err : new Error(String(err));
             setError(error);
@@ -1596,13 +1857,13 @@ function useUniversityBlock() {
             setIsLoading(false);
         }
     }, [
-        block.users
+        block.avatars
     ]);
-    const addUserSubscription = useCallback(async (userUniqueId, request)=>{
+    const multipartComplete = useCallback(async (userUniqueId, request)=>{
         setIsLoading(true);
         setError(null);
         try {
-            return await block.users.addSubscription(userUniqueId, request);
+            return await block.avatars.multipartComplete(userUniqueId, request);
         } catch (err) {
             const error = err instanceof Error ? err : new Error(String(err));
             setError(error);
@@ -1611,13 +1872,67 @@ function useUniversityBlock() {
             setIsLoading(false);
         }
     }, [
-        block.users
+        block.avatars
     ]);
-    const updateUserSubscription = useCallback(async (userUniqueId, request)=>{
+    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 {
-            return await block.users.updateSubscription(userUniqueId, request);
+            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);
@@ -1626,13 +1941,13 @@ function useUniversityBlock() {
             setIsLoading(false);
         }
     }, [
-        block.users
+        block.tenants
     ]);
-    const resendConfirmationByUniqueId = useCallback(async (userUniqueId)=>{
+    const validateCode = useCallback(async (request)=>{
         setIsLoading(true);
         setError(null);
         try {
-            await block.users.resendConfirmationByUniqueId(userUniqueId);
+            return await block.tenants.validateCode(request);
         } catch (err) {
             const error = err instanceof Error ? err : new Error(String(err));
             setError(error);
@@ -1641,35 +1956,97 @@ function useUniversityBlock() {
             setIsLoading(false);
         }
     }, [
-        block.users
+        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 {
-        users,
+        tenants,
         isLoading,
         error,
-        listUsers,
-        getUser,
-        getUserByUniqueId,
-        updateUser,
-        updateUserProfile,
-        deleteUser,
-        activateUser,
-        deactivateUser,
-        changeUserRole,
-        searchUsers,
-        searchUsersAdvanced,
-        getUserProfile,
-        createUserProfile,
-        updateUserEmail,
-        getUserDevices,
-        addUserDevice,
-        getUserCompanies,
-        addUserSubscription,
-        updateUserSubscription,
-        resendConfirmationByUniqueId,
+        listChildren,
+        validateCode,
+        searchByName,
+        searchByCode,
+        createTenantUser,
+        updateOnboarding,
+        updateSales,
         clearError
     };
 }
@@ -1902,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 };