@fgbg/mdocs 0.6.0

package/dist/server/identity/visitor.service.test.js

@@ -0,0 +1,108 @@
+/**
+ * 访客服务单元测试（visitor.service.ts）
+ *
+ * 覆盖：
+ * - 注册访客生成恢复码
+ * - 恢复码找回身份（正确码 / 错误码 / 重复使用）
+ * - 已登录访客重新生成恢复码
+ */
+import { describe, it, expect, beforeAll, afterEach, vi } from "vitest";
+import Database from "better-sqlite3";
+import { applySchema } from "../db/schema.js";
+/* ── Mock 基础设施 ── */
+const testDbRef = vi.hoisted(() => ({ db: null }));
+vi.mock("../db/connection.js", () => ({
+    getDb: () => testDbRef.db,
+}));
+vi.mock("../domains/personal-domain.service.js", () => ({
+    ensurePersonalDomain: () => { },
+}));
+import { registerVisitor, recoverVisitor, generateRecoveryCode } from "./visitor.service.js";
+/* ── 生命周期 ── */
+beforeAll(() => {
+    const db = new Database(":memory:");
+    applySchema(db);
+    testDbRef.db = db;
+});
+afterEach(() => {
+    const db = testDbRef.db;
+    db.exec("DELETE FROM visitors");
+    db.exec("DELETE FROM audit_logs");
+});
+/* ── 注册与恢复码 ── */
+describe("registerVisitor", () => {
+    it("注册成功时返回 visitor、visitorToken 和 recoveryCode", () => {
+        const result = registerVisitor("测试用户");
+        expect(result.visitor).toBeDefined();
+        expect(result.visitor.visitorName).toBe("测试用户");
+        expect(result.visitor.visitorId).toBeTruthy();
+        expect(result.visitorToken).toBeTruthy();
+        expect(result.recoveryCode).toBeTruthy();
+        // 恢复码格式：XXXX-XXXX-XXXX-XXXX
+        expect(result.recoveryCode).toMatch(/^[A-Z2-9]{4}-[A-Z2-9]{4}-[A-Z2-9]{4}-[A-Z2-9]{4}$/);
+    });
+    it("注册后恢复码哈希存入数据库", () => {
+        const result = registerVisitor("user2");
+        const db = testDbRef.db;
+        const row = db
+            .prepare(`SELECT recovery_code_hash FROM visitors WHERE visitor_id = ?`)
+            .get(result.visitor.visitorId);
+        expect(row.recovery_code_hash).toBeTruthy();
+        expect(row.recovery_code_hash.length).toBe(64); // SHA-256 hex
+    });
+});
+describe("recoverVisitor", () => {
+    it("使用正确的恢复码可以找回身份，返回原访客和新 Token", () => {
+        const registered = registerVisitor("找回测试");
+        const originalId = registered.visitor.visitorId;
+        const originalToken = registered.visitorToken;
+        const recovered = recoverVisitor(registered.recoveryCode);
+        expect(recovered).not.toBeNull();
+        // visitorId 不变
+        expect(recovered.visitor.visitorId).toBe(originalId);
+        expect(recovered.visitor.visitorName).toBe("找回测试");
+        // 新 Token
+        expect(recovered.visitorToken).toBeTruthy();
+        expect(recovered.visitorToken).not.toBe(originalToken);
+    });
+    it("恢复后返回新 Token，且新 Token 能从后端解析回同一访客", () => {
+        const registered = registerVisitor("token刷新");
+        const originalId = registered.visitor.visitorId;
+        const recovered = recoverVisitor(registered.recoveryCode);
+        expect(recovered.visitorToken).not.toBe(registered.visitorToken);
+        expect(recovered.visitor.visitorId).toBe(originalId);
+    });
+    it("使用错误的恢复码返回 null", () => {
+        const registered = registerVisitor("用户A");
+        const result = recoverVisitor("AAAA-BBBB-CCCC-DDDD");
+        expect(result).toBeNull();
+    });
+    it("恢复码一次性使用，重复使用返回 null", () => {
+        const registered = registerVisitor("一次性码");
+        // 第一次成功
+        const first = recoverVisitor(registered.recoveryCode);
+        expect(first).not.toBeNull();
+        // 第二次 null
+        const second = recoverVisitor(registered.recoveryCode);
+        expect(second).toBeNull();
+    });
+});
+describe("generateRecoveryCode（已登录用户生成新码）", () => {
+    it("生成新恢复码覆盖旧码", () => {
+        const registered = registerVisitor("更新码");
+        const oldCode = registered.recoveryCode;
+        // 生成新码
+        const newCode = generateRecoveryCode(registered.visitor.visitorId);
+        expect(newCode).toBeTruthy();
+        expect(newCode).not.toBe(oldCode);
+        expect(newCode).toMatch(/^[A-Z2-9]{4}-[A-Z2-9]{4}-[A-Z2-9]{4}-[A-Z2-9]{4}$/);
+        // 旧码失效
+        const oldRecover = recoverVisitor(oldCode);
+        expect(oldRecover).toBeNull();
+        // 新码有效
+        const newRecover = recoverVisitor(newCode);
+        expect(newRecover).not.toBeNull();
+        expect(newRecover.visitor.visitorId).toBe(registered.visitor.visitorId);
+    });
+});
+//# sourceMappingURL=visitor.service.test.js.map

package/dist/server/identity/visitor.service.test.js.map

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

package/dist/server/logger/logger.js

@@ -0,0 +1,276 @@
+import fs from "node:fs";
+import path from "node:path";
+import { format } from "node:util";
+import { getConfig } from "../config/index.js";
+// 日志级别权重映射，权重越高表示级别越严重
+const LEVEL_WEIGHT = {
+    trace: 10,
+    debug: 20,
+    info: 30,
+    warn: 40,
+    error: 50,
+    fatal: 60,
+    silent: 70,
+};
+// 默认单个日志文件大小上限：5 MB
+const MAX_FILE_BYTES_DEFAULT = 5 * 1024 * 1024;
+// 日志文件清理间隔：1 小时
+const CLEANUP_INTERVAL_MS = 60 * 60 * 1000;
+// 模块日志器缓存，避免重复创建
+const cache = new Map();
+let lastCleanupAt = 0;
+/**
+ * 获取（或创建）指定模块名称的日志器实例。
+ * 相同模块名会复用缓存的实例。
+ *
+ * @param moduleName - 模块名称，用于标识日志来源
+ * @returns 该模块对应的日志器
+ */
+export function useLogger(moduleName) {
+    const key = moduleName.trim() || "app";
+    const hit = cache.get(key);
+    if (hit)
+        return hit;
+    const logger = buildLogger(key);
+    cache.set(key, logger);
+    return logger;
+}
+/**
+ * 构建一个模块日志器实例。
+ * 根据配置将日志输出到文件和控制台，支持级别过滤与样式控制。
+ *
+ * @param moduleName - 模块名称
+ * @returns 模块日志器
+ */
+function buildLogger(moduleName) {
+    const emit = (level, msg, args) => {
+        const cfg = getConfig().logging;
+        // 使用 util.format 格式化消息中的占位符
+        const text = args.length ? format(msg, ...args) : msg;
+        const now = new Date();
+        const ts = formatTimestamp(now);
+        // 若日志级别满足文件输出阈值，则写入日志文件
+        if (passes(level, cfg.level)) {
+            try {
+                writeFileLine({
+                    dir: getConfig().logsDir,
+                    dateText: formatDate(now),
+                    line: `[${ts}] [${level.toUpperCase()}] [${moduleName}] ${text}`,
+                    maxBytes: cfg.maxFileBytes || MAX_FILE_BYTES_DEFAULT,
+                    retentionDays: cfg.retentionDays,
+                });
+            }
+            catch {
+                // 日志写入失败不应影响主业务流程
+            }
+        }
+        // 若日志级别满足控制台输出阈值，则输出到控制台
+        if (passes(level, cfg.consoleLevel)) {
+            writeConsole({
+                style: cfg.consoleStyle,
+                level,
+                moduleName,
+                ts,
+                text,
+            });
+        }
+    };
+    return {
+        trace: (m, ...a) => emit("trace", m, a),
+        debug: (m, ...a) => emit("debug", m, a),
+        info: (m, ...a) => emit("info", m, a),
+        warn: (m, ...a) => emit("warn", m, a),
+        error: (m, ...a) => emit("error", m, a),
+        fatal: (m, ...a) => emit("fatal", m, a),
+    };
+}
+/**
+ * 判断给定日志级别是否达到最低输出级别。
+ *
+ * @param level - 当前日志级别
+ * @param min - 最低允许级别
+ * @returns 若 level >= min 则返回 true
+ */
+function passes(level, min) {
+    if (min === "silent")
+        return false;
+    return LEVEL_WEIGHT[level] >= LEVEL_WEIGHT[min];
+}
+/**
+ * 将 Date 格式化为 YYYY-MM-DD 的日期字符串。
+ *
+ * @param d - 日期对象
+ * @returns 日期字符串
+ */
+function formatDate(d) {
+    const y = d.getFullYear();
+    const m = String(d.getMonth() + 1).padStart(2, "0");
+    const day = String(d.getDate()).padStart(2, "0");
+    return `${y}-${m}-${day}`;
+}
+/**
+ * 将 Date 格式化为带毫秒的完整时间戳字符串。
+ *
+ * @param d - 日期对象
+ * @returns 时间戳字符串，格式：YYYY-MM-DD HH:mm:ss.SSS
+ */
+function formatTimestamp(d) {
+    const dateText = formatDate(d);
+    const hh = String(d.getHours()).padStart(2, "0");
+    const mm = String(d.getMinutes()).padStart(2, "0");
+    const ss = String(d.getSeconds()).padStart(2, "0");
+    const ms = String(d.getMilliseconds()).padStart(3, "0");
+    return `${dateText} ${hh}:${mm}:${ss}.${ms}`;
+}
+/**
+ * 确保日志目录存在，不存在则递归创建，并设置权限为 0o700。
+ *
+ * @param dir - 目录路径
+ */
+function ensureDir(dir) {
+    if (!fs.existsSync(dir)) {
+        fs.mkdirSync(dir, { recursive: true, mode: 0o700 });
+    }
+}
+/**
+ * 将一行日志写入文件。会自动轮转文件（按大小切分）并定期清理过期日志。
+ *
+ * @param params.dir - 日志目录
+ * @param params.dateText - 日期文本（用于文件名）
+ * @param params.line - 要写入的日志行
+ * @param params.maxBytes - 单个日志文件大小上限
+ * @param params.retentionDays - 日志保留天数
+ */
+function writeFileLine(params) {
+    ensureDir(params.dir);
+    maybeCleanup(params.dir, params.retentionDays);
+    const filePath = pickWritable(params.dir, params.dateText, params.maxBytes);
+    fs.appendFileSync(filePath, `${params.line}\n`, { mode: 0o600 });
+}
+/**
+ * 挑选一个可写入的日志文件。若当前日期的日志文件达到大小上限，则按序号递增创建新文件。
+ *
+ * @param dir - 日志目录
+ * @param dateText - 日期文本
+ * @param maxBytes - 文件大小上限
+ * @returns 选中的日志文件完整路径
+ */
+function pickWritable(dir, dateText, maxBytes) {
+    let index = 0;
+    while (true) {
+        const name = index === 0 ? `mdocs-${dateText}.log` : `mdocs-${dateText}-${index}.log`;
+        const full = path.join(dir, name);
+        if (!fs.existsSync(full))
+            return full;
+        try {
+            const s = fs.statSync(full);
+            if (s.size < maxBytes)
+                return full;
+        }
+        catch {
+            return full;
+        }
+        index += 1;
+    }
+}
+/**
+ * 根据保留天数清理过期日志文件。清理操作受 CLEANUP_INTERVAL_MS 间隔限制，避免频繁执行。
+ *
+ * @param dir - 日志目录
+ * @param retentionDays - 日志保留天数
+ */
+function maybeCleanup(dir, retentionDays) {
+    const now = Date.now();
+    // 若距离上次清理不足间隔时间，则跳过
+    if (now - lastCleanupAt < CLEANUP_INTERVAL_MS)
+        return;
+    lastCleanupAt = now;
+    try {
+        const entries = fs.readdirSync(dir, { withFileTypes: true });
+        // 计算过期时间戳
+        const cutoff = now - retentionDays * 24 * 60 * 60 * 1000;
+        // 匹配 mdocs-YYYY-MM-DD.log 或 mdocs-YYYY-MM-DD-N.log 格式的日志文件
+        const rx = /^mdocs-(\d{4}-\d{2}-\d{2})(?:-\d+)?\.log$/;
+        for (const e of entries) {
+            if (!e.isFile())
+                continue;
+            const m = rx.exec(e.name);
+            if (!m || !m[1])
+                continue;
+            const t = new Date(`${m[1]}T00:00:00.000Z`).getTime();
+            if (Number.isNaN(t))
+                continue;
+            if (t >= cutoff)
+                continue;
+            try {
+                fs.unlinkSync(path.join(dir, e.name));
+            }
+            catch {
+                // 忽略删除失败
+            }
+        }
+    }
+    catch {
+        // 忽略读取目录失败
+    }
+}
+/**
+ * 将日志输出到控制台，支持多种输出样式：json、common、colorize。
+ *
+ * @param params.style - 控制台输出样式
+ * @param params.level - 日志级别
+ * @param params.moduleName - 模块名称
+ * @param params.ts - 时间戳
+ * @param params.text - 日志文本
+ */
+function writeConsole(params) {
+    const { style, level, moduleName, ts, text } = params;
+    if (style === "json") {
+        const line = JSON.stringify({ time: ts, level, module: moduleName, message: text });
+        writeLevel(level, line);
+        return;
+    }
+    const base = `[${ts}] [${level.toUpperCase()}] [${moduleName}] ${text}`;
+    if (style === "common") {
+        writeLevel(level, base);
+        return;
+    }
+    writeLevel(level, colorize(level, base));
+}
+/**
+ * 为日志文本添加 ANSI 颜色码。
+ *
+ * @param level - 日志级别
+ * @param text - 原始日志文本
+ * @returns 带颜色码的文本
+ */
+function colorize(level, text) {
+    const codes = {
+        trace: 90,
+        debug: 36,
+        info: 32,
+        warn: 33,
+        error: 31,
+        fatal: 35,
+        silent: 37,
+    };
+    return `\u001b[${codes[level]}m${text}\u001b[0m`;
+}
+/**
+ * 根据日志级别选择对应的 console 方法输出。
+ *
+ * @param level - 日志级别
+ * @param line - 要输出的日志行
+ */
+function writeLevel(level, line) {
+    if (level === "warn") {
+        console.warn(line);
+    }
+    else if (level === "error" || level === "fatal") {
+        console.error(line);
+    }
+    else {
+        console.log(line);
+    }
+}
+//# sourceMappingURL=logger.js.map

package/dist/server/logger/logger.js.map

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

package/dist/server/main.js

@@ -0,0 +1,24 @@
+import { buildApp } from "./app.js";
+import { getConfig } from "./config/index.js";
+import { useLogger } from "./logger/logger.js";
+const log = useLogger("server");
+/**
+ * 启动 HTTP 服务器。
+ * 从配置中读取端口和主机地址，构建 Express 应用并监听请求。
+ * 若启动失败会将错误写入日志并退出进程。
+ */
+function start() {
+    const cfg = getConfig();
+    const app = buildApp();
+    // 启动监听，绑定到配置指定的 host 与 port
+    const server = app.listen(cfg.port, cfg.host, () => {
+        log.info("mdocs listening on http://%s:%d", cfg.host, cfg.port);
+    });
+    // 监听服务器错误事件，发生致命错误时记录日志并退出
+    server.on("error", (err) => {
+        log.error("server error: %s", err instanceof Error ? err.message : String(err));
+        process.exit(1);
+    });
+}
+start();
+//# sourceMappingURL=main.js.map

package/dist/server/main.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.js","sourceRoot":"","sources":["../../src/server/main.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACpC,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAE/C,MAAM,GAAG,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;AAEhC;;;;GAIG;AACH,SAAS,KAAK;IACZ,MAAM,GAAG,GAAG,SAAS,EAAE,CAAC;IACxB,MAAM,GAAG,GAAG,QAAQ,EAAE,CAAC;IAEvB,4BAA4B;IAC5B,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,GAAG,EAAE;QACjD,GAAG,CAAC,IAAI,CAAC,iCAAiC,EAAE,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC;IAClE,CAAC,CAAC,CAAC;IAEH,2BAA2B;IAC3B,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;QACzB,GAAG,CAAC,KAAK,CAAC,kBAAkB,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;QAChF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;AACL,CAAC;AAED,KAAK,EAAE,CAAC"}

package/dist/server/middleware/document-auth.middleware.js

@@ -0,0 +1,45 @@
+import { assertDocumentAccess, DocumentError } from "../access/access-control.js";
+/**
+ * 创建文档访问权限校验中间件。
+ *
+ * 返回一个 Express 中间件函数，该函数会：
+ * 1. 从路由参数 `req.params.documentId` 中提取文档 ID。
+ * 2. 从请求上下文 `req.visitor` 中提取当前访客 ID（未登录则为 null）。
+ * 3. 调用核心鉴权函数 `assertDocumentAccess` 判断访客能否对文档执行指定操作。
+ * 4. 鉴权通过则调用 `next()` 进入后续中间件/路由处理器。
+ * 5. 鉴权失败则返回对应的 HTTP 错误（404 文档不存在 / 403 无权访问）。
+ *
+ * @param action - 要校验的操作类型："read"（读取）、"edit"（编辑）、"delete"（删除）
+ * @returns Express 中间件函数
+ */
+export function requireDocumentAccess(action) {
+    return (req, res, next) => {
+        // 从 Express 路由参数中取出文档 ID（如 /api/documents/:documentId）
+        const documentId = req.params.documentId;
+        // 如果路由里没有 documentId 参数，说明是路由配置错误，返回 400
+        if (!documentId) {
+            res.status(400).json({ error: { code: "BAD_REQUEST", message: "documentId is required" } });
+            return;
+        }
+        // 从请求上下文中取当前访客 ID：authMiddleware 之前会把解析成功的访客挂在 req.visitor 上
+        // 如果访客未登录（如公开域的读请求可能不强制登录），则为 null
+        const visitorId = req.visitor?.visitor_id ?? null;
+        try {
+            // 调用统一访问控制模块的核心鉴权函数
+            // 该函数内部会查文档 → 查域 → 根据域类型和文档权限值判断访客是否有权执行 action
+            assertDocumentAccess(documentId, visitorId, action);
+            // 鉴权通过，放行到下一个中间件或路由处理函数
+            next();
+        }
+        catch (err) {
+            // 如果是已知的业务权限异常，按异常里指定的状态码返回 JSON 错误
+            if (err instanceof DocumentError) {
+                res.status(err.status).json({ error: { code: err.code, message: err.message } });
+                return;
+            }
+            // 其他未预料的异常（如数据库连接失败），交给 Express 的错误处理中间件
+            next(err);
+        }
+    };
+}
+//# sourceMappingURL=document-auth.middleware.js.map

package/dist/server/middleware/document-auth.middleware.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-auth.middleware.js","sourceRoot":"","sources":["../../../src/server/middleware/document-auth.middleware.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAElF;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,qBAAqB,CAAC,MAAkC;IACtE,OAAO,CAAC,GAAY,EAAE,GAAa,EAAE,IAAkB,EAAQ,EAAE;QAC/D,uDAAuD;QACvD,MAAM,UAAU,GAAG,GAAG,CAAC,MAAM,CAAC,UAAU,CAAC;QACzC,yCAAyC;QACzC,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE,OAAO,EAAE,wBAAwB,EAAE,EAAE,CAAC,CAAC;YAC5F,OAAO;QACT,CAAC;QACD,6DAA6D;QAC7D,mCAAmC;QACnC,MAAM,SAAS,GAAG,GAAG,CAAC,OAAO,EAAE,UAAU,IAAI,IAAI,CAAC;QAClD,IAAI,CAAC;YACH,oBAAoB;YACpB,gDAAgD;YAChD,oBAAoB,CAAC,UAAU,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC;YACpD,wBAAwB;YACxB,IAAI,EAAE,CAAC;QACT,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,oCAAoC;YACpC,IAAI,GAAG,YAAY,aAAa,EAAE,CAAC;gBACjC,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;gBACjF,OAAO;YACT,CAAC;YACD,yCAAyC;YACzC,IAAI,CAAC,GAAG,CAAC,CAAC;QACZ,CAAC;IACH,CAAC,CAAC;AACJ,CAAC"}