@yydb/light-db 0.0.0

package/dist/api/Transaction.js

@@ -0,0 +1,263 @@
+"use strict";
+/**
+ * LightDB 事务实现
+ * 提供 ACID 事务支持
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TransactionManager = exports.Transaction = exports.TransactionError = void 0;
+/**
+ * 事务错误类
+ */
+class TransactionError extends Error {
+    constructor(message, code) {
+        super(message);
+        this.name = "TransactionError";
+        this.code = code;
+        Object.setPrototypeOf(this, TransactionError.prototype);
+    }
+}
+exports.TransactionError = TransactionError;
+/**
+ * 事务集合包装器
+ * 提供事务内的集合操作
+ */
+class TransactionCollectionWrapper {
+    constructor(collection, transaction) {
+        this.collection = collection;
+        this.transaction = transaction;
+    }
+    async find(filter = {}) {
+        this.transaction.ensureActive();
+        return this.collection.find({
+            where: filter,
+        }).docs;
+    }
+    async findOne(filter) {
+        this.transaction.ensureActive();
+        return this.collection.findOne(filter);
+    }
+    async insert(doc) {
+        this.transaction.ensureActive();
+        const result = this.collection.insert(doc);
+        if (!result.success) {
+            throw new TransactionError("Failed to insert document in transaction", "INSERT_FAILED");
+        }
+        this.transaction.recordOperation("insert", this.collection.Name, doc);
+    }
+    async update(filter, update) {
+        this.transaction.ensureActive();
+        const result = this.collection.updateMany(filter, { $set: update });
+        this.transaction.recordOperation("update", this.collection.Name, {
+            filter,
+            update,
+            count: result.modifiedCount,
+        });
+        return result.modifiedCount;
+    }
+    async delete(filter) {
+        this.transaction.ensureActive();
+        const result = this.collection.deleteMany(filter);
+        this.transaction.recordOperation("delete", this.collection.Name, {
+            filter,
+            count: result.deletedCount,
+        });
+        return result.deletedCount;
+    }
+}
+/**
+ * 事务类
+ * 管理事务的生命周期和操作
+ */
+class Transaction {
+    constructor(collections, options) {
+        this.collections = collections;
+        this.options = {
+            timeout: options?.timeout ?? 5000,
+            isolationLevel: options?.isolationLevel ?? "read_committed",
+        };
+        this.state = "active";
+        this.operations = [];
+        this.startTime = Date.now();
+    }
+    /**
+     * 获取事务集合
+     */
+    collection(name) {
+        this.ensureActive();
+        const collection = this.collections.get(name);
+        if (!collection) {
+            throw new TransactionError(`Collection "${name}" not found`, "COLLECTION_NOT_FOUND");
+        }
+        return new TransactionCollectionWrapper(collection, this);
+    }
+    /**
+     * 确保事务处于活动状态
+     */
+    ensureActive() {
+        if (this.state !== "active") {
+            throw new TransactionError(`Transaction is not active (current state: ${this.state})`, "TRANSACTION_NOT_ACTIVE");
+        }
+        if (Date.now() - this.startTime > this.options.timeout) {
+            this.state = "failed";
+            throw new TransactionError("Transaction timed out", "TRANSACTION_TIMEOUT");
+        }
+    }
+    /**
+     * 记录操作
+     */
+    recordOperation(type, collectionName, data) {
+        this.operations.push({ type, collectionName, data });
+    }
+    /**
+     * 提交事务
+     */
+    commit() {
+        if (this.state !== "active") {
+            return {
+                success: false,
+                state: this.state,
+                durationMs: Date.now() - this.startTime,
+                error: `Cannot commit transaction in state: ${this.state}`,
+            };
+        }
+        try {
+            this.state = "committed";
+            return {
+                success: true,
+                state: "committed",
+                durationMs: Date.now() - this.startTime,
+            };
+        } catch (error) {
+            this.state = "failed";
+            return {
+                success: false,
+                state: "failed",
+                durationMs: Date.now() - this.startTime,
+                error: error instanceof Error ? error.message : "Unknown error",
+            };
+        }
+    }
+    /**
+     * 回滚事务
+     */
+    rollback() {
+        if (this.state !== "active") {
+            return {
+                success: false,
+                state: this.state,
+                durationMs: Date.now() - this.startTime,
+                error: `Cannot rollback transaction in state: ${this.state}`,
+            };
+        }
+        try {
+            for (let i = this.operations.length - 1; i >= 0; i--) {
+                const op = this.operations[i];
+                this.undoOperation(op);
+            }
+            this.state = "rolled_back";
+            return {
+                success: true,
+                state: "rolled_back",
+                durationMs: Date.now() - this.startTime,
+            };
+        } catch (error) {
+            this.state = "failed";
+            return {
+                success: false,
+                state: "failed",
+                durationMs: Date.now() - this.startTime,
+                error: error instanceof Error ? error.message : "Unknown error",
+            };
+        }
+    }
+    /**
+     * 撤销操作
+     */
+    undoOperation(op) {
+        const collection = this.collections.get(op.collectionName);
+        if (!collection) return;
+        switch (op.type) {
+            case "insert": {
+                const doc = op.data;
+                const primaryKey = collection.extractPrimaryKey(doc);
+                collection.deleteByPrimaryKey(primaryKey);
+                break;
+            }
+            case "delete": {
+                break;
+            }
+            case "update": {
+                break;
+            }
+        }
+    }
+    /**
+     * 获取事务状态
+     */
+    getState() {
+        return this.state;
+    }
+    /**
+     * 获取操作数量
+     */
+    getOperationCount() {
+        return this.operations.length;
+    }
+}
+exports.Transaction = Transaction;
+/**
+ * 事务管理器
+ * 管理多个并发事务
+ */
+class TransactionManager {
+    constructor(collections) {
+        this.collections = collections;
+        this.activeTransactions = new Map();
+        this.transactionCounter = 0;
+    }
+    /**
+     * 开始新事务
+     */
+    begin(options) {
+        const transaction = new Transaction(this.collections, options);
+        const txId = `tx_${++this.transactionCounter}`;
+        this.activeTransactions.set(txId, transaction);
+        return transaction;
+    }
+    /**
+     * 执行事务
+     */
+    async execute(callback, options) {
+        const transaction = this.begin(options);
+        try {
+            await callback(transaction);
+            return transaction.commit();
+        } catch (error) {
+            const rollbackResult = transaction.rollback();
+            return {
+                success: false,
+                state: "failed",
+                durationMs: rollbackResult.durationMs,
+                error: error instanceof Error ? error.message : "Unknown error",
+            };
+        }
+    }
+    /**
+     * 获取活动事务数量
+     */
+    getActiveTransactionCount() {
+        return this.activeTransactions.size;
+    }
+    /**
+     * 清理已完成的事务
+     */
+    cleanup() {
+        for (const [txId, tx] of this.activeTransactions) {
+            if (tx.getState() !== "active") {
+                this.activeTransactions.delete(txId);
+            }
+        }
+    }
+}
+exports.TransactionManager = TransactionManager;
+//# sourceMappingURL=Transaction.js.map

package/dist/api/Transaction.js.map

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

package/dist/api/index.d.ts

@@ -0,0 +1,24 @@
+/**
+ * LightDB API 层
+ * 提供用户直接使用的接口层
+ *
+ * @packageDocumentation
+ */
+export {
+    LightDBOptions,
+    CollectionCreateOptions,
+    TransactionContext,
+    TransactionCollection,
+    TransactionCallback,
+    TransactionOptions,
+    TransactionState,
+    TransactionResult,
+    DatabaseStats,
+    DatabaseConfig,
+    ILightDB,
+    DefineCollectionSchema,
+    CollectionSchema,
+} from "./types";
+export { TransactionError, Transaction, TransactionManager } from "./Transaction";
+export { LightDB, defineCollectionSchema, openDatabase } from "./LightDB";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/api/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACH,cAAc,EACd,uBAAuB,EACvB,kBAAkB,EAClB,qBAAqB,EACrB,mBAAmB,EACnB,kBAAkB,EAClB,gBAAgB,EAChB,iBAAiB,EACjB,aAAa,EACb,cAAc,EACd,QAAQ,EACR,sBAAsB,EACtB,gBAAgB,GACnB,MAAM,SAAS,CAAC;AAEjB,OAAO,EACH,gBAAgB,EAChB,WAAW,EACX,kBAAkB,GACrB,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,OAAO,EAAE,sBAAsB,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC"}

package/dist/api/index.js

@@ -0,0 +1,54 @@
+"use strict";
+/**
+ * LightDB API 层
+ * 提供用户直接使用的接口层
+ *
+ * @packageDocumentation
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.openDatabase =
+    exports.defineCollectionSchema =
+    exports.LightDB =
+    exports.TransactionManager =
+    exports.Transaction =
+    exports.TransactionError =
+        void 0;
+var Transaction_1 = require("./Transaction");
+Object.defineProperty(exports, "TransactionError", {
+    enumerable: true,
+    get: function () {
+        return Transaction_1.TransactionError;
+    },
+});
+Object.defineProperty(exports, "Transaction", {
+    enumerable: true,
+    get: function () {
+        return Transaction_1.Transaction;
+    },
+});
+Object.defineProperty(exports, "TransactionManager", {
+    enumerable: true,
+    get: function () {
+        return Transaction_1.TransactionManager;
+    },
+});
+var LightDB_1 = require("./LightDB");
+Object.defineProperty(exports, "LightDB", {
+    enumerable: true,
+    get: function () {
+        return LightDB_1.LightDB;
+    },
+});
+Object.defineProperty(exports, "defineCollectionSchema", {
+    enumerable: true,
+    get: function () {
+        return LightDB_1.defineCollectionSchema;
+    },
+});
+Object.defineProperty(exports, "openDatabase", {
+    enumerable: true,
+    get: function () {
+        return LightDB_1.openDatabase;
+    },
+});
+//# sourceMappingURL=index.js.map

package/dist/api/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/api/index.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAkBH,6CAIuB;AAHnB,+GAAA,gBAAgB,OAAA;AAChB,0GAAA,WAAW,OAAA;AACX,iHAAA,kBAAkB,OAAA;AAGtB,qCAA0E;AAAjE,kGAAA,OAAO,OAAA;AAAE,iHAAA,sBAAsB,OAAA;AAAE,uGAAA,YAAY,OAAA"}

package/dist/api/types.d.ts

@@ -0,0 +1,154 @@
+/**
+ * LightDB API 层类型定义
+ * 包含所有公共 API 接口和类型定义
+ */
+import type { Collection } from "../collection";
+import type { CollectionOptions, IndexConfig } from "../collection/types";
+import type { StorageEngineOptions, StorageStats, CheckpointResult } from "../types";
+/**
+ * LightDB 配置选项
+ */
+export interface LightDBOptions extends StorageEngineOptions {
+    /** 数据库名称，默认为 'default' */
+    dbName?: string;
+}
+/**
+ * 集合配置选项
+ * 用于创建类型安全的集合
+ */
+export interface CollectionCreateOptions<T extends Record<string, unknown>> extends CollectionOptions<T> {
+    /** 集合名称（必填） */
+    name: string;
+}
+/**
+ * 事务上下文
+ * 提供事务内的集合访问
+ */
+export interface TransactionContext {
+    /** 获取集合 */
+    collection<T extends Record<string, unknown>>(name: string): TransactionCollection<T>;
+}
+/**
+ * 事务集合接口
+ * 提供事务内的集合操作
+ */
+export interface TransactionCollection<T extends Record<string, unknown>> {
+    /** 查找文档 */
+    find(filter?: Record<string, unknown>): Promise<T[]>;
+    /** 查找单个文档 */
+    findOne(filter: Record<string, unknown>): Promise<T | null>;
+    /** 插入文档 */
+    insert(doc: T): Promise<void>;
+    /** 更新文档 */
+    update(filter: Record<string, unknown>, update: Partial<T>): Promise<number>;
+    /** 删除文档 */
+    delete(filter: Record<string, unknown>): Promise<number>;
+}
+/**
+ * 事务回调函数类型
+ */
+export type TransactionCallback = (tx: TransactionContext) => Promise<void>;
+/**
+ * 事务选项
+ */
+export interface TransactionOptions {
+    /** 事务超时时间（毫秒），默认 5000 */
+    timeout?: number;
+    /** 事务隔离级别 */
+    isolationLevel?: "read_committed" | "repeatable_read" | "serializable";
+}
+/**
+ * 事务状态
+ */
+export type TransactionState = "active" | "committed" | "rolled_back" | "failed";
+/**
+ * 事务结果
+ */
+export interface TransactionResult {
+    /** 事务是否成功 */
+    success: boolean;
+    /** 事务状态 */
+    state: TransactionState;
+    /** 事务持续时间（毫秒） */
+    durationMs: number;
+    /** 错误信息（如果失败） */
+    error?: string;
+}
+/**
+ * 数据库统计信息
+ */
+export interface DatabaseStats extends StorageStats {
+    /** 数据库名称 */
+    dbName: string;
+    /** 集合数量 */
+    collectionCount: number;
+    /** 集合统计信息列表 */
+    collections: Array<{
+        name: string;
+        documentCount: number;
+        indexCount: number;
+    }>;
+}
+/**
+ * 数据库配置信息
+ */
+export interface DatabaseConfig {
+    /** 数据库名称 */
+    dbName: string;
+    /** 数据库路径 */
+    path: string;
+    /** 页面大小 */
+    pageSize: number;
+    /** WAL 阈值 */
+    walThreshold: number;
+    /** 是否启用自动检查点 */
+    autoCheckpoint: boolean;
+}
+/**
+ * LightDB 实例接口
+ * 定义 LightDB 的公共 API
+ */
+export interface ILightDB {
+    /** 获取数据库名称 */
+    readonly dbName: string;
+    /** 获取数据库路径 */
+    readonly path: string;
+    /** 检查数据库是否已打开 */
+    readonly isOpen: boolean;
+    /** 获取或创建集合 */
+    collection<T extends Record<string, unknown>>(name: string, options: CollectionCreateOptions<T>): Collection<T>;
+    /** 检查集合是否存在 */
+    hasCollection(name: string): boolean;
+    /** 删除集合 */
+    dropCollection(name: string): boolean;
+    /** 获取所有集合名称 */
+    getCollectionNames(): string[];
+    /** 执行事务 */
+    transaction(callback: TransactionCallback, options?: TransactionOptions): Promise<TransactionResult>;
+    /** 执行检查点 */
+    checkpoint(): Promise<CheckpointResult>;
+    /** 获取数据库统计信息 */
+    getStats(): Promise<DatabaseStats>;
+    /** 获取数据库配置 */
+    getConfig(): DatabaseConfig;
+    /** 同步数据到磁盘 */
+    sync(): Promise<void>;
+    /** 关闭数据库 */
+    close(): Promise<void>;
+}
+/**
+ * 定义集合 Schema 的辅助类型
+ */
+export type DefineCollectionSchema<T extends Record<string, unknown>> = {
+    /** 文档类型 */
+    schema: T;
+    /** 主键字段 */
+    primaryKey: keyof T & string;
+    /** 二级索引配置 */
+    indexes?: IndexConfig<T>[];
+};
+/**
+ * 创建集合 Schema 的辅助函数返回类型
+ */
+export type CollectionSchema<T extends Record<string, unknown>> = DefineCollectionSchema<T>;
+//# sourceMappingURL=types.d.ts.map

package/dist/api/types.d.ts.map

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

package/dist/api/types.js

@@ -0,0 +1,7 @@
+"use strict";
+/**
+ * LightDB API 层类型定义
+ * 包含所有公共 API 接口和类型定义
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/api/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/api/types.ts"],"names":[],"mappings":";AAAA;;;GAGG"}