@aiao/rxdb-plugin-sync 0.0.0-stage → 0.0.28

package/dist/bulk-sync.d.ts

@@ -0,0 +1,117 @@
+import { RxDB } from '@aiao/rxdb';
+import { RepositoryIdentifier } from './dependency-graph.js';
+import { PullRepositoryOptions } from './pull-repository.js';
+import { PushRepositoryOptions } from './push-repository.js';
+import { SyncRepositoryResult } from './sync-repository.js';
+/**
+ * 批量同步选项
+ */
+export interface BulkSyncOptions {
+    /**
+     * 同步操作类型
+     * @default 'sync'
+     */
+    operation?: 'pull' | 'push' | 'sync';
+    /**
+     * 目标仓库列表
+     * 如果为空，则同步所有启用的仓库
+     */
+    repositories?: RepositoryIdentifier[];
+    /**
+     * 拉取选项（应用于所有仓库）
+     */
+    pull?: PullRepositoryOptions;
+    /**
+     * 推送选项（应用于所有仓库）
+     */
+    push?: PushRepositoryOptions;
+    /**
+     * 是否并发执行
+     * @default false
+     */
+    concurrent?: boolean;
+    /**
+     * 并发限制（只有 concurrent=true 时生效）
+     * @default 3
+     */
+    concurrency?: number;
+}
+/**
+ * 批量同步结果
+ */
+export interface BulkSyncResult {
+    /**
+     * 成功的仓库数量
+     */
+    succeeded: number;
+    /**
+     * 失败的仓库数量
+     */
+    failed: number;
+    /**
+     * 每个仓库的详细结果
+     */
+    results: Array<{
+        repository: RepositoryIdentifier;
+        success: boolean;
+        result?: SyncRepositoryResult;
+        error?: Error;
+    }>;
+    /**
+     * 总耗时（毫秒）
+     */
+    durationMs: number;
+}
+/**
+ * 获取需要同步的仓库列表
+ *
+ * 如果 options.repositories 有值则使用该值；否则从 rxdb.config.entities 中挑出**真正能同步**的仓库。
+ *
+ * @param rxdb - RxDB 实例
+ * @param options - 批量同步选项
+ * @returns 需要同步的仓库列表
+ *
+ * @remarks
+ * 这里是枚举路径，资格不足一律**跳过**（单仓入口才抛错）。两条过滤：
+ * - 能力矩阵：两个方向都不可同步的（`none` / `local`）没有理由进队列。此前只跳
+ *   `none`，`local` 会一路走到 `syncRepository` 才被 `shouldPull` / `shouldPush`
+ *   双双判负，凭空多出一条「同步了 0 条」的结果。
+ * - `RxDBSync.enabled`：被用户关掉的仓库跳过。留着它只会在 `pullRepository` /
+ *   `pushRepository` 里抛错，把「我关的」变成一条同步失败。
+ *
+ * @internal
+ */
+export declare function getRepositoriesToSync(rxdb: RxDB, options: BulkSyncOptions): Promise<RepositoryIdentifier[]>;
+/**
+ * 对多个仓库执行批量同步
+ *
+ * 支持顺序和并发两种执行模式。
+ * 在顺序模式下，仓库将被逐个同步。
+ * 在并发模式下，可以同时并发同步多个仓库。
+ *
+ * @param rxdb - RxDB 实例
+ * @param options - 批量同步选项
+ * @returns 带有成功/失败计数的批量同步结果
+ *
+ * @example
+ * ```typescript
+ * // 顺序同步所有启用的仓库
+ * const result = await bulkSync(rxdb);
+ *
+ * // 同步指定仓库
+ * const result = await bulkSync(rxdb, {
+ *   repositories: [
+ *     { namespace: 'public', entity: 'Todo' },
+ *     { namespace: 'public', entity: 'User' }
+ *   ]
+ * });
+ *
+ * // 并发同步并限制并发数
+ * const result = await bulkSync(rxdb, {
+ *   concurrent: true,
+ *   concurrency: 3
+ * });
+ * ```
+ */
+export declare function bulkSync(rxdb: RxDB, options?: BulkSyncOptions): Promise<BulkSyncResult>;
+//# sourceMappingURL=bulk-sync.d.ts.map

package/dist/bulk-sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bulk-sync.d.ts","sourceRoot":"","sources":["../src/bulk-sync.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAML,KAAK,IAAI,EAIV,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAClE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAClE,OAAO,EAAE,KAAK,qBAAqB,EAAwB,MAAM,sBAAsB,CAAC;AACxF,OAAO,EAA8C,KAAK,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAE7G;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;IAErC;;;OAGG;IACH,YAAY,CAAC,EAAE,oBAAoB,EAAE,CAAC;IAEtC;;OAEG;IACH,IAAI,CAAC,EAAE,qBAAqB,CAAC;IAE7B;;OAEG;IACH,IAAI,CAAC,EAAE,qBAAqB,CAAC;IAE7B;;;OAGG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IAErB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,OAAO,EAAE,KAAK,CAAC;QACb,UAAU,EAAE,oBAAoB,CAAC;QACjC,OAAO,EAAE,OAAO,CAAC;QACjB,MAAM,CAAC,EAAE,oBAAoB,CAAC;QAC9B,KAAK,CAAC,EAAE,KAAK,CAAC;KACf,CAAC,CAAC;IAEH;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,qBAAqB,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,oBAAoB,EAAE,CAAC,CA8BjH;AA0HD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAsB,QAAQ,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,GAAE,eAAoB,GAAG,OAAO,CAAC,cAAc,CAAC,CAuDjG"}

package/dist/cascade-blocking.d.ts

@@ -0,0 +1,38 @@
+import { RepositoryIdentifier } from '@aiao/rxdb';
+import { DependencyGraph } from './dependency-graph.js';
+import { DependencyEdge } from './topological-sort.js';
+/**
+ * 被依赖失败阻断的仓库，及其阻断来源
+ */
+export interface CascadeBlock {
+    /** 直接导致阻断的依赖仓库 */
+    dependency: RepositoryIdentifier;
+    /** 该依赖仓库失败的错误 */
+    cause: Error;
+}
+/**
+ * 在依赖图上查找阻断当前仓库的第一个失败依赖
+ *
+ * @param graph - 依赖图
+ * @param repoKey - 当前仓库的 `namespace:entity` 键
+ * @param failed - 已失败仓库到其错误的映射（键同为 `namespace:entity`）
+ * @param edge - 本相位沿哪条依赖边判定阻断，取自 `dependencyEdgeForAction`。
+ * **没有默认值是刻意的**：这个值必须和本相位的
+ * 拓扑序同源，随手给一个默认就等于允许两者各说各话。
+ * @returns 存在失败依赖时返回该依赖与其错误；否则返回 `undefined`
+ *
+ * @remarks
+ * 只看直接邻居：级联按拓扑序执行，间接依赖的失败会先把中间那一层标成失败，
+ * 再经由这一层传导下来。
+ *
+ * 边必须跟着相位走，不能一律取 `dependsOn`：
+ *
+ * - **INSERT/UPDATE** 父先子后，父建不出来子就挂不上外键 → 子被 `dependsOn` 阻断；
+ * - **DELETE** 子先父后，子删不掉父就删不得（外键还指着它）→ 父被 `requiredBy` 阻断。
+ *
+ * 此前两个相位都取 `dependsOn`，等于把 DELETE 的方向反过来看：子仓删除失败时
+ * 父仓照删不误，远端要么直接违反外键约束、要么留下指向已删父行的孤儿；反过来
+ * 父仓删除失败又会白白挡住子仓——删子从来不会破坏父。
+ */
+export declare function findBlockingDependency(graph: DependencyGraph, repoKey: string, failed: ReadonlyMap<string, Error>, edge: DependencyEdge): CascadeBlock | undefined;
+//# sourceMappingURL=cascade-blocking.d.ts.map

package/dist/cascade-blocking.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cascade-blocking.d.ts","sourceRoot":"","sources":["../src/cascade-blocking.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,KAAK,oBAAoB,EAAiB,MAAM,YAAY,CAAC;AACtE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC5D;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,kBAAkB;IAClB,UAAU,EAAE,oBAAoB,CAAC;IAEjC,iBAAiB;IACjB,KAAK,EAAE,KAAK,CAAC;CACd;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,eAAe,EACtB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,KAAK,CAAC,EAClC,IAAI,EAAE,cAAc,GACnB,YAAY,GAAG,SAAS,CAU1B"}

package/dist/check-repository-updates.d.ts

@@ -0,0 +1,47 @@
+import { RepositoryIdentifier, RxDB } from '@aiao/rxdb';
+export type { RepositoryIdentifier };
+/**
+ * 仓库更新检查结果。
+ */
+export interface CheckRepositoryUpdatesResult {
+    /**
+     * Repository 标识
+     */
+    repository: RepositoryIdentifier;
+    /**
+     * 远程最新的 changeId
+     */
+    remoteLatestChangeId: number;
+    /**
+     * 本地最后拉取的远程 changeId
+     */
+    localLastPullRemoteChangeId: number | null;
+    /**
+     * 待拉取的变更数量
+     */
+    pendingCount: number;
+    /**
+     * 是否有更新
+     */
+    hasUpdates: boolean;
+}
+/**
+ * 预检远程更新（不下载数据）
+ *
+ * @param rxdb - RxDB 实例
+ * @param namespace - 命名空间
+ * @param entity - 实体名称
+ * @returns 更新检查结果
+ *
+ * @example
+ * ```typescript
+ * // 检查 Todo 是否有远程更新
+ * const result = await checkRepositoryUpdates(rxdb, 'public', 'Todo');
+ * if (result.hasUpdates) {
+ *   console.log(`有 ${result.pendingCount} 条更新待拉取`);
+ *   // 用户点击"更新"按钮后再调用 pullRepository()
+ * }
+ * ```
+ */
+export declare function checkRepositoryUpdates(rxdb: RxDB, namespace: string, entity: string): Promise<CheckRepositoryUpdatesResult>;
+//# sourceMappingURL=check-repository-updates.d.ts.map

package/dist/check-repository-updates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"check-repository-updates.d.ts","sourceRoot":"","sources":["../src/check-repository-updates.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAgC,KAAK,oBAAoB,EAAE,KAAK,IAAI,EAAY,MAAM,YAAY,CAAC;AAI1G,YAAY,EAAE,oBAAoB,EAAE,CAAC;AAErC;;GAEG;AACH,MAAM,WAAW,4BAA4B;IAC3C;;OAEG;IACH,UAAU,EAAE,oBAAoB,CAAC;IAEjC;;OAEG;IACH,oBAAoB,EAAE,MAAM,CAAC;IAE7B;;OAEG;IACH,2BAA2B,EAAE,MAAM,GAAG,IAAI,CAAC;IAE3C;;OAEG;IACH,YAAY,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,UAAU,EAAE,OAAO,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,sBAAsB,CAC1C,IAAI,EAAE,IAAI,EACV,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,4BAA4B,CAAC,CA4EvC"}

package/dist/cleanup-expired.d.ts

@@ -0,0 +1,56 @@
+import { RuleGroup, RxDBEntityId } from '@aiao/rxdb';
+import { SyncManager } from './SyncManager.js';
+/**
+ * 过期数据清理选项
+ */
+export interface CleanupExpiredOptions {
+    /**
+     * 过滤条件（可选）
+     * 如果不提供，从实体元数据的 sync.remote.filter() 获取
+     */
+    filter?: RuleGroup;
+    /**
+     * 干跑模式，只返回将被删除的数量
+     * @default false
+     */
+    dryRun?: boolean;
+}
+/**
+ * 过期数据清理结果
+ */
+export interface CleanupExpiredResult {
+    /**
+     * 被清理的记录数量
+     */
+    removed: number;
+    /**
+     * 被清理的实体 ID 列表（仅 dryRun 模式或实际删除时）
+     */
+    removedIds?: RxDBEntityId[];
+}
+/**
+ * 清理不再满足过滤条件的本地过期数据
+ *
+ * 注意: 删除操作不会记录到 RxDBChange，因此不会同步到远程
+ * 这适用于"只保留最近 N 天数据"的场景
+ *
+ * @param sm - SyncManager 实例
+ * @param namespace - 命名空间
+ * @param entityName - 实体名
+ * @param options - 清理选项
+ * @returns 清理结果
+ *
+ * @example
+ * ```ts
+ * const thirtyDaysAgo = new Date(Date.now() - 30 * 24 * 60 * 60 * 1000);
+ * const { removed } = await cleanupExpired(sm, 'public', 'Order', {
+ *   filter: {
+ *     combinator: 'and',
+ *     rules: [{ field: 'updatedAt', operator: '>=', value: thirtyDaysAgo }]
+ *   }
+ * });
+ * console.log(`Removed ${removed} expired records`);
+ * ```
+ */
+export declare function cleanupExpired(sm: SyncManager, namespace: string, entityName: string, options?: CleanupExpiredOptions): Promise<CleanupExpiredResult>;
+//# sourceMappingURL=cleanup-expired.d.ts.map

package/dist/cleanup-expired.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cleanup-expired.d.ts","sourceRoot":"","sources":["../src/cleanup-expired.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EASL,KAAK,SAAS,EAEd,KAAK,YAAY,EAIlB,MAAM,YAAY,CAAC;AASpB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpD;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC;;;OAGG;IACH,MAAM,CAAC,EAAE,SAAS,CAAC;IAEnB;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,UAAU,CAAC,EAAE,YAAY,EAAE,CAAC;CAC7B;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAsB,cAAc,CAClC,EAAE,EAAE,WAAW,EACf,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,qBAAqB,GAC9B,OAAO,CAAC,oBAAoB,CAAC,CAiI/B"}

package/dist/dependency-graph.d.ts

@@ -0,0 +1,128 @@
+import { RelationKind, RepositoryIdentifier } from '@aiao/rxdb';
+interface DependencyGraphEntityRelation {
+    kind: RelationKind;
+    mappedEntity: string;
+    mappedNamespace?: string;
+}
+interface DependencyGraphEntityMetadata {
+    name: string;
+    namespace: string;
+    relations?: readonly DependencyGraphEntityRelation[];
+}
+export type { RepositoryIdentifier };
+/**
+ * Repository 依赖关系
+ */
+export interface RepositoryDependency {
+    /**
+     * 当前 repository
+     */
+    repository: RepositoryIdentifier;
+    /**
+     * 依赖的 repository（外键指向的实体）
+     * Pull 时必须先同步这些实体
+     */
+    dependsOn: RepositoryIdentifier[];
+    /**
+     * 被依赖的 repository（指向当前实体的外键）
+     * Push 时必须等待这些实体同步完成
+     */
+    requiredBy: RepositoryIdentifier[];
+}
+/**
+ * 依赖图
+ * 键：`{namespace}:{entity}`。
+ */
+export type DependencyGraph = Map<string, RepositoryDependency>;
+/**
+ * 构建依赖图
+ *
+ * @param entities - 实体元数据数组
+ * @returns 依赖图
+ *
+ * @example
+ * ```ts
+ * const entities = entityManager.getEntities();
+ * const graph = buildDependencyGraph(entities);
+ *
+ * // 查询 Todo 的依赖
+ * const todoDep = graph.get('public:Todo');
+ * console.log(todoDep.dependsOn); // [{ namespace: 'public', entity: 'User' }]
+ * ```
+ */
+export declare function buildDependencyGraph(entities: readonly DependencyGraphEntityMetadata[]): DependencyGraph;
+/**
+ * 检测循环依赖
+ *
+ * 注意：自引用（self-reference）不算循环依赖，因为树形结构是合法的
+ * 例如：RxDBBranch -> RxDBBranch (parent-child 关系)
+ *
+ * @param graph - 依赖图
+ * @throws {RxDBError} 如果检测到循环依赖
+ *
+ * @example
+ * ```ts
+ * // 抛出错误示例：
+ * // User -> Profile -> User (循环依赖)
+ * detectCycles(graph); // 抛出 RxDBError
+ *
+ * // 允许的情况：
+ * // RxDBBranch -> RxDBBranch (自引用，树形结构)
+ * ```
+ */
+export declare function detectCycles(graph: DependencyGraph): void;
+/**
+ * 获取 repository 的所有依赖（包括间接依赖）
+ *
+ * 注意：自引用会被跳过，避免无限递归
+ *
+ * @param namespace - 命名空间
+ * @param entity - 实体名称
+ * @param graph - 依赖图
+ * @returns 所有依赖的 repository（拓扑排序，父在前）
+ *
+ * @example
+ * ```ts
+ * // Comment -> Todo -> User
+ * const deps = getAllDependencies('public', 'Comment', graph);
+ * // 返回: [User, Todo, Comment]
+ * ```
+ */
+export declare function getAllDependencies(namespace: string, entity: string, graph: DependencyGraph): RepositoryIdentifier[];
+/**
+ * 获取 repository 的所有被依赖方（包括间接被依赖）
+ *
+ * 注意：自引用会被跳过，避免无限递归
+ *
+ * @param namespace - 命名空间
+ * @param entity - 实体名称
+ * @param graph - 依赖图
+ * @returns 所有被依赖的 repository（拓扑排序，子在前）
+ *
+ * @example
+ * ```ts
+ * // User <- Todo <- Comment
+ * const requiredBy = getAllRequiredBy('public', 'User', graph);
+ * // 返回: [Comment, Todo, User]
+ * ```
+ */
+export declare function getAllRequiredBy(namespace: string, entity: string, graph: DependencyGraph): RepositoryIdentifier[];
+/**
+ * 获取 repository 的直接父实体（一层依赖）
+ *
+ * @param namespace - 命名空间
+ * @param entity - 实体名称
+ * @param graph - 依赖图
+ * @returns 直接父实体列表
+ */
+export declare function getDirectParents(namespace: string, entity: string, graph: DependencyGraph): RepositoryIdentifier[];
+/**
+ * 获取 repository 的直接子实体（一层被依赖）
+ *
+ * @param namespace - 命名空间
+ * @param entity - 实体名称
+ * @param graph - 依赖图
+ * @returns 直接子实体列表
+ */
+export declare function getDirectChildren(namespace: string, entity: string, graph: DependencyGraph): RepositoryIdentifier[];
+//# sourceMappingURL=dependency-graph.d.ts.map

package/dist/dependency-graph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dependency-graph.d.ts","sourceRoot":"","sources":["../src/dependency-graph.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,YAAY,EAAE,KAAK,oBAAoB,EAAa,MAAM,YAAY,CAAC;AAEhF,UAAU,6BAA6B;IACrC,IAAI,EAAE,YAAY,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,UAAU,6BAA6B;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,SAAS,6BAA6B,EAAE,CAAC;CACtD;AAED,YAAY,EAAE,oBAAoB,EAAE,CAAC;AAErC;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC;;OAEG;IACH,UAAU,EAAE,oBAAoB,CAAC;IAEjC;;;OAGG;IACH,SAAS,EAAE,oBAAoB,EAAE,CAAC;IAElC;;;OAGG;IACH,UAAU,EAAE,oBAAoB,EAAE,CAAC;CACpC;AAED;;;GAGG;AACH,MAAM,MAAM,eAAe,GAAG,GAAG,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAC;AAEhE;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,SAAS,6BAA6B,EAAE,GAAG,eAAe,CA6CxG;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,eAAe,GAAG,IAAI,CA+CzD;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,eAAe,GAAG,oBAAoB,EAAE,CAmCpH;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,eAAe,GAAG,oBAAoB,EAAE,CAmClH;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,eAAe,GAAG,oBAAoB,EAAE,CAOlH;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,eAAe,GAAG,oBAAoB,EAAE,CAOnH"}

package/dist/get-all-repository-sync-status.d.ts

@@ -0,0 +1,58 @@
+import { RxDB } from '@aiao/rxdb';
+import { RepositorySyncStatus, SyncTypeValue } from './get-repository-sync-status.js';
+/**
+ * getAllRepositorySyncStatus 的过滤选项
+ */
+export interface GetAllRepositorySyncStatusFilter {
+    /**
+     * 按同步类型过滤
+     * 如果提供，则仅返回这些同步类型的仓库
+     */
+    syncType?: SyncTypeValue[];
+    /**
+     * 按启用状态过滤
+     * 如果为 true，则仅返回启用的仓库
+     * 如果为 false，则仅返回禁用的仓库
+     * 如果为 undefined，则返回全部
+     */
+    enabled?: boolean;
+    /**
+     * 按待处理变更过滤
+     * 如果为 true，则仅返回 pushableCount > 0 或 pullableCount > 0 的仓库
+     * 如果为 false，则仅返回没有待处理变更的仓库
+     * 如果为 undefined，则返回全部
+     */
+    hasPendingChanges?: boolean;
+}
+/**
+ * 获取所有仓库的同步状态
+ *
+ * 遍历所有注册实体并查询它们的同步状态，支持按 syncType、启用状态和待处理变更进行过滤。
+ *
+ * @param rxdb - RxDB 实例
+ * @param filter - 可选的过滤条件
+ * @returns 仓库同步状态数组
+ *
+ * @example
+ * ```typescript
+ * // 获取所有仓库状态
+ * const statuses = await getAllRepositorySyncStatus(rxdb);
+ *
+ * // 仅获取启用的仓库
+ * const statuses = await getAllRepositorySyncStatus(rxdb, {
+ *   enabled: true
+ * });
+ *
+ * // 仅获取有待处理变更的仓库
+ * const statuses = await getAllRepositorySyncStatus(rxdb, {
+ *   hasPendingChanges: true
+ * });
+ *
+ * // 仅获取 full/remote 同步类型的仓库
+ * const statuses = await getAllRepositorySyncStatus(rxdb, {
+ *   syncType: ['full', 'remote']
+ * });
+ * ```
+ */
+export declare function getAllRepositorySyncStatus(rxdb: RxDB, filter?: GetAllRepositorySyncStatusFilter): Promise<RepositorySyncStatus[]>;
+//# sourceMappingURL=get-all-repository-sync-status.d.ts.map

package/dist/get-all-repository-sync-status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-all-repository-sync-status.d.ts","sourceRoot":"","sources":["../src/get-all-repository-sync-status.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAqB,KAAK,IAAI,EAAE,MAAM,YAAY,CAAC;AAC1D,OAAO,EAEL,KAAK,oBAAoB,EACzB,KAAK,aAAa,EACnB,MAAM,iCAAiC,CAAC;AAEzC;;GAEG;AACH,MAAM,WAAW,gCAAgC;IAC/C;;;OAGG;IACH,QAAQ,CAAC,EAAE,aAAa,EAAE,CAAC;IAE3B;;;;;OAKG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;;;;OAKG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAsB,0BAA0B,CAC9C,IAAI,EAAE,IAAI,EACV,MAAM,CAAC,EAAE,gCAAgC,GACxC,OAAO,CAAC,oBAAoB,EAAE,CAAC,CAyCjC"}

package/dist/get-repository-sync-status.d.ts

@@ -0,0 +1,68 @@
+import { RepositoryIdentifier, RxDB } from '@aiao/rxdb';
+export type { RepositoryIdentifier };
+/**
+ * 同步类型的取值
+ */
+export type SyncTypeValue = 'full' | 'filter' | 'querycache' | 'remote' | 'local' | 'none';
+/**
+ * 仓库同步状态
+ */
+export interface RepositorySyncStatus {
+    /**
+     * 仓库标识
+     */
+    repository: RepositoryIdentifier;
+    /**
+     * 分支 ID
+     */
+    branchId: string;
+    /**
+     * 同步类型
+     */
+    syncType: SyncTypeValue;
+    /**
+     * 是否启用同步
+     */
+    enabled: boolean;
+    /**
+     * 最后一次推送的 changeId
+     */
+    lastPushedChangeId: number | null;
+    /**
+     * 最后一次推送时间戳
+     */
+    lastPushedAt: Date | null;
+    /**
+     * 最后一次拉取时间戳
+     */
+    lastPulledAt: Date | null;
+    /**
+     * 最后一次拉取到的远端 changeId
+     */
+    lastPullRemoteChangeId: number | null;
+    /**
+     * 待推送的变更数量
+     */
+    pushableCount: number;
+    /**
+     * 可供拉取的变更数量
+     */
+    pullableCount: number;
+}
+/**
+ * 获取单个仓库的同步状态
+ *
+ * @param rxdb - RxDB 实例
+ * @param namespace - 实体命名空间
+ * @param entity - 实体名称
+ * @returns 仓库同步状态
+ *
+ * @example
+ * ```typescript
+ * const status = await getRepositorySyncStatus(rxdb, 'public', 'Todo');
+ * console.log(`Sync type: ${status.syncType}`);
+ * console.log(`Pushable: ${status.pushableCount}, Pullable: ${status.pullableCount}`);
+ * ```
+ */
+export declare function getRepositorySyncStatus(rxdb: RxDB, namespace: string, entity: string): Promise<RepositorySyncStatus>;
+//# sourceMappingURL=get-repository-sync-status.d.ts.map

package/dist/get-repository-sync-status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-repository-sync-status.d.ts","sourceRoot":"","sources":["../src/get-repository-sync-status.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAKL,KAAK,oBAAoB,EACzB,KAAK,IAAI,EAKV,MAAM,YAAY,CAAC;AAIpB,YAAY,EAAE,oBAAoB,EAAE,CAAC;AAErC;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,QAAQ,GAAG,YAAY,GAAG,QAAQ,GAAG,OAAO,GAAG,MAAM,CAAC;AAE3F;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC;;OAEG;IACH,UAAU,EAAE,oBAAoB,CAAC;IAEjC;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,QAAQ,EAAE,aAAa,CAAC;IAExB;;OAEG;IACH,OAAO,EAAE,OAAO,CAAC;IAEjB;;OAEG;IACH,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAElC;;OAEG;IACH,YAAY,EAAE,IAAI,GAAG,IAAI,CAAC;IAE1B;;OAEG;IACH,YAAY,EAAE,IAAI,GAAG,IAAI,CAAC;IAE1B;;OAEG;IACH,sBAAsB,EAAE,MAAM,GAAG,IAAI,CAAC;IAEtC;;OAEG;IACH,aAAa,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,aAAa,EAAE,MAAM,CAAC;CACvB;AAwED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,uBAAuB,CAC3C,IAAI,EAAE,IAAI,EACV,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,oBAAoB,CAAC,CAgE/B"}

package/dist/index.d.ts

@@ -0,0 +1,39 @@
+/**
+ * @packageDocumentation
+ * `@aiao/rxdb-plugin-sync` —— 推拉同步、冲突处理与仓库依赖序。
+ *
+ * @remarks
+ * 核心 `@aiao/rxdb` 只保留**原语**：`RxDBSync` 水位表、变更编解码、冲突模型
+ * （`ConflictResolution` / `RxDBConflictError`）与同步资格判定。搬进本包的是**消费者**：
+ * 整库与单仓库两个粒度的 push / pull / sync、冲突落地、依赖拓扑序、过期清理与出站队列。
+ *
+ * US-025 阶段 D 之前这些入口挂在 `@aiao/rxdb-plugin-history` 的 `VersionManager` 上。
+ * 两件事的生命周期本就不同：撤销重做要在第一条 `rxdb_change` 之前就位，推拉同步则只在
+ * 配了远端时才有意义，所以它们各自成包。
+ *
+ * 本包 `inject: ['plugin:history']`，反向没有依赖——历史包不认识本包。这条单向耦合只走
+ * 一张窄接口：一次往返结束时 undo 边界要作废、待拉计数要结算，而那些状态的主人在历史侧。
+ *
+ * @example
+ * ```ts
+ * import { rxDBPluginHistory } from '@aiao/rxdb-plugin-history';
+ * import { rxDBPluginSync } from '@aiao/rxdb-plugin-sync';
+ *
+ * rxdb.use(rxDBPluginHistory);
+ * rxdb.use(rxDBPluginSync);
+ * await rxdb.connect();
+ *
+ * await rxdb.syncManager.sync();
+ * ```
+ */
+export * from './plugin.js';
+export type { BulkSyncOptions, BulkSyncResult } from './bulk-sync.js';
+export type { CheckRepositoryUpdatesResult } from './check-repository-updates.js';
+export type { CleanupExpiredOptions, CleanupExpiredResult } from './cleanup-expired.js';
+export type { DependencyGraph } from './dependency-graph.js';
+export type { GetAllRepositorySyncStatusFilter } from './get-all-repository-sync-status.js';
+export type { RepositorySyncStatus } from './get-repository-sync-status.js';
+export { countQueryCacheOutbox, flushQueryCacheOutbox, pendingQueryCacheWriteIds, type QueryCacheOutboxFailure, type QueryCacheOutboxResult } from './query-cache-outbox.js';
+export type { SyncBranchSkipReason, SyncBranchesResult } from './sync-branches.js';
+export type { SyncManager } from './SyncManager.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,cAAc,aAAa,CAAC;AAE5B,YAAY,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEtE,YAAY,EAAE,4BAA4B,EAAE,MAAM,+BAA+B,CAAC;AAIlF,YAAY,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAExF,YAAY,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE7D,YAAY,EAAE,gCAAgC,EAAE,MAAM,qCAAqC,CAAC;AAE5F,YAAY,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AAI5E,OAAO,EACL,qBAAqB,EACrB,qBAAqB,EACrB,yBAAyB,EACzB,KAAK,uBAAuB,EAC5B,KAAK,sBAAsB,EAC5B,MAAM,yBAAyB,CAAC;AAGjC,YAAY,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAEnF,YAAY,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC"}