@yydb/light-db 0.0.0

package/dist/api/LightDB.d.ts

@@ -0,0 +1,194 @@
+/**
+ * LightDB 主类
+ * 提供用户直接使用的接口层
+ */
+import { StorageEngine } from "../storage";
+import { Collection } from "../collection";
+import type {
+    LightDBOptions,
+    CollectionCreateOptions,
+    TransactionCallback,
+    TransactionOptions,
+    TransactionResult,
+    DatabaseStats,
+    DatabaseConfig,
+    ILightDB,
+    CollectionSchema,
+} from "./types";
+import type { CheckpointResult } from "../types";
+/**
+ * LightDB 数据库实例
+ * 提供完整的数据库操作 API
+ */
+export declare class LightDB implements ILightDB {
+    private readonly storageEngine;
+    private readonly collections;
+    private readonly transactionManager;
+    private readonly options;
+    private closed;
+    /**
+     * 创建 LightDB 实例
+     * @param storageEngine 已初始化的存储引擎
+     * @param options 配置选项
+     */
+    private constructor();
+    /**
+     * 打开数据库
+     * 创建或打开指定路径的数据库
+     *
+     * @param path 数据库文件存储路径
+     * @param options 配置选项
+     * @returns 初始化完成的 LightDB 实例
+     *
+     * @example
+     * ```typescript
+     * const db = await LightDB.open('./data/mydb', {
+     *   dbName: 'mydb',
+     *   autoCheckpoint: true,
+     *   pageSize: 4096
+     * });
+     * ```
+     */
+    static open(path: string, options?: LightDBOptions): Promise<LightDB>;
+    /**
+     * 获取数据库名称
+     */
+    get dbName(): string;
+    /**
+     * 获取数据库路径
+     */
+    get path(): string;
+    /**
+     * 检查数据库是否已打开
+     */
+    get isOpen(): boolean;
+    /**
+     * 获取或创建集合
+     * 返回类型安全的集合实例
+     *
+     * @param name 集合名称
+     * @param options 集合配置选项
+     * @returns 集合实例
+     *
+     * @example
+     * ```typescript
+     * interface User {
+     *   id: number;
+     *   name: string;
+     *   age: number;
+     * }
+     *
+     * const users = db.collection<User>('users', {
+     *   name: 'users',
+     *   primaryKey: 'id',
+     *   indexes: [
+     *     { name: 'name_idx', fieldName: 'name' }
+     *   ]
+     * });
+     * ```
+     */
+    collection<T extends Record<string, unknown>>(name: string, options: CollectionCreateOptions<T>): Collection<T>;
+    /**
+     * 检查集合是否存在
+     *
+     * @param name 集合名称
+     * @returns 集合是否存在
+     */
+    hasCollection(name: string): boolean;
+    /**
+     * 删除集合
+     *
+     * @param name 集合名称
+     * @returns 是否删除成功
+     */
+    dropCollection(name: string): boolean;
+    /**
+     * 获取所有集合名称
+     *
+     * @returns 集合名称数组
+     */
+    getCollectionNames(): string[];
+    /**
+     * 执行事务
+     * 支持 ACID 事务特性
+     *
+     * @param callback 事务回调函数
+     * @param options 事务选项
+     * @returns 事务执行结果
+     *
+     * @example
+     * ```typescript
+     * await db.transaction(async (tx) => {
+     *   const users = tx.collection<User>('users');
+     *   const user = await users.findOne({ id: 1 });
+     *   await users.update({ id: 1 }, { balance: user.balance - 100 });
+     * });
+     * ```
+     */
+    transaction(callback: TransactionCallback, options?: TransactionOptions): Promise<TransactionResult>;
+    /**
+     * 执行检查点
+     * 将内存中的数据持久化到磁盘
+     *
+     * @returns 检查点执行结果
+     */
+    checkpoint(): Promise<CheckpointResult>;
+    /**
+     * 获取数据库统计信息
+     *
+     * @returns 数据库统计信息
+     */
+    getStats(): Promise<DatabaseStats>;
+    /**
+     * 获取数据库配置
+     *
+     * @returns 数据库配置信息
+     */
+    getConfig(): DatabaseConfig;
+    /**
+     * 同步数据到磁盘
+     * 确保所有数据都已持久化
+     */
+    sync(): Promise<void>;
+    /**
+     * 关闭数据库
+     * 释放所有资源并确保数据持久化
+     */
+    close(): Promise<void>;
+    /**
+     * 确保数据库处于打开状态
+     */
+    private ensureOpen;
+    /**
+     * 获取存储引擎（内部使用）
+     */
+    getStorageEngine(): StorageEngine;
+}
+/**
+ * 定义集合 Schema 的辅助函数
+ * 提供类型推断和 IDE 支持
+ *
+ * @param schema Schema 定义
+ * @returns Schema 对象
+ *
+ * @example
+ * ```typescript
+ * const UserSchema = defineCollectionSchema({
+ *   schema: {} as User,
+ *   primaryKey: 'id',
+ *   indexes: [
+ *     { name: 'name_idx', fieldName: 'name' }
+ *   ]
+ * });
+ * ```
+ */
+export declare function defineCollectionSchema<T extends Record<string, unknown>>(schema: CollectionSchema<T>): CollectionSchema<T>;
+/**
+ * 打开数据库的便捷函数
+ *
+ * @param path 数据库文件存储路径
+ * @param options 配置选项
+ * @returns 初始化完成的 LightDB 实例
+ */
+export declare function openDatabase(path: string, options?: LightDBOptions): Promise<LightDB>;
+//# sourceMappingURL=LightDB.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"LightDB.d.ts","sourceRoot":"","sources":["../../src/api/LightDB.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,aAAa,EAAuB,MAAM,YAAY,CAAC;AAChE,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAG3C,OAAO,KAAK,EACR,cAAc,EACd,uBAAuB,EACvB,mBAAmB,EACnB,kBAAkB,EAClB,iBAAiB,EACjB,aAAa,EACb,cAAc,EACd,QAAQ,EACR,gBAAgB,EACnB,MAAM,SAAS,CAAC;AACjB,OAAO,KAAK,EAAE,gBAAgB,EAAsC,MAAM,UAAU,CAAC;AAGrF;;;GAGG;AACH,qBAAa,OAAQ,YAAW,QAAQ;IACpC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAgB;IAC9C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAmD;IAC/E,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAqB;IACxD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAEtB;IACF,OAAO,CAAC,MAAM,CAAU;IAExB;;;;OAIG;IACH,OAAO;IAaP;;;;;;;;;;;;;;;;OAgBG;WACiB,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,OAAO,CAAC;IAyBtF;;OAEG;IACH,IAAW,MAAM,IAAI,MAAM,CAE1B;IAED;;OAEG;IACH,IAAW,IAAI,IAAI,MAAM,CAExB;IAED;;OAEG;IACH,IAAW,MAAM,IAAI,OAAO,CAE3B;IAED;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACI,UAAU,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,uBAAuB,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC;IAoBtH;;;;;OAKG;IACI,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAK3C;;;;;OAKG;IACI,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAa5C;;;;OAIG;IACI,kBAAkB,IAAI,MAAM,EAAE;IAKrC;;;;;;;;;;;;;;;;OAgBG;IACU,WAAW,CAAC,QAAQ,EAAE,mBAAmB,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAKjH;;;;;OAKG;IACU,UAAU,IAAI,OAAO,CAAC,gBAAgB,CAAC;IAKpD;;;;OAIG;IACU,QAAQ,IAAI,OAAO,CAAC,aAAa,CAAC;IAmB/C;;;;OAIG;IACI,SAAS,IAAI,cAAc;IAUlC;;;OAGG;IACU,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAKlC;;;OAGG;IACU,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAcnC;;OAEG;IACH,OAAO,CAAC,UAAU;IASlB;;OAEG;IACI,gBAAgB,IAAI,aAAa;CAG3C;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,sBAAsB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,gBAAgB,CAAC,CAAC,CAAC,GAAG,gBAAgB,CAAC,CAAC,CAAC,CAE1H;AAED;;;;;;GAMG;AACH,wBAAsB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC,CAE3F"}

package/dist/api/LightDB.js

@@ -0,0 +1,299 @@
+"use strict";
+/**
+ * LightDB 主类
+ * 提供用户直接使用的接口层
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LightDB = void 0;
+exports.defineCollectionSchema = defineCollectionSchema;
+exports.openDatabase = openDatabase;
+const storage_1 = require("../storage");
+const collection_1 = require("../collection");
+const Transaction_1 = require("./Transaction");
+const errors_1 = require("../errors");
+/**
+ * LightDB 数据库实例
+ * 提供完整的数据库操作 API
+ */
+class LightDB {
+    /**
+     * 创建 LightDB 实例
+     * @param storageEngine 已初始化的存储引擎
+     * @param options 配置选项
+     */
+    constructor(storageEngine, options) {
+        this.storageEngine = storageEngine;
+        this.options = options;
+        this.collections = new Map();
+        this.transactionManager = new Transaction_1.TransactionManager(this.collections);
+        this.closed = false;
+    }
+    /**
+     * 打开数据库
+     * 创建或打开指定路径的数据库
+     *
+     * @param path 数据库文件存储路径
+     * @param options 配置选项
+     * @returns 初始化完成的 LightDB 实例
+     *
+     * @example
+     * ```typescript
+     * const db = await LightDB.open('./data/mydb', {
+     *   dbName: 'mydb',
+     *   autoCheckpoint: true,
+     *   pageSize: 4096
+     * });
+     * ```
+     */
+    static async open(path, options = {}) {
+        const dbName = options.dbName ?? "default";
+        const fullOptions = {
+            dbName,
+            pageSize: options.pageSize ?? 4096,
+            walThreshold: options.walThreshold ?? 16 * 1024 * 1024,
+            autoCheckpoint: options.autoCheckpoint ?? true,
+            fsyncStrategy: options.fsyncStrategy,
+        };
+        const storageEngineOptions = {
+            pageSize: fullOptions.pageSize,
+            walThreshold: fullOptions.walThreshold,
+            autoCheckpoint: fullOptions.autoCheckpoint,
+        };
+        if (fullOptions.fsyncStrategy !== undefined) {
+            storageEngineOptions.fsyncStrategy = fullOptions.fsyncStrategy;
+        }
+        const storageEngine = await (0, storage_1.createStorageEngine)(path, dbName, storageEngineOptions);
+        return new LightDB(storageEngine, fullOptions);
+    }
+    /**
+     * 获取数据库名称
+     */
+    get dbName() {
+        return this.options.dbName;
+    }
+    /**
+     * 获取数据库路径
+     */
+    get path() {
+        return this.storageEngine.getBasePath();
+    }
+    /**
+     * 检查数据库是否已打开
+     */
+    get isOpen() {
+        return !this.closed && this.storageEngine.isInitialized();
+    }
+    /**
+     * 获取或创建集合
+     * 返回类型安全的集合实例
+     *
+     * @param name 集合名称
+     * @param options 集合配置选项
+     * @returns 集合实例
+     *
+     * @example
+     * ```typescript
+     * interface User {
+     *   id: number;
+     *   name: string;
+     *   age: number;
+     * }
+     *
+     * const users = db.collection<User>('users', {
+     *   name: 'users',
+     *   primaryKey: 'id',
+     *   indexes: [
+     *     { name: 'name_idx', fieldName: 'name' }
+     *   ]
+     * });
+     * ```
+     */
+    collection(name, options) {
+        this.ensureOpen();
+        const existingCollection = this.collections.get(name);
+        if (existingCollection) {
+            return existingCollection;
+        }
+        const collectionOptions = {
+            name,
+            primaryKey: options.primaryKey,
+            indexes: options.indexes ?? [],
+        };
+        const collection = new collection_1.Collection(collectionOptions);
+        this.collections.set(name, collection);
+        return collection;
+    }
+    /**
+     * 检查集合是否存在
+     *
+     * @param name 集合名称
+     * @returns 集合是否存在
+     */
+    hasCollection(name) {
+        this.ensureOpen();
+        return this.collections.has(name);
+    }
+    /**
+     * 删除集合
+     *
+     * @param name 集合名称
+     * @returns 是否删除成功
+     */
+    dropCollection(name) {
+        this.ensureOpen();
+        const collection = this.collections.get(name);
+        if (!collection) {
+            return false;
+        }
+        collection.clear();
+        this.collections.delete(name);
+        return true;
+    }
+    /**
+     * 获取所有集合名称
+     *
+     * @returns 集合名称数组
+     */
+    getCollectionNames() {
+        this.ensureOpen();
+        return Array.from(this.collections.keys());
+    }
+    /**
+     * 执行事务
+     * 支持 ACID 事务特性
+     *
+     * @param callback 事务回调函数
+     * @param options 事务选项
+     * @returns 事务执行结果
+     *
+     * @example
+     * ```typescript
+     * await db.transaction(async (tx) => {
+     *   const users = tx.collection<User>('users');
+     *   const user = await users.findOne({ id: 1 });
+     *   await users.update({ id: 1 }, { balance: user.balance - 100 });
+     * });
+     * ```
+     */
+    async transaction(callback, options) {
+        this.ensureOpen();
+        return this.transactionManager.execute(callback, options);
+    }
+    /**
+     * 执行检查点
+     * 将内存中的数据持久化到磁盘
+     *
+     * @returns 检查点执行结果
+     */
+    async checkpoint() {
+        this.ensureOpen();
+        return this.storageEngine.checkpoint();
+    }
+    /**
+     * 获取数据库统计信息
+     *
+     * @returns 数据库统计信息
+     */
+    async getStats() {
+        this.ensureOpen();
+        const storageStats = await this.storageEngine.getStats();
+        const collectionStats = Array.from(this.collections.entries()).map(([name, collection]) => ({
+            name,
+            documentCount: collection.Size,
+            indexCount: collection.getStats().indexCount,
+        }));
+        return {
+            ...storageStats,
+            dbName: this.options.dbName,
+            collectionCount: this.collections.size,
+            collections: collectionStats,
+        };
+    }
+    /**
+     * 获取数据库配置
+     *
+     * @returns 数据库配置信息
+     */
+    getConfig() {
+        return {
+            dbName: this.options.dbName,
+            path: this.storageEngine.getBasePath(),
+            pageSize: this.options.pageSize,
+            walThreshold: this.options.walThreshold,
+            autoCheckpoint: this.options.autoCheckpoint,
+        };
+    }
+    /**
+     * 同步数据到磁盘
+     * 确保所有数据都已持久化
+     */
+    async sync() {
+        this.ensureOpen();
+        await this.storageEngine.sync();
+    }
+    /**
+     * 关闭数据库
+     * 释放所有资源并确保数据持久化
+     */
+    async close() {
+        if (this.closed) {
+            return;
+        }
+        for (const collection of this.collections.values()) {
+            collection.clear();
+        }
+        this.collections.clear();
+        await this.storageEngine.close();
+        this.closed = true;
+    }
+    /**
+     * 确保数据库处于打开状态
+     */
+    ensureOpen() {
+        if (this.closed) {
+            throw new errors_1.StorageError("Database is closed", "DATABASE_CLOSED");
+        }
+        if (!this.storageEngine.isInitialized()) {
+            throw new errors_1.StorageError("Database is not initialized", "DATABASE_NOT_INITIALIZED");
+        }
+    }
+    /**
+     * 获取存储引擎（内部使用）
+     */
+    getStorageEngine() {
+        return this.storageEngine;
+    }
+}
+exports.LightDB = LightDB;
+/**
+ * 定义集合 Schema 的辅助函数
+ * 提供类型推断和 IDE 支持
+ *
+ * @param schema Schema 定义
+ * @returns Schema 对象
+ *
+ * @example
+ * ```typescript
+ * const UserSchema = defineCollectionSchema({
+ *   schema: {} as User,
+ *   primaryKey: 'id',
+ *   indexes: [
+ *     { name: 'name_idx', fieldName: 'name' }
+ *   ]
+ * });
+ * ```
+ */
+function defineCollectionSchema(schema) {
+    return schema;
+}
+/**
+ * 打开数据库的便捷函数
+ *
+ * @param path 数据库文件存储路径
+ * @param options 配置选项
+ * @returns 初始化完成的 LightDB 实例
+ */
+async function openDatabase(path, options) {
+    return LightDB.open(path, options);
+}
+//# sourceMappingURL=LightDB.js.map

package/dist/api/LightDB.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LightDB.js","sourceRoot":"","sources":["../../src/api/LightDB.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAgVH,wDAEC;AASD,oCAEC;AA3VD,wCAAgE;AAChE,8CAA2C;AAE3C,+CAAmD;AAanD,sCAAyC;AAEzC;;;GAGG;AACH,MAAa,OAAO;IAShB;;;;OAIG;IACH,YACI,aAA4B,EAC5B,OAEC;QAED,IAAI,CAAC,aAAa,GAAG,aAAa,CAAC;QACnC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,WAAW,GAAG,IAAI,GAAG,EAAE,CAAC;QAC7B,IAAI,CAAC,kBAAkB,GAAG,IAAI,gCAAkB,CAAC,IAAI,CAAC,WAA+D,CAAC,CAAC;QACvH,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;IACxB,CAAC;IAED;;;;;;;;;;;;;;;;OAgBG;IACI,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,IAAY,EAAE,UAA0B,EAAE;QAC/D,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,SAAS,CAAC;QAC3C,MAAM,WAAW,GAAG;YAChB,MAAM;YACN,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,IAAI;YAClC,YAAY,EAAE,OAAO,CAAC,YAAY,IAAI,EAAE,GAAG,IAAI,GAAG,IAAI;YACtD,cAAc,EAAE,OAAO,CAAC,cAAc,IAAI,IAAI;YAC9C,aAAa,EAAE,OAAO,CAAC,aAAa;SACvC,CAAC;QAER,MAAM,oBAAoB,GAAyB;YAClD,QAAQ,EAAE,WAAW,CAAC,QAAQ;YAC9B,YAAY,EAAE,WAAW,CAAC,YAAY;YACtC,cAAc,EAAE,WAAW,CAAC,cAAc;SAC1C,CAAC;QAEF,IAAI,WAAW,CAAC,aAAa,KAAK,SAAS,EAAE,CAAC;YAC5C,oBAA6E,CAAC,aAAa,GAAG,WAAW,CAAC,aAAa,CAAC;QAC1H,CAAC;QAED,MAAM,aAAa,GAAG,MAAM,IAAA,6BAAmB,EAAC,IAAI,EAAE,MAAM,EAAE,oBAAoB,CAAC,CAAC;QAE9E,OAAO,IAAI,OAAO,CAAC,aAAa,EAAE,WAAW,CAAC,CAAC;IACnD,CAAC;IAED;;OAEG;IACH,IAAW,MAAM;QACb,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC;IAC/B,CAAC;IAED;;OAEG;IACH,IAAW,IAAI;QACX,OAAO,IAAI,CAAC,aAAa,CAAC,WAAW,EAAE,CAAC;IAC5C,CAAC;IAED;;OAEG;IACH,IAAW,MAAM;QACb,OAAO,CAAC,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,aAAa,CAAC,aAAa,EAAE,CAAC;IAC9D,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACI,UAAU,CAAoC,IAAY,EAAE,OAAmC;QAClG,IAAI,CAAC,UAAU,EAAE,CAAC;QAElB,MAAM,kBAAkB,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACtD,IAAI,kBAAkB,EAAE,CAAC;YACrB,OAAO,kBAAmC,CAAC;QAC/C,CAAC;QAED,MAAM,iBAAiB,GAAyB;YAC5C,IAAI;YACJ,UAAU,EAAE,OAAO,CAAC,UAAU;YAC9B,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,EAAE;SACjC,CAAC;QAEF,MAAM,UAAU,GAAG,IAAI,uBAAU,CAAI,iBAAiB,CAAC,CAAC;QACxD,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,EAAE,UAAiD,CAAC,CAAC;QAE9E,OAAO,UAAU,CAAC;IACtB,CAAC;IAED;;;;;OAKG;IACI,aAAa,CAAC,IAAY;QAC7B,IAAI,CAAC,UAAU,EAAE,CAAC;QAClB,OAAO,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACtC,CAAC;IAED;;;;;OAKG;IACI,cAAc,CAAC,IAAY;QAC9B,IAAI,CAAC,UAAU,EAAE,CAAC;QAElB,MAAM,UAAU,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC9C,IAAI,CAAC,UAAU,EAAE,CAAC;YACd,OAAO,KAAK,CAAC;QACjB,CAAC;QAED,UAAU,CAAC,KAAK,EAAE,CAAC;QACnB,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAC9B,OAAO,IAAI,CAAC;IAChB,CAAC;IAED;;;;OAIG;IACI,kBAAkB;QACrB,IAAI,CAAC,UAAU,EAAE,CAAC;QAClB,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,CAAC;IAC/C,CAAC;IAED;;;;;;;;;;;;;;;;OAgBG;IACI,KAAK,CAAC,WAAW,CAAC,QAA6B,EAAE,OAA4B;QAChF,IAAI,CAAC,UAAU,EAAE,CAAC;QAClB,OAAO,IAAI,CAAC,kBAAkB,CAAC,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC9D,CAAC;IAED;;;;;OAKG;IACI,KAAK,CAAC,UAAU;QACnB,IAAI,CAAC,UAAU,EAAE,CAAC;QAClB,OAAO,IAAI,CAAC,aAAa,CAAC,UAAU,EAAE,CAAC;IAC3C,CAAC;IAED;;;;OAIG;IACI,KAAK,CAAC,QAAQ;QACjB,IAAI,CAAC,UAAU,EAAE,CAAC;QAElB,MAAM,YAAY,GAAiB,MAAM,IAAI,CAAC,aAAa,CAAC,QAAQ,EAAE,CAAC;QAEvE,MAAM,eAAe,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,UAAU,CAAC,EAAE,EAAE,CAAC,CAAC;YACxF,IAAI;YACJ,aAAa,EAAE,UAAU,CAAC,IAAI;YAC9B,UAAU,EAAE,UAAU,CAAC,QAAQ,EAAE,CAAC,UAAU;SAC/C,CAAC,CAAC,CAAC;QAEJ,OAAO;YACH,GAAG,YAAY;YACf,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,MAAM;YAC3B,eAAe,EAAE,IAAI,CAAC,WAAW,CAAC,IAAI;YACtC,WAAW,EAAE,eAAe;SAC/B,CAAC;IACN,CAAC;IAED;;;;OAIG;IACI,SAAS;QACZ,OAAO;YACH,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,MAAM;YAC3B,IAAI,EAAE,IAAI,CAAC,aAAa,CAAC,WAAW,EAAE;YACtC,QAAQ,EAAE,IAAI,CAAC,OAAO,CAAC,QAAQ;YAC/B,YAAY,EAAE,IAAI,CAAC,OAAO,CAAC,YAAY;YACvC,cAAc,EAAE,IAAI,CAAC,OAAO,CAAC,cAAc;SAC9C,CAAC;IACN,CAAC;IAED;;;OAGG;IACI,KAAK,CAAC,IAAI;QACb,IAAI,CAAC,UAAU,EAAE,CAAC;QAClB,MAAM,IAAI,CAAC,aAAa,CAAC,IAAI,EAAE,CAAC;IACpC,CAAC;IAED;;;OAGG;IACI,KAAK,CAAC,KAAK;QACd,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YACd,OAAO;QACX,CAAC;QAED,KAAK,MAAM,UAAU,IAAI,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,EAAE,CAAC;YACjD,UAAU,CAAC,KAAK,EAAE,CAAC;QACvB,CAAC;QACD,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,CAAC;QAEzB,MAAM,IAAI,CAAC,aAAa,CAAC,KAAK,EAAE,CAAC;QACjC,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;IACvB,CAAC;IAED;;OAEG;IACK,UAAU;QACd,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YACd,MAAM,IAAI,qBAAY,CAAC,oBAAoB,EAAE,iBAAiB,CAAC,CAAC;QACpE,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,aAAa,EAAE,EAAE,CAAC;YACtC,MAAM,IAAI,qBAAY,CAAC,6BAA6B,EAAE,0BAA0B,CAAC,CAAC;QACtF,CAAC;IACL,CAAC;IAED;;OAEG;IACI,gBAAgB;QACnB,OAAO,IAAI,CAAC,aAAa,CAAC;IAC9B,CAAC;CACJ;AApSD,0BAoSC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,SAAgB,sBAAsB,CAAoC,MAA2B;IACjG,OAAO,MAAM,CAAC;AAClB,CAAC;AAED;;;;;;GAMG;AACI,KAAK,UAAU,YAAY,CAAC,IAAY,EAAE,OAAwB;IACrE,OAAO,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AACvC,CAAC"}

package/dist/api/Transaction.d.ts

@@ -0,0 +1,100 @@
+/**
+ * LightDB 事务实现
+ * 提供 ACID 事务支持
+ */
+import type { Collection } from "../collection";
+import type {
+    TransactionContext,
+    TransactionCollection,
+    TransactionCallback,
+    TransactionOptions,
+    TransactionState,
+    TransactionResult,
+} from "./types";
+/**
+ * 事务错误类
+ */
+export declare class TransactionError extends Error {
+    readonly code: string;
+    constructor(message: string, code: string);
+}
+/**
+ * 操作记录类型
+ */
+interface OperationRecord {
+    type: "insert" | "update" | "delete";
+    collectionName: string;
+    data: unknown;
+}
+/**
+ * 事务类
+ * 管理事务的生命周期和操作
+ */
+export declare class Transaction implements TransactionContext {
+    private readonly collections;
+    private readonly options;
+    private state;
+    private readonly operations;
+    private readonly startTime;
+    constructor(collections: Map<string, Collection<Record<string, unknown>>>, options?: TransactionOptions);
+    /**
+     * 获取事务集合
+     */
+    collection<T extends Record<string, unknown>>(name: string): TransactionCollection<T>;
+    /**
+     * 确保事务处于活动状态
+     */
+    ensureActive(): void;
+    /**
+     * 记录操作
+     */
+    recordOperation(type: OperationRecord["type"], collectionName: string, data: unknown): void;
+    /**
+     * 提交事务
+     */
+    commit(): TransactionResult;
+    /**
+     * 回滚事务
+     */
+    rollback(): TransactionResult;
+    /**
+     * 撤销操作
+     */
+    private undoOperation;
+    /**
+     * 获取事务状态
+     */
+    getState(): TransactionState;
+    /**
+     * 获取操作数量
+     */
+    getOperationCount(): number;
+}
+/**
+ * 事务管理器
+ * 管理多个并发事务
+ */
+export declare class TransactionManager {
+    private readonly collections;
+    private readonly activeTransactions;
+    private transactionCounter;
+    constructor(collections: Map<string, Collection<Record<string, unknown>>>);
+    /**
+     * 开始新事务
+     */
+    begin(options?: TransactionOptions): Transaction;
+    /**
+     * 执行事务
+     */
+    execute(callback: TransactionCallback, options?: TransactionOptions): Promise<TransactionResult>;
+    /**
+     * 获取活动事务数量
+     */
+    getActiveTransactionCount(): number;
+    /**
+     * 清理已完成的事务
+     */
+    cleanup(): void;
+}
+export {};
+//# sourceMappingURL=Transaction.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Transaction.d.ts","sourceRoot":"","sources":["../../src/api/Transaction.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAe,MAAM,eAAe,CAAC;AAC7D,OAAO,KAAK,EACR,kBAAkB,EAClB,qBAAqB,EACrB,mBAAmB,EACnB,kBAAkB,EAClB,gBAAgB,EAChB,iBAAiB,EACpB,MAAM,SAAS,CAAC;AAEjB;;GAEG;AACH,qBAAa,gBAAiB,SAAQ,KAAK;IACvC,SAAgB,IAAI,EAAE,MAAM,CAAC;gBAEjB,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM;CAM5C;AA0DD;;GAEG;AACH,UAAU,eAAe;IACrB,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;IACrC,cAAc,EAAE,MAAM,CAAC;IACvB,IAAI,EAAE,OAAO,CAAC;CACjB;AAED;;;GAGG;AACH,qBAAa,WAAY,YAAW,kBAAkB;IAClD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAmD;IAC/E,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA+B;IACvD,OAAO,CAAC,KAAK,CAAmB;IAChC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAoB;IAC/C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;gBAEvB,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,kBAAkB;IAWvG;;OAEG;IACI,UAAU,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,qBAAqB,CAAC,CAAC,CAAC;IAW5F;;OAEG;IACI,YAAY,IAAI,IAAI;IAW3B;;OAEG;IACI,eAAe,CAAC,IAAI,EAAE,eAAe,CAAC,MAAM,CAAC,EAAE,cAAc,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,IAAI;IAIlG;;OAEG;IACI,MAAM,IAAI,iBAAiB;IA4BlC;;OAEG;IACI,QAAQ,IAAI,iBAAiB;IAiCpC;;OAEG;IACH,OAAO,CAAC,aAAa;IAoBrB;;OAEG;IACI,QAAQ,IAAI,gBAAgB;IAInC;;OAEG;IACI,iBAAiB,IAAI,MAAM;CAGrC;AAED;;;GAGG;AACH,qBAAa,kBAAkB;IAC3B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAmD;IAC/E,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAA2B;IAC9D,OAAO,CAAC,kBAAkB,CAAS;gBAEvB,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAMzE;;OAEG;IACI,KAAK,CAAC,OAAO,CAAC,EAAE,kBAAkB,GAAG,WAAW;IAOvD;;OAEG;IACU,OAAO,CAAC,QAAQ,EAAE,mBAAmB,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAiB7G;;OAEG;IACI,yBAAyB,IAAI,MAAM;IAI1C;;OAEG;IACI,OAAO,IAAI,IAAI;CAOzB"}