@yydb/light-db 0.0.0 → 0.0.10

package/dist/storage/opfs/OpfsStorageAdapter.js

@@ -0,0 +1,400 @@
+/**
+ * OPFS 存储适配器
+ *
+ * 默认持久化后端。优先使用 sync access handle（需 Worker 上下文），
+ * 主线程退化为 `createWritable` + `getFile`，两条路径共享同一套逻辑文件语义。
+ *
+ * 不把 OPFS 目录结构暴露给上层：上层只认识 `main` / `main.tmp` / `wal` / `shm`。
+ */
+import { LightDbError, LightDbErrorCodes } from '../../errors';
+import { STORAGE_FILES } from '../StorageAdapter';
+/** 逻辑文件在 OPFS 中的物理文件名 */
+const PHYSICAL_NAMES = {
+    main: 'main.snapshot',
+    'main.tmp': 'main.snapshot.tmp',
+    wal: 'wal.log',
+    shm: 'wal.index',
+};
+/**
+ * 判断当前宿主是否提供 OPFS
+ */
+export function isOpfsAvailable() {
+    const storage = globalThis.navigator?.storage;
+    return typeof storage?.getDirectory === 'function';
+}
+/**
+ * OPFS 适配器工厂
+ */
+export class OpfsStorageAdapterFactory {
+    /** 适配器类型 */
+    kind = 'opfs';
+    /** 数据持久化 */
+    persistent = true;
+    root = null;
+    /**
+     * 打开数据库适配器
+     * @param name 数据库名
+     */
+    async openDatabase(name) {
+        const root = await this.getRoot();
+        const directory = await this.getDirectory(root, encodeURIComponent(name), 'openDatabase');
+        return new OpfsStorageAdapter(name, directory);
+    }
+    /**
+     * 取得 OPFS 根目录
+     */
+    async getRoot() {
+        const storage = globalThis.navigator?.storage;
+        if (!storage) {
+            throw new LightDbError(LightDbErrorCodes.unsupported, 'OPFS is not available in this environment', {
+                operation: 'openDatabase',
+            });
+        }
+        if (!this.root) {
+            this.root = storage.getDirectory();
+        }
+        try {
+            return await this.root;
+        }
+        catch (error) {
+            this.root = null;
+            throw new LightDbError(LightDbErrorCodes.io, 'failed to open the OPFS root directory', {
+                operation: 'openDatabase',
+                cause: error,
+            });
+        }
+    }
+    /**
+     * 取得或创建目录
+     * @param parent 父目录
+     * @param name 目录名
+     * @param operation 操作名
+     */
+    async getDirectory(parent, name, operation) {
+        try {
+            return await parent.getDirectoryHandle(name, { create: true });
+        }
+        catch (error) {
+            throw new LightDbError(LightDbErrorCodes.io, `failed to open OPFS directory "${name}"`, {
+                operation,
+                cause: error,
+            });
+        }
+    }
+}
+/**
+ * OPFS 存储适配器
+ */
+export class OpfsStorageAdapter {
+    /** 适配器类型 */
+    kind = 'opfs';
+    /** 数据持久化 */
+    persistent = true;
+    name;
+    directory;
+    closed = false;
+    constructor(name, directory) {
+        this.name = name;
+        this.directory = directory;
+    }
+    /**
+     * 打开逻辑文件
+     * @param file 逻辑文件名
+     * @param mode 打开模式
+     */
+    async open(file, mode = 'readwrite') {
+        this.assertOpen('storageOpen');
+        const physical = PHYSICAL_NAMES[file];
+        let handle;
+        try {
+            handle = await this.directory.getFileHandle(physical, { create: mode === 'readwrite' });
+        }
+        catch (error) {
+            throw new LightDbError(LightDbErrorCodes.io, `failed to open OPFS file "${physical}"`, {
+                operation: 'storageOpen',
+                cause: error,
+            });
+        }
+        return new OpfsStorageHandle(physical, handle);
+    }
+    /**
+     * 判断文件是否存在
+     * @param file 逻辑文件名
+     */
+    async exists(file) {
+        this.assertOpen('storageExists');
+        try {
+            await this.directory.getFileHandle(PHYSICAL_NAMES[file]);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * 删除文件
+     * @param file 逻辑文件名
+     */
+    async delete(file) {
+        this.assertOpen('storageDelete');
+        try {
+            await this.directory.removeEntry(PHYSICAL_NAMES[file]);
+        }
+        catch (error) {
+            if (isNotFound(error)) {
+                return;
+            }
+            throw new LightDbError(LightDbErrorCodes.io, `failed to delete OPFS file "${PHYSICAL_NAMES[file]}"`, {
+                operation: 'storageDelete',
+                cause: error,
+            });
+        }
+    }
+    /**
+     * 发布快照：优先 `move`，否则复制后删除
+     * @param from 源文件
+     * @param to 目标文件
+     */
+    async rename(from, to) {
+        this.assertOpen('storageRename');
+        const fromName = PHYSICAL_NAMES[from];
+        const toName = PHYSICAL_NAMES[to];
+        try {
+            const source = await this.directory.getFileHandle(fromName);
+            if (typeof source.move === 'function') {
+                try {
+                    await source.move(toName);
+                    return;
+                }
+                catch {
+                    // 宿主声明了 `move` 但拒绝执行（目标已存在或上下文受限），退回复制路径
+                }
+            }
+        }
+        catch (error) {
+            if (!isNotFound(error)) {
+                throw new LightDbError(LightDbErrorCodes.io, `failed to rename OPFS file "${fromName}"`, {
+                    operation: 'storageRename',
+                    cause: error,
+                });
+            }
+        }
+        const data = await this.readAll(from);
+        const target = await this.open(to, 'readwrite');
+        try {
+            await target.truncate(0);
+            await target.write(0, data);
+            await target.sync();
+        }
+        finally {
+            await target.close();
+        }
+        await this.delete(from);
+    }
+    /**
+     * 列出已存在的文件
+     */
+    async list() {
+        this.assertOpen('storageList');
+        const present = [];
+        for (const file of STORAGE_FILES) {
+            if (await this.exists(file)) {
+                present.push(file);
+            }
+        }
+        return present;
+    }
+    /** 关闭适配器 */
+    async close() {
+        this.closed = true;
+    }
+    /**
+     * 读取逻辑文件全部内容
+     * @param file 逻辑文件名
+     */
+    async readAll(file) {
+        const handle = await this.open(file, 'read');
+        try {
+            return await handle.read(0, await handle.size());
+        }
+        finally {
+            await handle.close();
+        }
+    }
+    /**
+     * 断言适配器未关闭
+     * @param operation 操作名
+     */
+    assertOpen(operation) {
+        if (this.closed) {
+            throw new LightDbError(LightDbErrorCodes.sessionClosed, `OPFS database "${this.name}" is closed`, {
+                operation,
+            });
+        }
+    }
+}
+/**
+ * OPFS 文件句柄
+ */
+class OpfsStorageHandle {
+    physical;
+    handle;
+    syncHandle = null;
+    syncProbed = false;
+    closed = false;
+    constructor(physical, handle) {
+        this.physical = physical;
+        this.handle = handle;
+    }
+    /**
+     * 读取指定区间
+     * @param position 起始位置
+     * @param length 期望长度
+     */
+    async read(position, length) {
+        this.assertOpen('read');
+        if (length <= 0) {
+            return new Uint8Array(0);
+        }
+        const sync = await this.getSyncHandle();
+        if (sync) {
+            const buffer = new Uint8Array(length);
+            const bytesRead = sync.read(buffer, { at: position });
+            return buffer.subarray(0, bytesRead);
+        }
+        const file = await this.handle.getFile();
+        const data = new Uint8Array(await file.arrayBuffer());
+        if (position >= data.length) {
+            return new Uint8Array(0);
+        }
+        return data.subarray(position, Math.min(position + length, data.length));
+    }
+    /**
+     * 写入指定位置
+     * @param position 起始位置
+     * @param data 数据
+     */
+    async write(position, data) {
+        this.assertOpen('write');
+        const sync = await this.getSyncHandle();
+        if (sync) {
+            sync.write(data, { at: position });
+            return;
+        }
+        await this.withWritable(async (writable) => {
+            await writable.write({ type: 'write', position, data });
+        }, 'write');
+    }
+    /**
+     * 截断文件
+     * @param size 目标大小
+     */
+    async truncate(size) {
+        this.assertOpen('truncate');
+        const sync = await this.getSyncHandle();
+        if (sync) {
+            sync.truncate(size);
+            return;
+        }
+        await this.withWritable(async (writable) => {
+            await writable.truncate(size);
+        }, 'truncate');
+    }
+    /** 落盘 */
+    async sync() {
+        this.assertOpen('sync');
+        if (this.syncHandle) {
+            this.syncHandle.flush();
+        }
+        // `createWritable` 路径每次写入都会 close 提交，无需额外 flush。
+    }
+    /** 当前文件大小 */
+    async size() {
+        this.assertOpen('size');
+        if (this.syncHandle) {
+            return this.syncHandle.getSize();
+        }
+        const file = await this.handle.getFile();
+        return file.size;
+    }
+    /** 关闭句柄 */
+    async close() {
+        if (this.closed) {
+            return;
+        }
+        this.closed = true;
+        if (this.syncHandle) {
+            this.syncHandle.close();
+            this.syncHandle = null;
+        }
+    }
+    /**
+     * 尝试取得同步访问句柄
+     *
+     * 主线程没有 `createSyncAccessHandle` 或调用被拒绝时返回 null，退化到可写流。
+     */
+    async getSyncHandle() {
+        if (this.syncHandle) {
+            return this.syncHandle;
+        }
+        if (this.syncProbed || typeof this.handle.createSyncAccessHandle !== 'function') {
+            return null;
+        }
+        this.syncProbed = true;
+        try {
+            this.syncHandle = await this.handle.createSyncAccessHandle();
+            return this.syncHandle;
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * 使用可写流执行一次提交
+     * @param action 写入动作
+     * @param operation 操作名
+     */
+    async withWritable(action, operation) {
+        let writable;
+        try {
+            writable = await this.handle.createWritable({ keepExistingData: true });
+        }
+        catch (error) {
+            throw new LightDbError(LightDbErrorCodes.io, `failed to open OPFS writable "${this.physical}"`, {
+                operation,
+                cause: error,
+            });
+        }
+        try {
+            await action(writable);
+        }
+        catch (error) {
+            throw new LightDbError(LightDbErrorCodes.io, `failed to write OPFS file "${this.physical}"`, {
+                operation,
+                cause: error,
+            });
+        }
+        finally {
+            await writable.close();
+        }
+    }
+    /**
+     * 断言句柄未关闭
+     * @param operation 操作名
+     */
+    assertOpen(operation) {
+        if (this.closed) {
+            throw new LightDbError(LightDbErrorCodes.sessionClosed, `OPFS handle "${this.physical}" is closed`, {
+                operation,
+            });
+        }
+    }
+}
+/**
+ * 判断是否为「文件不存在」错误
+ * @param error 错误
+ */
+function isNotFound(error) {
+    return typeof error === 'object' && error !== null && error.name === 'NotFoundError';
+}
+//# sourceMappingURL=OpfsStorageAdapter.js.map

package/dist/storage/opfs/OpfsStorageAdapter.js.map

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

package/package.json

@@ -1,37 +1,49 @@
 {
-    "name": "@yydb/light-db",
-    "version": "0.0.0",
-    "description": "LightDB Storage Engine - A high-performance TypeScript database storage layer",
-    "main": "dist/index.js",
-    "types": "dist/index.d.ts",
-    "files": [
-        "dist"
-    ],
-    "scripts": {
-        "build": "tsc",
-        "typecheck": "tsc --noEmit"
-    },
-    "keywords": [
-        "database",
-        "storage-engine",
-        "wal",
-        "typescript"
-    ],
-    "license": "MPL-2.0",
-    "engines": {
-        "node": ">=14.0.0"
-    },
-    "author": "LightDB Team",
-    "repository": {
-        "type": "git",
-        "url": "https://github.com/yy-database/LightDB.ts.git",
-        "directory": "projects/light-db"
-    },
-    "publishConfig": {
-        "access": "public"
-    },
-    "devDependencies": {
-        "@types/node": "^20.10.0",
-        "typescript": "^5.3.0"
-    }
-}
+  "name": "@yydb/light-db",
+  "version": "0.0.10",
+  "description": "Light DB — browser-native YYDB database written in pure TypeScript",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit",
+    "test": "tsx tests/index.ts",
+    "test:browser": "tsx tests/browser/run.ts"
+  },
+  "keywords": [
+    "yydb",
+    "light-db",
+    "database",
+    "browser",
+    "opfs",
+    "wal",
+    "typescript"
+  ],
+  "license": "MPL-2.0",
+  "author": "YYDB Contributors",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/yy-database/yydb.git",
+    "directory": "projects/packages/light-db"
+  },
+  "homepage": "https://github.com/yy-database/yydb/tree/dev/projects/packages/light-db#readme",
+  "bugs": {
+    "url": "https://github.com/yy-database/yydb/issues"
+  },
+  "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": "workspace:*"
+  }
+}