@yydb/light-db 0.0.0

package/dist/collection/Collection.d.ts

@@ -0,0 +1,235 @@
+/**
+ * LightDB 集合类
+ * 提供类型安全的 CRUD 操作和链式查询 API
+ */
+import { QueryBuilder, QueryExecutor } from "./QueryBuilder";
+import type {
+    CollectionOptions,
+    InsertOptions,
+    InsertResult,
+    InsertManyResult,
+    UpdateOptions,
+    UpdateResult,
+    DeleteOptions,
+    DeleteResult,
+    QueryFilter,
+    QueryOptions,
+    FindResult,
+    UpdateOperation,
+    PrimaryKeyType,
+    CollectionStats,
+    CollectionEventListener,
+    CollectionEventType,
+    IndexConfig,
+} from "./types";
+/**
+ * 集合错误类
+ */
+export declare class CollectionError extends Error {
+    readonly code: string;
+    constructor(message: string, code: string);
+}
+/**
+ * LightDB 集合
+ * 类似数据库表的概念，提供类型安全的 CRUD 操作
+ */
+export declare class Collection<T extends Record<string, unknown>> implements QueryExecutor<T> {
+    private readonly name;
+    private readonly primaryKeyField;
+    private readonly indexManager;
+    private readonly eventListeners;
+    /**
+     * 创建集合实例
+     * @param options 集合配置选项
+     */
+    constructor(options: CollectionOptions<T>);
+    /**
+     * 获取集合名称
+     */
+    get Name(): string;
+    /**
+     * 获取主键字段名
+     */
+    get PrimaryKeyField(): string;
+    /**
+     * 获取文档数量
+     */
+    get Size(): number;
+    /**
+     * 插入单条文档
+     * @param doc 要插入的文档
+     * @param options 插入选项
+     */
+    insert(doc: T, options?: InsertOptions): InsertResult<T>;
+    /**
+     * 批量插入文档
+     * @param docs 要插入的文档数组
+     * @param options 插入选项
+     */
+    insertMany(docs: T[], options?: InsertOptions): InsertManyResult<T>;
+    /**
+     * 查找文档
+     * @param options 查询选项
+     */
+    find(options?: QueryOptions<T>): FindResult<T>;
+    /**
+     * 查找单条文档
+     * @param filter 查询条件
+     */
+    findOne(filter: QueryFilter<T>): T | null;
+    /**
+     * 通过主键查找文档
+     * @param primaryKey 主键值
+     */
+    findByPrimaryKey(primaryKey: PrimaryKeyType): T | undefined;
+    /**
+     * 通过二级索引查找文档
+     * @param indexName 索引名称
+     * @param value 索引值
+     */
+    findBySecondaryIndex(indexName: string, value: unknown): T[];
+    /**
+     * 更新文档
+     * @param filter 查询条件
+     * @param update 更新操作
+     * @param options 更新选项
+     */
+    update(filter: QueryFilter<T>, update: UpdateOperation<T>, options?: UpdateOptions): UpdateResult;
+    /**
+     * 更新单条文档
+     * @param filter 查询条件
+     * @param update 更新操作
+     * @param options 更新选项
+     */
+    updateOne(filter: QueryFilter<T>, update: UpdateOperation<T>, options?: Omit<UpdateOptions, "multi">): UpdateResult;
+    /**
+     * 更新多条文档
+     * @param filter 查询条件
+     * @param update 更新操作
+     * @param options 更新选项
+     */
+    updateMany(filter: QueryFilter<T>, update: UpdateOperation<T>, options?: Omit<UpdateOptions, "multi">): UpdateResult;
+    /**
+     * Upsert 操作
+     */
+    private upsert;
+    /**
+     * 删除文档
+     * @param filter 查询条件
+     * @param options 删除选项
+     */
+    delete(filter: QueryFilter<T>, options?: DeleteOptions): DeleteResult;
+    /**
+     * 删除单条文档
+     * @param filter 查询条件
+     * @param options 删除选项
+     */
+    deleteOne(filter: QueryFilter<T>, options?: Omit<DeleteOptions, "multi">): DeleteResult;
+    /**
+     * 删除多条文档
+     * @param filter 查询条件
+     * @param options 删除选项
+     */
+    deleteMany(filter: QueryFilter<T>, options?: Omit<DeleteOptions, "multi">): DeleteResult;
+    /**
+     * 通过主键删除文档
+     * @param primaryKey 主键值
+     */
+    deleteByPrimaryKey(primaryKey: PrimaryKeyType): boolean;
+    /**
+     * 统计文档数量
+     * @param filter 查询条件
+     */
+    count(filter?: QueryFilter<T>): number;
+    /**
+     * 检查文档是否存在
+     * @param filter 查询条件
+     */
+    exists(filter: QueryFilter<T>): boolean;
+    /**
+     * 创建查询构建器
+     */
+    query(): QueryBuilder<T>;
+    /**
+     * 清空集合
+     */
+    clear(): void;
+    /**
+     * 获取集合统计信息
+     */
+    getStats(): CollectionStats;
+    /**
+     * 创建二级索引
+     * @param config 索引配置
+     */
+    createIndex(config: IndexConfig<T>): void;
+    /**
+     * 删除二级索引
+     * @param name 索引名称
+     */
+    dropIndex(name: string): boolean;
+    /**
+     * 获取所有索引名称
+     */
+    getIndexNames(): string[];
+    /**
+     * 添加事件监听器
+     * @param event 事件类型
+     * @param listener 监听器函数
+     */
+    on(event: CollectionEventType, listener: CollectionEventListener<T>): void;
+    /**
+     * 移除事件监听器
+     * @param event 事件类型
+     * @param listener 监听器函数
+     */
+    off(event: CollectionEventType, listener: CollectionEventListener<T>): void;
+    /**
+     * 触发事件
+     */
+    private emitEvent;
+    /**
+     * 提取主键值
+     */
+    extractPrimaryKey(doc: T): PrimaryKeyType;
+    /**
+     * 应用更新操作
+     */
+    private applyUpdate;
+    /**
+     * 检查是否是更新操作符
+     */
+    private isUpdateOperators;
+    /**
+     * 应用更新操作符
+     */
+    private applyUpdateOperators;
+    /**
+     * 从更新操作创建文档
+     */
+    private createDocFromUpdate;
+    /**
+     * 获取所有文档
+     */
+    getAll(): T[];
+    /**
+     * 获取主键字段名（实现 QueryExecutor 接口）
+     */
+    getPrimaryKeyField(): string;
+    /**
+     * 获取二级索引字段列表（实现 QueryExecutor 接口）
+     */
+    getSecondaryIndexFields(): string[];
+    /**
+     * 验证集合一致性
+     */
+    validate(): {
+        valid: boolean;
+        errors: string[];
+    };
+    /**
+     * 重建所有索引
+     */
+    rebuildIndexes(): void;
+}
+//# sourceMappingURL=Collection.d.ts.map

package/dist/collection/Collection.d.ts.map

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