mirror of
https://github.com/langgenius/dify.git
synced 2026-04-29 23:18:05 +08:00
BREAKING CHANGE: commonLayout is now an async Server Component that prefetches user-profile and current-workspace on the server via TanStack Query's prefetchQuery + HydrationBoundary pattern. This replaces the previous purely client-side data fetching approach. Key changes: - **SSR data prefetch (root layout)**: prefetch systemFeatures and setupStatus in the root layout server component, wrap children with HydrationBoundary to hydrate TanStack Query cache on the client. - **SSR data prefetch (commonLayout)**: convert commonLayout from a client component to an async server component that prefetches user-profile (with x-version/x-env response headers) and current-workspace. Client-side providers/UI extracted to a new layout-client.tsx component. - **Add loading.tsx (Next.js convention)**: add a Next.js loading.tsx file in commonLayout that shows a centered spinner. This replaces the deleted Splash component but works via Next.js built-in Suspense boundary for route segments, not a client-side overlay. - **Extract shared SSR fetch utilities (utils/ssr-fetch.ts)**: create serverFetch (unauthenticated) and serverFetchWithAuth (with cookie forwarding + CSRF token). getAuthHeaders is wrapped with React.cache() for per-request deduplication across multiple SSR fetches. - **Refactor AppInitializer**: split single monolithic async IIFE effect into three independent useEffects (oauth tracking, education verify, setup status check). Use useReducer for init flag, useRef to prevent duplicate tracking in StrictMode. Now reads setupStatus from TanStack Query cache (useSetupStatusQuery) instead of fetching independently. - **Refactor global-public-context**: move Zustand store sync from queryFn side-effect to a dedicated useEffect, keeping queryFn pure. fetchSystemFeatures now simply returns the API response. - **Fix usePSInfo SSR crash**: defer globalThis.location access from hook top-level to callback execution time via getDomain() helper, preventing "Cannot read properties of undefined" during server render. - **Remove Splash component**: delete the client-side loading overlay that relied on useIsLogin polling, replaced by Next.js loading.tsx. - **Remove staleTime/gcTime overrides in useUserProfile**: allow the SSR-prefetched data to be reused via default cache policy instead of forcing refetch on every mount. - **Revert middleware auth guard**: remove the cookie-based session check in proxy.ts that caused false redirects to /signin for authenticated users (Dify's auth uses token refresh, not simple cookie presence).