@yydb/light-db 0.0.0 → 0.0.11

package/dist/storage/indexeddb/IndexedDbStorageAdapter.js

@@ -0,0 +1,403 @@
+/**
+ * IndexedDB 存储适配器
+ *
+ * 兼容后端：宿主没有 OPFS，或需要在同一浏览器配置里复用既有存储时使用。
+ * 它只实现 `StorageAdapter` 合同，事务、恢复与检查点语义仍由 `core` 决定，
+ * 两套后端不各自实现一套数据库语义。
+ *
+ * IndexedDB 没有按位置随机写的原生能力，因此句柄在内存中维护整份文件内容，
+ * `sync()` 与 `close()` 负责把它写回对象仓库。这牺牲了 OPFS 那样的细粒度
+ * 原子性，属于兼容后端的已知取舍。
+ */
+import { LightDbError, LightDbErrorCodes } from '../../errors';
+import { STORAGE_FILES } from '../StorageAdapter';
+/** 对象仓库名 */
+const STORE_NAME = 'files';
+/** IndexedDB 数据库版本 */
+const DB_VERSION = 1;
+/** 数据库名前缀，避免与宿主自己的对象仓库冲突 */
+const DATABASE_PREFIX = 'yydb:light:';
+/**
+ * 判断当前宿主是否提供 IndexedDB
+ */
+export function isIndexedDbAvailable() {
+    const factory = globalThis.indexedDB;
+    return typeof factory?.open === 'function';
+}
+/**
+ * IndexedDB 适配器工厂
+ */
+export class IndexedDbStorageAdapterFactory {
+    /** 适配器类型 */
+    kind = 'indexeddb';
+    /** 数据持久化 */
+    persistent = true;
+    /**
+     * 打开数据库适配器
+     * @param name 数据库名
+     */
+    async openDatabase(name) {
+        const database = await openIdbDatabase(`${DATABASE_PREFIX}${name}`, 'openDatabase');
+        return new IndexedDbStorageAdapter(name, database);
+    }
+}
+/**
+ * IndexedDB 存储适配器
+ */
+export class IndexedDbStorageAdapter {
+    /** 适配器类型 */
+    kind = 'indexeddb';
+    /** 数据持久化 */
+    persistent = true;
+    name;
+    db;
+    closed = false;
+    constructor(name, db) {
+        this.name = name;
+        this.db = db;
+    }
+    /**
+     * 打开逻辑文件
+     * @param file 逻辑文件名
+     * @param mode 打开模式
+     */
+    async open(file, mode = 'readwrite') {
+        this.assertOpen('storageOpen');
+        const data = await this.readFile(file);
+        if (data === null && mode === 'read') {
+            throw new LightDbError(LightDbErrorCodes.io, `storage file "${file}" does not exist in "${this.name}"`, {
+                operation: 'storageOpen',
+            });
+        }
+        return new IndexedDbStorageHandle(this, file, data ?? new Uint8Array(0), mode === 'read');
+    }
+    /**
+     * 判断文件是否存在
+     * @param file 逻辑文件名
+     */
+    async exists(file) {
+        this.assertOpen('storageExists');
+        return (await this.readFile(file)) !== null;
+    }
+    /**
+     * 删除文件，不存在时视为成功
+     * @param file 逻辑文件名
+     */
+    async delete(file) {
+        this.assertOpen('storageDelete');
+        await this.writeTransaction('storageDelete', (store) => {
+            store.delete(file);
+        });
+    }
+    /**
+     * 原子重命名：同一事务内写入目标并删除源
+     * @param from 源文件
+     * @param to 目标文件
+     */
+    async rename(from, to) {
+        this.assertOpen('storageRename');
+        const data = await this.readFile(from);
+        if (data === null) {
+            throw new LightDbError(LightDbErrorCodes.io, `cannot rename missing storage file "${from}"`, {
+                operation: 'storageRename',
+            });
+        }
+        await this.writeTransaction('storageRename', (store) => {
+            store.put(toArrayBuffer(data), to);
+            store.delete(from);
+        });
+    }
+    /**
+     * 列出已存在的文件
+     */
+    async list() {
+        this.assertOpen('storageList');
+        const keys = await this.readTransaction('storageList', (store) => requestResult(store.getAllKeys(), 'storageList', `failed to list IndexedDB database "${this.name}"`));
+        return STORAGE_FILES.filter((file) => keys.includes(file));
+    }
+    /** 关闭适配器 */
+    async close() {
+        if (this.closed) {
+            return;
+        }
+        this.closed = true;
+        try {
+            this.db.close();
+        }
+        catch (error) {
+            throw toStorageError(error, 'storageClose', `failed to close IndexedDB database "${this.name}"`);
+        }
+    }
+    /**
+     * 写回逻辑文件内容
+     * @param file 逻辑文件名
+     * @param data 文件内容
+     */
+    async persist(file, data) {
+        this.assertOpen('write');
+        await this.writeTransaction('write', (store) => {
+            store.put(toArrayBuffer(data), file);
+        });
+    }
+    /**
+     * 读取逻辑文件内容
+     * @param file 逻辑文件名
+     * @returns 内容，文件不存在时返回 null
+     */
+    readFile(file) {
+        return this.readTransaction('read', async (store) => {
+            const buffer = await requestResult(store.get(file), 'read', `failed to read storage file "${file}"`);
+            return buffer === undefined ? null : new Uint8Array(buffer);
+        });
+    }
+    /**
+     * 执行只读事务
+     * @param operation 操作名
+     * @param action 请求构造
+     */
+    async readTransaction(operation, action) {
+        const tx = this.beginTransaction('readonly', operation);
+        const done = awaitTransaction(tx, operation, `IndexedDB transaction failed for "${this.name}"`);
+        const result = await action(tx.objectStore(STORE_NAME));
+        await done;
+        return result;
+    }
+    /**
+     * 执行读写事务
+     * @param operation 操作名
+     * @param action 请求构造
+     */
+    async writeTransaction(operation, action) {
+        const tx = this.beginTransaction('readwrite', operation);
+        const done = awaitTransaction(tx, operation, `IndexedDB transaction failed for "${this.name}"`);
+        try {
+            action(tx.objectStore(STORE_NAME));
+        }
+        catch (error) {
+            try {
+                tx.abort();
+            }
+            catch {
+                // 事务已经结束，保留原始错误
+            }
+            await done.catch(() => undefined);
+            throw toStorageError(error, operation, `failed to write IndexedDB database "${this.name}"`);
+        }
+        await done;
+    }
+    /**
+     * 创建事务
+     * @param mode 事务模式
+     * @param operation 操作名
+     */
+    beginTransaction(mode, operation) {
+        try {
+            return this.db.transaction(STORE_NAME, mode);
+        }
+        catch (error) {
+            throw toStorageError(error, operation, `failed to start IndexedDB transaction for "${this.name}"`);
+        }
+    }
+    /**
+     * 断言适配器未关闭
+     * @param operation 操作名
+     */
+    assertOpen(operation) {
+        if (this.closed) {
+            throw new LightDbError(LightDbErrorCodes.sessionClosed, `IndexedDB database "${this.name}" is closed`, {
+                operation,
+            });
+        }
+    }
+}
+/**
+ * IndexedDB 文件句柄
+ *
+ * 内容常驻内存，`sync()` 与 `close()` 写回对象仓库。
+ */
+class IndexedDbStorageHandle {
+    adapter;
+    file;
+    readOnly;
+    data;
+    dirty = false;
+    closed = false;
+    constructor(adapter, file, data, readOnly) {
+        this.adapter = adapter;
+        this.file = file;
+        this.data = data;
+        this.readOnly = readOnly;
+    }
+    /**
+     * 读取指定区间
+     * @param position 起始位置
+     * @param length 期望长度
+     */
+    async read(position, length) {
+        this.assertOpen('read');
+        if (position >= this.data.length || length <= 0) {
+            return new Uint8Array(0);
+        }
+        return this.data.slice(position, Math.min(position + length, this.data.length));
+    }
+    /**
+     * 写入指定位置
+     * @param position 起始位置
+     * @param data 数据
+     */
+    async write(position, data) {
+        this.assertOpen('write');
+        const required = position + data.length;
+        if (this.data.length < required) {
+            const next = new Uint8Array(required);
+            next.set(this.data, 0);
+            this.data = next;
+        }
+        this.data.set(data, position);
+        this.dirty = true;
+    }
+    /**
+     * 截断文件
+     * @param size 目标大小
+     */
+    async truncate(size) {
+        this.assertOpen('truncate');
+        if (size <= this.data.length) {
+            this.data = this.data.slice(0, size);
+        }
+        else {
+            const next = new Uint8Array(size);
+            next.set(this.data, 0);
+            this.data = next;
+        }
+        this.dirty = true;
+    }
+    /** 写回对象仓库 */
+    async sync() {
+        this.assertOpen('sync');
+        if (!this.dirty || this.readOnly) {
+            return;
+        }
+        await this.adapter.persist(this.file, this.data);
+        this.dirty = false;
+    }
+    /** 当前文件大小 */
+    async size() {
+        this.assertOpen('size');
+        return this.data.length;
+    }
+    /** 关闭句柄 */
+    async close() {
+        if (this.closed) {
+            return;
+        }
+        await this.sync();
+        this.closed = true;
+    }
+    /**
+     * 断言句柄未关闭
+     * @param operation 操作名
+     */
+    assertOpen(operation) {
+        if (this.closed) {
+            throw new LightDbError(LightDbErrorCodes.sessionClosed, `IndexedDB handle for "${this.file}" is closed`, {
+                operation,
+            });
+        }
+    }
+}
+/**
+ * 打开 IndexedDB 数据库
+ * @param name 物理数据库名
+ * @param operation 操作名
+ */
+function openIdbDatabase(name, operation) {
+    return new Promise((resolve, reject) => {
+        const factory = globalThis.indexedDB;
+        if (!factory) {
+            reject(new LightDbError(LightDbErrorCodes.unsupported, 'IndexedDB is not available in this environment', {
+                operation,
+            }));
+            return;
+        }
+        let request;
+        try {
+            request = factory.open(name, DB_VERSION);
+        }
+        catch (error) {
+            reject(toStorageError(error, operation, `failed to open IndexedDB database "${name}"`));
+            return;
+        }
+        request.onupgradeneeded = () => {
+            const database = request.result;
+            if (!database.objectStoreNames.contains(STORE_NAME)) {
+                database.createObjectStore(STORE_NAME);
+            }
+        };
+        request.onsuccess = () => {
+            resolve(request.result);
+        };
+        request.onerror = () => {
+            reject(toStorageError(request.error, operation, `failed to open IndexedDB database "${name}"`));
+        };
+        request.onblocked = () => {
+            reject(new LightDbError(LightDbErrorCodes.io, `IndexedDB database "${name}" is blocked by another connection`, {
+                operation,
+            }));
+        };
+    });
+}
+/**
+ * 等待请求完成
+ * @param request 请求
+ * @param operation 操作名
+ * @param message 失败描述
+ */
+function requestResult(request, operation, message) {
+    return new Promise((resolve, reject) => {
+        request.onsuccess = () => {
+            resolve(request.result);
+        };
+        request.onerror = () => {
+            reject(toStorageError(request.error, operation, message));
+        };
+    });
+}
+/**
+ * 等待事务提交
+ * @param tx 事务
+ * @param operation 操作名
+ * @param message 失败描述
+ */
+function awaitTransaction(tx, operation, message) {
+    return new Promise((resolve, reject) => {
+        tx.oncomplete = () => {
+            resolve();
+        };
+        tx.onerror = () => {
+            reject(toStorageError(tx.error, operation, message));
+        };
+        tx.onabort = () => {
+            reject(toStorageError(tx.error, operation, message));
+        };
+    });
+}
+/**
+ * 复制为独立的 `ArrayBuffer`
+ * @param data 数据
+ */
+function toArrayBuffer(data) {
+    return data.slice().buffer;
+}
+/**
+ * 转换为稳定存储错误
+ * @param error 原始错误
+ * @param operation 操作名
+ * @param message 失败描述
+ */
+function toStorageError(error, operation, message) {
+    const name = typeof error === 'object' && error !== null ? error.name : undefined;
+    const code = name === 'QuotaExceededError' ? LightDbErrorCodes.quotaExceeded : LightDbErrorCodes.io;
+    return new LightDbError(code, message, { operation, cause: error });
+}
+//# sourceMappingURL=IndexedDbStorageAdapter.js.map

package/dist/storage/indexeddb/IndexedDbStorageAdapter.js.map

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

package/dist/storage/memory/MemoryStorageAdapter.d.ts

@@ -0,0 +1,76 @@
+/**
+ * 内存存储适配器
+ *
+ * 用于测试、无持久化需求的一次性会话，以及适配器合同的参考实现。
+ */
+import type { StorageAdapter, StorageAdapterFactory, StorageFile, StorageHandle, StorageOpenMode } from '../StorageAdapter';
+/** 单个数据库的内存目录 */
+type MemoryDirectory = Map<StorageFile, Uint8Array>;
+/**
+ * 内存存储后端
+ *
+ * 只有共用同一个后端实例才能跨 `openDatabase` 读到上一会话的数据，
+ * 测试据此模拟「关闭后重开」。
+ */
+export declare class MemoryStorageBackend implements StorageAdapterFactory {
+    /** 适配器类型 */
+    readonly kind: "memory";
+    /** 会话结束后数据不保留 */
+    readonly persistent = false;
+    private readonly directories;
+    /**
+     * 打开数据库适配器
+     * @param name 数据库名
+     */
+    openDatabase(name: string): Promise<StorageAdapter>;
+    /** 清空所有数据库 */
+    reset(): void;
+}
+/**
+ * 内存存储适配器
+ */
+export declare class MemoryStorageAdapter implements StorageAdapter {
+    /** 适配器类型 */
+    readonly kind: "memory";
+    /** 会话结束后数据不保留 */
+    readonly persistent = false;
+    private readonly name;
+    private readonly directory;
+    private closed;
+    constructor(name: string, directory: MemoryDirectory);
+    /**
+     * 打开逻辑文件
+     * @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 operation 操作名
+     */
+    private assertOpen;
+}
+export {};
+//# sourceMappingURL=MemoryStorageAdapter.d.ts.map

package/dist/storage/memory/MemoryStorageAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MemoryStorageAdapter.d.ts","sourceRoot":"","sources":["../../../src/storage/memory/MemoryStorageAdapter.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,qBAAqB,EAAE,WAAW,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAG5H,iBAAiB;AACjB,KAAK,eAAe,GAAG,GAAG,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC;AAEpD;;;;;GAKG;AACH,qBAAa,oBAAqB,YAAW,qBAAqB;IAC9D,YAAY;IACZ,SAAgB,IAAI,WAAqB;IAEzC,iBAAiB;IACjB,SAAgB,UAAU,SAAS;IAEnC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA2C;IAEvE;;;OAGG;IACU,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAShE,cAAc;IACP,KAAK,IAAI,IAAI;CAGvB;AAED;;GAEG;AACH,qBAAa,oBAAqB,YAAW,cAAc;IACvD,YAAY;IACZ,SAAgB,IAAI,WAAqB;IAEzC,iBAAiB;IACjB,SAAgB,UAAU,SAAS;IAEnC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAkB;IAC5C,OAAO,CAAC,MAAM,CAAkB;gBAEpB,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,eAAe;IAKpD;;;;OAIG;IACU,IAAI,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,GAAE,eAA6B,GAAG,OAAO,CAAC,aAAa,CAAC;IAiBjG;;;OAGG;IACU,MAAM,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC;IAKxD;;;OAGG;IACU,MAAM,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAKrD;;;;OAIG;IACU,MAAM,CAAC,IAAI,EAAE,WAAW,EAAE,EAAE,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAYtE;;OAEG;IACU,IAAI,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;IAK3C,YAAY;IACC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAInC;;;OAGG;IACH,OAAO,CAAC,UAAU;CAKrB"}