@yydb/light-db 0.0.0 → 0.0.11

package/dist/api/LightDB.js

@@ -1,299 +0,0 @@
-"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

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

package/dist/api/Transaction.d.ts

@@ -1,100 +0,0 @@
-/**
- * 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

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

package/dist/api/Transaction.js

@@ -1,263 +0,0 @@
-"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

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