@fgbg/mdocs 0.6.0

package/dist/server/routes/cli-tokens.routes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-tokens.routes.js","sourceRoot":"","sources":["../../../src/server/routes/cli-tokens.routes.ts"],"names":[],"mappings":"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"}

package/dist/server/routes/diagrams.routes.js

@@ -0,0 +1,122 @@
+import { Router } from "express";
+import { createDiagram, DiagramError, getDiagram, listAllDiagrams, removeDiagram, updateDiagram, } from "../diagrams/diagram.service.js";
+import { useLogger } from "../logger/logger.js";
+const log = useLogger("diagrams-route");
+export function buildDiagramsRouter() {
+    const router = Router();
+    router.get("/", (_req, res) => {
+        res.json({ data: listAllDiagrams() });
+    });
+    router.post("/", (req, res) => {
+        if (!req.visitor) {
+            res.status(401).json({ error: { code: "UNAUTHENTICATED", message: "no visitor" } });
+            return;
+        }
+        const body = (req.body ?? {});
+        try {
+            const diagram = createDiagram({
+                actorVisitorId: req.visitor.visitor_id,
+                title: typeof body.title === "string" ? body.title : undefined,
+                data: body.data,
+            });
+            res.status(201).json({ data: diagram });
+        }
+        catch (err) {
+            respondError(res, err, "diagrams-route.create");
+        }
+    });
+    router.get("/:diagramId", (req, res) => {
+        const diagramId = req.params.diagramId;
+        if (!diagramId) {
+            res.status(400).json({ error: { code: "BAD_REQUEST", message: "diagramId is required" } });
+            return;
+        }
+        try {
+            res.json({ data: getDiagram(diagramId) });
+        }
+        catch (err) {
+            respondError(res, err, "diagrams-route.get");
+        }
+    });
+    router.put("/:diagramId", (req, res) => {
+        if (!req.visitor) {
+            res.status(401).json({ error: { code: "UNAUTHENTICATED", message: "no visitor" } });
+            return;
+        }
+        const diagramId = req.params.diagramId;
+        if (!diagramId) {
+            res.status(400).json({ error: { code: "BAD_REQUEST", message: "diagramId is required" } });
+            return;
+        }
+        const body = (req.body ?? {});
+        if (typeof body.data === "undefined") {
+            res.status(400).json({ error: { code: "BAD_REQUEST", message: "data is required" } });
+            return;
+        }
+        try {
+            const diagram = updateDiagram({
+                actorVisitorId: req.visitor.visitor_id,
+                diagramId,
+                title: typeof body.title === "string" ? body.title : undefined,
+                data: body.data,
+            });
+            res.json({ data: diagram });
+        }
+        catch (err) {
+            respondError(res, err, "diagrams-route.update");
+        }
+    });
+    router.delete("/:diagramId", (req, res) => {
+        if (!req.visitor) {
+            res.status(401).json({ error: { code: "UNAUTHENTICATED", message: "no visitor" } });
+            return;
+        }
+        const diagramId = req.params.diagramId;
+        if (!diagramId) {
+            res.status(400).json({ error: { code: "BAD_REQUEST", message: "diagramId is required" } });
+            return;
+        }
+        try {
+            removeDiagram({ actorVisitorId: req.visitor.visitor_id, diagramId });
+            res.status(204).end();
+        }
+        catch (err) {
+            respondError(res, err, "diagrams-route.delete");
+        }
+    });
+    return router;
+}
+export function buildPublicDiagramRouter() {
+    const router = Router();
+    router.get("/:diagramId", (req, res) => {
+        const diagramId = req.params.diagramId;
+        if (!diagramId) {
+            res.status(400).json({ error: { code: "BAD_REQUEST", message: "diagramId is required" } });
+            return;
+        }
+        try {
+            const diagram = getDiagram(diagramId);
+            res.json({
+                data: {
+                    diagramId: diagram.diagramId,
+                    title: diagram.title,
+                    updatedAt: diagram.updatedAt,
+                    data: diagram.data,
+                },
+            });
+        }
+        catch (err) {
+            respondError(res, err, "diagrams-route.public-get");
+        }
+    });
+    return router;
+}
+function respondError(res, err, context) {
+    if (err instanceof DiagramError) {
+        res.status(err.status).json({ error: { code: err.code, message: err.message } });
+        return;
+    }
+    log.error("%s failed: %s", context, err instanceof Error ? err.message : String(err));
+    res.status(500).json({ error: { code: "INTERNAL", message: "internal error" } });
+}
+//# sourceMappingURL=diagrams.routes.js.map

package/dist/server/routes/diagrams.routes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagrams.routes.js","sourceRoot":"","sources":["../../../src/server/routes/diagrams.routes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAA+B,MAAM,SAAS,CAAC;AAC9D,OAAO,EACL,aAAa,EACb,YAAY,EACZ,UAAU,EACV,eAAe,EACf,aAAa,EACb,aAAa,GACd,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAEhD,MAAM,GAAG,GAAG,SAAS,CAAC,gBAAgB,CAAC,CAAC;AAExC,MAAM,UAAU,mBAAmB;IACjC,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC;IAExB,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,IAAa,EAAE,GAAa,EAAE,EAAE;QAC/C,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,eAAe,EAAE,EAAE,CAAC,CAAC;IACxC,CAAC,CAAC,CAAC;IAEH,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,GAAY,EAAE,GAAa,EAAE,EAAE;QAC/C,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;YACjB,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,iBAAiB,EAAE,OAAO,EAAE,YAAY,EAAE,EAAE,CAAC,CAAC;YACpF,OAAO;QACT,CAAC;QACD,MAAM,IAAI,GAAG,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE,CAAwC,CAAC;QACrE,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,aAAa,CAAC;gBAC5B,cAAc,EAAE,GAAG,CAAC,OAAO,CAAC,UAAU;gBACtC,KAAK,EAAE,OAAO,IAAI,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS;gBAC9D,IAAI,EAAE,IAAI,CAAC,IAAI;aAChB,CAAC,CAAC;YACH,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;QAC1C,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,YAAY,CAAC,GAAG,EAAE,GAAG,EAAE,uBAAuB,CAAC,CAAC;QAClD,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,MAAM,CAAC,GAAG,CAAC,aAAa,EAAE,CAAC,GAAY,EAAE,GAAa,EAAE,EAAE;QACxD,MAAM,SAAS,GAAG,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC;QACvC,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE,OAAO,EAAE,uBAAuB,EAAE,EAAE,CAAC,CAAC;YAC3F,OAAO;QACT,CAAC;QACD,IAAI,CAAC;YACH,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;QAC5C,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,YAAY,CAAC,GAAG,EAAE,GAAG,EAAE,oBAAoB,CAAC,CAAC;QAC/C,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,MAAM,CAAC,GAAG,CAAC,aAAa,EAAE,CAAC,GAAY,EAAE,GAAa,EAAE,EAAE;QACxD,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;YACjB,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,iBAAiB,EAAE,OAAO,EAAE,YAAY,EAAE,EAAE,CAAC,CAAC;YACpF,OAAO;QACT,CAAC;QACD,MAAM,SAAS,GAAG,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC;QACvC,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE,OAAO,EAAE,uBAAuB,EAAE,EAAE,CAAC,CAAC;YAC3F,OAAO;QACT,CAAC;QACD,MAAM,IAAI,GAAG,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE,CAAwC,CAAC;QACrE,IAAI,OAAO,IAAI,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;YACrC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE,OAAO,EAAE,kBAAkB,EAAE,EAAE,CAAC,CAAC;YACtF,OAAO;QACT,CAAC;QACD,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,aAAa,CAAC;gBAC5B,cAAc,EAAE,GAAG,CAAC,OAAO,CAAC,UAAU;gBACtC,SAAS;gBACT,KAAK,EAAE,OAAO,IAAI,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS;gBAC9D,IAAI,EAAE,IAAI,CAAC,IAAI;aAChB,CAAC,CAAC;YACH,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;QAC9B,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,YAAY,CAAC,GAAG,EAAE,GAAG,EAAE,uBAAuB,CAAC,CAAC;QAClD,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,MAAM,CAAC,MAAM,CAAC,aAAa,EAAE,CAAC,GAAY,EAAE,GAAa,EAAE,EAAE;QAC3D,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;YACjB,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,iBAAiB,EAAE,OAAO,EAAE,YAAY,EAAE,EAAE,CAAC,CAAC;YACpF,OAAO;QACT,CAAC;QACD,MAAM,SAAS,GAAG,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC;QACvC,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE,OAAO,EAAE,uBAAuB,EAAE,EAAE,CAAC,CAAC;YAC3F,OAAO;QACT,CAAC;QACD,IAAI,CAAC;YACH,aAAa,CAAC,EAAE,cAAc,EAAE,GAAG,CAAC,OAAO,CAAC,UAAU,EAAE,SAAS,EAAE,CAAC,CAAC;YACrE,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC;QACxB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,YAAY,CAAC,GAAG,EAAE,GAAG,EAAE,uBAAuB,CAAC,CAAC;QAClD,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,wBAAwB;IACtC,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC;IACxB,MAAM,CAAC,GAAG,CAAC,aAAa,EAAE,CAAC,GAAY,EAAE,GAAa,EAAE,EAAE;QACxD,MAAM,SAAS,GAAG,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC;QACvC,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE,OAAO,EAAE,uBAAuB,EAAE,EAAE,CAAC,CAAC;YAC3F,OAAO;QACT,CAAC;QACD,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC;YACtC,GAAG,CAAC,IAAI,CAAC;gBACP,IAAI,EAAE;oBACJ,SAAS,EAAE,OAAO,CAAC,SAAS;oBAC5B,KAAK,EAAE,OAAO,CAAC,KAAK;oBACpB,SAAS,EAAE,OAAO,CAAC,SAAS;oBAC5B,IAAI,EAAE,OAAO,CAAC,IAAI;iBACnB;aACF,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,YAAY,CAAC,GAAG,EAAE,GAAG,EAAE,2BAA2B,CAAC,CAAC;QACtD,CAAC;IACH,CAAC,CAAC,CAAC;IACH,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,YAAY,CAAC,GAAa,EAAE,GAAY,EAAE,OAAe;IAChE,IAAI,GAAG,YAAY,YAAY,EAAE,CAAC;QAChC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QACjF,OAAO;IACT,CAAC;IACD,GAAG,CAAC,KAAK,CAAC,eAAe,EAAE,OAAO,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;IACtF,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,gBAAgB,EAAE,EAAE,CAAC,CAAC;AACnF,CAAC"}

package/dist/server/routes/documents.routes.js

@@ -0,0 +1,296 @@
+import { Router } from "express";
+import { DocumentError } from "../access/access-control.js";
+import { addDocumentInvite, createDocument, getDocument, getDocumentInvites, listDocuments, removeDocument, removeDocumentInvite, updateDocument, } from "../documents/document.service.js";
+import { searchDocuments } from "../search/search.service.js";
+import { requireDocumentAccess } from "../middleware/document-auth.middleware.js";
+import { StoragePathError } from "../storage/paths.js";
+import { useLogger } from "../logger/logger.js";
+const log = useLogger("documents-route");
+/**
+ * 构建文档相关路由。
+ *
+ * 包含以下接口：
+ * - GET  /          列出当前访客在指定域下可见的文档列表
+ * - POST /          创建新文档（需登录）
+ * - GET  /:id       读取单篇文档详情（需 read 权限）
+ * - PUT  /:id       更新文档（需 edit 权限）
+ * - DELETE /:id     删除文档（需 delete 权限，仅限创建者）
+ * - GET  /:id/invites          获取邀请列表（需 edit 权限）
+ * - POST /:id/invites          添加邀请（需 edit 权限）
+ * - DELETE /:id/invites/:vid   移除邀请（需 edit 权限）
+ *
+ * @returns Express Router 实例
+ */
+export function buildDocumentsRouter() {
+    const router = Router();
+    /**
+     * GET /
+     * 列出当前访客在指定域下可见的文档列表。
+     *
+     * 查询参数：
+     * - domainId?: string  要查询的域ID，不传则使用默认域
+     *
+     * 逻辑：从请求中取出 domainId 和当前访客ID，调用 listDocuments 服务函数，
+     * 由服务层负责权限过滤，直接返回过滤后的列表。
+     */
+    router.get("/", (req, res) => {
+        // 从 query 中读取 domainId，必须是字符串；不是字符串就当没传
+        const domainId = typeof req.query.domainId === "string" ? req.query.domainId : undefined;
+        // 从已鉴权的请求上下文中取访客ID；未登录则为 null
+        const visitorId = req.visitor?.visitor_id ?? null;
+        // 调用服务层获取可见文档列表（服务层内部做权限过滤）
+        const docs = listDocuments(domainId, visitorId);
+        res.json({ data: docs });
+    });
+    /**
+     * POST /
+     * 创建新文档。需已登录。
+     *
+     * 请求体字段：
+     * - relativePath: string  必填，文档相对路径
+     * - content: string       必填，文档正文
+     * - displayName?: string  可选，展示名
+     * - domainId?: string     可选，目标域，不传则默认域
+     * - permission?: number   可选，权限档位，不传则按域类型给默认值
+     */
+    router.post("/", (req, res) => {
+        // 创建文档必须先登录
+        if (!req.visitor) {
+            res.status(401).json({ error: { code: "UNAUTHENTICATED", message: "no visitor" } });
+            return;
+        }
+        // 从请求体中解构可能存在的字段
+        const body = (req.body ?? {});
+        // 校验必填字段：文件名和内容必须是字符串
+        if (typeof body.fileName !== "string" || typeof body.content !== "string") {
+            res.status(400).json({ error: { code: "BAD_REQUEST", message: "fileName and content are required" } });
+            return;
+        }
+        try {
+            // 调用服务层创建文档，把请求参数映射为服务参数
+            const doc = createDocument({
+                actorVisitorId: req.visitor.visitor_id,
+                fileName: body.fileName,
+                displayName: typeof body.displayName === "string" ? body.displayName : undefined,
+                content: body.content,
+                domainId: typeof body.domainId === "string" ? body.domainId : undefined,
+                permission: typeof body.permission === "number" ? body.permission : undefined,
+                parentId: typeof body.parentId === "string" ? body.parentId : undefined,
+                contentFormat: body.contentFormat === 'markdown' ? 'markdown' : undefined,
+            });
+            // 201 Created 返回新建文档的完整详情
+            res.status(201).json({ data: doc });
+        }
+        catch (err) {
+            // 统一异常处理：DocumentError 返回对应状态码，其他记日志后返回 500
+            respondError(res, err, "documents-route.create");
+        }
+    });
+    /**
+     * GET /:documentId
+     * 获取单篇文档详情。需具备读取权限。
+     *
+     * 前置校验：requireDocumentAccess("read") 中间件会先查文档和域信息，
+     * 判断当前访客是否有权读取；无权则直接返回 404/403。
+     */
+    router.get("/:documentId", requireDocumentAccess("read"), (req, res) => {
+        // 中间件已通过校验，这里直接从路由参数取文档ID
+        const documentId = req.params.documentId;
+        try {
+            // 从数据库和磁盘读取完整文档内容
+            const doc = getDocument(documentId);
+            res.json({ data: doc });
+        }
+        catch (err) {
+            respondError(res, err, "documents-route.get");
+        }
+    });
+    /**
+     * PUT /:documentId
+     * 更新文档内容、展示名或权限。需具备编辑权限。
+     *
+     * 前置校验：requireDocumentAccess("edit") 中间件会先鉴权。
+     * 请求体字段：
+     * - content: string       必填，新正文
+     * - displayName?: string  可选，新展示名
+     * - permission?: number   可选，新权限档位
+     */
+    router.put("/:documentId", requireDocumentAccess("edit"), (req, res) => {
+        // 中间件只校验了文档访问权，编辑操作仍需确认已登录（ req.visitor 存在）
+        if (!req.visitor) {
+            res.status(401).json({ error: { code: "UNAUTHENTICATED", message: "no visitor" } });
+            return;
+        }
+        const body = (req.body ?? {});
+        // 更新时 content 是必填项（即使是空字符串也要显式传）
+        if (typeof body.content !== "string") {
+            res.status(400).json({ error: { code: "BAD_REQUEST", message: "content is required" } });
+            return;
+        }
+        const documentId = req.params.documentId;
+        try {
+            const doc = updateDocument({
+                actorVisitorId: req.visitor.visitor_id,
+                documentId,
+                content: body.content,
+                displayName: typeof body.displayName === "string" ? body.displayName : undefined,
+                permission: typeof body.permission === "number" ? body.permission : undefined,
+                contentFormat: body.contentFormat === 'markdown' ? 'markdown' : undefined,
+            });
+            res.json({ data: doc });
+        }
+        catch (err) {
+            respondError(res, err, "documents-route.update");
+        }
+    });
+    /**
+     * DELETE /:documentId
+     * 删除文档。需具备删除权限（仅限创建者）。
+     *
+     * 前置校验：requireDocumentAccess("delete") 中间件会确保只有创建者能过。
+     */
+    router.delete("/:documentId", requireDocumentAccess("delete"), (req, res) => {
+        if (!req.visitor) {
+            res.status(401).json({ error: { code: "UNAUTHENTICATED", message: "no visitor" } });
+            return;
+        }
+        const documentId = req.params.documentId;
+        try {
+            removeDocument({
+                actorVisitorId: req.visitor.visitor_id,
+                documentId,
+            });
+            // 删除成功返回 204 No Content，无响应体
+            res.status(204).end();
+        }
+        catch (err) {
+            respondError(res, err, "documents-route.delete");
+        }
+    });
+    /**
+     * POST /search
+     * 全文检索文档。支持关键词搜索，结果按 BM25 相关性排序，
+     * 自动过滤当前访客无权阅读的文档。
+     *
+     * 请求体字段：
+     * - query: string     必填，搜索关键词
+     * - domainId?: string  可选，限定搜索域
+     * - topN?: number     可选，返回数量，默认 10
+     */
+    router.post("/search", (req, res) => {
+        const body = (req.body ?? {});
+        if (typeof body.query !== "string" || !body.query.trim()) {
+            res.status(400).json({ error: { code: "BAD_REQUEST", message: "query is required" } });
+            return;
+        }
+        const visitorId = req.visitor?.visitor_id ?? null;
+        const results = searchDocuments({
+            query: body.query,
+            visitorId,
+            domainId: typeof body.domainId === "string" ? body.domainId : undefined,
+            topN: typeof body.topN === "number" ? body.topN : undefined,
+        });
+        res.json({ data: results });
+    });
+    /**
+     * GET /:documentId/invites
+     * 获取文档的邀请列表。需具备编辑权限。
+     *
+     * 只有能编辑文档的访客（创建者或被邀请者等）才能查看邀请列表。
+     */
+    router.get("/:documentId/invites", requireDocumentAccess("edit"), (req, res) => {
+        const documentId = req.params.documentId;
+        try {
+            const invites = getDocumentInvites(documentId);
+            res.json({ data: invites });
+        }
+        catch (err) {
+            respondError(res, err, "documents-route.invites.get");
+        }
+    });
+    /**
+     * POST /:documentId/invites
+     * 为文档添加访客邀请。需具备编辑权限。
+     *
+     * 请求体字段：
+     * - targetVisitorId: string  必填，被邀请的访客ID
+     * - targetPermission: string  必填，授予的权限（read / edit）
+     *
+     * 业务限制：
+     * - 仅创建者可邀请。
+     * - 目标访客不能已是该域成员（邀请与域成员互斥）。
+     */
+    router.post("/:documentId/invites", requireDocumentAccess("edit"), (req, res) => {
+        if (!req.visitor) {
+            res.status(401).json({ error: { code: "UNAUTHENTICATED", message: "no visitor" } });
+            return;
+        }
+        const targetVisitorId = req.body.targetVisitorId;
+        const targetPermission = req.body.targetPermission;
+        // 校验请求体里是否同时提供了目标访客ID和权限
+        if (typeof targetVisitorId !== "string" || !targetPermission) {
+            res.status(400).json({ error: { code: "BAD_REQUEST", message: "targetVisitorId and targetPermission are required" } });
+            return;
+        }
+        const documentId = req.params.documentId;
+        try {
+            // 调用服务层插入邀请记录
+            addDocumentInvite(req.visitor.visitor_id, documentId, targetVisitorId, targetPermission);
+            // 成功返回 204 No Content
+            res.status(204).end();
+        }
+        catch (err) {
+            respondError(res, err, "documents-route.invites.add");
+        }
+    });
+    /**
+     * DELETE /:documentId/invites/:targetVisitorId
+     * 移除文档对指定访客的邀请。需具备编辑权限。
+     *
+     * 仅创建者可移除邀请。
+     */
+    router.delete("/:documentId/invites/:targetVisitorId", requireDocumentAccess("edit"), (req, res) => {
+        if (!req.visitor) {
+            res.status(401).json({ error: { code: "UNAUTHENTICATED", message: "no visitor" } });
+            return;
+        }
+        const documentId = req.params.documentId;
+        try {
+            // 从 URL 参数中读取要移除邀请的目标访客ID
+            removeDocumentInvite(req.visitor.visitor_id, documentId, req.params.targetVisitorId);
+            res.status(204).end();
+        }
+        catch (err) {
+            respondError(res, err, "documents-route.invites.remove");
+        }
+    });
+    return router;
+}
+/**
+ * 统一处理文档路由中的异常，映射为对应的 HTTP 响应。
+ *
+ * 异常映射规则：
+ * - DocumentError → 返回其自带的 status（400/403/404/409）和错误信息
+ * - StoragePathError → 返回 400，表示路径不合法
+ * - 其他未知异常 → 记日志后返回 500
+ *
+ * @param res - Express 响应对象
+ * @param err - 捕获到的异常
+ * @param context - 日志上下文标识，用于定位哪个路由处理函数出错
+ */
+function respondError(res, err, context) {
+    // 业务异常：带有明确 HTTP 状态码和错误码
+    if (err instanceof DocumentError) {
+        res.status(err.status).json({ error: { code: err.code, message: err.message } });
+        return;
+    }
+    // 路径类异常：统一映射为 400 Bad Request
+    if (err instanceof StoragePathError) {
+        res.status(400).json({ error: { code: "INVALID_PATH", message: err.message } });
+        return;
+    }
+    // 未识别的异常记录日志后返回 500，避免把内部错误详情暴露给客户端
+    log.error("%s failed: %s", context, err instanceof Error ? err.message : String(err));
+    res.status(500).json({ error: { code: "INTERNAL", message: "internal error" } });
+}
+//# sourceMappingURL=documents.routes.js.map

package/dist/server/routes/documents.routes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"documents.routes.js","sourceRoot":"","sources":["../../../src/server/routes/documents.routes.ts"],"names":[],"mappings":"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"}

package/dist/server/routes/domain-member-templates.routes.js

@@ -0,0 +1,163 @@
+import { Router } from "express";
+import { getDb } from "../db/connection.js";
+import { deleteDomainMemberTemplate, findDomainMemberTemplateById, insertDomainMemberTemplate, listDomainMemberTemplates, normaliseVisitorIdsToCsv, updateDomainMemberTemplate, visitorIdsFromStoredCsv, } from "../db/repositories/domain-member-template.repo.js";
+/**
+ * 将数据库模板记录转换为对外展示的 DTO。
+ * @param row - 数据库中的模板行记录
+ * @returns 前端可用的模板对象
+ */
+function rowToDto(row) {
+    return {
+        id: row.id,
+        displayName: row.display_name,
+        visitorIds: visitorIdsFromStoredCsv(row.domain_visitor_ids),
+        createTime: row.create_time,
+        updateTime: row.update_time,
+    };
+}
+/**
+ * 从请求体中解析访客ID数组。
+ * 未提供时返回空数组；格式错误返回 null。
+ * @param body - 请求体
+ * @returns 访客ID数组，或 null 表示格式不合法
+ */
+function parseVisitorIdsBody(body) {
+    if (!body || typeof body !== "object")
+        return null;
+    const v = body.visitorIds;
+    if (v === undefined)
+        return [];
+    if (!Array.isArray(v))
+        return null;
+    const out = [];
+    for (const item of v) {
+        if (typeof item !== "string")
+            return null;
+        out.push(item);
+    }
+    return out;
+}
+/**
+ * 构建域成员模板相关路由。
+ * 包含模板的列表查询、创建、更新、删除等接口。
+ * @returns Express Router 实例
+ */
+export function buildDomainMemberTemplatesRouter() {
+    const router = Router();
+    /**
+     * GET /
+     * 获取当前访客创建的所有域成员模板。
+     */
+    router.get("/", (req, res) => {
+        if (!req.visitor) {
+            res.status(401).json({ error: { code: "UNAUTHENTICATED", message: "no visitor" } });
+            return;
+        }
+        const db = getDb();
+        // 按创建者ID过滤模板列表
+        const rows = listDomainMemberTemplates(db, req.visitor.visitor_id);
+        res.json({ data: rows.map(rowToDto) });
+    });
+    /**
+     * POST /
+     * 创建新的域成员模板。
+     */
+    router.post("/", (req, res) => {
+        if (!req.visitor) {
+            res.status(401).json({ error: { code: "UNAUTHENTICATED", message: "no visitor" } });
+            return;
+        }
+        const body = (req.body ?? {});
+        // 校验模板展示名
+        if (typeof body.displayName !== "string" || !body.displayName.trim()) {
+            res.status(400).json({ error: { code: "BAD_REQUEST", message: "displayName is required" } });
+            return;
+        }
+        const visitorIds = parseVisitorIdsBody(req.body);
+        if (visitorIds === null) {
+            res.status(400).json({ error: { code: "BAD_REQUEST", message: "visitorIds must be an array of strings" } });
+            return;
+        }
+        const now = new Date().toISOString();
+        const db = getDb();
+        // 插入新模板记录
+        const id = insertDomainMemberTemplate(db, {
+            displayName: body.displayName.trim(),
+            domainVisitorIdsCsv: normaliseVisitorIdsToCsv(visitorIds),
+            createVisitorId: req.visitor.visitor_id,
+            createTime: now,
+            updateTime: now,
+        });
+        // 重新读取刚创建的记录并返回
+        const row = findDomainMemberTemplateById(db, id, req.visitor.visitor_id);
+        if (!row) {
+            res.status(500).json({ error: { code: "INTERNAL", message: "failed to load created template" } });
+            return;
+        }
+        res.status(201).json({ data: rowToDto(row) });
+    });
+    /**
+     * PUT /:id
+     * 更新指定域成员模板。
+     */
+    router.put("/:id", (req, res) => {
+        if (!req.visitor) {
+            res.status(401).json({ error: { code: "UNAUTHENTICATED", message: "no visitor" } });
+            return;
+        }
+        const id = Number(req.params.id);
+        // 校验ID为正整数
+        if (!Number.isInteger(id) || id < 1) {
+            res.status(400).json({ error: { code: "BAD_REQUEST", message: "invalid id" } });
+            return;
+        }
+        const body = (req.body ?? {});
+        if (typeof body.displayName !== "string" || !body.displayName.trim()) {
+            res.status(400).json({ error: { code: "BAD_REQUEST", message: "displayName is required" } });
+            return;
+        }
+        const visitorIds = parseVisitorIdsBody(req.body);
+        if (visitorIds === null) {
+            res.status(400).json({ error: { code: "BAD_REQUEST", message: "visitorIds must be an array of strings" } });
+            return;
+        }
+        const db = getDb();
+        // 执行更新，并校验是否命中记录（同时校验归属权）
+        const updated = updateDomainMemberTemplate(db, id, req.visitor.visitor_id, {
+            displayName: body.displayName.trim(),
+            domainVisitorIdsCsv: normaliseVisitorIdsToCsv(visitorIds),
+            updateTime: new Date().toISOString(),
+        });
+        if (!updated) {
+            res.status(404).json({ error: { code: "NOT_FOUND", message: "template not found" } });
+            return;
+        }
+        const row = findDomainMemberTemplateById(db, id, req.visitor.visitor_id);
+        res.json({ data: rowToDto(row) });
+    });
+    /**
+     * DELETE /:id
+     * 删除指定域成员模板。
+     */
+    router.delete("/:id", (req, res) => {
+        if (!req.visitor) {
+            res.status(401).json({ error: { code: "UNAUTHENTICATED", message: "no visitor" } });
+            return;
+        }
+        const id = Number(req.params.id);
+        if (!Number.isInteger(id) || id < 1) {
+            res.status(400).json({ error: { code: "BAD_REQUEST", message: "invalid id" } });
+            return;
+        }
+        const db = getDb();
+        // 执行删除，并校验是否命中记录（同时校验归属权）
+        const deleted = deleteDomainMemberTemplate(db, id, req.visitor.visitor_id);
+        if (!deleted) {
+            res.status(404).json({ error: { code: "NOT_FOUND", message: "template not found" } });
+            return;
+        }
+        res.status(204).end();
+    });
+    return router;
+}
+//# sourceMappingURL=domain-member-templates.routes.js.map

package/dist/server/routes/domain-member-templates.routes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"domain-member-templates.routes.js","sourceRoot":"","sources":["../../../src/server/routes/domain-member-templates.routes.ts"],"names":[],"mappings":"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"}