@yunzai-ng/core 0.1.0

package/dist/store/json.d.ts

@@ -0,0 +1,73 @@
+/**
+ * 模块职责：JSON 文件 KV 驱动（纯 JS 兜底，Termux/无编译环境用）
+ * 依赖方向：依赖 util/{fs,deep}、类型包
+ * 生命周期：`open()` 载入全量数据，`close()` 落盘；进程存续期间数据常驻内存
+ * 注意事项：**这是兜底方案，不是主力**。全量数据常驻内存 + 每次写盘重写整个文件，
+ *          数据量大了必然吃内存与 IO；只在原生模块装不上（Android/Termux 常见）
+ *          时启用，`level` 驱动才是默认。
+ *
+ *          写盘做了两件事防丢数据：一是合并窗口内的多次写只落一次盘，
+ *          二是走 `atomicWrite`（同目录临时文件 + rename），断电不会留下半个文件。
+ *          进程退出前必须 `close()`，否则最后一个窗口内的写入会丢。
+ */
+import type { KvBatchOp, KvDriver, StoredEnvelope } from "@yunzai-ng/types";
+/** JSON 文件 KV 驱动 */
+export declare class JsonKvDriver implements KvDriver {
+    #private;
+    /** 驱动 id */
+    readonly id = "json";
+    /**
+     * @param file 数据文件绝对路径
+     */
+    constructor(file: string);
+    /** 键数量 */
+    get size(): number;
+    /**
+     * 载入数据
+     *
+     * 文件损坏时不抛错也不删除：改名为 `.corrupt-<时间戳>` 留证，然后从空库启动。
+     * 存储坏了让机器人起不来，比丢一点缓存严重得多。
+     */
+    open(): Promise<void>;
+    /** 落盘并停止后续写入 */
+    close(): Promise<void>;
+    /**
+     * 读取
+     * @param key 完整键
+     * @returns 值信封副本
+     */
+    get(key: string): Promise<StoredEnvelope | undefined>;
+    /**
+     * 写入
+     * @param key 完整键
+     * @param value 值信封
+     */
+    set(key: string, value: StoredEnvelope): Promise<void>;
+    /**
+     * 删除
+     * @param key 完整键
+     */
+    del(key: string): Promise<void>;
+    /**
+     * 批量操作（只触发一次落盘）
+     * @param ops 操作列表
+     */
+    batch(ops: KvBatchOp[]): Promise<void>;
+    /**
+     * 按前缀扫描
+     * @param prefix 键前缀
+     * @returns 键值对迭代器
+     */
+    scan(prefix: string): AsyncIterableIterator<readonly [string, StoredEnvelope]>;
+    /**
+     * 原生原子自增（同步读改写，单线程下天然原子）
+     * @param key 完整键
+     * @param by 增量
+     * @param expireAt 首次创建时的过期时间点
+     * @returns 自增后的值
+     */
+    incr(key: string, by: number, expireAt?: number): Promise<number>;
+    /** 立即落盘（`close()` 与测试用） */
+    flush(): Promise<void>;
+}
+//# sourceMappingURL=json.d.ts.map

package/dist/store/json.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.d.ts","sourceRoot":"","sources":["../../src/store/json.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AAoB3E,oBAAoB;AACpB,qBAAa,YAAa,YAAW,QAAQ;;IAC3C,YAAY;IACZ,QAAQ,CAAC,EAAE,UAAS;IAepB;;OAEG;gBACS,IAAI,EAAE,MAAM;IAIxB,UAAU;IACV,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;;;;OAKG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAoB3B,gBAAgB;IACV,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAS5B;;;;OAIG;IACG,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC;IAK3D;;;;OAIG;IACG,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAK5D;;;OAGG;IACG,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIrC;;;OAGG;IACG,KAAK,CAAC,GAAG,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAW5C;;;;OAIG;IACI,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,qBAAqB,CAAC,SAAS,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IASrF;;;;;;OAMG;IACG,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAWvE,2BAA2B;IACrB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAuB7B"}

package/dist/store/json.js

@@ -0,0 +1,174 @@
+import { atomicWrite, ensureDir, readText } from "../util/fs.js";
+import { deepClone } from "../util/deep.js";
+import { dirname } from "node:path";
+import { isExpired } from "./kv.js";
+/** 落盘合并窗口（毫秒） */
+const FLUSH_DELAY = 300;
+/** 文件格式版本，将来变更结构时用于迁移判断 */
+const FORMAT = 1;
+/** JSON 文件 KV 驱动 */
+export class JsonKvDriver {
+    /** 驱动 id */
+    id = "json";
+    /** 文件绝对路径 */
+    #file;
+    /** 数据表 */
+    #map = new Map();
+    /** 落盘定时器 */
+    #timer;
+    /** 是否有未落盘的改动 */
+    #dirty = false;
+    /** 正在进行的落盘，用于串行化避免两次写互相覆盖 */
+    #writing = Promise.resolve();
+    /** 是否已关闭 */
+    #closed = false;
+    /**
+     * @param file 数据文件绝对路径
+     */
+    constructor(file) {
+        this.#file = file;
+    }
+    /** 键数量 */
+    get size() {
+        return this.#map.size;
+    }
+    /**
+     * 载入数据
+     *
+     * 文件损坏时不抛错也不删除：改名为 `.corrupt-<时间戳>` 留证，然后从空库启动。
+     * 存储坏了让机器人起不来，比丢一点缓存严重得多。
+     */
+    async open() {
+        this.#closed = false;
+        await ensureDir(dirname(this.#file));
+        const text = await readText(this.#file);
+        if (text === undefined || text.trim() === "")
+            return;
+        try {
+            const parsed = JSON.parse(text);
+            const data = parsed.format === FORMAT ? parsed.data : undefined;
+            if (!data || typeof data !== "object")
+                throw new Error("结构不符");
+            this.#map = new Map(Object.entries(data));
+            // 载入时清掉过期键，避免它们一直占内存直到被访问
+            for (const [key, env] of [...this.#map])
+                if (isExpired(env))
+                    this.#map.delete(key);
+        }
+        catch (err) {
+            const backup = `${this.#file}.corrupt-${Date.now()}`;
+            await atomicWrite(backup, text).catch(() => undefined);
+            throw new Error(`KV 数据文件解析失败，已备份到 ${backup}：${err instanceof Error ? err.message : String(err)}`);
+        }
+    }
+    /** 落盘并停止后续写入 */
+    async close() {
+        this.#closed = true;
+        if (this.#timer) {
+            clearTimeout(this.#timer);
+            this.#timer = undefined;
+        }
+        await this.flush();
+    }
+    /**
+     * 读取
+     * @param key 完整键
+     * @returns 值信封副本
+     */
+    async get(key) {
+        const env = this.#map.get(key);
+        return env === undefined ? undefined : deepClone(env);
+    }
+    /**
+     * 写入
+     * @param key 完整键
+     * @param value 值信封
+     */
+    async set(key, value) {
+        this.#map.set(key, deepClone(value));
+        this.#schedule();
+    }
+    /**
+     * 删除
+     * @param key 完整键
+     */
+    async del(key) {
+        if (this.#map.delete(key))
+            this.#schedule();
+    }
+    /**
+     * 批量操作（只触发一次落盘）
+     * @param ops 操作列表
+     */
+    async batch(ops) {
+        let changed = false;
+        for (const op of ops) {
+            if (op.op === "set") {
+                this.#map.set(op.key, deepClone(op.value));
+                changed = true;
+            }
+            else if (this.#map.delete(op.key))
+                changed = true;
+        }
+        if (changed)
+            this.#schedule();
+    }
+    /**
+     * 按前缀扫描
+     * @param prefix 键前缀
+     * @returns 键值对迭代器
+     */
+    async *scan(prefix) {
+        for (const key of [...this.#map.keys()]) {
+            if (!key.startsWith(prefix))
+                continue;
+            const env = this.#map.get(key);
+            if (env === undefined)
+                continue;
+            yield [key, deepClone(env)];
+        }
+    }
+    /**
+     * 原生原子自增（同步读改写，单线程下天然原子）
+     * @param key 完整键
+     * @param by 增量
+     * @param expireAt 首次创建时的过期时间点
+     * @returns 自增后的值
+     */
+    async incr(key, by, expireAt) {
+        const env = this.#map.get(key);
+        const alive = env !== undefined && !isExpired(env);
+        const current = alive && typeof env.v === "number" ? env.v : 0;
+        const next = current + by;
+        const keep = alive ? env.e : expireAt;
+        this.#map.set(key, keep === undefined ? { v: next } : { v: next, e: keep });
+        this.#schedule();
+        return next;
+    }
+    /** 立即落盘（`close()` 与测试用） */
+    async flush() {
+        if (!this.#dirty)
+            return await this.#writing;
+        this.#dirty = false;
+        const snapshot = { format: FORMAT, data: Object.fromEntries(this.#map) };
+        // 串在上一次写之后：两次并发的 atomicWrite 会竞争同一个目标文件
+        this.#writing = this.#writing.then(async () => {
+            await atomicWrite(this.#file, JSON.stringify(snapshot));
+        });
+        await this.#writing;
+    }
+    /** 安排一次延迟落盘 */
+    #schedule() {
+        this.#dirty = true;
+        if (this.#closed || this.#timer)
+            return;
+        this.#timer = setTimeout(() => {
+            this.#timer = undefined;
+            void this.flush().catch(() => undefined);
+        }, FLUSH_DELAY);
+        // unref：等待落盘不该拖住进程退出，退出路径上有 close() 兜底
+        if (typeof this.#timer.unref === "function")
+            this.#timer.unref();
+    }
+}
+//# sourceMappingURL=json.js.map

package/dist/store/json.js.map

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

package/dist/store/kv.d.ts

@@ -0,0 +1,126 @@
+/**
+ * 模块职责：驱动之上的命名空间化 KV 视图（前缀隔离、TTL、原子自增、前缀遍历）
+ * 依赖方向：依赖 util/{duration,queue}、类型包；不认识任何具体驱动
+ * 生命周期：与驱动同寿；`Kv` 自身无需回收
+ * 注意事项：三条规则 ——
+ *
+ *          1) **过期为读时判定**，不用定时器扫描 —— 那会在低内存设备上白耗 CPU。读到过期键
+ *             即视为不存在并一并删除，遍历时同样机会式清理。
+ *          2) **`incr` 在驱动没有原生原子操作时退化为"按键串行的读改写"。** LevelDB 没有 INCR，
+ *             直接 `get` + `set` 会让同一秒内的并发消息相互覆盖、计数偏小。`KeyedQueue` 把同一个键
+ *             的操作排队，进程内语义正确；跨进程原子性不予承诺（单进程架构无此需要）。
+ *          3) **每个插件的键自带 `plugin:<name>:` 前缀**，插件之间不可能访问到对方的键 ——
+ *             隔离由前缀保证，不靠命名约定。
+ */
+import type { DurationLike, KvDriver, KvNamespace, KvSetOptions, StoredEnvelope } from "@yunzai-ng/types";
+import { KeyedQueue } from "../util/queue.js";
+/**
+ * 命名空间化的 KV 视图
+ *
+ * 由 `openKv()` 创建根视图，插件通过 `ctx.kv` 拿到 `plugin:<name>:` 子视图。
+ */
+export declare class Kv implements KvNamespace {
+    #private;
+    /** 本命名空间的键前缀 */
+    readonly prefix: string;
+    /**
+     * @param driver 底层驱动
+     * @param prefix 键前缀（含结尾分隔符，根视图为空串）
+     * @param queue 自增串行队列；派生子视图时必须沿用父级的队列，
+     *              否则同一个键在父子视图里会落到两条队列上，串行保证失效
+     */
+    constructor(driver: KvDriver, prefix?: string, queue?: KeyedQueue);
+    /**
+     * 读取
+     * @param key 命名空间内的键
+     * @returns 值；不存在或已过期时 undefined
+     */
+    get<T = unknown>(key: string): Promise<T | undefined>;
+    /**
+     * 读取，不存在时返回默认值
+     * @param key 命名空间内的键
+     * @param fallback 默认值
+     * @returns 值或默认值
+     */
+    getOr<T>(key: string, fallback: T): Promise<T>;
+    /**
+     * 写入
+     * @param key 命名空间内的键
+     * @param value 值，必须可 JSON 序列化
+     * @param opts 写入选项
+     */
+    set<T = unknown>(key: string, value: T, opts?: KvSetOptions): Promise<void>;
+    /**
+     * 删除
+     * @param key 命名空间内的键
+     */
+    del(key: string): Promise<void>;
+    /**
+     * 判断是否存在且未过期
+     * @param key 命名空间内的键
+     * @returns 是否存在
+     */
+    has(key: string): Promise<boolean>;
+    /**
+     * 原子自增
+     *
+     * 驱动提供原生 `incr` 就直接用；否则按键串行地读改写。
+     * @param key 命名空间内的键
+     * @param by 增量，默认 1
+     * @param opts 写入选项；`ttl` 只在键首次创建时生效（与 Redis 的 INCR 语义一致：
+     *             自增不会刷新过期时间，否则热点计数器永不过期）
+     * @returns 自增后的值
+     */
+    incr(key: string, by?: number, opts?: KvSetOptions): Promise<number>;
+    /**
+     * 读取剩余存活毫秒数
+     * @param key 命名空间内的键
+     * @returns 剩余毫秒；永不过期返回 Infinity；不存在或已过期返回 -1
+     */
+    ttl(key: string): Promise<number>;
+    /**
+     * 遍历键（不含命名空间前缀）
+     * @param prefix 命名空间内的额外前缀
+     * @returns 键的异步迭代器
+     */
+    keys(prefix?: string): AsyncIterableIterator<string>;
+    /**
+     * 遍历键值
+     * @param prefix 命名空间内的额外前缀
+     * @returns 键值对的异步迭代器
+     */
+    entries<T = unknown>(prefix?: string): AsyncIterableIterator<readonly [string, T]>;
+    /**
+     * 清空（可按前缀）
+     * @param prefix 命名空间内的额外前缀，省略则清空整个命名空间
+     * @returns 删除的键数量
+     */
+    clear(prefix?: string): Promise<number>;
+    /**
+     * 派生子命名空间
+     * @param name 子命名空间名
+     * @returns 新的 KV 视图，与父级共享驱动与自增队列
+     * @throws 当名字为空或含分隔符时（否则两个不同的子空间可能拼出同一个前缀）
+     */
+    sub(name: string): KvNamespace;
+}
+/**
+ * 判断信封是否已过期
+ * @param env 值信封
+ * @returns 是否过期
+ */
+export declare function isExpired(env: StoredEnvelope): boolean;
+/**
+ * 计算过期时间点
+ * @param ttl 存活时长
+ * @returns 毫秒时间戳；不过期时 undefined
+ */
+export declare function expiryOf(ttl: DurationLike | undefined): number | undefined;
+/**
+ * 组装值信封
+ * @param value 值
+ * @param ttl 存活时长
+ * @returns 值信封
+ */
+export declare function envelope(value: unknown, ttl?: DurationLike): StoredEnvelope;
+//# sourceMappingURL=kv.d.ts.map

package/dist/store/kv.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kv.d.ts","sourceRoot":"","sources":["../../src/store/kv.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,WAAW,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AAEzG,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAQ7C;;;;GAIG;AACH,qBAAa,EAAG,YAAW,WAAW;;IACpC,gBAAgB;IAChB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IAOvB;;;;;OAKG;gBACS,MAAM,EAAE,QAAQ,EAAE,MAAM,SAAK,EAAE,KAAK,aAAmB;IAMnE;;;;OAIG;IACG,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;IAY3D;;;;;OAKG;IACG,KAAK,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAKpD;;;;;OAKG;IACG,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAIjF;;;OAGG;IACG,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIrC;;;;OAIG;IACG,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAIxC;;;;;;;;;OASG;IACG,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,SAAI,EAAE,IAAI,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC;IAmBrE;;;;OAIG;IACG,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAOvC;;;;OAIG;IACI,IAAI,CAAC,MAAM,SAAK,GAAG,qBAAqB,CAAC,MAAM,CAAC;IAIvD;;;;OAIG;IACI,OAAO,CAAC,CAAC,GAAG,OAAO,EAAE,MAAM,SAAK,GAAG,qBAAqB,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IAkBrF;;;;OAIG;IACG,KAAK,CAAC,MAAM,SAAK,GAAG,OAAO,CAAC,MAAM,CAAC;IAQzC;;;;;OAKG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW;CA2B/B;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAEtD;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,YAAY,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAI1E;AAED;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,CAAC,EAAE,YAAY,GAAG,cAAc,CAG3E"}

package/dist/store/kv.js

@@ -0,0 +1,232 @@
+import { parseDuration } from "../util/duration.js";
+import { KeyedQueue } from "../util/queue.js";
+/** 命名空间分隔符 */
+const SEP = ":";
+/** 单次遍历中最多清理多少个过期键（有界，避免遍历大库时删除列表耗尽内存） */
+const SWEEP_LIMIT = 256;
+/**
+ * 命名空间化的 KV 视图
+ *
+ * 由 `openKv()` 创建根视图，插件通过 `ctx.kv` 拿到 `plugin:<name>:` 子视图。
+ */
+export class Kv {
+    /** 本命名空间的键前缀 */
+    prefix;
+    /** 底层驱动 */
+    #driver;
+    /** 自增串行队列，与同一驱动的所有视图共享 */
+    #queue;
+    /**
+     * @param driver 底层驱动
+     * @param prefix 键前缀（含结尾分隔符，根视图为空串）
+     * @param queue 自增串行队列；派生子视图时必须沿用父级的队列，
+     *              否则同一个键在父子视图里会落到两条队列上，串行保证失效
+     */
+    constructor(driver, prefix = "", queue = new KeyedQueue()) {
+        this.#driver = driver;
+        this.prefix = prefix;
+        this.#queue = queue;
+    }
+    /**
+     * 读取
+     * @param key 命名空间内的键
+     * @returns 值；不存在或已过期时 undefined
+     */
+    async get(key) {
+        const full = this.#full(key);
+        const env = await this.#driver.get(full);
+        if (env === undefined)
+            return undefined;
+        if (isExpired(env)) {
+            // 读到过期键即予删除：不删除则遍历与容量统计均会被无效数据污染
+            await this.#driver.del(full).catch(() => undefined);
+            return undefined;
+        }
+        return env.v;
+    }
+    /**
+     * 读取，不存在时返回默认值
+     * @param key 命名空间内的键
+     * @param fallback 默认值
+     * @returns 值或默认值
+     */
+    async getOr(key, fallback) {
+        const value = await this.get(key);
+        return value === undefined ? fallback : value;
+    }
+    /**
+     * 写入
+     * @param key 命名空间内的键
+     * @param value 值，必须可 JSON 序列化
+     * @param opts 写入选项
+     */
+    async set(key, value, opts) {
+        await this.#driver.set(this.#full(key), envelope(value, opts?.ttl));
+    }
+    /**
+     * 删除
+     * @param key 命名空间内的键
+     */
+    async del(key) {
+        await this.#driver.del(this.#full(key));
+    }
+    /**
+     * 判断是否存在且未过期
+     * @param key 命名空间内的键
+     * @returns 是否存在
+     */
+    async has(key) {
+        return (await this.get(key)) !== undefined;
+    }
+    /**
+     * 原子自增
+     *
+     * 驱动提供原生 `incr` 就直接用；否则按键串行地读改写。
+     * @param key 命名空间内的键
+     * @param by 增量，默认 1
+     * @param opts 写入选项；`ttl` 只在键首次创建时生效（与 Redis 的 INCR 语义一致：
+     *             自增不会刷新过期时间，否则热点计数器永不过期）
+     * @returns 自增后的值
+     */
+    async incr(key, by = 1, opts) {
+        const full = this.#full(key);
+        const expireAt = expiryOf(opts?.ttl);
+        if (this.#driver.incr)
+            return this.#driver.incr(full, by, expireAt);
+        return this.#queue.run(full, async () => {
+            const env = await this.#driver.get(full);
+            const alive = env !== undefined && !isExpired(env);
+            const current = alive && typeof env.v === "number" ? env.v : 0;
+            const next = current + by;
+            // 已存在的键保留原过期时间点，新建的键才套用传入的 ttl
+            const keep = alive ? env.e : expireAt;
+            await this.#driver.set(full, keep === undefined ? { v: next } : { v: next, e: keep });
+            return next;
+        });
+    }
+    /**
+     * 读取剩余存活毫秒数
+     * @param key 命名空间内的键
+     * @returns 剩余毫秒；永不过期返回 Infinity；不存在或已过期返回 -1
+     */
+    async ttl(key) {
+        const env = await this.#driver.get(this.#full(key));
+        if (env === undefined || isExpired(env))
+            return -1;
+        if (env.e === undefined)
+            return Number.POSITIVE_INFINITY;
+        return env.e - Date.now();
+    }
+    /**
+     * 遍历键（不含命名空间前缀）
+     * @param prefix 命名空间内的额外前缀
+     * @returns 键的异步迭代器
+     */
+    async *keys(prefix = "") {
+        for await (const [key] of this.entries(prefix))
+            yield key;
+    }
+    /**
+     * 遍历键值
+     * @param prefix 命名空间内的额外前缀
+     * @returns 键值对的异步迭代器
+     */
+    async *entries(prefix = "") {
+        const base = this.#full(prefix);
+        const expired = [];
+        try {
+            for await (const [full, env] of this.#driver.scan(base)) {
+                if (isExpired(env)) {
+                    if (expired.length < SWEEP_LIMIT)
+                        expired.push(full);
+                    continue;
+                }
+                yield [full.slice(this.prefix.length), env.v];
+            }
+        }
+        finally {
+            // 在迭代结束后再删：遍历过程中改动底层游标在部分驱动上是未定义行为。
+            // 提前 break 也会走到这里，已收集的过期键同样被清理。
+            if (expired.length > 0)
+                await this.#delMany(expired);
+        }
+    }
+    /**
+     * 清空（可按前缀）
+     * @param prefix 命名空间内的额外前缀，省略则清空整个命名空间
+     * @returns 删除的键数量
+     */
+    async clear(prefix = "") {
+        const base = this.#full(prefix);
+        const keys = [];
+        for await (const [full] of this.#driver.scan(base))
+            keys.push(full);
+        await this.#delMany(keys);
+        return keys.length;
+    }
+    /**
+     * 派生子命名空间
+     * @param name 子命名空间名
+     * @returns 新的 KV 视图，与父级共享驱动与自增队列
+     * @throws 当名字为空或含分隔符时（否则两个不同的子空间可能拼出同一个前缀）
+     */
+    sub(name) {
+        if (name === "")
+            throw new Error("子命名空间名不能为空");
+        if (name.includes(SEP))
+            throw new Error(`子命名空间名不能含 "${SEP}"：${name}`);
+        return new Kv(this.#driver, `${this.prefix}${name}${SEP}`, this.#queue);
+    }
+    /**
+     * 拼出完整键
+     * @param key 命名空间内的键
+     * @returns 完整键
+     */
+    #full(key) {
+        return `${this.prefix}${key}`;
+    }
+    /**
+     * 批量删除，能用 batch 就用 batch
+     * @param keys 完整键列表
+     */
+    async #delMany(keys) {
+        if (keys.length === 0)
+            return;
+        if (this.#driver.batch) {
+            await this.#driver.batch(keys.map(key => ({ op: "del", key })));
+            return;
+        }
+        for (const key of keys)
+            await this.#driver.del(key);
+    }
+}
+/**
+ * 判断信封是否已过期
+ * @param env 值信封
+ * @returns 是否过期
+ */
+export function isExpired(env) {
+    return env.e !== undefined && env.e <= Date.now();
+}
+/**
+ * 计算过期时间点
+ * @param ttl 存活时长
+ * @returns 毫秒时间戳；不过期时 undefined
+ */
+export function expiryOf(ttl) {
+    if (ttl === undefined)
+        return undefined;
+    const ms = parseDuration(ttl, 0);
+    return ms > 0 ? Date.now() + ms : undefined;
+}
+/**
+ * 组装值信封
+ * @param value 值
+ * @param ttl 存活时长
+ * @returns 值信封
+ */
+export function envelope(value, ttl) {
+    const e = expiryOf(ttl);
+    return e === undefined ? { v: value } : { v: value, e };
+}
+//# sourceMappingURL=kv.js.map

package/dist/store/kv.js.map

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