@aiao/rxdb 0.0.6 → 0.0.8

package/dist/query/entity_type_dependencies.d.ts

@@ -10,12 +10,13 @@ import { RxDB } from '../RxDB.js';
  * - 关系字段（如 user.name）：添加关联实体类型
  * - MANY_TO_MANY 关系：额外添加中间表实体类型
  * - keyValue 字段：无额外依赖
+ * - EXISTS/NOT EXISTS 操作符：添加关联实体及其子查询依赖
  *
  * @param rxdb RxDB 实例
  * @param where 查询条件
  * @param EntityType 主查询的实体类型
  * @param relationEntityTypes 用于收集依赖实体类型的集合
  */
-declare const _default: <T extends EntityType>(rxdb: RxDB, where: RuleGroup<T>, EntityType: EntityType, relationEntityTypes: Set<EntityType>) => void;
-export default _default;
+declare const extractEntityTypeDependencies: <T extends EntityType>(rxdb: RxDB, where: RuleGroup<T>, EntityType: EntityType, relationEntityTypes: Set<EntityType>) => void;
+export default extractEntityTypeDependencies;
 //# sourceMappingURL=entity_type_dependencies.d.ts.map

package/dist/query/entity_type_dependencies.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"entity_type_dependencies.d.ts","sourceRoot":"","sources":["../../src/query/entity_type_dependencies.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAG3D,OAAO,EAAE,SAAS,EAAE,MAAM,kCAAkC,CAAC;AAE7D,OAAO,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAyIlC;;;;;;;;;;;;;;GAcG;yBACa,CAAC,SAAS,UAAU,EAClC,MAAM,IAAI,EACV,OAAO,SAAS,CAAC,CAAC,CAAC,EACnB,YAAY,UAAU,EACtB,qBAAqB,GAAG,CAAC,UAAU,CAAC;AAJtC,wBAyBE"}
+{"version":3,"file":"entity_type_dependencies.d.ts","sourceRoot":"","sources":["../../src/query/entity_type_dependencies.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAG3D,OAAO,EAAE,SAAS,EAAE,MAAM,kCAAkC,CAAC;AAE7D,OAAO,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAyIlC;;;;;;;;;;;;;;;GAeG;AACH,QAAA,MAAM,6BAA6B,GAAI,CAAC,SAAS,UAAU,EACzD,MAAM,IAAI,EACV,OAAO,SAAS,CAAC,CAAC,CAAC,EACnB,YAAY,UAAU,EACtB,qBAAqB,GAAG,CAAC,UAAU,CAAC,SA8ErC,CAAC;AAEF,eAAe,6BAA6B,CAAC"}

package/dist/query/merge-update-basic.d.ts

@@ -0,0 +1,30 @@
+import { EntityType } from '../entity/entity.interface.js';
+import { QueryTask } from '../repository/QueryTask.js';
+import { UpdateClassification, UpdateDataCache } from './merge-update.utils.js';
+/**
+ * 处理 findAll 查询更新
+ *
+ * 注意：patch 可能是增量数据（跨 Tab 场景），不是完整实体
+ * 因此对于结果集中已有的实体，需要合并 patch 而不是替换
+ */
+export declare const handleFindAllUpdate: <T extends EntityType>(task: QueryTask<T>, classification: UpdateClassification, cache: UpdateDataCache<T>) => void;
+/**
+ * 处理 find 查询更新 (分页查询)
+ */
+export declare const handleFindUpdate: <T extends EntityType>(task: QueryTask<T>, classification: UpdateClassification) => void;
+/**
+ * 处理 findByCursor 查询更新
+ */
+export declare const handleFindByCursorUpdate: <T extends EntityType>(task: QueryTask<T>, classification: UpdateClassification) => void;
+/**
+ * 处理 findOne/findOneOrFail 查询更新
+ *
+ * 注意：patch 可能是增量数据（跨 Tab 场景），不是完整实体
+ * 因此对于当前结果，需要合并 patch 而不是替换
+ */
+export declare const handleFindOneUpdate: <T extends EntityType>(task: QueryTask<T>, classification: UpdateClassification, cache: UpdateDataCache<T>) => void;
+/**
+ * 处理 count 查询更新
+ */
+export declare const handleCountUpdate: <T extends EntityType>(task: QueryTask<T>, classification: UpdateClassification) => void;
+//# sourceMappingURL=merge-update-basic.d.ts.map

package/dist/query/merge-update-basic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge-update-basic.d.ts","sourceRoot":"","sources":["../../src/query/merge-update-basic.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAE3D,OAAO,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AACvD,OAAO,EAAE,oBAAoB,EAAE,eAAe,EAAe,MAAM,yBAAyB,CAAC;AAG7F;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,GAAI,CAAC,SAAS,UAAU,EACtD,MAAM,SAAS,CAAC,CAAC,CAAC,EAClB,gBAAgB,oBAAoB,EACpC,OAAO,eAAe,CAAC,CAAC,CAAC,SA8C1B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,gBAAgB,GAAI,CAAC,SAAS,UAAU,EAAE,MAAM,SAAS,CAAC,CAAC,CAAC,EAAE,gBAAgB,oBAAoB,SAgB9G,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,wBAAwB,GAAI,CAAC,SAAS,UAAU,EAC3D,MAAM,SAAS,CAAC,CAAC,CAAC,EAClB,gBAAgB,oBAAoB,SAiBrC,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,GAAI,CAAC,SAAS,UAAU,EACtD,MAAM,SAAS,CAAC,CAAC,CAAC,EAClB,gBAAgB,oBAAoB,EACpC,OAAO,eAAe,CAAC,CAAC,CAAC,SA8C1B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,iBAAiB,GAAI,CAAC,SAAS,UAAU,EAAE,MAAM,SAAS,CAAC,CAAC,CAAC,EAAE,gBAAgB,oBAAoB,SAU/G,CAAC"}

package/dist/query/merge-update-tree.d.ts

@@ -0,0 +1,86 @@
+import { EntityType } from '../entity/entity.interface.js';
+import { QueryTask } from '../repository/QueryTask.js';
+import { RxDBEntityLocalUpdatedEventData } from '../rxdb-events.js';
+import { UpdateClassification, UpdateDataCache } from './merge-update.utils.js';
+/**
+ * 处理 findDescendants 查询的增量更新
+ *
+ * UPDATE 场景下的复杂性:
+ * 1. 实体的 parentId 可能变化，导致树形结构重组
+ * 2. 实体可能从不是后代变成后代，或从后代变成非后代
+ * 3. 实体仍然是后代，但字段值变化（如名称、描述等）
+ * 4. 需要考虑 level 限制（只查询特定层级的后代）
+ *
+ * 更新策略:
+ * - 移除: 不再匹配 where 条件 或 不再是后代 或 超出 level 范围
+ * - 更新: 仍在结果集中的实体，更新其字段值
+ * - 添加: 新匹配 where 条件 且 成为后代 且 在 level 范围内
+ *
+ * @param task 查询任务
+ * @param data 更新的实体数据列表
+ * @param classification 更新分类结果
+ * @param cache 更新数据缓存
+ */
+export declare const handleFindDescendantsUpdate: <T extends EntityType>(task: QueryTask<T>, data: RxDBEntityLocalUpdatedEventData<T>[], classification: UpdateClassification, cache: UpdateDataCache<T>) => void;
+/**
+ * 处理 findAncestors 查询的增量更新
+ *
+ * UPDATE 场景下的复杂性:
+ * 1. 目标实体的祖先链路可能因为其他实体的 parentId 变化而改变
+ * 2. 实体可能从不是祖先变成祖先，或从祖先变成非祖先
+ * 3. 实体仍然是祖先，但字段值变化
+ * 4. 目标实体本身也是结果的一部分（level=0）
+ *
+ * 特殊情况:
+ * - 如果目标实体的 parentId 变化，整个祖先链都会改变，需要完全刷新
+ *
+ * @param task 查询任务
+ * @param data 更新的实体数据列表
+ * @param classification 更新分类结果
+ * @param cache 更新数据缓存
+ */
+export declare const handleFindAncestorsUpdate: <T extends EntityType>(task: QueryTask<T>, data: RxDBEntityLocalUpdatedEventData<T>[], classification: UpdateClassification, cache: UpdateDataCache<T>) => void;
+/**
+ * 处理 countDescendants 查询的增量更新
+ *
+ * 计数查询的特点:
+ * - 只需要返回数量，不需要返回具体实体
+ * - 需要精确计算增减变化
+ * - 如果无法确定关系（父实体链中断），则触发 SQL 刷新
+ *
+ * UPDATE 场景下的计数变化:
+ * 1. 实体的 parentId 变化 → 可能从非后代变为后代，或相反
+ * 2. 实体从不匹配变为匹配 where 条件 → 如果是后代，计数+1
+ * 3. 实体从匹配变为不匹配 where 条件 → 如果是后代，计数-1
+ *
+ * @param task 查询任务
+ * @param data 更新的实体数据列表
+ * @param classification 更新分类结果
+ * @param cache 更新数据缓存
+ * @param where where 条件
+ * @param isEntityMatchWhere 检查实体是否匹配 where 条件的函数
+ */
+export declare const handleCountDescendantsUpdate: <T extends EntityType>(task: QueryTask<T>, data: RxDBEntityLocalUpdatedEventData<T>[], classification: UpdateClassification, cache: UpdateDataCache<T>, where: any, isEntityMatchWhere: (entity: any, where: any) => boolean) => void;
+/**
+ * 处理 countAncestors 查询的增量更新
+ *
+ * 计数查询的特点:
+ * - 只需要返回数量，不需要返回具体实体
+ * - 需要精确计算增减变化
+ * - 如果无法确定关系（父实体链中断）或目标实体的 parentId 变化，则触发 SQL 刷新
+ *
+ * UPDATE 场景下的计数变化:
+ * 1. 目标实体的 parentId 变化 → 整个祖先链改变，必须触发刷新
+ * 2. 其他实体的 parentId 变化 → 可能从非祖先变为祖先，或相反
+ * 3. 实体从不匹配变为匹配 where 条件 → 如果是祖先，计数+1
+ * 4. 实体从匹配变为不匹配 where 条件 → 如果是祖先，计数-1
+ *
+ * @param task 查询任务
+ * @param data 更新的实体数据列表
+ * @param classification 更新分类结果
+ * @param cache 更新数据缓存
+ * @param where where 条件
+ * @param isEntityMatchWhere 检查实体是否匹配 where 条件的函数
+ */
+export declare const handleCountAncestorsUpdate: <T extends EntityType>(task: QueryTask<T>, data: RxDBEntityLocalUpdatedEventData<T>[], classification: UpdateClassification, cache: UpdateDataCache<T>, where: any, isEntityMatchWhere: (entity: any, where: any) => boolean) => void;
+//# sourceMappingURL=merge-update-tree.d.ts.map

package/dist/query/merge-update-tree.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge-update-tree.d.ts","sourceRoot":"","sources":["../../src/query/merge-update-tree.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAC3D,OAAO,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAEvD,OAAO,EAAE,+BAA+B,EAAE,MAAM,mBAAmB,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,eAAe,EAAe,MAAM,yBAAyB,CAAC;AA6O7F;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,2BAA2B,GAAI,CAAC,SAAS,UAAU,EAC9D,MAAM,SAAS,CAAC,CAAC,CAAC,EAClB,MAAM,+BAA+B,CAAC,CAAC,CAAC,EAAE,EAC1C,gBAAgB,oBAAoB,EACpC,OAAO,eAAe,CAAC,CAAC,CAAC,SAwI1B,CAAC;AAEF;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,yBAAyB,GAAI,CAAC,SAAS,UAAU,EAC5D,MAAM,SAAS,CAAC,CAAC,CAAC,EAClB,MAAM,+BAA+B,CAAC,CAAC,CAAC,EAAE,EAC1C,gBAAgB,oBAAoB,EACpC,OAAO,eAAe,CAAC,CAAC,CAAC,SAyI1B,CAAC;AAEF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,4BAA4B,GAAI,CAAC,SAAS,UAAU,EAC/D,MAAM,SAAS,CAAC,CAAC,CAAC,EAClB,MAAM,+BAA+B,CAAC,CAAC,CAAC,EAAE,EAC1C,gBAAgB,oBAAoB,EACpC,OAAO,eAAe,CAAC,CAAC,CAAC,EACzB,OAAO,GAAG,EACV,oBAAoB,CAAC,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,KAAK,OAAO,SA+DzD,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,0BAA0B,GAAI,CAAC,SAAS,UAAU,EAC7D,MAAM,SAAS,CAAC,CAAC,CAAC,EAClB,MAAM,+BAA+B,CAAC,CAAC,CAAC,EAAE,EAC1C,gBAAgB,oBAAoB,EACpC,OAAO,eAAe,CAAC,CAAC,CAAC,EACzB,OAAO,GAAG,EACV,oBAAoB,CAAC,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,KAAK,OAAO,SAwHzD,CAAC"}

package/dist/query/merge-update.utils.d.ts

@@ -0,0 +1,52 @@
+import { EntityType } from '../entity/entity.interface.js';
+import { RxDBEntityLocalUpdatedEventData } from '../rxdb-events.js';
+/**
+ * 获取实体 ID
+ */
+export declare const getEntityId: (entity: any) => string | undefined;
+/**
+ * 更新数据的缓存管理器
+ * 用于缓存序列化后的实体数据,避免重复序列化
+ */
+export declare class UpdateDataCache<T extends EntityType> {
+    private serialize;
+    private dataById;
+    private serializedUpdateCache;
+    private serializedBeforeCache;
+    constructor(data: RxDBEntityLocalUpdatedEventData<T>[], serialize: (event: RxDBEntityLocalUpdatedEventData<T>) => InstanceType<T>);
+    /**
+     * 获取序列化后的更新数据
+     */
+    getSerializedUpdate(id: string): InstanceType<T> | undefined;
+    /**
+     * 获取序列化后的更新前数据
+     */
+    getSerializedBefore(id: string, inversePatch: any): InstanceType<T> | undefined;
+    /**
+     * 获取原始更新数据
+     */
+    getData(id: string): RxDBEntityLocalUpdatedEventData<T> | undefined;
+}
+/**
+ * 更新分类结果
+ */
+export interface UpdateClassification {
+    /** 更新的实体 ID 集合 */
+    updatedIds: Set<string>;
+    /** 当前匹配条件的实体 ID */
+    matchNowIds: Set<string>;
+    /** 更新前匹配条件的实体 ID */
+    matchBeforeIds: Set<string>;
+    /** 从 "不匹配" 变为 "匹配" 的实体 */
+    newlyMatchedIds: Set<string>;
+    /** 从 "匹配" 变为 "不匹配" 的实体 */
+    newlyUnmatchedIds: Set<string>;
+    /** 更新前后都匹配的实体 */
+    stillMatchedIds: Set<string>;
+}
+/**
+ * 分类更新的实体
+ * 根据 where 条件判断实体的匹配状态变化
+ */
+export declare const classifyUpdates: <T extends EntityType>(data: RxDBEntityLocalUpdatedEventData<T>[], where: any, isEntityMatchWhere: (entity: any, where: any) => boolean) => UpdateClassification;
+//# sourceMappingURL=merge-update.utils.d.ts.map

package/dist/query/merge-update.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge-update.utils.d.ts","sourceRoot":"","sources":["../../src/query/merge-update.utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAC3D,OAAO,EAAE,+BAA+B,EAAE,MAAM,mBAAmB,CAAC;AAEpE;;GAEG;AACH,eAAO,MAAM,WAAW,GAAI,QAAQ,GAAG,KAAG,MAAM,GAAG,SAGlD,CAAC;AAEF;;;GAGG;AACH,qBAAa,eAAe,CAAC,CAAC,SAAS,UAAU;IAO7C,OAAO,CAAC,SAAS;IANnB,OAAO,CAAC,QAAQ,CAAyD;IACzE,OAAO,CAAC,qBAAqB,CAAsC;IACnE,OAAO,CAAC,qBAAqB,CAAsC;gBAGjE,IAAI,EAAE,+BAA+B,CAAC,CAAC,CAAC,EAAE,EAClC,SAAS,EAAE,CAAC,KAAK,EAAE,+BAA+B,CAAC,CAAC,CAAC,KAAK,YAAY,CAAC,CAAC,CAAC;IAKnF;;OAEG;IACH,mBAAmB,CAAC,EAAE,EAAE,MAAM,GAAG,YAAY,CAAC,CAAC,CAAC,GAAG,SAAS;IAa5D;;OAEG;IACH,mBAAmB,CAAC,EAAE,EAAE,MAAM,EAAE,YAAY,EAAE,GAAG,GAAG,YAAY,CAAC,CAAC,CAAC,GAAG,SAAS;IAS/E;;OAEG;IACH,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,+BAA+B,CAAC,CAAC,CAAC,GAAG,SAAS;CAGpE;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,kBAAkB;IAClB,UAAU,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACxB,mBAAmB;IACnB,WAAW,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACzB,oBAAoB;IACpB,cAAc,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC5B,0BAA0B;IAC1B,eAAe,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC7B,0BAA0B;IAC1B,iBAAiB,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC/B,iBAAiB;IACjB,eAAe,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CAC9B;AAED;;;GAGG;AACH,eAAO,MAAM,eAAe,GAAI,CAAC,SAAS,UAAU,EAClD,MAAM,+BAA+B,CAAC,CAAC,CAAC,EAAE,EAC1C,OAAO,GAAG,EACV,oBAAoB,CAAC,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,KAAK,OAAO,KACvD,oBAiCF,CAAC"}

package/dist/query/merge_create.d.ts

@@ -1,6 +1,6 @@
 import { EntityType } from '../entity/entity.interface.js';
 import { QueryTask } from '../repository/QueryTask.js';
-import { RxDBEntityCreatedEventData } from '../rxdb-events.js';
+import { RxDBEntityLocalCreatedEventData } from '../rxdb-events.js';
 /**
  * 处理 CREATE 事件的缓存合并逻辑
  *
@@ -14,6 +14,6 @@ import { RxDBEntityCreatedEventData } from '../rxdb-events.js';
  * @param task 查询任务
  * @param entities 创建的实体事件数据
  */
-declare const _default: <T extends EntityType>(task: QueryTask<T>, entities: RxDBEntityCreatedEventData<T>[]) => void;
+declare const _default: <T extends EntityType>(task: QueryTask<T>, entities: RxDBEntityLocalCreatedEventData<T>[]) => void;
 export default _default;
 //# sourceMappingURL=merge_create.d.ts.map

package/dist/query/merge_create.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"merge_create.d.ts","sourceRoot":"","sources":["../../src/query/merge_create.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAE3D,OAAO,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AACvD,OAAO,EAAE,0BAA0B,EAAE,MAAM,mBAAmB,CAAC;AAgW/D;;;;;;;;;;;;GAYG;yBACa,CAAC,SAAS,UAAU,EAAE,MAAM,SAAS,CAAC,CAAC,CAAC,EAAE,UAAU,0BAA0B,CAAC,CAAC,CAAC,EAAE;AAAnG,wBA4FE"}
+{"version":3,"file":"merge_create.d.ts","sourceRoot":"","sources":["../../src/query/merge_create.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAG3D,OAAO,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAEvD,OAAO,EAAE,+BAA+B,EAAE,MAAM,mBAAmB,CAAC;AAoKpE;;;;;;;;;;;;GAYG;yBACa,CAAC,SAAS,UAAU,EAAE,MAAM,SAAS,CAAC,CAAC,CAAC,EAAE,UAAU,+BAA+B,CAAC,CAAC,CAAC,EAAE;AAAxG,wBAyCE"}

package/dist/query/merge_remove.d.ts

@@ -1,19 +1,6 @@
 import { EntityType } from '../entity/entity.interface.js';
 import { QueryTask } from '../repository/QueryTask.js';
-import { RxDBEntityRemovedEventData } from '../rxdb-events.js';
-/**
- * 处理 REMOVE 事件的缓存合并逻辑
- *
- * 不同查询类型的删除策略:
- * - findAll: JS 直接移除
- * - find: SQL 刷新(需要补充数据)
- * - findByCursor: JS 直接移除
- * - findOne/findOneOrFail: SQL 刷新(如果当前结果被删除)
- * - count: JS 简单减法
- *
- * @param task 查询任务
- * @param entities 删除的实体事件数据
- */
-declare const _default: <T extends EntityType>(task: QueryTask<T>, entities: RxDBEntityRemovedEventData<T>[]) => void;
+import { RxDBEntityLocalRemovedEventData } from '../rxdb-events.js';
+declare const _default: <T extends EntityType>(task: QueryTask<T>, entities: RxDBEntityLocalRemovedEventData<T>[]) => void;
 export default _default;
 //# sourceMappingURL=merge_remove.d.ts.map

package/dist/query/merge_remove.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"merge_remove.d.ts","sourceRoot":"","sources":["../../src/query/merge_remove.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAE3D,OAAO,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AACvD,OAAO,EAAE,0BAA0B,EAAE,MAAM,mBAAmB,CAAC;AAiO/D;;;;;;;;;;;;GAYG;yBACa,CAAC,SAAS,UAAU,EAAE,MAAM,SAAS,CAAC,CAAC,CAAC,EAAE,UAAU,0BAA0B,CAAC,CAAC,CAAC,EAAE;AAAnG,wBAuEE"}
+{"version":3,"file":"merge_remove.d.ts","sourceRoot":"","sources":["../../src/query/merge_remove.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAG3D,OAAO,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AACvD,OAAO,EAAE,+BAA+B,EAAE,MAAM,mBAAmB,CAAC;yBA6FpD,CAAC,SAAS,UAAU,EAAE,MAAM,SAAS,CAAC,CAAC,CAAC,EAAE,UAAU,+BAA+B,CAAC,CAAC,CAAC,EAAE;AAAxG,wBAqCE"}

package/dist/query/merge_update.d.ts

@@ -1,6 +1,6 @@
 import { EntityType } from '../entity/entity.interface.js';
 import { QueryTask } from '../repository/QueryTask.js';
-import { RxDBEntityUpdatedEventData } from '../rxdb-events.js';
+import { RxDBEntityLocalUpdatedEventData } from '../rxdb-events.js';
 /**
  * 处理 UPDATE 事件的缓存合并逻辑
  *
@@ -19,6 +19,6 @@ import { RxDBEntityUpdatedEventData } from '../rxdb-events.js';
  * @param task 查询任务
  * @param entities 更新的实体事件数据
  */
-declare const _default: <T extends EntityType>(task: QueryTask<T>, entities: RxDBEntityUpdatedEventData<T>[]) => void;
+declare const _default: <T extends EntityType>(task: QueryTask<T>, entities: RxDBEntityLocalUpdatedEventData<T>[]) => void;
 export default _default;
 //# sourceMappingURL=merge_update.d.ts.map

package/dist/query/merge_update.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"merge_update.d.ts","sourceRoot":"","sources":["../../src/query/merge_update.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAE3D,OAAO,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AACvD,OAAO,EAAE,0BAA0B,EAAE,MAAM,mBAAmB,CAAC;AAytB/D;;;;;;;;;;;;;;;;;GAiBG;yBACa,CAAC,SAAS,UAAU,EAAE,MAAM,SAAS,CAAC,CAAC,CAAC,EAAE,UAAU,0BAA0B,CAAC,CAAC,CAAC,EAAE;AAAnG,wBA6HE"}
+{"version":3,"file":"merge_update.d.ts","sourceRoot":"","sources":["../../src/query/merge_update.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAG3D,OAAO,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AACvD,OAAO,EAAE,+BAA+B,EAAE,MAAM,mBAAmB,CAAC;AA2EpE;;;;;;;;;;;;;;;;;GAiBG;yBACa,CAAC,SAAS,UAAU,EAAE,MAAM,SAAS,CAAC,CAAC,CAAC,EAAE,UAAU,+BAA+B,CAAC,CAAC,CAAC,EAAE;AAAxG,wBAwJE"}

package/dist/query/need_refresh_create.d.ts

@@ -1,10 +1,10 @@
 import { EntityType } from '../entity/entity.interface.js';
 import { RefreshMatchRules } from '../repository/QueryManager.interface.js';
 import { QueryTask } from '../repository/QueryTask.js';
-import { RxDBEntityCreatedEventData } from '../rxdb-events.js';
-export declare const query_need_refresh_create: <T extends EntityType = any>(task: QueryTask<T>, changes: RxDBEntityCreatedEventData<T>[], refresh_rules: RefreshMatchRules, recalculate_rules: RefreshMatchRules) => {
-    current_entities: RxDBEntityCreatedEventData<T>[];
-    relation_entities: RxDBEntityCreatedEventData<T>[];
+import { RxDBEntityLocalCreatedEventData } from '../rxdb-events.js';
+export declare const query_need_refresh_create: <T extends EntityType = EntityType>(task: QueryTask<T>, changes: RxDBEntityLocalCreatedEventData<T>[], refresh_rules: RefreshMatchRules, recalculate_rules: RefreshMatchRules) => {
+    current_entities: RxDBEntityLocalCreatedEventData<T>[];
+    relation_entities: RxDBEntityLocalCreatedEventData<T>[];
     refresh: boolean;
     recalculate: boolean;
 };

package/dist/query/need_refresh_create.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"need_refresh_create.d.ts","sourceRoot":"","sources":["../../src/query/need_refresh_create.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAE3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,yCAAyC,CAAC;AAC5E,OAAO,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AACvD,OAAO,EAAE,0BAA0B,EAAE,MAAM,mBAAmB,CAAC;AAuC/D,eAAO,MAAM,yBAAyB,GAAI,CAAC,SAAS,UAAU,GAAG,GAAG,EAClE,MAAM,SAAS,CAAC,CAAC,CAAC,EAClB,SAAS,0BAA0B,CAAC,CAAC,CAAC,EAAE,EACxC,eAAe,iBAAiB,EAChC,mBAAmB,iBAAiB;;;;;CAgGrC,CAAC"}
+{"version":3,"file":"need_refresh_create.d.ts","sourceRoot":"","sources":["../../src/query/need_refresh_create.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,yCAAyC,CAAC;AAC5E,OAAO,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AACvD,OAAO,EAAE,+BAA+B,EAAE,MAAM,mBAAmB,CAAC;AAQpE,eAAO,MAAM,yBAAyB,GAAI,CAAC,SAAS,UAAU,GAAG,UAAU,EACzE,MAAM,SAAS,CAAC,CAAC,CAAC,EAClB,SAAS,+BAA+B,CAAC,CAAC,CAAC,EAAE,EAC7C,eAAe,iBAAiB,EAChC,mBAAmB,iBAAiB;;;;;CA6CrC,CAAC"}

package/dist/query/need_refresh_remove.d.ts

@@ -1,6 +1,6 @@
 import { EntityType } from '../entity/entity.interface.js';
 import { RefreshMatchRules } from '../repository/QueryManager.interface.js';
 import { QueryTask } from '../repository/QueryTask.js';
-import { RxDBEntityRemovedEventData } from '../rxdb-events.js';
-export declare const query_need_refresh_remove: <T extends EntityType = any>(task: QueryTask<T>, changes: RxDBEntityRemovedEventData[], refresh_rules: RefreshMatchRules, recalculate_rules: RefreshMatchRules) => import('./query-matching.utils.js').NeedRefreshResult;
+import { RxDBEntityLocalRemovedEventData } from '../rxdb-events.js';
+export declare const query_need_refresh_remove: <T extends EntityType = any>(task: QueryTask<T>, changes: RxDBEntityLocalRemovedEventData[], refresh_rules: RefreshMatchRules, recalculate_rules: RefreshMatchRules) => import('./query-matching.utils.js').NeedRefreshResult;
 //# sourceMappingURL=need_refresh_remove.d.ts.map

package/dist/query/need_refresh_remove.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"need_refresh_remove.d.ts","sourceRoot":"","sources":["../../src/query/need_refresh_remove.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAE3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,yCAAyC,CAAC;AAC5E,OAAO,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AACvD,OAAO,EAAE,0BAA0B,EAAE,MAAM,mBAAmB,CAAC;AAK/D,eAAO,MAAM,yBAAyB,GAAI,CAAC,SAAS,UAAU,GAAG,GAAG,EAClE,MAAM,SAAS,CAAC,CAAC,CAAC,EAClB,SAAS,0BAA0B,EAAE,EACrC,eAAe,iBAAiB,EAChC,mBAAmB,iBAAiB,0DAwBrC,CAAC"}
+{"version":3,"file":"need_refresh_remove.d.ts","sourceRoot":"","sources":["../../src/query/need_refresh_remove.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,yCAAyC,CAAC;AAC5E,OAAO,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AACvD,OAAO,EAAE,+BAA+B,EAAE,MAAM,mBAAmB,CAAC;AAIpE,eAAO,MAAM,yBAAyB,GAAI,CAAC,SAAS,UAAU,GAAG,GAAG,EAClE,MAAM,SAAS,CAAC,CAAC,CAAC,EAClB,SAAS,+BAA+B,EAAE,EAC1C,eAAe,iBAAiB,EAChC,mBAAmB,iBAAiB,0DAQrC,CAAC"}

package/dist/query/need_refresh_update.d.ts

@@ -1,10 +1,10 @@
 import { EntityType } from '../entity/entity.interface.js';
 import { RefreshMatchRules } from '../repository/QueryManager.interface.js';
 import { QueryTask } from '../repository/QueryTask.js';
-import { RxDBEntityUpdatedEventData } from '../rxdb-events.js';
-export declare const query_need_refresh_update: <T extends EntityType = any>(task: QueryTask<T>, changes: RxDBEntityUpdatedEventData[], refresh_rules: RefreshMatchRules, recalculate_rules: RefreshMatchRules) => import('./query-matching.utils.js').NeedRefreshResult | {
-    current_entities: RxDBEntityUpdatedEventData<EntityType>[];
-    relation_entities: RxDBEntityUpdatedEventData<EntityType>[];
+import { RxDBEntityLocalUpdatedEventData } from '../rxdb-events.js';
+export declare const query_need_refresh_update: <T extends EntityType = any>(task: QueryTask<T>, changes: RxDBEntityLocalUpdatedEventData[], refresh_rules: RefreshMatchRules, recalculate_rules: RefreshMatchRules) => import('./query-matching.utils.js').NeedRefreshResult | {
+    current_entities: RxDBEntityLocalUpdatedEventData<EntityType>[];
+    relation_entities: RxDBEntityLocalUpdatedEventData<EntityType>[];
     refresh: boolean;
     recalculate: boolean;
 };

package/dist/query/need_refresh_update.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"need_refresh_update.d.ts","sourceRoot":"","sources":["../../src/query/need_refresh_update.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAE3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,yCAAyC,CAAC;AAC5E,OAAO,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AACvD,OAAO,EAAE,0BAA0B,EAAE,MAAM,mBAAmB,CAAC;AA2C/D,eAAO,MAAM,yBAAyB,GAAI,CAAC,SAAS,UAAU,GAAG,GAAG,EAClE,MAAM,SAAS,CAAC,CAAC,CAAC,EAClB,SAAS,0BAA0B,EAAE,EACrC,eAAe,iBAAiB,EAChC,mBAAmB,iBAAiB;;;;;CAiFrC,CAAC"}
+{"version":3,"file":"need_refresh_update.d.ts","sourceRoot":"","sources":["../../src/query/need_refresh_update.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAE3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,yCAAyC,CAAC;AAC5E,OAAO,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AACvD,OAAO,EAAE,+BAA+B,EAAE,MAAM,mBAAmB,CAAC;AAQpE,eAAO,MAAM,yBAAyB,GAAI,CAAC,SAAS,UAAU,GAAG,GAAG,EAClE,MAAM,SAAS,CAAC,CAAC,CAAC,EAClB,SAAS,+BAA+B,EAAE,EAC1C,eAAe,iBAAiB,EAChC,mBAAmB,iBAAiB;;;;;CAiDrC,CAAC"}

package/dist/query/query-matching.utils.d.ts

@@ -1,6 +1,6 @@
 import { EntityType } from '../entity/entity.interface.js';
 import { OrderBy } from '../repository/query-options.interface.js';
-import { RuleGroup } from '../repository/query.interface.js';
+import { Rule, RuleGroup } from '../repository/query.interface.js';
 import { RefreshMatchRules } from '../repository/QueryManager.interface.js';
 /**
  * 计算结果
@@ -17,12 +17,28 @@ export interface NeedRefreshResult {
 }
 /**
  * 判断是否是 RuleGroup
+ * @param value - 要检查的值
+ * @returns 如果是 RuleGroup 则返回 true，否则返回 false
  */
 export declare const isRuleGroup: (value: unknown) => value is RuleGroup<any>;
+/**
+ * 判断是否是 Rule
+ * @param value - 要检查的值
+ * @returns 如果是 Rule 则返回 true，否则返回 false
+ */
+export declare const isRule: (value: unknown) => value is Rule<any>;
+/**
+ * 判断是否是 EXISTS/NOT EXISTS 规则
+ * @param rule - 要检查的规则
+ * @returns 如果是 EXISTS/NOT EXISTS 规则则返回 true，否则返回 false
+ */
+export declare const isExistsRule: <T extends EntityType>(rule: Rule<T>) => rule is Extract<Rule<T>, {
+    operator: "exists" | "notExists";
+}>;
 /**
  * 判断实体是否匹配规则组
  */
-export declare const isEntityMatchWhere: <T extends EntityType>(entity: any, ruleGroup: RuleGroup<T>) => boolean;
+export declare const isEntityMatchWhere: (entity: any, ruleGroup: RuleGroup<any>) => boolean;
 /**
  * 判断 entity 是否影响排序后的结果中
  * @param entities 排序后的结果

package/dist/query/query-matching.utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"query-matching.utils.d.ts","sourceRoot":"","sources":["../../src/query/query-matching.utils.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAC3D,OAAO,EAAE,OAAO,EAAE,MAAM,0CAA0C,CAAC;AACnE,OAAO,EAAQ,SAAS,EAAE,MAAM,kCAAkC,CAAC;AACnE,OAAO,EAAE,iBAAiB,EAAE,MAAM,yCAAyC,CAAC;AAG5E;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,OAAO,EAAE,OAAO,CAAC;IACjB;;OAEG;IACH,WAAW,EAAE,OAAO,CAAC;CACtB;AAED;;GAEG;AACH,eAAO,MAAM,WAAW,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,SAAS,CAAC,GAAG,CAChB,CAAC;AAmEpD;;GAEG;AACH,eAAO,MAAM,kBAAkB,GAAI,CAAC,SAAS,UAAU,EAAE,QAAQ,GAAG,EAAE,WAAW,SAAS,CAAC,CAAC,CAAC,YACtC,CAAC;AAmCxD;;;;;;GAMG;AACH,eAAO,MAAM,qBAAqB,GAAI,CAAC,SAAS,UAAU,EACxD,QAAQ,YAAY,CAAC,CAAC,CAAC,GAAG,GAAG,EAC7B,QAAQ,YAAY,CAAC,CAAC,CAAC,EAAE,EACzB,cAAc,OAAO,CAAC,MAAM,CAAC,EAAE,wBAgBhC,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,GAAI,CAAC,SAAS,UAAU,EAAE,QAAQ,YAAY,CAAC,CAAC,CAAC,EAAE,EAAE,SAAS,OAAO,CAAC,MAAM,CAAC,EAAE,sBAQ3G,CAAC;AAEF,eAAO,MAAM,UAAU,GACrB,SAAS;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,OAAO,CAAA;CAAE,EACzC,eAAe,iBAAiB,EAChC,mBAAmB,iBAAiB,KACnC,iBAcF,CAAC"}
+{"version":3,"file":"query-matching.utils.d.ts","sourceRoot":"","sources":["../../src/query/query-matching.utils.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAC3D,OAAO,EAAE,OAAO,EAAE,MAAM,0CAA0C,CAAC;AACnE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,kCAAkC,CAAC;AACnE,OAAO,EAAE,iBAAiB,EAAE,MAAM,yCAAyC,CAAC;AAG5E;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,OAAO,EAAE,OAAO,CAAC;IACjB;;OAEG;IACH,WAAW,EAAE,OAAO,CAAC;CACtB;AAED;;;;GAIG;AACH,eAAO,MAAM,WAAW,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,SAAS,CAAC,GAAG,CAChB,CAAC;AAEpD;;;;GAIG;AACH,eAAO,MAAM,MAAM,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,IAAI,CAAC,GAAG,CAA4C,CAAC;AAEtG;;;;GAIG;AACH,eAAO,MAAM,YAAY,GAAI,CAAC,SAAS,UAAU,EAC/C,MAAM,IAAI,CAAC,CAAC,CAAC,KACZ,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE;IAAE,QAAQ,EAAE,QAAQ,GAAG,WAAW,CAAA;CAAE,CACH,CAAC;AA8H9D;;GAEG;AACH,eAAO,MAAM,kBAAkB,GAAI,QAAQ,GAAG,EAAE,WAAW,SAAS,CAAC,GAAG,CAAC,KAAG,OAO3E,CAAC;AAmCF;;;;;;GAMG;AACH,eAAO,MAAM,qBAAqB,GAAI,CAAC,SAAS,UAAU,EACxD,QAAQ,YAAY,CAAC,CAAC,CAAC,GAAG,GAAG,EAC7B,QAAQ,YAAY,CAAC,CAAC,CAAC,EAAE,EACzB,cAAc,OAAO,CAAC,MAAM,CAAC,EAAE,wBAgBhC,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,GAAI,CAAC,SAAS,UAAU,EAAE,QAAQ,YAAY,CAAC,CAAC,CAAC,EAAE,EAAE,SAAS,OAAO,CAAC,MAAM,CAAC,EAAE,sBAQ3G,CAAC;AAEF,eAAO,MAAM,UAAU,GACrB,SAAS;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,OAAO,CAAA;CAAE,EACzC,eAAe,iBAAiB,EAChC,mBAAmB,iBAAiB,KACnC,iBAcF,CAAC"}

package/dist/query/query-relation.utils.d.ts

@@ -0,0 +1,44 @@
+import { EntityType } from '../entity/entity.interface.js';
+import { EntityMetadata } from '../entity/metadata.interface.js';
+import { RuleGroup } from '../repository/query.interface.js';
+import { QueryTask } from '../repository/QueryTask.js';
+import { RxDBEntityLocalEventData } from '../rxdb-events.js';
+/**
+ * 检查关系实体是否与查询结果集相关
+ *
+ * 增强版：使用依赖提取器精确识别查询依赖的实体类型
+ * 特别支持 EXISTS 操作符的依赖跟踪
+ *
+ * @param task 查询任务
+ * @param relation_entity 关系实体（包含 entity 和 namespace）
+ * @returns 如果关系实体与查询相关则返回 true
+ */
+export declare function isRelationEntityRelated<T extends EntityType>(task: QueryTask<T>, relation_entity: {
+    entity: string;
+    namespace: string;
+}): boolean;
+/**
+ * 分离当前实体和关系实体
+ *
+ * 增强版：支持自引用关系的特殊处理
+ * 当查询使用 EXISTS 且存在自引用关系时，同一实体可能同时是：
+ * - current_entities：直接匹配查询条件的主实体
+ * - relation_entities：作为其他实体的关联实体
+ *
+ * @param task 查询任务
+ * @param changes 变更的实体列表
+ * @returns 分离后的当前实体和关系实体
+ */
+export declare function separateEntities<T extends EntityType, CT extends RxDBEntityLocalEventData>(task: QueryTask<T>, changes: CT[]): {
+    current_entities: CT[];
+    relation_entities: CT[];
+};
+/**
+ * 检测 where 条件是否使用了关系字段
+ *
+ * @param where where 条件对象
+ * @param metadata 实体元数据
+ * @returns 如果 where 条件使用了关系字段则返回 true
+ */
+export declare function whereUsesRelations(where: RuleGroup<any>, metadata: EntityMetadata): boolean;
+//# sourceMappingURL=query-relation.utils.d.ts.map

package/dist/query/query-relation.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-relation.utils.d.ts","sourceRoot":"","sources":["../../src/query/query-relation.utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAEjE,OAAO,EAAE,SAAS,EAAE,MAAM,kCAAkC,CAAC;AAC7D,OAAO,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AACvD,OAAO,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AAK7D;;;;;;;;;GASG;AACH,wBAAgB,uBAAuB,CAAC,CAAC,SAAS,UAAU,EAC1D,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC,EAClB,eAAe,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GACrD,OAAO,CA+BT;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,UAAU,EAAE,EAAE,SAAS,wBAAwB,EACxF,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC,EAClB,OAAO,EAAE,EAAE,EAAE,GACZ;IACD,gBAAgB,EAAE,EAAE,EAAE,CAAC;IACvB,iBAAiB,EAAE,EAAE,EAAE,CAAC;CACzB,CA+BA;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,SAAS,CAAC,GAAG,CAAC,EAAE,QAAQ,EAAE,cAAc,GAAG,OAAO,CAuB3F"}

package/dist/query/query-rules-builder.d.ts

@@ -0,0 +1,68 @@
+import { EntityType } from '../entity/entity.interface.js';
+import { QueryTask } from '../repository/QueryTask.js';
+/**
+ * 规则匹配结果
+ */
+export interface QueryRules {
+    [key: string]: () => boolean;
+    match_where: () => boolean;
+    not_match_where: () => boolean;
+    match_relation_where: () => boolean;
+    not_match_relation_where: () => boolean;
+    result_contains: () => boolean;
+    result_not_contains: () => boolean;
+    match_order_by: () => boolean;
+    match_where_before: () => boolean;
+    not_match_where_before: () => boolean;
+}
+/**
+ * 规则构建器 - 统一处理不同事件类型的规则
+ */
+export declare class QueryRulesBuilder<T extends EntityType> {
+    private task;
+    private current_entities;
+    private hasRelationChanges;
+    private whereUsesRelations;
+    private entityIds;
+    constructor(task: QueryTask<T>, current_entities: any[], hasRelationChanges: boolean, whereUsesRelations?: boolean);
+    /**
+     * 构建完整规则集（CREATE）
+     */
+    buildCreateRules(): QueryRules;
+    /**
+     * 构建完整规则集（UPDATE）
+     */
+    buildUpdateRules(): QueryRules;
+    /**
+     * 构建完整规则集（REMOVE）
+     */
+    buildRemoveRules(): QueryRules;
+    /**
+     * 构建 match_where 规则（适用于 CREATE/UPDATE）
+     */
+    private buildMatchWhere;
+    /**
+     * 构建 result_contains 规则
+     */
+    private buildResultContains;
+    /**
+     * 构建关系匹配规则（CREATE 场景）
+     *
+     * CREATE 场景：只要有关系实体变更就应该触发刷新
+     * 因为新增的关系实体可能影响 EXISTS 查询或其他依赖关系
+     */
+    private buildRelationWhereRulesForCreate;
+    /**
+     * 构建关系匹配规则（UPDATE 场景）
+     *
+     * UPDATE 场景：需要更严格的条件
+     * 只有当 where 条件使用了关系字段，且有关系实体变更时，才触发刷新
+     * 这样可以避免自引用场景下不必要的刷新（跨 Tab 同步时同一实体被放入 relation_entities）
+     */
+    private buildRelationWhereRulesForUpdate;
+    /**
+     * 构建排序规则（仅用于 CREATE）
+     */
+    private buildOrderByRule;
+}
+//# sourceMappingURL=query-rules-builder.d.ts.map

package/dist/query/query-rules-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-rules-builder.d.ts","sourceRoot":"","sources":["../../src/query/query-rules-builder.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAE3D,OAAO,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAKvD;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,OAAO,CAAC;IAC7B,WAAW,EAAE,MAAM,OAAO,CAAC;IAC3B,eAAe,EAAE,MAAM,OAAO,CAAC;IAC/B,oBAAoB,EAAE,MAAM,OAAO,CAAC;IACpC,wBAAwB,EAAE,MAAM,OAAO,CAAC;IACxC,eAAe,EAAE,MAAM,OAAO,CAAC;IAC/B,mBAAmB,EAAE,MAAM,OAAO,CAAC;IACnC,cAAc,EAAE,MAAM,OAAO,CAAC;IAC9B,kBAAkB,EAAE,MAAM,OAAO,CAAC;IAClC,sBAAsB,EAAE,MAAM,OAAO,CAAC;CACvC;AAED;;GAEG;AACH,qBAAa,iBAAiB,CAAC,CAAC,SAAS,UAAU;IAI/C,OAAO,CAAC,IAAI;IACZ,OAAO,CAAC,gBAAgB;IACxB,OAAO,CAAC,kBAAkB;IAC1B,OAAO,CAAC,kBAAkB;IAN5B,OAAO,CAAC,SAAS,CAAiB;gBAGxB,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC,EAClB,gBAAgB,EAAE,GAAG,EAAE,EACvB,kBAAkB,EAAE,OAAO,EAC3B,kBAAkB,GAAE,OAAe;IAK7C;;OAEG;IACH,gBAAgB,IAAI,UAAU;IAsB9B;;OAEG;IACH,gBAAgB,IAAI,UAAU;IAuB9B;;OAEG;IACH,gBAAgB,IAAI,UAAU;IAmB9B;;OAEG;IACH,OAAO,CAAC,eAAe;IAUvB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAI3B;;;;;OAKG;IACH,OAAO,CAAC,gCAAgC;IASxC;;;;;;OAMG;IACH,OAAO,CAAC,gCAAgC;IASxC;;OAEG;IACH,OAAO,CAAC,gBAAgB;CASzB"}

package/dist/query/query-tree.utils.d.ts

@@ -0,0 +1,54 @@
+import { EntityStaticType, EntityType } from '../entity/entity.interface.js';
+/**
+ * 树形遍历配置
+ */
+interface TreeTraversalOptions {
+    maxLevel?: number;
+    maxDepth?: number;
+}
+/**
+ * 获取实体的父级 ID
+ * 处理 parentId 可能是对象或字符串的情况
+ */
+export declare const get_tree_parent_id: <T extends EntityType>(entity: InstanceType<T>) => EntityStaticType<T, "idType"> | null;
+/**
+ * 向上遍历父级链路
+ *
+ * @param entity 起始实体
+ * @param entitiesMap 实体 ID 映射表
+ * @param options 遍历配置
+ * @yields 每一层的父级实体和层级
+ */
+export declare function traverseAncestors<T extends EntityType>(entity: InstanceType<T>, entitiesMap: Map<EntityStaticType<T, 'idType'>, InstanceType<T>>, options?: TreeTraversalOptions): Generator<{
+    entity: InstanceType<T>;
+    level: number;
+}>;
+/**
+ * 检查实体是否是目标实体的后代
+ *
+ * @param entity 要检查的实体
+ * @param targetId 目标实体 ID (为 null 或 undefined 时表示查找根节点)
+ * @param entitiesMap 实体 ID 映射表
+ * @param maxLevel 最大层级 (undefined 或 0 表示无限制)
+ * @returns 如果是后代则返回 true
+ */
+export declare function isDescendantOf<T extends EntityType>(entity: InstanceType<T>, targetId: EntityStaticType<T, 'idType'> | null | undefined, entitiesMap: Map<EntityStaticType<T, 'idType'>, InstanceType<T>>, maxLevel?: number): boolean;
+/**
+ * 检查实体是否是目标实体的祖先
+ *
+ * @param candidateEntity 候选祖先实体
+ * @param targetId 目标实体 ID
+ * @param entitiesMap 实体 ID 映射表
+ * @returns 如果是祖先则返回 true
+ */
+export declare function isAncestorOf<T extends EntityType>(candidateEntity: InstanceType<T>, targetId: EntityStaticType<T, 'idType'>, entitiesMap: Map<EntityStaticType<T, 'idType'>, InstanceType<T>>): boolean;
+/**
+ * 构建实体 ID 映射表（优化查找性能）
+ *
+ * @param entities 实体数组
+ * @param getIdFn 获取实体 ID 的函数
+ * @returns 实体 ID 到实体的映射表
+ */
+export declare function buildEntityMap<T extends EntityType>(entities: InstanceType<T>[], getIdFn: (e: InstanceType<T>) => EntityStaticType<T, 'idType'>): Map<EntityStaticType<T, 'idType'>, InstanceType<T>>;
+export {};
+//# sourceMappingURL=query-tree.utils.d.ts.map

package/dist/query/query-tree.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-tree.utils.d.ts","sourceRoot":"","sources":["../../src/query/query-tree.utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAE7E;;GAEG;AACH,UAAU,oBAAoB;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,eAAO,MAAM,kBAAkB,GAAI,CAAC,SAAS,UAAU,EACrD,QAAQ,YAAY,CAAC,CAAC,CAAC,KACtB,gBAAgB,CAAC,CAAC,EAAE,QAAQ,CAAC,GAAG,IAAgC,CAAC;AAEpE;;;;;;;GAOG;AACH,wBAAiB,iBAAiB,CAAC,CAAC,SAAS,UAAU,EACrD,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC,EACvB,WAAW,EAAE,GAAG,CAAC,gBAAgB,CAAC,CAAC,EAAE,QAAQ,CAAC,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC,EAChE,OAAO,GAAE,oBAAyB,GACjC,SAAS,CAAC;IAAE,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAoBvD;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,CAAC,SAAS,UAAU,EACjD,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC,EACvB,QAAQ,EAAE,gBAAgB,CAAC,CAAC,EAAE,QAAQ,CAAC,GAAG,IAAI,GAAG,SAAS,EAC1D,WAAW,EAAE,GAAG,CAAC,gBAAgB,CAAC,CAAC,EAAE,QAAQ,CAAC,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC,EAChE,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAkCT;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,CAAC,SAAS,UAAU,EAC/C,eAAe,EAAE,YAAY,CAAC,CAAC,CAAC,EAChC,QAAQ,EAAE,gBAAgB,CAAC,CAAC,EAAE,QAAQ,CAAC,EACvC,WAAW,EAAE,GAAG,CAAC,gBAAgB,CAAC,CAAC,EAAE,QAAQ,CAAC,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC,GAC/D,OAAO,CAWT;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,CAAC,SAAS,UAAU,EACjD,QAAQ,EAAE,YAAY,CAAC,CAAC,CAAC,EAAE,EAC3B,OAAO,EAAE,CAAC,CAAC,EAAE,YAAY,CAAC,CAAC,CAAC,KAAK,gBAAgB,CAAC,CAAC,EAAE,QAAQ,CAAC,GAC7D,GAAG,CAAC,gBAAgB,CAAC,CAAC,EAAE,QAAQ,CAAC,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC,CAOrD"}

package/dist/repository/QueryManager.d.ts

@@ -1,9 +1,27 @@
 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[];
+}
 /**
  * 查询缓存管理器
  *
@@ -42,6 +60,10 @@ export declare class QueryManager<T extends EntityType> {
      * @param taskOptions 查询任务选项
      * @returns 查询任务对象，包含 result$ 用于订阅查询结果
      */
-    createTask<RT = any>(queryOptions: QueryOptions<T>, runner: (options?: QueryOptions<T>) => Observable<RT>): QueryTask<T>;
+    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

@@ -1 +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;AAgBhE,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;;;;;;;;;;;;;GAaG;AACH,qBAAa,YAAY,CAAC,CAAC,SAAS,UAAU;;IAc1C,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,EACxB,YAAY,EAAE,YAAY,CAAC,CAAC,CAAC,EAC7B,MAAM,EAAE,CAAC,OAAO,CAAC,EAAE,YAAY,CAAC,CAAC,CAAC,KAAK,UAAU,CAAC,EAAE,CAAC,GACpD,SAAS,CAAC,CAAC,CAAC;CA4JhB"}
+{"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"}