@aiao/rxdb-plugin-history 0.0.0-stage → 0.0.26

package/dist/merge-branch.d.ts

@@ -0,0 +1,22 @@
+import { MergeBranchOptions, MergeBranchResult } from '@aiao/rxdb';
+import { VersionManager } from './VersionManager.js';
+/**
+ * 合并分支
+ *
+ * 将源分支的变更合并到当前激活分支（目标分支）。
+ *
+ * 支持两种策略：
+ * - `squash`（默认）：将源分支所有变更压缩为最小操作集后应用，过滤幽灵操作（源分支内
+ *   INSERT 后又 DELETE 的实体不会影响目标分支）
+ * - `normal`：逐条应用源分支变更，每条变更在目标分支产生独立的变更记录，不过滤幽灵操作
+ *
+ * 合并后可选删除源分支。
+ *
+ * @param version - VersionManager 实例
+ * @param sourceBranchId - 源分支 ID
+ * @param currentBranchId - 当前激活分支 ID（由调用方提供，避免重复查询）
+ * @param options - 合并选项
+ * @returns 合并结果
+ */
+export declare const merge_branch: (version: VersionManager, sourceBranchId: string, currentBranchId: string, options?: MergeBranchOptions) => Promise<MergeBranchResult>;
+//# sourceMappingURL=merge-branch.d.ts.map

package/dist/merge-branch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge-branch.d.ts","sourceRoot":"","sources":["../src/merge-branch.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoB,kBAAkB,EAAE,iBAAiB,EAAmC,MAAM,YAAY,CAAC;AACtH,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAIrD;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,YAAY,GACvB,SAAS,cAAc,EACvB,gBAAgB,MAAM,EACtB,iBAAiB,MAAM,EACvB,UAAU,kBAAkB,KAC3B,OAAO,CAAC,iBAAiB,CA4H3B,CAAC"}

package/dist/plugin.d.ts

@@ -0,0 +1,58 @@
+import { IRxDBPlugin, Plugin, RxDBPluginBase } from '@aiao/rxdb';
+import { LifecycleScope } from '@aiao/utils';
+import { VersionManager } from './VersionManager.js';
+/** 本插件当前不接受任何选项 */
+export type RxDBPluginHistoryOptions = object;
+/**
+ * 历史 / 撤销重做 / 分支插件。
+ *
+ * @remarks
+ * **不声明 `inject`**：`VersionManager.init()` 只挂事件监听与订阅，一条适配器读写都不发。
+ * 声明 `adapter:local` 会把安装推到引导链之后，而 `HistoryManager` 的分支流必须在第一条
+ * `rxdb_change` 事件到达之前就已经订阅上——装晚了，那一批变更不进历史。这也正是搬进插件
+ * 之前的时序：核心在构造器里 `new VersionManager()`、在 `init()` 里调 `init()`，
+ * 两者都早于 `schemaManager.init()`。
+ *
+ * 两处宿主改动都登记在 `scope` 上，断开连接时由宿主逆序释放：
+ *
+ * 1. `rxdb.versionManager` 这个实例槽位 —— 释放时连同 `destroy()` 一起撤掉，不给下一个
+ *    纪元留一个指向已拆事件总线的管理器。槽位排在最先获取，因而最后撤，`destroy()`
+ *    才跑得在槽位仍可读的窗口里；
+ * 2. {@link RxDB.syncState} 上的可推送计数订阅 —— 枢纽活得和实例一样长，计数却只在连接
+ *    期间有意义，因此走 `bindPushableCount()` 拿一个解绑函数，而不是在构造枢纽时传进去。
+ *
+ * 同一枢纽上的「重算待拉数」跳板**不在这里**：`refreshPullableCount()` 随 US-025 阶段 D
+ * 去了 `@aiao/rxdb-plugin-sync`，接住 `requestPullableRefresh()` 于是也是那个插件的活。
+ * 只装历史不装同步时那个请求发进空里，正是「没有同步就没有待拉数」的实情。
+ */
+export declare class RxDBPluginHistory extends RxDBPluginBase implements IRxDBPlugin {
+    readonly lifecycle: "scoped";
+    name: Uncapitalize<string>;
+    install(scope: LifecycleScope): void;
+}
+declare module '@aiao/rxdb' {
+    interface RxDB {
+        /**
+         * 历史 / 撤销重做 / 分支子系统。
+         *
+         * @remarks
+         * 由 `@aiao/rxdb-plugin-history` 在连接纪元内装配。**没装插件时这个槽位不存在**：
+         * 读它拿到 `undefined`，而不是一个什么都不做的空壳——核心不做 fallback 兜底。
+         */
+        versionManager: VersionManager;
+    }
+}
+/**
+ * 历史插件工厂。
+ *
+ * @param db - 宿主实例
+ *
+ * @example
+ * ```ts
+ * import { rxDBPluginHistory } from '@aiao/rxdb-plugin-history';
+ *
+ * rxdb.use(rxDBPluginHistory);
+ * ```
+ */
+export declare const rxDBPluginHistory: Plugin<RxDBPluginHistoryOptions>;
+//# sourceMappingURL=plugin.d.ts.map

package/dist/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,EAAQ,cAAc,EAAE,MAAM,YAAY,CAAC;AACvE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAErD,mBAAmB;AACnB,MAAM,MAAM,wBAAwB,GAAG,MAAM,CAAC;AAE9C;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBAAa,iBAAkB,SAAQ,cAAe,YAAW,WAAW;IAC1E,QAAQ,CAAC,SAAS,EAAG,QAAQ,CAAU;IACvC,IAAI,EAAE,YAAY,CAAC,MAAM,CAAC,CAAa;IAEvC,OAAO,CAAC,KAAK,EAAE,cAAc;CAyB9B;AAED,OAAO,QAAQ,YAAY,CAAC;IAC1B,UAAU,IAAI;QACZ;;;;;;WAMG;QACH,cAAc,EAAE,cAAc,CAAC;KAChC;CACF;AAED;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,wBAAwB,CAA2C,CAAC"}

package/dist/pullable-count.d.ts

@@ -0,0 +1,37 @@
+import { PullOptions, PullResult } from '@aiao/rxdb';
+/**
+ * 结算一次 pull 所需的全部输入
+ */
+export interface PullableSettlement {
+    /** 本次 pull 是否覆盖了当前分支的完整仓库集合，且没有遗留分页或失败 */
+    complete: boolean;
+    /** 结算令牌签发之后是否又有远端事件到达 */
+    concurrent: boolean;
+    /** 本次 pull 实际取回的变更数 */
+    pulled: number;
+}
+/**
+ * 判断一次 pull 是否算「完整同步」
+ *
+ * @param options - 发起 pull 时的选项
+ * @param result - pull 的结果
+ * @returns 覆盖了全部仓库、没有下一页、也没有失败仓库时返回 `true`
+ *
+ * @remarks
+ * `repositoryFilter` 传了空数组等价于不过滤：判成不完整会让绝大多数正常 pull 永远清不掉计数。
+ */
+export declare function isCompletePull(options: PullOptions | undefined, result: PullResult): boolean;
+/**
+ * 计算结算后的 pullable 计数
+ *
+ * @param current - 结算前的计数
+ * @param settlement - 结算输入
+ * @returns 结算后的计数（不会为负）
+ *
+ * @remarks
+ * 只有「完整同步」且「期间没有新的远端事件」才归零。`concurrent` 这一关是必须的：
+ * pull 期间到达的事件描述的是快照之后的新变更，本次 pull 没有覆盖它们，
+ * 归零等于把它们吞掉，界面从此再也不会提示这批数据。
+ */
+export declare function settledPullableCount(current: number, settlement: PullableSettlement): number;
+//# sourceMappingURL=pullable-count.d.ts.map

package/dist/pullable-count.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pullable-count.d.ts","sourceRoot":"","sources":["../src/pullable-count.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE1D;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,0CAA0C;IAC1C,QAAQ,EAAE,OAAO,CAAC;IAElB,yBAAyB;IACzB,UAAU,EAAE,OAAO,CAAC;IAEpB,uBAAuB;IACvB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,WAAW,GAAG,SAAS,EAAE,MAAM,EAAE,UAAU,GAAG,OAAO,CAK5F;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,kBAAkB,GAAG,MAAM,CAK5F"}

package/dist/push-inflight.d.ts

@@ -0,0 +1,60 @@
+/**
+ * 推送在飞登记：push 把「正在往远端送」的变更区间挂出来，undo 认这个区间。
+ *
+ * @module rxdb/version/push-inflight
+ */
+/**
+ * 一次 push 调用期间持有的认领句柄。
+ *
+ * 一次 `pushRepository` 可能同时推多个仓库（级联），因此 `claim` 可以调多次，
+ * 而 {@link release} 一次把这一轮的全部认领撤干净 —— 谁开的谁关，中途从哪条路径
+ * 提前返回都不会漏。
+ */
+export interface PushInFlightSession {
+    /**
+     * 声明本轮正在把某仓库 id ≤ `maxChangeId` 的变更送往远端。
+     *
+     * @param repositoryKey - `namespace:entity`
+     * @param maxChangeId - 本轮送出的最大 change id
+     *
+     * @remarks
+     * 同一仓库重复认领取**较大**者：级联路径分相位推同一份计划，后一相位不该把
+     * 前一相位已经罩住的区间缩回去。
+     */
+    claim(repositoryKey: string, maxChangeId: number): void;
+    /** 撤销本 session 的全部认领。重复调用是空操作。 */
+    release(): void;
+}
+/**
+ * 「哪些变更此刻正在飞往远端」的进程内登记处。
+ *
+ * @remarks
+ * 存在的理由是一个时序缺口：撤销的判据是「还没推上去」，而这件事的数据源
+ * `RxDBSync.lastPushedChangeId` 只在 push **提交**时才写。push 的远端往返在事务之外，
+ * 于是「已经发出去了、水位线还没推进」这段窗口里，`undo()` 会放行一条其实已经到达
+ * 远端的变更。
+ *
+ * 撤销**不产生新的变更行**（`undo-redo-apply.ts` 只给原行打 `revertChangeId` 标记），
+ * 而出站查询过滤 `revertChangeId = null` —— 那条变更从此远端有、本地无，且没有任何
+ * 一次 push 会把这个差异送出去。本登记处把那段窗口填上：在飞即视同已推。
+ *
+ * **只覆盖本进程。** 多 tab / Tauri 多进程共享同一份本地库时，另一个进程的 push
+ * 在这里是看不见的。跨进程要的是数据库里的一条租约行，而 push 路径目前整体就没有
+ * 跨进程互斥（两个进程会各自推同一批变更），那是另一个问题，不在这里假装解决。
+ */
+export declare class PushInFlightRegistry {
+    #private;
+    /**
+     * 开一轮认领。
+     *
+     * @returns 本轮的认领句柄；调用方必须在 `finally` 里 {@link PushInFlightSession.release}
+     */
+    session(): PushInFlightSession;
+    /**
+     * 当前全部在飞认领，按仓库取最大值。
+     *
+     * @returns `namespace:entity` -> 正在飞的最大 change id；没有任何认领时是空 Map
+     */
+    snapshot(): ReadonlyMap<string, number>;
+}
+//# sourceMappingURL=push-inflight.d.ts.map

package/dist/push-inflight.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"push-inflight.d.ts","sourceRoot":"","sources":["../src/push-inflight.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;GAMG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;;;;;;;OASG;IACH,KAAK,CAAC,aAAa,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAExD,kCAAkC;IAClC,OAAO,IAAI,IAAI,CAAC;CACjB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,oBAAoB;;IAK/B;;;;OAIG;IACH,OAAO,IAAI,mBAAmB;IAiB9B;;;;OAIG;IACH,QAAQ,IAAI,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC;CAWxC"}

package/dist/redo-stack.d.ts

@@ -0,0 +1,56 @@
+import { HistoryItem } from '@aiao/rxdb';
+import { Observable } from 'rxjs';
+/**
+ * Redo 栈容量上限（会话内）
+ *
+ * 超过则丢弃最旧的项（尾部），避免长会话下无界增长。
+ */
+export declare const MAX_REDO_STACK_SIZE = 1000;
+/**
+ * 会话级 Redo 栈
+ *
+ * 从 HistoryManager 抽离的 redo 栈管理子模块：
+ * - 持有内存 `BehaviorSubject<HistoryItem[]>`（不持久化）
+ * - 新项总在头部（push 后第一个）
+ * - 容量上限 `MAX_REDO_STACK_SIZE`
+ *
+ * 设计理由：
+ * - HistoryManager 原本 1120 行，redo 栈状态 + 操作占 60+ 行且与 history 查询/undo 流程正交
+ * - 独立后可单测，并避免泄漏 BehaviorSubject 引用
+ *
+ * @internal 由 HistoryManager 持有；外部通过 HistoryManager 公共 API 访问
+ */
+export declare class RedoStack {
+    #private;
+    /**
+     * 当前 redo 栈的可观察流（新项在前）
+     */
+    get items$(): Observable<HistoryItem[]>;
+    /**
+     * 当前栈快照
+     */
+    get value(): HistoryItem[];
+    /**
+     * 将一组历史项压入栈顶（items 在前）
+     *
+     * 超过 MAX_REDO_STACK_SIZE 时丢弃尾部最旧项。
+     */
+    push(items: HistoryItem[]): void;
+    /**
+     * 按稳定身份（`fingerprint`）移除已应用的项。
+     *
+     * @param items - 已经 redo 完成、需要出栈的项
+     * @returns 实际被移除的项（按栈中原顺序）；不在栈中的项被忽略
+     *
+     * @remarks
+     * **不能用「移除 N 项」代替身份匹配**：作用域 redo 会先按 scope 筛出本作用域的项再应用，
+     * 这些项未必位于栈顶。按数量截栈顶会删掉栈头那些**未被 redo** 的项（它们从此丢失），
+     * 而真正已 redo 的项仍留在栈里可以被重复执行。
+     */
+    remove(items: HistoryItem[]): HistoryItem[];
+    /**
+     * 清空栈
+     */
+    clear(): void;
+}
+//# sourceMappingURL=redo-stack.d.ts.map

package/dist/redo-stack.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redo-stack.d.ts","sourceRoot":"","sources":["../src/redo-stack.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,EAAmB,UAAU,EAAE,MAAM,MAAM,CAAC;AAEnD;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,OAAO,CAAC;AAExC;;;;;;;;;;;;;GAaG;AACH,qBAAa,SAAS;;IAGpB;;OAEG;IACH,IAAI,MAAM,IAAI,UAAU,CAAC,WAAW,EAAE,CAAC,CAEtC;IAED;;OAEG;IACH,IAAI,KAAK,IAAI,WAAW,EAAE,CAEzB;IAED;;;;OAIG;IACH,IAAI,CAAC,KAAK,EAAE,WAAW,EAAE,GAAG,IAAI;IAMhC;;;;;;;;;;OAUG;IACH,MAAM,CAAC,KAAK,EAAE,WAAW,EAAE,GAAG,WAAW,EAAE;IAS3C;;OAEG;IACH,KAAK,IAAI,IAAI;CAGd"}

package/dist/remove-branch.d.ts

@@ -0,0 +1,16 @@
+import { VersionManager } from './VersionManager.js';
+/**
+ * 移除一个分支
+ * @param version
+ * @param branchId
+ *
+ * @remarks
+ * 「查子分支 → 查 change → 删」整段必须在一个事务窗口内完成。
+ * 拆开之后，检查与删除之间新建的子分支会漏判，留下 `parentId` 指向不存在分支的孤儿，
+ * 而孤儿又会被切分支时的「父节点缺失即当作到根」静默吞掉，损坏无声。
+ *
+ * 事务体内一律用 `executor.getRepository(...)`：绑在适配器上的仓库会重新入队，
+ * 排在自己这个事务后面（队列并发度 1），永久挂起。
+ */
+export declare const remove_branch: (version: VersionManager, branchId: string) => Promise<void>;
+//# sourceMappingURL=remove-branch.d.ts.map

package/dist/remove-branch.d.ts.map

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

package/dist/restore-entity.d.ts

@@ -0,0 +1,15 @@
+import { EntityType, RestoreEntityOptions } from '@aiao/rxdb';
+import { VersionManager } from './VersionManager.js';
+/**
+ * 恢复被删除的实体。
+ *
+ * 根据 RxDBChange 记录中的 inversePatch 重新插入实体，
+ * 恢复操作本身会生成新的 RxDBChange 记录（可被 push 到远程）。
+ *
+ * @param vm - 版本管理器实例
+ * @param entity - 被删除的实体实例（需要包含 metadata 信息）
+ * @param options - 恢复选项，包含 changeId（DELETE 类型的 RxDBChange 记录 ID）
+ * @returns 恢复后的实体实例
+ */
+export declare function restore_entity<T extends EntityType>(vm: VersionManager, entity: InstanceType<T>, options: RestoreEntityOptions): Promise<InstanceType<T>>;
+//# sourceMappingURL=restore-entity.d.ts.map

package/dist/restore-entity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"restore-entity.d.ts","sourceRoot":"","sources":["../src/restore-entity.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,UAAU,EAAqB,oBAAoB,EAAa,MAAM,YAAY,CAAC;AAE5F,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE1D;;;;;;;;;;GAUG;AACH,wBAAsB,cAAc,CAAC,CAAC,SAAS,UAAU,EACvD,EAAE,EAAE,cAAc,EAClB,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC,EACvB,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAsE1B"}

package/dist/scope-selection.d.ts

@@ -0,0 +1,55 @@
+import { HistoryItem, HistoryScope, RxDBChange, RxDBError } from '@aiao/rxdb';
+/** 判定作用域归属只需要这三个字段 */
+type ScopedChange = Pick<RxDBChange, 'entity' | 'entityId' | 'namespace'>;
+/**
+ * 单条变更是否落在作用域内
+ *
+ * @remarks
+ * entity 作用域用 `===` 比较 id，`0` / `''` 这类假值同样是合法 id——
+ * 判空必须用 `undefined` 而不是真值判断，否则 `entityId = 0` 会退化成 repository 作用域。
+ */
+export declare function isChangeInScope(change: ScopedChange, scope: HistoryScope): boolean;
+/** 历史项是否**至少有一条**变更落在作用域内（决定它是否出现在该作用域的历史里） */
+export declare function historyTouchesScope(history: HistoryItem, scope: HistoryScope): boolean;
+/** 历史项是否**全部**变更都落在作用域内（决定它能否被该作用域整条应用） */
+export declare function isHistoryWithinScope(history: HistoryItem, scope: HistoryScope): boolean;
+/** {@link selectScopedHistories} 的结果 */
+export interface ScopedHistorySelection {
+    /** 触及作用域、但同时改了作用域外数据的事务：不可部分应用 */
+    crossScope: HistoryItem[];
+    /** 完全落在作用域内、可以整条应用的历史项（未被裁剪） */
+    selected: HistoryItem[];
+}
+/**
+ * 在作用域内挑出接下来 `step` 条要 undo / redo 的历史项
+ *
+ * @param histories - 候选历史（已按可撤销 / 可重做过滤，最新在前）
+ * @param scope - 作用域
+ * @param step - 取几条；非正数取 0 条
+ *
+ * @remarks
+ * `step` 数的是「触及作用域的历史项」，越界事务同样占一个名额而不是被跳过——
+ * undo 必须后进先出，跳过它去撤更早的那条会把顺序弄乱。
+ */
+export declare function selectScopedHistories(histories: HistoryItem[], scope: HistoryScope, step: number): ScopedHistorySelection;
+/**
+ * 作用域 undo / redo 撞上跨作用域事务
+ *
+ * @remarks
+ * 拿到本错误说明选中的历史项里有事务同时改了作用域内外的数据。作用域**不会**替你决定
+ * 是牺牲原子性还是越权撤销，改用不带参数的 `rxdb.versionManager.history()`
+ * （database 作用域）可以完整撤销这个事务。`historyManager` 是私有字段，够不到。
+ */
+export declare class RxDBCrossScopeTransactionError extends RxDBError {
+    /** 发起 undo / redo 的作用域 */
+    readonly scope: HistoryScope;
+    /** 越界的历史项（完整未裁剪） */
+    readonly histories: readonly HistoryItem[];
+    constructor(
+    /** 发起 undo / redo 的作用域 */
+    scope: HistoryScope, 
+    /** 越界的历史项（完整未裁剪） */
+    histories: readonly HistoryItem[]);
+}
+export {};
+//# sourceMappingURL=scope-selection.d.ts.map

package/dist/scope-selection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope-selection.d.ts","sourceRoot":"","sources":["../src/scope-selection.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAC9E,sBAAsB;AACtB,KAAK,YAAY,GAAG,IAAI,CAAC,UAAU,EAAE,QAAQ,GAAG,UAAU,GAAG,WAAW,CAAC,CAAC;AAE1E;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,YAAY,EAAE,KAAK,EAAE,YAAY,GAAG,OAAO,CAIlF;AAED,+CAA+C;AAC/C,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,YAAY,GAAG,OAAO,CAEtF;AAED,2CAA2C;AAC3C,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,YAAY,GAAG,OAAO,CAEvF;AAED,wCAAwC;AACxC,MAAM,WAAW,sBAAsB;IACrC,kCAAkC;IAClC,UAAU,EAAE,WAAW,EAAE,CAAC;IAC1B,gCAAgC;IAChC,QAAQ,EAAE,WAAW,EAAE,CAAC;CACzB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,WAAW,EAAE,EACxB,KAAK,EAAE,YAAY,EACnB,IAAI,EAAE,MAAM,GACX,sBAAsB,CAcxB;AAuBD;;;;;;;GAOG;AACH,qBAAa,8BAA+B,SAAQ,SAAS;IAEzD,0BAA0B;IAC1B,QAAQ,CAAC,KAAK,EAAE,YAAY;IAC5B,oBAAoB;IACpB,QAAQ,CAAC,SAAS,EAAE,SAAS,WAAW,EAAE;;IAH1C,0BAA0B;IACjB,KAAK,EAAE,YAAY;IAC5B,oBAAoB;IACX,SAAS,EAAE,SAAS,WAAW,EAAE;CAS7C"}

package/dist/switch-branch-actions.d.ts

@@ -0,0 +1,16 @@
+import { RxDBChange, SwitchVersionActions } from '@aiao/rxdb';
+import { VersionManager } from './VersionManager.js';
+/**
+ * 计算切换分支所需的操作
+ * @param version
+ * @param branchId 要切换到的分支ID
+ * @returns 返回切换分支所需的操作序列
+ */
+export declare const switch_branch_actions: (version: VersionManager, branchId: string) => Promise<SwitchVersionActions<import('@aiao/rxdb').EntityType>>;
+/**
+ * 计算切换版本所需的操作
+ * @param changes 需要计算的 changes
+ * @param options
+ */
+export declare const get_switch_version_actions: (changes: RxDBChange[], isPatch: boolean, actions?: SwitchVersionActions) => SwitchVersionActions;
+//# sourceMappingURL=switch-branch-actions.d.ts.map

package/dist/switch-branch-actions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"switch-branch-actions.d.ts","sourceRoot":"","sources":["../src/switch-branch-actions.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,UAAU,EAEV,oBAAoB,EACrB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,GAAU,SAAS,cAAc,EAAE,UAAU,MAAM,mEAmFpF,CAAC;AAkBF;;;;GAIG;AACH,eAAO,MAAM,0BAA0B,GACrC,SAAS,UAAU,EAAE,EACrB,SAAS,OAAO,EAChB,UAAS,oBAIR,KACA,oBA4FF,CAAC"}

package/dist/sync-history-bridge.d.ts

@@ -0,0 +1,87 @@
+import { PullOptions, PullResult } from '@aiao/rxdb';
+import { HistoryManager } from './HistoryManager.js';
+import { PushInFlightRegistry } from './push-inflight.js';
+/**
+ * 同步插件可见的历史侧能力。
+ *
+ * @remarks
+ * 由 `VersionManager.syncBridge` 提供，`SyncManager` 在构造时接过去。
+ *
+ * @internal
+ */
+export interface SyncHistoryBridge {
+    /**
+     * 「哪些变更此刻正在飞往远端」的登记处。
+     *
+     * @remarks
+     * push 与 undo 唯一的会合点，主人是 {@link VersionManager} —— undo 侧经
+     * `rxdb.versionManager.pushInFlight` 读它，push 侧经本桥认领区间。
+     * 两边读的必须是同一个实例，见 {@link PushInFlightRegistry}。
+     */
+    readonly pushInFlight: PushInFlightRegistry;
+    /**
+     * 在可重入同步上下文中执行：期间产生的本地写入不进 undo/redo 栈。
+     *
+     * @param fn - 同步动作
+     */
+    syncing<T>(fn: () => Promise<T>): Promise<T>;
+    /** 与远端合并之后清空当前分支的 undo/redo —— 合并前的内容已经 undo 不回去了 */
+    clearUndoHistory(): void;
+    /**
+     * pull 开始前签发结算令牌。
+     *
+     * @returns 令牌，交回 {@link settlePull} / {@link settleAbortedPull} /
+     * {@link reconcilePullableCount}
+     *
+     * @remarks
+     * 必须在真正发起 pull **之前**取：拉取期间到达的远端事件描述的是快照之后的新变更，
+     * 结算时要能看出来，否则「完整同步」的归零会把它们一起吞掉。
+     */
+    beginPullableSettlement(): number;
+    /**
+     * 按一次成功 pull 的实际覆盖范围结算待拉计数。
+     *
+     * @param token - {@link beginPullableSettlement} 签发的令牌
+     * @param options - 发起 pull 时的选项
+     * @param result - pull 的结果
+     */
+    settlePull(token: number, options: PullOptions | undefined, result: PullResult): void;
+    /**
+     * 按一次抛错 pull 已落库的部分结算待拉计数。
+     *
+     * @param token - {@link beginPullableSettlement} 签发的令牌
+     * @param pulled - 抛错前已经真实落库的条数，一条都没落时传 0
+     *
+     * @remarks
+     * 令牌必须收回，否则代次永远停在旧值，后续结算全被判成「并发」。
+     */
+    settleAbortedPull(token: number, pulled: number): void;
+    /**
+     * 用远端水位线校准待拉计数。
+     *
+     * @param token - {@link beginPullableSettlement} 签发的令牌
+     * @param count - 按各仓库持久化水位线算出的待拉总数
+     */
+    reconcilePullableCount(token: number, count: number): void;
+    /**
+     * 远端事件到达时累加待拉计数。
+     *
+     * @param count - 本次事件里属于当前激活分支的条数
+     */
+    incrementPullableCount(count: number): void;
+}
+/**
+ * 造一座桥。
+ *
+ * @param historyManager - 取当前 {@link HistoryManager} 的闭包
+ * @param pushInFlight - 飞行登记处
+ *
+ * @remarks
+ * 第一个参数是闭包而不是实例：`VersionManager` 在 `init()` 里会重建
+ * {@link HistoryManager}（上一纪元 destroy 过），桥若捏着旧实例，重连后所有结算
+ * 都会打进一个已经拆掉事件总线的管理器。
+ *
+ * @internal
+ */
+export declare const createSyncHistoryBridge: (historyManager: () => HistoryManager, pushInFlight: PushInFlightRegistry) => SyncHistoryBridge;
+//# sourceMappingURL=sync-history-bridge.d.ts.map

package/dist/sync-history-bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-history-bridge.d.ts","sourceRoot":"","sources":["../src/sync-history-bridge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC1D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE1D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAE/D;;;;;;;GAOG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;;;;;OAOG;IACH,QAAQ,CAAC,YAAY,EAAE,oBAAoB,CAAC;IAE5C;;;;OAIG;IACH,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAE7C,qDAAqD;IACrD,gBAAgB,IAAI,IAAI,CAAC;IAEzB;;;;;;;;;OASG;IACH,uBAAuB,IAAI,MAAM,CAAC;IAElC;;;;;;OAMG;IACH,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,GAAG,SAAS,EAAE,MAAM,EAAE,UAAU,GAAG,IAAI,CAAC;IAEtF;;;;;;;;OAQG;IACH,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAEvD;;;;;OAKG;IACH,sBAAsB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAE3D;;;;OAIG;IACH,sBAAsB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7C;AAED;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,uBAAuB,GAClC,gBAAgB,MAAM,cAAc,EACpC,cAAc,oBAAoB,KACjC,iBAaD,CAAC"}

package/dist/undo-redo-apply.d.ts

@@ -0,0 +1,47 @@
+import { FindOptions, HistoryItem, IRepository, RxDB, RxDBAdapterLocalBase, RxDBChange, RxDBSync, RxDBSyncOrderByField, RxDBSyncRuleGroup } from '@aiao/rxdb';
+import { BehaviorSubject, Subject } from 'rxjs';
+import { ActiveUndoSession, UndoBoundary } from './history-undo-session.types.js';
+type LocalRxDBSyncRepository = IRepository<typeof RxDBSync> & {
+    find(options: FindOptions<typeof RxDBSync, RxDBSyncRuleGroup, RxDBSyncOrderByField>): Promise<RxDBSync[]>;
+};
+export declare const getLocalRxDBSyncRepository: (adapter: RxDBAdapterLocalBase) => LocalRxDBSyncRepository;
+/**
+ * undo / redo / pushableCount 所需的可变状态。
+ *
+ * `#` 字段必须通过 getter/setter 关闭 captured 实例；Map / Subject 用类持有的同一份引用。
+ */
+export interface UndoRedoApplyHost {
+    readonly rxdb: RxDB;
+    readonly destroyed: boolean;
+    isUndoRedoInProgress: boolean;
+    redoInvalidationFloor: number;
+    pushableGeneration: number;
+    readonly pushableCount$: BehaviorSubject<number>;
+    readonly pushableCountTrigger$: BehaviorSubject<number>;
+    readonly errors$: Subject<Error>;
+    getFirstConnectedAt(): Date;
+    isUndoSessionCurrent(session: ActiveUndoSession): boolean;
+    getNextRevertStateUpdatedAt(changes: RxDBChange[]): Date;
+    setRevertStateWatermarks(changes: RxDBChange[], reverted: boolean, updatedAt: Date): void;
+    pushToRedoStack(items: HistoryItem[]): void;
+    removeFromRedoStack(items: HistoryItem[]): HistoryItem[];
+}
+/** 绕过 Observable 缓存，直接查最新变更再转成历史项。 */
+export declare function fetchLatestHistories(host: UndoRedoApplyHost, undoBoundary: UndoBoundary): Promise<{
+    histories: HistoryItem[];
+    lastPushedMap: Map<string, number>;
+}>;
+/**
+ * 应用 undo/redo：提取排序 → switchBranch actions → 元数据 → 身份检查 → 切分支 → 栈。
+ *
+ * undo 在 `adapter.switchBranch` 前必须做 session 对象身份检查。
+ */
+export declare function applyUndoRedoHistories(host: UndoRedoApplyHost, operation: 'undo' | 'redo', histories: HistoryItem[], undoSession?: ActiveUndoSession): Promise<void>;
+/**
+ * 按 repository 水位线异步刷新 pushableCount。
+ *
+ * 只有仍是最新那次刷新才有资格改写计数。失败字符串 `'[#updatePushableCount] error'` 不得改。
+ */
+export declare function updatePushableCount(host: UndoRedoApplyHost): Promise<void>;
+export {};
+//# sourceMappingURL=undo-redo-apply.d.ts.map

package/dist/undo-redo-apply.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"undo-redo-apply.d.ts","sourceRoot":"","sources":["../src/undo-redo-apply.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,WAAW,EAChB,KAAK,WAAW,EAChB,KAAK,WAAW,EAEhB,KAAK,IAAI,EACT,KAAK,oBAAoB,EAEzB,UAAU,EAEV,QAAQ,EACR,KAAK,oBAAoB,EACzB,KAAK,iBAAiB,EACvB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,eAAe,EAAkB,OAAO,EAAE,MAAM,MAAM,CAAC;AAGhE,OAAO,KAAK,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAEvF,KAAK,uBAAuB,GAAG,WAAW,CAAC,OAAO,QAAQ,CAAC,GAAG;IAC5D,IAAI,CAAC,OAAO,EAAE,WAAW,CAAC,OAAO,QAAQ,EAAE,iBAAiB,EAAE,oBAAoB,CAAC,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;CAC3G,CAAC;AAEF,eAAO,MAAM,0BAA0B,GAAI,SAAS,oBAAoB,KAAG,uBACA,CAAC;AAE5E;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IACpB,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,oBAAoB,EAAE,OAAO,CAAC;IAC9B,qBAAqB,EAAE,MAAM,CAAC;IAC9B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,cAAc,EAAE,eAAe,CAAC,MAAM,CAAC,CAAC;IACjD,QAAQ,CAAC,qBAAqB,EAAE,eAAe,CAAC,MAAM,CAAC,CAAC;IACxD,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;IACjC,mBAAmB,IAAI,IAAI,CAAC;IAC5B,oBAAoB,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC;IAC1D,2BAA2B,CAAC,OAAO,EAAE,UAAU,EAAE,GAAG,IAAI,CAAC;IACzD,wBAAwB,CAAC,OAAO,EAAE,UAAU,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,SAAS,EAAE,IAAI,GAAG,IAAI,CAAC;IAC1F,eAAe,CAAC,KAAK,EAAE,WAAW,EAAE,GAAG,IAAI,CAAC;IAC5C,mBAAmB,CAAC,KAAK,EAAE,WAAW,EAAE,GAAG,WAAW,EAAE,CAAC;CAC1D;AAED,sCAAsC;AACtC,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,iBAAiB,EACvB,YAAY,EAAE,YAAY,GACzB,OAAO,CAAC;IAAE,SAAS,EAAE,WAAW,EAAE,CAAC;IAAC,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,CAAC,CAoD3E;AAED;;;;GAIG;AACH,wBAAsB,sBAAsB,CAC1C,IAAI,EAAE,iBAAiB,EACvB,SAAS,EAAE,MAAM,GAAG,MAAM,EAC1B,SAAS,EAAE,WAAW,EAAE,EACxB,WAAW,CAAC,EAAE,iBAAiB,GAC9B,OAAO,CAAC,IAAI,CAAC,CAiEf;AAED;;;;GAIG;AACH,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAsEhF"}

package/dist/version-manager.utils.d.ts

@@ -0,0 +1,30 @@
+/**
+ * @fileoverview 版本管理器的纯函数工具集
+ *
+ * 从 {@link VersionManager} 抽出的无状态辅助函数，供变更事件处理流程复用。
+ *
+ * @remarks
+ * 同步侧那两个（`hasSyncedData` / `partialResultOf`）随 US-025 阶段 D 去了
+ * `@aiao/rxdb-plugin-sync` 的 `sync-manager.utils.ts`：它们的形参是
+ * `SyncRepositoryResult`，留在这里会让历史包反向依赖同步包。
+ */
+/**
+ * 从变更事件里提取数字 id。
+ *
+ * @param change - 变更事件，优先取 `change.id`，缺失时回退到 `change.patch.id`
+ * @returns 正整数 id，无法提取时返回 null
+ */
+export declare const getRxDBChangeEventId: (change: {
+    id: unknown;
+    patch?: unknown;
+}) => number | null;
+/**
+ * 取一组变更里最早的 `recordAt` 时间。
+ *
+ * @param changes - 变更数组
+ * @returns 最早的有效 `recordAt`，没有有效记录时返回 null
+ */
+export declare const getEarliestRecordAt: (changes: readonly {
+    recordAt?: unknown;
+}[]) => Date | null;
+//# sourceMappingURL=version-manager.utils.d.ts.map

package/dist/version-manager.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version-manager.utils.d.ts","sourceRoot":"","sources":["../src/version-manager.utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,GAAI,QAAQ;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,KAAG,MAAM,GAAG,IAKxF,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,GAAI,SAAS,SAAS;IAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAE,EAAE,KAAG,IAAI,GAAG,IASvF,CAAC"}

package/package.json

@@ -1,6 +1,60 @@
 {
   "name": "@aiao/rxdb-plugin-history",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.0.26",
+  "description": "History, undo/redo and branch management for Aiao RxDB.",
+  "homepage": "https://rxdb.netlify.app/docs/plugins",
+  "bugs": {
+    "url": "https://github.com/aiao-io/rxdb/issues"
+  },
+  "keywords": [
+    "aiao",
+    "rxdb",
+    "history",
+    "undo",
+    "redo",
+    "branch",
+    "offline-first",
+    "typescript"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/aiao-io/rxdb.git",
+    "directory": "packages/rxdb-plugin-history"
+  },
+  "type": "module",
+  "sideEffects": false,
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    "./package.json": "./package.json",
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src",
+    "!src/**/*.spec.*",
+    "!src/**/*.test.*",
+    "!src/**/__tests__/**",
+    "!**/*.tsbuildinfo"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "nx": {
+    "name": "rxdb-plugin-history",
+    "tags": [
+      "js-lib"
+    ]
+  },
+  "dependencies": {
+    "rxjs": "^7.8.2",
+    "@aiao/rxdb": "0.0.26",
+    "@aiao/utils": "0.0.26"
+  }
 }