@fgbg/mdocs 0.6.0

package/dist/server/routes/domains.routes.js

@@ -0,0 +1,317 @@
+import { randomUUID } from "node:crypto";
+import { Router } from "express";
+import { getDb } from "../db/connection.js";
+import { findDomainById, listDomains, insertDomain, updateDomainName, updateDomainPermission, deleteDomainRow, addDomainMember, listDomainMemberIds, replaceDomainMembers, } from "../db/repositories/domain.repo.js";
+import { countDocumentsByDomain, listDomainIdsWithDocumentInviteForVisitor, } from "../db/repositories/document.repo.js";
+import { findVisitorById } from "../db/repositories/visitor.repo.js";
+import { resolveDomainAccess } from "../access/domain-access.js";
+/**
+ * 规范化请求体中的访客ID数组。
+ * 去重、去空字符串，并校验元素类型。
+ * @param body - 请求体
+ * @returns 规范化后的访客ID数组；格式不合法时返回 null
+ */
+function normaliseVisitorIdsBody(body) {
+    if (!body || typeof body !== "object")
+        return null;
+    const v = body.visitorIds;
+    if (!Array.isArray(v))
+        return null;
+    const out = [];
+    const seen = new Set();
+    for (const item of v) {
+        if (typeof item !== "string")
+            return null;
+        const id = item.trim();
+        if (!id || seen.has(id))
+            continue;
+        seen.add(id);
+        out.push(id);
+    }
+    return out;
+}
+/**
+ * 构建域（Domain）相关路由。
+ * 包含域的列表查询、创建、成员管理、重命名、权限修改及删除等接口。
+ * @returns Express Router 实例
+ */
+export function buildDomainsRouter() {
+    const router = Router();
+    /**
+     * GET /
+     * 列出当前访客可见的所有域。
+     */
+    // list visible domains
+    router.get("/", (req, res) => {
+        const visitorId = req.visitor?.visitor_id ?? null;
+        const db = getDb();
+        const rows = listDomains(db);
+        // 收集当前访客被邀请的域ID集合，用于后续权限判断
+        const documentInviteDomainIds = visitorId ? new Set(listDomainIdsWithDocumentInviteForVisitor(db, visitorId)) : undefined;
+        // 过滤掉访客完全无权访问的域
+        const filtered = rows.filter((r) => resolveDomainAccess(db, r, r.domain_id, visitorId, { documentInviteDomainIds }).kind !== "none");
+        res.json({
+            data: filtered.map((r) => ({
+                domainId: r.domain_id,
+                domainName: r.domain_name,
+                permission: r.permission,
+                creatorVisitorId: r.creator_visitor_id,
+                docCount: countDocumentsByDomain(db, r.domain_id),
+            })),
+        });
+    });
+    /**
+     * POST /
+     * 创建新域。仅已登录访客可操作。
+     * restricted 权限的域会自动将创建者加入成员列表。
+     */
+    // create domain
+    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.domainName !== "string" || !body.domainName.trim()) {
+            res.status(400).json({ error: { code: "BAD_REQUEST", message: "domainName is required" } });
+            return;
+        }
+        // 校验并默认权限为 restricted
+        const permission = typeof body.permission === "string" ? body.permission : "restricted";
+        if (!["public", "restricted", "private"].includes(permission)) {
+            res.status(400).json({ error: { code: "BAD_REQUEST", message: "invalid permission" } });
+            return;
+        }
+        const now = new Date().toISOString();
+        const domainId = randomUUID();
+        const db = getDb();
+        insertDomain(db, {
+            domainId,
+            domainName: body.domainName.trim(),
+            creatorVisitorId: req.visitor.visitor_id,
+            createdAt: now,
+            updatedAt: now,
+            permission,
+        });
+        // restricted 域需将创建者自动设为成员，确保其能继续管理该域
+        if (permission === "restricted") {
+            addDomainMember(db, domainId, req.visitor.visitor_id);
+        }
+        res.status(201).json({
+            data: {
+                domainId,
+                domainName: body.domainName.trim(),
+                permission,
+                creatorVisitorId: req.visitor.visitor_id,
+                docCount: 0,
+            },
+        });
+    });
+    /**
+     * GET /:id/members
+     * 获取 restricted 域的成员列表。仅域创建者可查看。
+     */
+    router.get("/:id/members", (req, res) => {
+        if (!req.visitor) {
+            res.status(401).json({ error: { code: "UNAUTHENTICATED", message: "no visitor" } });
+            return;
+        }
+        const domainId = req.params.id;
+        const db = getDb();
+        const domain = findDomainById(db, domainId);
+        if (!domain) {
+            res.status(404).json({ error: { code: "NOT_FOUND", message: "domain not found" } });
+            return;
+        }
+        // 只有域创建者才有权查看成员列表
+        if (domain.creator_visitor_id !== req.visitor.visitor_id) {
+            res.status(403).json({ error: { code: "FORBIDDEN", message: "only the creator can view domain members" } });
+            return;
+        }
+        if (domain.permission !== "restricted") {
+            res.status(400).json({
+                error: { code: "DOMAIN_NOT_RESTRICTED", message: "member list applies to restricted domains only" },
+            });
+            return;
+        }
+        const ids = listDomainMemberIds(db, domainId);
+        const members = [];
+        for (const id of ids) {
+            const v = findVisitorById(db, id);
+            if (!v) {
+                /* 1) visitors 表中已无此行（物理删除）→ missing，右栏显示「库中无记录」 */
+                members.push({ visitorId: id, visitorName: "", missing: true, disabled: false });
+            }
+            else {
+                members.push({
+                    visitorId: id,
+                    visitorName: v.visitor_name,
+                    missing: false,
+                    /* 2) disabled_at 非空 → 已停用（被 migrate 合并到了其他访客）*/
+                    disabled: v.disabled_at != null,
+                });
+            }
+        }
+        res.json({ data: { members } });
+    });
+    /**
+     * PUT /:id/members
+     * 批量替换 restricted 域的成员列表。仅域创建者可操作，创建者始终保留在成员中。
+     */
+    router.put("/:id/members", (req, res) => {
+        if (!req.visitor) {
+            res.status(401).json({ error: { code: "UNAUTHENTICATED", message: "no visitor" } });
+            return;
+        }
+        const domainId = req.params.id;
+        const ids = normaliseVisitorIdsBody(req.body);
+        if (ids === null) {
+            res.status(400).json({ error: { code: "BAD_REQUEST", message: "visitorIds must be an array of strings" } });
+            return;
+        }
+        const db = getDb();
+        const domain = findDomainById(db, domainId);
+        if (!domain) {
+            res.status(404).json({ error: { code: "NOT_FOUND", message: "domain not found" } });
+            return;
+        }
+        if (domain.creator_visitor_id !== req.visitor.visitor_id) {
+            res.status(403).json({ error: { code: "FORBIDDEN", message: "only the creator can modify domain members" } });
+            return;
+        }
+        if (domain.permission !== "restricted") {
+            res.status(400).json({
+                error: { code: "DOMAIN_NOT_RESTRICTED", message: "member list applies to restricted domains only" },
+            });
+            return;
+        }
+        /* 无论模板/前端传了哪些成员，域创建者必须保留在成员列表中 */
+        const mergedSet = new Set(ids);
+        mergedSet.add(domain.creator_visitor_id);
+        const merged = [...mergedSet];
+        // 校验所有待添加的访客ID是否真实存在
+        const invalid = [];
+        for (const vid of merged) {
+            const v = findVisitorById(db, vid);
+            if (!v) {
+                invalid.push(vid);
+            }
+        }
+        if (invalid.length > 0) {
+            res.status(400).json({
+                error: {
+                    code: "UNKNOWN_VISITOR_IDS",
+                    message: "one or more visitor ids do not exist",
+                    details: { invalidVisitorIds: invalid },
+                },
+            });
+            return;
+        }
+        const joinedAt = new Date().toISOString();
+        replaceDomainMembers(db, domainId, merged, joinedAt);
+        res.json({ data: { memberCount: merged.length } });
+    });
+    /**
+     * PUT /:id
+     * 重命名域。仅域创建者可操作，且域内不能有文档。
+     */
+    // rename domain
+    router.put("/:id", (req, res) => {
+        if (!req.visitor) {
+            res.status(401).json({ error: { code: "UNAUTHENTICATED", message: "no visitor" } });
+            return;
+        }
+        const domainId = req.params.id;
+        const body = (req.body ?? {});
+        if (typeof body.domainName !== "string" || !body.domainName.trim()) {
+            res.status(400).json({ error: { code: "BAD_REQUEST", message: "domainName is required" } });
+            return;
+        }
+        const db = getDb();
+        const domain = findDomainById(db, domainId);
+        if (!domain) {
+            res.status(404).json({ error: { code: "NOT_FOUND", message: "domain not found" } });
+            return;
+        }
+        if (domain.creator_visitor_id !== req.visitor.visitor_id) {
+            res.status(403).json({ error: { code: "FORBIDDEN", message: "only the creator can modify this domain" } });
+            return;
+        }
+        // 已有文档的域不允许重命名，防止路径引用混乱
+        const docCount = countDocumentsByDomain(db, domainId);
+        if (docCount > 0) {
+            res.status(400).json({ error: { code: "DOMAIN_HAS_DOCUMENTS", message: "cannot modify domain with documents" } });
+            return;
+        }
+        updateDomainName(db, domainId, body.domainName.trim());
+        res.json({ data: { domainId, domainName: body.domainName.trim() } });
+    });
+    /**
+     * PUT /:id/permission
+     * 修改域的访问权限。仅域创建者可操作，且域内不能有文档。
+     */
+    // change domain permission
+    router.put("/:id/permission", (req, res) => {
+        if (!req.visitor) {
+            res.status(401).json({ error: { code: "UNAUTHENTICATED", message: "no visitor" } });
+            return;
+        }
+        const domainId = req.params.id;
+        const body = (req.body ?? {});
+        if (typeof body.permission !== "string" || !["public", "restricted", "private"].includes(body.permission)) {
+            res.status(400).json({ error: { code: "BAD_REQUEST", message: "invalid permission" } });
+            return;
+        }
+        const db = getDb();
+        const domain = findDomainById(db, domainId);
+        if (!domain) {
+            res.status(404).json({ error: { code: "NOT_FOUND", message: "domain not found" } });
+            return;
+        }
+        if (domain.creator_visitor_id !== req.visitor.visitor_id) {
+            res.status(403).json({ error: { code: "FORBIDDEN", message: "only the creator can modify this domain" } });
+            return;
+        }
+        // 已有文档的域不允许修改权限
+        const docCount = countDocumentsByDomain(db, domainId);
+        if (docCount > 0) {
+            res.status(400).json({ error: { code: "DOMAIN_HAS_DOCUMENTS", message: "cannot modify domain with documents" } });
+            return;
+        }
+        updateDomainPermission(db, domainId, body.permission);
+        res.json({ data: { domainId, permission: body.permission } });
+    });
+    /**
+     * DELETE /:id
+     * 删除域。仅域创建者可操作，且域内不能有文档。
+     */
+    // delete domain
+    router.delete("/:id", (req, res) => {
+        if (!req.visitor) {
+            res.status(401).json({ error: { code: "UNAUTHENTICATED", message: "no visitor" } });
+            return;
+        }
+        const domainId = req.params.id;
+        const db = getDb();
+        const domain = findDomainById(db, domainId);
+        if (!domain) {
+            res.status(404).json({ error: { code: "NOT_FOUND", message: "domain not found" } });
+            return;
+        }
+        if (domain.creator_visitor_id !== req.visitor.visitor_id) {
+            res.status(403).json({ error: { code: "FORBIDDEN", message: "only the creator can delete this domain" } });
+            return;
+        }
+        // 已有文档的域不允许删除
+        const docCount = countDocumentsByDomain(db, domainId);
+        if (docCount > 0) {
+            res.status(400).json({ error: { code: "DOMAIN_HAS_DOCUMENTS", message: "cannot delete domain with documents" } });
+            return;
+        }
+        deleteDomainRow(db, domainId);
+        res.status(204).end();
+    });
+    return router;
+}
+//# sourceMappingURL=domains.routes.js.map

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

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

package/dist/server/routes/folders.routes.js

@@ -0,0 +1,210 @@
+import { Router } from "express";
+import { randomUUID } from "node:crypto";
+import { getDb } from "../db/connection.js";
+import { findDomainById } from "../db/repositories/domain.repo.js";
+import { findDocumentById, findDocumentByPath, insertDocument, countChildrenByParent, deleteDocument } from "../db/repositories/document.repo.js";
+import { resolveDomainAccess } from "../access/domain-access.js";
+import { DocumentError, Permission, validateDomainPermission, } from "../access/access-control.js";
+import { insertAuditLog } from "../db/repositories/audit.repo.js";
+import { folderDescPathForFolder } from "../../shared/folderDesc.js";
+import { normalisePathSegmentForStorage } from "../../shared/storagePath.js";
+import { writeDocument } from "../storage/file-store.js";
+import { getConfig } from "../config/index.js";
+import { useLogger } from "../logger/logger.js";
+const log = useLogger("folders-route");
+export function buildFoldersRouter() {
+    const router = Router();
+    /**
+     * 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.name !== "string" || !body.name.trim()) {
+            res.status(400).json({ error: { code: "BAD_REQUEST", message: "name is required" } });
+            return;
+        }
+        try {
+            const result = createFolder({
+                actorVisitorId: req.visitor.visitor_id,
+                name: body.name.trim(),
+                parentId: typeof body.parentId === "string" ? body.parentId : undefined,
+                domainId: typeof body.domainId === "string" ? body.domainId : undefined,
+                description: typeof body.description === "string" ? body.description : undefined,
+                permission: typeof body.permission === "number" ? body.permission : undefined,
+            });
+            res.status(201).json({ data: result });
+        }
+        catch (err) {
+            respondError(res, err, "folders-route.create");
+        }
+    });
+    /**
+     * DELETE /:folderId
+     * 删除空目录。非空时拒绝。
+     */
+    router.delete("/:folderId", (req, res) => {
+        if (!req.visitor) {
+            res.status(401).json({ error: { code: "UNAUTHENTICATED", message: "no visitor" } });
+            return;
+        }
+        try {
+            deleteFolder({
+                actorVisitorId: req.visitor.visitor_id,
+                folderId: req.params.folderId,
+            });
+            res.status(204).end();
+        }
+        catch (err) {
+            respondError(res, err, "folders-route.delete");
+        }
+    });
+    return router;
+}
+// ============================================================
+//  服务函数
+// ============================================================
+function createFolder(params) {
+    const cfg = getConfig();
+    const domainId = params.domainId?.trim() || cfg.defaultDomainId;
+    const db = getDb();
+    const domainRow = findDomainById(db, domainId);
+    if (!domainRow) {
+        throw new DocumentError("DOMAIN_NOT_FOUND", "域不存在", 404);
+    }
+    const access = resolveDomainAccess(db, domainRow, domainId, params.actorVisitorId);
+    if (access.kind !== "full") {
+        throw new DocumentError("FORBIDDEN", "无权在该域创建目录", 403);
+    }
+    // 规范化目录名（空格转下划线等），用于 relative_path
+    const storageName = normalisePathSegmentForStorage(params.name);
+    if (!storageName) {
+        throw new DocumentError("INVALID_PATH", "目录名不合法", 400);
+    }
+    // 校验父目录
+    let normalizedPath;
+    if (params.parentId) {
+        const parent = findDocumentById(db, params.parentId);
+        if (!parent || parent.file_type !== 'dir') {
+            throw new DocumentError("INVALID_PARENT", "父目录不存在", 404);
+        }
+        if (parent.domain_id !== domainId) {
+            throw new DocumentError("FORBIDDEN", "不能跨域创建目录", 403);
+        }
+        normalizedPath = `${parent.relative_path}/${storageName}`;
+    }
+    else {
+        normalizedPath = storageName;
+    }
+    // 查重
+    const existing = findDocumentByPath(db, domainId, normalizedPath);
+    if (existing) {
+        throw new DocumentError("DOC_EXISTS", "同名目录已存在", 409);
+    }
+    const folderId = randomUUID();
+    const now = new Date().toISOString();
+    const defaultPermission = domainId === params.actorVisitorId
+        ? Permission.PRIVATE
+        : domainRow.permission === "restricted"
+            ? Permission.DOMAIN_READ
+            : Permission.PUBLIC_READ;
+    let permission;
+    if (params.permission !== undefined) {
+        if (!validateDomainPermission(domainRow.permission, params.permission)) {
+            throw new DocumentError("INVALID_PERMISSION", `域类型不允许该权限值`, 400);
+        }
+        permission = params.permission;
+    }
+    else {
+        permission = defaultPermission;
+    }
+    // 始终创建 ___desc___.md，内容为默认标题
+    const descPath = folderDescPathForFolder(normalizedPath);
+    const descContent = params.description ?? `# ${params.name}`;
+    const tx = db.transaction(() => {
+        // 插入目录记录，displayName 保留用户原始输入
+        insertDocument(db, {
+            documentId: folderId,
+            domainId,
+            relativePath: normalizedPath,
+            displayName: params.name,
+            ownerVisitorId: params.actorVisitorId,
+            createdBy: params.actorVisitorId,
+            updatedBy: params.actorVisitorId,
+            contentHash: '',
+            createdAt: now,
+            updatedAt: now,
+            permission,
+            fileType: 'dir',
+            parentId: params.parentId ?? null,
+        });
+        // 创建 ___desc___.md 文档
+        writeDocument(domainId, descPath, descContent);
+        insertDocument(db, {
+            documentId: randomUUID(),
+            domainId,
+            relativePath: descPath,
+            displayName: params.name,
+            ownerVisitorId: params.actorVisitorId,
+            createdBy: params.actorVisitorId,
+            updatedBy: params.actorVisitorId,
+            contentHash: '',
+            createdAt: now,
+            updatedAt: now,
+            permission,
+            fileType: 'md',
+            parentId: folderId,
+        });
+        insertAuditLog(db, {
+            actorVisitorId: params.actorVisitorId,
+            action: "folder.create",
+            targetType: "folder",
+            targetId: folderId,
+            metadata: { relativePath: normalizedPath },
+            createdAt: now,
+        });
+    });
+    tx();
+    return { folderId, path: normalizedPath };
+}
+function deleteFolder(params) {
+    const db = getDb();
+    const folder = findDocumentById(db, params.folderId);
+    if (!folder)
+        throw new DocumentError("DOC_NOT_FOUND", "目录不存在", 404);
+    if (folder.file_type !== 'dir')
+        throw new DocumentError("BAD_REQUEST", "不是目录", 400);
+    if (folder.owner_visitor_id !== params.actorVisitorId) {
+        throw new DocumentError("FORBIDDEN", "仅创建者可删除目录", 403);
+    }
+    // 检查是否为空目录
+    const childCount = countChildrenByParent(db, params.folderId);
+    if (childCount > 0) {
+        throw new DocumentError("NOT_EMPTY", "目录不为空，无法删除", 409);
+    }
+    const now = new Date().toISOString();
+    db.transaction(() => {
+        deleteDocument(db, params.folderId);
+        insertAuditLog(db, {
+            actorVisitorId: params.actorVisitorId,
+            action: "folder.delete",
+            targetType: "folder",
+            targetId: params.folderId,
+            metadata: { relativePath: folder.relative_path },
+            createdAt: now,
+        });
+    })();
+}
+function respondError(res, err, context) {
+    if (err instanceof DocumentError) {
+        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=folders.routes.js.map

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

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

package/dist/server/routes/tree.routes.js

@@ -0,0 +1,25 @@
+import { Router } from "express";
+import { buildDocumentTree } from "../documents/tree.service.js";
+/**
+ * 构建文档树路由。
+ * 提供 GET / 接口，用于返回指定域的文档目录树。
+ * @returns Express Router 实例
+ */
+export function buildTreeRouter() {
+    const router = Router();
+    /**
+     * GET /
+     * 查询参数：domainId（可选）
+     * 返回当前访客在指定域下可见的文档目录树。
+     */
+    router.get("/", (req, res) => {
+        // 从查询参数中提取域ID
+        const domainId = typeof req.query.domainId === "string" ? req.query.domainId : undefined;
+        // 获取当前已认证访客的ID（未登录则为 null）
+        const visitorId = req.visitor?.visitor_id ?? null;
+        // 构建并返回目录树
+        res.json({ data: buildDocumentTree(domainId, visitorId) });
+    });
+    return router;
+}
+//# sourceMappingURL=tree.routes.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tree.routes.js","sourceRoot":"","sources":["../../../src/server/routes/tree.routes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAA+B,MAAM,SAAS,CAAC;AAC9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AAEjE;;;;GAIG;AACH,MAAM,UAAU,eAAe;IAC7B,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC;IAExB;;;;OAIG;IACH,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,GAAY,EAAE,GAAa,EAAE,EAAE;QAC9C,cAAc;QACd,MAAM,QAAQ,GAAG,OAAO,GAAG,CAAC,KAAK,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC;QACzF,2BAA2B;QAC3B,MAAM,SAAS,GAAG,GAAG,CAAC,OAAO,EAAE,UAAU,IAAI,IAAI,CAAC;QAClD,WAAW;QACX,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,iBAAiB,CAAC,QAAQ,EAAE,SAAS,CAAC,EAAE,CAAC,CAAC;IAC7D,CAAC,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC;AAChB,CAAC"}