@fgbg/mdocs 0.6.0

package/dist/server/app.js

@@ -0,0 +1,78 @@
+import fs from "node:fs";
+import path from "node:path";
+import express from "express";
+import { getConfig } from "./config/index.js";
+import { getDb } from "./db/connection.js";
+import { authMiddleware } from "./identity/auth.middleware.js";
+import { buildVisitorsRouter } from "./routes/visitors.routes.js";
+import { buildDocumentsRouter } from "./routes/documents.routes.js";
+import { buildTreeRouter } from "./routes/tree.routes.js";
+import { buildDomainsRouter } from "./routes/domains.routes.js";
+import { buildDomainMemberTemplatesRouter } from "./routes/domain-member-templates.routes.js";
+import { buildFoldersRouter } from "./routes/folders.routes.js";
+import { buildCliTokensRouter } from "./routes/cli-tokens.routes.js";
+import { buildAssetsUploadRouter, serveAssetFile } from "./routes/assets.routes.js";
+import { startIndexTimer } from "./search/document-index-manager.js";
+import { useLogger } from "./logger/logger.js";
+const log = useLogger("app");
+/**
+ * 构建并配置 Express 应用实例。
+ * 包括：创建运行时目录、初始化数据库、挂载中间件与路由、配置静态文件服务。
+ */
+export function buildApp() {
+    const cfg = getConfig();
+    ensureRuntimeDirs();
+    getDb();
+    // 启动 FTS5 全文索引定时重建
+    startIndexTimer();
+    const app = express();
+    app.disable("x-powered-by");
+    app.use(express.json({ limit: "32mb" }));
+    // 健康检查端点，无需认证
+    app.get("/api/health", (_req, res) => {
+        res.json({ data: { status: "ok" } });
+    });
+    // 资源文件读取端点，无需认证
+    app.get("/api/assets/:assetId", (req, res) => {
+        serveAssetFile(req, res);
+    });
+    // 后续 /api 路由均需经过身份认证
+    app.use("/api", authMiddleware);
+    app.use("/api/assets", buildAssetsUploadRouter());
+    app.use("/api/visitors", buildVisitorsRouter());
+    app.use("/api/documents", buildDocumentsRouter());
+    app.use("/api/tree", buildTreeRouter());
+    app.use("/api/domains", buildDomainsRouter());
+    app.use("/api/domain-member-templates", buildDomainMemberTemplatesRouter());
+    app.use("/api/folders", buildFoldersRouter());
+    app.use("/api/cli", buildCliTokensRouter());
+    // 兜底：未匹配到的 API 路径返回 404
+    app.use("/api", (_req, res) => {
+        res.status(404).json({ error: { code: "NOT_FOUND", message: "api not found" } });
+    });
+    // 若前端构建产物存在，则提供静态文件服务与单页应用回退
+    if (fs.existsSync(cfg.webDistDir)) {
+        app.use(express.static(cfg.webDistDir));
+        app.get("*", (_req, res) => {
+            const indexHtml = path.join(cfg.webDistDir, "index.html");
+            if (fs.existsSync(indexHtml)) {
+                res.sendFile(indexHtml);
+            }
+            else {
+                res.status(404).end();
+            }
+        });
+    }
+    else {
+        log.warn("web dist dir not found: %s", cfg.webDistDir);
+    }
+    return app;
+}
+/** 确保运行时所需的各目录已存在，按 0o700 权限递归创建。 */
+function ensureRuntimeDirs() {
+    const cfg = getConfig();
+    for (const dir of [cfg.dataDir, cfg.filesDir, cfg.docsDir, cfg.assetsDir, cfg.logsDir]) {
+        fs.mkdirSync(dir, { recursive: true, mode: 0o700 });
+    }
+}
+//# sourceMappingURL=app.js.map

package/dist/server/app.js.map

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

package/dist/server/cli/main.js

@@ -0,0 +1,126 @@
+import { buildApp } from "../app.js";
+import { getConfig } from "../config/index.js";
+import { listAllVisitors } from "../identity/visitor.service.js";
+import { migrateVisitor, MigrationError, } from "../migrations/visitor-migration.service.js";
+/** 解析命令行参数，将 `--key value` 或 `--flag` 形式转为键值对象。 */
+function parseFlags(argv) {
+    const out = {};
+    for (let i = 0; i < argv.length; i += 1) {
+        const token = argv[i];
+        if (!token || !token.startsWith("--"))
+            continue;
+        const key = token.slice(2);
+        const next = argv[i + 1];
+        // 若下一项存在且不是新的标志，则将其视为当前标志的值
+        if (next !== undefined && !next.startsWith("--")) {
+            out[key] = next;
+            i += 1;
+        }
+        else {
+            out[key] = true;
+        }
+    }
+    return out;
+}
+/** 打印 CLI 使用说明到标准输出。 */
+function printUsage() {
+    process.stdout.write([
+        "mdocs CLI",
+        "",
+        "Usage:",
+        "  mdocs visitor list",
+        "  mdocs visitor migrate --from OLD --to NEW [--dry-run] [--confirm]",
+        "",
+        "Notes:",
+        "  Either --dry-run or --confirm must be supplied for migrate.",
+        "  --confirm performs the migration inside a transaction and makes a backup first.",
+        "",
+    ].join("\n"));
+}
+/** CLI 入口：根据命令与子命令分发到对应的处理函数。 */
+async function main() {
+    const [command, sub, ...rest] = process.argv.slice(2);
+    if (!command) {
+        startServer();
+        return;
+    }
+    if (command === "start") {
+        startServer();
+        return;
+    }
+    if (command === "visitor" && sub === "list") {
+        runVisitorList();
+        return;
+    }
+    if (command === "visitor" && sub === "migrate") {
+        runVisitorMigrate(parseFlags(rest));
+        return;
+    }
+    printUsage();
+    process.exit(1);
+}
+/** 启动 HTTP 服务器。 */
+function startServer() {
+    const cfg = getConfig();
+    const app = buildApp();
+    const server = app.listen(cfg.port, cfg.host, () => {
+        process.stdout.write(`mdocs listening on http://${cfg.host}:${cfg.port}\n`);
+    });
+    server.on("error", (err) => {
+        process.stderr.write(`server error: ${err instanceof Error ? err.message : String(err)}\n`);
+        process.exit(1);
+    });
+}
+/** 执行 `visitor list`：查询所有访客并以 TSV 格式输出。 */
+function runVisitorList() {
+    const rows = listAllVisitors();
+    for (const row of rows) {
+        process.stdout.write(`${row.visitor_id}\t${row.visitor_name}\tcreated=${row.created_at}\tdisabled=${row.disabled_at ?? "-"}\tmerged_into=${row.merged_into_visitor_id ?? "-"}\n`);
+    }
+}
+/** 执行 `visitor migrate`：校验参数后调用迁移服务，并输出结果或错误。 */
+function runVisitorMigrate(flags) {
+    const from = typeof flags.from === "string" ? flags.from : "";
+    const to = typeof flags.to === "string" ? flags.to : "";
+    const dryRun = flags["dry-run"] === true;
+    const confirm = flags.confirm === true;
+    // 校验必填参数
+    if (!from || !to) {
+        process.stderr.write("--from and --to are required\n");
+        process.exit(2);
+    }
+    // 校验必须指定执行模式
+    if (!dryRun && !confirm) {
+        process.stderr.write("must pass --dry-run or --confirm\n");
+        process.exit(2);
+    }
+    try {
+        const result = migrateVisitor({ fromVisitorId: from, toVisitorId: to, confirm });
+        printMigrationResult(result);
+    }
+    catch (err) {
+        if (err instanceof MigrationError) {
+            process.stderr.write(`migration error: ${err.code} ${err.message}\n`);
+            process.exit(3);
+        }
+        process.stderr.write(`unexpected error: ${err instanceof Error ? err.message : String(err)}\n`);
+        process.exit(4);
+    }
+}
+/** 将访客迁移结果格式化为可读文本并输出到标准输出。 */
+function printMigrationResult(result) {
+    const header = result.dryRun ? "dry-run" : "executed";
+    process.stdout.write([
+        `migration ${header}`,
+        `  from: ${result.from.visitor_id} (${result.from.visitor_name})`,
+        `  to:   ${result.to.visitor_id} (${result.to.visitor_name})`,
+        `  documents.owner_visitor_id: ${result.impact.documents_owner}`,
+        `  documents.created_by:       ${result.impact.documents_created_by}`,
+        `  documents.updated_by:       ${result.impact.documents_updated_by}`,
+        `  attachments.owner_visitor_id: ${result.impact.attachments_owner}`,
+        result.backupPath ? `  backup: ${result.backupPath}` : "  backup: -",
+        "",
+    ].join("\n"));
+}
+void main();
+//# sourceMappingURL=main.js.map

package/dist/server/cli/main.js.map

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

package/dist/server/config/index.js

@@ -0,0 +1,66 @@
+import os from "node:os";
+import path from "node:path";
+let cached = null;
+/**
+ * 读取并缓存应用配置。
+ * 优先从环境变量获取，未设置时使用默认值；首次调用后结果会被缓存。
+ */
+export function getConfig() {
+    if (cached)
+        return cached;
+    // 数据目录：环境变量 > 用户主目录下的 .mdocs
+    const dataDir = process.env.MDOCS_DATA_DIR?.trim()
+        ? path.resolve(process.env.MDOCS_DATA_DIR)
+        : path.join(os.homedir(), ".mdocs");
+    // 网络监听地址与端口
+    const host = process.env.MDOCS_HOST?.trim() || "127.0.0.1";
+    const port = process.env.MDOCS_PORT ? Number(process.env.MDOCS_PORT) : 4000;
+    // 组装日志配置
+    const logging = {
+        level: parseLevel(process.env.MDOCS_LOG_LEVEL, "info"),
+        consoleLevel: parseLevel(process.env.MDOCS_CONSOLE_LEVEL, "info"),
+        consoleStyle: parseStyle(process.env.MDOCS_CONSOLE_STYLE, "pretty"),
+        retentionDays: Number(process.env.MDOCS_LOG_RETENTION_DAYS ?? 14),
+        maxFileBytes: Number(process.env.MDOCS_LOG_MAX_BYTES ?? 5 * 1024 * 1024),
+    };
+    // 缓存完整配置对象
+    cached = {
+        host,
+        port,
+        dataDir,
+        dbFile: path.join(dataDir, "sqlite", "data.sqlite"),
+        filesDir: path.join(dataDir, "files"),
+        docsDir: path.join(dataDir, "files", "docs"),
+        assetsDir: path.join(dataDir, "files", "assets"),
+        logsDir: path.join(dataDir, "logs"),
+        webDistDir: path.resolve(process.cwd(), "dist/web"),
+        logging,
+        defaultDomainId: "default",
+    };
+    return cached;
+}
+/** 将原始字符串解析为合法的日志级别，若非法则返回 fallback。 */
+function parseLevel(raw, fallback) {
+    const allowed = [
+        "trace",
+        "debug",
+        "info",
+        "warn",
+        "error",
+        "fatal",
+        "silent",
+    ];
+    if (!raw)
+        return fallback;
+    const lower = raw.toLowerCase();
+    return allowed.includes(lower) ? lower : fallback;
+}
+/** 将原始字符串解析为合法的日志样式，若非法则返回 fallback。 */
+function parseStyle(raw, fallback) {
+    const allowed = ["pretty", "common", "json"];
+    if (!raw)
+        return fallback;
+    const lower = raw.toLowerCase();
+    return allowed.includes(lower) ? lower : fallback;
+}
+//# sourceMappingURL=index.js.map

package/dist/server/config/index.js.map

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

package/dist/server/db/connection.js

@@ -0,0 +1,34 @@
+import fs from "node:fs";
+import path from "node:path";
+import Database from "better-sqlite3";
+import { getConfig } from "../config/index.js";
+import { applySchema } from "./schema.js";
+let instance = null;
+/**
+ * 获取 SQLite 数据库实例（单例）。
+ * 首次调用时会创建数据库目录、启用 WAL 模式与外键约束，并自动应用 Schema。
+ */
+export function getDb() {
+    if (instance)
+        return instance;
+    const cfg = getConfig();
+    const dir = path.dirname(cfg.dbFile);
+    // 若数据库文件所在目录不存在则递归创建
+    if (!fs.existsSync(dir)) {
+        fs.mkdirSync(dir, { recursive: true, mode: 0o700 });
+    }
+    const db = new Database(cfg.dbFile);
+    db.pragma("journal_mode = WAL");
+    db.pragma("foreign_keys = ON");
+    applySchema(db);
+    instance = db;
+    return db;
+}
+/** 关闭当前数据库连接并将单例置空。 */
+export function closeDb() {
+    if (instance) {
+        instance.close();
+        instance = null;
+    }
+}
+//# sourceMappingURL=connection.js.map

package/dist/server/db/connection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection.js","sourceRoot":"","sources":["../../../src/server/db/connection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AACtC,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,IAAI,QAAQ,GAA6B,IAAI,CAAC;AAE9C;;;GAGG;AACH,MAAM,UAAU,KAAK;IACnB,IAAI,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAC9B,MAAM,GAAG,GAAG,SAAS,EAAE,CAAC;IACxB,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACrC,qBAAqB;IACrB,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACxB,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IACtD,CAAC;IACD,MAAM,EAAE,GAAG,IAAI,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACpC,EAAE,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC;IAChC,EAAE,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC;IAC/B,WAAW,CAAC,EAAE,CAAC,CAAC;IAChB,QAAQ,GAAG,EAAE,CAAC;IACd,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,uBAAuB;AACvB,MAAM,UAAU,OAAO;IACrB,IAAI,QAAQ,EAAE,CAAC;QACb,QAAQ,CAAC,KAAK,EAAE,CAAC;QACjB,QAAQ,GAAG,IAAI,CAAC;IAClB,CAAC;AACH,CAAC"}

package/dist/server/db/repositories/audit.repo.js

@@ -0,0 +1,20 @@
+/**
+ * 插入一条审计日志记录。
+ * metadata 对象会被序列化为 JSON 字符串存储；若为空则存 NULL。
+ */
+export function insertAuditLog(db, input) {
+    const metadataText = input.metadata ? JSON.stringify(input.metadata) : null;
+    db.prepare(`INSERT INTO audit_logs (
+      actor_visitor_id, action, target_type, target_id, metadata_json, created_at
+    ) VALUES (?, ?, ?, ?, ?, ?)`).run(input.actorVisitorId, input.action, input.targetType ?? null, input.targetId ?? null, metadataText, input.createdAt);
+}
+/**
+ * 插入一条访客迁移历史记录。
+ * affectedCounts 对象会被序列化为 JSON 字符串存储。
+ */
+export function insertVisitorMigration(db, input) {
+    db.prepare(`INSERT INTO visitor_migrations (
+      from_visitor_id, to_visitor_id, affected_counts_json, executed_at
+    ) VALUES (?, ?, ?, ?)`).run(input.fromVisitorId, input.toVisitorId, JSON.stringify(input.affectedCounts), input.executedAt);
+}
+//# sourceMappingURL=audit.repo.js.map

package/dist/server/db/repositories/audit.repo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit.repo.js","sourceRoot":"","sources":["../../../../src/server/db/repositories/audit.repo.ts"],"names":[],"mappings":"AAYA;;;GAGG;AACH,MAAM,UAAU,cAAc,CAC5B,EAAqB,EACrB,KAA0B;IAE1B,MAAM,YAAY,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAC5E,EAAE,CAAC,OAAO,CACR;;gCAE4B,CAC7B,CAAC,GAAG,CACH,KAAK,CAAC,cAAc,EACpB,KAAK,CAAC,MAAM,EACZ,KAAK,CAAC,UAAU,IAAI,IAAI,EACxB,KAAK,CAAC,QAAQ,IAAI,IAAI,EACtB,YAAY,EACZ,KAAK,CAAC,SAAS,CAChB,CAAC;AACJ,CAAC;AAUD;;;GAGG;AACH,MAAM,UAAU,sBAAsB,CACpC,EAAqB,EACrB,KAAkC;IAElC,EAAE,CAAC,OAAO,CACR;;0BAEsB,CACvB,CAAC,GAAG,CACH,KAAK,CAAC,aAAa,EACnB,KAAK,CAAC,WAAW,EACjB,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,cAAc,CAAC,EACpC,KAAK,CAAC,UAAU,CACjB,CAAC;AACJ,CAAC"}

package/dist/server/db/repositories/cli-token.repo.js

@@ -0,0 +1,21 @@
+export function insertCliToken(db, input) {
+    db.prepare(`INSERT INTO cli_tokens (token_id, visitor_id, token_hash, name, revoked, created_at)
+     VALUES (?, ?, ?, ?, 0, ?)`).run(input.tokenId, input.visitorId, input.tokenHash, input.name, input.createdAt);
+}
+export function findCliTokenByHash(db, tokenHash) {
+    return db
+        .prepare(`SELECT * FROM cli_tokens WHERE token_hash = ?`)
+        .get(tokenHash);
+}
+export function listCliTokensByVisitor(db, visitorId) {
+    return db
+        .prepare(`SELECT * FROM cli_tokens WHERE visitor_id = ? ORDER BY created_at DESC`)
+        .all(visitorId);
+}
+export function revokeCliToken(db, tokenId) {
+    db.prepare(`UPDATE cli_tokens SET revoked = 1 WHERE token_id = ?`).run(tokenId);
+}
+export function revokeAllCliTokensByVisitor(db, visitorId) {
+    db.prepare(`UPDATE cli_tokens SET revoked = 1 WHERE visitor_id = ?`).run(visitorId);
+}
+//# sourceMappingURL=cli-token.repo.js.map

package/dist/server/db/repositories/cli-token.repo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-token.repo.js","sourceRoot":"","sources":["../../../../src/server/db/repositories/cli-token.repo.ts"],"names":[],"mappings":"AAmBA,MAAM,UAAU,cAAc,CAAC,EAAqB,EAAE,KAA0B;IAC9E,EAAE,CAAC,OAAO,CACR;+BAC2B,CAC5B,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC;AACtF,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,EAAqB,EAAE,SAAiB;IACzE,OAAO,EAAE;SACN,OAAO,CAAC,+CAA+C,CAAC;SACxD,GAAG,CAAC,SAAS,CAA4B,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,EAAqB,EAAE,SAAiB;IAC7E,OAAO,EAAE;SACN,OAAO,CAAC,wEAAwE,CAAC;SACjF,GAAG,CAAC,SAAS,CAAkB,CAAC;AACrC,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,EAAqB,EAAE,OAAe;IACnE,EAAE,CAAC,OAAO,CAAC,sDAAsD,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;AAClF,CAAC;AAED,MAAM,UAAU,2BAA2B,CAAC,EAAqB,EAAE,SAAiB;IAClF,EAAE,CAAC,OAAO,CAAC,wDAAwD,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;AACtF,CAAC"}

package/dist/server/db/repositories/diagram.repo.js

@@ -0,0 +1,21 @@
+export function insertDiagram(db, input) {
+    db.prepare(`INSERT INTO diagrams (diagram_id, title, owner_visitor_id, data_json, created_at, updated_at)
+     VALUES (?, ?, ?, ?, ?, ?)`).run(input.diagramId, input.title, input.ownerVisitorId, input.dataJson, input.createdAt, input.updatedAt);
+}
+export function findDiagramById(db, diagramId) {
+    return db
+        .prepare(`SELECT * FROM diagrams WHERE diagram_id = ?`)
+        .get(diagramId);
+}
+export function listDiagrams(db) {
+    return db
+        .prepare(`SELECT * FROM diagrams ORDER BY updated_at DESC`)
+        .all();
+}
+export function updateDiagram(db, input) {
+    db.prepare(`UPDATE diagrams SET title = ?, data_json = ?, updated_at = ? WHERE diagram_id = ?`).run(input.title, input.dataJson, input.updatedAt, input.diagramId);
+}
+export function deleteDiagram(db, diagramId) {
+    db.prepare(`DELETE FROM diagrams WHERE diagram_id = ?`).run(diagramId);
+}
+//# sourceMappingURL=diagram.repo.js.map

package/dist/server/db/repositories/diagram.repo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagram.repo.js","sourceRoot":"","sources":["../../../../src/server/db/repositories/diagram.repo.ts"],"names":[],"mappings":"AAoBA,MAAM,UAAU,aAAa,CAAC,EAAqB,EAAE,KAAyB;IAC5E,EAAE,CAAC,OAAO,CACR;+BAC2B,CAC5B,CAAC,GAAG,CACH,KAAK,CAAC,SAAS,EACf,KAAK,CAAC,KAAK,EACX,KAAK,CAAC,cAAc,EACpB,KAAK,CAAC,QAAQ,EACd,KAAK,CAAC,SAAS,EACf,KAAK,CAAC,SAAS,CAChB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,eAAe,CAC7B,EAAqB,EACrB,SAAiB;IAEjB,OAAO,EAAE;SACN,OAAO,CAAqB,6CAA6C,CAAC;SAC1E,GAAG,CAAC,SAAS,CAAC,CAAC;AACpB,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,EAAqB;IAChD,OAAO,EAAE;SACN,OAAO,CAAiB,iDAAiD,CAAC;SAC1E,GAAG,EAAE,CAAC;AACX,CAAC;AAED,MAAM,UAAU,aAAa,CAC3B,EAAqB,EACrB,KAAgF;IAEhF,EAAE,CAAC,OAAO,CACR,mFAAmF,CACpF,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC;AACvE,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,EAAqB,EAAE,SAAiB;IACpE,EAAE,CAAC,OAAO,CAAC,2CAA2C,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;AACzE,CAAC"}

package/dist/server/db/repositories/document.repo.js

@@ -0,0 +1,231 @@
+/**
+ * 统计指定域下的文档总数。
+ *
+ * @param db - better-sqlite3 数据库实例
+ * @param domainId - 要统计的域 ID
+ * @returns 该域下的文档数量
+ */
+export function countDocumentsByDomain(db, domainId) {
+    // 使用 COUNT(*) 统计满足 domain_id 条件的行数
+    const row = db
+        .prepare(`SELECT COUNT(*) as c FROM documents WHERE domain_id = ?`)
+        .get(domainId);
+    // 如果查询结果异常为空，兜底返回 0
+    return row?.c ?? 0;
+}
+/**
+ * 列出指定域下的所有文档，按相对路径升序排列。
+ *
+ * @param db - better-sqlite3 数据库实例
+ * @param domainId - 目标域 ID
+ * @returns 该域下所有文档的数据库行数组
+ */
+export function listDocumentsByDomain(db, domainId) {
+    return db
+        .prepare(`SELECT document_id, domain_id, relative_path, display_name, owner_visitor_id,
+              created_by, updated_by, content_hash, created_at, updated_at, permission,
+              file_type, parent_id
+       FROM documents WHERE domain_id = ? ORDER BY relative_path`)
+        .all(domainId);
+}
+/**
+ * 根据文档 ID 查找单篇文档。
+ *
+ * @param db - better-sqlite3 数据库实例
+ * @param documentId - 文档唯一标识
+ * @returns 匹配的数据库行；未找到则返回 undefined
+ */
+export function findDocumentById(db, documentId) {
+    return db
+        .prepare(`SELECT document_id, domain_id, relative_path, display_name, owner_visitor_id,
+              created_by, updated_by, content_hash, created_at, updated_at, permission,
+              file_type, parent_id
+       FROM documents WHERE document_id = ?`)
+        .get(documentId);
+}
+/**
+ * 根据域和相对路径查找单篇文档。
+ *
+ * 注意：relative_path 现在是 (domain_id, relative_path) 联合唯一，
+ * 因此查询必须包含 domainId。
+ *
+ * @param db - better-sqlite3 数据库实例
+ * @param domainId - 域 ID
+ * @param relativePath - 文档的相对路径
+ * @returns 匹配的数据库行；未找到则返回 undefined
+ */
+export function findDocumentByPath(db, domainId, relativePath) {
+    return db
+        .prepare(`SELECT document_id, domain_id, relative_path, display_name, owner_visitor_id,
+              created_by, updated_by, content_hash, created_at, updated_at, permission,
+              file_type, parent_id
+       FROM documents WHERE domain_id = ? AND relative_path = ?`)
+        .get(domainId, relativePath);
+}
+/**
+ * 插入一篇新文档到数据库。
+ *
+ * @param db - better-sqlite3 数据库实例
+ * @param input - 包含所有必填字段的插入参数
+ */
+export function insertDocument(db, input) {
+    db.prepare(`INSERT INTO documents
+     (document_id, domain_id, relative_path, display_name, owner_visitor_id,
+      created_by, updated_by, content_hash, created_at, updated_at, permission,
+      file_type, parent_id)
+     VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`).run(input.documentId, input.domainId, input.relativePath, input.displayName, input.ownerVisitorId, input.createdBy, input.updatedBy, input.contentHash, input.createdAt, input.updatedAt, input.permission, input.fileType ?? 'md', input.parentId ?? null);
+}
+/**
+ * 更新文档内容与元数据。
+ *
+ * 分支逻辑：
+ * - 如果 input.permission 有值，则同时更新 permission 字段。
+ * - 如果没传 permission，则只更新 display_name、content_hash、updated_by、updated_at。
+ *
+ * @param db - better-sqlite3 数据库实例
+ * @param input - 包含要更新字段的参数对象
+ */
+export function updateDocumentContent(db, input) {
+    // 根据是否传入 permission 决定使用哪条 SQL
+    if (input.permission !== undefined) {
+        db.prepare(`UPDATE documents
+       SET display_name = ?, content_hash = ?, updated_by = ?, updated_at = ?, permission = ?
+       WHERE document_id = ?`).run(input.displayName, input.contentHash, input.updatedBy, input.updatedAt, input.permission, input.documentId);
+    }
+    else {
+        db.prepare(`UPDATE documents
+       SET display_name = ?, content_hash = ?, updated_by = ?, updated_at = ?
+       WHERE document_id = ?`).run(input.displayName, input.contentHash, input.updatedBy, input.updatedAt, input.documentId);
+    }
+}
+/**
+ * 根据文档 ID 删除文档记录。
+ *
+ * 注意：此函数只删数据库记录，不删磁盘文件；
+ * 磁盘文件的删除由调用方（如 removeDocument 服务函数）负责。
+ *
+ * @param db - better-sqlite3 数据库实例
+ * @param documentId - 要删除的文档 ID
+ */
+export function deleteDocument(db, documentId) {
+    db.prepare(`DELETE FROM documents WHERE document_id = ?`).run(documentId);
+}
+/**
+ * 查询某访客对指定文档的邀请记录。
+ *
+ * @param db - better-sqlite3 数据库实例
+ * @param documentId - 文档 ID
+ * @param visitorId - 访客 ID
+ * @returns 邀请记录行；未找到则返回 undefined
+ */
+export function findDocumentInvite(db, documentId, visitorId) {
+    return db
+        .prepare(`SELECT document_id, visitor_id, permission FROM document_invites WHERE document_id = ? AND visitor_id = ?`)
+        .get(documentId, visitorId);
+}
+/**
+ * 插入或更新文档邀请记录。
+ *
+ * 使用 SQLite 的 ON CONFLICT ... DO UPDATE：
+ * 如果 (document_id, visitor_id) 组合已存在，则覆盖 permission 字段；
+ * 不存在则插入新记录。
+ *
+ * @param db - better-sqlite3 数据库实例
+ * @param documentId - 文档 ID
+ * @param visitorId - 被邀请的访客 ID
+ * @param permission - 授予的权限（read / edit）
+ */
+export function insertDocumentInvite(db, documentId, visitorId, permission) {
+    db.prepare(`INSERT INTO document_invites (document_id, visitor_id, permission) VALUES (?, ?, ?)
+     ON CONFLICT(document_id, visitor_id) DO UPDATE SET permission = excluded.permission`).run(documentId, visitorId, permission);
+}
+/**
+ * 删除指定文档对指定访客的邀请记录。
+ *
+ * @param db - better-sqlite3 数据库实例
+ * @param documentId - 文档 ID
+ * @param visitorId - 访客 ID
+ */
+export function deleteDocumentInvite(db, documentId, visitorId) {
+    db.prepare(`DELETE FROM document_invites WHERE document_id = ? AND visitor_id = ?`).run(documentId, visitorId);
+}
+/**
+ * 列出指定文档的所有邀请记录。
+ *
+ * @param db - better-sqlite3 数据库实例
+ * @param documentId - 文档 ID
+ * @returns 该文档的全部邀请记录数组
+ */
+export function listDocumentInvites(db, documentId) {
+    return db
+        .prepare(`SELECT document_id, visitor_id, permission FROM document_invites WHERE document_id = ?`)
+        .all(documentId);
+}
+/**
+ * 查的是什么：当前访客在「文档邀请」里涉及到的所有域 ID（同一域多篇邀请只算一次）。
+ * 怎么实现：`document_invites` 按 `document_id` 关联 `documents`，用 `visitor_id = ?` 过滤，`DISTINCT` 取 `domain_id`。
+ *
+ * 用途：批量列域时，可预先查出所有「因文档邀请而可见」的域ID集合，
+ * 避免在 resolveDomainAccess 中逐域查库。
+ *
+ * @param db - better-sqlite3 数据库实例
+ * @param visitorId - 当前访客 ID
+ * @returns 该访客被邀请过的所有文档所属域的 ID 数组（去重）
+ */
+export function listDomainIdsWithDocumentInviteForVisitor(db, visitorId) {
+    const rows = db
+        .prepare(`SELECT DISTINCT d.domain_id AS domain_id
+       FROM document_invites di
+       INNER JOIN documents d ON d.document_id = di.document_id
+       WHERE di.visitor_id = ?`)
+        .all(visitorId);
+    // 把对象数组展平为字符串数组
+    return rows.map((r) => r.domain_id);
+}
+/**
+ * 查的是什么：给定域里，是否存在至少一篇文档对当前访客有邀请记录。
+ * 怎么实现：同样的 invite 联 documents，加上 `domain_id = ?` 与 `visitor_id = ?`，用 `EXISTS` 只判断有无一行。
+ *
+ * 用途：在 resolveDomainAccess 中判断 restricted/private 域是否因文档邀请而对访客可见。
+ *
+ * @param db - better-sqlite3 数据库实例
+ * @param domainId - 目标域 ID
+ * @param visitorId - 当前访客 ID
+ * @returns true 表示该域里至少有一篇文档邀请了这个访客
+ */
+export function hasDocumentInviteInDomain(db, domainId, visitorId) {
+    const row = db
+        .prepare(`SELECT EXISTS (
+         SELECT 1 FROM document_invites di
+         INNER JOIN documents d ON d.document_id = di.document_id
+         WHERE d.domain_id = ? AND di.visitor_id = ?
+       ) AS ok`)
+        .get(domainId, visitorId);
+    // SQLite EXISTS 返回 1（存在）或 0（不存在）
+    return (row?.ok ?? 0) === 1;
+}
+/**
+ * 查找指定父目录下的所有直接子节点。
+ *
+ * @param db - better-sqlite3 数据库实例
+ * @param parentId - 父目录 document_id
+ * @returns 子节点数组
+ */
+export function findChildrenByParent(db, parentId) {
+    return db
+        .prepare(`SELECT document_id, domain_id, relative_path, display_name, owner_visitor_id,
+              created_by, updated_by, content_hash, created_at, updated_at, permission,
+              file_type, parent_id
+       FROM documents WHERE parent_id = ? ORDER BY relative_path`)
+        .all(parentId);
+}
+/**
+ * 统计指定父目录下的子节点数量。
+ */
+export function countChildrenByParent(db, parentId) {
+    const row = db
+        .prepare(`SELECT COUNT(*) as c FROM documents WHERE parent_id = ?`)
+        .get(parentId);
+    return row?.c ?? 0;
+}
+//# sourceMappingURL=document.repo.js.map

package/dist/server/db/repositories/document.repo.js.map

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