@yunzai-ng/core 0.1.0

package/dist/util/dispose.js

@@ -0,0 +1,143 @@
+/**
+ * 资源回收登记簿
+ *
+ * 线程模型：同进程单线程，无需加锁；但 `dispose()` 可能重入
+ * （插件在 disposer 里又触发卸载），故有 `#disposed` 幂等保护。
+ */
+export class DisposalRegistry {
+    /** 登记的回收器，按登记顺序存放 */
+    #entries = [];
+    /** 是否已回收 */
+    #disposed = false;
+    /** 归属标识，仅用于日志 */
+    #owner;
+    /**
+     * @param owner 归属标识（插件名等），出错时用于定位
+     */
+    constructor(owner) {
+        this.#owner = owner;
+    }
+    /** 是否已回收 */
+    get disposed() {
+        return this.#disposed;
+    }
+    /** 尚未回收的登记项数量 */
+    get size() {
+        return this.#entries.length;
+    }
+    /**
+     * 登记一个回收器
+     *
+     * 若 registry 已回收，传入的 disposer 会**立即执行** —— 这防止"卸载竞态"：
+     * 异步初始化的插件在卸载后才完成注册，资源没人回收。
+     * @param dispose 回收函数
+     * @param label 标签，用于报错定位
+     * @returns 取消登记并执行回收的函数；重复调用无副作用
+     */
+    add(dispose, label = "anonymous") {
+        if (this.#disposed) {
+            this.#runOne({ label, dispose });
+            return () => undefined;
+        }
+        const entry = { label, dispose };
+        this.#entries.push(entry);
+        let done = false;
+        return () => {
+            if (done)
+                return;
+            done = true;
+            const index = this.#entries.indexOf(entry);
+            if (index >= 0)
+                this.#entries.splice(index, 1);
+            this.#runOne(entry);
+        };
+    }
+    /**
+     * 登记一个 `Map`/`Set` 条目的清理
+     * @param collection 容器
+     * @param key 键
+     * @param label 标签
+     * @returns 回收函数
+     */
+    addEntry(collection, key, label = "entry") {
+        return this.add(() => void collection.delete(key), label);
+    }
+    /**
+     * 登记一个定时器
+     *
+     * 顺带 `unref`，让"只剩定时器"时进程能正常退出。
+     * @param timer 定时器句柄
+     * @param label 标签
+     * @returns 回收函数
+     */
+    addTimer(timer, label = "timer") {
+        if (typeof timer.unref === "function")
+            timer.unref();
+        return this.add(() => clearTimeout(timer), label);
+    }
+    /**
+     * 创建从属子登记簿
+     *
+     * 父簿回收时自动带走子簿。用于"插件里的账号连接"这类嵌套生命周期。
+     * @param owner 子簿归属标识
+     * @returns 子登记簿
+     */
+    child(owner) {
+        const sub = new DisposalRegistry(`${this.#owner}/${owner}`);
+        this.add(() => void sub.dispose(), `child:${owner}`);
+        return sub;
+    }
+    /**
+     * 逆序回收全部登记项
+     *
+     * 单个 disposer 抛错**不会**中断后续回收 —— 一个插件写错清理逻辑不应该
+     * 导致其余资源全部泄漏。所有错误汇总返回，由调用方（插件宿主）记日志。
+     * @returns 回收过程中发生的错误列表；无错时为空数组
+     */
+    dispose() {
+        if (this.#disposed)
+            return [];
+        this.#disposed = true;
+        const failures = [];
+        // 逆序：后注册的可能依赖先注册的
+        for (let i = this.#entries.length - 1; i >= 0; i--) {
+            const failure = this.#runOne(this.#entries[i]);
+            if (failure)
+                failures.push(failure);
+        }
+        this.#entries.length = 0;
+        return failures;
+    }
+    /**
+     * 执行单个回收器并捕获错误
+     * @param entry 登记项
+     * @returns 出错时返回错误信息，否则 undefined
+     */
+    #runOne(entry) {
+        try {
+            entry.dispose();
+            return undefined;
+        }
+        catch (error) {
+            return { label: `${this.#owner}:${entry.label}`, error };
+        }
+    }
+}
+/**
+ * 把多个 Disposer 合成一个
+ * @param disposers 回收函数列表（可含 undefined，便于条件注册）
+ * @returns 合成后的回收函数；逆序执行，单个抛错不影响其余
+ */
+export function combineDisposers(...disposers) {
+    return () => {
+        for (let i = disposers.length - 1; i >= 0; i--) {
+            try {
+                disposers[i]?.();
+            }
+            catch {
+                // 合成 disposer 拿不到 logger，只能忽略；需要记录的场景请用 DisposalRegistry
+            }
+        }
+    };
+}
+//# sourceMappingURL=dispose.js.map

package/dist/util/dispose.js.map

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

package/dist/util/duration.d.ts

@@ -0,0 +1,28 @@
+/**
+ * 模块职责：时长表达式解析
+ * 依赖方向：仅依赖类型包
+ * 生命周期：纯函数
+ * 注意事项：一律写 `"30d"` 而不是 `60 * 60 * 24 * 30`：手工算出来的秒数改一处要通查全部
+ *          调用点，而配置文件里也读不出那串数字是多久。
+ */
+import type { DurationLike } from "@yunzai-ng/types";
+/**
+ * 把时长表达式解析为毫秒
+ * @param value 毫秒数字，或形如 `"5s"` / `"30d"` 的字符串
+ * @param fallback 无法解析时返回的默认值，缺省 0
+ * @returns 毫秒数
+ */
+export declare function parseDuration(value: DurationLike | string | undefined | null, fallback?: number): number;
+/**
+ * 把毫秒格式化为人类可读的中文时长
+ * @param ms 毫秒数
+ * @returns 形如 `"1天2小时3分"` 的字符串；小于 1 秒时返回 `"<1秒"`
+ */
+export declare function formatDuration(ms: number): string;
+/**
+ * 把字节数格式化为可读大小
+ * @param bytes 字节数
+ * @returns 形如 `"12.34MB"` 的字符串
+ */
+export declare function formatBytes(bytes: number): string;
+//# sourceMappingURL=duration.d.ts.map

package/dist/util/duration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"duration.d.ts","sourceRoot":"","sources":["../../src/util/duration.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AAapD;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,YAAY,GAAG,MAAM,GAAG,SAAS,GAAG,IAAI,EAAE,QAAQ,SAAI,GAAG,MAAM,CAcnG;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAgBjD;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAWjD"}

package/dist/util/duration.js

@@ -0,0 +1,77 @@
+/** 各单位对应的毫秒数 */
+const UNIT_MS = {
+    ms: 1,
+    s: 1000,
+    m: 60_000,
+    h: 3_600_000,
+    d: 86_400_000
+};
+const DURATION_RE = /^(-?\d+(?:\.\d+)?)(ms|s|m|h|d)$/;
+/**
+ * 把时长表达式解析为毫秒
+ * @param value 毫秒数字，或形如 `"5s"` / `"30d"` 的字符串
+ * @param fallback 无法解析时返回的默认值，缺省 0
+ * @returns 毫秒数
+ */
+export function parseDuration(value, fallback = 0) {
+    if (value === undefined || value === null)
+        return fallback;
+    if (typeof value === "number")
+        return Number.isFinite(value) ? value : fallback;
+    const trimmed = value.trim();
+    if (trimmed === "")
+        return fallback;
+    // 纯数字串按毫秒处理，兼容从 YAML 里读到的 "5000"
+    if (/^-?\d+$/.test(trimmed))
+        return Number(trimmed);
+    const m = DURATION_RE.exec(trimmed);
+    if (!m)
+        return fallback;
+    const [, num, unit] = m;
+    return Number(num) * (UNIT_MS[unit] ?? 1);
+}
+/**
+ * 把毫秒格式化为人类可读的中文时长
+ * @param ms 毫秒数
+ * @returns 形如 `"1天2小时3分"` 的字符串；小于 1 秒时返回 `"<1秒"`
+ */
+export function formatDuration(ms) {
+    if (!Number.isFinite(ms) || ms < 0)
+        return "-";
+    if (ms < 1000)
+        return "<1秒";
+    const d = Math.floor(ms / UNIT_MS.d);
+    const h = Math.floor((ms % UNIT_MS.d) / UNIT_MS.h);
+    const m = Math.floor((ms % UNIT_MS.h) / UNIT_MS.m);
+    const s = Math.floor((ms % UNIT_MS.m) / 1000);
+    const parts = [];
+    if (d)
+        parts.push(`${d}天`);
+    if (h)
+        parts.push(`${h}小时`);
+    if (m)
+        parts.push(`${m}分`);
+    // 只有在没有更大单位时才显示秒，避免 "1天0小时0分3秒" 这种噪音
+    if (s && !d && !h)
+        parts.push(`${s}秒`);
+    return parts.join("") || "<1秒";
+}
+/**
+ * 把字节数格式化为可读大小
+ * @param bytes 字节数
+ * @returns 形如 `"12.34MB"` 的字符串
+ */
+export function formatBytes(bytes) {
+    if (!Number.isFinite(bytes))
+        return "-";
+    const units = ["B", "KB", "MB", "GB", "TB"];
+    let value = Math.abs(bytes);
+    let i = 0;
+    while (value >= 1024 && i < units.length - 1) {
+        value /= 1024;
+        i++;
+    }
+    const sign = bytes < 0 ? "-" : "";
+    return `${sign}${i === 0 ? value : value.toFixed(2)}${units[i]}`;
+}
+//# sourceMappingURL=duration.js.map

package/dist/util/duration.js.map

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

package/dist/util/fs.d.ts

@@ -0,0 +1,110 @@
+/**
+ * 从未知错误里取出 errno code
+ * @param err 错误
+ * @returns 错误码，取不到时 undefined
+ */
+export declare function errorCode(err: unknown): string | undefined;
+/**
+ * 路径是否存在
+ * @param path 路径
+ * @returns 是否存在
+ */
+export declare function pathExists(path: string): Promise<boolean>;
+/**
+ * 是否是目录
+ * @param path 路径
+ * @returns 是目录则 true；不存在或不是目录则 false
+ */
+export declare function isDirectory(path: string): Promise<boolean>;
+/**
+ * 是否是文件
+ * @param path 路径
+ * @returns 是文件则 true
+ */
+export declare function isFile(path: string): Promise<boolean>;
+/**
+ * 确保目录存在
+ * @param path 目录路径
+ * @returns 目录路径本身，便于链式使用
+ */
+export declare function ensureDir(path: string): Promise<string>;
+/**
+ * 原子写文件
+ *
+ * 先写同目录下的 `.tmp-*` 文件再 rename 覆盖 —— 同目录是关键，
+ * 跨分区 rename 不是原子操作。
+ * @param path 目标文件路径
+ * @param data 内容
+ * @throws 写入或替换失败时抛出；此时原文件保持不变
+ */
+export declare function atomicWrite(path: string, data: string | Uint8Array): Promise<void>;
+/**
+ * 读文本文件
+ * @param path 路径
+ * @returns 文件内容；不存在时 undefined
+ * @throws 除"不存在"以外的读取错误
+ */
+export declare function readText(path: string): Promise<string | undefined>;
+/**
+ * 读 JSON 文件
+ * @param path 路径
+ * @returns 解析结果；文件不存在时 undefined
+ * @throws JSON 解析失败时抛出，错误信息带上文件路径
+ */
+export declare function readJson<T = unknown>(path: string): Promise<T | undefined>;
+/**
+ * 原子写 JSON 文件
+ * @param path 路径
+ * @param value 数据
+ * @param pretty 是否缩进，缺省 true（配置类文件要能手改）
+ */
+export declare function writeJson(path: string, value: unknown, pretty?: boolean): Promise<void>;
+/**
+ * 列出目录下的子目录名
+ * @param path 目录路径
+ * @returns 子目录名数组；目录不存在时空数组
+ */
+export declare function listDirs(path: string): Promise<string[]>;
+/**
+ * 列出目录下的文件名
+ * @param path 目录路径
+ * @param ext 可选扩展名过滤，如 `".yaml"`
+ * @returns 文件名数组；目录不存在时空数组
+ */
+export declare function listFiles(path: string, ext?: string): Promise<string[]>;
+/**
+ * 删除文件或目录（不存在时静默）
+ * @param path 路径
+ */
+export declare function remove(path: string): Promise<void>;
+/**
+ * 取文件修改时间
+ * @param path 路径
+ * @returns 毫秒时间戳；文件不存在时 undefined
+ */
+export declare function mtimeOf(path: string): Promise<number | undefined>;
+/**
+ * 取文件大小
+ * @param path 路径
+ * @returns 字节数；文件不存在时 undefined
+ */
+export declare function sizeOf(path: string): Promise<number | undefined>;
+/**
+ * 在根目录内安全拼接路径，阻止 `../` 越界
+ *
+ * WebUI 的静态资源、插件模板资源都要按外部传入的相对路径取文件，
+ * 不做这层校验就是任意文件读取漏洞。
+ * @param root 允许访问的根目录
+ * @param requested 外部传入的相对路径
+ * @returns 解析后的绝对路径
+ * @throws 当结果落在 root 之外，或传入了绝对路径时
+ */
+export declare function safeJoin(root: string, requested: string): string;
+/**
+ * 判断路径是否在某目录内
+ * @param root 根目录
+ * @param target 待判定路径
+ * @returns 是否在根目录内（含自身）
+ */
+export declare function isInside(root: string, target: string): boolean;
+//# sourceMappingURL=fs.d.ts.map

package/dist/util/fs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs.d.ts","sourceRoot":"","sources":["../../src/util/fs.ts"],"names":[],"mappings":"AAiCA;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAM1D;AAED;;;;GAIG;AACH,wBAAsB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAO/D;AAED;;;;GAIG;AACH,wBAAsB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAMhE;AAED;;;;GAIG;AACH,wBAAsB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAM3D;AAED;;;;GAIG;AACH,wBAAsB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAG7D;AAwBD;;;;;;;;GAQG;AACH,wBAAsB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAYxF;AAED;;;;;GAKG;AACH,wBAAsB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAOxE;AAED;;;;;GAKG;AACH,wBAAsB,QAAQ,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,CAQhF;AAED;;;;;GAKG;AACH,wBAAsB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,UAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAE1F;AAED;;;;GAIG;AACH,wBAAsB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAQ9D;AAED;;;;;GAKG;AACH,wBAAsB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAS7E;AAED;;;GAGG;AACH,wBAAsB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAExD;AAED;;;;GAIG;AACH,wBAAsB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAMvE;AAED;;;;GAIG;AACH,wBAAsB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAMtE;AAED;;;;;;;;;GASG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAShE;AAED;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAG9D"}

package/dist/util/fs.js

@@ -0,0 +1,269 @@
+/**
+ * 模块职责：文件系统助手（原子写、目录保证、路径越界防护）
+ * 依赖方向：仅依赖 node:fs / node:path 与 util/defer
+ * 生命周期：纯函数
+ * 注意事项：**原子写是必需品**，一律走"写临时文件 → rename"。直接 `writeFileSync` 时，
+ *          进程恰在此刻被杀（Windows 关窗口、安卓被系统回收）会留下一个截断的配置文件，
+ *          下次启动即崩。
+ *
+ *          Windows 上 rename 会因杀软/资源管理器短暂占用而抛 EPERM
+ *          （本项目 pnpm install 就撞过一次），所以带退避重试。
+ */
+import { constants as fsConstants } from "node:fs";
+import { access, mkdir, readFile, readdir, rename, rm, stat, unlink, writeFile } from "node:fs/promises";
+import { dirname, isAbsolute, join, relative, resolve, sep } from "node:path";
+import { randomId } from "./id.js";
+import { sleep } from "./defer.js";
+/** rename 遇到占用类错误时的重试次数 */
+const RENAME_RETRIES = 5;
+/** 判定为"临时占用、可重试"的错误码 */
+const TRANSIENT_CODES = new Set(["EPERM", "EACCES", "EBUSY"]);
+/**
+ * 从未知错误里取出 errno code
+ * @param err 错误
+ * @returns 错误码，取不到时 undefined
+ */
+export function errorCode(err) {
+    if (err !== null && typeof err === "object" && "code" in err) {
+        const code = err.code;
+        if (typeof code === "string")
+            return code;
+    }
+    return undefined;
+}
+/**
+ * 路径是否存在
+ * @param path 路径
+ * @returns 是否存在
+ */
+export async function pathExists(path) {
+    try {
+        await access(path, fsConstants.F_OK);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * 是否是目录
+ * @param path 路径
+ * @returns 是目录则 true；不存在或不是目录则 false
+ */
+export async function isDirectory(path) {
+    try {
+        return (await stat(path)).isDirectory();
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * 是否是文件
+ * @param path 路径
+ * @returns 是文件则 true
+ */
+export async function isFile(path) {
+    try {
+        return (await stat(path)).isFile();
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * 确保目录存在
+ * @param path 目录路径
+ * @returns 目录路径本身，便于链式使用
+ */
+export async function ensureDir(path) {
+    await mkdir(path, { recursive: true });
+    return path;
+}
+/**
+ * 带重试的 rename
+ *
+ * Windows 下杀软扫描、编辑器索引会短暂锁住新建文件，导致 rename 抛 EPERM。
+ * 这类错误重试即可，不该让一次配置保存失败。
+ * @param from 源路径
+ * @param to 目标路径
+ * @throws 重试用尽后抛出最后一次错误
+ */
+async function renameWithRetry(from, to) {
+    for (let attempt = 1;; attempt++) {
+        try {
+            await rename(from, to);
+            return;
+        }
+        catch (err) {
+            const code = errorCode(err);
+            if (attempt >= RENAME_RETRIES || !code || !TRANSIENT_CODES.has(code))
+                throw err;
+            await sleep(20 * attempt);
+        }
+    }
+}
+/**
+ * 原子写文件
+ *
+ * 先写同目录下的 `.tmp-*` 文件再 rename 覆盖 —— 同目录是关键，
+ * 跨分区 rename 不是原子操作。
+ * @param path 目标文件路径
+ * @param data 内容
+ * @throws 写入或替换失败时抛出；此时原文件保持不变
+ */
+export async function atomicWrite(path, data) {
+    const dir = dirname(path);
+    await ensureDir(dir);
+    const tmp = join(dir, `.tmp-${randomId(8)}`);
+    try {
+        await writeFile(tmp, data);
+        await renameWithRetry(tmp, path);
+    }
+    catch (err) {
+        // 清理临时文件，失败也不掩盖原始错误
+        await unlink(tmp).catch(() => undefined);
+        throw err;
+    }
+}
+/**
+ * 读文本文件
+ * @param path 路径
+ * @returns 文件内容；不存在时 undefined
+ * @throws 除"不存在"以外的读取错误
+ */
+export async function readText(path) {
+    try {
+        return await readFile(path, "utf8");
+    }
+    catch (err) {
+        if (errorCode(err) === "ENOENT")
+            return undefined;
+        throw err;
+    }
+}
+/**
+ * 读 JSON 文件
+ * @param path 路径
+ * @returns 解析结果；文件不存在时 undefined
+ * @throws JSON 解析失败时抛出，错误信息带上文件路径
+ */
+export async function readJson(path) {
+    const text = await readText(path);
+    if (text === undefined)
+        return undefined;
+    try {
+        return JSON.parse(text);
+    }
+    catch (err) {
+        throw new Error(`解析 JSON 失败：${path} —— ${err instanceof Error ? err.message : String(err)}`);
+    }
+}
+/**
+ * 原子写 JSON 文件
+ * @param path 路径
+ * @param value 数据
+ * @param pretty 是否缩进，缺省 true（配置类文件要能手改）
+ */
+export async function writeJson(path, value, pretty = true) {
+    await atomicWrite(path, JSON.stringify(value, null, pretty ? 2 : undefined));
+}
+/**
+ * 列出目录下的子目录名
+ * @param path 目录路径
+ * @returns 子目录名数组；目录不存在时空数组
+ */
+export async function listDirs(path) {
+    try {
+        const entries = await readdir(path, { withFileTypes: true });
+        return entries.filter(e => e.isDirectory()).map(e => e.name);
+    }
+    catch (err) {
+        if (errorCode(err) === "ENOENT")
+            return [];
+        throw err;
+    }
+}
+/**
+ * 列出目录下的文件名
+ * @param path 目录路径
+ * @param ext 可选扩展名过滤，如 `".yaml"`
+ * @returns 文件名数组；目录不存在时空数组
+ */
+export async function listFiles(path, ext) {
+    try {
+        const entries = await readdir(path, { withFileTypes: true });
+        const files = entries.filter(e => e.isFile()).map(e => e.name);
+        return ext ? files.filter(name => name.endsWith(ext)) : files;
+    }
+    catch (err) {
+        if (errorCode(err) === "ENOENT")
+            return [];
+        throw err;
+    }
+}
+/**
+ * 删除文件或目录（不存在时静默）
+ * @param path 路径
+ */
+export async function remove(path) {
+    await rm(path, { recursive: true, force: true });
+}
+/**
+ * 取文件修改时间
+ * @param path 路径
+ * @returns 毫秒时间戳；文件不存在时 undefined
+ */
+export async function mtimeOf(path) {
+    try {
+        return (await stat(path)).mtimeMs;
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * 取文件大小
+ * @param path 路径
+ * @returns 字节数；文件不存在时 undefined
+ */
+export async function sizeOf(path) {
+    try {
+        return (await stat(path)).size;
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * 在根目录内安全拼接路径，阻止 `../` 越界
+ *
+ * WebUI 的静态资源、插件模板资源都要按外部传入的相对路径取文件，
+ * 不做这层校验就是任意文件读取漏洞。
+ * @param root 允许访问的根目录
+ * @param requested 外部传入的相对路径
+ * @returns 解析后的绝对路径
+ * @throws 当结果落在 root 之外，或传入了绝对路径时
+ */
+export function safeJoin(root, requested) {
+    if (isAbsolute(requested))
+        throw new Error(`路径越界：不接受绝对路径 ${requested}`);
+    const rootAbs = resolve(root);
+    const target = resolve(rootAbs, requested);
+    const rel = relative(rootAbs, target);
+    if (rel === "" || rel.startsWith("..") || isAbsolute(rel)) {
+        throw new Error(`路径越界：${requested}`);
+    }
+    return target;
+}
+/**
+ * 判断路径是否在某目录内
+ * @param root 根目录
+ * @param target 待判定路径
+ * @returns 是否在根目录内（含自身）
+ */
+export function isInside(root, target) {
+    const rel = relative(resolve(root), resolve(target));
+    return rel === "" || (!rel.startsWith(`..${sep}`) && rel !== ".." && !isAbsolute(rel));
+}
+//# sourceMappingURL=fs.js.map

package/dist/util/fs.js.map

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