release: v0.2.2 AriaEngine OPFS 自研存储后端 — 零依赖纯文件系统

dist/metona-sqlark.d.ts

@@ -851,6 +851,59 @@ interface Token {
 /** 将 SQL 字符串解析为 Token 列表 */
 declare function tokenize(sql: string): Token[];
 
+/**
+ * AriaEngine Storage Backend — 存储后端抽象层
+ * @module engine/aria/store/backend
+ *
+ * 封装底层浏览器存储 API（IndexedDB / OPFS / Memory 回退），
+ * 供 Buffer Pool 的 PageIO 和 WAL 的 WALStore 使用。
+ */
+interface IStorageBackend {
+    /** 打开存储 */
+    open(name: string): Promise<void>;
+    /** 关闭存储 */
+    close(): Promise<void>;
+    /** 是否已打开 */
+    isOpen(): boolean;
+    /** 读取数据块 */
+    read(key: string): Promise<ArrayBuffer | null>;
+    /** 写入数据块 */
+    write(key: string, data: ArrayBuffer): Promise<void>;
+    /** 删除数据块 */
+    delete(key: string): Promise<void>;
+    /** 列出所有 key */
+    listKeys(): Promise<string[]>;
+    /** 检查 key 是否存在 */
+    exists(key: string): Promise<boolean>;
+    /** 清空所有数据 */
+    clear(): Promise<void>;
+}
+
+/**
+ * AriaEngine OPFS Backend — 基于 Origin Private File System 的自研存储后端
+ * @module engine/aria/store/opfs_backend
+ *
+ * 零外部依赖，纯浏览器文件系统 API。
+ * 每个 key 对应 OPFS 目录下的一个二进制文件。
+ *
+ * 浏览器要求：Chrome 102+ / Edge 102+
+ */
+
+declare class OPFSBackend implements IStorageBackend {
+    private root;
+    private dbDir;
+    private dbName;
+    open(name: string): Promise<void>;
+    close(): Promise<void>;
+    isOpen(): boolean;
+    read(key: string): Promise<ArrayBuffer | null>;
+    write(key: string, data: ArrayBuffer): Promise<void>;
+    delete(key: string): Promise<void>;
+    listKeys(): Promise<string[]>;
+    exists(key: string): Promise<boolean>;
+    clear(): Promise<void>;
+}
+
 /**
  * metona-sqlark — 入口文件
  * @module metona-sqlark
@@ -896,4 +949,4 @@ declare global {
 
 declare const MeSqlark: typeof MetonaSqlark;
 
-export { AriaEngine, AriaEngineConfig, ColumnDef, DatabaseConfig, DeleteStatement, DiskEngine, FieldType, HybridEngine, IStorageEngine, IndexedDBEngine, InsertStatement, MeSqlark, MemoryEngine, MetonaSqlark, OPFSEngine, SelectStatement, Statement, StorageMode, Table, TableSchema, UpdateStatement, VERSION, api, create, api as default, parse, tokenize };
+export { AriaEngine, AriaEngineConfig, ColumnDef, DatabaseConfig, DeleteStatement, DiskEngine, FieldType, HybridEngine, IStorageEngine, IndexedDBEngine, InsertStatement, MeSqlark, MemoryEngine, MetonaSqlark, OPFSBackend, OPFSEngine, SelectStatement, Statement, StorageMode, Table, TableSchema, UpdateStatement, VERSION, api, create, api as default, parse, tokenize };