@aiao/rxdb 0.0.5 → 0.0.7

package/dist/rxdb-adapter.d.ts

@@ -1,20 +1,41 @@
-import { Observable } from 'rxjs';
 import { EntityType } from './entity/entity.interface.js';
 import { IRepository } from './repository/repository.interface.js';
+import { RepositoryBase } from './repository/RepositoryBase.js';
 import { RxDB } from './RxDB.js';
+import { RxDBChange } from './system/change.js';
+import { RemoteChange } from './system/system.interface.js';
+import { SwitchVersionActions } from './version/VersionManager.interface.js';
+/**
+ * 仓库构造函数类型
+ * 确保注册的仓库是可实例化的具体类，而不是抽象类
+ * 支持带有额外泛型参数的仓库
+ */
+export type RepositoryConstructor<T extends RepositoryBase<any>> = new (...args: any[]) => T;
+export interface RxDBMutationsMap<T extends EntityType = any> {
+    create: Map<T, Set<InstanceType<T>>>;
+    remove: Map<T, Set<InstanceType<T>>>;
+    update: Map<T, Set<InstanceType<T>>>;
+}
 /**
  * 事务回调函数
  */
 export type TransactionFun = () => Promise<any>;
+export interface SwitchBranchOptions {
+    branchId: string;
+    actions: SwitchVersionActions;
+}
 /**
  * RxDB 数据库适配器接口
  */
 export interface IRxDBAdapter {
+    /**
+     * 适配器名称
+     */
     readonly name: string;
     /**
      * 连接数据库
      */
-    connect(): Observable<IRxDBAdapter>;
+    connect(): Promise<IRxDBAdapter>;
     /**
      * 取消连接
      */
@@ -26,11 +47,7 @@ export interface IRxDBAdapter {
     /**
      * 获取仓库
      */
-    getRepository<T extends EntityType, RT extends IRepository<T>>(EntityType: EntityType): RT;
-    /**
-     * 创建 table
-     */
-    createTables(EntityTypes: EntityType[], entities?: InstanceType<any>[]): Promise<boolean>;
+    getRepository<T extends EntityType, RT extends IRepository<T> = IRepository<T>>(EntityType: T): RT;
     /**
      * 保存多个实体
      * @param entities
@@ -41,6 +58,11 @@ export interface IRxDBAdapter {
      * @param entities
      */
     removeMany<T extends EntityType>(entities: InstanceType<T>[]): Promise<InstanceType<T>[]>;
+    /**
+     * 批量修改实体（创建/更新/删除）
+     * @param options 批量修改选项
+     */
+    mutations<T extends EntityType>(options: RxDBMutationsMap<T>): Promise<InstanceType<T>[]>;
     /**
      * 判断 table 是否存在
      */
@@ -51,10 +73,19 @@ export interface IRxDBAdapter {
  */
 export declare abstract class RxDBAdapterBase {
     readonly rxdb: RxDB;
+    protected readonly repository_map: Map<string, RepositoryConstructor<any>>;
+    protected readonly repository_cache: Map<EntityType, IRepository<any>>;
     constructor(rxdb: RxDB);
+    abstract getRepository<T extends EntityType, RT extends IRepository<T> = IRepository<T>>(EntityType: T): RT;
+    /**
+     * 注册适配器的仓库
+     * @param repositoryName
+     * @param RepositoryClass
+     */
+    protected repository<RT extends RepositoryBase<any>>(repositoryName: string, RepositoryClass: RepositoryConstructor<RT>): void;
 }
 export interface RestoreEntityOptions {
-    source: string;
+    changeId: string;
 }
 /**
  * 数据库适配器基类（本地）
@@ -62,28 +93,81 @@ export interface RestoreEntityOptions {
 export declare abstract class RxDBAdapterLocalBase extends RxDBAdapterBase {
     /**
      * 执行事务
+     * @param fun 事务回调函数
      */
     abstract transaction(fun: TransactionFun): Promise<any>;
     /**
-     * 创建分支
+     * 创建 tables
+     * @param EntityTypes 的类型数组
+     * @param entities 可选的实体实例数组，用于初始化数据
      */
-    abstract createBranch(branchId: string, fromChangeId?: number): Promise<void>;
+    abstract createTables(EntityTypes: EntityType[], entities?: InstanceType<any>[]): Promise<boolean>;
     /**
      * 切换分支
-     * @param branchId
+     * @param options 切换分支选项
      */
-    abstract switchBranch(branchId: string): Promise<void>;
+    abstract switchBranch(options: SwitchBranchOptions): Promise<void>;
     /**
-     * 恢复实体
-     * @param entity
-     * @param options
+     * 获取当前 RxDBChange 序列号
      */
-    abstract restoreEntity<T extends EntityType>(entity: InstanceType<T>, options: RestoreEntityOptions): Promise<InstanceType<T>>;
+    abstract getRxDBChangeSequence(): Promise<number>;
+    /**
+     * 应用压缩后的变更到本地实体表
+     *
+     * 实现策略（SQLite）：
+     * 1. 将 actions 转换为 SQL 操作
+     * 2. 在事务中：
+     *    a) 执行 SQL 操作实体表（INSERT/UPDATE/DELETE）
+     *    b) 批量插入 localChanges 到 RxDBChange 表（用于历史追踪）
+     * 3. 发送本地事件通知 UI 更新
+     *
+     * @param actions - 压缩后的变更操作集合（从远程 pull 来的）
+     * @param localChanges - 需要保存到本地 RxDBChange 表的记录（可选）
+     * @param disableTriggers - 是否禁用触发器（用于 pull 等操作，避免创建 RxDBChange）
+     */
+    abstract mergeChanges(actions: SwitchVersionActions, localChanges?: Omit<RxDBChange, 'id'>[], disableTriggers?: boolean): Promise<void>;
 }
 /**
  * 数据库适配器基类（远程）
  */
 export declare abstract class RxDBAdapterRemoteBase extends RxDBAdapterBase {
+    /**
+     * 从远程拉取变更记录
+     *
+     * @param sinceId - 拉取此 ID 之后的变更（不包含该 ID）
+     * @param limit - 最大拉取数量
+     * @param repositoryFilter - 可选的实体过滤列表（用于 repository-level sync）
+     * @returns 变更记录数组，按 id ASC 排序
+     */
+    abstract pullChanges(sinceId: number, limit?: number, repositoryFilter?: string[]): Promise<RemoteChange[]>;
+    /**
+     * 获取远程变更数量（轻量级，不下载数据）
+     *
+     * 此方法只查询远程有多少新变更，不返回实际数据。
+     * 用于实现 checkRepositoryUpdates() 功能，节省带宽。
+     *
+     * @param sinceId - 起始 changeId（不包含该 ID）
+     * @param repositoryFilter - 可选的实体过滤列表
+     * @returns 变更数量和最新 changeId
+     */
+    abstract getChangeCount(sinceId: number, repositoryFilter?: string[]): Promise<{
+        count: number;
+        latestChangeId: number;
+    }>;
+    /**
+     * 应用压缩后的变更到远程实体表
+     *
+     * 实现策略（Supabase）：
+     * 1. 将 actions (Map) 转换为 RemoteChange 记录
+     * 2. 在事务中：
+     *    a) 写入远程 RemoteChange 表（用于其他客户端 pull）
+     *    b) 直接操作远程实体表（INSERT/UPDATE/DELETE）
+     *
+     * @param actions - 压缩后的变更操作集合（从本地 push 来的）
+     * @param clientId - 客户端唯一标识（用于去重）
+     * @returns 创建的远程 RxDBChange 的最大 ID（用于更新 lastPullRemoteChangeId）
+     */
+    abstract mergeChanges(actions: SwitchVersionActions): Promise<number | void>;
 }
 /**
  * 适配器基础配置

package/dist/rxdb-adapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"rxdb-adapter.d.ts","sourceRoot":"","sources":["../src/rxdb-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,MAAM,CAAC;AAClC,OAAO,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAC1D,OAAO,EAAE,WAAW,EAAE,MAAM,sCAAsC,CAAC;AACnE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC;AAEhD;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,OAAO,IAAI,UAAU,CAAC,YAAY,CAAC,CAAC;IAEpC;;OAEG;IACH,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAE5B;;OAEG;IACH,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAE3B;;OAEG;IACH,aAAa,CAAC,CAAC,SAAS,UAAU,EAAE,EAAE,SAAS,WAAW,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,UAAU,GAAG,EAAE,CAAC;IAE3F;;OAEG;IACH,YAAY,CAAC,WAAW,EAAE,UAAU,EAAE,EAAE,QAAQ,CAAC,EAAE,YAAY,CAAC,GAAG,CAAC,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAE1F;;;OAGG;IACH,QAAQ,CAAC,CAAC,SAAS,UAAU,EAAE,QAAQ,EAAE,YAAY,CAAC,CAAC,CAAC,EAAE,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IAExF;;;OAGG;IACH,UAAU,CAAC,CAAC,SAAS,UAAU,EAAE,QAAQ,EAAE,YAAY,CAAC,CAAC,CAAC,EAAE,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IAE1F;;OAEG;IACH,cAAc,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAC1D;AAED;;GAEG;AACH,8BAAsB,eAAe;aACP,IAAI,EAAE,IAAI;gBAAV,IAAI,EAAE,IAAI;CACvC;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,8BAAsB,oBAAqB,SAAQ,eAAe;IAChE;;OAEG;IACH,QAAQ,CAAC,WAAW,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,GAAG,CAAC;IAEvD;;OAEG;IACH,QAAQ,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAE7E;;;OAGG;IACH,QAAQ,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAEtD;;;;OAIG;IACH,QAAQ,CAAC,aAAa,CAAC,CAAC,SAAS,UAAU,EACzC,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC,EACvB,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;CAC5B;AAED;;GAEG;AACH,8BAAsB,qBAAsB,SAAQ,eAAe;CAAG;AAEtE;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;AAEtD;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,IAAI,EAAE,IAAI,KAAK,OAAO,CAAC,YAAY,CAAC,GAAG,YAAY,CAAC;AAElF;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,CAAC;CAC9B"}
+{"version":3,"file":"rxdb-adapter.d.ts","sourceRoot":"","sources":["../src/rxdb-adapter.ts"],"names":[],"mappings":"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"}

package/dist/rxdb-events.d.ts

@@ -1,113 +1,382 @@
-import { EntityType, RowId } from './entity/entity.interface.js';
+import { EntityStaticType, EntityType } from './entity/entity.interface.js';
+import { Conflict } from './version/conflict.js';
+import { PullResult, PushResult } from './version/VersionManager.interface.js';
+/** 本地实体初始化事件类型 */
+export declare const ENTITY_LOCAL_NEW_EVENT = "ENTITY_LOCAL_NEW";
+/** 本地实体创建事件类型 */
+export declare const ENTITY_LOCAL_CREATE_EVENT = "ENTITY_LOCAL_CREATE";
+/** 本地实体更新事件类型 */
+export declare const ENTITY_LOCAL_UPDATE_EVENT = "ENTITY_LOCAL_UPDATE";
+/** 本地实体删除事件类型 */
+export declare const ENTITY_LOCAL_REMOVE_EVENT = "ENTITY_LOCAL_REMOVE";
+/** 远程实体创建事件类型 */
+export declare const ENTITY_REMOTE_CREATE_EVENT = "ENTITY_REMOTE_CREATE";
+/** 远程实体更新事件类型 */
+export declare const ENTITY_REMOTE_UPDATE_EVENT = "ENTITY_REMOTE_UPDATE";
+/** 远程实体删除事件类型 */
+export declare const ENTITY_REMOTE_REMOVE_EVENT = "ENTITY_REMOTE_REMOVE";
+/** 事务开始事件类型 */
+export declare const TRANSACTION_BEGIN = "TRANSACTION_BEGIN";
+/** 事务提交事件类型 */
+export declare const TRANSACTION_COMMIT = "TRANSACTION_COMMIT";
+/** 事务回滚事件类型 */
+export declare const TRANSACTION_ROLLBACK = "TRANSACTION_ROLLBACK";
+/** 分支切换开始事件类型 */
+export declare const SWITCH_BRANCH_BEGIN: "SWITCH_BRANCH_BEGIN";
+/** 分支切换提交事件类型 */
+export declare const SWITCH_BRANCH_COMMIT: "SWITCH_BRANCH_COMMIT";
+/** 分支切换回滚事件类型 */
+export declare const SWITCH_BRANCH_ROLLBACK: "SWITCH_BRANCH_ROLLBACK";
+/** 同步开始事件类型 */
+export declare const SYNC_BEGIN_EVENT: "SYNC_BEGIN";
+/** 同步完成事件类型 */
+export declare const SYNC_COMPLETE_EVENT: "SYNC_COMPLETE";
+/** 同步错误事件类型 */
+export declare const SYNC_ERROR_EVENT: "SYNC_ERROR";
+/** 远程变更待处理事件类型 */
+export declare const REMOTE_CHANGES_PENDING_EVENT: "REMOTE_CHANGES_PENDING";
+/** 冲突检测事件类型 */
+export declare const CONFLICT_DETECTED_EVENT: "CONFLICT_DETECTED";
+/** 冲突待处理事件类型 */
+export declare const CONFLICT_PENDING_EVENT: "CONFLICT_PENDING";
+/** Repository 同步开始事件类型 */
+export declare const REPOSITORY_SYNC_BEGIN_EVENT: "REPOSITORY_SYNC_BEGIN";
+/** Repository 同步完成事件类型 */
+export declare const REPOSITORY_SYNC_COMPLETE_EVENT: "REPOSITORY_SYNC_COMPLETE";
+/** Repository 同步错误事件类型 */
+export declare const REPOSITORY_SYNC_ERROR_EVENT: "REPOSITORY_SYNC_ERROR";
 /**
- * RxDB 实体事件抽象类
+ * RxDB 实体事件数据基础接口
  */
-declare abstract class AbstractRxDBEntityEvent {
-    readonly entities: InstanceType<EntityType>[];
-    abstract type: string;
-    constructor(entities: InstanceType<EntityType>[]);
+interface RxDBEntityLocalEventDataBase<T extends EntityType = EntityType> {
+    type: 'INSERT' | 'UPDATE' | 'DELETE' | 'NEW';
+    /** 命名空间 */
+    namespace: string;
+    /** 实体名称 */
+    entity: string;
+    /** 实体唯一标识符 */
+    id: EntityStaticType<T, 'idType'>;
+    /** 实体类型 */
+    entityType?: T;
+    /** 变更记录时间 */
+    recordAt: Date;
+}
+export interface RxDBEntityLocalNewEventData<T extends EntityType = EntityType> extends RxDBEntityLocalEventDataBase<T> {
+    patch: Readonly<Partial<InstanceType<T>>>;
+    inversePatch: null;
+}
+export interface RxDBEntityLocalCreatedEventData<T extends EntityType = EntityType> extends RxDBEntityLocalEventDataBase<T> {
+    patch: Readonly<InstanceType<T>>;
+    inversePatch: null;
+}
+export interface RxDBEntityLocalUpdatedEventData<T extends EntityType = EntityType> extends RxDBEntityLocalEventDataBase<T> {
+    patch: Readonly<Partial<InstanceType<T>>>;
+    inversePatch: Readonly<Partial<InstanceType<T>>>;
+}
+export interface RxDBEntityLocalRemovedEventData<T extends EntityType = EntityType> extends RxDBEntityLocalEventDataBase<T> {
+    patch: null;
+    inversePatch: Readonly<Partial<InstanceType<T>>>;
 }
-export declare const ENTITY_NEW_EVENT = "ENTITY_NEW";
+/** RxDB 实体本地事件数据联合类型 */
+export type RxDBEntityLocalEventData<T extends EntityType = EntityType> = RxDBEntityLocalNewEventData<T> | RxDBEntityLocalCreatedEventData<T> | RxDBEntityLocalUpdatedEventData<T> | RxDBEntityLocalRemovedEventData<T>;
+export interface RxDBEntityRemoteCreatedEventData<T extends EntityType = EntityType> extends RxDBEntityLocalEventDataBase<T> {
+    data: Readonly<InstanceType<T>>;
+}
+export interface RxDBEntityRemoteUpdatedEventData<T extends EntityType = EntityType> extends RxDBEntityLocalEventDataBase<T> {
+    data: Readonly<InstanceType<T>>;
+}
+export interface RxDBEntityRemoteRemovedEventData<T extends EntityType = EntityType> extends RxDBEntityLocalEventDataBase<T> {
+    data: Readonly<InstanceType<T>>;
+}
+/** RxDB 实体远程事件数据联合类型 */
+export type RxDBEntityRemoteEventData<T extends EntityType = EntityType> = RxDBEntityRemoteCreatedEventData<T> | RxDBEntityRemoteUpdatedEventData<T> | RxDBEntityRemoteRemovedEventData<T>;
 /**
- * 实体 被 new 出来
+ * 本地实体初始化事件
+ *
+ * 当实体通过构造函数被实例化(new)时触发。
+ * 此时实体对象已创建但尚未持久化到数据库。
  */
-export declare class EntityNewEvent extends AbstractRxDBEntityEvent {
+export declare class EntityLocalNewEvent {
+    readonly entities: RxDBEntityLocalNewEventData[];
     type: string;
+    constructor(entities: RxDBEntityLocalNewEventData[]);
 }
-export declare const ENTITY_CREATE_EVENT = "ENTITY_CREATE";
 /**
- * 实体 创建成功
+ * 本地实体创建成功事件
+ *
+ * 当实体成功持久化到数据库时触发。
  */
-export declare class EntityCreateEvent extends AbstractRxDBEntityEvent {
+export declare class EntityLocalCreatedEvent {
+    readonly entities: RxDBEntityLocalCreatedEventData[];
     type: string;
+    constructor(entities: RxDBEntityLocalCreatedEventData[]);
 }
-export declare const ENTITY_UPDATE_EVENT = "ENTITY_UPDATE";
 /**
- * 实体 更新成功
+ * 本地实体更新成功事件
+ *
+ * 当实体数据被更新到数据库时触发。
  */
-export declare class EntityUpdateEvent extends AbstractRxDBEntityEvent {
+export declare class EntityLocalUpdatedEvent {
+    readonly entities: RxDBEntityLocalUpdatedEventData[];
     type: string;
+    constructor(entities: RxDBEntityLocalUpdatedEventData[]);
 }
-export declare const ENTITY_REMOVE_EVENT = "ENTITY_REMOVE";
 /**
- * 实体 删除成功
+ * 本地实体删除成功事件
+ *
+ * 当实体从数据库中被成功删除时触发。
  */
-export declare class EntityRemoveEvent extends AbstractRxDBEntityEvent {
+export declare class EntityLocalRemovedEvent {
+    readonly entities: RxDBEntityLocalRemovedEventData[];
     type: string;
+    constructor(entities: RxDBEntityLocalRemovedEventData[]);
 }
-/**
- * 实体 所有事件
- */
-export interface RxDBEntityEventMap {
-    [ENTITY_NEW_EVENT]: EntityNewEvent;
-    [ENTITY_CREATE_EVENT]: EntityCreateEvent;
-    [ENTITY_UPDATE_EVENT]: EntityUpdateEvent;
-    [ENTITY_REMOVE_EVENT]: EntityRemoveEvent;
+/** 远程实体创建事件 */
+export declare class EntityRemoteCreatedEvent {
+    readonly entities: RxDBEntityRemoteCreatedEventData[];
+    type: string;
+    constructor(entities: RxDBEntityRemoteCreatedEventData[]);
 }
-export declare const TRANSACTION_BEGIN = "TRANSACTION_BEGIN";
-export declare const TRANSACTION_COMMIT = "TRANSACTION_COMMIT";
-export declare const TRANSACTION_ROLLBACK = "TRANSACTION_ROLLBACK";
-/**
- * 事务 开始
- */
+/** 远程实体更新事件 */
+export declare class EntityRemoteUpdatedEvent {
+    readonly entities: RxDBEntityRemoteUpdatedEventData[];
+    type: string;
+    constructor(entities: RxDBEntityRemoteUpdatedEventData[]);
+}
+/** 远程实体删除事件 */
+export declare class EntityRemoteRemovedEvent {
+    readonly entities: RxDBEntityRemoteRemovedEventData[];
+    type: string;
+    constructor(entities: RxDBEntityRemoteRemovedEventData[]);
+}
+/** 事务开始事件 */
 export declare class TransactionBeginEvent {
     type: string;
 }
-/**
- * 事务 提交
- */
+/** 事务提交事件 */
 export declare class TransactionCommitEvent {
     type: string;
 }
-/**
- * 事务 回滚
- */
+/** 事务回滚事件 */
 export declare class TransactionRollbackEvent {
     type: string;
 }
-export declare const DATABASE_DELETE = "DATABASE_DELETE";
-export declare const DATABASE_INSERT = "DATABASE_INSERT";
-export declare const DATABASE_UPDATE = "DATABASE_UPDATE";
+/** 分支切换开始事件 */
+export declare class SwitchBranchBeginEvent {
+    type: "SWITCH_BRANCH_BEGIN";
+}
+/** 分支切换提交事件 */
+export declare class SwitchBranchCommitEvent {
+    type: "SWITCH_BRANCH_COMMIT";
+}
+/** 分支切换回滚事件 */
+export declare class SwitchBranchRollbackEvent {
+    type: "SWITCH_BRANCH_ROLLBACK";
+}
 /**
- * 数据变化
+ * 同步方向
  */
-export interface IRxDBAdapterDataChange {
-    rowIds: RowId[];
-    recordAt: Date;
+export type SyncDirection = 'pull' | 'push';
+/**
+ * 同步开始事件
+ *
+ * 当开始执行 pull() 或 push() 操作时触发
+ */
+export declare class SyncBeginEvent {
+    /** 同步方向 */
+    readonly direction: SyncDirection;
+    readonly type: "SYNC_BEGIN";
+    constructor(
+    /** 同步方向 */
+    direction: SyncDirection);
 }
-declare abstract class AbstractRxDBAdapterDataChangeEvent {
-    readonly EntityType: EntityType;
-    readonly data: IRxDBAdapterDataChange;
-    abstract type: string;
-    constructor(EntityType: EntityType, data: IRxDBAdapterDataChange);
+/**
+ * 同步完成事件
+ *
+ * 当 pull() 或 push() 操作成功完成时触发
+ */
+export declare class SyncCompleteEvent {
+    /** 同步方向 */
+    readonly direction: SyncDirection;
+    /** 同步结果 */
+    readonly result: PullResult | PushResult;
+    readonly type: "SYNC_COMPLETE";
+    constructor(
+    /** 同步方向 */
+    direction: SyncDirection, 
+    /** 同步结果 */
+    result: PullResult | PushResult);
 }
-export declare class RxDBAdapterDeleteChangeEvent extends AbstractRxDBAdapterDataChangeEvent {
-    type: string;
+/**
+ * 同步错误事件
+ *
+ * 当 pull() 或 push() 操作失败时触发
+ */
+export declare class SyncErrorEvent {
+    /** 同步方向 */
+    readonly direction: SyncDirection;
+    /** 错误信息 */
+    readonly error: Error;
+    readonly type: "SYNC_ERROR";
+    constructor(
+    /** 同步方向 */
+    direction: SyncDirection, 
+    /** 错误信息 */
+    error: Error);
 }
-export declare class RxDBAdapterInsertChangeEvent extends AbstractRxDBAdapterDataChangeEvent {
-    type: string;
+/**
+ * 冲突检测事件
+ *
+ * 当 pull 时检测到本地未同步变更与远程变更冲突时触发
+ */
+export declare class ConflictDetectedEvent {
+    /** 发现的冲突列表 */
+    readonly conflicts: Conflict[];
+    /** 已自动解决的数量 */
+    readonly resolved: number;
+    /** 延迟处理的数量 */
+    readonly deferred: number;
+    readonly type: "CONFLICT_DETECTED";
+    constructor(
+    /** 发现的冲突列表 */
+    conflicts: Conflict[], 
+    /** 已自动解决的数量 */
+    resolved: number, 
+    /** 延迟处理的数量 */
+    deferred: number);
 }
-export declare class RxDBAdapterUpdateChangeEvent extends AbstractRxDBAdapterDataChangeEvent {
-    type: string;
+/**
+ * 冲突待处理事件
+ *
+ * 当有冲突解决结果为 DEFER 时触发
+ */
+export declare class ConflictPendingEvent {
+    /** 待处理的冲突列表 */
+    readonly conflicts: Conflict[];
+    readonly type: "CONFLICT_PENDING";
+    constructor(
+    /** 待处理的冲突列表 */
+    conflicts: Conflict[]);
 }
 /**
- * Rxdb 事件
+ * Repository 同步方向
  */
+export type RepositorySyncDirection = 'pull' | 'push' | 'sync';
+/**
+ * Repository 同步开始事件
+ *
+ * 当开始执行 pullRepository(), pushRepository() 或 syncRepository() 时触发
+ */
+export declare class RepositorySyncBeginEvent {
+    /** 同步方向 */
+    readonly direction: RepositorySyncDirection;
+    /** 命名空间 */
+    readonly namespace: string;
+    /** 实体名称 */
+    readonly entity: string;
+    /** 是否包含关联实体 */
+    readonly includeRelated: boolean;
+    readonly type: "REPOSITORY_SYNC_BEGIN";
+    constructor(
+    /** 同步方向 */
+    direction: RepositorySyncDirection, 
+    /** 命名空间 */
+    namespace: string, 
+    /** 实体名称 */
+    entity: string, 
+    /** 是否包含关联实体 */
+    includeRelated: boolean);
+}
+/**
+ * Repository 同步完成事件
+ *
+ * 当 repository 同步操作成功完成时触发
+ */
+export declare class RepositorySyncCompleteEvent {
+    /** 同步方向 */
+    readonly direction: RepositorySyncDirection;
+    /** 命名空间 */
+    readonly namespace: string;
+    /** 实体名称 */
+    readonly entity: string;
+    /** 同步结果统计 */
+    readonly result: {
+        pulled?: number;
+        pushed?: number;
+        compacted?: number;
+        failed?: number;
+    };
+    readonly type: "REPOSITORY_SYNC_COMPLETE";
+    constructor(
+    /** 同步方向 */
+    direction: RepositorySyncDirection, 
+    /** 命名空间 */
+    namespace: string, 
+    /** 实体名称 */
+    entity: string, 
+    /** 同步结果统计 */
+    result: {
+        pulled?: number;
+        pushed?: number;
+        compacted?: number;
+        failed?: number;
+    });
+}
+/**
+ * Repository 同步错误事件
+ *
+ * 当 repository 同步操作失败时触发
+ */
+export declare class RepositorySyncErrorEvent {
+    /** 同步方向 */
+    readonly direction: RepositorySyncDirection;
+    /** 命名空间 */
+    readonly namespace: string;
+    /** 实体名称 */
+    readonly entity: string;
+    /** 错误信息 */
+    readonly error: Error;
+    readonly type: "REPOSITORY_SYNC_ERROR";
+    constructor(
+    /** 同步方向 */
+    direction: RepositorySyncDirection, 
+    /** 命名空间 */
+    namespace: string, 
+    /** 实体名称 */
+    entity: string, 
+    /** 错误信息 */
+    error: Error);
+}
+/** RxDB 实体事件映射接口 */
+export interface RxDBEntityEventMap {
+    [ENTITY_LOCAL_NEW_EVENT]: EntityLocalNewEvent;
+    [ENTITY_LOCAL_CREATE_EVENT]: EntityLocalCreatedEvent;
+    [ENTITY_LOCAL_UPDATE_EVENT]: EntityLocalUpdatedEvent;
+    [ENTITY_LOCAL_REMOVE_EVENT]: EntityLocalRemovedEvent;
+    [ENTITY_REMOTE_CREATE_EVENT]: EntityRemoteCreatedEvent;
+    [ENTITY_REMOTE_UPDATE_EVENT]: EntityRemoteUpdatedEvent;
+    [ENTITY_REMOTE_REMOVE_EVENT]: EntityRemoteRemovedEvent;
+}
+/** RxDB 完整事件映射接口 */
 export interface RxDBEventMap extends RxDBEntityEventMap {
     [TRANSACTION_BEGIN]: TransactionBeginEvent;
     [TRANSACTION_COMMIT]: TransactionCommitEvent;
     [TRANSACTION_ROLLBACK]: TransactionRollbackEvent;
-    [DATABASE_DELETE]: RxDBAdapterDeleteChangeEvent;
-    [DATABASE_INSERT]: RxDBAdapterInsertChangeEvent;
-    [DATABASE_UPDATE]: RxDBAdapterUpdateChangeEvent;
+    [SWITCH_BRANCH_BEGIN]: SwitchBranchBeginEvent;
+    [SWITCH_BRANCH_COMMIT]: SwitchBranchCommitEvent;
+    [SWITCH_BRANCH_ROLLBACK]: SwitchBranchRollbackEvent;
+    [SYNC_BEGIN_EVENT]: SyncBeginEvent;
+    [SYNC_COMPLETE_EVENT]: SyncCompleteEvent;
+    [SYNC_ERROR_EVENT]: SyncErrorEvent;
+    [CONFLICT_DETECTED_EVENT]: ConflictDetectedEvent;
+    [CONFLICT_PENDING_EVENT]: ConflictPendingEvent;
+    [REPOSITORY_SYNC_BEGIN_EVENT]: RepositorySyncBeginEvent;
+    [REPOSITORY_SYNC_COMPLETE_EVENT]: RepositorySyncCompleteEvent;
+    [REPOSITORY_SYNC_ERROR_EVENT]: RepositorySyncErrorEvent;
 }
-/**
- * RxDB 实体事件
- */
+/** RxDB 实体事件联合类型 */
 export type RxDBEntityEvent = RxDBEntityEventMap[keyof RxDBEntityEventMap];
-/**
- * RxDB 事件
- */
+/** RxDB 事件联合类型 */
 export type RxDBEvent = RxDBEventMap[keyof RxDBEventMap];
 export {};
 //# sourceMappingURL=rxdb-events.d.ts.map