@yydb/light-db 0.0.0

package/dist/utils/file.js

@@ -0,0 +1,346 @@
+"use strict";
+/**
+ * 文件操作工具类
+ * 提供文件系统操作的封装
+ */
+var __createBinding =
+    (this && this.__createBinding) ||
+    (Object.create
+        ? function (o, m, k, k2) {
+              if (k2 === undefined) k2 = k;
+              var desc = Object.getOwnPropertyDescriptor(m, k);
+              if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+                  desc = {
+                      enumerable: true,
+                      get: function () {
+                          return m[k];
+                      },
+                  };
+              }
+              Object.defineProperty(o, k2, desc);
+          }
+        : function (o, m, k, k2) {
+              if (k2 === undefined) k2 = k;
+              o[k2] = m[k];
+          });
+var __setModuleDefault =
+    (this && this.__setModuleDefault) ||
+    (Object.create
+        ? function (o, v) {
+              Object.defineProperty(o, "default", { enumerable: true, value: v });
+          }
+        : function (o, v) {
+              o["default"] = v;
+          });
+var __importStar =
+    (this && this.__importStar) ||
+    (function () {
+        var ownKeys = function (o) {
+            ownKeys =
+                Object.getOwnPropertyNames ||
+                function (o) {
+                    var ar = [];
+                    for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+                    return ar;
+                };
+            return ownKeys(o);
+        };
+        return function (mod) {
+            if (mod && mod.__esModule) return mod;
+            var result = {};
+            if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+            __setModuleDefault(result, mod);
+            return result;
+        };
+    })();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FileHandleWrapper = exports.FileUtils = void 0;
+const fs_1 = require("fs");
+const path = __importStar(require("path"));
+const errors_1 = require("../errors");
+/**
+ * 文件操作工具类
+ * 提供静态方法用于文件系统操作
+ */
+class FileUtils {
+    /**
+     * 检查文件是否存在
+     * @param filePath 文件路径
+     */
+    static async exists(filePath) {
+        try {
+            await fs_1.promises.access(filePath);
+            return true;
+        } catch {
+            return false;
+        }
+    }
+    /**
+     * 确保目录存在，不存在则创建
+     * @param dirPath 目录路径
+     */
+    static async ensureDir(dirPath) {
+        try {
+            await fs_1.promises.mkdir(dirPath, { recursive: true });
+        } catch (error) {
+            const err = error;
+            if (err.code !== "EEXIST") {
+                throw new errors_1.FileOperationError(`Failed to create directory: ${dirPath}`, dirPath, "mkdir");
+            }
+        }
+    }
+    /**
+     * 读取文件内容
+     * @param filePath 文件路径
+     */
+    static async readFile(filePath) {
+        try {
+            return await fs_1.promises.readFile(filePath);
+        } catch (error) {
+            throw new errors_1.FileOperationError(`Failed to read file: ${filePath}`, filePath, "read");
+        }
+    }
+    /**
+     * 写入文件内容
+     * @param filePath 文件路径
+     * @param data 文件内容
+     */
+    static async writeFile(filePath, data) {
+        try {
+            await fs_1.promises.writeFile(filePath, data);
+        } catch (error) {
+            throw new errors_1.FileOperationError(`Failed to write file: ${filePath}`, filePath, "write");
+        }
+    }
+    /**
+     * 追加写入文件
+     * @param filePath 文件路径
+     * @param data 要追加的数据
+     */
+    static async appendFile(filePath, data) {
+        try {
+            await fs_1.promises.appendFile(filePath, data);
+        } catch (error) {
+            throw new errors_1.FileOperationError(`Failed to append to file: ${filePath}`, filePath, "append");
+        }
+    }
+    /**
+     * 删除文件
+     * @param filePath 文件路径
+     */
+    static async deleteFile(filePath) {
+        try {
+            await fs_1.promises.unlink(filePath);
+        } catch (error) {
+            const err = error;
+            if (err.code !== "ENOENT") {
+                throw new errors_1.FileOperationError(`Failed to delete file: ${filePath}`, filePath, "delete");
+            }
+        }
+    }
+    /**
+     * 原子性重命名文件
+     * @param oldPath 原文件路径
+     * @param newPath 新文件路径
+     */
+    static async rename(oldPath, newPath) {
+        try {
+            await fs_1.promises.rename(oldPath, newPath);
+        } catch (error) {
+            throw new errors_1.FileOperationError(`Failed to rename file from ${oldPath} to ${newPath}`, oldPath, "rename");
+        }
+    }
+    /**
+     * 获取文件大小
+     * @param filePath 文件路径
+     */
+    static async getFileSize(filePath) {
+        try {
+            const stats = await fs_1.promises.stat(filePath);
+            return stats.size;
+        } catch (error) {
+            throw new errors_1.FileOperationError(`Failed to get file size: ${filePath}`, filePath, "stat");
+        }
+    }
+    /**
+     * 同步文件到磁盘
+     * @param filePath 文件路径
+     */
+    static async syncFile(filePath) {
+        let handle = null;
+        try {
+            handle = await fs_1.promises.open(filePath, "r+");
+            await handle.sync();
+        } catch (error) {
+            throw new errors_1.FileOperationError(`Failed to sync file: ${filePath}`, filePath, "sync");
+        } finally {
+            if (handle) {
+                await handle.close();
+            }
+        }
+    }
+    /**
+     * 打开文件句柄
+     * @param filePath 文件路径
+     * @param flags 打开标志
+     */
+    static async openFile(filePath, flags) {
+        try {
+            return await fs_1.promises.open(filePath, flags);
+        } catch (error) {
+            throw new errors_1.FileOperationError(`Failed to open file: ${filePath}`, filePath, "open");
+        }
+    }
+    /**
+     * 从指定位置读取文件
+     * @param handle 文件句柄
+     * @param buffer 目标缓冲区
+     * @param offset 缓冲区偏移
+     * @param length 读取长度
+     * @param position 文件位置
+     */
+    static async readFromPosition(handle, buffer, offset, length, position) {
+        const result = await handle.read(buffer, offset, length, position);
+        return result.bytesRead;
+    }
+    /**
+     * 在指定位置写入文件
+     * @param handle 文件句柄
+     * @param buffer 源缓冲区
+     * @param offset 缓冲区偏移
+     * @param length 写入长度
+     * @param position 文件位置
+     */
+    static async writeToPosition(handle, buffer, offset, length, position) {
+        const result = await handle.write(buffer, offset, length, position);
+        return result.bytesWritten;
+    }
+    /**
+     * 截断文件到指定大小
+     * @param filePath 文件路径
+     * @param size 目标大小
+     */
+    static async truncateFile(filePath, size) {
+        try {
+            await fs_1.promises.truncate(filePath, size);
+        } catch (error) {
+            throw new errors_1.FileOperationError(`Failed to truncate file: ${filePath}`, filePath, "truncate");
+        }
+    }
+    /**
+     * 构建完整文件路径
+     * @param basePath 基础路径
+     * @param name 文件名（不含扩展名）
+     * @param extension 文件扩展名
+     */
+    static buildFilePath(basePath, name, extension) {
+        return path.join(basePath, name + extension);
+    }
+    /**
+     * 解析文件名（不含扩展名）
+     * @param filePath 文件路径
+     */
+    static getFileName(filePath) {
+        const basename = path.basename(filePath);
+        const ext = path.extname(basename);
+        return basename.slice(0, basename.length - ext.length);
+    }
+    /**
+     * 获取目录路径
+     * @param filePath 文件路径
+     */
+    static getDirPath(filePath) {
+        return path.dirname(filePath);
+    }
+}
+exports.FileUtils = FileUtils;
+/**
+ * 文件句柄包装类
+ * 提供更高级的文件操作接口
+ */
+class FileHandleWrapper {
+    /**
+     * 创建文件句柄包装
+     * @param filePath 文件路径
+     * @param flags 打开标志
+     */
+    constructor(filePath, flags) {
+        this.handle = null;
+        this.filePath = filePath;
+        this.flags = flags;
+    }
+    /**
+     * 打开文件
+     */
+    async open() {
+        this.handle = await FileUtils.openFile(this.filePath, this.flags);
+    }
+    /**
+     * 关闭文件
+     */
+    async close() {
+        if (this.handle) {
+            await this.handle.close();
+            this.handle = null;
+        }
+    }
+    /**
+     * 确保文件已打开
+     */
+    ensureOpen() {
+        if (!this.handle) {
+            throw new errors_1.FileOperationError("File handle is not open", this.filePath, "ensureOpen");
+        }
+    }
+    /**
+     * 读取数据
+     * @param buffer 目标缓冲区
+     * @param offset 缓冲区偏移
+     * @param length 读取长度
+     * @param position 文件位置
+     */
+    async read(buffer, offset, length, position) {
+        this.ensureOpen();
+        return FileUtils.readFromPosition(this.handle, buffer, offset, length, position);
+    }
+    /**
+     * 写入数据
+     * @param buffer 源缓冲区
+     * @param offset 缓冲区偏移
+     * @param length 写入长度
+     * @param position 文件位置
+     */
+    async write(buffer, offset, length, position) {
+        this.ensureOpen();
+        return FileUtils.writeToPosition(this.handle, buffer, offset, length, position);
+    }
+    /**
+     * 同步到磁盘
+     */
+    async sync() {
+        this.ensureOpen();
+        await this.handle.sync();
+    }
+    /**
+     * 获取文件大小
+     */
+    async size() {
+        this.ensureOpen();
+        const stats = await this.handle.stat();
+        return stats.size;
+    }
+    /**
+     * 获取文件路径
+     */
+    get path() {
+        return this.filePath;
+    }
+    /**
+     * 检查是否已打开
+     */
+    get isOpen() {
+        return this.handle !== null;
+    }
+}
+exports.FileHandleWrapper = FileHandleWrapper;
+//# sourceMappingURL=file.js.map

package/dist/utils/file.js.map

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

package/dist/utils/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * 工具模块导出
+ */
+export { BinaryUtils, BufferWriter, BufferReader } from "./binary";
+export { FileUtils, FileHandleWrapper } from "./file";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACnE,OAAO,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,QAAQ,CAAC"}

package/dist/utils/index.js

@@ -0,0 +1,39 @@
+"use strict";
+/**
+ * 工具模块导出
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FileHandleWrapper = exports.FileUtils = exports.BufferReader = exports.BufferWriter = exports.BinaryUtils = void 0;
+var binary_1 = require("./binary");
+Object.defineProperty(exports, "BinaryUtils", {
+    enumerable: true,
+    get: function () {
+        return binary_1.BinaryUtils;
+    },
+});
+Object.defineProperty(exports, "BufferWriter", {
+    enumerable: true,
+    get: function () {
+        return binary_1.BufferWriter;
+    },
+});
+Object.defineProperty(exports, "BufferReader", {
+    enumerable: true,
+    get: function () {
+        return binary_1.BufferReader;
+    },
+});
+var file_1 = require("./file");
+Object.defineProperty(exports, "FileUtils", {
+    enumerable: true,
+    get: function () {
+        return file_1.FileUtils;
+    },
+});
+Object.defineProperty(exports, "FileHandleWrapper", {
+    enumerable: true,
+    get: function () {
+        return file_1.FileHandleWrapper;
+    },
+});
+//# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH,mCAAmE;AAA1D,qGAAA,WAAW,OAAA;AAAE,sGAAA,YAAY,OAAA;AAAE,sGAAA,YAAY,OAAA;AAChD,+BAAsD;AAA7C,iGAAA,SAAS,OAAA;AAAE,yGAAA,iBAAiB,OAAA"}

package/package.json

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

package/readme.md

@@ -0,0 +1,124 @@
+# LightDB Storage Engine 🚀
+
+A high-performance TypeScript database storage layer with WAL (Write-Ahead Logging), indexes, and transaction support.
+
+## Features ✨
+
+- **High Performance**: Optimized for speed with batch writing and columnar storage
+- **Transaction Support**: ACID-compliant operations
+- **Indexing**: B+ tree indexes for fast querying
+- **Write-Ahead Logging**: Ensures data durability
+- **Recovery**: Automatic recovery from crashes
+- **Memory-Mapped Files**: Efficient I/O operations
+- **TypeScript Ready**: Full TypeScript support with type definitions
+
+## Installation 📦
+
+```bash
+pnpm add @yydb/light-db
+```
+
+## Quick Start 🚀
+
+```typescript
+import { LightDB } from '@yydb/light-db';
+
+// Initialize the database
+const db = await LightDB.open('./mydb');
+
+// Create a collection
+const users = db.collection('users');
+
+// Insert a document
+await users.insert({ id: 1, name: 'John Doe', email: 'john@example.com' });
+
+// Find a document
+const user = await users.findOne({ id: 1 });
+console.log(user); // { id: 1, name: 'John Doe', email: 'john@example.com' }
+
+// Update a document
+await users.update({ id: 1 }, { $set: { name: 'John Smith' } });
+
+// Delete a document
+await users.delete({ id: 1 });
+
+// Close the database
+await db.close();
+```
+
+## API Reference 📚
+
+### LightDB Class
+
+#### `open(path: string): Promise<LightDB>`
+Opens an existing database or creates a new one at the specified path.
+
+#### `collection(name: string): Collection`
+Returns a collection with the given name. Creates it if it doesn't exist.
+
+#### `transaction(): Promise<Transaction>`
+Starts a new transaction.
+
+#### `close(): Promise<void>`
+Closes the database connection.
+
+### Collection Class
+
+#### `insert(document: Document): Promise<void>`
+Inserts a new document into the collection.
+
+#### `find(query: Query): Promise<Document[]>`
+Finds all documents matching the query.
+
+#### `findOne(query: Query): Promise<Document | null>`
+Finds the first document matching the query.
+
+#### `update(query: Query, update: Update): Promise<number>`
+Updates documents matching the query and returns the number of updated documents.
+
+#### `delete(query: Query): Promise<number>`
+Deletes documents matching the query and returns the number of deleted documents.
+
+#### `createIndex(field: string): Promise<void>`
+Creates an index on the specified field for faster queries.
+
+### Transaction Class
+
+#### `commit(): Promise<void>`
+Commits the transaction.
+
+#### `rollback(): Promise<void>`
+Rolls back the transaction.
+
+## Performance Features ⚡
+
+### Batch Writing
+LightDB uses batch writing to optimize disk I/O operations, significantly improving write performance for bulk operations.
+
+### Columnar Storage
+For certain data types, LightDB uses columnar storage to reduce disk space and improve query performance.
+
+### Memory-Mapped Files
+LightDB uses memory-mapped files for efficient I/O operations, reducing the overhead of traditional file I/O.
+
+## Architecture 🏗️
+
+LightDB consists of several key components:
+
+1. **Storage Engine**: Manages the physical storage of data
+2. **WAL (Write-Ahead Log)**: Ensures data durability and supports recovery
+3. **Index Manager**: Manages B+ tree indexes for fast querying
+4. **Collection Layer**: Provides a document-oriented API
+5. **Transaction Manager**: Handles ACID-compliant transactions
+
+## Recovery 🔄
+
+LightDB automatically recovers from crashes using the WAL. When the database is opened after a crash, it replays the WAL to restore the database to a consistent state.
+
+## Contributing 🤝
+
+Contributions are welcome! Please feel free to submit a Pull Request.
+
+## License 📄
+
+LightDB is licensed under the MPL-2.0 License. See the [LICENSE](LICENSE) file for details.