Never stop coding. Free MIT AI gateway: one endpoint, 375 providers (150+ free), 1,400+ models Kimi, Claude, GPT, Gemini, GLM, DeepSeek, MiniMax. Works with Claude Code, Codex, Cursor, OpenCode, Cline & Copilot. Quota-aware auto-fallback, RTK+Caveman compression saves 15-95% tokens, MCP/A2A, Desktop/PWA. Built by 900+ contributors
TypeScript a2aai-agentsai-gatewayanthropicclaudeclaude-codeclinecodexcopilotcursordeepseekfree-aigeminikimillm-gatewaymcpopenaiopenai-proxyqwentoken-saver
"use client";
import { NextIntlClientProvider, useTranslations } from "next-intl";
import { useEffect, useState } from "react";
import { DEFAULT_LOCALE, LOCALES, LOCALE_COOKIE } from "@/i18n/config";
/**
* Global Error Page — FASE-04 Error Handling
*
* Root-level error boundary for unrecoverable errors.
* This is the last resort — catches errors that the per-page
* error.js boundaries don't handle.
*
* NOTE: this module must never statically import a full locale catalog
* (`@/i18n/messages/en.json` is ~770 KB). Next.js includes the root
* global-error chunk in the initial HTML of EVERY page, so a static import
* ships the whole English catalog on every route. Only the handful of
* `publicSystem.globalError` strings are needed up front — they live below
* as `FALLBACK_EN_GLOBAL_ERROR` and are kept in sync with en.json by
* `tests/unit/global-error-messages.test.ts`. Non-default locales load via
* the dynamic import in the effect below (async chunk, fetched only when a
* global error actually renders). Those generated chunks contain only the
* error-boundary strings, so full catalogs stay outside the client graph.
*/
const FALLBACK_EN_GLOBAL_ERROR = {
title: "Something went wrong",
description: "An unexpected error occurred. This has been logged and our team will investigate.",
detailsAriaLabel: "Error details",
retryAriaLabel: "Retry loading the page",
tryAgain: "Try Again",
statusAriaLabel: "Open system status",
systemStatus: "System Status",
} as const;
const FALLBACK_EN_MESSAGES = {
publicSystem: { globalError: { ...FALLBACK_EN_GLOBAL_ERROR } },
};
interface GlobalErrorProps {
error: Error & { digest?: string };
reset: () => void;
}
function getCookieLocale() {
const cookie = document.cookie
.split(";")
.map((entry) => entry.trim())
.find((entry) => entry.startsWith(`${LOCALE_COOKIE}=`));
const locale = cookie?.slice(`${LOCALE_COOKIE}=`.length) || DEFAULT_LOCALE;
return LOCALES.includes(locale) ? locale : DEFAULT_LOCALE;
}
function buildGlobalErrorMessages(localeMessages: Record<string, unknown>) {
const publicSystem = localeMessages.publicSystem;
const globalError =
publicSystem && typeof publicSystem === "object" && !Array.isArray(publicSystem)
? (publicSystem as Record<string, unknown>).globalError
: null;
const translated =
globalError && typeof globalError === "object" && !Array.isArray(globalError)
? Object.fromEntries(
Object.entries(globalError).filter(
([, value]) => typeof value === "string" && !value.startsWith("__MISSING__:")
)
)
: {};
return {
publicSystem: {
globalError: {
...FALLBACK_EN_GLOBAL_ERROR,
...translated,
},
},
};
}
function GlobalErrorContent({ error, reset }: GlobalErrorProps) {
const t = useTranslations("publicSystem");
return (
<main role="alert" aria-live="assertive" className="flex flex-col items-center">
<div className="text-[64px] mb-4" aria-hidden="true">
⚠️
</div>
<h1 className="text-[28px] font-bold mb-2">{t("globalError.title")}</h1>
<p className="text-[15px] text-text-muted max-w-[400px] leading-relaxed mb-6">
{t("globalError.description")}
</p>
{process.env.NODE_ENV === "development" && error?.message && (
<pre
className="p-4 rounded-lg bg-red-500/10 border border-red-500/30 text-red-500 text-xs max-w-[600px] overflow-auto text-left mb-6"
aria-label={t("globalError.detailsAriaLabel")}
>
{error.message}
</pre>
)}
<div className="flex flex-col sm:flex-row gap-3">
<button
onClick={reset}
aria-label={t("globalError.retryAriaLabel")}
className="px-8 py-3 rounded-[10px] text-white border-none text-sm font-semibold cursor-pointer transition-transform duration-200 motion-reduce:transition-none motion-reduce:transform-none shadow-warm hover:-translate-y-0.5 bg-gradient-to-br from-primary to-primary-hover focus:outline-2 focus:outline-offset-2 focus:outline-primary"
>
{t("globalError.tryAgain")}
</button>
<a
href="/status"
className="px-8 py-3 rounded-[10px] text-sm font-semibold border border-[var(--color-border)] hover:bg-[var(--color-bg-alt)] no-underline focus:outline-2 focus:outline-offset-2 focus:outline-primary"
aria-label={t("globalError.statusAriaLabel")}
>
{t("globalError.systemStatus")}
</a>
</div>
</main>
);
}
export default function GlobalError({ error, reset }: GlobalErrorProps) {
const [locale, setLocale] = useState<string>(DEFAULT_LOCALE);
const [messages, setMessages] = useState<Record<string, unknown>>(FALLBACK_EN_MESSAGES);
useEffect(() => {
void (async () => {
await Promise.resolve();
const nextLocale = getCookieLocale();
setLocale(nextLocale);
if (nextLocale === DEFAULT_LOCALE) return;
try {
const mod = await import(`../i18n/global-error-messages/${nextLocale}.json`);
setMessages(buildGlobalErrorMessages(mod.default as Record<string, unknown>));
} catch {
setMessages(FALLBACK_EN_MESSAGES);
}
})();
}, []);
return (
<html lang={locale}>
<body className="flex flex-col items-center justify-center min-h-screen p-6 bg-bg text-text-main font-[system-ui,-apple-system,sans-serif] text-center m-0">
<NextIntlClientProvider locale={locale} messages={messages}>
<GlobalErrorContent error={error} reset={reset} />
</NextIntlClientProvider>
</body>
</html>
);
}