import { ReactNode } from "react"; import { ErrorBoundary } from "react-error-boundary"; import { Button, Center, Stack, Text } from "@mantine/core"; const RELOAD_FLAG = "chunk-reload-attempted"; // Heuristic detection of a failed dynamic import. Since the code-splitting work, // every route (plus Aside / AiChatWindow) is React.lazy: when a new deploy // replaces the hashed chunks, a tab left open on the old index.html requests a // chunk URL that now 404s, and React.lazy rejects. Browsers / Vite surface these // with a ChunkLoadError name or one of these messages. export function isChunkLoadError(error: unknown): boolean { if (!error) return false; const name = (error as { name?: string }).name ?? ""; const message = (error as { message?: string }).message ?? ""; return ( name === "ChunkLoadError" || /Failed to fetch dynamically imported module/i.test(message) || /error loading dynamically imported module/i.test(message) || /Importing a module script failed/i.test(message) ); } function handleError(error: unknown) { if (!isChunkLoadError(error)) return; // A stale-chunk 404 is cured by a full reload that re-fetches index.html and // the new chunk manifest. Auto-reload once, guarding against a reload loop // (e.g. a genuinely missing chunk) with a one-shot sessionStorage flag. If the // flag is already set we fall through to the manual recovery UI below. try { if (sessionStorage.getItem(RELOAD_FLAG)) return; sessionStorage.setItem(RELOAD_FLAG, "1"); } catch { // sessionStorage unavailable (private mode / disabled): skip the automatic // reload rather than risk an unguarded loop; the fallback UI still recovers. return; } window.location.reload(); } // Root-level boundary that sits ABOVE every route-level Suspense boundary so a // lazy route/component chunk failure is caught here instead of unmounting the // whole tree into a blank white screen. Per-feature ErrorBoundaries (page.tsx, // transclusion, page-embed) remain in place underneath for their local errors. export function ChunkLoadErrorBoundary({ children }: { children: ReactNode }) { return ( { const chunk = isChunkLoadError(error); return (
{chunk ? "A new version is available" : "Something went wrong"} {chunk ? "Please reload the page to load the latest version." : "An unexpected error occurred. Reloading the page may help."}
); }} > {children}
); }