"use client"; import { useCallback, useEffect, useState } from "react"; import { clearRecentSubspaces, readRecentSubspaces, rememberRecentSubspace, } from "@/lib/subspace-history"; type RecentSubspaceStorage = Pick< Storage, "getItem" | "setItem" | "removeItem" >; const unavailableLocalStorage: RecentSubspaceStorage = { getItem: () => null, setItem: () => {}, removeItem: () => {}, }; export function getLocalStorage(): RecentSubspaceStorage { try { return window.localStorage; } catch { return unavailableLocalStorage; } } export interface ScopedSubspaceHistory { scopeId: string; history: string[]; } export function getSubspaceScopeId( dataScopeKey: string, knowledgeBaseName: string, ): string { return JSON.stringify([dataScopeKey, knowledgeBaseName]); } export function selectSubspaceHistory( state: ScopedSubspaceHistory, dataScopeKey: string, knowledgeBaseName: string, ): string[] { return state.scopeId === getSubspaceScopeId(dataScopeKey, knowledgeBaseName) ? state.history : []; } /** * Per-knowledge-base subspace history persisted in localStorage. * Most recently used entries are kept first, capped at MAX_HISTORY. * History is hydrated after mount to keep the SSR-rendered tree in sync * with the initial client tree. */ export function useSubspaceHistory( dataScopeKey: string, knowledgeBaseName: string, ) { const scopeId = getSubspaceScopeId(dataScopeKey, knowledgeBaseName); const [state, setState] = useState({ scopeId, history: [], }); const history = selectSubspaceHistory(state, dataScopeKey, knowledgeBaseName); useEffect(() => { setState({ scopeId, history: readRecentSubspaces( getLocalStorage(), dataScopeKey, knowledgeBaseName, ), }); }, [scopeId, dataScopeKey, knowledgeBaseName]); const addToHistory = useCallback( (subspace: string) => { setState({ scopeId, history: rememberRecentSubspace( getLocalStorage(), dataScopeKey, knowledgeBaseName, subspace, ), }); }, [scopeId, dataScopeKey, knowledgeBaseName], ); const clearHistory = useCallback(() => { clearRecentSubspaces(getLocalStorage(), dataScopeKey, knowledgeBaseName); setState({ scopeId, history: [] }); }, [scopeId, dataScopeKey, knowledgeBaseName]); return { history, addToHistory, clearHistory }; }