feat: make the site database authoritative for documents and catalog

apps/docs/src/pages/api/documents/source.ts

@@ -0,0 +1,22 @@
+import type { NextApiRequest, NextApiResponse } from "next";
+import { readDocument } from "@/lib/docs";
+
+// The proxy protects Markdown just like the rendered document and search index.
+export default function handler(request: NextApiRequest, response: NextApiResponse) {
+  response.setHeader("Cache-Control", "private, no-store");
+  if (request.method !== "GET") {
+    response.setHeader("Allow", "GET");
+    return response.status(405).end();
+  }
+  const slug = request.query.slug;
+  if (typeof slug !== "string") return response.status(400).json({ error: "缺少文档地址" });
+  try {
+    const doc = readDocument(slug);
+    if (!doc) return response.status(404).end();
+    response.setHeader("Content-Type", "text/plain; charset=utf-8");
+    response.setHeader("X-Content-Type-Options", "nosniff");
+    return response.status(200).send(doc.content);
+  } catch {
+    return response.status(503).json({ error: "文档数据库暂时不可用" });
+  }
+}

apps/docs/src/pages/api/search.ts

@@ -1,5 +1,5 @@
 import type { NextApiRequest, NextApiResponse } from "next";
-import { listDocs, readDoc } from "@/lib/docs";
+import { allDocuments } from "@/lib/docs";
 
 // The proxy authenticates this endpoint, including index content.
 export default async function handler(request: NextApiRequest, response: NextApiResponse) {
@@ -8,9 +8,10 @@ export default async function handler(request: NextApiRequest, response: NextApi
     response.setHeader("Allow", "GET");
     return response.status(405).end();
   }
-  const docs = await listDocs();
-  const index = await Promise.all(docs.map(async (doc) => ({
-    ...doc, searchText: (await readDoc(doc.slug)).content,
-  })));
-  response.status(200).json(index);
+  try {
+    const index = allDocuments().map(({ content, ...doc }) => ({ ...doc, searchText: content }));
+    return response.status(200).json(index);
+  } catch {
+    return response.status(503).json({ error: "文档数据库暂时不可用" });
+  }
 }