0.6 rust重构01

wolai-frontend/src/app/api/documents/content/route.ts

@@ -2,28 +2,57 @@ import { NextResponse } from "next/server";
 import { isConvexEnabled } from "@/lib/convex/enabled";
 import { getAuthedConvexClient } from "@/lib/convex/route";
 import { api } from "@/lib/convex/api";
+import {
+  assertDocumentId,
+  buildDocumentBridgeContext,
+  buildDocumentQueryEnvelope,
+  documentBridgeErrorResponse,
+} from "@/lib/documents/bridge";
 
 export const dynamic = "force-dynamic";
 
 export async function GET(request: Request) {
   if (isConvexEnabled()) {
-    const url = new URL(request.url);
-    const documentId = url.searchParams.get("documentId") ?? "";
+    try {
+      const url = new URL(request.url);
+      const documentId = assertDocumentId(url.searchParams.get("documentId"));
+      const workspaceId = url.searchParams.get("workspaceId")?.trim() || null;
+      const { client } = await getAuthedConvexClient();
+      const bridgeContext = await buildDocumentBridgeContext({ request, workspaceId });
+      const envelope = buildDocumentQueryEnvelope({
+        name: "documents.content.get",
+        payload: { documentId, workspaceId },
+      });
 
-    if (!documentId) {
-      return NextResponse.json({ error: "缺少 documentId" }, { status: 400 });
+      const result = await client.query(api.documents.getContent, {
+        id: documentId,
+      });
+
+      if (!result) {
+        return NextResponse.json(
+          {
+            error: "页面不存在",
+            meta: {
+              requestId: bridgeContext.requestId,
+              traceId: bridgeContext.traceId,
+              queryName: envelope.name,
+            },
+          },
+          { status: 404 },
+        );
+      }
+
+      return NextResponse.json({
+        content: result.content ?? null,
+        meta: {
+          requestId: bridgeContext.requestId,
+          traceId: bridgeContext.traceId,
+          queryName: envelope.name,
+        },
+      });
+    } catch (error) {
+      return documentBridgeErrorResponse(error);
     }
-
-    const { client } = await getAuthedConvexClient();
-    const result = await client.query(api.documents.getContent, {
-      id: documentId,
-    });
-
-    if (!result) {
-      return NextResponse.json({ error: "页面不存在" }, { status: 404 });
-    }
-
-    return NextResponse.json({ content: result.content ?? null });
   }
 
   return NextResponse.json({ error: "当前仅支持 Convex 模式" }, { status: 501 });

wolai-frontend/src/app/api/documents/meta/route.ts

@@ -0,0 +1,57 @@
+import { NextResponse } from "next/server";
+import { isConvexEnabled } from "@/lib/convex/enabled";
+import { getAuthedConvexClient } from "@/lib/convex/route";
+import { api } from "@/lib/convex/api";
+import {
+  assertDocumentId,
+  buildDocumentBridgeContext,
+  buildDocumentQueryEnvelope,
+  documentBridgeErrorResponse,
+} from "@/lib/documents/bridge";
+
+export const dynamic = "force-dynamic";
+
+export async function GET(request: Request) {
+  if (isConvexEnabled()) {
+    try {
+      const url = new URL(request.url);
+      const documentId = assertDocumentId(url.searchParams.get("documentId"));
+      const workspaceId = url.searchParams.get("workspaceId")?.trim() || null;
+      const { client } = await getAuthedConvexClient();
+      const bridgeContext = await buildDocumentBridgeContext({ request, workspaceId });
+      const envelope = buildDocumentQueryEnvelope({
+        name: "documents.meta.get",
+        payload: { documentId, workspaceId },
+      });
+
+      const doc = await client.query(api.documents.getMeta, { id: documentId });
+
+      if (!doc) {
+        return NextResponse.json(
+          {
+            error: "页面不存在",
+            meta: {
+              requestId: bridgeContext.requestId,
+              traceId: bridgeContext.traceId,
+              queryName: envelope.name,
+            },
+          },
+          { status: 404 },
+        );
+      }
+
+      return NextResponse.json({
+        doc,
+        meta: {
+          requestId: bridgeContext.requestId,
+          traceId: bridgeContext.traceId,
+          queryName: envelope.name,
+        },
+      });
+    } catch (error) {
+      return documentBridgeErrorResponse(error);
+    }
+  }
+
+  return NextResponse.json({ error: "当前仅支持 Convex 模式" }, { status: 501 });
+}

wolai-frontend/src/app/api/documents/options/route.ts

@@ -1,42 +1,65 @@
 import { NextResponse } from "next/server";
 import { isConvexEnabled } from "@/lib/convex/enabled";
-import { getAuthedConvexClient } from "@/lib/convex/route";
-import { api } from "@/lib/convex/api";
 import type { PageOptionsState } from "@/types/page-options";
+import {
+  assertDocumentId,
+  assertOptionsPatch,
+  buildDocumentBridgeContext,
+  buildDocumentCommandEnvelope,
+  documentBridgeErrorResponse,
+} from "@/lib/documents/bridge";
+import {
+  executeMetadataBridgeCommand,
+  type DocumentOptionsUpdatePayload,
+} from "@/lib/documents/metadata-command-adapter";
 
 type OptionsPayload = {
   documentId: string;
+  workspaceId?: string | null;
   options: Partial<PageOptionsState>;
 };
 
 export async function POST(request: Request) {
   if (isConvexEnabled()) {
-    const { documentId, options }: OptionsPayload = await request.json();
-    if (!documentId || !options) {
-      return NextResponse.json({ error: "缺少参数" }, { status: 400 });
+    try {
+      const { documentId, workspaceId, options }: OptionsPayload = await request.json();
+      const normalizedDocumentId = assertDocumentId(documentId);
+      assertOptionsPatch(options);
+      const normalizedWorkspaceId = workspaceId?.trim() || null;
+      const bridgeContext = await buildDocumentBridgeContext({
+        request,
+        workspaceId: normalizedWorkspaceId,
+      });
+      const envelope = buildDocumentCommandEnvelope({
+        name: "documents.options.update",
+        payload: {
+          documentId: normalizedDocumentId,
+          workspaceId: normalizedWorkspaceId,
+          options,
+        } satisfies DocumentOptionsUpdatePayload,
+        context: bridgeContext,
+        target: {
+          workspaceId: normalizedWorkspaceId,
+          pageId: normalizedDocumentId,
+        },
+      });
+      const result = await executeMetadataBridgeCommand({
+        context: bridgeContext,
+        envelope,
+      });
+
+      return NextResponse.json({
+        ok: true,
+        meta: {
+          requestId: result.requestId,
+          traceId: result.traceId,
+          commandId: result.commandId,
+          commandName: result.commandName,
+        },
+      });
+    } catch (error) {
+      return documentBridgeErrorResponse(error);
     }
-
-    const { client } = await getAuthedConvexClient();
-    await client.mutation(api.documents.updateOptions, {
-      id: documentId,
-      options: {
-        wideLayout: options.wideLayout,
-        smallText: options.smallText,
-        showHeadingNumbers: options.showHeadingNumbers,
-        showToc: options.showToc,
-        showStructure: options.showStructure,
-        protectEditing: options.protectEditing,
-        showWordCount: options.showWordCount,
-        collapseBacklinks: options.collapseBacklinks,
-        pageFont: options.pageFont,
-        layoutDensity: options.layoutDensity,
-        hideChildPages: options.hideChildPages,
-        showBlockRefCount: options.showBlockRefCount,
-        embedDefaultBlockId: typeof options.embedDefaultBlockId === "string" ? options.embedDefaultBlockId : null,
-      },
-    });
-
-    return NextResponse.json({ ok: true });
   }
 
   return NextResponse.json({ error: "当前仅支持 Convex 模式" }, { status: 501 });

wolai-frontend/src/app/api/documents/save/route.ts

@@ -2,21 +2,62 @@ import { NextResponse } from "next/server";
 import { isConvexEnabled } from "@/lib/convex/enabled";
 import { getAuthedConvexClient } from "@/lib/convex/route";
 import { api } from "@/lib/convex/api";
+import {
+  assertDocumentId,
+  buildDocumentBridgeContext,
+  buildDocumentCommandEnvelope,
+  documentBridgeErrorResponse,
+} from "@/lib/documents/bridge";
+import { recordBridgeCommandArtifacts } from "@/lib/documents/bridge-log";
 
 interface SavePayload {
   documentId: string;
+  workspaceId?: string | null;
   content: unknown;
 }
 
 export async function POST(request: Request) {
   if (isConvexEnabled()) {
-    const { documentId, content }: SavePayload = await request.json();
-    const { client } = await getAuthedConvexClient();
-    await client.mutation(api.documents.updateContent, {
-      id: documentId,
-      content,
-    });
-    return NextResponse.json({ ok: true });
+    try {
+      const { documentId, workspaceId, content }: SavePayload = await request.json();
+      const normalizedDocumentId = assertDocumentId(documentId);
+      const normalizedWorkspaceId = workspaceId?.trim() || null;
+      const bridgeContext = await buildDocumentBridgeContext({ request, workspaceId: normalizedWorkspaceId });
+      const envelope = buildDocumentCommandEnvelope({
+        name: "documents.save",
+        payload: {
+          documentId: normalizedDocumentId,
+          workspaceId: normalizedWorkspaceId,
+          content,
+        },
+        context: bridgeContext,
+        target: {
+          workspaceId: normalizedWorkspaceId,
+          pageId: normalizedDocumentId,
+        },
+      });
+
+      const { client } = await getAuthedConvexClient();
+      await client.mutation(api.documents.updateContent, {
+        id: normalizedDocumentId,
+        content: envelope.payload.content,
+      });
+      await recordBridgeCommandArtifacts({
+        context: bridgeContext,
+        envelope,
+      });
+      return NextResponse.json({
+        ok: true,
+        meta: {
+          requestId: bridgeContext.requestId,
+          traceId: bridgeContext.traceId,
+          commandId: envelope.commandId,
+          commandName: envelope.name,
+        },
+      });
+    } catch (error) {
+      return documentBridgeErrorResponse(error);
+    }
   }
 
   return NextResponse.json({ error: "当前仅支持 Convex 模式" }, { status: 501 });

wolai-frontend/src/app/api/documents/stats/route.ts

@@ -1,32 +1,65 @@
 import { NextResponse } from "next/server";
 import { isConvexEnabled } from "@/lib/convex/enabled";
-import { getAuthedConvexClient } from "@/lib/convex/route";
-import { api } from "@/lib/convex/api";
 import type { DocumentStats } from "@/types/page-options";
+import {
+  assertDocumentId,
+  assertStats,
+  buildDocumentBridgeContext,
+  buildDocumentCommandEnvelope,
+  documentBridgeErrorResponse,
+} from "@/lib/documents/bridge";
+import {
+  executeMetadataBridgeCommand,
+  type DocumentStatsUpdatePayload,
+} from "@/lib/documents/metadata-command-adapter";
 
 interface StatsPayload {
   documentId: string;
+  workspaceId?: string | null;
   stats: DocumentStats;
 }
 
 export async function POST(request: Request) {
   if (isConvexEnabled()) {
-    const { documentId, stats }: StatsPayload = await request.json();
-    if (!documentId || !stats) {
-      return NextResponse.json({ error: "缺少参数" }, { status: 400 });
+    try {
+      const { documentId, workspaceId, stats }: StatsPayload = await request.json();
+      const normalizedDocumentId = assertDocumentId(documentId);
+      assertStats(stats);
+      const normalizedWorkspaceId = workspaceId?.trim() || null;
+      const bridgeContext = await buildDocumentBridgeContext({
+        request,
+        workspaceId: normalizedWorkspaceId,
+      });
+      const envelope = buildDocumentCommandEnvelope({
+        name: "documents.stats.update",
+        payload: {
+          documentId: normalizedDocumentId,
+          workspaceId: normalizedWorkspaceId,
+          stats,
+        } satisfies DocumentStatsUpdatePayload,
+        context: bridgeContext,
+        target: {
+          workspaceId: normalizedWorkspaceId,
+          pageId: normalizedDocumentId,
+        },
+      });
+      const result = await executeMetadataBridgeCommand({
+        context: bridgeContext,
+        envelope,
+      });
+
+      return NextResponse.json({
+        ok: true,
+        meta: {
+          requestId: result.requestId,
+          traceId: result.traceId,
+          commandId: result.commandId,
+          commandName: result.commandName,
+        },
+      });
+    } catch (error) {
+      return documentBridgeErrorResponse(error);
     }
-
-    const { client } = await getAuthedConvexClient();
-    await client.mutation(api.documents.updateStats, {
-      id: documentId,
-      wordCount: stats.wordCount,
-      characterCount: stats.characterCount,
-      blockCount: stats.blockCount,
-      todoTotal: stats.todoTotal,
-      todoDone: stats.todoDone,
-    });
-
-    return NextResponse.json({ ok: true });
   }
 
   return NextResponse.json({ error: "当前仅支持 Convex 模式" }, { status: 501 });

wolai-frontend/src/app/api/documents/title/route.ts

@@ -1,22 +1,61 @@
 import { NextResponse } from "next/server";
 import { isConvexEnabled } from "@/lib/convex/enabled";
-import { getAuthedConvexClient } from "@/lib/convex/route";
-import { api } from "@/lib/convex/api";
+import {
+  assertDocumentId,
+  assertTitle,
+  buildDocumentBridgeContext,
+  buildDocumentCommandEnvelope,
+  documentBridgeErrorResponse,
+} from "@/lib/documents/bridge";
+import {
+  executeMetadataBridgeCommand,
+  type DocumentTitleUpdatePayload,
+} from "@/lib/documents/metadata-command-adapter";
 
 interface RenamePayload {
   documentId: string;
+  workspaceId?: string | null;
   title: string;
 }
 
 export async function POST(request: Request) {
   if (isConvexEnabled()) {
-    const { documentId, title }: RenamePayload = await request.json();
-    const { client } = await getAuthedConvexClient();
-    await client.mutation(api.documents.updateTitle, {
-      id: documentId,
-      title,
-    });
-    return NextResponse.json({ ok: true });
+    try {
+      const { documentId, workspaceId, title }: RenamePayload = await request.json();
+      const normalizedDocumentId = assertDocumentId(documentId);
+      const normalizedTitle = assertTitle(title);
+      const normalizedWorkspaceId = workspaceId?.trim() || null;
+      const bridgeContext = await buildDocumentBridgeContext({ request, workspaceId: normalizedWorkspaceId });
+      const envelope = buildDocumentCommandEnvelope({
+        name: "documents.title.update",
+        payload: {
+          documentId: normalizedDocumentId,
+          workspaceId: normalizedWorkspaceId,
+          title: normalizedTitle,
+        } satisfies DocumentTitleUpdatePayload,
+        context: bridgeContext,
+        target: {
+          workspaceId: normalizedWorkspaceId,
+          pageId: normalizedDocumentId,
+        },
+      });
+      const result = await executeMetadataBridgeCommand({
+        context: bridgeContext,
+        envelope,
+      });
+
+      return NextResponse.json({
+        ok: true,
+        meta: {
+          requestId: result.requestId,
+          traceId: result.traceId,
+          commandId: result.commandId,
+          commandName: result.commandName,
+        },
+      });
+    } catch (error) {
+      return documentBridgeErrorResponse(error);
+    }
   }
 
   return NextResponse.json({ error: "当前仅支持 Convex 模式" }, { status: 501 });