@yydb/light-db 0.0.18 → 0.1.2

package/dist/core/records.d.ts

@@ -1,49 +0,0 @@
-/**
- * 记录存储
- *
- * 数据库在内存中的键值视图。值在写入与读取时都做一次复制，
- * 避免调用方持有内部字节数组造成校验和与快照不一致。
- */
-/**
- * 内存记录存储
- */
-export declare class RecordStore {
-    private records;
-    /**
-     * 读取值
-     * @param key 键
-     */
-    get(key: string): Uint8Array | null;
-    /**
-     * 是否存在键
-     * @param key 键
-     */
-    has(key: string): boolean;
-    /**
-     * 写入值
-     * @param key 键
-     * @param value 值
-     */
-    put(key: string, value: Uint8Array): void;
-    /**
-     * 删除键
-     * @param key 键
-     */
-    delete(key: string): boolean;
-    /** 记录数量 */
-    get size(): number;
-    /**
-     * 快照当前记录
-     *
-     * 返回只读视图，供检查点打包使用。
-     */
-    snapshot(): ReadonlyMap<string, Uint8Array>;
-    /**
-     * 用恢复结果替换全部记录
-     * @param records 记录映射
-     */
-    restore(records: ReadonlyMap<string, Uint8Array>): void;
-    /** 清空所有记录 */
-    clear(): void;
-}
-//# sourceMappingURL=records.d.ts.map

package/dist/core/records.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"records.d.ts","sourceRoot":"","sources":["../../src/core/records.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH;;GAEG;AACH,qBAAa,WAAW;IACpB,OAAO,CAAC,OAAO,CAAsC;IAErD;;;OAGG;IACI,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI;IAK1C;;;OAGG;IACI,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAIhC;;;;OAIG;IACI,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,IAAI;IAIhD;;;OAGG;IACI,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAInC,WAAW;IACX,IAAW,IAAI,IAAI,MAAM,CAExB;IAED;;;;OAIG;IACI,QAAQ,IAAI,WAAW,CAAC,MAAM,EAAE,UAAU,CAAC;IAIlD;;;OAGG;IACI,OAAO,CAAC,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,UAAU,CAAC,GAAG,IAAI;IAO9D,aAAa;IACN,KAAK,IAAI,IAAI;CAGvB"}

package/dist/core/records.js

@@ -1,70 +0,0 @@
-/**
- * 记录存储
- *
- * 数据库在内存中的键值视图。值在写入与读取时都做一次复制，
- * 避免调用方持有内部字节数组造成校验和与快照不一致。
- */
-import { BinaryUtils } from '../codec';
-/**
- * 内存记录存储
- */
-export class RecordStore {
-    records = new Map();
-    /**
-     * 读取值
-     * @param key 键
-     */
-    get(key) {
-        const value = this.records.get(key);
-        return value ? BinaryUtils.copy(value) : null;
-    }
-    /**
-     * 是否存在键
-     * @param key 键
-     */
-    has(key) {
-        return this.records.has(key);
-    }
-    /**
-     * 写入值
-     * @param key 键
-     * @param value 值
-     */
-    put(key, value) {
-        this.records.set(key, BinaryUtils.copy(value));
-    }
-    /**
-     * 删除键
-     * @param key 键
-     */
-    delete(key) {
-        return this.records.delete(key);
-    }
-    /** 记录数量 */
-    get size() {
-        return this.records.size;
-    }
-    /**
-     * 快照当前记录
-     *
-     * 返回只读视图，供检查点打包使用。
-     */
-    snapshot() {
-        return this.records;
-    }
-    /**
-     * 用恢复结果替换全部记录
-     * @param records 记录映射
-     */
-    restore(records) {
-        this.records = new Map();
-        for (const [key, value] of records) {
-            this.records.set(key, BinaryUtils.copy(value));
-        }
-    }
-    /** 清空所有记录 */
-    clear() {
-        this.records.clear();
-    }
-}
-//# sourceMappingURL=records.js.map

package/dist/core/records.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"records.js","sourceRoot":"","sources":["../../src/core/records.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAEvC;;GAEG;AACH,MAAM,OAAO,WAAW;IACZ,OAAO,GAA4B,IAAI,GAAG,EAAE,CAAC;IAErD;;;OAGG;IACI,GAAG,CAAC,GAAW;QAClB,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACpC,OAAO,KAAK,CAAC,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAClD,CAAC;IAED;;;OAGG;IACI,GAAG,CAAC,GAAW;QAClB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACjC,CAAC;IAED;;;;OAIG;IACI,GAAG,CAAC,GAAW,EAAE,KAAiB;QACrC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;IACnD,CAAC;IAED;;;OAGG;IACI,MAAM,CAAC,GAAW;QACrB,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACpC,CAAC;IAED,WAAW;IACX,IAAW,IAAI;QACX,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC;IAC7B,CAAC;IAED;;;;OAIG;IACI,QAAQ;QACX,OAAO,IAAI,CAAC,OAAO,CAAC;IACxB,CAAC;IAED;;;OAGG;IACI,OAAO,CAAC,OAAwC;QACnD,IAAI,CAAC,OAAO,GAAG,IAAI,GAAG,EAAE,CAAC;QACzB,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,OAAO,EAAE,CAAC;YACjC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;QACnD,CAAC;IACL,CAAC;IAED,aAAa;IACN,KAAK;QACR,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;IACzB,CAAC;CACJ"}

package/dist/core/recovery.d.ts

@@ -1,43 +0,0 @@
-/**
- * 崩溃恢复
- *
- * 读取最近一次快照，再按 WAL 顺序重放快照之后的记录。
- */
-import type { StorageAdapter } from '../storage/StorageAdapter';
-import type { WalLog } from './wal';
-/** 恢复结果 */
-export interface RecoveryOutcome {
-    /** 恢复后的记录 */
-    records: Map<string, Uint8Array>;
-    /** 已覆盖到的最大 LSN */
-    lastLsn: bigint;
-    /** 载入的页数量 */
-    pagesLoaded: number;
-    /** 重放的 WAL 记录数量 */
-    recordsReplayed: number;
-    /** 丢弃的不完整 WAL 尾字节数 */
-    discardedTailBytes: number;
-}
-/**
- * 恢复管理器
- */
-export declare class RecoveryManager {
-    private readonly adapter;
-    constructor(adapter: StorageAdapter);
-    /**
-     * 执行恢复
-     * @param wal 已打开的 WAL
-     */
-    recover(wal: WalLog): Promise<RecoveryOutcome>;
-    /**
-     * 读取快照，不存在时返回空记录
-     */
-    private loadSnapshot;
-    /**
-     * 应用一条 WAL 记录
-     * @param records 记录映射
-     * @param record WAL 记录
-     */
-    private apply;
-}
-//# sourceMappingURL=recovery.d.ts.map

package/dist/core/recovery.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"recovery.d.ts","sourceRoot":"","sources":["../../src/core/recovery.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AAEpC,WAAW;AACX,MAAM,WAAW,eAAe;IAC5B,aAAa;IACb,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACjC,kBAAkB;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,mBAAmB;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,sBAAsB;IACtB,kBAAkB,EAAE,MAAM,CAAC;CAC9B;AAED;;GAEG;AACH,qBAAa,eAAe;IACxB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAiB;gBAE7B,OAAO,EAAE,cAAc;IAInC;;;OAGG;IACU,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IA6B3D;;OAEG;YACW,YAAY;IAoC1B;;;;OAIG;IACH,OAAO,CAAC,KAAK;CAchB"}

package/dist/core/recovery.js

@@ -1,99 +0,0 @@
-/**
- * 崩溃恢复
- *
- * 读取最近一次快照，再按 WAL 顺序重放快照之后的记录。
- */
-import { ChecksumMismatchError, decodeSnapshot, SnapshotFormatError } from '../codec';
-import { WalOperation } from '../codec';
-import { LightDbError, LightDbErrorCodes } from '../errors';
-/**
- * 恢复管理器
- */
-export class RecoveryManager {
-    adapter;
-    constructor(adapter) {
-        this.adapter = adapter;
-    }
-    /**
-     * 执行恢复
-     * @param wal 已打开的 WAL
-     */
-    async recover(wal) {
-        const snapshot = await this.loadSnapshot();
-        const { records: walRecords, validBytes, fileSize } = await wal.readAll();
-        if (validBytes < fileSize) {
-            await wal.truncate(validBytes);
-        }
-        let recordsReplayed = 0;
-        let lastLsn = snapshot.lastSnapshotLsn;
-        for (const record of walRecords) {
-            if (record.lsn <= snapshot.lastSnapshotLsn) {
-                continue;
-            }
-            this.apply(snapshot.records, record);
-            lastLsn = record.lsn > lastLsn ? record.lsn : lastLsn;
-            recordsReplayed++;
-        }
-        return {
-            records: snapshot.records,
-            lastLsn,
-            pagesLoaded: snapshot.pagesLoaded,
-            recordsReplayed,
-            discardedTailBytes: fileSize - validBytes,
-        };
-    }
-    /**
-     * 读取快照，不存在时返回空记录
-     */
-    async loadSnapshot() {
-        if (!(await this.adapter.exists('main'))) {
-            return { records: new Map(), lastSnapshotLsn: 0n, pagesLoaded: 0 };
-        }
-        const handle = await this.adapter.open('main', 'read');
-        let data;
-        try {
-            const size = await handle.size();
-            data = await handle.read(0, size);
-        }
-        finally {
-            await handle.close();
-        }
-        try {
-            const snapshot = decodeSnapshot(data);
-            return {
-                records: snapshot.records,
-                lastSnapshotLsn: snapshot.header.lastSnapshotLsn,
-                pagesLoaded: snapshot.pageCount,
-            };
-        }
-        catch (error) {
-            if (error instanceof SnapshotFormatError || error instanceof ChecksumMismatchError) {
-                throw new LightDbError(LightDbErrorCodes.corrupt, 'database snapshot is corrupt', {
-                    operation: 'recover',
-                    cause: error,
-                });
-            }
-            throw error;
-        }
-    }
-    /**
-     * 应用一条 WAL 记录
-     * @param records 记录映射
-     * @param record WAL 记录
-     */
-    apply(records, record) {
-        switch (record.operation) {
-            case WalOperation.Put:
-                if (record.value) {
-                    records.set(record.key, record.value);
-                }
-                break;
-            case WalOperation.Delete:
-                records.delete(record.key);
-                break;
-            case WalOperation.Checkpoint:
-                break;
-        }
-    }
-}
-//# sourceMappingURL=recovery.js.map

package/dist/core/recovery.js.map

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

package/dist/core/wal.d.ts

@@ -1,50 +0,0 @@
-/**
- * WAL 日志
- *
- * 只通过 `StorageAdapter` 访问平台，记录格式由 `codec/record` 决定。
- */
-import type { WalRecord } from '../codec';
-import type { StorageAdapter } from '../storage/StorageAdapter';
-/**
- * 预写日志
- */
-export declare class WalLog {
-    private readonly adapter;
-    private handle;
-    private offset;
-    constructor(adapter: StorageAdapter);
-    /** 当前日志字节数 */
-    get byteSize(): number;
-    /**
-     * 打开日志，定位到末尾
-     */
-    open(): Promise<void>;
-    /**
-     * 追加记录并等待落盘
-     * @param records 记录
-     */
-    append(records: readonly WalRecord[]): Promise<number>;
-    /**
-     * 读取全部完整记录
-     *
-     * 末尾不完整的记录（写入过程中断）会被丢弃，`validBytes` 指向最后一个完整记录之后。
-     */
-    readAll(): Promise<{
-        records: WalRecord[];
-        validBytes: number;
-        fileSize: number;
-    }>;
-    /**
-     * 截断日志
-     * @param size 目标字节数，默认 0
-     */
-    truncate(size?: number): Promise<void>;
-    /** 关闭日志 */
-    close(): Promise<void>;
-    /**
-     * 获取已打开的句柄
-     * @param operation 操作名
-     */
-    private requireHandle;
-}
-//# sourceMappingURL=wal.d.ts.map

package/dist/core/wal.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"wal.d.ts","sourceRoot":"","sources":["../../src/core/wal.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAE1C,OAAO,KAAK,EAAE,cAAc,EAAiB,MAAM,2BAA2B,CAAC;AAE/E;;GAEG;AACH,qBAAa,MAAM;IACf,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAiB;IACzC,OAAO,CAAC,MAAM,CAA8B;IAC5C,OAAO,CAAC,MAAM,CAAa;gBAEf,OAAO,EAAE,cAAc;IAInC,cAAc;IACd,IAAW,QAAQ,IAAI,MAAM,CAE5B;IAED;;OAEG;IACU,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAKlC;;;OAGG;IACU,MAAM,CAAC,OAAO,EAAE,SAAS,SAAS,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAsBnE;;;;OAIG;IACU,OAAO,IAAI,OAAO,CAAC;QAAE,OAAO,EAAE,SAAS,EAAE,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IAiC/F;;;OAGG;IACU,QAAQ,CAAC,IAAI,GAAE,MAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAOtD,WAAW;IACE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAOnC;;;OAGG;IACH,OAAO,CAAC,aAAa;CAMxB"}

package/dist/core/wal.js

@@ -1,114 +0,0 @@
-/**
- * WAL 日志
- *
- * 只通过 `StorageAdapter` 访问平台，记录格式由 `codec/record` 决定。
- */
-import { ChecksumMismatchError, decodeWalRecord, encodeWalRecord } from '../codec';
-import { LightDbError, LightDbErrorCodes } from '../errors';
-/**
- * 预写日志
- */
-export class WalLog {
-    adapter;
-    handle = null;
-    offset = 0;
-    constructor(adapter) {
-        this.adapter = adapter;
-    }
-    /** 当前日志字节数 */
-    get byteSize() {
-        return this.offset;
-    }
-    /**
-     * 打开日志，定位到末尾
-     */
-    async open() {
-        this.handle = await this.adapter.open('wal', 'readwrite');
-        this.offset = await this.handle.size();
-    }
-    /**
-     * 追加记录并等待落盘
-     * @param records 记录
-     */
-    async append(records) {
-        if (records.length === 0) {
-            return 0;
-        }
-        const handle = this.requireHandle('walAppend');
-        const encoded = records.map((record) => encodeWalRecord(record));
-        const total = encoded.reduce((sum, part) => sum + part.length, 0);
-        const buffer = new Uint8Array(total);
-        let position = 0;
-        for (const part of encoded) {
-            buffer.set(part, position);
-            position += part.length;
-        }
-        await handle.write(this.offset, buffer);
-        await handle.sync();
-        this.offset += total;
-        return total;
-    }
-    /**
-     * 读取全部完整记录
-     *
-     * 末尾不完整的记录（写入过程中断）会被丢弃，`validBytes` 指向最后一个完整记录之后。
-     */
-    async readAll() {
-        const handle = this.requireHandle('walRead');
-        const size = await handle.size();
-        if (size === 0) {
-            return { records: [], validBytes: 0, fileSize: 0 };
-        }
-        const data = await handle.read(0, size);
-        const records = [];
-        let offset = 0;
-        while (offset < data.length) {
-            try {
-                const decoded = decodeWalRecord(data, offset);
-                if (decoded.status === 'incomplete') {
-                    break;
-                }
-                records.push(decoded.record);
-                offset += decoded.bytesRead;
-            }
-            catch (error) {
-                if (error instanceof ChecksumMismatchError) {
-                    throw new LightDbError(LightDbErrorCodes.corrupt, `WAL record is corrupt at offset ${offset}`, {
-                        operation: 'walRead',
-                        cause: error,
-                    });
-                }
-                throw error;
-            }
-        }
-        return { records, validBytes: offset, fileSize: size };
-    }
-    /**
-     * 截断日志
-     * @param size 目标字节数，默认 0
-     */
-    async truncate(size = 0) {
-        const handle = this.requireHandle('walTruncate');
-        await handle.truncate(size);
-        await handle.sync();
-        this.offset = size;
-    }
-    /** 关闭日志 */
-    async close() {
-        if (this.handle) {
-            await this.handle.close();
-            this.handle = null;
-        }
-    }
-    /**
-     * 获取已打开的句柄
-     * @param operation 操作名
-     */
-    requireHandle(operation) {
-        if (!this.handle) {
-            throw new LightDbError(LightDbErrorCodes.sessionClosed, 'WAL is not open', { operation });
-        }
-        return this.handle;
-    }
-}
-//# sourceMappingURL=wal.js.map

package/dist/core/wal.js.map

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

package/dist/storage/StorageAdapter.d.ts

@@ -1,97 +0,0 @@
-/**
- * 存储适配器合同
- *
- * 这是 `@yydb/light-db` 唯一的平台边界。上层只认识逻辑文件名与随机访问句柄，
- * 不认识本地路径、OPFS 目录结构或任何 Node 文件 API。
- */
-/** 逻辑文件名，对外不暴露扩展名与目录结构 */
-export type StorageFile = 'main' | 'main.tmp' | 'wal' | 'shm';
-/** 所有逻辑文件 */
-export declare const STORAGE_FILES: readonly StorageFile[];
-/** 打开模式 */
-export type StorageOpenMode = 'read' | 'readwrite';
-/** 适配器类型 */
-export type StorageAdapterKind = 'opfs' | 'indexeddb' | 'memory';
-/**
- * 随机访问句柄
- *
- * 语义参照 OPFS `FileSystemSyncAccessHandle`：按位置读写、可截断、可 flush，
- * 不提供路径、目录或文件重命名能力。
- */
-export interface StorageHandle {
-    /**
-     * 读取指定区间
-     * @param position 起始位置
-     * @param length 期望长度，超出文件末尾时返回实际可读部分
-     */
-    read(position: number, length: number): Promise<Uint8Array>;
-    /**
-     * 写入指定位置，必要时扩展文件
-     * @param position 起始位置
-     * @param data 数据
-     */
-    write(position: number, data: Uint8Array): Promise<void>;
-    /**
-     * 截断到指定大小
-     * @param size 目标大小
-     */
-    truncate(size: number): Promise<void>;
-    /** 将已写入的数据持久化到宿主 */
-    sync(): Promise<void>;
-    /** 当前文件大小 */
-    size(): Promise<number>;
-    /** 关闭句柄 */
-    close(): Promise<void>;
-}
-/**
- * 单个数据库的存储适配器
- *
- * 适配器只管理四个逻辑文件，原子发布由 `rename` 完成。
- */
-export interface StorageAdapter {
-    /** 适配器类型 */
-    readonly kind: StorageAdapterKind;
-    /** 数据是否在会话结束后仍然存在 */
-    readonly persistent: boolean;
-    /**
-     * 打开逻辑文件
-     * @param file 逻辑文件名
-     * @param mode 打开模式，默认 `readwrite`
-     */
-    open(file: StorageFile, mode?: StorageOpenMode): Promise<StorageHandle>;
-    /**
-     * 判断逻辑文件是否存在
-     * @param file 逻辑文件名
-     */
-    exists(file: StorageFile): Promise<boolean>;
-    /**
-     * 删除逻辑文件，不存在时视为成功
-     * @param file 逻辑文件名
-     */
-    delete(file: StorageFile): Promise<void>;
-    /**
-     * 原子重命名，用于发布快照
-     * @param from 源文件
-     * @param to 目标文件
-     */
-    rename(from: StorageFile, to: StorageFile): Promise<void>;
-    /** 列出已存在的逻辑文件 */
-    list(): Promise<StorageFile[]>;
-    /** 关闭适配器 */
-    close(): Promise<void>;
-}
-/**
- * 按数据库名打开适配器的工厂
- */
-export interface StorageAdapterFactory {
-    /** 适配器类型 */
-    readonly kind: StorageAdapterKind;
-    /** 数据是否在会话结束后仍然存在 */
-    readonly persistent: boolean;
-    /**
-     * 打开指定数据库的适配器
-     * @param name 数据库名（浏览器 storage namespace）
-     */
-    openDatabase(name: string): Promise<StorageAdapter>;
-}
-//# sourceMappingURL=StorageAdapter.d.ts.map

package/dist/storage/StorageAdapter.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"StorageAdapter.d.ts","sourceRoot":"","sources":["../../src/storage/StorageAdapter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,0BAA0B;AAC1B,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,UAAU,GAAG,KAAK,GAAG,KAAK,CAAC;AAE9D,aAAa;AACb,eAAO,MAAM,aAAa,EAAE,SAAS,WAAW,EAAuC,CAAC;AAExF,WAAW;AACX,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,WAAW,CAAC;AAEnD,YAAY;AACZ,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG,WAAW,GAAG,QAAQ,CAAC;AAEjE;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC1B;;;;OAIG;IACH,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAE5D;;;;OAIG;IACH,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEzD;;;OAGG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEtC,oBAAoB;IACpB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEtB,aAAa;IACb,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAExB,WAAW;IACX,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B;AAED;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC3B,YAAY;IACZ,QAAQ,CAAC,IAAI,EAAE,kBAAkB,CAAC;IAElC,qBAAqB;IACrB,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAE7B;;;;OAIG;IACH,IAAI,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IAExE;;;OAGG;IACH,MAAM,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAE5C;;;OAGG;IACH,MAAM,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEzC;;;;OAIG;IACH,MAAM,CAAC,IAAI,EAAE,WAAW,EAAE,EAAE,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE1D,iBAAiB;IACjB,IAAI,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IAE/B,YAAY;IACZ,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IAClC,YAAY;IACZ,QAAQ,CAAC,IAAI,EAAE,kBAAkB,CAAC;IAElC,qBAAqB;IACrB,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAE7B;;;OAGG;IACH,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;CACvD"}

package/dist/storage/StorageAdapter.js

@@ -1,9 +0,0 @@
-/**
- * 存储适配器合同
- *
- * 这是 `@yydb/light-db` 唯一的平台边界。上层只认识逻辑文件名与随机访问句柄，
- * 不认识本地路径、OPFS 目录结构或任何 Node 文件 API。
- */
-/** 所有逻辑文件 */
-export const STORAGE_FILES = ['main', 'main.tmp', 'wal', 'shm'];
-//# sourceMappingURL=StorageAdapter.js.map

package/dist/storage/StorageAdapter.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"StorageAdapter.js","sourceRoot":"","sources":["../../src/storage/StorageAdapter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,aAAa;AACb,MAAM,CAAC,MAAM,aAAa,GAA2B,CAAC,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC"}

package/dist/storage/index.d.ts

@@ -1,11 +0,0 @@
-/**
- * storage 层导出
- *
- * `StorageAdapter` 是唯一平台边界；OPFS 为默认后端，内存后端用于测试与一次性会话。
- */
-export { STORAGE_FILES } from './StorageAdapter';
-export type { StorageAdapter, StorageAdapterFactory, StorageAdapterKind, StorageFile, StorageHandle, StorageOpenMode } from './StorageAdapter';
-export { MemoryStorageAdapter, MemoryStorageBackend } from './memory/MemoryStorageAdapter';
-export { OpfsStorageAdapter, OpfsStorageAdapterFactory, isOpfsAvailable } from './opfs/OpfsStorageAdapter';
-export { IndexedDbStorageAdapter, IndexedDbStorageAdapterFactory, isIndexedDbAvailable } from './indexeddb/IndexedDbStorageAdapter';
-//# sourceMappingURL=index.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/storage/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,YAAY,EAAE,cAAc,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,WAAW,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAC/I,OAAO,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AAC3F,OAAO,EAAE,kBAAkB,EAAE,yBAAyB,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC3G,OAAO,EAAE,uBAAuB,EAAE,8BAA8B,EAAE,oBAAoB,EAAE,MAAM,qCAAqC,CAAC"}

package/dist/storage/index.js

@@ -1,10 +0,0 @@
-/**
- * storage 层导出
- *
- * `StorageAdapter` 是唯一平台边界；OPFS 为默认后端，内存后端用于测试与一次性会话。
- */
-export { STORAGE_FILES } from './StorageAdapter';
-export { MemoryStorageAdapter, MemoryStorageBackend } from './memory/MemoryStorageAdapter';
-export { OpfsStorageAdapter, OpfsStorageAdapterFactory, isOpfsAvailable } from './opfs/OpfsStorageAdapter';
-export { IndexedDbStorageAdapter, IndexedDbStorageAdapterFactory, isIndexedDbAvailable } from './indexeddb/IndexedDbStorageAdapter';
-//# sourceMappingURL=index.js.map

package/dist/storage/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/storage/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEjD,OAAO,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AAC3F,OAAO,EAAE,kBAAkB,EAAE,yBAAyB,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC3G,OAAO,EAAE,uBAAuB,EAAE,8BAA8B,EAAE,oBAAoB,EAAE,MAAM,qCAAqC,CAAC"}