- {object.relationships.map((rel, i) => (
+ {(object.relationships ?? []).map((rel, i) => (
` and `save(items: FavoriteItem[]): Promise`.
+ * When the adapter is provided, localStorage should be used only as a fallback
+ * during the initial load while the server response is in-flight.
+ *
+ * @module
+ */
+
+import {
+ createContext,
+ useCallback,
+ useContext,
+ useEffect,
+ useMemo,
+ useState,
+ type ReactNode,
+} from 'react';
+
+// ---------------------------------------------------------------------------
+// Types
+// ---------------------------------------------------------------------------
+
+export interface FavoriteItem {
+ /** Unique key, e.g. "object:contact" or "dashboard:sales_overview" */
+ id: string;
+ label: string;
+ href: string;
+ type: 'object' | 'dashboard' | 'page' | 'report';
+ /** ISO timestamp of when the item was favorited */
+ favoritedAt: string;
+}
+
+interface FavoritesContextValue {
+ favorites: FavoriteItem[];
+ addFavorite: (item: Omit) => void;
+ removeFavorite: (id: string) => void;
+ toggleFavorite: (item: Omit) => void;
+ isFavorite: (id: string) => boolean;
+ clearFavorites: () => void;
+}
+
+// ---------------------------------------------------------------------------
+// Storage helpers
+// ---------------------------------------------------------------------------
+
+const STORAGE_KEY = 'objectui-favorites';
+const MAX_FAVORITES = 20;
+
+function loadFavorites(): FavoriteItem[] {
+ try {
+ const raw = localStorage.getItem(STORAGE_KEY);
+ return raw ? JSON.parse(raw) : [];
+ } catch {
+ return [];
+ }
+}
+
+function saveFavorites(items: FavoriteItem[]) {
+ try {
+ localStorage.setItem(STORAGE_KEY, JSON.stringify(items));
+ } catch {
+ // Storage full — silently ignore
+ }
+}
+
+// ---------------------------------------------------------------------------
+// Context
+// ---------------------------------------------------------------------------
+
+const FavoritesContext = createContext(null);
+
+// ---------------------------------------------------------------------------
+// Provider
+// ---------------------------------------------------------------------------
+
+interface FavoritesProviderProps {
+ children: ReactNode;
+}
+
+export function FavoritesProvider({ children }: FavoritesProviderProps) {
+ const [favorites, setFavorites] = useState(loadFavorites);
+
+ // Re-sync from storage on mount (handles cases where storage was written
+ // before this provider was mounted, e.g. on initial page load).
+ useEffect(() => {
+ setFavorites(loadFavorites());
+ }, []);
+
+ const addFavorite = useCallback(
+ (item: Omit) => {
+ setFavorites(prev => {
+ if (prev.some(f => f.id === item.id)) return prev;
+ const updated = [
+ { ...item, favoritedAt: new Date().toISOString() },
+ ...prev,
+ ].slice(0, MAX_FAVORITES);
+ saveFavorites(updated);
+ return updated;
+ });
+ },
+ [],
+ );
+
+ const removeFavorite = useCallback((id: string) => {
+ setFavorites(prev => {
+ const updated = prev.filter(f => f.id !== id);
+ saveFavorites(updated);
+ return updated;
+ });
+ }, []);
+
+ const toggleFavorite = useCallback(
+ (item: Omit) => {
+ setFavorites(prev => {
+ const exists = prev.some(f => f.id === item.id);
+ const updated = exists
+ ? prev.filter(f => f.id !== item.id)
+ : [{ ...item, favoritedAt: new Date().toISOString() }, ...prev].slice(
+ 0,
+ MAX_FAVORITES,
+ );
+ saveFavorites(updated);
+ return updated;
+ });
+ },
+ [],
+ );
+
+ const clearFavorites = useCallback(() => {
+ setFavorites([]);
+ saveFavorites([]);
+ }, []);
+
+ const value = useMemo(
+ () => ({
+ favorites,
+ addFavorite,
+ removeFavorite,
+ toggleFavorite,
+ // Inlined here so useMemo sees the freshest `favorites` without needing
+ // a separate useCallback([favorites]) entry in the deps array.
+ isFavorite: (id: string) => favorites.some(f => f.id === id),
+ clearFavorites,
+ }),
+ // addFavorite / removeFavorite / toggleFavorite / clearFavorites are all
+ // stable (useCallback with [] deps) and never cause extra re-renders.
+ [favorites, addFavorite, removeFavorite, toggleFavorite, clearFavorites],
+ );
+
+ return (
+
+ {children}
+
+ );
+}
+
+// ---------------------------------------------------------------------------
+// Hook
+// ---------------------------------------------------------------------------
+
+/**
+ * Access shared favorites state.
+ *
+ * Must be used inside ``.
+ */
+export function useFavorites(): FavoritesContextValue {
+ const ctx = useContext(FavoritesContext);
+ if (!ctx) {
+ throw new Error('useFavorites must be used within a FavoritesProvider');
+ }
+ return ctx;
+}
diff --git a/apps/console/src/hooks/useFavorites.ts b/apps/console/src/hooks/useFavorites.ts
index 428322360..24170b87b 100644
--- a/apps/console/src/hooks/useFavorites.ts
+++ b/apps/console/src/hooks/useFavorites.ts
@@ -1,102 +1,14 @@
/**
- * useFavorites
+ * useFavorites — re-export shim
*
- * Tracks user-favorited items (objects, dashboards, pages, reports) with
- * localStorage persistence. Exposes helpers to toggle, add, remove, and
- * retrieve favorites.
+ * The favorites state has been migrated to a React Context so all consumers
+ * share a single state instance (fixes star toggle not updating HomePage).
+ *
+ * All existing imports of `useFavorites` and `FavoriteItem` from this path
+ * continue to work without any changes at the call sites.
+ *
+ * @see apps/console/src/context/FavoritesProvider.tsx
* @module
*/
-import { useState, useCallback, useEffect } from 'react';
-
-export interface FavoriteItem {
- /** Unique key, e.g. "object:contact" or "dashboard:sales_overview" */
- id: string;
- label: string;
- href: string;
- type: 'object' | 'dashboard' | 'page' | 'report';
- /** ISO timestamp of when the item was favorited */
- favoritedAt: string;
-}
-
-const STORAGE_KEY = 'objectui-favorites';
-const MAX_FAVORITES = 20;
-
-function loadFavorites(): FavoriteItem[] {
- try {
- const raw = localStorage.getItem(STORAGE_KEY);
- return raw ? JSON.parse(raw) : [];
- } catch {
- return [];
- }
-}
-
-function saveFavorites(items: FavoriteItem[]) {
- try {
- localStorage.setItem(STORAGE_KEY, JSON.stringify(items));
- } catch {
- // Storage full — silently ignore
- }
-}
-
-export function useFavorites() {
- const [favorites, setFavorites] = useState(loadFavorites);
-
- // Sync from storage on mount
- useEffect(() => {
- setFavorites(loadFavorites());
- }, []);
-
- const addFavorite = useCallback(
- (item: Omit) => {
- setFavorites(prev => {
- // Don't add duplicates
- if (prev.some(f => f.id === item.id)) return prev;
- const updated = [
- { ...item, favoritedAt: new Date().toISOString() },
- ...prev,
- ].slice(0, MAX_FAVORITES);
- saveFavorites(updated);
- return updated;
- });
- },
- [],
- );
-
- const removeFavorite = useCallback((id: string) => {
- setFavorites(prev => {
- const updated = prev.filter(f => f.id !== id);
- saveFavorites(updated);
- return updated;
- });
- }, []);
-
- const toggleFavorite = useCallback(
- (item: Omit) => {
- setFavorites(prev => {
- const exists = prev.some(f => f.id === item.id);
- const updated = exists
- ? prev.filter(f => f.id !== item.id)
- : [{ ...item, favoritedAt: new Date().toISOString() }, ...prev].slice(
- 0,
- MAX_FAVORITES,
- );
- saveFavorites(updated);
- return updated;
- });
- },
- [],
- );
-
- const isFavorite = useCallback(
- (id: string) => favorites.some(f => f.id === id),
- [favorites],
- );
-
- const clearFavorites = useCallback(() => {
- setFavorites([]);
- saveFavorites([]);
- }, []);
-
- return { favorites, addFavorite, removeFavorite, toggleFavorite, isFavorite, clearFavorites };
-}
+export { useFavorites, type FavoriteItem } from '../context/FavoritesProvider';