@yydb/light-db 0.0.0 → 0.0.10

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"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,eAAe,EACf,iBAAiB,EACjB,WAAW,EACX,UAAU,EACV,mBAAmB,EACnB,eAAe,EACf,mBAAmB,EACnB,YAAY,EACZ,YAAY,GACf,MAAM,OAAO,CAAC"}

package/dist/storage/StorageAdapter.d.ts

@@ -0,0 +1,97 @@
+/**
+ * 存储适配器合同
+ *
+ * 这是 `@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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,9 @@
+/**
+ * 存储适配器合同
+ *
+ * 这是 `@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

@@ -0,0 +1 @@
+{"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,10 +1,11 @@
 /**
- * 存储模块导出
+ * storage 层导出
+ *
+ * `StorageAdapter` 是唯一平台边界；OPFS 为默认后端，内存后端用于测试与一次性会话。
  */
-export { LightFileSerializer, LightFileManager, PageManager } from "./LightFile";
-export { WalRecordSerializer, WalWriter, WalReader, WalManager } from "./WALFile";
-export { ShmSerializer, ShmHashTable, ShmFileManager, WalIndexManager } from "./SHMFile";
-export { CheckpointManager, AutoCheckpointScheduler, IncrementalCheckpointManager, CheckpointOptions } from "./Checkpoint";
-export { RecoveryManager, FastRecoveryManager, RecoveryValidator, RecoveryPhase, RecoveryContext } from "./Recovery";
-export { StorageEngine, createStorageEngine } from "./StorageEngine";
-//# sourceMappingURL=index.d.ts.map
+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 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/storage/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACH,mBAAmB,EACnB,gBAAgB,EAChB,WAAW,GACd,MAAM,aAAa,CAAC;AACrB,OAAO,EACH,mBAAmB,EACnB,SAAS,EACT,SAAS,EACT,UAAU,GACb,MAAM,WAAW,CAAC;AACnB,OAAO,EACH,aAAa,EACb,YAAY,EACZ,cAAc,EACd,eAAe,GAClB,MAAM,WAAW,CAAC;AACnB,OAAO,EACH,iBAAiB,EACjB,uBAAuB,EACvB,4BAA4B,EAC5B,iBAAiB,GACpB,MAAM,cAAc,CAAC;AACtB,OAAO,EACH,eAAe,EACf,mBAAmB,EACnB,iBAAiB,EACjB,aAAa,EACb,eAAe,GAClB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC"}
+{"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,153 +1,10 @@
-"use strict";
 /**
- * 存储模块导出
+ * storage 层导出
+ *
+ * `StorageAdapter` 是唯一平台边界；OPFS 为默认后端，内存后端用于测试与一次性会话。
  */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.createStorageEngine =
-    exports.StorageEngine =
-    exports.RecoveryPhase =
-    exports.RecoveryValidator =
-    exports.FastRecoveryManager =
-    exports.RecoveryManager =
-    exports.IncrementalCheckpointManager =
-    exports.AutoCheckpointScheduler =
-    exports.CheckpointManager =
-    exports.WalIndexManager =
-    exports.ShmFileManager =
-    exports.ShmHashTable =
-    exports.ShmSerializer =
-    exports.WalManager =
-    exports.WalReader =
-    exports.WalWriter =
-    exports.WalRecordSerializer =
-    exports.PageManager =
-    exports.LightFileManager =
-    exports.LightFileSerializer =
-        void 0;
-var LightFile_1 = require("./LightFile");
-Object.defineProperty(exports, "LightFileSerializer", {
-    enumerable: true,
-    get: function () {
-        return LightFile_1.LightFileSerializer;
-    },
-});
-Object.defineProperty(exports, "LightFileManager", {
-    enumerable: true,
-    get: function () {
-        return LightFile_1.LightFileManager;
-    },
-});
-Object.defineProperty(exports, "PageManager", {
-    enumerable: true,
-    get: function () {
-        return LightFile_1.PageManager;
-    },
-});
-var WALFile_1 = require("./WALFile");
-Object.defineProperty(exports, "WalRecordSerializer", {
-    enumerable: true,
-    get: function () {
-        return WALFile_1.WalRecordSerializer;
-    },
-});
-Object.defineProperty(exports, "WalWriter", {
-    enumerable: true,
-    get: function () {
-        return WALFile_1.WalWriter;
-    },
-});
-Object.defineProperty(exports, "WalReader", {
-    enumerable: true,
-    get: function () {
-        return WALFile_1.WalReader;
-    },
-});
-Object.defineProperty(exports, "WalManager", {
-    enumerable: true,
-    get: function () {
-        return WALFile_1.WalManager;
-    },
-});
-var SHMFile_1 = require("./SHMFile");
-Object.defineProperty(exports, "ShmSerializer", {
-    enumerable: true,
-    get: function () {
-        return SHMFile_1.ShmSerializer;
-    },
-});
-Object.defineProperty(exports, "ShmHashTable", {
-    enumerable: true,
-    get: function () {
-        return SHMFile_1.ShmHashTable;
-    },
-});
-Object.defineProperty(exports, "ShmFileManager", {
-    enumerable: true,
-    get: function () {
-        return SHMFile_1.ShmFileManager;
-    },
-});
-Object.defineProperty(exports, "WalIndexManager", {
-    enumerable: true,
-    get: function () {
-        return SHMFile_1.WalIndexManager;
-    },
-});
-var Checkpoint_1 = require("./Checkpoint");
-Object.defineProperty(exports, "CheckpointManager", {
-    enumerable: true,
-    get: function () {
-        return Checkpoint_1.CheckpointManager;
-    },
-});
-Object.defineProperty(exports, "AutoCheckpointScheduler", {
-    enumerable: true,
-    get: function () {
-        return Checkpoint_1.AutoCheckpointScheduler;
-    },
-});
-Object.defineProperty(exports, "IncrementalCheckpointManager", {
-    enumerable: true,
-    get: function () {
-        return Checkpoint_1.IncrementalCheckpointManager;
-    },
-});
-var Recovery_1 = require("./Recovery");
-Object.defineProperty(exports, "RecoveryManager", {
-    enumerable: true,
-    get: function () {
-        return Recovery_1.RecoveryManager;
-    },
-});
-Object.defineProperty(exports, "FastRecoveryManager", {
-    enumerable: true,
-    get: function () {
-        return Recovery_1.FastRecoveryManager;
-    },
-});
-Object.defineProperty(exports, "RecoveryValidator", {
-    enumerable: true,
-    get: function () {
-        return Recovery_1.RecoveryValidator;
-    },
-});
-Object.defineProperty(exports, "RecoveryPhase", {
-    enumerable: true,
-    get: function () {
-        return Recovery_1.RecoveryPhase;
-    },
-});
-var StorageEngine_1 = require("./StorageEngine");
-Object.defineProperty(exports, "StorageEngine", {
-    enumerable: true,
-    get: function () {
-        return StorageEngine_1.StorageEngine;
-    },
-});
-Object.defineProperty(exports, "createStorageEngine", {
-    enumerable: true,
-    get: function () {
-        return StorageEngine_1.createStorageEngine;
-    },
-});
-//# sourceMappingURL=index.js.map
+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 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/storage/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH,yCAIqB;AAHjB,gHAAA,mBAAmB,OAAA;AACnB,6GAAA,gBAAgB,OAAA;AAChB,wGAAA,WAAW,OAAA;AAEf,qCAKmB;AAJf,8GAAA,mBAAmB,OAAA;AACnB,oGAAA,SAAS,OAAA;AACT,oGAAA,SAAS,OAAA;AACT,qGAAA,UAAU,OAAA;AAEd,qCAKmB;AAJf,wGAAA,aAAa,OAAA;AACb,uGAAA,YAAY,OAAA;AACZ,yGAAA,cAAc,OAAA;AACd,0GAAA,eAAe,OAAA;AAEnB,2CAKsB;AAJlB,+GAAA,iBAAiB,OAAA;AACjB,qHAAA,uBAAuB,OAAA;AACvB,0HAAA,4BAA4B,OAAA;AAGhC,uCAMoB;AALhB,2GAAA,eAAe,OAAA;AACf,+GAAA,mBAAmB,OAAA;AACnB,6GAAA,iBAAiB,OAAA;AACjB,yGAAA,aAAa,OAAA;AAGjB,iDAAqE;AAA5D,8GAAA,aAAa,OAAA;AAAE,oHAAA,mBAAmB,OAAA"}
+{"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"}

package/dist/storage/indexeddb/IndexedDbStorageAdapter.d.ts

@@ -0,0 +1,140 @@
+/**
+ * IndexedDB 存储适配器
+ *
+ * 兼容后端：宿主没有 OPFS，或需要在同一浏览器配置里复用既有存储时使用。
+ * 它只实现 `StorageAdapter` 合同，事务、恢复与检查点语义仍由 `core` 决定，
+ * 两套后端不各自实现一套数据库语义。
+ *
+ * IndexedDB 没有按位置随机写的原生能力，因此句柄在内存中维护整份文件内容，
+ * `sync()` 与 `close()` 负责把它写回对象仓库。这牺牲了 OPFS 那样的细粒度
+ * 原子性，属于兼容后端的已知取舍。
+ */
+import type { StorageAdapter, StorageAdapterFactory, StorageFile, StorageHandle, StorageOpenMode } from '../StorageAdapter';
+/** IndexedDB 请求的结构化视图 */
+interface IdbRequestLike<T> {
+    result: T;
+    error: unknown;
+    onsuccess: (() => void) | null;
+    onerror: (() => void) | null;
+}
+/** 对象仓库的结构化视图 */
+interface IdbObjectStoreLike {
+    get(key: string): IdbRequestLike<ArrayBuffer | undefined>;
+    put(value: ArrayBuffer, key: string): IdbRequestLike<unknown>;
+    delete(key: string): IdbRequestLike<unknown>;
+    getAllKeys(): IdbRequestLike<string[]>;
+}
+/** 事务的结构化视图 */
+interface IdbTransactionLike {
+    error: unknown;
+    oncomplete: (() => void) | null;
+    onerror: (() => void) | null;
+    onabort: (() => void) | null;
+    objectStore(name: string): IdbObjectStoreLike;
+    abort(): void;
+}
+/** 数据库的结构化视图 */
+interface IdbDatabaseLike {
+    objectStoreNames: {
+        contains(name: string): boolean;
+    };
+    createObjectStore(name: string): IdbObjectStoreLike;
+    transaction(name: string, mode?: 'readonly' | 'readwrite'): IdbTransactionLike;
+    close(): void;
+}
+/**
+ * 判断当前宿主是否提供 IndexedDB
+ */
+export declare function isIndexedDbAvailable(): boolean;
+/**
+ * IndexedDB 适配器工厂
+ */
+export declare class IndexedDbStorageAdapterFactory implements StorageAdapterFactory {
+    /** 适配器类型 */
+    readonly kind: "indexeddb";
+    /** 数据持久化 */
+    readonly persistent = true;
+    /**
+     * 打开数据库适配器
+     * @param name 数据库名
+     */
+    openDatabase(name: string): Promise<StorageAdapter>;
+}
+/**
+ * IndexedDB 存储适配器
+ */
+export declare class IndexedDbStorageAdapter implements StorageAdapter {
+    /** 适配器类型 */
+    readonly kind: "indexeddb";
+    /** 数据持久化 */
+    readonly persistent = true;
+    private readonly name;
+    private readonly db;
+    private closed;
+    constructor(name: string, db: IdbDatabaseLike);
+    /**
+     * 打开逻辑文件
+     * @param file 逻辑文件名
+     * @param mode 打开模式
+     */
+    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>;
+    /**
+     * 写回逻辑文件内容
+     * @param file 逻辑文件名
+     * @param data 文件内容
+     */
+    persist(file: StorageFile, data: Uint8Array): Promise<void>;
+    /**
+     * 读取逻辑文件内容
+     * @param file 逻辑文件名
+     * @returns 内容，文件不存在时返回 null
+     */
+    private readFile;
+    /**
+     * 执行只读事务
+     * @param operation 操作名
+     * @param action 请求构造
+     */
+    private readTransaction;
+    /**
+     * 执行读写事务
+     * @param operation 操作名
+     * @param action 请求构造
+     */
+    private writeTransaction;
+    /**
+     * 创建事务
+     * @param mode 事务模式
+     * @param operation 操作名
+     */
+    private beginTransaction;
+    /**
+     * 断言适配器未关闭
+     * @param operation 操作名
+     */
+    private assertOpen;
+}
+export {};
+//# sourceMappingURL=IndexedDbStorageAdapter.d.ts.map

package/dist/storage/indexeddb/IndexedDbStorageAdapter.d.ts.map

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