@yydb/light-db 0.0.0 → 0.0.11

package/dist/indexes/IndexManager.d.ts

@@ -1,236 +0,0 @@
-/**
- * LightDB 索引管理器实现
- * 统一管理主键索引和二级索引，提供自动维护功能
- */
-import { PrimaryIndex } from "./PrimaryIndex";
-import { SecondaryIndex } from "./SecondaryIndex";
-import type { IndexKey, IndexValue, IndexStats, IndexManagerOptions, EqualityCondition, KeyExtractor, ValueExtractor } from "./types";
-/**
- * 集合配置
- */
-export interface CollectionIndexConfig<T = unknown> {
-    /** 集合名称 */
-    name: string;
-    /** 主键字段名 */
-    primaryKey: string;
-    /** 主键提取器 */
-    primaryKeyExtractor: KeyExtractor<T>;
-    /** 二级索引配置 */
-    secondaryIndexes?: Array<{
-        name: string;
-        fieldName: string;
-        unique?: boolean;
-        sparse?: boolean;
-        valueExtractor: ValueExtractor<T>;
-    }>;
-}
-/**
- * 索引管理器
- * 提供索引的创建、查询、维护等统一管理功能
- */
-export declare class IndexManager<T = unknown> {
-    private readonly options;
-    private primaryIndex;
-    private readonly secondaryIndexes;
-    private readonly valueExtractors;
-    private readonly collectionName;
-    private readonly primaryKeyField;
-    private readonly primaryKeyExtractor;
-    /**
-     * 创建索引管理器实例
-     * @param config 集合配置
-     * @param options 索引管理器选项
-     */
-    constructor(config: CollectionIndexConfig<T>, options?: IndexManagerOptions);
-    /**
-     * 获取集合名称
-     */
-    get CollectionName(): string;
-    /**
-     * 获取主键字段名
-     */
-    get PrimaryKeyField(): string;
-    /**
-     * 获取主键索引
-     */
-    get PrimaryIndex(): PrimaryIndex<T>;
-    /**
-     * 获取记录数量
-     */
-    get Size(): number;
-    /**
-     * 初始化主键索引
-     */
-    private initializePrimaryIndex;
-    /**
-     * 初始化二级索引
-     */
-    private initializeSecondaryIndexes;
-    /**
-     * 创建二级索引
-     * @param config 索引配置
-     */
-    createSecondaryIndex(config: {
-        name: string;
-        fieldName: string;
-        unique?: boolean;
-        sparse?: boolean;
-        valueExtractor: ValueExtractor<T>;
-    }): SecondaryIndex;
-    /**
-     * 删除二级索引
-     * @param name 索引名称
-     */
-    dropSecondaryIndex(name: string): boolean;
-    /**
-     * 获取二级索引
-     * @param name 索引名称
-     */
-    getSecondaryIndex(name: string): SecondaryIndex;
-    /**
-     * 检查二级索引是否存在
-     * @param name 索引名称
-     */
-    hasSecondaryIndex(name: string): boolean;
-    /**
-     * 获取所有二级索引名称
-     */
-    getSecondaryIndexNames(): string[];
-    /**
-     * 插入记录
-     * @param record 记录
-     * @param throwOnDuplicate 如果主键已存在是否抛出异常
-     * @returns 是否插入成功
-     */
-    insert(record: T, throwOnDuplicate?: boolean): boolean;
-    /**
-     * 更新记录
-     * @param oldRecord 旧记录
-     * @param newRecord 新记录
-     * @param throwOnMissing 如果主键不存在是否抛出异常
-     * @returns 是否更新成功
-     */
-    update(oldRecord: T, newRecord: T, throwOnMissing?: boolean): boolean;
-    /**
-     * 删除记录
-     * @param record 要删除的记录
-     * @param throwOnMissing 如果主键不存在是否抛出异常
-     * @returns 被删除的记录，如果不存在返回 undefined
-     */
-    delete(record: T, throwOnMissing?: boolean): T | undefined;
-    /**
-     * 通过主键删除记录
-     * @param primaryKey 主键
-     * @param throwOnMissing 如果主键不存在是否抛出异常
-     * @returns 被删除的记录，如果不存在返回 undefined
-     */
-    deleteByKey(primaryKey: IndexKey, throwOnMissing?: boolean): T | undefined;
-    /**
-     * 通过主键查找记录
-     * @param primaryKey 主键
-     */
-    findByPrimaryKey(primaryKey: IndexKey): T | undefined;
-    /**
-     * 检查主键是否存在
-     * @param primaryKey 主键
-     */
-    hasByPrimaryKey(primaryKey: IndexKey): boolean;
-    /**
-     * 通过二级索引查找
-     * @param indexName 索引名称
-     * @param value 索引值
-     * @returns 匹配的记录数组
-     */
-    findBySecondaryIndex(indexName: string, value: IndexValue): T[];
-    /**
-     * 通过二级索引条件查询
-     * @param indexName 索引名称
-     * @param condition 查询条件
-     * @returns 匹配的记录数组
-     */
-    queryBySecondaryIndex(indexName: string, condition: EqualityCondition<IndexValue>): T[];
-    /**
-     * 主键范围查询
-     * @param start 起始键
-     * @param end 结束键
-     * @param includeStart 是否包含起始键
-     * @param includeEnd 是否包含结束键
-     * @returns 匹配的记录数组
-     */
-    rangeByPrimaryKey(start?: IndexKey, end?: IndexKey, includeStart?: boolean, includeEnd?: boolean): T[];
-    /**
-     * 二级索引范围查询
-     * @param indexName 索引名称
-     * @param start 起始值
-     * @param end 结束值
-     * @param includeStart 是否包含起始值
-     * @param includeEnd 是否包含结束值
-     * @returns 匹配的记录数组
-     */
-    rangeBySecondaryIndex(indexName: string, start?: IndexValue, end?: IndexValue, includeStart?: boolean, includeEnd?: boolean): T[];
-    /**
-     * 获取所有记录
-     */
-    getAll(): T[];
-    /**
-     * 获取所有主键
-     */
-    getAllPrimaryKeys(): IndexKey[];
-    /**
-     * 清空所有索引
-     */
-    clear(): void;
-    /**
-     * 获取所有索引统计信息
-     */
-    getStats(): IndexStats[];
-    /**
-     * 批量插入
-     * @param records 记录数组
-     * @param throwOnDuplicate 如果主键已存在是否抛出异常
-     */
-    insertBatch(
-        records: T[],
-        throwOnDuplicate?: boolean,
-    ): {
-        success: number;
-        failed: number;
-        errors: Array<{
-            index: number;
-            error: string;
-        }>;
-    };
-    /**
-     * 批量删除
-     * @param primaryKeys 主键数组
-     */
-    deleteBatch(primaryKeys: IndexKey[]): {
-        success: number;
-        failed: number;
-    };
-    /**
-     * 验证索引一致性
-     */
-    validate(): {
-        valid: boolean;
-        errors: Array<{
-            index: string;
-            errors: string[];
-        }>;
-    };
-    /**
-     * 重建所有索引
-     * @param records 所有记录
-     */
-    rebuild(records: T[]): void;
-    /**
-     * 重建指定二级索引
-     * @param indexName 索引名称
-     */
-    rebuildSecondaryIndex(indexName: string): void;
-    /**
-     * 获取估算的内存使用量
-     */
-    getMemoryUsage(): number;
-}
-//# sourceMappingURL=IndexManager.d.ts.map

package/dist/indexes/IndexManager.d.ts.map

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