@aiao/rxdb 0.0.5 → 0.0.7

package/dist/repository/QueryManager.d.ts

@@ -0,0 +1,69 @@
+import { Observable } from 'rxjs';
+import { EntityType } from '../entity/entity.interface.js';
+import { RxDBEntityLocalCreatedEventData, RxDBEntityLocalRemovedEventData, RxDBEntityLocalUpdatedEventData } from '../rxdb-events.js';
+import { RxDB } from '../RxDB.js';
+import { QueryOptions } from './QueryManager.interface.js';
+import { QueryTask } from './QueryTask.js';
+import { Repository } from './Repository.js';
+export type MergeQueryTaskCreateFn<T extends EntityType = any> = (task: QueryTask<T>, entities: RxDBEntityLocalCreatedEventData<T>[]) => void;
+export type MergeQueryTaskUpdateFn<T extends EntityType = any> = (task: QueryTask<T>, entities: RxDBEntityLocalUpdatedEventData<T>[]) => void;
+export type MergeQueryTaskRemoveFn<T extends EntityType = any> = (task: QueryTask<T>, entities: RxDBEntityLocalRemovedEventData<T>[]) => void;
+interface CreateTaskOptions<T extends EntityType, RT> {
+    /**
+     * 查询选项
+     */
+    options: QueryOptions<T>;
+    /**
+     * 查询执行函数
+     */
+    runner: (options?: QueryOptions<T>) => Observable<RT>;
+    /**
+     * 结果指纹计算方法
+     */
+    getFingerprint: (result: any) => any[];
+}
+/**
+ * 查询缓存管理器
+ *
+ * 用于管理查询任务的缓存和执行
+ * - 需要根据查询条件记录观察表的依赖关系
+ * - 统一计算何时 js 计算，何时重新执行 sql，减少适配器的开发难度
+ * - 未来配置 Repository 里的规则，与远程进行 pull/push
+ *
+ * 核心功能：
+ * 1. 查询结果缓存：相同查询条件复用缓存结果
+ * 2. 订阅管理：管理多个观察者的订阅和取消订阅
+ * 3. 自动清理：当没有观察者时自动清理缓存
+ * 4. 响应式刷新：支持手动刷新和自动刷新查询结果
+ */
+export declare class QueryManager<T extends EntityType> {
+    #private;
+    protected readonly rxdb: RxDB;
+    protected readonly EntityType: T;
+    protected readonly repository: Repository<T>;
+    /**
+     * 构造函数
+     *
+     * @param rxdb RxDB 实例，用于访问数据库和事件系统
+     * @param EntityType 实体类型，用于标识当前管理的实体
+     * @param repository 仓库实例，用于执行实际的查询操作
+     */
+    constructor(rxdb: RxDB, EntityType: T, repository: Repository<T>);
+    /**
+     * 创建查询任务
+     *
+     * 此方法根据查询选项创建或复用缓存的查询任务
+     * - 使用查询类型和选项的 hash 值作为缓存 key
+     * - 如果缓存中已存在相同的查询，直接返回缓存的任务
+     * - 每个查询任务管理多个观察者，当最后一个观察者取消订阅时自动清理任务
+     *
+     * @param taskOptions 查询任务选项
+     * @returns 查询任务对象，包含 result$ 用于订阅查询结果
+     */
+    createTask<RT = any>(taskOptions: CreateTaskOptions<T, RT>): QueryTask<T>;
+    registerMergeCreateFn(taskType: string, fn: MergeQueryTaskCreateFn<T>): void;
+    registerMergeUpdateFn(taskType: string, fn: MergeQueryTaskUpdateFn<T>): void;
+    registerMergeRemoveFn(taskType: string, fn: MergeQueryTaskRemoveFn<T>): void;
+}
+export {};
+//# sourceMappingURL=QueryManager.d.ts.map

package/dist/repository/QueryManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"QueryManager.d.ts","sourceRoot":"","sources":["../../src/repository/QueryManager.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,MAAM,CAAC;AAClC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAIhE,OAAO,EAOL,+BAA+B,EAE/B,+BAA+B,EAC/B,+BAA+B,EAChC,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAC3D,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAElD,MAAM,MAAM,sBAAsB,CAAC,CAAC,SAAS,UAAU,GAAG,GAAG,IAAI,CAC/D,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC,EAClB,QAAQ,EAAE,+BAA+B,CAAC,CAAC,CAAC,EAAE,KAC3C,IAAI,CAAC;AAEV,MAAM,MAAM,sBAAsB,CAAC,CAAC,SAAS,UAAU,GAAG,GAAG,IAAI,CAC/D,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC,EAClB,QAAQ,EAAE,+BAA+B,CAAC,CAAC,CAAC,EAAE,KAC3C,IAAI,CAAC;AAEV,MAAM,MAAM,sBAAsB,CAAC,CAAC,SAAS,UAAU,GAAG,GAAG,IAAI,CAC/D,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC,EAClB,QAAQ,EAAE,+BAA+B,CAAC,CAAC,CAAC,EAAE,KAC3C,IAAI,CAAC;AAEV,UAAU,iBAAiB,CAAC,CAAC,SAAS,UAAU,EAAE,EAAE;IAClD;;OAEG;IACH,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC;IACzB;;OAEG;IACH,MAAM,EAAE,CAAC,OAAO,CAAC,EAAE,YAAY,CAAC,CAAC,CAAC,KAAK,UAAU,CAAC,EAAE,CAAC,CAAC;IACtD;;OAEG;IACH,cAAc,EAAE,CAAC,MAAM,EAAE,GAAG,KAAK,GAAG,EAAE,CAAC;CACxC;AAED;;;;;;;;;;;;;GAaG;AACH,qBAAa,YAAY,CAAC,CAAC,SAAS,UAAU;;IAkB1C,SAAS,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI;IAC7B,SAAS,CAAC,QAAQ,CAAC,UAAU,EAAE,CAAC;IAChC,SAAS,CAAC,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC,CAAC;IAV9C;;;;;;OAMG;gBAEkB,IAAI,EAAE,IAAI,EACV,UAAU,EAAE,CAAC,EACb,UAAU,EAAE,UAAU,CAAC,CAAC,CAAC;IAQ9C;;;;;;;;;;OAUG;IACI,UAAU,CAAC,EAAE,GAAG,GAAG,EAAE,WAAW,EAAE,iBAAiB,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC;IAehF,qBAAqB,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,sBAAsB,CAAC,CAAC,CAAC;IAIrE,qBAAqB,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,sBAAsB,CAAC,CAAC,CAAC;IAIrE,qBAAqB,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,sBAAsB,CAAC,CAAC,CAAC;CAmKtE"}

package/dist/repository/QueryManager.interface.d.ts

@@ -0,0 +1,106 @@
+import { EntityStaticType, EntityType } from '../entity/entity.interface.js';
+import { CountOptions, FindAllOptions, FindByCursorOptions, FindOneOptions, FindOneOrFailOptions, FindOptions } from './query-options.interface.js';
+import { FindTreeOptions } from './tree-repository.interface.js';
+/**
+ * Get 查询任务
+ * 根据 ID 获取单个实体的查询任务
+ */
+export interface GetQuery<T extends EntityType> {
+    type: 'get';
+    options: EntityStaticType<T, 'idType'>;
+}
+/**
+ * FindOne 查询任务
+ * 查找符合条件的第一个实体，可能返回 null
+ */
+export interface FindOneQuery<T extends EntityType> {
+    type: 'findOne';
+    options: FindOneOptions<T>;
+}
+/**
+ * FindOneOrFail 查询任务
+ * 查找符合条件的第一个实体，找不到时抛出错误
+ */
+export interface FindOneOrFailQuery<T extends EntityType> {
+    type: 'findOneOrFail';
+    options: FindOneOrFailOptions<T>;
+}
+/**
+ * Find 查询任务
+ * 查找符合条件的所有实体
+ */
+export interface FindQuery<T extends EntityType> {
+    type: 'find';
+    options: FindOptions<T>;
+}
+/**
+ * FindAll 查询任务
+ * 查找所有实体
+ */
+export interface FindAllQuery<T extends EntityType> {
+    type: 'findAll';
+    options: FindAllOptions<T>;
+}
+/**
+ * FindByCursor 查询任务
+ * 使用游标分页查找实体
+ */
+export interface FindByCursorQuery<T extends EntityType> {
+    type: 'findByCursor';
+    options: FindByCursorOptions<T>;
+}
+/**
+ * Count 查询任务
+ * 统计符合条件的实体数量
+ */
+export interface CountQuery<T extends EntityType> {
+    type: 'count';
+    options: CountOptions<T>;
+}
+/**
+ * FindDescendants 查询任务
+ * 查找指定实体的所有后代节点
+ */
+export interface FindDescendantsQuery<T extends EntityType> {
+    type: 'findDescendants';
+    options: FindTreeOptions<T>;
+}
+/**
+ * FindAncestors 查询任务
+ * 查找指定实体的所有祖先节点
+ */
+export interface FindAncestorsQuery<T extends EntityType> {
+    type: 'findAncestors';
+    options: FindTreeOptions<T>;
+}
+/**
+ * CountDescendants 查询任务
+ * 统计指定实体的后代节点数量
+ */
+export interface CountDescendantsQuery<T extends EntityType> {
+    type: 'countDescendants';
+    options: FindTreeOptions<T>;
+}
+/**
+ * CountAncestors 查询任务
+ * 统计指定实体的祖先节点数量
+ */
+export interface CountAncestorsQuery<T extends EntityType> {
+    type: 'countAncestors';
+    options: FindTreeOptions<T>;
+}
+export type QueryOptions<T extends EntityType> = GetQuery<T> | FindOneQuery<T> | FindOneOrFailQuery<T> | FindQuery<T> | FindAllQuery<T> | FindByCursorQuery<T> | CountQuery<T> | CountAncestorsQuery<T> | CountDescendantsQuery<T> | FindAncestorsQuery<T> | FindDescendantsQuery<T>;
+/**
+ * 刷新匹配规则名称
+ * 定义查询缓存刷新时的匹配规则类型
+ */
+type RefreshMatchRuleName = 'match_where' | 'match_order_by' | 'match_relation_where' | 'not_match_relation_where' | 'result_contains' | 'not_match_where' | 'result_not_contains' | 'match_where_before' | 'not_match_where_before';
+/**
+ * 刷新匹配规则
+ * 二维数组表示多组规则的组合，每组规则内的条件是 AND 关系，组与组之间是 OR 关系
+ * 例如：[['match_where', 'result_contains'], ['not_match_where']]
+ * 表示：(匹配查询条件 AND 结果包含) OR (不匹配查询条件)
+ */
+export type RefreshMatchRules = RefreshMatchRuleName[][];
+export {};
+//# sourceMappingURL=QueryManager.interface.d.ts.map

package/dist/repository/QueryManager.interface.d.ts.map

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

package/dist/repository/QueryTask.d.ts

@@ -0,0 +1,150 @@
+import { Observable, Observer } from 'rxjs';
+import { EntityStaticType, EntityType } from '../entity/entity.interface.js';
+import { RxDBEntityLocalEventData } from '../rxdb-events.js';
+import { RxDB } from '../RxDB.js';
+import { QueryOptions } from './QueryManager.interface.js';
+/**
+ * 查询任务选项接口
+ */
+export interface QueryTaskOptions<T extends EntityType> {
+    /**
+     * 缓存键
+     */
+    cacheKey: string;
+    /**
+     * 查询选项
+     */
+    options: QueryOptions<T>;
+    /**
+     * 查询执行函数
+     */
+    runner: () => Observable<any>;
+    /**
+     * 实体类型
+     */
+    entityType: T;
+    /**
+     * RxDB 实例
+     */
+    rxdb: RxDB;
+    /**
+     * 依赖的实体类型映射
+     */
+    depEntityTypeMap: Map<T, number>;
+    /**
+     * 序列化函数
+     */
+    serialize: (data: RxDBEntityLocalEventData<T>) => InstanceType<T>;
+    /**
+     * 清理函数
+     */
+    onClean: (cacheKey: string) => void;
+    /**
+     * 结果指纹计算方法
+     */
+    getFingerprint: (result: any) => any[];
+}
+/**
+ * 查询任务实现
+ *
+ * 封装查询任务的创建和生命周期管理
+ * - 管理任务的刷新和销毁信号
+ * - 处理观察者的订阅和取消订阅
+ * - 维护实体类型依赖关系
+ * - 提供任务的首次运行和清理机制
+ */
+export declare class QueryTask<T extends EntityType, RT = any> {
+    #private;
+    private readonly runner;
+    private readonly onClean;
+    /**
+     * 观察者集合
+     * 存储所有订阅此查询结果的观察者
+     */
+    readonly observers: Set<Observer<any>>;
+    readonly serialize: (data: RxDBEntityLocalEventData<T>) => InstanceType<T>;
+    readonly cacheKey: string;
+    readonly entityType: T;
+    readonly rxdb: RxDB;
+    readonly depEntityTypeMap: Map<T, number>;
+    /**
+     * 刷新触发流
+     * 每次刷新时发送刷新次数，用于触发查询重新执行
+     */
+    readonly refresh$: Observable<number>;
+    /**
+     * 查询销毁流
+     * 当查询任务被销毁时触发
+     */
+    readonly destroy$: Observable<void>;
+    /**
+     * 关联实体类型集合
+     * 存储查询中涉及到的所有关联实体类型
+     */
+    readonly relationEntityTypes: Set<T>;
+    /**
+     * 查询的实体 ID 集合
+     */
+    readonly resultEntityIds: Set<EntityStaticType<T, "idType">>;
+    /**
+     * 查询的实体集合
+     * 存储查询结果中包含的所有实体实例
+     */
+    readonly resultEntitySet: Set<InstanceType<T>>;
+    /**
+     * 查询类型
+     */
+    readonly type: 'get' | 'findOne' | 'findOneOrFail' | 'find' | 'findAll' | 'findByCursor' | 'count' | 'findDescendants' | 'findAncestors' | 'countDescendants' | 'countAncestors' | 'findNeighbors' | 'countNeighbors' | 'findPaths';
+    /**
+     * 查询选项
+     */
+    readonly options: QueryOptions<T>['options'];
+    /**
+     * 观察者数量
+     * 记录当前有多少个订阅者正在监听此查询结果
+     */
+    observerCount: number;
+    /**
+     * 刷新次数
+     * 记录查询被刷新执行的总次数
+     */
+    refreshCount: number;
+    /**
+     * 查询结果
+     * 缓存的最新查询结果数据
+     */
+    result?: RT;
+    /**
+     * 结果指纹计算方法
+     */
+    getFingerprint: (result: any) => (string | number)[];
+    /**
+     * 查询结果流
+     * 通过 Observable 发送查询结果的响应式流
+     */
+    result$: Observable<RT>;
+    constructor(opt: QueryTaskOptions<T>);
+    /**
+     * 清理任务资源
+     */
+    clean: () => void;
+    /**
+     * 首次运行查询任务
+     */
+    run: () => void;
+    /**
+     * 发送结果给所有观察者
+     * @param result 查询结果
+     * @param autoCache 是否自动缓存结果实体
+     */
+    next: (result: any, autoCache?: boolean) => void;
+    /**
+     * 发送错误给所有观察者
+     */
+    error: (err: any) => void;
+    /**
+     * 手动刷新查询
+     */
+    refresh: () => void;
+}
+//# sourceMappingURL=QueryTask.d.ts.map

package/dist/repository/QueryTask.d.ts.map

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

package/dist/repository/Repository.d.ts

@@ -1,102 +1,96 @@
-import { BehaviorSubject, Observable } from 'rxjs';
-import { SyncOptions } from '../entity/entity-metadata-options.interface.js';
+import { Observable } from 'rxjs';
 import { EntityStaticType, EntityType } from '../entity/entity.interface.js';
-import { IRxDBAdapter, RxDBAdapterLocalBase, RxDBAdapterRemoteBase } from '../rxdb-adapter.js';
+import { SyncOptions } from '../entity/metadata-options.interface.js';
 import { RxDB } from '../RxDB.js';
-import { CountOptions, FindAllOptions, FindOneOptions, FindOneOrFailOptions, FindOptions } from './query-options.interface.js';
+import { CountOptions, FindAllOptions, FindByCursorOptions, FindOneOptions, FindOneOrFailOptions, FindOptions } from './query-options.interface.js';
+import { QueryManager } from './QueryManager.js';
 import { IRepository } from './repository.interface.js';
+import { RepositoryBase } from './RepositoryBase.js';
 /**
  * 实体仓库
  * 根据配置决策实体的具体操作
  */
-export declare class Repository<T extends EntityType, RT extends IRepository<T> = IRepository<T>> implements IRepository<T> {
-    protected rxdb: RxDB;
-    protected EntityType: EntityType;
+export declare class Repository<T extends EntityType, RT extends IRepository<T> = IRepository<T>> extends RepositoryBase<T> {
+    protected static _STATIC_METHODS: string[];
     /**
-     * 本地适配器
+     * 本地仓库
      */
-    protected localAdapterSub: BehaviorSubject<string>;
-    protected localAdapter$: Observable<IRxDBAdapter & RxDBAdapterLocalBase>;
+    protected readonly local$: Observable<RT>;
     /**
-     * 本地仓库
+     * 远程仓库
      */
-    protected local$: Observable<RT>;
+    protected readonly remote$: Observable<IRepository<T>>;
     /**
-     * 远程适配器
+     * 主仓库（根据 SyncOptions 选择 local 或 remote）
+     * - SyncType.None + 只有 remote：使用 remote$
+     * - 其他情况：使用 local$
      */
-    protected remoteAdapterSub: BehaviorSubject<string>;
-    protected remoteAdapter$: Observable<IRxDBAdapter & RxDBAdapterRemoteBase>;
+    protected readonly primary$: Observable<RT>;
     /**
-     * 远程仓库
+     * 查询缓存管理器
      */
-    protected remote$: Observable<IRepository<EntityType>>;
+    protected readonly queryManager: QueryManager<T>;
     /**
      * 同步配置
-     * TODO: 待实现同步功能
      */
-    sync: SyncOptions;
-    constructor(rxdb: RxDB, EntityType: EntityType);
+    readonly sync: SyncOptions;
+    constructor(rxdb: RxDB, EntityType: T);
     /**
      * 根据 id 获取实体
-     * @param id
-     * @param options
+     * @param id 实体的唯一标识符
      */
     get(id: EntityStaticType<T, 'idType'>): Observable<InstanceType<T>>;
     /**
      * 查找一个实体
-     * @param where
-     * @param options
+     * @param options 查询选项，包含 where 条件
      */
-    findOne(options: FindOneOptions<T>): Observable<InstanceType<T> | undefined>;
+    findOne(options: FindOneOptions<T>): Observable<InstanceType<T> | null>;
     /**
      * 查找一个实体，查不到就抛出错误
-     * @param where
-     * @param options
+     * @param options 查询选项，包含 where 条件
      */
     findOneOrFail(options: FindOneOrFailOptions<T>): Observable<InstanceType<T>>;
     /**
      * 查询多个实体
-     * @param where
-     * @param options
+     * @param options 查询选项，包含 where 条件、limit、offset 等
      */
     find(options: FindOptions<T>): Observable<InstanceType<T>[]>;
     /**
      * 查询所有实体
-     * @param where
-     * @param options
+     * @param options 查询选项，包含 where 条件和排序（不限制数量）
+  
      */
     findAll(options: FindAllOptions<T>): Observable<InstanceType<T>[]>;
     /**
-     * 查询实体数量
-     * @param where
-     * @param options
+     * 通过游标进行分页查询
+     * @param options 游标分页选项，包含 orderBy、before/after 游标
      */
-    count(options: CountOptions<T>): Observable<number>;
+    findByCursor(options: FindByCursorOptions<T>): Observable<InstanceType<T>[]>;
     /**
-     * 事务保存
-     * @param entities 需要保存的实体
+     * 查询实体数量
+     * @param options 查询选项，包含 where 条件
      */
-    saveMany(entities: InstanceType<T>[]): Promise<InstanceType<T>[]>;
+    count(options: CountOptions<T>): Observable<number>;
     /**
      * 创建实体
-     * @param entity
+     * @param entity 要创建的实体实例
      */
     create(entity: InstanceType<T>): Promise<InstanceType<T>>;
     /**
      * 更新实体
-     * @param entity
-     * @param patch
+     * @param entity 要更新的实体实例
+     * @param patch 部分更新数据
      */
     update(entity: InstanceType<T>, patch: Partial<InstanceType<T>>): Promise<InstanceType<T>>;
     /**
      * 删除实体
-     * @param entity
+     * @param entity 要删除的实体实例
      */
     remove(entity: InstanceType<T>): Promise<InstanceType<T>>;
     /**
      * 设置状态 local
      */
-    protected _setLocalEntityStatus: (entity: InstanceType<T>) => boolean;
-    protected _setLocalEntitiesStatus: (entities: InstanceType<T>[]) => void;
+    protected _setLocal: (entity: InstanceType<T>) => void;
+    protected _setLocals: (entities: InstanceType<T>[]) => void;
 }
 //# sourceMappingURL=Repository.d.ts.map

package/dist/repository/Repository.d.ts.map

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

package/dist/repository/RepositoryBase.d.ts

@@ -1,20 +1,20 @@
-import { EntityStaticType, EntityType } from '../entity/entity.interface.js';
+import { EntityStaticType, EntityType, EntityUpdateData, IEntity } from '../entity/entity.interface.js';
 import { RxDB } from '../RxDB.js';
 /**
  * 数据仓库
  * 用来协调数据存取
  */
-export declare abstract class RepositoryBase<T extends EntityType> {
+export declare abstract class RepositoryBase<T extends EntityType & (new (...args: any[]) => IEntity)> {
     protected readonly rxdb: RxDB;
-    protected readonly EntityClass: T;
-    constructor(rxdb: RxDB, EntityClass: T);
+    readonly EntityType: T;
+    protected static _STATIC_METHODS: string[];
+    static get staticMethods(): string[];
+    constructor(rxdb: RxDB, EntityType: T);
     /**
      * 获取实体实例
      * @param data 实体数据
      */
-    createEntityRef(data: Partial<InstanceType<T>> & {
-        id: EntityStaticType<T, 'idType'>;
-    }): any;
+    createEntityRef(data: EntityUpdateData<T>): any;
     /**
      * 获取实体实例
      * @param id 实体的 ID
@@ -28,6 +28,6 @@ export declare abstract class RepositoryBase<T extends EntityType> {
     /**
      * 更新实体
      */
-    updateEntity(entity: InstanceType<T>, newValue: Partial<InstanceType<T>>): void;
+    updateEntity(entity: InstanceType<T>, update: InstanceType<T>): void;
 }
 //# sourceMappingURL=RepositoryBase.d.ts.map

package/dist/repository/RepositoryBase.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"RepositoryBase.d.ts","sourceRoot":"","sources":["../../src/repository/RepositoryBase.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAE7E,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAGvC;;;GAGG;AACH,8BAAsB,cAAc,CAAC,CAAC,SAAS,UAAU;IAErD,SAAS,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI;IAC7B,SAAS,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC;gBADd,IAAI,EAAE,IAAI,EACV,WAAW,EAAE,CAAC;IAGnC;;;OAGG;IACH,eAAe,CAAC,IAAI,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,GAAG;QAAE,EAAE,EAAE,gBAAgB,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAA;KAAE;IAItF;;;OAGG;IACH,YAAY,CAAC,EAAE,EAAE,gBAAgB,CAAC,CAAC,EAAE,QAAQ,CAAC,GAAG,YAAY,CAAC,CAAC,CAAC,GAAG,SAAS;IAI5E;;;OAGG;IACH,YAAY,CAAC,EAAE,EAAE,gBAAgB,CAAC,CAAC,EAAE,QAAQ,CAAC,GAAG,OAAO;IAIxD;;OAEG;IACH,YAAY,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;CAOzE"}
+{"version":3,"file":"RepositoryBase.d.ts","sourceRoot":"","sources":["../../src/repository/RepositoryBase.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,UAAU,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,+BAA+B,CAAC;AAExG,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAEvC;;;GAGG;AACH,8BAAsB,cAAc,CAAC,CAAC,SAAS,UAAU,GAAG,CAAC,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,OAAO,CAAC;IAQzF,SAAS,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI;aACb,UAAU,EAAE,CAAC;IAR/B,SAAS,CAAC,MAAM,CAAC,eAAe,EAAE,MAAM,EAAE,CAAM;IAEhD,MAAM,KAAK,aAAa,aAEvB;gBAGoB,IAAI,EAAE,IAAI,EACb,UAAU,EAAE,CAAC;IAG/B;;;OAGG;IACH,eAAe,CAAC,IAAI,EAAE,gBAAgB,CAAC,CAAC,CAAC;IAIzC;;;OAGG;IACH,YAAY,CAAC,EAAE,EAAE,gBAAgB,CAAC,CAAC,EAAE,QAAQ,CAAC,GAAG,YAAY,CAAC,CAAC,CAAC,GAAG,SAAS;IAI5E;;;OAGG;IACH,YAAY,CAAC,EAAE,EAAE,gBAAgB,CAAC,CAAC,EAAE,QAAQ,CAAC,GAAG,OAAO;IAIxD;;OAEG;IACH,YAAY,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC;CAK9D"}

package/dist/repository/TreeRepository.d.ts

@@ -1,14 +1,39 @@
 import { Observable } from 'rxjs';
 import { EntityType } from '../entity/entity.interface.js';
+import { ITreeEntity } from '../entity/tree-entity.interface.js';
 import { Repository } from './Repository.js';
-import { FindTreeOptions, FindTreeRootOptions, ITreeRepository } from './tree-repository.interface.js';
+import { FindTreeOptions, ITreeRepository } from './tree-repository.interface.js';
 /**
  * 树结构实体仓库
  * 根据配置决策实体的具体操作
+ *
+ * @template T - 必须是实现 ITreeEntity 接口的实体类型（通常继承 TreeAdjacencyListEntityBase）
+ *
+ * @example
+ * ```typescript
+ * // ✅ 正确：继承 TreeAdjacencyListEntityBase
+ * @Entity({ name: 'Category' })
+ * class Category extends TreeAdjacencyListEntityBase {
+ *   name!: string;
+ * }
+ *
+ * // 可以使用树查询方法
+ * Category.findDescendants({ entityId: 'root-id' });
+ * Category.findAncestors({ entityId: 'leaf-id' });
+ *
+ * // ❌ 错误：只继承 EntityBase，没有实现 ITreeEntity
+ * @Entity({ name: 'User' })
+ * class User extends EntityBase {
+ *   name!: string;
+ * }
+ *
+ * // 编译错误：User 不满足 TreeRepository 的类型约束
+ * // User.findDescendants({ entityId: 'id' }); // TypeScript 错误
+ * ```
  */
-export declare class TreeRepository<T extends EntityType, RepositoryType extends ITreeRepository<T> = ITreeRepository<T>> extends Repository<T, RepositoryType> implements ITreeRepository<T> {
-    findRoot(options?: FindTreeRootOptions<T>): Observable<InstanceType<T>[]>;
-    countRoot(options?: FindTreeRootOptions<T>): Observable<number>;
+export declare class TreeRepository<T extends EntityType & (new (...args: any[]) => ITreeEntity), RepositoryType extends ITreeRepository<T> = ITreeRepository<T>> extends Repository<T, RepositoryType> {
+    #private;
+    protected static _STATIC_METHODS: string[];
     /**
      * 查询子孙
      */

package/dist/repository/TreeRepository.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TreeRepository.d.ts","sourceRoot":"","sources":["../../src/repository/TreeRepository.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAkB,MAAM,MAAM,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAC3D,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAEvG;;;GAGG;AACH,qBAAa,cAAc,CAAC,CAAC,SAAS,UAAU,EAAE,cAAc,SAAS,eAAe,CAAC,CAAC,CAAC,GAAG,eAAe,CAAC,CAAC,CAAC,CAC9G,SAAQ,UAAU,CAAC,CAAC,EAAE,cAAc,CACpC,YAAW,eAAe,CAAC,CAAC,CAAC;IAE7B,QAAQ,CAAC,OAAO,CAAC,EAAE,mBAAmB,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC;IAOzE,SAAS,CAAC,OAAO,CAAC,EAAE,mBAAmB,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC,MAAM,CAAC;IAI/D;;OAEG;IACH,eAAe,CAAC,OAAO,EAAE,eAAe,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC;IAO3E;;OAEG;IACH,gBAAgB,CAAC,OAAO,EAAE,eAAe,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC,MAAM,CAAC;IAIjE;;OAEG;IACH,aAAa,CAAC,OAAO,EAAE,eAAe,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC;IAOzE;;OAEG;IACH,cAAc,CAAC,OAAO,EAAE,eAAe,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC,MAAM,CAAC;CAGhE"}
+{"version":3,"file":"TreeRepository.d.ts","sourceRoot":"","sources":["../../src/repository/TreeRepository.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAkB,MAAM,MAAM,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAC3D,OAAO,EAAE,WAAW,EAAE,MAAM,oCAAoC,CAAC;AAEjE,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAIlF;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,qBAAa,cAAc,CACzB,CAAC,SAAS,UAAU,GAAG,CAAC,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,WAAW,CAAC,EAC5D,cAAc,SAAS,eAAe,CAAC,CAAC,CAAC,GAAG,eAAe,CAAC,CAAC,CAAC,CAC9D,SAAQ,UAAU,CAAC,CAAC,EAAE,cAAc,CAAC;;IACrC,iBAA0B,eAAe,WAMvC;IAEF;;OAEG;IACH,eAAe,CAAC,OAAO,EAAE,eAAe,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC;IAc3E;;OAEG;IACH,gBAAgB,CAAC,OAAO,EAAE,eAAe,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC,MAAM,CAAC;IAUjE;;OAEG;IACH,aAAa,CAAC,OAAO,EAAE,eAAe,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC;IAczE;;OAEG;IACH,cAAc,CAAC,OAAO,EAAE,eAAe,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC,MAAM,CAAC;CAwBhE"}

package/dist/repository/fingerprint.utils.d.ts

@@ -0,0 +1,28 @@
+import { EntityType } from '../entity/entity.interface.js';
+/**
+ * 指纹类型
+ */
+export type Fingerprint = string | number | boolean | null | undefined;
+/**
+ * 值类型指纹计算
+ * 用于 count 等返回原始值的查询
+ *
+ * @param value - 要计算指纹的值
+ * @returns 指纹数组
+ */
+export declare const getFingerprintPrimitive: <T extends Fingerprint>(value: T | T[]) => Fingerprint[];
+/**
+ * 单个实体指纹计算
+ *
+ * @param entity - 要计算指纹的实体
+ * @returns 指纹数组
+ */
+export declare const getFingerprintByEntity: <T extends EntityType>(entity: InstanceType<T> | null | undefined) => Fingerprint[];
+/**
+ * 多个实体指纹计算
+ *
+ * @param entities - 要计算指纹的实体数组
+ * @returns 指纹数组
+ */
+export declare const getFingerprintByEntities: <T extends EntityType>(entities: InstanceType<T>[]) => Fingerprint[];
+//# sourceMappingURL=fingerprint.utils.d.ts.map

package/dist/repository/fingerprint.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fingerprint.utils.d.ts","sourceRoot":"","sources":["../../src/repository/fingerprint.utils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAG3D;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,CAAC;AAEvE;;;;;;GAMG;AACH,eAAO,MAAM,uBAAuB,GAAI,CAAC,SAAS,WAAW,EAAE,OAAO,CAAC,GAAG,CAAC,EAAE,KAAG,WAAW,EACnD,CAAC;AAEzC;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB,GAAI,CAAC,SAAS,UAAU,EACzD,QAAQ,YAAY,CAAC,CAAC,CAAC,GAAG,IAAI,GAAG,SAAS,KACzC,WAAW,EAIb,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,wBAAwB,GAAI,CAAC,SAAS,UAAU,EAAE,UAAU,YAAY,CAAC,CAAC,CAAC,EAAE,KAAG,WAAW,EAIpG,CAAC"}