@aiao/rxdb 0.0.5 → 0.0.7

package/dist/RxDB.d.ts

@@ -1,18 +1,66 @@
 import { Observable } from 'rxjs';
+import { EntityType } from './entity/entity.interface.js';
 import { EntityManager } from './entity/EntityManager.js';
-import { AdapterFactory, IRxDBAdapter, RxDBAdapters } from './rxdb-adapter.js';
+import { EntityMetadata } from './entity/metadata.interface.js';
+import { MergeQueryTaskCreateFn, MergeQueryTaskRemoveFn, MergeQueryTaskUpdateFn } from './repository/QueryManager.js';
+import { Repository } from './repository/Repository.js';
+import { AdapterFactory, IRxDBAdapter, RepositoryConstructor, RxDBAdapterLocalBase, RxDBAdapterRemoteBase, RxDBAdapters } from './rxdb-adapter.js';
 import { RxDBEvent, RxDBEventMap } from './rxdb-events.js';
 import { Plugin } from './rxdb-plugin.js';
 import { RxDBContext, RxDBOptions } from './rxdb.interface.js';
 import { SchemaManager } from './schema/SchemaManager.js';
-import { VersionManager } from './system/VersionManager.js';
+import { RxDBBranch } from './system/branch.js';
+import { RxDBChange } from './system/change.js';
+import { RxDBMigration } from './system/migration.js';
+import { VersionManager } from './version/VersionManager.js';
 type EventListener<T> = (event: T) => void;
-type RxDBConfig = RxDBOptions;
 /**
- * RxDB
+ * Repository 合并查询任务配置
+ */
+interface MergeQueryTaskOptions {
+    create: MergeQueryTaskCreateFn;
+    update: MergeQueryTaskUpdateFn;
+    remove: MergeQueryTaskRemoveFn;
+}
+/**
+ * IRepositoryConfig 统一注册配置
+ * 合并 factory、class 和 merge operations 为单一配置对象
+ */
+export interface IRepositoryConfig<RT extends Repository<any> = Repository<any>> {
+    /**
+     * Entity 生成器
+     * 用于根据 EntityMetadata 动态生成 Entity 类
+     * 用于生成中间表等场景
+     */
+    entityGenerator?: (metadata: EntityMetadata) => EntityType | EntityType[];
+    /**
+     * Repository 类构造函数
+     */
+    class: RepositoryConstructor<RT>;
+    /**
+     * 合并查询操作配置
+     */
+    mergeOperations: MergeQueryTaskOptions;
+}
+/**
+ * RxDB 是个单例对象，负责管理插件、适配器、事件以及上下文等全局功能
+ * 全局只能创建一个 RxDB 实例，所有 entity 都通过这个实例进行管理
+ * 所有 Entity 的 Class 也只能被注册一次
  */
 export declare class RxDB {
     #private;
+    /**
+     * 本地适配器
+     */
+    readonly localAdapter$: Observable<IRxDBAdapter & RxDBAdapterLocalBase>;
+    /**
+     * 远程适配器
+     */
+    readonly remoteAdapter$: Observable<IRxDBAdapter & RxDBAdapterRemoteBase>;
+    /**
+     * 连接状态 Observable
+     */
+    readonly connected$: Observable<boolean>;
     /**
      * Schema 管理
      */
@@ -30,50 +78,99 @@ export declare class RxDB {
      */
     get context(): RxDBContext;
     set context(context: RxDBContext);
-    readonly options: RxDBConfig;
+    /**
+     * 获取首次连接时间
+     */
+    get firstConnectedAt(): Date | undefined;
+    /**
+     * 获取 RxDB 版本号
+     */
+    get version(): string;
+    get config(): RxDBOptions;
+    /**
+     * 构造函数
+     * @param options - RxDB 配置选项
+     */
     constructor(options: RxDBOptions);
     /**
-     * 注册适配器
+     * 初始化 RxDB
      */
-    adapter<K extends keyof RxDBAdapters>(adapterName: K, adapter: AdapterFactory): this;
+    init(): void;
     /**
-     * 获取适配器
+     * 注册 Repository
+     * 统一接口，所有 repository 配置存储在 RxDB 中
+     *
+     * @param repositoryName - Repository 名称
+     * @param config - Repository 配置对象
      */
-    getAdapter<K extends keyof RxDBAdapters>(adapterName: K): Observable<RxDBAdapters[K]>;
+    repository<RT extends Repository<any>>(repositoryName: string, config: IRepositoryConfig<RT>): this;
+    /**
+     * 注册 adapter
+     * @param adapterName - 适配器名称
+     * @param adapter - 适配器工厂函数
+     * @returns 返回 RxDB 实例，支持链式调用
+     */
+    adapter<K extends keyof RxDBAdapters>(adapterName: K, adapter: AdapterFactory): this;
     /**
      * 安装插件
+     * @param plugin - 插件构造函数
+     * @param options - 插件选项
+     * @returns 返回 RxDB 实例，支持链式调用
      */
     use<Options = any>(plugin: Plugin<Options>, options?: Options): this;
+    /**
+     * 获取适配器实例
+     * @param adapterName - 适配器名称
+     * @returns 返回适配器实例的 Promise
+     * @throws 当适配器未注册时抛出错误
+     */
+    getAdapter<K extends keyof RxDBAdapters>(adapterName: K): Promise<RxDBAdapters[K]>;
+    /**
+     * 获取 Repository 配置
+     *
+     * @param repositoryName - Repository 名称
+     * @returns Repository 配置对象，如果不存在返回 undefined
+     */
+    getRepositoryConfig(repositoryName: string): IRepositoryConfig<Repository<any, import('../packages/rxdb/src/index.ts').IRepository<any>>> | undefined;
     /**
      * 连接适配器
+     * @param adapterName - 适配器名称
+     * @returns 返回连接的适配器实例
      */
-    connect<K extends keyof RxDBAdapters>(adapterName: K): Observable<IRxDBAdapter>;
+    connect<K extends keyof RxDBAdapters>(adapterName: K): Promise<RxDBAdapters[K]>;
     /**
-     * 断开适配器
-     * @param adapterName 适配器注册名称
+     * 断开适配器连接
+     * @param adapterName - 适配器名称
      */
-    disconnect<K extends keyof RxDBAdapters>(adapterName: K): Observable<void>;
+    disconnect<K extends keyof RxDBAdapters>(adapterName: K): Promise<void>;
     /**
-     * 断开所有适配器
+     * 断开所有适配器连接
      */
-    disconnectAll(): Observable<void[]>;
+    disconnectAll(): Promise<void>;
     /**
      * 监听事件
-     * @param type
-     * @param listener
+     * @param type - 事件类型
+     * @param listener - 事件监听器函数
      */
     addEventListener<T extends keyof RxDBEventMap>(type: T, listener: EventListener<RxDBEventMap[T]>): void;
     /**
-     * 移除事件
-     * @param type
-     * @param listener
+     * 移除事件监听器
+     * @param type - 事件类型
+     * @param listener - 要移除的事件监听器函数
      */
     removeEventListener<T extends keyof RxDBEventMap>(type: T, listener: EventListener<RxDBEventMap[T]>): void;
     /**
      * 派发事件
-     * @param event
+     * @param event - 要派发的事件对象
      */
     dispatchEvent(event: RxDBEvent): void;
 }
+declare module '../packages/rxdb/src/index.ts' {
+    interface RxDB {
+        RxDBChange: typeof RxDBChange;
+        RxDBBranch: typeof RxDBBranch;
+        RxDBMigration: typeof RxDBMigration;
+    }
+}
 export {};
 //# sourceMappingURL=RxDB.d.ts.map

package/dist/RxDB.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"RxDB.d.ts","sourceRoot":"","sources":["../src/RxDB.ts"],"names":[],"mappings":"AACA,OAAO,EAOL,UAAU,EAIX,MAAM,MAAM,CAAC;AACd,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAC/E,OAAO,EAEL,SAAS,EACT,YAAY,EAIb,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAE/D,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAG1D,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAE5D,KAAK,aAAa,CAAC,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,CAAC;AAE3C,KAAK,UAAU,GAAG,WAAW,CAAC;AAE9B;;GAEG;AACH,qBAAa,IAAI;;IAkBf;;OAEG;IACH,SAAgB,aAAa,EAAG,aAAa,CAAC;IAE9C;;OAEG;IACH,SAAgB,aAAa,EAAG,aAAa,CAAC;IAE9C;;OAEG;IACH,SAAgB,cAAc,EAAG,cAAc,CAAC;IAEhD;;OAEG;IACH,IAAI,OAAO,IAGU,WAAW,CAD/B;IACD,IAAI,OAAO,CAAC,OAAO,EAAE,WAAW,EAE/B;IAED,SAAgB,OAAO,EAAE,UAAU,CAAC;gBAExB,OAAO,EAAE,WAAW;IA2BhC;;OAEG;IACI,OAAO,CAAC,CAAC,SAAS,MAAM,YAAY,EAAE,WAAW,EAAE,CAAC,EAAE,OAAO,EAAE,cAAc,GAAG,IAAI;IAM3F;;OAEG;IACI,UAAU,CAAC,CAAC,SAAS,MAAM,YAAY,EAAE,WAAW,EAAE,CAAC,GAAG,UAAU,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IAsB5F;;OAEG;IACI,GAAG,CAAC,OAAO,GAAG,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,EAAE,OAAO;IAWpE;;OAEG;IACH,OAAO,CAAC,CAAC,SAAS,MAAM,YAAY,EAAE,WAAW,EAAE,CAAC;IAyBpD;;;OAGG;IACH,UAAU,CAAC,CAAC,SAAS,MAAM,YAAY,EAAE,WAAW,EAAE,CAAC;IAIvD;;OAEG;IACH,aAAa;IAMb;;;;OAIG;IACH,gBAAgB,CAAC,CAAC,SAAS,MAAM,YAAY,EAAE,IAAI,EAAE,CAAC,EAAE,QAAQ,EAAE,aAAa,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI;IAIvG;;;;OAIG;IACH,mBAAmB,CAAC,CAAC,SAAS,MAAM,YAAY,EAAE,IAAI,EAAE,CAAC,EAAE,QAAQ,EAAE,aAAa,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI;IAI1G;;;OAGG;IACH,aAAa,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI;CAmBtC"}
+{"version":3,"file":"RxDB.d.ts","sourceRoot":"","sources":["../src/RxDB.ts"],"names":[],"mappings":"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"}

package/dist/RxDBError.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"RxDBError.d.ts","sourceRoot":"","sources":["../src/RxDBError.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,qBAAa,SAAU,SAAQ,KAAK;gBACtB,OAAO,EAAE,MAAM;CAK5B"}
+{"version":3,"file":"RxDBError.d.ts","sourceRoot":"","sources":["../src/RxDBError.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,qBAAa,SAAU,SAAQ,KAAK;gBACtB,OAAO,EAAE,MAAM;CAK5B"}

package/dist/entity/@Entity.d.ts

@@ -1,5 +1,5 @@
-import { EntityMetadataOptions } from './entity-metadata-options.interface.js';
 import { AbstractEntityType, EntityType } from './entity.interface.js';
+import { EntityMetadataOptions } from './metadata-options.interface.js';
 /**
  * 实体装饰器
  * 用于将类标记为 RxDB 实体，并处理元数据、代理和生命周期

package/dist/entity/@Entity.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"@Entity.d.ts","sourceRoot":"","sources":["../../src/entity/@Entity.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,EAAE,qBAAqB,EAAE,MAAM,wCAAwC,CAAC;AAC/E,OAAO,EAAE,kBAAkB,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAIvE;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,MAAM,GAChB,iBAAiB,qBAAqB,MACtC,CAAC,SAAS,UAAU,GAAG,kBAAkB,EAAE,QAAQ,CAAC,KAAG,GAuCvD,CAAC"}
+{"version":3,"file":"@Entity.d.ts","sourceRoot":"","sources":["../../src/entity/@Entity.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,EAAE,kBAAkB,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAEvE,OAAO,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAC;AAGxE;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,MAAM,GAChB,iBAAiB,qBAAqB,MACtC,CAAC,SAAS,UAAU,GAAG,kBAAkB,EAAE,QAAQ,CAAC,KAAG,GAuCvD,CAAC"}

package/dist/entity/@TreeEntity.d.ts

@@ -1,26 +1,7 @@
-import { EntityMetadataOptions } from './entity-metadata-options.interface.js';
+import { EntityMetadataOptions } from './metadata-options.interface.js';
 /**
  * 树形实体装饰器
  * 用于将类标记为树形结构实体，并处理树形特定的元数据
- *
- * 该装饰器基于基础的 Entity 装饰器，但添加了树形结构特定的处理：
- * 1. 设置默认仓库为 TreeRepository
- * 2. 处理树形结构特定的元数据
- * 3. 支持树形结构的查询和操作
- *
- * 树形实体通常包含以下关系：
- * - parent: 指向父节点的关系
- * - children: 指向子节点的关系集合
- *
- * @example
- * ```typescript
- * @TreeEntity({
- *   name: 'Category',
- *   treeType: 'adjacency-list'
- * })
- * class Category extends TreeAdjacencyListEntityBase {
- * }
- * ```
  */
-export declare const TreeEntity: (metadataOptions: EntityMetadataOptions) => <T extends import('@aiao/rxdb').EntityType | import('@aiao/rxdb').AbstractEntityType>(target: T) => any;
+export declare const TreeEntity: (metadataOptions: EntityMetadataOptions) => <T extends import('../../packages/rxdb/src/index.ts').EntityType | import('../../packages/rxdb/src/index.ts').AbstractEntityType>(target: T) => any;
 //# sourceMappingURL=@TreeEntity.d.ts.map

package/dist/entity/@TreeEntity.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"@TreeEntity.d.ts","sourceRoot":"","sources":["../../src/entity/@TreeEntity.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,qBAAqB,EAAE,MAAM,wCAAwC,CAAC;AAE/E;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,eAAO,MAAM,UAAU,GAAI,iBAAiB,qBAAqB,4GAUhE,CAAC"}
+{"version":3,"file":"@TreeEntity.d.ts","sourceRoot":"","sources":["../../src/entity/@TreeEntity.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAC;AAExE;;;GAGG;AACH,eAAO,MAAM,UAAU,GAAI,iBAAiB,qBAAqB,4GAchE,CAAC"}

package/dist/entity/EntityBase.d.ts

@@ -1,5 +1,7 @@
-import { EntityMetadataOptions } from './entity-metadata-options.interface.js';
+import { Observable } from 'rxjs';
+import { CountOptions, FindAllOptions, FindByCursorOptions, FindOneOptions, FindOneOrFailOptions, FindOptions } from '../repository/query-options.interface.js';
 import { IEntity, UUID } from './entity.interface.js';
+import { EntityMetadataOptions } from './metadata-options.interface.js';
 export declare const ENTITY_BASE_METADATA_OPTIONS: EntityMetadataOptions;
 /**
  * 实体基类装饰器配置
@@ -21,11 +23,6 @@ export declare abstract class EntityBase implements IEntity {
      * 实体创建或更新时自动设置为当前时间
      */
     readonly updatedAt: Date;
-    /**
-     * 删除时间
-     * 实体被软删除时设置为当前时间，否则为null
-     */
-    readonly removedAt?: Date | null;
     /**
      * 创建者ID
      * 记录创建此实体的用户ID
@@ -37,16 +34,67 @@ export declare abstract class EntityBase implements IEntity {
      */
     readonly updatedBy?: UUID | null;
     /**
-     * 删除者ID
-     * 记录删除此实体的用户ID
+     * 根据 id 获取实体
+     * @param id - 实体的唯一标识符
+     * @returns Observable 包装的实体实例
+     */
+    static get: <T extends EntityBase>(this: new () => T, id: UUID) => Observable<T>;
+    /**
+     * 查找一个实体
+     * @param options - 查询选项，包含 where 条件
+     * @returns Observable 包装的实体实例或 null
+     */
+    static findOne: <T extends EntityBase>(this: new () => T, options: FindOneOptions<new () => T>) => Observable<T | null>;
+    /**
+     * 查找一个实体，查不到就抛出错误
+     * @param options - 查询选项，包含 where 条件
+     * @returns Observable 包装的实体实例
      */
-    readonly removedBy?: UUID | null;
+    static findOneOrFail: <T extends EntityBase>(this: new () => T, options: FindOneOrFailOptions<new () => T>) => Observable<T>;
+    /**
+     * 查询多个实体
+     * @param options - 查询选项，包含 where 条件、limit、offset 等
+     * @returns Observable 包装的实体实例数组
+     */
+    static find: <T extends EntityBase>(this: new () => T, options: FindOptions<new () => T>) => Observable<T[]>;
+    /**
+     * 查询所有实体
+     * @param options - 查询选项，包含 where 条件和排序（不限制数量）
+     * @returns Observable 包装的实体实例数组
+     */
+    static findAll: <T extends EntityBase>(this: new () => T, options: FindAllOptions<new () => T>) => Observable<T[]>;
+    /**
+     * 通过游标进行分页查询
+     * @param options - 游标分页选项，包含 orderBy、before/after 游标
+     * @returns Observable 包装的实体实例数组
+     */
+    static findByCursor: <T extends EntityBase>(this: new () => T, options: FindByCursorOptions<new () => T>) => Observable<T[]>;
+    /**
+     * 查询实体数量
+     * @param options - 查询选项，包含 where 条件
+     * @returns Observable 包装的数量
+     */
+    static count: <T extends EntityBase>(this: new () => T, options: CountOptions<new () => T>) => Observable<number>;
+    /**
+     * 删除
+     */
+    remove: () => Promise<any>;
+    /**
+     * 重置数据
+     */
+    reset: () => void;
+    /**
+     * 保存
+     */
+    save: () => Promise<any>;
     /**
      * 实体基类构造函数
      * 子类会通过 Entity 装饰器增强此构造函数
      *
-     * @param initData - 可选的初始化数据
+     * @param _initData - 可选的初始化数据
      */
-    constructor(initData?: any);
+    constructor(_initData?: any);
+}
+export declare class Todo extends EntityBase {
 }
 //# sourceMappingURL=EntityBase.d.ts.map

package/dist/entity/EntityBase.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"EntityBase.d.ts","sourceRoot":"","sources":["../../src/entity/EntityBase.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,EAAE,qBAAqB,EAAgB,MAAM,wCAAwC,CAAC;AAC7F,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,uBAAuB,CAAC;AAEtD,eAAO,MAAM,4BAA4B,EAAE,qBAiDjC,CAAC;AAEX;;;GAGG;AACH,8BAiBsB,UAAW,YAAW,OAAO;IACjD;;;OAGG;IACH,QAAQ,CAAC,EAAE,EAAG,IAAI,CAAC;IAEnB;;;OAGG;IACH,QAAQ,CAAC,SAAS,EAAG,IAAI,CAAC;IAE1B;;;OAGG;IACH,QAAQ,CAAC,SAAS,EAAG,IAAI,CAAC;IAE1B;;;OAGG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;IAEjC;;;OAGG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;IAEjC;;;OAGG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;IAEjC;;;OAGG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;IAEjC;;;;;OAKG;gBAES,QAAQ,CAAC,EAAE,GAAG;CAC3B"}
+{"version":3,"file":"EntityBase.d.ts","sourceRoot":"","sources":["../../src/entity/EntityBase.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,MAAM,CAAC;AAClC,OAAO,KAAK,EACV,YAAY,EACZ,cAAc,EACd,mBAAmB,EACnB,cAAc,EACd,oBAAoB,EACpB,WAAW,EACZ,MAAM,0CAA0C,CAAC;AAGlD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAE,qBAAqB,EAAgB,MAAM,iCAAiC,CAAC;AAEtF,eAAO,MAAM,4BAA4B,EAAE,qBAqCjC,CAAC;AAEX;;;GAGG;AACH,8BAiBsB,UAAW,YAAW,OAAO;IACjD;;;OAGG;IACH,QAAQ,CAAC,EAAE,EAAG,IAAI,CAAC;IAEnB;;;OAGG;IACH,QAAQ,CAAC,SAAS,EAAG,IAAI,CAAC;IAE1B;;;OAGG;IACH,QAAQ,CAAC,SAAS,EAAG,IAAI,CAAC;IAE1B;;;OAGG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;IAEjC;;;OAGG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;IAEjC;;;;OAIG;IACH,OAAe,GAAG,EAAE,CAAC,CAAC,SAAS,UAAU,EAAE,IAAI,EAAE,UAAU,CAAC,EAAE,EAAE,EAAE,IAAI,KAAK,UAAU,CAAC,CAAC,CAAC,CAAC;IAEzF;;;;OAIG;IACH,OAAe,OAAO,EAAE,CAAC,CAAC,SAAS,UAAU,EAC3C,IAAI,EAAE,UAAU,CAAC,EACjB,OAAO,EAAE,cAAc,CAAC,UAAU,CAAC,CAAC,KACjC,UAAU,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IAE1B;;;;OAIG;IACH,OAAe,aAAa,EAAE,CAAC,CAAC,SAAS,UAAU,EACjD,IAAI,EAAE,UAAU,CAAC,EACjB,OAAO,EAAE,oBAAoB,CAAC,UAAU,CAAC,CAAC,KACvC,UAAU,CAAC,CAAC,CAAC,CAAC;IAEnB;;;;OAIG;IACH,OAAe,IAAI,EAAE,CAAC,CAAC,SAAS,UAAU,EAAE,IAAI,EAAE,UAAU,CAAC,EAAE,OAAO,EAAE,WAAW,CAAC,UAAU,CAAC,CAAC,KAAK,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC;IAErH;;;;OAIG;IACH,OAAe,OAAO,EAAE,CAAC,CAAC,SAAS,UAAU,EAC3C,IAAI,EAAE,UAAU,CAAC,EACjB,OAAO,EAAE,cAAc,CAAC,UAAU,CAAC,CAAC,KACjC,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC;IAErB;;;;OAIG;IACH,OAAe,YAAY,EAAE,CAAC,CAAC,SAAS,UAAU,EAChD,IAAI,EAAE,UAAU,CAAC,EACjB,OAAO,EAAE,mBAAmB,CAAC,UAAU,CAAC,CAAC,KACtC,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC;IAErB;;;;OAIG;IACH,OAAe,KAAK,EAAE,CAAC,CAAC,SAAS,UAAU,EACzC,IAAI,EAAE,UAAU,CAAC,EACjB,OAAO,EAAE,YAAY,CAAC,UAAU,CAAC,CAAC,KAC/B,UAAU,CAAC,MAAM,CAAC,CAAC;IAExB;;OAEG;IACK,MAAM,EAAE,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC;IACnC;;OAEG;IACK,KAAK,EAAE,MAAM,IAAI,CAAC;IAC1B;;OAEG;IACK,IAAI,EAAE,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC;IAEjC;;;;;OAKG;gBAES,SAAS,CAAC,EAAE,GAAG;CAG5B;AAED,qBAOa,IAAK,SAAQ,UAAU;CAAG"}

package/dist/entity/EntityManager.d.ts

@@ -1,7 +1,8 @@
 import { Repository } from '../repository/Repository.js';
+import { RxDBMutationsMap } from '../rxdb-adapter.js';
 import { RxDB } from '../RxDB.js';
-import { EntityStaticType, EntityType, RowId } from './entity.interface.js';
-import { EntityStatusOptions } from './EntityStatus.js';
+import { EntityStaticType, EntityType, EntityUpdateData } from './entity.interface.js';
+import { EntityStatusOptions } from './EntityStatus.interface.js';
 /**
  * 实体管理器
  *
@@ -29,6 +30,11 @@ export declare class EntityManager {
      * @param rxdb - RxDB实例，提供数据库访问和事件分发
      */
     constructor(rxdb: RxDB);
+    init(): void;
+    /**
+     * 清理所有缓存
+     */
+    cleanAllCache(): void;
     /**
      * 创建实体引用
      * 根据提供的数据创建或获取实体实例，并设置其状态
@@ -40,9 +46,7 @@ export declare class EntityManager {
      * @param [status] - 可选的实体状态配置
      * @returns 创建或获取的实体实例
      */
-    createEntityRef<T extends EntityType>(EntityType: T, data: Partial<InstanceType<T>> & {
-        id: EntityStaticType<T, 'idType'>;
-    }, status?: EntityStatusOptions<T>): any;
+    createEntityRef<T extends EntityType>(EntityType: T, data: EntityUpdateData<T>, status?: EntityStatusOptions<T>): any;
     /**
      * 获取实体引用
      * 从缓存中获取指定ID的实体实例
@@ -50,16 +54,9 @@ export declare class EntityManager {
      * @template T 实体类型
      * @param EntityType - 实体类型
      * @param id - 实体ID
-     * @returns 实体实例，如果不存在则返回undefined
+     * @returns 实体实例，如果不存在则返回 undefined
      */
     getEntityRef<T extends EntityType>(EntityType: T, id: EntityStaticType<T, 'idType'>): InstanceType<T> | undefined;
-    /**
-     * 根据数据库行ID获取实体
-     * @param EntityType
-     * @param rowId
-     * @returns
-     */
-    getEntityByRowId<T extends EntityType>(EntityType: T, rowId: RowId): InstanceType<T> | undefined;
     /**
      * 检查实体是否在缓存中
      * 判断指定ID的实体是否已在缓存中初始化
@@ -67,7 +64,7 @@ export declare class EntityManager {
      * @template T 实体类型
      * @param EntityType - 实体类型
      * @param id - 实体ID
-     * @returns 如果实体在缓存中存在则返回true
+     * @returns 如果实体在缓存中存在则返回 true
      */
     hasEntityRef<T extends EntityType>(EntityType: T, id: EntityStaticType<T, 'idType'>): boolean;
     /**
@@ -86,15 +83,6 @@ export declare class EntityManager {
      * @param entity - 要移除的实体实例
      */
     removeEntityCache<T extends EntityType>(entity: InstanceType<T>): void;
-    /**
-     * 更新实体的行ID映射
-     * 建立数据库行ID到实体UUID的映射关系
-     *
-     * @template T 实体类型
-     * @param entity - 实体实例
-     * @param rowId - 数据库行ID
-     */
-    updateEntityRowId<T extends EntityType>(entity: InstanceType<T>, rowId: RowId): void;
     /**
      * 保存实体
      * 根据实体状态决定是创建新实体还是更新现有实体
@@ -110,13 +98,18 @@ export declare class EntityManager {
      * @param entities
      * @returns
      */
-    saveMany<T extends EntityType>(entities: InstanceType<T>[]): Promise<InstanceType<T>[]>;
+    saveMany<T extends EntityType>(entities: InstanceType<T>[]): Promise<any[]>;
     /**
      * 批量删除
      * @param entities
      * @returns
      */
-    removeMany<T extends EntityType>(entities: InstanceType<T>[]): Promise<InstanceType<T>[]>;
+    removeMany<T extends EntityType>(entities: InstanceType<T>[]): Promise<any[]>;
+    /**
+     * 批量修改实体（创建/更新/删除）
+     * @param options 批量修改选项
+     */
+    mutations(options: RxDBMutationsMap<any>): Promise<any[]>;
     /**
      * 删除实体
      * 从数据库中删除实体，并分发相关事件

package/dist/entity/EntityManager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"EntityManager.d.ts","sourceRoot":"","sources":["../../src/entity/EntityManager.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"EntityManager.d.ts","sourceRoot":"","sources":["../../src/entity/EntityManager.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAOH,OAAO,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAGzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAGtD,OAAO,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAGlC,OAAO,EAAE,gBAAgB,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAQvF,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAKlE;;;;;;;;;;;;GAYG;AACH,qBAAa,aAAa;;aAwBI,IAAI,EAAE,IAAI;IAVtC;;;;;;;;;OASG;gBACyB,IAAI,EAAE,IAAI;IAoBtC,IAAI;IA8DJ;;OAEG;IACH,aAAa;IAKb;;;;;;;;;;OAUG;IACH,eAAe,CAAC,CAAC,SAAS,UAAU,EAAE,UAAU,EAAE,CAAC,EAAE,IAAI,EAAE,gBAAgB,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,EAAE,mBAAmB,CAAC,CAAC,CAAC;IAc/G;;;;;;;;OAQG;IACH,YAAY,CAAC,CAAC,SAAS,UAAU,EAAE,UAAU,EAAE,CAAC,EAAE,EAAE,EAAE,gBAAgB,CAAC,CAAC,EAAE,QAAQ,CAAC,GAAG,YAAY,CAAC,CAAC,CAAC,GAAG,SAAS;IAIjH;;;;;;;;OAQG;IACH,YAAY,CAAC,CAAC,SAAS,UAAU,EAAE,UAAU,EAAE,CAAC,EAAE,EAAE,EAAE,gBAAgB,CAAC,CAAC,EAAE,QAAQ,CAAC,GAAG,OAAO;IAI7F;;;;;;OAMG;IACH,cAAc,CAAC,CAAC,SAAS,UAAU,EAAE,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC;IAI5D;;;;;;OAMG;IACH,iBAAiB,CAAC,CAAC,SAAS,UAAU,EAAE,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC;IAI/D;;;;;;;;OAQG;IACG,IAAI,CAAC,CAAC,SAAS,UAAU,EAAE,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IA4BnF;;;;OAIG;IACG,QAAQ,CAAC,CAAC,SAAS,UAAU,EAAE,QAAQ,EAAE,YAAY,CAAC,CAAC,CAAC,EAAE;IAShE;;;;OAIG;IACG,UAAU,CAAC,CAAC,SAAS,UAAU,EAAE,QAAQ,EAAE,YAAY,CAAC,CAAC,CAAC,EAAE;IAQlE;;;OAGG;IACG,SAAS,CAAC,OAAO,EAAE,gBAAgB,CAAC,GAAG,CAAC;IAK9C;;;;;;;;OAQG;IACG,MAAM,CAAC,CAAC,SAAS,UAAU,EAAE,IAAI,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IAMnF;;OAEG;IACG,KAAK,CAAC,CAAC,SAAS,UAAU,EAAE,IAAI,EAAE,YAAY,CAAC,CAAC,CAAC;IAOvD;;;;;;;;OAQG;IACG,MAAM,CAAC,CAAC,SAAS,UAAU,EAAE,IAAI,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IAMnF;;;;;;;;OAQG;IACG,MAAM,CAAC,CAAC,SAAS,UAAU,EAAE,IAAI,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IAUnF;;;;;;;OAOG;IACH,aAAa,CAAC,CAAC,SAAS,UAAU,EAAE,EAAE,SAAS,UAAU,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,GAAG,EAAE;CA4DjF"}