feat: 收口文档桥接与 OnlyOffice/Sidebar 回归

- 为 documents.save/meta/content、blocks.patch 与 sidebar.dataset.list 补齐 Rust 协议映射、共享契约与桥接执行器 - 对齐 BlockNote、Mindmap、OnlyOffice 的保存/路由元信息，并补真实浏览器回归脚本与 OnlyOffice 部署基线 - 忽略 Rust 本地构建产物与 Harness 调试状态文件，避免临时产物进入仓库历史
2026-04-15 03:06:29 +08:00
parent 84a8454fa9
commit b33ffb99e7
51 changed files with 3260 additions and 379 deletions
@@ -0,0 +1,75 @@
+import { api } from "@/lib/convex/api";
+import { getAuthedConvexClient } from "@/lib/convex/route";
+import {
+  buildDocumentBridgeMutationRequest,
+  executeDocumentBridgeMutationRequest,
+  type CommandEnvelope,
+  type BridgeContext,
+} from "@/lib/documents/bridge";
+import { recordBridgeCommandArtifacts } from "@/lib/documents/bridge-log";
+import type { DocumentSavePayload } from "@/lib/documents/save-contract";
+import { DocumentBridgeError } from "@/lib/documents/bridge";
+
+export type DocumentSaveExecutionResult = {
+  requestId: string;
+  traceId: string;
+  commandId: string;
+  commandName: string;
+  revision: number | null;
+  conflictDetectionKey: string | null;
+};
+
+export async function executeSaveBridgeCommand(input: {
+  context: BridgeContext;
+  envelope: CommandEnvelope<DocumentSavePayload>;
+}): Promise<DocumentSaveExecutionResult> {
+  const { client } = await getAuthedConvexClient();
+  const mutationRequest = buildDocumentBridgeMutationRequest({
+    context: input.context,
+    envelope: input.envelope,
+    mapConvexArgs: (payload) => ({
+      id: payload.documentId,
+      content: payload.content,
+      expectedRevision: payload.revision,
+      conflictDetectionKey: payload.conflictDetectionKey,
+    }),
+  });
+
+  let mutationResult;
+  try {
+    mutationResult = await executeDocumentBridgeMutationRequest({
+      client,
+      mutation: api.documents.updateContent,
+      request: mutationRequest,
+    });
+  } catch (error) {
+    if (error instanceof Error && /正文(内容已变更|冲突检测失败)/.test(error.message)) {
+      throw new DocumentBridgeError(error.message, 409, "REJECTED", {
+        reason: "content_conflict",
+        revision: input.envelope.payload.revision,
+        conflictDetectionKey: input.envelope.payload.conflictDetectionKey,
+      });
+    }
+    throw error;
+  }
+  await recordBridgeCommandArtifacts({
+    context: input.context,
+    envelope: input.envelope,
+  });
+
+  return {
+    requestId: input.context.requestId,
+    traceId: input.context.traceId,
+    commandId: input.envelope.commandId,
+    commandName: input.envelope.name,
+    revision:
+      typeof mutationResult?.revision === "number" && Number.isInteger(mutationResult.revision)
+        ? mutationResult.revision
+        : null,
+    conflictDetectionKey:
+      typeof mutationResult?.conflict_detection_key === "string" &&
+      mutationResult.conflict_detection_key.trim()
+        ? mutationResult.conflict_detection_key
+        : null,
+  };
+}