@yunzai-ng/core 0.1.0

package/dist/store/sql.js

@@ -0,0 +1,246 @@
+var _a;
+import { dirname } from "node:path";
+import { LruCache } from "../util/lru.js";
+import { Semaphore } from "../util/queue.js";
+import { ensureDir } from "../util/fs.js";
+/** 语句缓存条目上限 */
+const STMT_CACHE_MAX = 200;
+/** 迁移记录表名 */
+const MIGRATION_TABLE = "_yzng_migrations";
+/**
+ * 尝试加载 better-sqlite3
+ * @returns 构造函数；模块不可用时 undefined
+ */
+export async function loadSqlite() {
+    try {
+        const mod = (await import("better-sqlite3"));
+        return mod.default;
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * SQLite 句柄
+ *
+ * 根句柄由 `openSql()` 创建；事务内传给回调的是 `depth > 0` 的子句柄，
+ * 它们共享同一条连接，因此**不能**在事务回调里持有子句柄留到事务外使用。
+ */
+export class SqliteHandle {
+    /** 共享状态 */
+    #state;
+    /** 事务嵌套深度，0 表示不在事务中 */
+    #depth;
+    /**
+     * @param state 共享状态
+     * @param depth 事务嵌套深度
+     */
+    constructor(state, depth = 0) {
+        this.#state = state;
+        this.#depth = depth;
+    }
+    /**
+     * 执行不返回行的语句
+     *
+     * 不带参数且含多条语句时走 `exec()`，方便迁移里一次建表 + 建索引；
+     * 这种情况下无法报告受影响行数，返回 0。
+     * @param sql SQL 文本
+     * @param params 绑定参数
+     * @returns 受影响行数与最后插入 id
+     */
+    async run(sql, params = []) {
+        if (params.length === 0 && isMultiStatement(sql)) {
+            this.#state.db.exec(sql);
+            return { changes: 0, lastInsertRowid: 0 };
+        }
+        return this.#prepare(sql).run(...params);
+    }
+    /**
+     * 查询多行
+     * @param sql SQL 文本
+     * @param params 绑定参数
+     * @returns 结果行数组
+     */
+    async all(sql, params = []) {
+        return this.#prepare(sql).all(...params);
+    }
+    /**
+     * 查询首行
+     * @param sql SQL 文本
+     * @param params 绑定参数
+     * @returns 首行；无结果时 undefined
+     */
+    async get(sql, params = []) {
+        return this.#prepare(sql).get(...params) ?? undefined;
+    }
+    /**
+     * 在事务中执行
+     *
+     * 最外层用 `BEGIN IMMEDIATE`（立刻拿写锁，避免升级锁时才发现冲突而整段重来）；
+     * 嵌套层用 SAVEPOINT，实现"内层回滚不牵连外层"。
+     * @param fn 事务体，抛错即回滚
+     * @returns 事务体的返回值
+     */
+    async transaction(fn) {
+        if (this.#depth > 0)
+            return this.#savepoint(fn);
+        // 同一条连接上不能并发开事务，排队等前一个事务结束
+        return this.#state.mutex.use(async () => {
+            const tx = new _a(this.#state, 1);
+            this.#state.db.exec("BEGIN IMMEDIATE");
+            try {
+                const result = await fn(tx);
+                this.#state.db.exec("COMMIT");
+                return result;
+            }
+            catch (err) {
+                // 回滚本身也可能失败（连接已断），此时保留原始错误更有诊断价值
+                try {
+                    this.#state.db.exec("ROLLBACK");
+                }
+                catch {
+                    /* 忽略 */
+                }
+                throw err;
+            }
+        });
+    }
+    /**
+     * 应用迁移
+     *
+     * 每条迁移单独一个事务：失败只回滚这一条，已成功的保持生效，修好后重跑从断点继续。
+     * 版本号落在迁移表里，故"这个库到哪一版了"有确定答案，不必靠"存在则忽略"的 try/catch。
+     * @param migrations 迁移列表
+     * @throws 版本号未严格递增，或某条迁移执行失败
+     */
+    async migrate(migrations) {
+        await this.run(`CREATE TABLE IF NOT EXISTS ${MIGRATION_TABLE} (
+         version INTEGER PRIMARY KEY,
+         name TEXT NOT NULL,
+         applied_at INTEGER NOT NULL
+       )`);
+        const sorted = [...migrations].sort((a, b) => a.version - b.version);
+        for (let i = 1; i < sorted.length; i++) {
+            if (sorted[i].version === sorted[i - 1].version) {
+                throw new Error(`迁移版本号重复：${sorted[i].version}`);
+            }
+        }
+        const rows = await this.all(`SELECT version FROM ${MIGRATION_TABLE}`);
+        const applied = new Set(rows.map(r => r.version));
+        for (const migration of sorted) {
+            if (applied.has(migration.version))
+                continue;
+            await this.transaction(async (tx) => {
+                await migration.up(tx);
+                await tx.run(`INSERT INTO ${MIGRATION_TABLE} (version, name, applied_at) VALUES (?, ?, ?)`, [
+                    migration.version,
+                    migration.name,
+                    Date.now()
+                ]);
+            });
+        }
+    }
+    /**
+     * 嵌套事务：SAVEPOINT
+     * @param fn 事务体
+     * @returns 事务体的返回值
+     */
+    async #savepoint(fn) {
+        const name = `yzng_sp_${++this.#state.savepoint}`;
+        const tx = new _a(this.#state, this.#depth + 1);
+        this.#state.db.exec(`SAVEPOINT ${name}`);
+        try {
+            const result = await fn(tx);
+            this.#state.db.exec(`RELEASE ${name}`);
+            return result;
+        }
+        catch (err) {
+            try {
+                this.#state.db.exec(`ROLLBACK TO ${name}`);
+                this.#state.db.exec(`RELEASE ${name}`);
+            }
+            catch {
+                /* 忽略 */
+            }
+            throw err;
+        }
+    }
+    /**
+     * 取（并缓存）预编译语句
+     * @param sql SQL 文本
+     * @returns 预编译语句
+     */
+    #prepare(sql) {
+        const cached = this.#state.stmts.get(sql);
+        if (cached)
+            return cached;
+        const stmt = this.#state.db.prepare(sql);
+        this.#state.stmts.set(sql, stmt);
+        return stmt;
+    }
+}
+_a = SqliteHandle;
+/**
+ * 打开 SQLite 数据库
+ * @param opts 参数
+ * @returns 已打开的 SQL 存储；原生模块不可用时 undefined（调用方应降级为纯 KV）
+ */
+export async function openSql(opts) {
+    const ctor = opts.ctor ?? (await loadSqlite());
+    if (!ctor)
+        return undefined;
+    await ensureDir(dirname(opts.file));
+    const db = new ctor(opts.file);
+    // WAL：读不阻塞写，且断电时不会像 rollback journal 那样留下半个事务
+    db.pragma("journal_mode = WAL");
+    // NORMAL 在 WAL 下依然崩溃安全（只可能丢最后一个未 checkpoint 的事务），
+    // 却比 FULL 快一个数量级；机器人数据不是账本，这个取舍是合适的
+    db.pragma("synchronous = NORMAL");
+    db.pragma("foreign_keys = ON");
+    // 被别的连接短暂锁住时等一会儿再报错，而不是立刻抛 SQLITE_BUSY
+    db.pragma("busy_timeout = 5000");
+    const state = {
+        db,
+        stmts: new LruCache({ max: STMT_CACHE_MAX }),
+        mutex: new Semaphore(1),
+        savepoint: 0
+    };
+    return {
+        handle: new SqliteHandle(state),
+        file: opts.file,
+        close: () => {
+            // 缓存里的语句必须先丢掉：连接关了之后再用它们会直接崩进程
+            state.stmts.clear();
+            db.close();
+        }
+    };
+}
+/**
+ * 判断 SQL 是否包含多条语句
+ *
+ * 只做粗判：跳过字符串字面量后看是否还有 `;` 跟着非空白内容。
+ * 粗判失败的后果仅仅是走 `prepare()` 然后由 SQLite 自己报错，可接受。
+ * @param sql SQL 文本
+ * @returns 是否多语句
+ */
+function isMultiStatement(sql) {
+    let inString = false;
+    let quote = "";
+    for (let i = 0; i < sql.length; i++) {
+        const ch = sql[i];
+        if (inString) {
+            if (ch === quote)
+                inString = false;
+            continue;
+        }
+        if (ch === "'" || ch === '"') {
+            inString = true;
+            quote = ch;
+            continue;
+        }
+        if (ch === ";" && sql.slice(i + 1).trim() !== "")
+            return true;
+    }
+    return false;
+}
+//# sourceMappingURL=sql.js.map

package/dist/store/sql.js.map

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

package/dist/testing/fake.d.ts

@@ -0,0 +1,109 @@
+/**
+ * 模块职责：测试替身（假日志器、录制型子系统接缝、最小应用视图）
+ * 依赖方向：依赖 plugin/hooks、类型包；只被 `*.test.ts` 使用
+ * 生命周期：每个用例新建一套
+ * 注意事项：这些替身**刻意采用真实实现而非 mock 框架的自动桩** —— 注册后必须可查得到、
+ *          注销后必须可查得已不存在，否则"卸载是否确实归还了资源"这类断言无从落地。
+ *
+ *          目前仅用于内核自身的测试。将来若需使插件作者亦可借其编写单元测试，
+ *          须同时放开分层门禁中 `@yunzai-ng/core/*` 的深引限制 ——
+ *          那是一次独立的、需要写入文档的决定，不在此处附带开放。
+ */
+import type { AdapterProvider, AppView, HttpClient, KvDriver, Logger, RenderRequest, RendererProvider } from "@yunzai-ng/types";
+import type { CommandRegistration, KernelHooks, MiddlewareRegistration, TaskRegistration } from "../plugin/hooks.js";
+/** 带行记录的假日志器 */
+export interface FakeLogger extends Logger {
+    /** 已记录的日志行，形如 `"warn 消息 附加参数"` */
+    readonly lines: string[];
+}
+/**
+ * 创建假日志器
+ *
+ * 断言"出错时给了提示"而不是"抛异常中断"时用它 —— 框架里大量路径的正确行为
+ * 就是"记一条能照着解决的 warn 然后继续跑"，没有日志断言就测不到。
+ * @returns 假日志器
+ */
+export declare function fakeLogger(): FakeLogger;
+/** 一条静态目录挂载记录 */
+export interface StaticMount {
+    /** URL 作用域；面板挂载记为归属标识（如 `plugin:webui-next`） */
+    scope: string;
+    /** URL 前缀；面板挂载记为 `"/"` */
+    urlPath: string;
+    /** 本地目录 */
+    dir: string;
+    /** 是否为单页应用挂载（`ctx.panel()` 记为真） */
+    spa: boolean;
+}
+/** 一条路由记录 */
+export interface RouteMount {
+    /** URL 作用域 */
+    scope: string;
+    /** 方法，WebSocket 记为 `"WS"` */
+    method: string;
+    /** 路径 */
+    path: string;
+}
+/** 录制到的全部注册 */
+export interface Recorded {
+    /** 命令 */
+    commands: CommandRegistration[];
+    /** 重新索引的次数（按命令去重前的调用计数） */
+    reindexed: CommandRegistration[];
+    /** 中间件 */
+    middlewares: MiddlewareRegistration[];
+    /** 定时任务 */
+    tasks: TaskRegistration[];
+    /** 路由与 WebSocket */
+    routes: RouteMount[];
+    /** 静态目录 */
+    statics: StaticMount[];
+    /** 适配器 */
+    adapters: AdapterProvider[];
+    /** 渲染器 */
+    renderers: RendererProvider[];
+    /** 收到的渲染请求（断言 templateRoot/resourceRoot 是否算对） */
+    renders: RenderRequest[];
+    /** KV 驱动 */
+    kvDrivers: KvDriver[];
+    /** 已打开的 SQL 库，形如 `"插件名/库名"` */
+    sqlOpened: string[];
+    /** 被要求关闭全部库的插件名 */
+    sqlClosed: string[];
+}
+/** 录制型接缝与其录制结果 */
+export interface RecordingHooks {
+    /** 交给上下文的接缝 */
+    hooks: KernelHooks;
+    /** 录制结果 */
+    recorded: Recorded;
+}
+/**
+ * 创建录制型子系统接缝
+ *
+ * 每个 `register` 均确实将登记写入数组，返回的 disposer 亦确实将其摘除。
+ * 因此"插件卸载后残留多少条命令"可直接断言 `recorded.commands.length === 0`。
+ * @returns 接缝与录制结果
+ */
+export declare function recordingHooks(): RecordingHooks;
+/**
+ * 创建最小应用视图
+ *
+ * 只填测试真正会读的字段，其余用类型断言留空 —— `AppView` 聚合了适配器、
+ * 账号、策略等一大票子系统视图，为一个上下文测试把它们全造出来毫无收益。
+ * 一旦某个用例真的要读某字段，就在这里补上真的实现。
+ * @returns 应用视图
+ */
+export declare function fakeAppView(): AppView;
+/**
+ * 创建假 HTTP 客户端
+ *
+ * 任何调用均抛错：网络请求出现在单元测试中几乎总属设计问题，应使其显式失败。
+ *
+ * 方法列表与 `HttpClient` 逐一对齐，且**不使用 as unknown as 断言** ——
+ * 经断言的替身对象会掩盖"契约已变更"一事：真实客户端新增一个方法后，
+ * 只有被测代码调用它时才在运行时抛错，而编译期不会报告任何问题。
+ * @returns HTTP 客户端
+ */
+export declare function fakeHttp(): HttpClient;
+//# sourceMappingURL=fake.d.ts.map

package/dist/testing/fake.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fake.d.ts","sourceRoot":"","sources":["../../src/testing/fake.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EACV,eAAe,EACf,OAAO,EACP,UAAU,EACV,QAAQ,EAER,MAAM,EACN,aAAa,EACb,gBAAgB,EAEjB,MAAM,kBAAkB,CAAA;AACzB,OAAO,KAAK,EACV,mBAAmB,EACnB,WAAW,EACX,sBAAsB,EACtB,gBAAgB,EACjB,MAAM,oBAAoB,CAAA;AAE3B,gBAAgB;AAChB,MAAM,WAAW,UAAW,SAAQ,MAAM;IACxC,kCAAkC;IAClC,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,CAAA;CACzB;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,IAAI,UAAU,CAwBvC;AAED,iBAAiB;AACjB,MAAM,WAAW,WAAW;IAC1B,gDAAgD;IAChD,KAAK,EAAE,MAAM,CAAA;IACb,0BAA0B;IAC1B,OAAO,EAAE,MAAM,CAAA;IACf,WAAW;IACX,GAAG,EAAE,MAAM,CAAA;IACX,mCAAmC;IACnC,GAAG,EAAE,OAAO,CAAA;CACb;AAED,aAAa;AACb,MAAM,WAAW,UAAU;IACzB,cAAc;IACd,KAAK,EAAE,MAAM,CAAA;IACb,6BAA6B;IAC7B,MAAM,EAAE,MAAM,CAAA;IACd,SAAS;IACT,IAAI,EAAE,MAAM,CAAA;CACb;AAED,eAAe;AACf,MAAM,WAAW,QAAQ;IACvB,SAAS;IACT,QAAQ,EAAE,mBAAmB,EAAE,CAAA;IAC/B,2BAA2B;IAC3B,SAAS,EAAE,mBAAmB,EAAE,CAAA;IAChC,UAAU;IACV,WAAW,EAAE,sBAAsB,EAAE,CAAA;IACrC,WAAW;IACX,KAAK,EAAE,gBAAgB,EAAE,CAAA;IACzB,oBAAoB;IACpB,MAAM,EAAE,UAAU,EAAE,CAAA;IACpB,WAAW;IACX,OAAO,EAAE,WAAW,EAAE,CAAA;IACtB,UAAU;IACV,QAAQ,EAAE,eAAe,EAAE,CAAA;IAC3B,UAAU;IACV,SAAS,EAAE,gBAAgB,EAAE,CAAA;IAC7B,iDAAiD;IACjD,OAAO,EAAE,aAAa,EAAE,CAAA;IACxB,YAAY;IACZ,SAAS,EAAE,QAAQ,EAAE,CAAA;IACrB,+BAA+B;IAC/B,SAAS,EAAE,MAAM,EAAE,CAAA;IACnB,mBAAmB;IACnB,SAAS,EAAE,MAAM,EAAE,CAAA;CACpB;AAED,kBAAkB;AAClB,MAAM,WAAW,cAAc;IAC7B,eAAe;IACf,KAAK,EAAE,WAAW,CAAA;IAClB,WAAW;IACX,QAAQ,EAAE,QAAQ,CAAA;CACnB;AAeD;;;;;;GAMG;AACH,wBAAgB,cAAc,IAAI,cAAc,CA4G/C;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,IAAI,OAAO,CAMrC;AAED;;;;;;;;;GASG;AACH,wBAAgB,QAAQ,IAAI,UAAU,CAcrC"}

package/dist/testing/fake.js

@@ -0,0 +1,196 @@
+/**
+ * 创建假日志器
+ *
+ * 断言"出错时给了提示"而不是"抛异常中断"时用它 —— 框架里大量路径的正确行为
+ * 就是"记一条能照着解决的 warn 然后继续跑"，没有日志断言就测不到。
+ * @returns 假日志器
+ */
+export function fakeLogger() {
+    const lines = [];
+    /** 生成某个级别的记录函数 */
+    const push = (level) => (msg, ...args) => {
+        const extra = args.map(a => (a instanceof Error ? a.message : String(a))).join(" ");
+        lines.push(`${level} ${String(msg)} ${extra}`.trim());
+    };
+    const logger = {
+        lines,
+        level: "trace",
+        trace: push("trace"),
+        debug: push("debug"),
+        info: push("info"),
+        warn: push("warn"),
+        error: push("error"),
+        fatal: push("fatal"),
+        mark: push("info"),
+        child: () => logger,
+        isLevelEnabled: () => true
+    };
+    return logger;
+}
+/**
+ * 从数组里移除某项的 disposer
+ * @param list 数组
+ * @param item 待移除项
+ * @returns 注销函数
+ */
+function remover(list, item) {
+    return () => {
+        const index = list.indexOf(item);
+        if (index >= 0)
+            list.splice(index, 1);
+    };
+}
+/**
+ * 创建录制型子系统接缝
+ *
+ * 每个 `register` 均确实将登记写入数组，返回的 disposer 亦确实将其摘除。
+ * 因此"插件卸载后残留多少条命令"可直接断言 `recorded.commands.length === 0`。
+ * @returns 接缝与录制结果
+ */
+export function recordingHooks() {
+    const recorded = {
+        commands: [],
+        reindexed: [],
+        middlewares: [],
+        tasks: [],
+        routes: [],
+        statics: [],
+        adapters: [],
+        renderers: [],
+        renders: [],
+        kvDrivers: [],
+        sqlOpened: [],
+        sqlClosed: []
+    };
+    /** 假 SQL 句柄：只记录被调用过，不真的建库 */
+    const sqlHandle = {
+        file: ":fake:",
+        exec: () => undefined,
+        run: () => ({ changes: 0, lastInsertRowid: 0 }),
+        get: () => undefined,
+        all: () => [],
+        transaction: (fn) => fn(),
+        pragma: () => undefined
+    };
+    const hooks = {
+        commands: {
+            register: reg => {
+                recorded.commands.push(reg);
+                return remover(recorded.commands, reg);
+            },
+            reindex: reg => void recorded.reindexed.push(reg)
+        },
+        middlewares: {
+            register: reg => {
+                recorded.middlewares.push(reg);
+                return remover(recorded.middlewares, reg);
+            }
+        },
+        tasks: {
+            register: reg => {
+                recorded.tasks.push(reg);
+                return remover(recorded.tasks, reg);
+            }
+        },
+        server: {
+            info: { enabled: true, host: "127.0.0.1", port: 2536, publicUrl: "http://127.0.0.1:2536" },
+            route: (scope, method, path) => {
+                const mount = { scope, method, path };
+                recorded.routes.push(mount);
+                return remover(recorded.routes, mount);
+            },
+            websocket: (scope, path) => {
+                const mount = { scope, method: "WS", path };
+                recorded.routes.push(mount);
+                return remover(recorded.routes, mount);
+            },
+            static: (scope, urlPath, dir) => {
+                const mount = { scope, urlPath, dir, spa: false };
+                recorded.statics.push(mount);
+                return remover(recorded.statics, mount);
+            },
+            panel: (owner, dir) => {
+                const mount = { scope: owner, urlPath: "/", dir, spa: true };
+                recorded.statics.push(mount);
+                return remover(recorded.statics, mount);
+            },
+            // 只按 urlPath 相等判断：录制型接缝不实现路径表，而调用方（内核挂载内置面板）
+            // 问的只是"根路径有没有人接管"这一种情况
+            claimant: path => recorded.statics.find(m => m.urlPath === path)?.scope
+        },
+        render: {
+            register: provider => {
+                recorded.renderers.push(provider);
+                return remover(recorded.renderers, provider);
+            },
+            // 一张 3 字节的假图：断言"渲染结果被包成 ImageSegment"用得到，
+            // 不需要真的产生 PNG
+            render: async (req) => {
+                recorded.renders.push(req);
+                return { images: [new Uint8Array([1, 2, 3])], cost: 1, renderer: "fake" };
+            }
+        },
+        adapters: {
+            register: provider => {
+                recorded.adapters.push(provider);
+                return remover(recorded.adapters, provider);
+            }
+        },
+        kvDrivers: {
+            register: driver => {
+                recorded.kvDrivers.push(driver);
+                return remover(recorded.kvDrivers, driver);
+            }
+        },
+        sql: {
+            open: async (plugin, name) => {
+                recorded.sqlOpened.push(`${plugin}/${name}`);
+                return sqlHandle;
+            },
+            close: async (plugin) => void recorded.sqlClosed.push(plugin)
+        },
+        bots: { pick: () => undefined }
+    };
+    return { hooks, recorded };
+}
+/**
+ * 创建最小应用视图
+ *
+ * 只填测试真正会读的字段，其余用类型断言留空 —— `AppView` 聚合了适配器、
+ * 账号、策略等一大票子系统视图，为一个上下文测试把它们全造出来毫无收益。
+ * 一旦某个用例真的要读某字段，就在这里补上真的实现。
+ * @returns 应用视图
+ */
+export function fakeAppView() {
+    return {
+        version: "0.0.0-test",
+        startedAt: 0,
+        usage: () => ({ rss: 0, heapUsed: 0, heapTotal: 0, external: 0, uptime: 0, cpu: 0 })
+    };
+}
+/**
+ * 创建假 HTTP 客户端
+ *
+ * 任何调用均抛错：网络请求出现在单元测试中几乎总属设计问题，应使其显式失败。
+ *
+ * 方法列表与 `HttpClient` 逐一对齐，且**不使用 as unknown as 断言** ——
+ * 经断言的替身对象会掩盖"契约已变更"一事：真实客户端新增一个方法后，
+ * 只有被测代码调用它时才在运行时抛错，而编译期不会报告任何问题。
+ * @returns HTTP 客户端
+ */
+export function fakeHttp() {
+    /** 统一拒绝 */
+    const fail = () => {
+        throw new Error("测试中不应发起真实 HTTP 请求");
+    };
+    const client = {
+        request: fail,
+        get: fail,
+        post: fail,
+        buffer: fail,
+        download: fail,
+        extend: () => client
+    };
+    return client;
+}
+//# sourceMappingURL=fake.js.map

package/dist/testing/fake.js.map

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

package/dist/testing/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * 模块职责：`@yunzai-ng/core/testing` 的入口，汇总内核提供的测试替身
+ * 依赖方向：只做转发
+ * 生命周期：无
+ * 注意事项：这些替身刻意**不**从主入口 `@yunzai-ng/core` 导出 —— 一并导出会使测试替身
+ *          进入生产依赖图（见 src/index.ts 的说明）。适配器与插件作者编写测试时：
+ *          ```ts
+ *          import { createMockAdapter, fakeLogger } from "@yunzai-ng/core/testing"
+ *          ```
+ *
+ *          与内核自身那些 `*.test.ts` 的分工：后者是内部单元测试，直接以相对路径 import
+ *          内部模块；此处是**对外公开**的替身，因此每次改动均应视为 API 变更。
+ */
+export * from "./fake.js";
+export * from "./mock-adapter.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/testing/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/testing/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,cAAc,WAAW,CAAA;AACzB,cAAc,mBAAmB,CAAA"}

package/dist/testing/index.js

@@ -0,0 +1,16 @@
+/**
+ * 模块职责：`@yunzai-ng/core/testing` 的入口，汇总内核提供的测试替身
+ * 依赖方向：只做转发
+ * 生命周期：无
+ * 注意事项：这些替身刻意**不**从主入口 `@yunzai-ng/core` 导出 —— 一并导出会使测试替身
+ *          进入生产依赖图（见 src/index.ts 的说明）。适配器与插件作者编写测试时：
+ *          ```ts
+ *          import { createMockAdapter, fakeLogger } from "@yunzai-ng/core/testing"
+ *          ```
+ *
+ *          与内核自身那些 `*.test.ts` 的分工：后者是内部单元测试，直接以相对路径 import
+ *          内部模块；此处是**对外公开**的替身，因此每次改动均应视为 API 变更。
+ */
+export * from "./fake.js";
+export * from "./mock-adapter.js";
+//# sourceMappingURL=index.js.map

package/dist/testing/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/testing/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,cAAc,WAAW,CAAA;AACzB,cAAc,mBAAmB,CAAA"}