@aiao/rxdb 0.0.6 → 0.0.7

package/dist/version/conflict.d.ts

@@ -0,0 +1,75 @@
+import { RxDBChange } from '../system/change.js';
+/**
+ * 冲突信息
+ *
+ * 当本地未同步的变更与远程变更针对同一实体时产生冲突
+ */
+export interface Conflict {
+    /**
+     * 实体键：`${namespace}:${entity}:${entityId}`
+     */
+    entityKey: string;
+    /**
+     * 本地变更
+     */
+    local: RxDBChange;
+    /**
+     * 远程变更
+     */
+    remote: RxDBChange;
+    /**
+     * 共同祖先数据（用于三方合并，可选）
+     */
+    base?: Record<string, unknown>;
+}
+/**
+ * 冲突解决结果
+ */
+export type ConflictResolution = {
+    type: 'KEEP_LOCAL';
+} | {
+    type: 'KEEP_REMOTE';
+} | {
+    type: 'MERGE';
+    merged: Record<string, unknown>;
+} | {
+    type: 'DEFER';
+};
+/**
+ * 冲突解决器接口
+ *
+ * 可自定义实现，支持：
+ * - Last-Write-Wins（默认）
+ * - 字段级三方合并（类似 Git）
+ * - 交互式 UI 选择
+ *
+ * @example 自定义解决器
+ * ```typescript
+ * class MyResolver implements ConflictResolver {
+ *   async resolve(conflict: Conflict): Promise<ConflictResolution> {
+ *     // 显示 UI 让用户选择
+ *     const choice = await showConflictDialog(conflict);
+ *     return choice;
+ *   }
+ * }
+ * ```
+ */
+export interface ConflictResolver {
+    /**
+     * 解决单个冲突
+     *
+     * @param conflict - 冲突信息
+     * @returns 冲突解决结果
+     */
+    resolve(conflict: Conflict): Promise<ConflictResolution>;
+    /**
+     * 批量解决冲突（可选优化）
+     *
+     * 默认实现会逐个调用 resolve()
+     *
+     * @param conflicts - 冲突列表
+     * @returns 解决结果列表
+     */
+    resolveAll?(conflicts: Conflict[]): Promise<ConflictResolution[]>;
+}
+//# sourceMappingURL=conflict.d.ts.map

package/dist/version/conflict.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conflict.d.ts","sourceRoot":"","sources":["../../src/version/conflict.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEjD;;;;GAIG;AACH,MAAM,WAAW,QAAQ;IACvB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,KAAK,EAAE,UAAU,CAAC;IAElB;;OAEG;IACH,MAAM,EAAE,UAAU,CAAC;IAEnB;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAC1B;IAAE,IAAI,EAAE,YAAY,CAAA;CAAE,GACtB;IAAE,IAAI,EAAE,aAAa,CAAA;CAAE,GACvB;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,GAClD;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,CAAC;AAEtB;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;;;OAKG;IACH,OAAO,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAEzD;;;;;;;OAOG;IACH,UAAU,CAAC,CAAC,SAAS,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAAC;CACnE"}

package/dist/version/create_branch.d.ts

@@ -0,0 +1,13 @@
+import { RxDBBranch } from '../system/branch.js';
+import { RxDBChange } from '../system/change.js';
+import { VersionManager } from './VersionManager.js';
+/**
+ * 创建一个新分支
+ * @param version
+ * @param branchId
+ * @param fromChangeId
+ * @returns
+ */
+export declare const create_branch: (version: VersionManager, branchId: string, fromChangeId?: number) => Promise<RxDBBranch>;
+export declare const get_current_branch_last_change: (version: VersionManager, currentBranchId?: string) => Promise<RxDBChange>;
+//# sourceMappingURL=create_branch.d.ts.map

package/dist/version/create_branch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create_branch.d.ts","sourceRoot":"","sources":["../../src/version/create_branch.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAErD;;;;;;GAMG;AACH,eAAO,MAAM,aAAa,GAAU,SAAS,cAAc,EAAE,UAAU,MAAM,EAAE,eAAe,MAAM,wBA4DnG,CAAC;AAGF,eAAO,MAAM,8BAA8B,GAAU,SAAS,cAAc,EAAE,kBAAkB,MAAM,wBAqBrG,CAAC"}

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

@@ -0,0 +1,132 @@
+import { EntityMetadata } from '../entity/metadata.interface.js';
+/**
+ * Repository 标识符
+ */
+export interface RepositoryIdentifier {
+    /**
+     * 实体命名空间
+     * @example "public"
+     */
+    namespace: string;
+    /**
+     * 实体名称
+     * @example "Todo"
+     */
+    entity: string;
+}
+/**
+ * Repository 依赖关系
+ */
+export interface RepositoryDependency {
+    /**
+     * 当前 repository
+     */
+    repository: RepositoryIdentifier;
+    /**
+     * 依赖的 repository（外键指向的实体）
+     * Pull 时必须先同步这些实体
+     */
+    dependsOn: RepositoryIdentifier[];
+    /**
+     * 被依赖的 repository（指向当前实体的外键）
+     * Push 时必须等待这些实体同步完成
+     */
+    requiredBy: RepositoryIdentifier[];
+}
+/**
+ * 依赖图
+ * Key: `{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: EntityMetadata[]): 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/version/dependency-graph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dependency-graph.d.ts","sourceRoot":"","sources":["../../src/version/dependency-graph.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAGtE;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC;;;OAGG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;;OAGG;IACH,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;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,cAAc,EAAE,GAAG,eAAe,CA8ChF;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,eAAe,GAAG,IAAI,CAyCzD;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/version/find_switch_branch_step.d.ts

@@ -0,0 +1,53 @@
+import { RxDBBranch } from '../system/branch.js';
+/**
+ * 分支切换步骤
+ */
+export interface SwitchBranchStep {
+    /**
+     * 分支对象
+     */
+    branch: RxDBBranch;
+    /**
+     * 开始变更 ID
+     */
+    fromChangeId: number;
+    /**
+     * 目标变更 ID
+     */
+    toChangeId: number;
+}
+/**
+ * 查找分支切换路径的参数
+ */
+export interface FindBranchPathOptions {
+    /**
+     * 所需分支列表
+     */
+    branches: RxDBBranch[];
+    /**
+     * 当前分支
+     */
+    currentBranch: RxDBBranch;
+    /**
+     * 当前分支的变更 ID
+     */
+    currentChangeId: number | null;
+    /**
+     * 目标分支
+     */
+    nextBranch: RxDBBranch;
+    /**
+     * 目标分支的变更 ID
+     */
+    nextChangeId: number | null;
+}
+/**
+ * 计算出树的两个节点之间的切换路径
+ * 规则如下:
+ *  1, 如果两个树节点有共同的祖先节点,则路径为从当前节点到共同祖先节点,再到目标节点
+ *  2, 如果没有共同祖先节点,则路径为从当前节点到根节点,再到目标节点
+ *  3, 需要计算出路径内每个节点需要变更过程，也就是 fromChangeId -> toChangeId
+ *  4, 由于 changeId 在不同分支的变化都是是递增的, 所以如果逆向还原数据那么 fromChangeId 会大于 toChangeId, 正向应用数据则相反
+ */
+export declare const find_switch_branch_step: (options: FindBranchPathOptions) => SwitchBranchStep[];
+//# sourceMappingURL=find_switch_branch_step.d.ts.map

package/dist/version/find_switch_branch_step.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"find_switch_branch_step.d.ts","sourceRoot":"","sources":["../../src/version/find_switch_branch_step.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEjD;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,MAAM,EAAE,UAAU,CAAC;IACnB;;OAEG;IACH,YAAY,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC;;OAEG;IACH,QAAQ,EAAE,UAAU,EAAE,CAAC;IAEvB;;OAEG;IACH,aAAa,EAAE,UAAU,CAAC;IAE1B;;OAEG;IACH,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAE/B;;OAEG;IACH,UAAU,EAAE,UAAU,CAAC;IAEvB;;OAEG;IACH,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,uBAAuB,GAAI,SAAS,qBAAqB,KAAG,gBAAgB,EA2LxF,CAAC"}

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

@@ -0,0 +1,58 @@
+import { RxDB } from '../RxDB.js';
+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/version/get-all-repository-sync-status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-all-repository-sync-status.d.ts","sourceRoot":"","sources":["../../src/version/get-all-repository-sync-status.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAEvC,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/version/get-repository-sync-status.d.ts

@@ -0,0 +1,74 @@
+import { RxDB } from '../RxDB.js';
+/**
+ * 仓库标识
+ */
+export interface RepositoryIdentifier {
+    namespace: string;
+    entity: string;
+}
+/**
+ * 同步类型的取值
+ */
+export type SyncTypeValue = 'full' | '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/version/get-repository-sync-status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-repository-sync-status.d.ts","sourceRoot":"","sources":["../../src/version/get-repository-sync-status.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAOvC;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,GAAG,MAAM,CAAC;AAEjE;;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;AAqED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,uBAAuB,CAC3C,IAAI,EAAE,IAAI,EACV,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,oBAAoB,CAAC,CAiE/B"}

package/dist/version/pull-repository.d.ts

@@ -0,0 +1,99 @@
+import { VersionManager } from './VersionManager.js';
+import { RepositoryIdentifier } from './dependency-graph.js';
+/**
+ * 拉取仓库选项
+ */
+export interface PullRepositoryOptions {
+    /**
+     * 每次请求获取的最大变更数量
+     * @default 1000
+     */
+    limit?: number;
+    /**
+     * 是否通过多次请求获取所有变更
+     * @default false
+     */
+    fetchAll?: boolean;
+    /**
+     * 是否包含相关实体（级联同步）
+     *
+     * 当为 true 时：
+     * - 自动拉取所有父实体（外键引用）
+     * - 遵循拓扑顺序：父 -> 子
+     * - 示例：拉取 Post 时会自动拉取 User
+     *
+     * 当为 false 时：
+     * - 仅同步指定仓库
+     * - 如果父实体未同步，可能会导致外键约束错误
+     *
+     * @default true
+     */
+    includeRelated?: boolean;
+}
+/**
+ * 仓库拉取结果
+ */
+export interface PullRepositoryResult {
+    /**
+     * 仓库标识
+     */
+    repository: RepositoryIdentifier;
+    /**
+     * 拉取操作是否成功
+     * @default true
+     */
+    success?: boolean;
+    /**
+     * 拉取失败时的错误
+     */
+    error?: Error;
+    /**
+     * 如果仓库因依赖失败而被跳过，则说明跳过原因
+     */
+    skipped?: string;
+    /**
+     * 从远端拉取的变更数量（压缩前）
+     */
+    pulled: number;
+    /**
+     * 被压缩/丢弃的变更数量
+     * 示例：INSERT -> DELETE 的链式变更会被丢弃
+     */
+    compacted: number;
+    /**
+     * 成功应用到本地的变更数量（压缩后）
+     */
+    applied: number;
+    /**
+     * 是否还有更多变更可供拉取
+     */
+    hasMore: boolean;
+    /**
+     * 相关仓库的拉取结果（当 includeRelated=true 时）
+     */
+    relatedResults?: PullRepositoryResult[];
+}
+/**
+ * 为单个仓库拉取变更
+ *
+ * @param vm - VersionManager 实例
+ * @param namespace - 实体命名空间
+ * @param entity - 实体名称
+ * @param options - 拉取选项
+ * @returns 拉取结果
+ *
+ * @example
+ * ```ts
+ * // 在不进行级联的情况下拉取 Todo 仓库
+ * const result = await pullRepository(vm, 'public', 'Todo', {
+ *   includeRelated: false
+ * });
+ *
+ * // 拉取 Todo 及其所有依赖项（如 User）
+ * const result = await pullRepository(vm, 'public', 'Todo', {
+ *   includeRelated: true
+ * });
+ * ```
+ */
+export declare function pullRepository(vm: VersionManager, namespace: string, entity: string, options?: PullRepositoryOptions): Promise<PullRepositoryResult>;
+//# sourceMappingURL=pull-repository.d.ts.map

package/dist/version/pull-repository.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pull-repository.d.ts","sourceRoot":"","sources":["../../src/version/pull-repository.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAQH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE1D,OAAO,EAAwB,KAAK,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAIxF;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;;;;;;;;;;;;OAaG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC;;OAEG;IACH,UAAU,EAAE,oBAAoB,CAAC;IAEjC;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;OAEG;IACH,KAAK,CAAC,EAAE,KAAK,CAAC;IAEd;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;;OAGG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,OAAO,EAAE,OAAO,CAAC;IAEjB;;OAEG;IACH,cAAc,CAAC,EAAE,oBAAoB,EAAE,CAAC;CACzC;AAWD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAsB,cAAc,CAClC,EAAE,EAAE,cAAc,EAClB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,qBAAqB,GAC9B,OAAO,CAAC,oBAAoB,CAAC,CAwB/B"}

package/dist/version/pull.d.ts

@@ -0,0 +1,11 @@
+import { PullOptions, PullResult } from './VersionManager.interface.js';
+import { VersionManager } from './VersionManager.js';
+/**
+ * 执行 Pull 操作
+ *
+ * @param vm - VersionManager 实例
+ * @param options - Pull 选项
+ * @returns Pull 结果
+ */
+export declare function pull(vm: VersionManager, options?: PullOptions): Promise<PullResult>;
+//# sourceMappingURL=pull.d.ts.map

package/dist/version/pull.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pull.d.ts","sourceRoot":"","sources":["../../src/version/pull.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AACxE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE1D;;;;;;GAMG;AACH,wBAAsB,IAAI,CAAC,EAAE,EAAE,cAAc,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CA8DzF"}

package/dist/version/push-repository.d.ts

@@ -0,0 +1,93 @@
+import { RepositoryIdentifier } from './dependency-graph.js';
+import { VersionManager } from './VersionManager.js';
+/**
+ * 推送仓库选项
+ */
+export interface PushRepositoryOptions {
+    /**
+     * 每批次推送的最大变更数量
+     * @default 1000
+     */
+    batchSize?: number;
+    /**
+     * 是否包含相关实体（级联同步）
+     *
+     * 当为 true 时：
+     * - 自动推送所有子实体（引用当前实体的实体）
+     * - 遵循反向拓扑顺序：子 -> 父
+     * - 示例：推送 User 时会自动推送 Post
+     *
+     * 当为 false 时：
+     * - 仅同步指定仓库
+     * - 可能会导致远端数据不完整
+     *
+     * @default true
+     */
+    includeRelated?: boolean;
+}
+/**
+ * 仓库推送结果
+ */
+export interface PushRepositoryResult {
+    /**
+     * 仓库标识
+     */
+    repository: RepositoryIdentifier;
+    /**
+     * 推送操作是否成功
+     * @default true
+     */
+    success?: boolean;
+    /**
+     * 推送失败时的错误
+     */
+    error?: Error;
+    /**
+     * 如果仓库因依赖失败而被跳过，则说明跳过原因
+     */
+    skipped?: string;
+    /**
+     * 成功推送到远端的变更数量（压缩/合并后）
+     */
+    pushed: number;
+    /**
+     * 推送失败的变更数量
+     */
+    failed: number;
+    /**
+     * 被压缩/丢弃的变更数量
+     */
+    compacted: number;
+    /**
+     * 原始未推送变更数量（压缩前）
+     */
+    originalCount: number;
+    /**
+     * 相关仓库的推送结果（当 includeRelated=true 时）
+     */
+    relatedResults?: PushRepositoryResult[];
+}
+/**
+ * 为单个仓库推送变更
+ *
+ * @param vm - VersionManager 实例
+ * @param namespace - 实体命名空间
+ * @param entity - 实体名称
+ * @param options - 推送选项
+ * @returns 推送结果
+ *
+ * @example
+ * ```ts
+ * // 在不进行级联的情况下推送 Todo 仓库
+ * const result = await pushRepository(vm, 'public', 'Todo', {
+ *   includeRelated: false
+ * });
+ *
+ * // 推送 Todo 以及所有依赖它的实体（如 Comment）
+ * const result = await pushRepository(vm, 'public', 'Todo', {
+ *   includeRelated: true
+ * });
+ * ```
+ */
+export declare function pushRepository(vm: VersionManager, namespace: string, entity: string, options?: PushRepositoryOptions): Promise<PushRepositoryResult>;
+//# sourceMappingURL=push-repository.d.ts.map

package/dist/version/push-repository.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"push-repository.d.ts","sourceRoot":"","sources":["../../src/version/push-repository.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAQH,OAAO,EAAwB,KAAK,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAIxF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE1D;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;;;;;;;;;;;OAaG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC;;OAEG;IACH,UAAU,EAAE,oBAAoB,CAAC;IAEjC;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;OAEG;IACH,KAAK,CAAC,EAAE,KAAK,CAAC;IAEd;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,aAAa,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,cAAc,CAAC,EAAE,oBAAoB,EAAE,CAAC;CACzC;AAUD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAsB,cAAc,CAClC,EAAE,EAAE,cAAc,EAClB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,qBAAqB,GAC9B,OAAO,CAAC,oBAAoB,CAAC,CAyB/B"}

package/dist/version/push.d.ts

@@ -0,0 +1,11 @@
+import { PushOptions, PushResult } from './VersionManager.interface.js';
+import { VersionManager } from './VersionManager.js';
+/**
+ * 执行 Push 操作
+ *
+ * @param vm - VersionManager 实例
+ * @param options - Push 选项
+ * @returns Push 结果
+ */
+export declare function push(vm: VersionManager, options?: PushOptions): Promise<PushResult>;
+//# sourceMappingURL=push.d.ts.map

package/dist/version/push.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"push.d.ts","sourceRoot":"","sources":["../../src/version/push.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AACxE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE1D;;;;;;GAMG;AACH,wBAAsB,IAAI,CAAC,EAAE,EAAE,cAAc,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CA8DzF"}

package/dist/version/remove_branch.d.ts

@@ -0,0 +1,8 @@
+import { VersionManager } from './VersionManager.js';
+/**
+ * 移除一个分支
+ * @param version
+ * @param branchId
+ */
+export declare const remove_branch: (version: VersionManager, branchId: string) => Promise<void>;
+//# sourceMappingURL=remove_branch.d.ts.map

package/dist/version/remove_branch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remove_branch.d.ts","sourceRoot":"","sources":["../../src/version/remove_branch.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAErD;;;;GAIG;AACH,eAAO,MAAM,aAAa,GAAU,SAAS,cAAc,EAAE,UAAU,MAAM,kBAkD5E,CAAC"}