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
import { notFound } from "next/navigation";
import type { Metadata } from "next";
import { cookies } from "next/headers";
import { DEFAULT_LOCALE, LOCALE_COOKIE } from "@/i18n/config";
import fs from "node:fs";
import path from "node:path";
import { resolveSafeI18nSectionDir } from "@/lib/docsI18nPath";
import { resolveDocHref, normalizeDocsMarkdownLinks } from "@/lib/docsLinkResolver";
import { getTranslations } from "next-intl/server";
// ── Locale detection ────────────────────────────────────────────────────────
function getDocsLocale(): string {
try {
const cookieStore = cookies();
return (cookieStore as any).get(LOCALE_COOKIE)?.value || DEFAULT_LOCALE;
} catch {
return DEFAULT_LOCALE;
}
}
// ── i18n fallback ───────────────────────────────────────────────────────────
// When locale ≠ "en", try to load the translated .md from
// `docs/i18n/<locale>/docs/<section>/<FILE>.md` — the exact path layout that
// `scripts/i18n/run-translation.mjs` produces. Returns rendered HTML or null.
async function tryI18nFallback(slug: string[], locale: string): Promise<string | null> {
if (!locale || locale === "en") return null;
// 🛡️ Path traversal prevention — `locale` is a user-controllable cookie, so
// validate segments + confine the resolved dir to docs/i18n before any fs read.
// Centralized in resolveSafeI18nSectionDir (pure, unit-tested).
const docsRoot = path.resolve(process.cwd(), "docs");
const sectionDir = resolveSafeI18nSectionDir(docsRoot, locale, slug);
if (!sectionDir) return null;
if (!fs.existsSync(sectionDir)) return null;
// Fumadocs lowercases slugs — match case-insensitively against i18n dir
const target = slug[slug.length - 1];
let files: string[];
try {
files = fs.readdirSync(sectionDir);
} catch {
return null;
}
const match = files.find((f) => f.toLowerCase().replace(/\.md$/, "") === target.toLowerCase());
if (!match) return null;
const filePath = path.join(sectionDir, match);
const raw = fs.readFileSync(filePath, "utf8");
// Strip the i18n header (heading + language bar + ---) before rendering.
// Translated files have: # Title (Native)\n\n🌐 Languages: ...\n\n---\n\nbody
const bodyMatch = raw.match(/^---\s*$/m);
const body =
bodyMatch && bodyMatch.index != null
? raw.slice(bodyMatch.index + bodyMatch[0].length).trim()
: raw;
// 🛡️ Sentinel: XSS protection via server-side sanitization of rendered markdown
const [{ marked }, { sanitizeDocsHtml }] = await Promise.all([
import("marked"),
import("@/lib/docsSanitizer"),
]);
const docRelPath = `${slug.join("/")}.md`;
const normalizedBody = normalizeDocsMarkdownLinks(body, docRelPath);
const html = marked.parse(normalizedBody) as string;
return sanitizeDocsHtml(html);
}
// ── Page component ──────────────────────────────────────────────────────────
export default async function Page(props: { params: Promise<{ slug: string[] }> }) {
const params = await props.params;
const { source } = await import("../../../lib/source");
const [{ DocsPage, DocsBody }, { default: defaultMdxComponents }] = await Promise.all([
import("fumadocs-ui/layouts/docs/page"),
import("fumadocs-ui/mdx"),
]);
const page = source.getPage(params.slug);
if (!page) notFound();
const locale = getDocsLocale();
const i18nHtml = await tryI18nFallback(params.slug, locale);
if (i18nHtml) {
// Render translated markdown (non-English locale with available translation)
return (
<DocsPage toc={page.data.toc} full={page.data.full}>
<DocsBody>
<div className="prose-content" dangerouslySetInnerHTML={{ __html: i18nHtml }} />
</DocsBody>
</DocsPage>
);
}
// Default: English MDX rendered natively by Fumadocs with resolved links
const MDX = page.data.body;
const docPath = page.file?.path || `${params.slug.join("/")}.md`;
const DocsLink = (linkProps: React.ComponentProps<typeof defaultMdxComponents.a>) => {
const resolved = linkProps.href ? resolveDocHref(linkProps.href, docPath) : linkProps.href;
return <defaultMdxComponents.a {...linkProps} href={resolved} />;
};
return (
<DocsPage toc={page.data.toc} full={page.data.full}>
<DocsBody>
<MDX components={{ ...defaultMdxComponents, a: DocsLink }} />
</DocsBody>
</DocsPage>
);
}
// ── Runtime metadata ───────────────────────────────────────────────────────
// Keep the docs route dynamic. Fumadocs' generated source includes build-only
// metadata that Next's Bun page-data workers cannot reliably traverse during
// generateStaticParams; rendering on request preserves the docs while keeping
// the production build Bun-compatible.
export const dynamic = "force-dynamic";
export async function generateMetadata(props: {
params: Promise<{ slug: string[] }>;
}): Promise<Metadata> {
const params = await props.params;
const { source } = await import("../../../lib/source");
const page = source.getPage(params.slug);
if (!page) return {};
const t = await getTranslations("docs");
return {
title: t("pageMetadataTitle", { title: page.data.title }),
description: page.data.description ?? t("pageMetadataDescription", { title: page.data.title }),
};
}