@yydb/light-db 0.0.15 → 0.0.16

package/dist/api/database.d.ts

@@ -1,6 +1,8 @@
-import { type WasmSession } from '@yydb/yydb-unknown-wasm32';
-import { type EmittableItem } from '@voml/vos';
-/** Schema 版本与文档。 */
+/**
+ * Schema 版本与文档。
+ *
+ * 共享类型：纯 TS {@link Database} 与 WASM {@link WasmDatabase} 都使用同一版本模型。
+ */
 export interface SchemaVersion {
     version: number;
     document: string;
@@ -32,73 +34,68 @@ export interface MigrateOptions {
         toField: string;
     }>;
 }
-/** 打开浏览器数据库的选项。 */
+/** 打开浏览器 WASM 数据库的选项。 */
 export interface OpenOptions {
     /** 使用内存 session（测试专用；默认使用 OPFS 持久 session）。 */
     memory?: boolean;
 }
-/** Transaction-local handle for callback-style transactions. */
-export declare class TransactionHandle {
-    private readonly session;
-    constructor(session: WasmSession);
-    private parseResult;
-    get(key: string): Promise<Uint8Array | null>;
-    put(key: string, value: Uint8Array | string): Promise<void>;
-    delete(key: string): Promise<void>;
-    scan(options?: ScanOptions): Promise<ScanRow[]>;
-    batch(changes: readonly BatchChange[]): Promise<void>;
-    compareExchange(key: string, expected: Uint8Array | string | null, replacement: Uint8Array | string | null): Promise<boolean>;
-    query<T = Record<string, unknown>>(source: string): Promise<T[]>;
-    execute(source: string): Promise<void>;
-}
+import type { CheckpointResult, StorageEngineStats } from '../core/engine.js';
+import type { LightDatabase, LightDatabaseOptions } from './types.js';
 /**
- * Browser/WASM 侧 YYDB 数据库句柄。
+ * 浏览器可用的纯 TS 数据库实现。
  *
- * 与 `@yydb/yydb` 的 {@link Database} 同名——宿主靠 import 来源区分：
+ * 与 Node 侧 `@yydb/yydb` 的 {@link Database} 同构：宿主靠 import 来源区分：
  *
  * ```ts
  * import { Database } from '@yydb/yydb';       // Node 原生
- * import { Database } from '@yydb/light-db';   // 浏览器 WASM
+ * import { Database } from '@yydb/light-db';   // 浏览器纯 TS（本文件）
  * ```
+ *
+ * 完全不依赖 WASM；OPFS 持久化、WAL 恢复、检查点、事务都在 TypeScript 内完成。
+ *
+ * 默认后端是 `OpfsStorageAdapterFactory`；通过 `options.storage` 可以显式指定。
  */
-export declare class Database {
-    /** 数据库名（OPFS 路径）。 */
+export declare class Database implements LightDatabase {
+    /** 数据库名 */
     readonly name: string;
-    private readonly session;
+    private readonly engine;
+    private readonly transaction;
     private constructor();
-    /** 初始化 WASM 并打开一个 session（memory 或 OPFS persistent）。 */
-    static open(name: string, options?: OpenOptions): Promise<Database>;
-    /** 解析 WASM JSON 结果，失败时转 LightDbError。 */
-    private parseResult;
-    /** 读取已持久化的 schema，或 `null`。 */
-    getSchema(): Promise<SchemaVersion | null>;
-    /** 声明 schema 文档。 */
-    ensureSchema(...input: [string] | EmittableItem[]): Promise<void>;
-    /** 读取键，或 `null`。 */
+    /**
+     * 打开数据库
+     * @param name 数据库名
+     * @param options 打开选项
+     */
+    static open(name: string, options?: LightDatabaseOptions): Promise<Database>;
+    /** 读取已持久化的 schema */
+    schema(): Promise<SchemaVersion | null>;
+    /**
+     * 声明 schema 文档
+     *
+     * 文档是唯一真相：首次写入后，重复调用必须传入完全相同的文档。
+     */
+    ensureSchema(document: string): Promise<void>;
+    /** 读取键 */
     get(key: string): Promise<Uint8Array | null>;
-    /** 写入键。 */
-    put(key: string, value: Uint8Array | string): Promise<void>;
-    /** 删除键。 */
-    delete(key: string): Promise<void>;
-    /** 扫描键值对。 */
-    scan(options?: ScanOptions): Promise<ScanRow[]>;
-    /** 原子批量写入/删除。 */
-    batch(changes: readonly BatchChange[]): Promise<void>;
-    /** Compare-and-swap。 */
-    compareExchange(key: string, expected: Uint8Array | string | null, replacement: Uint8Array | string | null): Promise<boolean>;
-    /** Callback-style 事务：自动 begin/commit，异常自动 rollback。 */
-    transaction<T>(fn: (tx: TransactionHandle) => Promise<T>): Promise<T>;
-    /** 执行 VOS read pipeline，返回 typed rows。 */
-    query<T = Record<string, unknown>>(source: string): Promise<T[]>;
-    /** 执行 VOS write program。 */
-    execute(source: string): Promise<void>;
-    /** 发布新 schema 版本。 */
-    migrateSchema(documentOrSource: string | EmittableItem, ...rest: (EmittableItem | MigrateOptions)[]): Promise<void>;
-    /** 执行检查点（折叠 WAL）。 */
-    checkpoint(): Promise<void>;
-    /** 关闭 session。 */
+    /** 写入键 */
+    put(key: string, value: Uint8Array): Promise<void>;
+    /** 删除键 */
+    delete(key: string): Promise<boolean>;
+    /** 开始事务 */
+    begin(): Promise<void>;
+    /** 提交事务 */
+    commit(): Promise<void>;
+    /** 回滚事务 */
+    rollback(): Promise<void>;
+    /** 执行检查点 */
+    checkpoint(): Promise<CheckpointResult>;
+    /** 统计信息 */
+    stats(): StorageEngineStats;
+    /** 关闭数据库 */
     close(): Promise<void>;
+    /**
+     * 校验用户键
+     */
+    private assertUserKey;
 }
-/** 打开浏览器数据库的便捷函数（等价于 {@link Database.open}）。 */
-export declare function openLightDatabase(name: string, options?: OpenOptions): Promise<Database>;
 //# sourceMappingURL=database.d.ts.map

package/dist/api/database.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"database.d.ts","sourceRoot":"","sources":["../../src/api/database.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"database.d.ts","sourceRoot":"","sources":["../../src/api/database.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CACpB;AAED,2BAA2B;AAC3B,MAAM,WAAW,OAAO;IACpB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,UAAU,CAAC;CACrB;AAED,wBAAwB;AACxB,MAAM,WAAW,WAAW;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,wBAAwB;AACxB,MAAM,WAAW,WAAW;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,UAAU,GAAG,MAAM,GAAG,IAAI,CAAC;CACrC;AAED,iCAAiC;AACjC,MAAM,WAAW,cAAc;IAC3B,OAAO,CAAC,EAAE,aAAa,CACjB;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GACpC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CACzD,CAAC;CACL;AAED,yBAAyB;AACzB,MAAM,WAAW,WAAW;IACxB,+CAA+C;IAC/C,MAAM,CAAC,EAAE,OAAO,CAAC;CACpB;AAOD,OAAO,KAAK,EAAE,gBAAgB,EAAwB,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAMpG,OAAO,KAAK,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAKtE;;;;;;;;;;;;;GAaG;AACH,qBAAa,QAAS,YAAW,aAAa;IAC1C,WAAW;IACX,SAAgB,IAAI,EAAE,MAAM,CAAC;IAE7B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgB;IACvC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAc;IAE1C,OAAO;IAMP;;;;OAIG;WACiB,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,oBAAyB,GAAG,OAAO,CAAC,QAAQ,CAAC;IAmB7F,qBAAqB;IACR,MAAM,IAAI,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAKpD;;;;OAIG;IACU,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAmB1D,UAAU;IACG,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IAIzD,UAAU;IACG,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAI/D,UAAU;IACG,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAIlD,WAAW;IACE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAInC,WAAW;IACE,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAIpC,WAAW;IACE,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAItC,YAAY;IACC,UAAU,IAAI,OAAO,CAAC,gBAAgB,CAAC;IAIpD,WAAW;IACJ,KAAK,IAAI,kBAAkB;IAIlC,YAAY;IACC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAOnC;;OAEG;IACH,OAAO,CAAC,aAAa;CAWxB"}

package/dist/api/database.js

@@ -1,228 +1,149 @@
-import { initWasm, openPersistentSession, createMemorySession, } from '@yydb/yydb-unknown-wasm32';
-import { emitSource } from '@voml/vos';
-import { LightDbError } from '../errors/index.js';
-/** Transaction-local handle for callback-style transactions. */
-export class TransactionHandle {
-    session;
-    constructor(session) {
-        this.session = session;
-    }
-    parseResult(raw) {
-        const parsed = JSON.parse(raw);
-        if (!parsed.ok) {
-            const err = LightDbError.fromDiagnosticJson(parsed.error);
-            throw err ?? new Error(typeof parsed.error === 'string' ? parsed.error : 'wasm error');
-        }
-        return parsed;
-    }
-    async get(key) {
-        const raw = JSON.parse(this.session.get(key));
-        if (!raw.ok)
-            throw new Error(raw.error);
-        if (raw.value === null || raw.value === undefined)
-            return null;
-        if (Array.isArray(raw.value))
-            return new Uint8Array(raw.value);
-        return new Uint8Array(raw.value);
-    }
-    async put(key, value) {
-        const bytes = typeof value === 'string' ? new TextEncoder().encode(value) : value;
-        this.parseResult(this.session.put(key, bytes));
-    }
-    async delete(key) {
-        this.parseResult(this.session.delete(key));
-    }
-    async scan(options = {}) {
-        const raw = JSON.parse(this.session.scanPrefix(options.prefix ?? '', options.after ?? null, options.limit ?? 1000));
-        if (!raw.ok)
-            throw new Error(raw.error);
-        return (raw.rows ?? []).map((r) => ({
-            key: r.key,
-            value: new Uint8Array(r.value),
-        }));
-    }
-    async batch(changes) {
-        const body = changes.map((c) => ({
-            key: c.key,
-            value: c.value === null ? null : typeof c.value === 'string' ? Array.from(new TextEncoder().encode(c.value)) : Array.from(c.value),
-        }));
-        this.parseResult(this.session.writeBatch(new TextEncoder().encode(JSON.stringify(body))));
-    }
-    async compareExchange(key, expected, replacement) {
-        const toBytes = (v) => v === null ? null : typeof v === 'string' ? new TextEncoder().encode(v) : v;
-        const raw = JSON.parse(this.session.compareExchange(key, toBytes(expected), toBytes(replacement)));
-        if (!raw.ok)
-            throw new Error(raw.error);
-        return raw.success ?? false;
-    }
-    async query(source) {
-        const raw = JSON.parse(this.session.queryVos(source));
-        if (!raw.ok)
-            throw new Error(raw.error);
-        return (raw.rows ?? []);
-    }
-    async execute(source) {
-        this.parseResult(this.session.executeVosWrite(source));
-    }
-}
+// ---------------------------------------------------------------------------
+// Pure-TS Database (StorageEngine wrapper — browser-friendly, no WASM)
+// ---------------------------------------------------------------------------
+import { StorageEngine } from '../core/engine.js';
+import { LightDbError, LightDbErrorCodes } from '../errors/index.js';
+import { isOpfsAvailable, OpfsStorageAdapterFactory } from '../storage/opfs/OpfsStorageAdapter.js';
+import { decodeSchema, encodeSchema, parseSchemaDocument, RESERVED_KEY_PREFIX, SCHEMA_KEY } from './schema.js';
+import { Transaction } from './transaction.js';
+/** 数据库名最大长度 */
+const MAX_DATABASE_NAME_LENGTH = 128;
 /**
- * Browser/WASM 侧 YYDB 数据库句柄。
+ * 浏览器可用的纯 TS 数据库实现。
  *
- * 与 `@yydb/yydb` 的 {@link Database} 同名——宿主靠 import 来源区分：
+ * 与 Node 侧 `@yydb/yydb` 的 {@link Database} 同构：宿主靠 import 来源区分：
  *
  * ```ts
  * import { Database } from '@yydb/yydb';       // Node 原生
- * import { Database } from '@yydb/light-db';   // 浏览器 WASM
+ * import { Database } from '@yydb/light-db';   // 浏览器纯 TS（本文件）
  * ```
+ *
+ * 完全不依赖 WASM；OPFS 持久化、WAL 恢复、检查点、事务都在 TypeScript 内完成。
+ *
+ * 默认后端是 `OpfsStorageAdapterFactory`；通过 `options.storage` 可以显式指定。
  */
 export class Database {
-    /** 数据库名（OPFS 路径）。 */
+    /** 数据库名 */
     name;
-    session;
-    constructor(name, session) {
+    engine;
+    transaction;
+    constructor(name, engine) {
         this.name = name;
-        this.session = session;
-    }
-    /** 初始化 WASM 并打开一个 session（memory 或 OPFS persistent）。 */
+        this.engine = engine;
+        this.transaction = new Transaction(engine);
+    }
+    /**
+     * 打开数据库
+     * @param name 数据库名
+     * @param options 打开选项
+     */
     static async open(name, options = {}) {
-        if (!name || name.length === 0) {
-            throw new Error('database name must not be empty');
+        if (name.trim().length === 0 || name.length > MAX_DATABASE_NAME_LENGTH) {
+            throw new LightDbError(LightDbErrorCodes.unsupported, `database name must be 1-${MAX_DATABASE_NAME_LENGTH} characters`, {
+                operation: 'open',
+            });
         }
-        await initWasm();
-        const session = options.memory
-            ? createMemorySession()
-            : openPersistentSession(name);
-        return new Database(name, session);
-    }
-    /** 解析 WASM JSON 结果，失败时转 LightDbError。 */
-    parseResult(raw) {
-        const parsed = JSON.parse(raw);
-        if (!parsed.ok) {
-            const err = LightDbError.fromDiagnosticJson(parsed.error);
-            throw err ?? new Error(typeof parsed.error === 'string' ? parsed.error : 'wasm error');
+        const storage = resolveStorageFactory(options);
+        const engineOptions = {};
+        if (options.pageSize !== undefined)
+            engineOptions.pageSize = options.pageSize;
+        if (options.walThreshold !== undefined)
+            engineOptions.walThreshold = options.walThreshold;
+        if (options.autoCheckpoint !== undefined)
+            engineOptions.autoCheckpoint = options.autoCheckpoint;
+        if (options.lease !== undefined)
+            engineOptions.lease = options.lease;
+        const engine = await StorageEngine.open(name, storage, engineOptions);
+        return new Database(name, engine);
+    }
+    /** 读取已持久化的 schema */
+    async schema() {
+        const value = await this.engine.get(SCHEMA_KEY);
+        return value ? decodeSchema(value) : null;
+    }
+    /**
+     * 声明 schema 文档
+     *
+     * 文档是唯一真相：首次写入后，重复调用必须传入完全相同的文档。
+     */
+    async ensureSchema(document) {
+        const version = parseSchemaDocument(document);
+        const existing = await this.schema();
+        if (existing) {
+            if (existing.document !== document) {
+                throw new LightDbError(LightDbErrorCodes.schemaConflict, `schema document conflict: stored version ${existing.version}, incoming version ${version}`, { operation: 'ensureSchema' });
+            }
+            return;
         }
-        return parsed;
+        await this.engine.put(SCHEMA_KEY, encodeSchema({ version, document }));
+        this.engine.notifySchemaChange();
     }
-    /** 读取已持久化的 schema，或 `null`。 */
-    async getSchema() {
-        const raw = this.parseResult(this.session.getSchema());
-        if (!raw.schema)
-            return null;
-        return raw.schema;
-    }
-    /** 声明 schema 文档。 */
-    async ensureSchema(...input) {
-        const document = typeof input[0] === 'string' ? input[0] : emitSource(input);
-        this.parseResult(this.session.ensureSchema(document));
-    }
-    /** 读取键，或 `null`。 */
+    /** 读取键 */
     async get(key) {
-        const raw = JSON.parse(this.session.get(key));
-        if (!raw.ok)
-            throw (LightDbError.fromDiagnosticJson(raw.error) ?? new Error(raw.error));
-        if (raw.value === null || raw.value === undefined)
-            return null;
-        if (Array.isArray(raw.value))
-            return new Uint8Array(raw.value);
-        return new Uint8Array(raw.value);
-    }
-    /** 写入键。 */
+        return this.engine.get(this.assertUserKey(key, 'kvGet'));
+    }
+    /** 写入键 */
     async put(key, value) {
-        const bytes = typeof value === 'string' ? new TextEncoder().encode(value) : value;
-        this.parseResult(this.session.put(key, bytes));
+        await this.engine.put(this.assertUserKey(key, 'kvPut'), value);
     }
-    /** 删除键。 */
+    /** 删除键 */
     async delete(key) {
-        this.parseResult(this.session.delete(key));
-    }
-    /** 扫描键值对。 */
-    async scan(options = {}) {
-        const raw = JSON.parse(this.session.scanPrefix(options.prefix ?? '', options.after ?? null, options.limit ?? 1000));
-        if (!raw.ok)
-            throw (LightDbError.fromDiagnosticJson(raw.error) ?? new Error(raw.error));
-        return (raw.rows ?? []).map((r) => ({
-            key: r.key,
-            value: new Uint8Array(r.value),
-        }));
-    }
-    /** 原子批量写入/删除。 */
-    async batch(changes) {
-        const body = changes.map((c) => ({
-            key: c.key,
-            value: c.value === null ? null : typeof c.value === 'string' ? Array.from(new TextEncoder().encode(c.value)) : Array.from(c.value),
-        }));
-        this.parseResult(this.session.writeBatch(new TextEncoder().encode(JSON.stringify(body))));
-    }
-    /** Compare-and-swap。 */
-    async compareExchange(key, expected, replacement) {
-        const toBytes = (v) => v === null ? null : typeof v === 'string' ? new TextEncoder().encode(v) : v;
-        const raw = JSON.parse(this.session.compareExchange(key, toBytes(expected), toBytes(replacement)));
-        if (!raw.ok)
-            throw (LightDbError.fromDiagnosticJson(raw.error) ?? new Error(raw.error));
-        return raw.success ?? false;
-    }
-    /** Callback-style 事务：自动 begin/commit，异常自动 rollback。 */
-    async transaction(fn) {
-        this.parseResult(this.session.begin());
-        const tx = new TransactionHandle(this.session);
-        try {
-            const result = await fn(tx);
-            this.parseResult(this.session.commit());
-            return result;
-        }
-        catch (err) {
-            try {
-                this.session.rollback();
-            }
-            catch {
-                // don't mask original
-            }
-            throw err;
-        }
+        return this.engine.delete(this.assertUserKey(key, 'kvDelete'));
     }
-    /** 执行 VOS read pipeline，返回 typed rows。 */
-    async query(source) {
-        const raw = JSON.parse(this.session.queryVos(source));
-        if (!raw.ok)
-            throw (LightDbError.fromDiagnosticJson(raw.error) ?? new Error(raw.error));
-        return (raw.rows ?? []);
-    }
-    /** 执行 VOS write program。 */
-    async execute(source) {
-        this.parseResult(this.session.executeVosWrite(source));
-    }
-    /** 发布新 schema 版本。 */
-    async migrateSchema(documentOrSource, ...rest) {
-        let document;
-        let options = {};
-        const all = [documentOrSource, ...rest];
-        const last = all[all.length - 1];
-        if (last && typeof last === 'object' &&
-            !('table' in last) &&
-            !('class' in last) &&
-            ('renames' in last || Object.keys(last).length === 0)) {
-            options = all.pop() ?? {};
-        }
-        if (typeof all[0] === 'string') {
-            document = all[0];
-        }
-        else {
-            document = emitSource(all);
-        }
-        const renamesJson = options.renames?.length ? JSON.stringify(options.renames) : null;
-        this.parseResult(this.session.migrateSchema(document, renamesJson));
+    /** 开始事务 */
+    async begin() {
+        await this.transaction.begin();
+    }
+    /** 提交事务 */
+    async commit() {
+        await this.transaction.commit();
+    }
+    /** 回滚事务 */
+    async rollback() {
+        await this.transaction.rollback();
     }
-    /** 执行检查点（折叠 WAL）。 */
+    /** 执行检查点 */
     async checkpoint() {
-        this.parseResult(this.session.checkpoint());
+        return this.engine.checkpoint();
     }
-    /** 关闭 session。 */
+    /** 统计信息 */
+    stats() {
+        return this.engine.getStats();
+    }
+    /** 关闭数据库 */
     async close() {
-        this.session.close();
+        if (this.transaction.isActive) {
+            await this.transaction.rollback();
+        }
+        await this.engine.close();
+    }
+    /**
+     * 校验用户键
+     */
+    assertUserKey(key, operation) {
+        if (key.length === 0) {
+            throw new LightDbError(LightDbErrorCodes.unsupported, 'key must not be empty', { operation });
+        }
+        if (key.startsWith(RESERVED_KEY_PREFIX)) {
+            throw new LightDbError(LightDbErrorCodes.unsupported, `key prefix "${RESERVED_KEY_PREFIX}" is reserved for the database`, {
+                operation,
+            });
+        }
+        return key;
     }
 }
-/** 打开浏览器数据库的便捷函数（等价于 {@link Database.open}）。 */
-export async function openLightDatabase(name, options = {}) {
-    return Database.open(name, options);
+/**
+ * 解析存储后端
+ */
+function resolveStorageFactory(options) {
+    if (options.storage) {
+        return options.storage;
+    }
+    if (!isOpfsAvailable()) {
+        throw new LightDbError(LightDbErrorCodes.unsupported, 'OPFS is unavailable, pass an explicit storage adapter', {
+            operation: 'open',
+        });
+    }
+    return new OpfsStorageAdapterFactory();
 }
 //# sourceMappingURL=database.js.map

package/dist/api/database.js.map

@@ -1 +1 @@
-{"version":3,"file":"database.js","sourceRoot":"","sources":["../../src/api/database.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,QAAQ,EACR,qBAAqB,EACrB,mBAAmB,GAEtB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,UAAU,EAAsB,MAAM,WAAW,CAAC;AAC3D,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAoDlD,gEAAgE;AAChE,MAAM,OAAO,iBAAiB;IACG;IAA7B,YAA6B,OAAoB;QAApB,YAAO,GAAP,OAAO,CAAa;IAAG,CAAC;IAE7C,WAAW,CAAI,GAAW;QAC9B,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAe,CAAC;QAC7C,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;YACb,MAAM,GAAG,GAAG,YAAY,CAAC,kBAAkB,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAC1D,MAAM,GAAG,IAAI,IAAI,KAAK,CAAC,OAAO,MAAM,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC;QAC3F,CAAC;QACD,OAAO,MAAW,CAAC;IACvB,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,GAAW;QACjB,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAe,CAAC;QAC5D,IAAI,CAAC,GAAG,CAAC,EAAE;YAAE,MAAM,IAAI,KAAK,CAAC,GAAG,CAAC,KAAe,CAAC,CAAC;QAClD,IAAI,GAAG,CAAC,KAAK,KAAK,IAAI,IAAI,GAAG,CAAC,KAAK,KAAK,SAAS;YAAE,OAAO,IAAI,CAAC;QAC/D,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC;YAAE,OAAO,IAAI,UAAU,CAAC,GAAG,CAAC,KAAiB,CAAC,CAAC;QAC3E,OAAO,IAAI,UAAU,CAAC,GAAG,CAAC,KAA0B,CAAC,CAAC;IAC1D,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,GAAW,EAAE,KAA0B;QAC7C,MAAM,KAAK,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;QAClF,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC;IACnD,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,GAAW;QACpB,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;IAC/C,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,UAAuB,EAAE;QAChC,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,MAAM,IAAI,EAAE,EAAE,OAAO,CAAC,KAAK,IAAI,IAAI,EAAE,OAAO,CAAC,KAAK,IAAI,IAAI,CAAC,CAAe,CAAC;QAClI,IAAI,CAAC,GAAG,CAAC,EAAE;YAAE,MAAM,IAAI,KAAK,CAAC,GAAG,CAAC,KAAe,CAAC,CAAC;QAClD,OAAO,CAAC,GAAG,CAAC,IAA0C,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACtE,GAAG,EAAE,CAAC,CAAC,GAAG;YACV,KAAK,EAAE,IAAI,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC;SACjC,CAAC,CAAC,CAAC;IACR,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,OAA+B;QACvC,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAC7B,GAAG,EAAE,CAAC,CAAC,GAAG;YACV,KAAK,EAAE,CAAC,CAAC,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC;SACrI,CAAC,CAAC,CAAC;QACJ,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9F,CAAC;IAED,KAAK,CAAC,eAAe,CACjB,GAAW,EAAE,QAAoC,EAAE,WAAuC;QAE1F,MAAM,OAAO,GAAG,CAAC,CAA6B,EAAqB,EAAE,CACjE,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAChF,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC,GAAG,EAAE,OAAO,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC,CAAe,CAAC;QACjH,IAAI,CAAC,GAAG,CAAC,EAAE;YAAE,MAAM,IAAI,KAAK,CAAC,GAAG,CAAC,KAAe,CAAC,CAAC;QAClD,OAAO,GAAG,CAAC,OAAO,IAAI,KAAK,CAAC;IAChC,CAAC;IAED,KAAK,CAAC,KAAK,CAA8B,MAAc;QACnD,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAe,CAAC;QACpE,IAAI,CAAC,GAAG,CAAC,EAAE;YAAE,MAAM,IAAI,KAAK,CAAC,GAAG,CAAC,KAAe,CAAC,CAAC;QAClD,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE,CAAQ,CAAC;IACnC,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,MAAc;QACxB,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC;IAC3D,CAAC;CACJ;AAED;;;;;;;;;GASG;AACH,MAAM,OAAO,QAAQ;IACjB,qBAAqB;IACL,IAAI,CAAS;IAEZ,OAAO,CAAc;IAEtC,YAAoB,IAAY,EAAE,OAAoB;QAClD,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IAC3B,CAAC;IAED,wDAAwD;IACjD,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,IAAY,EAAE,UAAuB,EAAE;QAC5D,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC7B,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;QACvD,CAAC;QAED,MAAM,QAAQ,EAAE,CAAC;QAEjB,MAAM,OAAO,GAAgB,OAAO,CAAC,MAAM;YACvC,CAAC,CAAC,mBAAmB,EAAE;YACvB,CAAC,CAAC,qBAAqB,CAAC,IAAI,CAAC,CAAC;QAElC,OAAO,IAAI,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACvC,CAAC;IAED,yCAAyC;IACjC,WAAW,CAAI,GAAW;QAC9B,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAe,CAAC;QAC7C,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;YACb,MAAM,GAAG,GAAG,YAAY,CAAC,kBAAkB,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAC1D,MAAM,GAAG,IAAI,IAAI,KAAK,CAAC,OAAO,MAAM,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC;QAC3F,CAAC;QACD,OAAO,MAAW,CAAC;IACvB,CAAC;IAED,+BAA+B;IACxB,KAAK,CAAC,SAAS;QAClB,MAAM,GAAG,GAAG,IAAI,CAAC,WAAW,CAAa,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;QACnE,IAAI,CAAC,GAAG,CAAC,MAAM;YAAE,OAAO,IAAI,CAAC;QAC7B,OAAO,GAAG,CAAC,MAAM,CAAC;IACtB,CAAC;IAED,oBAAoB;IACb,KAAK,CAAC,YAAY,CAAC,GAAG,KAAiC;QAC1D,MAAM,QAAQ,GAAG,OAAO,KAAK,CAAC,CAAC,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,KAAwB,CAAC,CAAC;QAChG,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC1D,CAAC;IAED,oBAAoB;IACb,KAAK,CAAC,GAAG,CAAC,GAAW;QACxB,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAe,CAAC;QAC5D,IAAI,CAAC,GAAG,CAAC,EAAE;YAAE,MAAM,CAAC,YAAY,CAAC,kBAAkB,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,GAAG,CAAC,KAAe,CAAC,CAAC,CAAC;QAClG,IAAI,GAAG,CAAC,KAAK,KAAK,IAAI,IAAI,GAAG,CAAC,KAAK,KAAK,SAAS;YAAE,OAAO,IAAI,CAAC;QAC/D,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC;YAAE,OAAO,IAAI,UAAU,CAAC,GAAG,CAAC,KAAiB,CAAC,CAAC;QAC3E,OAAO,IAAI,UAAU,CAAC,GAAG,CAAC,KAA0B,CAAC,CAAC;IAC1D,CAAC;IAED,WAAW;IACJ,KAAK,CAAC,GAAG,CAAC,GAAW,EAAE,KAA0B;QACpD,MAAM,KAAK,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;QAClF,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC;IACnD,CAAC;IAED,WAAW;IACJ,KAAK,CAAC,MAAM,CAAC,GAAW;QAC3B,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;IAC/C,CAAC;IAED,aAAa;IACN,KAAK,CAAC,IAAI,CAAC,UAAuB,EAAE;QACvC,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAC1C,OAAO,CAAC,MAAM,IAAI,EAAE,EACpB,OAAO,CAAC,KAAK,IAAI,IAAI,EACrB,OAAO,CAAC,KAAK,IAAI,IAAI,CACxB,CAAe,CAAC;QACjB,IAAI,CAAC,GAAG,CAAC,EAAE;YAAE,MAAM,CAAC,YAAY,CAAC,kBAAkB,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,GAAG,CAAC,KAAe,CAAC,CAAC,CAAC;QAClG,OAAO,CAAC,GAAG,CAAC,IAA0C,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACtE,GAAG,EAAE,CAAC,CAAC,GAAG;YACV,KAAK,EAAE,IAAI,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC;SACjC,CAAC,CAAC,CAAC;IACR,CAAC;IAED,iBAAiB;IACV,KAAK,CAAC,KAAK,CAAC,OAA+B;QAC9C,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAC7B,GAAG,EAAE,CAAC,CAAC,GAAG;YACV,KAAK,EAAE,CAAC,CAAC,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC;SACrI,CAAC,CAAC,CAAC;QACJ,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9F,CAAC;IAED,wBAAwB;IACjB,KAAK,CAAC,eAAe,CACxB,GAAW,EAAE,QAAoC,EAAE,WAAuC;QAE1F,MAAM,OAAO,GAAG,CAAC,CAA6B,EAAqB,EAAE,CACjE,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAChF,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC,GAAG,EAAE,OAAO,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC,CAAe,CAAC;QACjH,IAAI,CAAC,GAAG,CAAC,EAAE;YAAE,MAAM,CAAC,YAAY,CAAC,kBAAkB,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,GAAG,CAAC,KAAe,CAAC,CAAC,CAAC;QAClG,OAAO,GAAG,CAAC,OAAO,IAAI,KAAK,CAAC;IAChC,CAAC;IAED,uDAAuD;IAChD,KAAK,CAAC,WAAW,CAAI,EAAyC;QACjE,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;QACvC,MAAM,EAAE,GAAG,IAAI,iBAAiB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC/C,IAAI,CAAC;YACD,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC;YAC5B,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;YACxC,OAAO,MAAM,CAAC;QAClB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACX,IAAI,CAAC;gBACD,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;YAC5B,CAAC;YAAC,MAAM,CAAC;gBACL,sBAAsB;YAC1B,CAAC;YACD,MAAM,GAAG,CAAC;QACd,CAAC;IACL,CAAC;IAED,0CAA0C;IACnC,KAAK,CAAC,KAAK,CAA8B,MAAc;QAC1D,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAe,CAAC;QACpE,IAAI,CAAC,GAAG,CAAC,EAAE;YAAE,MAAM,CAAC,YAAY,CAAC,kBAAkB,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,GAAG,CAAC,KAAe,CAAC,CAAC,CAAC;QAClG,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE,CAAQ,CAAC;IACnC,CAAC;IAED,4BAA4B;IACrB,KAAK,CAAC,OAAO,CAAC,MAAc;QAC/B,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC;IAC3D,CAAC;IAED,qBAAqB;IACd,KAAK,CAAC,aAAa,CACtB,gBAAwC,EACxC,GAAG,IAAwC;QAE3C,IAAI,QAAgB,CAAC;QACrB,IAAI,OAAO,GAAmB,EAAE,CAAC;QACjC,MAAM,GAAG,GAAG,CAAC,gBAAgB,EAAE,GAAG,IAAI,CAAC,CAAC;QACxC,MAAM,IAAI,GAAG,GAAG,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QACjC,IACI,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ;YAChC,CAAC,CAAC,OAAO,IAAK,IAAgC,CAAC;YAC/C,CAAC,CAAC,OAAO,IAAK,IAAgC,CAAC;YAC/C,CAAC,SAAS,IAAK,IAAgC,IAAI,MAAM,CAAC,IAAI,CAAC,IAAc,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,EAC9F,CAAC;YACC,OAAO,GAAI,GAAG,CAAC,GAAG,EAAqB,IAAI,EAAE,CAAC;QAClD,CAAC;QACD,IAAI,OAAO,GAAG,CAAC,CAAC,CAAC,KAAK,QAAQ,EAAE,CAAC;YAC7B,QAAQ,GAAG,GAAG,CAAC,CAAC,CAAW,CAAC;QAChC,CAAC;aAAM,CAAC;YACJ,QAAQ,GAAG,UAAU,CAAC,GAAsB,CAAC,CAAC;QAClD,CAAC;QACD,MAAM,WAAW,GAAG,OAAO,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QACrF,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC,CAAC;IACxE,CAAC;IAED,qBAAqB;IACd,KAAK,CAAC,UAAU;QACnB,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;IAChD,CAAC;IAED,kBAAkB;IACX,KAAK,CAAC,KAAK;QACd,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;IACzB,CAAC;CACJ;AAED,gDAAgD;AAChD,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACnC,IAAY,EACZ,UAAuB,EAAE;IAEzB,OAAO,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AACxC,CAAC"}
+{"version":3,"file":"database.js","sourceRoot":"","sources":["../../src/api/database.ts"],"names":[],"mappings":"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"}

package/dist/api/index.d.ts

@@ -1,10 +1,14 @@
 /**
  * api 层导出
+ *
+ * 主线是 {@link Database}（纯 TS，无 WASM 依赖，与 Node 侧 `@yydb/yydb` 同构）。
+ * 需要 WASM 可选后端的宿主显式从 `./wasm-database` 引入 {@link WasmDatabase}。
  */
-export { Database, openLightDatabase } from './database';
-export type { OpenOptions, ScanRow, ScanOptions, BatchChange, MigrateOptions } from './database';
+export { Database } from './database';
+export type { OpenOptions, ScanRow, ScanOptions, BatchChange, MigrateOptions, SchemaVersion } from './database';
+export { WasmDatabase, TransactionHandle, openLightDatabase } from './wasm-database';
 export { Transaction } from './transaction';
 export type { TransactionState } from './transaction';
 export { SCHEMA_KEY, RESERVED_KEY_PREFIX, documentVersion, parseSchemaDocument, encodeSchema, decodeSchema } from './schema';
-export type { LightDatabase, LightDatabaseOptions, SchemaVersion } from './types';
+export type { LightDatabase, LightDatabaseOptions } from './types';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/api/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,QAAQ,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AACzD,YAAY,EAAE,WAAW,EAAE,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACjG,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,YAAY,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,mBAAmB,EAAE,eAAe,EAAE,mBAAmB,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAC7H,YAAY,EAAE,aAAa,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/api/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,YAAY,EAAE,WAAW,EAAE,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhH,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAErF,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,YAAY,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,mBAAmB,EAAE,eAAe,EAAE,mBAAmB,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAC7H,YAAY,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC"}

package/dist/api/index.js

@@ -1,7 +1,11 @@
 /**
  * api 层导出
+ *
+ * 主线是 {@link Database}（纯 TS，无 WASM 依赖，与 Node 侧 `@yydb/yydb` 同构）。
+ * 需要 WASM 可选后端的宿主显式从 `./wasm-database` 引入 {@link WasmDatabase}。
  */
-export { Database, openLightDatabase } from './database';
+export { Database } from './database';
+export { WasmDatabase, TransactionHandle, openLightDatabase } from './wasm-database';
 export { Transaction } from './transaction';
 export { SCHEMA_KEY, RESERVED_KEY_PREFIX, documentVersion, parseSchemaDocument, encodeSchema, decodeSchema } from './schema';
 //# sourceMappingURL=index.js.map

package/dist/api/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/api/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,QAAQ,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEzD,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE5C,OAAO,EAAE,UAAU,EAAE,mBAAmB,EAAE,eAAe,EAAE,mBAAmB,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/api/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAGtC,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAErF,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE5C,OAAO,EAAE,UAAU,EAAE,mBAAmB,EAAE,eAAe,EAAE,mBAAmB,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC"}

package/dist/api/wasm-database.d.ts

@@ -0,0 +1,64 @@
+import { type WasmSession } from '@yydb/yydb-unknown-wasm32';
+import { type EmittableItem } from '@voml/vos';
+import type { BatchChange, MigrateOptions, OpenOptions, ScanOptions, ScanRow, SchemaVersion } from './database.js';
+/** Transaction-local handle for callback-style transactions. */
+export declare class TransactionHandle {
+    private readonly session;
+    constructor(session: WasmSession);
+    private parseResult;
+    get(key: string): Promise<Uint8Array | null>;
+    put(key: string, value: Uint8Array | string): Promise<void>;
+    delete(key: string): Promise<void>;
+    scan(options?: ScanOptions): Promise<ScanRow[]>;
+    batch(changes: readonly BatchChange[]): Promise<void>;
+    compareExchange(key: string, expected: Uint8Array | string | null, replacement: Uint8Array | string | null): Promise<boolean>;
+    query<T = Record<string, unknown>>(source: string): Promise<T[]>;
+    execute(source: string): Promise<void>;
+}
+/**
+ * Browser/WASM 侧 YYDB 数据库句柄（可选后端）。
+ *
+ * 这是 `@yydb/light-db` 的 WASM 路径。默认可选——包主线是 {@link Database}
+ * （`api/database.ts`，纯 TS，无 WASM 依赖），宿主按需显式 import 本文件以引入 WASM。
+ */
+export declare class WasmDatabase {
+    /** 数据库名（OPFS 路径）。 */
+    readonly name: string;
+    private readonly session;
+    private constructor();
+    /** 初始化 WASM 并打开一个 session（memory 或 OPFS persistent）。 */
+    static open(name: string, options?: OpenOptions): Promise<WasmDatabase>;
+    /** 解析 WASM JSON 结果，失败时转 LightDbError。 */
+    private parseResult;
+    /** 读取已持久化的 schema，或 `null`。 */
+    getSchema(): Promise<SchemaVersion | null>;
+    /** 声明 schema 文档。 */
+    ensureSchema(...input: [string] | EmittableItem[]): Promise<void>;
+    /** 读取键，或 `null`。 */
+    get(key: string): Promise<Uint8Array | null>;
+    /** 写入键。 */
+    put(key: string, value: Uint8Array | string): Promise<void>;
+    /** 删除键。 */
+    delete(key: string): Promise<void>;
+    /** 扫描键值对。 */
+    scan(options?: ScanOptions): Promise<ScanRow[]>;
+    /** 原子批量写入/删除。 */
+    batch(changes: readonly BatchChange[]): Promise<void>;
+    /** Compare-and-swap。 */
+    compareExchange(key: string, expected: Uint8Array | string | null, replacement: Uint8Array | string | null): Promise<boolean>;
+    /** Callback-style 事务：自动 begin/commit，异常自动 rollback。 */
+    transaction<T>(fn: (tx: TransactionHandle) => Promise<T>): Promise<T>;
+    /** 执行 VOS read pipeline，返回 typed rows。 */
+    query<T = Record<string, unknown>>(source: string): Promise<T[]>;
+    /** 执行 VOS write program。 */
+    execute(source: string): Promise<void>;
+    /** 发布新 schema 版本。 */
+    migrateSchema(documentOrSource: string | EmittableItem, ...rest: (EmittableItem | MigrateOptions)[]): Promise<void>;
+    /** 执行检查点（折叠 WAL）。 */
+    checkpoint(): Promise<void>;
+    /** 关闭 session。 */
+    close(): Promise<void>;
+}
+/** 打开浏览器 WASM 数据库的便捷函数（等价于 {@link WasmDatabase.open}）。 */
+export declare function openLightDatabase(name: string, options?: OpenOptions): Promise<WasmDatabase>;
+//# sourceMappingURL=wasm-database.d.ts.map

package/dist/api/wasm-database.d.ts.map

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

package/dist/api/wasm-database.js

@@ -0,0 +1,224 @@
+import { initWasm, openPersistentSession, createMemorySession, } from '@yydb/yydb-unknown-wasm32';
+import { emitSource } from '@voml/vos';
+import { LightDbError } from '../errors/index.js';
+/** Transaction-local handle for callback-style transactions. */
+export class TransactionHandle {
+    session;
+    constructor(session) {
+        this.session = session;
+    }
+    parseResult(raw) {
+        const parsed = JSON.parse(raw);
+        if (!parsed.ok) {
+            const err = LightDbError.fromDiagnosticJson(parsed.error);
+            throw err ?? new Error(typeof parsed.error === 'string' ? parsed.error : 'wasm error');
+        }
+        return parsed;
+    }
+    async get(key) {
+        const raw = JSON.parse(this.session.get(key));
+        if (!raw.ok)
+            throw new Error(raw.error);
+        if (raw.value === null || raw.value === undefined)
+            return null;
+        if (Array.isArray(raw.value))
+            return new Uint8Array(raw.value);
+        return new Uint8Array(raw.value);
+    }
+    async put(key, value) {
+        const bytes = typeof value === 'string' ? new TextEncoder().encode(value) : value;
+        this.parseResult(this.session.put(key, bytes));
+    }
+    async delete(key) {
+        this.parseResult(this.session.delete(key));
+    }
+    async scan(options = {}) {
+        const raw = JSON.parse(this.session.scanPrefix(options.prefix ?? '', options.after ?? null, options.limit ?? 1000));
+        if (!raw.ok)
+            throw new Error(raw.error);
+        return (raw.rows ?? []).map((r) => ({
+            key: r.key,
+            value: new Uint8Array(r.value),
+        }));
+    }
+    async batch(changes) {
+        const body = changes.map((c) => ({
+            key: c.key,
+            value: c.value === null ? null : typeof c.value === 'string' ? Array.from(new TextEncoder().encode(c.value)) : Array.from(c.value),
+        }));
+        this.parseResult(this.session.writeBatch(new TextEncoder().encode(JSON.stringify(body))));
+    }
+    async compareExchange(key, expected, replacement) {
+        const toBytes = (v) => v === null ? null : typeof v === 'string' ? new TextEncoder().encode(v) : v;
+        const raw = JSON.parse(this.session.compareExchange(key, toBytes(expected), toBytes(replacement)));
+        if (!raw.ok)
+            throw new Error(raw.error);
+        return raw.success ?? false;
+    }
+    async query(source) {
+        const raw = JSON.parse(this.session.queryVos(source));
+        if (!raw.ok)
+            throw new Error(raw.error);
+        return (raw.rows ?? []);
+    }
+    async execute(source) {
+        this.parseResult(this.session.executeVosWrite(source));
+    }
+}
+/**
+ * Browser/WASM 侧 YYDB 数据库句柄（可选后端）。
+ *
+ * 这是 `@yydb/light-db` 的 WASM 路径。默认可选——包主线是 {@link Database}
+ * （`api/database.ts`，纯 TS，无 WASM 依赖），宿主按需显式 import 本文件以引入 WASM。
+ */
+export class WasmDatabase {
+    /** 数据库名（OPFS 路径）。 */
+    name;
+    session;
+    constructor(name, session) {
+        this.name = name;
+        this.session = session;
+    }
+    /** 初始化 WASM 并打开一个 session（memory 或 OPFS persistent）。 */
+    static async open(name, options = {}) {
+        if (!name || name.length === 0) {
+            throw new Error('database name must not be empty');
+        }
+        await initWasm();
+        const session = options.memory
+            ? createMemorySession()
+            : openPersistentSession(name);
+        return new WasmDatabase(name, session);
+    }
+    /** 解析 WASM JSON 结果，失败时转 LightDbError。 */
+    parseResult(raw) {
+        const parsed = JSON.parse(raw);
+        if (!parsed.ok) {
+            const err = LightDbError.fromDiagnosticJson(parsed.error);
+            throw err ?? new Error(typeof parsed.error === 'string' ? parsed.error : 'wasm error');
+        }
+        return parsed;
+    }
+    /** 读取已持久化的 schema，或 `null`。 */
+    async getSchema() {
+        const raw = this.parseResult(this.session.getSchema());
+        if (!raw.schema)
+            return null;
+        return raw.schema;
+    }
+    /** 声明 schema 文档。 */
+    async ensureSchema(...input) {
+        const document = typeof input[0] === 'string' ? input[0] : emitSource(input);
+        this.parseResult(this.session.ensureSchema(document));
+    }
+    /** 读取键，或 `null`。 */
+    async get(key) {
+        const raw = JSON.parse(this.session.get(key));
+        if (!raw.ok)
+            throw (LightDbError.fromDiagnosticJson(raw.error) ?? new Error(raw.error));
+        if (raw.value === null || raw.value === undefined)
+            return null;
+        if (Array.isArray(raw.value))
+            return new Uint8Array(raw.value);
+        return new Uint8Array(raw.value);
+    }
+    /** 写入键。 */
+    async put(key, value) {
+        const bytes = typeof value === 'string' ? new TextEncoder().encode(value) : value;
+        this.parseResult(this.session.put(key, bytes));
+    }
+    /** 删除键。 */
+    async delete(key) {
+        this.parseResult(this.session.delete(key));
+    }
+    /** 扫描键值对。 */
+    async scan(options = {}) {
+        const raw = JSON.parse(this.session.scanPrefix(options.prefix ?? '', options.after ?? null, options.limit ?? 1000));
+        if (!raw.ok)
+            throw (LightDbError.fromDiagnosticJson(raw.error) ?? new Error(raw.error));
+        return (raw.rows ?? []).map((r) => ({
+            key: r.key,
+            value: new Uint8Array(r.value),
+        }));
+    }
+    /** 原子批量写入/删除。 */
+    async batch(changes) {
+        const body = changes.map((c) => ({
+            key: c.key,
+            value: c.value === null ? null : typeof c.value === 'string' ? Array.from(new TextEncoder().encode(c.value)) : Array.from(c.value),
+        }));
+        this.parseResult(this.session.writeBatch(new TextEncoder().encode(JSON.stringify(body))));
+    }
+    /** Compare-and-swap。 */
+    async compareExchange(key, expected, replacement) {
+        const toBytes = (v) => v === null ? null : typeof v === 'string' ? new TextEncoder().encode(v) : v;
+        const raw = JSON.parse(this.session.compareExchange(key, toBytes(expected), toBytes(replacement)));
+        if (!raw.ok)
+            throw (LightDbError.fromDiagnosticJson(raw.error) ?? new Error(raw.error));
+        return raw.success ?? false;
+    }
+    /** Callback-style 事务：自动 begin/commit，异常自动 rollback。 */
+    async transaction(fn) {
+        this.parseResult(this.session.begin());
+        const tx = new TransactionHandle(this.session);
+        try {
+            const result = await fn(tx);
+            this.parseResult(this.session.commit());
+            return result;
+        }
+        catch (err) {
+            try {
+                this.session.rollback();
+            }
+            catch {
+                // don't mask original
+            }
+            throw err;
+        }
+    }
+    /** 执行 VOS read pipeline，返回 typed rows。 */
+    async query(source) {
+        const raw = JSON.parse(this.session.queryVos(source));
+        if (!raw.ok)
+            throw (LightDbError.fromDiagnosticJson(raw.error) ?? new Error(raw.error));
+        return (raw.rows ?? []);
+    }
+    /** 执行 VOS write program。 */
+    async execute(source) {
+        this.parseResult(this.session.executeVosWrite(source));
+    }
+    /** 发布新 schema 版本。 */
+    async migrateSchema(documentOrSource, ...rest) {
+        let document;
+        let options = {};
+        const all = [documentOrSource, ...rest];
+        const last = all[all.length - 1];
+        if (last && typeof last === 'object' &&
+            !('table' in last) &&
+            !('class' in last) &&
+            ('renames' in last || Object.keys(last).length === 0)) {
+            options = all.pop() ?? {};
+        }
+        if (typeof all[0] === 'string') {
+            document = all[0];
+        }
+        else {
+            document = emitSource(all);
+        }
+        const renamesJson = options.renames?.length ? JSON.stringify(options.renames) : null;
+        this.parseResult(this.session.migrateSchema(document, renamesJson));
+    }
+    /** 执行检查点（折叠 WAL）。 */
+    async checkpoint() {
+        this.parseResult(this.session.checkpoint());
+    }
+    /** 关闭 session。 */
+    async close() {
+        this.session.close();
+    }
+}
+/** 打开浏览器 WASM 数据库的便捷函数（等价于 {@link WasmDatabase.open}）。 */
+export async function openLightDatabase(name, options = {}) {
+    return WasmDatabase.open(name, options);
+}
+//# sourceMappingURL=wasm-database.js.map

package/dist/api/wasm-database.js.map

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

package/dist/index.d.ts

@@ -14,6 +14,6 @@ export { STORAGE_FILES, MemoryStorageAdapter, MemoryStorageBackend, OpfsStorageA
 export type { StorageAdapter, StorageAdapterFactory, StorageAdapterKind, StorageFile, StorageHandle, StorageOpenMode } from './storage';
 export { StorageEngine, DEFAULT_WAL_THRESHOLD, acquireWriterLease, listenDatabaseEvents } from './core';
 export type { CheckpointResult, LeaseMode, RecoveryOutcome, StorageEngineOptions, StorageEngineStats, TransactionState, DatabaseEvent, DatabaseEventType, WriterLease, } from './core';
-export { Database, openLightDatabase, Transaction, SCHEMA_KEY, RESERVED_KEY_PREFIX, documentVersion, parseSchemaDocument, encodeSchema, decodeSchema, } from './api';
+export { Database, WasmDatabase, openLightDatabase, Transaction, SCHEMA_KEY, RESERVED_KEY_PREFIX, documentVersion, parseSchemaDocument, encodeSchema, decodeSchema, } from './api';
 export type { OpenOptions, ScanRow, ScanOptions, BatchChange, MigrateOptions, LightDatabase, LightDatabaseOptions, SchemaVersion } from './api';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAC3D,YAAY,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAGpD,OAAO,EACH,WAAW,EACX,UAAU,EACV,UAAU,EACV,qBAAqB,EACrB,KAAK,EACL,eAAe,EACf,iBAAiB,EACjB,cAAc,EACd,gBAAgB,EAChB,oBAAoB,EACpB,gBAAgB,EAChB,mBAAmB,EACnB,mBAAmB,EACnB,YAAY,EACZ,cAAc,EACd,cAAc,EACd,eAAe,EACf,eAAe,GAClB,MAAM,SAAS,CAAC;AACjB,YAAY,EAAE,cAAc,EAAE,YAAY,EAAE,IAAI,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAG9F,OAAO,EACH,aAAa,EACb,oBAAoB,EACpB,oBAAoB,EACpB,kBAAkB,EAClB,yBAAyB,EACzB,eAAe,EACf,uBAAuB,EACvB,8BAA8B,EAC9B,oBAAoB,GACvB,MAAM,WAAW,CAAC;AACnB,YAAY,EAAE,cAAc,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,WAAW,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAGxI,OAAO,EAAE,aAAa,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,QAAQ,CAAC;AACxG,YAAY,EACR,gBAAgB,EAChB,SAAS,EACT,eAAe,EACf,oBAAoB,EACpB,kBAAkB,EAClB,gBAAgB,EAChB,aAAa,EACb,iBAAiB,EACjB,WAAW,GACd,MAAM,QAAQ,CAAC;AAGhB,OAAO,EACH,QAAQ,EACR,iBAAiB,EACjB,WAAW,EACX,UAAU,EACV,mBAAmB,EACnB,eAAe,EACf,mBAAmB,EACnB,YAAY,EACZ,YAAY,GACf,MAAM,OAAO,CAAC;AACf,YAAY,EAAE,WAAW,EAAE,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,cAAc,EAAE,aAAa,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAC3D,YAAY,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAGpD,OAAO,EACH,WAAW,EACX,UAAU,EACV,UAAU,EACV,qBAAqB,EACrB,KAAK,EACL,eAAe,EACf,iBAAiB,EACjB,cAAc,EACd,gBAAgB,EAChB,oBAAoB,EACpB,gBAAgB,EAChB,mBAAmB,EACnB,mBAAmB,EACnB,YAAY,EACZ,cAAc,EACd,cAAc,EACd,eAAe,EACf,eAAe,GAClB,MAAM,SAAS,CAAC;AACjB,YAAY,EAAE,cAAc,EAAE,YAAY,EAAE,IAAI,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAG9F,OAAO,EACH,aAAa,EACb,oBAAoB,EACpB,oBAAoB,EACpB,kBAAkB,EAClB,yBAAyB,EACzB,eAAe,EACf,uBAAuB,EACvB,8BAA8B,EAC9B,oBAAoB,GACvB,MAAM,WAAW,CAAC;AACnB,YAAY,EAAE,cAAc,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,WAAW,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAGxI,OAAO,EAAE,aAAa,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,QAAQ,CAAC;AACxG,YAAY,EACR,gBAAgB,EAChB,SAAS,EACT,eAAe,EACf,oBAAoB,EACpB,kBAAkB,EAClB,gBAAgB,EAChB,aAAa,EACb,iBAAiB,EACjB,WAAW,GACd,MAAM,QAAQ,CAAC;AAGhB,OAAO,EACH,QAAQ,EACR,YAAY,EACZ,iBAAiB,EACjB,WAAW,EACX,UAAU,EACV,mBAAmB,EACnB,eAAe,EACf,mBAAmB,EACnB,YAAY,EACZ,YAAY,GACf,MAAM,OAAO,CAAC;AACf,YAAY,EAAE,WAAW,EAAE,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,cAAc,EAAE,aAAa,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC"}

package/dist/index.js

@@ -15,5 +15,5 @@ export { STORAGE_FILES, MemoryStorageAdapter, MemoryStorageBackend, OpfsStorageA
 // 数据库语义
 export { StorageEngine, DEFAULT_WAL_THRESHOLD, acquireWriterLease, listenDatabaseEvents } from './core';
 // 作者面
-export { Database, openLightDatabase, Transaction, SCHEMA_KEY, RESERVED_KEY_PREFIX, documentVersion, parseSchemaDocument, encodeSchema, decodeSchema, } from './api';
+export { Database, WasmDatabase, openLightDatabase, Transaction, SCHEMA_KEY, RESERVED_KEY_PREFIX, documentVersion, parseSchemaDocument, encodeSchema, decodeSchema, } from './api';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO;AACP,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAG3D,MAAM;AACN,OAAO,EACH,WAAW,EACX,UAAU,EACV,UAAU,EACV,qBAAqB,EACrB,KAAK,EACL,eAAe,EACf,iBAAiB,EACjB,cAAc,EACd,gBAAgB,EAChB,oBAAoB,EACpB,gBAAgB,EAChB,mBAAmB,EACnB,mBAAmB,EACnB,YAAY,EACZ,cAAc,EACd,cAAc,EACd,eAAe,EACf,eAAe,GAClB,MAAM,SAAS,CAAC;AAGjB,SAAS;AACT,OAAO,EACH,aAAa,EACb,oBAAoB,EACpB,oBAAoB,EACpB,kBAAkB,EAClB,yBAAyB,EACzB,eAAe,EACf,uBAAuB,EACvB,8BAA8B,EAC9B,oBAAoB,GACvB,MAAM,WAAW,CAAC;AAGnB,QAAQ;AACR,OAAO,EAAE,aAAa,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,QAAQ,CAAC;AAaxG,MAAM;AACN,OAAO,EACH,QAAQ,EACR,iBAAiB,EACjB,WAAW,EACX,UAAU,EACV,mBAAmB,EACnB,eAAe,EACf,mBAAmB,EACnB,YAAY,EACZ,YAAY,GACf,MAAM,OAAO,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO;AACP,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAG3D,MAAM;AACN,OAAO,EACH,WAAW,EACX,UAAU,EACV,UAAU,EACV,qBAAqB,EACrB,KAAK,EACL,eAAe,EACf,iBAAiB,EACjB,cAAc,EACd,gBAAgB,EAChB,oBAAoB,EACpB,gBAAgB,EAChB,mBAAmB,EACnB,mBAAmB,EACnB,YAAY,EACZ,cAAc,EACd,cAAc,EACd,eAAe,EACf,eAAe,GAClB,MAAM,SAAS,CAAC;AAGjB,SAAS;AACT,OAAO,EACH,aAAa,EACb,oBAAoB,EACpB,oBAAoB,EACpB,kBAAkB,EAClB,yBAAyB,EACzB,eAAe,EACf,uBAAuB,EACvB,8BAA8B,EAC9B,oBAAoB,GACvB,MAAM,WAAW,CAAC;AAGnB,QAAQ;AACR,OAAO,EAAE,aAAa,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,QAAQ,CAAC;AAaxG,MAAM;AACN,OAAO,EACH,QAAQ,EACR,YAAY,EACZ,iBAAiB,EACjB,WAAW,EACX,UAAU,EACV,mBAAmB,EACnB,eAAe,EACf,mBAAmB,EACnB,YAAY,EACZ,YAAY,GACf,MAAM,OAAO,CAAC"}

package/package.json

@@ -1,23 +1,18 @@
 {
-  "author": "YYDB Contributors",
-  "bugs": {
-    "url": "https://github.com/yy-database/yydb.rs/issues"
-  },
-  "dependencies": {
-    "@voml/vos": "^0.0.1",
-    "@yydb/yydb-unknown-wasm32": "0.0.15"
-  },
+  "name": "@yydb/light-db",
+  "version": "0.0.16",
   "description": "Light DB — browser-native YYDB database written in pure TypeScript",
-  "devDependencies": {
-    "@types/node": "^20.19.43",
-    "playwright-core": "^1.64.1",
-    "tsx": "^4.23.15",
-    "typescript": "^5.3.0"
-  },
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
   "files": [
     "dist"
   ],
-  "homepage": "https://github.com/yy-database/yydb.rs/tree/dev/projects/packages/light-db#readme",
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit",
+    "test": "tsx tests/index.ts",
+    "test:browser": "tsx tests/browser/run.ts"
+  },
   "keywords": [
     "yydb",
     "light-db",
@@ -28,22 +23,27 @@
     "typescript"
   ],
   "license": "MPL-2.0",
-  "main": "dist/index.js",
-  "name": "@yydb/light-db",
-  "publishConfig": {
-    "access": "public"
-  },
+  "author": "YYDB Contributors",
   "repository": {
-    "directory": "projects/packages/light-db",
     "type": "git",
-    "url": "git+https://github.com/yy-database/yydb.rs.git"
+    "url": "git+https://github.com/yy-database/yydb.git",
+    "directory": "projects/packages/light-db"
   },
-  "scripts": {
-    "build": "tsc",
-    "test": "tsx tests/index.ts",
-    "test:browser": "tsx tests/browser/run.ts",
-    "typecheck": "tsc --noEmit"
+  "homepage": "https://github.com/yy-database/yydb/tree/dev/projects/packages/light-db#readme",
+  "bugs": {
+    "url": "https://github.com/yy-database/yydb/issues"
   },
-  "types": "dist/index.d.ts",
-  "version": "0.0.15"
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "@types/node": "^20.19.43",
+    "playwright-core": "^1.64.1",
+    "tsx": "^4.23.15",
+    "typescript": "^5.3.0"
+  },
+  "dependencies": {
+    "@voml/vos": "^0.0.1",
+    "@yydb/yydb-unknown-wasm32": "0.0.16"
+  }
 }

package/readme.md

@@ -1,110 +1,110 @@
-# `@yydb/light-db`
-
-**Light DB** is the browser edition of YYDB: a database written in pure TypeScript that stores `.yydb`-style
-snapshots, WAL records and checkpoints in browser storage. It has no Node built-ins, no N-API bindings and no WASM in
-its runtime path.
-
-## Product relationship
-
-| Package | Role |
-|---------|------|
-| `@yydb/yydb` | Node product: native Rust engine, N-API, local `.yydb` / `.yydx` files and CLI |
-| `@yydb/light-db` | Browser product: pure TypeScript, OPFS / IndexedDB storage, Web APIs, same author surface |
-| `@yydb/yydb-client` | Remote wire client for a running `yydb serve` |
-
-## Status
-
-Light DB is a migration of the original `LightDB.ts` engine, rebuilt around a browser-native architecture. The package
-ships as a pre-1.0 release of the browser product, so the author surface may still change between patch releases.
-
-Current coverage:
-
-- `pnpm test` runs the Node-side runner over codec, adapter and database logic (29 cases).
-- `pnpm test:browser` runs the conformance suite in an installed Chrome (16 cases): OPFS persistence across reopen, WAL
-  recovery, checkpoint truncation, corruption detection, single-writer exclusion, transaction rollback and commit,
-  schema and close notifications, and two-tab lease and broadcast behaviour.
-
-## Usage
-
-```ts
-import { LightDbError, openLightDatabase } from '@yydb/light-db';
-
-const db = await openLightDatabase('app');
-
-await db.ensureSchema('// @yydb-schema-version: 1\nkv users');
-await db.put('user:1', new TextEncoder().encode('Ada'));
-
-const value = await db.get('user:1');
-await db.checkpoint();
-await db.close();
-```
-
-Public data types are browser-native: keys and values use `Uint8Array`, databases are addressed by name rather than by
-file path, and every lifecycle call is asynchronous.
-
-## Author surface
-
-```ts
-const db: LightDatabase = await openLightDatabase('app', options);
-
-await db.schema();
-await db.ensureSchema(document);
-await db.get(key);
-await db.put(key, value);
-await db.delete(key);
-await db.begin();
-await db.commit();
-await db.rollback();
-await db.checkpoint();
-db.stats();
-await db.close();
-```
-
-`schema()` returns the persisted schema version and document. The document is the single source of truth: a second
-`ensureSchema` call must pass the identical document, otherwise it fails with `yydb.schema.conflict`. Keys starting with
-`__yydb__/` are reserved for the database.
-
-## Storage backends
-
-| Adapter | Use |
-|---------|-----|
-| `OpfsStorageAdapterFactory` | Default. Origin Private File System, positional reads and writes, atomic snapshot publication |
-| `IndexedDbStorageAdapterFactory` | Compatibility backend for hosts without OPFS |
-| `MemoryStorageBackend` | Tests and throwaway sessions |
-
-`StorageAdapter` is the only platform boundary. Transactions, recovery and checkpoint semantics live in `core`, so
-backends implement files, not database behaviour.
-
-## Concurrency
-
-A writer holds a session-scoped `Web Locks` lease. A second tab that opens the same database fails with
-`yydb.lease.unavailable` and `retryable: true` instead of silently writing alongside the first one. When a lock manager
-is missing the call fails the same way; it never degrades to multiple writers.
-
-`BroadcastChannel` carries `commit`, `schema` and `close` events so other same-origin contexts can discard stale views
-and retry after the lease is released. `listenDatabaseEvents(name, handler)` subscribes without opening the database.
-
-## Layout
-
-| Path | Role |
-|------|------|
-| `src/api/` | Public database, transaction, schema and shared types |
-| `src/core/` | Records, WAL, checkpoint, recovery, writer lease and broadcast |
-| `src/storage/` | `StorageAdapter` plus OPFS, IndexedDB and memory backends |
-| `src/codec/` | Page, snapshot and WAL record encoding over `Uint8Array` |
-| `src/errors/` | Stable `yydb.*` error codes |
-
-## Errors
-
-| Code | Meaning |
-|------|---------|
-| `yydb.io` | Storage operation failed |
-| `yydb.corrupt` | Persisted bytes failed validation |
-| `yydb.schema.conflict` | Schema document differs from the stored one |
-| `yydb.schema.invalid` | Schema document is not usable |
-| `yydb.unsupported` | Host or operation is not supported |
-| `yydb.session.closed` | Database or handle is closed |
-| `yydb.lease.unavailable` | Writer lease is held elsewhere or Web Locks is missing (retryable) |
-| `yydb.quota.exceeded` | Browser storage quota is exhausted |
-
-[YYDB overview](https://github.com/yy-database/yydb.rs)
+# `@yydb/light-db`
+
+**Light DB** is the browser edition of YYDB: a database written in pure TypeScript that stores `.yydb`-style
+snapshots, WAL records and checkpoints in browser storage. It has no Node built-ins, no N-API bindings and no WASM in
+its runtime path.
+
+## Product relationship
+
+| Package | Role |
+|---------|------|
+| `@yydb/yydb` | Node product: native Rust engine, N-API, local `.yydb` / `.yydx` files and CLI |
+| `@yydb/light-db` | Browser product: pure TypeScript, OPFS / IndexedDB storage, Web APIs, same author surface |
+| `@yydb/yydb-client` | Remote wire client for a running `yydb serve` |
+
+## Status
+
+Light DB is a migration of the original `LightDB.ts` engine, rebuilt around a browser-native architecture. The package
+ships as a pre-1.0 release of the browser product, so the author surface may still change between patch releases.
+
+Current coverage:
+
+- `pnpm test` runs the Node-side runner over codec, adapter and database logic (29 cases).
+- `pnpm test:browser` runs the conformance suite in an installed Chrome (16 cases): OPFS persistence across reopen, WAL
+  recovery, checkpoint truncation, corruption detection, single-writer exclusion, transaction rollback and commit,
+  schema and close notifications, and two-tab lease and broadcast behaviour.
+
+## Usage
+
+```ts
+import { LightDbError, openLightDatabase } from '@yydb/light-db';
+
+const db = await openLightDatabase('app');
+
+await db.ensureSchema('// @yydb-schema-version: 1\nkv users');
+await db.put('user:1', new TextEncoder().encode('Ada'));
+
+const value = await db.get('user:1');
+await db.checkpoint();
+await db.close();
+```
+
+Public data types are browser-native: keys and values use `Uint8Array`, databases are addressed by name rather than by
+file path, and every lifecycle call is asynchronous.
+
+## Author surface
+
+```ts
+const db: LightDatabase = await openLightDatabase('app', options);
+
+await db.schema();
+await db.ensureSchema(document);
+await db.get(key);
+await db.put(key, value);
+await db.delete(key);
+await db.begin();
+await db.commit();
+await db.rollback();
+await db.checkpoint();
+db.stats();
+await db.close();
+```
+
+`schema()` returns the persisted schema version and document. The document is the single source of truth: a second
+`ensureSchema` call must pass the identical document, otherwise it fails with `yydb.schema.conflict`. Keys starting with
+`__yydb__/` are reserved for the database.
+
+## Storage backends
+
+| Adapter | Use |
+|---------|-----|
+| `OpfsStorageAdapterFactory` | Default. Origin Private File System, positional reads and writes, atomic snapshot publication |
+| `IndexedDbStorageAdapterFactory` | Compatibility backend for hosts without OPFS |
+| `MemoryStorageBackend` | Tests and throwaway sessions |
+
+`StorageAdapter` is the only platform boundary. Transactions, recovery and checkpoint semantics live in `core`, so
+backends implement files, not database behaviour.
+
+## Concurrency
+
+A writer holds a session-scoped `Web Locks` lease. A second tab that opens the same database fails with
+`yydb.lease.unavailable` and `retryable: true` instead of silently writing alongside the first one. When a lock manager
+is missing the call fails the same way; it never degrades to multiple writers.
+
+`BroadcastChannel` carries `commit`, `schema` and `close` events so other same-origin contexts can discard stale views
+and retry after the lease is released. `listenDatabaseEvents(name, handler)` subscribes without opening the database.
+
+## Layout
+
+| Path | Role |
+|------|------|
+| `src/api/` | Public database, transaction, schema and shared types |
+| `src/core/` | Records, WAL, checkpoint, recovery, writer lease and broadcast |
+| `src/storage/` | `StorageAdapter` plus OPFS, IndexedDB and memory backends |
+| `src/codec/` | Page, snapshot and WAL record encoding over `Uint8Array` |
+| `src/errors/` | Stable `yydb.*` error codes |
+
+## Errors
+
+| Code | Meaning |
+|------|---------|
+| `yydb.io` | Storage operation failed |
+| `yydb.corrupt` | Persisted bytes failed validation |
+| `yydb.schema.conflict` | Schema document differs from the stored one |
+| `yydb.schema.invalid` | Schema document is not usable |
+| `yydb.unsupported` | Host or operation is not supported |
+| `yydb.session.closed` | Database or handle is closed |
+| `yydb.lease.unavailable` | Writer lease is held elsewhere or Web Locks is missing (retryable) |
+| `yydb.quota.exceeded` | Browser storage quota is exhausted |
+
+[YYDB overview](https://github.com/yy-database/yydb.rs)