feat(auth): Add refreshUserData function for profile sync

Implements Option 2 (Token Refresh on Profile Page) for immediate
profile updates without requiring sign out/in.

Changes:
1. Added refreshUserData() function to AuthContext
   - Fetches fresh user data from /oauth2/userinfo endpoint
   - Returns Promise<boolean> for success/failure handling
   - Updates session state with latest user information

2. Updated AUTH.md documentation
   - Added refreshUserData to available properties
   - New example: ProfilePage with auto-refresh on mount
   - New example: Manual refresh button
   - Use case explanation for profile synchronization

Usage:
```tsx
const { refreshUserData } = useAuth();

// Auto-refresh on page load
useEffect(() => {
  refreshUserData();
}, []);

// Manual refresh
await refreshUserData();
```

Benefits:
- ✅ Immediate profile updates (no 6-hour token expiry wait)
- ✅ No sign out/in required
- ✅ Fresh data on demand
- ✅ Better UX for profile management

Related: Auth server profile edit page (auth-server commits)

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

Author: mjunaidca

robolearn-interface/AUTH.md

@@ -160,21 +160,73 @@ function SignOutButton() {
     <div>
       {/* Local sign out - user stays logged in at auth server */}
       <button onClick={() => signOut(false)}>Sign Out (Local)</button>
-      
+
       {/* Global sign out - logs out from all apps */}
       <button onClick={() => signOut(true)}>Sign Out (Global)</button>
     </div>
   );
 }
 ```
 
+#### 6. Refresh User Data (After Profile Update)
+
+```tsx
+import { useAuth } from '@/contexts/AuthContext';
+import { useEffect, useState } from 'react';
+
+function ProfilePage() {
+  const { session, refreshUserData } = useAuth();
+  const [refreshing, setRefreshing] = useState(false);
+
+  // Option A: Auto-refresh on page load
+  useEffect(() => {
+    refreshUserData();
+  }, []);
+
+  // Option B: Manual refresh button
+  const handleRefresh = async () => {
+    setRefreshing(true);
+    const success = await refreshUserData();
+    if (success) {
+      alert('Profile data refreshed!');
+    } else {
+      alert('Failed to refresh profile data');
+    }
+    setRefreshing(false);
+  };
+
+  if (!session) return <div>Please log in</div>;
+
+  return (
+    <div>
+      <h1>Profile</h1>
+      <p><strong>Name:</strong> {session.user.name}</p>
+      <p><strong>Email:</strong> {session.user.email}</p>
+      <p><strong>Software Background:</strong> {session.user.softwareBackground}</p>
+      <p><strong>Hardware Tier:</strong> {session.user.hardwareTier}</p>
+
+      <button onClick={handleRefresh} disabled={refreshing}>
+        {refreshing ? 'Refreshing...' : 'Refresh Profile Data'}
+      </button>
+
+      <a href={`${process.env.NEXT_PUBLIC_AUTH_URL}/account/profile`}>
+        Edit Profile on Auth Server
+      </a>
+    </div>
+  );
+}
+```
+
+**Use Case**: After a user updates their profile on the auth server, call `refreshUserData()` to fetch the latest information without requiring sign out/in.
+
 ### Available Properties
 
 The `useAuth()` hook returns:
 
 - **`session`**: `Session | null` - Current session object containing user info and access token
 - **`isLoading`**: `boolean` - Whether authentication state is being checked
 - **`signOut`**: `(global?: boolean) => void` - Function to sign out the user
+- **`refreshUserData`**: `() => Promise<boolean>` - Fetches fresh user data from auth server (returns true on success)
 
 ### Notes
 

robolearn-interface/src/contexts/AuthContext.tsx

@@ -21,6 +21,7 @@ interface AuthContextType {
   session: Session | null;
   isLoading: boolean;
   signOut: (global?: boolean) => void;
+  refreshUserData: () => Promise<boolean>;
 }
 
 const AuthContext = createContext<AuthContextType | undefined>(undefined);
@@ -171,8 +172,45 @@ export function AuthProvider({ children, authUrl, oauthClientId }: AuthProviderP
     }
   };
 
+  /**
+   * Refresh user data from the auth server
+   * Call this after profile updates to get the latest user information
+   * @returns true if refresh succeeded, false otherwise
+   */
+  const handleRefreshUserData = async (): Promise<boolean> => {
+    try {
+      const accessToken = localStorage.getItem('robolearn_access_token');
+
+      if (!accessToken) {
+        console.warn('No access token available for refresh');
+        return false;
+      }
+
+      // Fetch fresh user data from /oauth2/userinfo endpoint
+      const user = await fetchUserInfo(accessToken);
+
+      if (user) {
+        // Update session with fresh user data
+        setSession({ user, accessToken });
+        console.log('✅ User data refreshed successfully');
+        return true;
+      } else {
+        console.warn('⚠️ Failed to refresh user data');
+        return false;
+      }
+    } catch (error) {
+      console.error('❌ Error refreshing user data:', error);
+      return false;
+    }
+  };
+
   return (
-    <AuthContext.Provider value={{ session, isLoading, signOut: handleSignOut }}>
+    <AuthContext.Provider value={{
+      session,
+      isLoading,
+      signOut: handleSignOut,
+      refreshUserData: handleRefreshUserData
+    }}>
       {children}
     </AuthContext.Provider>
   );