@aiao/rxdb 0.0.6 → 0.0.8

package/dist/version/VersionManager.interface.d.ts

@@ -0,0 +1,428 @@
+import { Observable } from 'rxjs';
+import { EntityType, UUID } from '../entity/entity.interface.js';
+import { RxDBChange } from '../system/change.js';
+import { ConflictResolver } from './conflict.js';
+/**
+ * Pull 操作结果
+ */
+export interface PullResult {
+    /**
+     * 从远程拉取的变更数量（压缩前）
+     */
+    pulled: number;
+    /**
+     * 被压缩/丢弃的变更数量
+     * 例如：INSERT → DELETE 的变更会被丢弃
+     */
+    compacted: number;
+    /**
+     * 成功应用到本地的变更数量（压缩后）
+     */
+    applied: number;
+    /**
+     * 是否还有更多数据需要拉取
+     */
+    hasMore: boolean;
+}
+/**
+ * Push 操作结果
+ */
+export interface PushResult {
+    /**
+     * 成功推送到远程的变更数量（压缩后）
+     */
+    pushed: number;
+    /**
+     * 推送失败的变更数量
+     */
+    failed: number;
+    /**
+     * 被压缩/丢弃的变更数量
+     * 例如：INSERT → DELETE 的变更会被丢弃
+     */
+    compacted: number;
+    /**
+     * 压缩前的原始变更数量
+     * originalCount = pushed + failed + compacted
+     */
+    originalCount: number;
+}
+/**
+ * Sync 操作结果（pull + push 组合）
+ */
+export interface SyncResult {
+    /**
+     * Pull 操作结果
+     */
+    pullResult: PullResult;
+    /**
+     * Push 操作结果
+     */
+    pushResult: PushResult;
+}
+/**
+ * Pull 操作选项
+ */
+export interface PullOptions {
+    /**
+     * 单次拉取的最大数量
+     * @default 1000
+     */
+    limit?: number;
+    /**
+     * 是否自动处理分页，拉取所有数据
+     * @default false
+     */
+    fetchAll?: boolean;
+    /**
+     * 可选的实体过滤列表（用于 repository-level sync）
+     * 只拉取指定实体的变更
+     * @example ['Todo', 'User']
+     * @example [{ namespace: 'public', entity: 'Todo' }]
+     */
+    repositoryFilter?: (string | RepositoryIdentifier)[];
+}
+/**
+ * Check repository updates result
+ *
+ * 检查远程仓库更新的结果，用于实现 "有 N 条更新可拉取" 功能
+ */
+export interface CheckRepositoryUpdatesResult {
+    /**
+     * 是否有更新可拉取
+     */
+    hasUpdates: boolean;
+    /**
+     * 远程可用的更新数量
+     * 仅在 hasUpdates=true 时有意义
+     */
+    updateCount: number;
+    /**
+     * 远程最新的 changeId
+     * 如果远程没有任何变更记录，则为 0
+     */
+    latestChangeId: number;
+    /**
+     * 本地最后一次拉取的 changeId
+     * 如果本地从未拉取过，则为 0
+     */
+    lastPulledChangeId: number;
+}
+/**
+ * Push 操作选项
+ */
+export interface PushOptions {
+    /**
+     * 单次推送的最大数量
+     * @default 1000
+     */
+    batchSize?: number;
+    /**
+     * 可选的实体过滤列表（用于 repository-level sync）
+     * 只推送指定实体的变更
+     * @example ['Todo', 'User']
+     * @example [{ namespace: 'public', entity: 'Todo' }]
+     */
+    repositoryFilter?: (string | RepositoryIdentifier)[];
+}
+/**
+ * 远程同步配置选项
+ */
+export interface RemoteSyncOptions {
+    /**
+     * 自动同步开关
+     *
+     * - `true`（默认）: 收到远程变更时立即应用到本地实体表
+     * - `false`: 缓存变更，等待用户调用 pull() 时批量应用
+     *
+     * @default true
+     */
+    autoSync?: boolean;
+    /**
+     * 冲突解决器
+     *
+     * 当 pull 时检测到本地未同步变更与远程变更冲突时调用
+     *
+     * @default new LWWConflictResolver()
+     */
+    conflictResolver?: ConflictResolver;
+}
+/**
+ * 历史记录作用域类型
+ */
+export type HistoryScopeType = 'database' | 'repository' | 'entity';
+/**
+ * 历史记录作用域配置
+ */
+export type HistoryScope = {
+    type: 'database';
+} | {
+    type: 'repository';
+    namespace: string;
+    entity: string;
+} | {
+    type: 'entity';
+    namespace: string;
+    entity: string;
+    entityId: string;
+};
+/**
+ * 历史记录作用域 API
+ * 所有作用域返回统一的接口，消除特殊情况
+ */
+export interface HistoryScopeAPI {
+    type: HistoryScopeType;
+    /** 历史记录流 */
+    histories$: Observable<HistoryItem[]>;
+    /** 可撤销的历史记录流 */
+    undoHistories$: Observable<HistoryItem[]>;
+    /** 可重做的历史记录流 */
+    redoHistories$: Observable<HistoryItem[]>;
+    /** 历史记录总数 */
+    count$: Observable<number>;
+    /** 可撤销数量 */
+    undoCount$: Observable<number>;
+    /** 可重做数量 */
+    redoCount$: Observable<number>;
+    /** 撤销操作 */
+    undo(step?: number): Promise<void>;
+    /** 重做操作 */
+    redo(step?: number): Promise<void>;
+}
+/**
+ * 历史记录项
+ * 表示一个可撤销/重做的操作单元
+ */
+export interface HistoryItem {
+    changeId: number;
+    /**
+     * 唯一指纹，用于标识该历史项
+     */
+    fingerprint: string;
+    /**
+     * 命名空间
+     */
+    namespace: string;
+    /**
+     * 实体名称
+     */
+    entity: string;
+    /**
+     * 操作类型
+     */
+    type: 'INSERT' | 'UPDATE' | 'DELETE' | 'TRANSACTION';
+    /**
+     * 描述信息（用于 UI 展示）
+     *
+     * @example
+     * - 单条变更：「创建 User」「更新 Todo」「删除 Post」
+     * - 多条变更：「事务: 创建2条, 更新3条」
+     */
+    description: string;
+    /**
+     * 事务ID
+     */
+    transactionId: UUID | null;
+    /**
+     * 该历史项包含的所有变更
+     */
+    changes: RxDBChange[];
+    /**
+     * 变更数量
+     */
+    count: number;
+    /**
+     * 最新变更的时间戳
+     */
+    createdAt: Date;
+    /**
+     * 是否已撤销
+     * true 表示该历史项已被撤销（任意一个 change 被撤销即为 true）
+     */
+    reverted: boolean;
+    /**
+     * Redo 是否失效
+     * true 表示该历史项的 redo 操作已被废弃（任意一个 change 被废弃即为 true）
+     */
+    redoInvalidated: boolean;
+}
+export type EntityData = Record<string, any> | any;
+export interface SwitchVersionChange<T extends EntityType = EntityType> {
+    patch: Partial<InstanceType<T>> | null;
+    inversePatch: Partial<InstanceType<T>> | null;
+}
+/**
+ * 切换分支版本需要的操作
+ */
+export interface SwitchVersionActions<T extends EntityType = EntityType> {
+    /**
+     * 需要删除的实体键集合 key
+     * key 格式：`${namespace}:${entityName}:${entityId}`
+     */
+    deletes: Map<string, SwitchVersionChange<T>>;
+    /**
+     * 需要更新的实体键集合 key
+     * key 格式：`${namespace}:${entityName}:${entityId}`
+     */
+    updates: Map<string, SwitchVersionChange<T>>;
+    /**
+     * 需要插入的实体键集合 key
+     * key 格式：`${namespace}:${entityName}:${entityId}`
+     */
+    inserts: Map<string, SwitchVersionChange<T>>;
+    /**
+     * 更新 RxDBChange 序列号
+     * local only, 不会同步到远程
+     */
+    updateRxDBChangeSequence?: number;
+}
+/**
+ * Repository identifier
+ * Uniquely identifies an entity type
+ */
+export interface RepositoryIdentifier {
+    /**
+     * Entity namespace
+     * @example "public"
+     */
+    namespace: string;
+    /**
+     * Entity name
+     * @example "Todo"
+     */
+    entity: string;
+}
+/**
+ * Pull repository options
+ */
+export interface PullRepositoryOptions {
+    /**
+     * Maximum number of changes to fetch per request
+     * @default 1000
+     */
+    limit?: number;
+    /**
+     * Whether to fetch all changes in multiple requests
+     * @default false
+     */
+    fetchAll?: boolean;
+    /**
+     * Whether to include related entities (cascade sync)
+     *
+     * When true:
+     * - Automatically pulls all parent entities (foreign key references)
+     * - Follows topological order: parent -> child
+     * - Example: Pulling Post automatically pulls User
+     *
+     * When false:
+     * - Only syncs the specified repository
+     * - May cause foreign key constraint errors if parent entities not synced
+     *
+     * @default true
+     */
+    includeRelated?: boolean;
+}
+/**
+ * Push repository options
+ */
+export interface PushRepositoryOptions {
+    /**
+     * Maximum number of changes to push per batch
+     * @default 1000
+     */
+    batchSize?: number;
+    /**
+     * Whether to include related entities (cascade sync)
+     *
+     * When true:
+     * - Automatically pushes all child entities (entities referencing current entity)
+     * - Follows reverse topological order: child -> parent
+     * - Example: Pushing User automatically pushes Post
+     *
+     * When false:
+     * - Only syncs the specified repository
+     * - May cause incomplete remote data
+     *
+     * @default true
+     */
+    includeRelated?: boolean;
+}
+/**
+ * Sync repository options
+ */
+export interface SyncRepositoryOptions {
+    pull?: PullRepositoryOptions;
+    push?: PushRepositoryOptions;
+}
+/**
+ * Pull repository result
+ */
+export interface PullRepositoryResult {
+    /**
+     * Repository identifier
+     */
+    repository: RepositoryIdentifier;
+    /**
+     * Number of changes pulled from remote (before compaction)
+     */
+    pulled: number;
+    /**
+     * Number of changes compacted/discarded
+     */
+    compacted: number;
+    /**
+     * Number of changes successfully applied to local (after compaction)
+     */
+    applied: number;
+    /**
+     * Whether there are more changes to pull
+     */
+    hasMore: boolean;
+    /**
+     * Results of related repositories (when includeRelated=true)
+     */
+    relatedResults?: PullRepositoryResult[];
+}
+/**
+ * Push repository result
+ */
+export interface PushRepositoryResult {
+    /**
+     * Repository identifier
+     */
+    repository: RepositoryIdentifier;
+    /**
+     * Number of changes successfully pushed to remote (after compaction)
+     */
+    pushed: number;
+    /**
+     * Number of changes that failed to push
+     */
+    failed: number;
+    /**
+     * Number of changes compacted/discarded
+     */
+    compacted: number;
+    /**
+     * Original number of unpushed changes (before compaction)
+     */
+    originalCount: number;
+    /**
+     * Results of related repositories (when includeRelated=true)
+     */
+    relatedResults?: PushRepositoryResult[];
+}
+/**
+ * Sync repository result
+ */
+export interface SyncRepositoryResult {
+    /**
+     * Pull result
+     */
+    pullResult: PullRepositoryResult;
+    /**
+     * Push result
+     */
+    pushResult: PushRepositoryResult;
+}
+//# sourceMappingURL=VersionManager.interface.d.ts.map

package/dist/version/VersionManager.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"VersionManager.interface.d.ts","sourceRoot":"","sources":["../../src/version/VersionManager.interface.ts"],"names":[],"mappings":"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"}

package/dist/version/VersionManager.utils.d.ts

@@ -0,0 +1,14 @@
+import { IRxDBChange } from '../system/system.interface.js';
+/**
+ * 构造业务实体的唯一键（用于 deletes/updates/inserts Map）
+ * @param change - RxDBChange 实例
+ * @returns 格式: "namespace:entity:entityId"
+ */
+export declare const getRxDBChangeKey: <T extends IRxDBChange>(change: T) => string;
+/**
+ * 解析实体键
+ * @param entityKey - 实体键字符串
+ * @returns [namespace, entity, entityId]
+ */
+export declare const parseRxDBChangeKey: (entityKey: string) => [string, string, string];
+//# sourceMappingURL=VersionManager.utils.d.ts.map

package/dist/version/VersionManager.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"VersionManager.utils.d.ts","sourceRoot":"","sources":["../../src/version/VersionManager.utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAE5D;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,GAAI,CAAC,SAAS,WAAW,EAAE,QAAQ,CAAC,WACN,CAAC;AAE5D;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,GAAI,WAAW,MAAM,KAA6B,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC"}

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

@@ -0,0 +1,97 @@
+import { RxDB } from '../RxDB.js';
+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;
+}
+/**
+ * 对多个仓库执行批量同步
+ *
+ * 支持顺序和并发两种执行模式。
+ * 在顺序模式下，仓库将被逐个同步。
+ * 在并发模式下，可以同时并发同步多个仓库。
+ *
+ * @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/version/bulk-sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bulk-sync.d.ts","sourceRoot":"","sources":["../../src/version/bulk-sync.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAEvC,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAClE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAClE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAClE,OAAO,EAA8C,KAAK,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAG7G;;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;AAsJD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAsB,QAAQ,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,GAAE,eAAoB,GAAG,OAAO,CAAC,cAAc,CAAC,CAyCjG"}

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

@@ -0,0 +1,53 @@
+import { RxDB } from '../RxDB.js';
+/**
+ * Repository 标识符
+ */
+export interface RepositoryIdentifier {
+    namespace: string;
+    entity: string;
+}
+/**
+ * Check Repository Updates Result
+ */
+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/version/check-repository-updates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"check-repository-updates.d.ts","sourceRoot":"","sources":["../../src/version/check-repository-updates.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAIvC;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;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,CAkEvC"}

package/dist/version/compact-changes.d.ts

@@ -0,0 +1,45 @@
+import { IRxDBChange } from '../system/system.interface.js';
+import { SwitchVersionActions } from './VersionManager.interface.js';
+/**
+ * 压缩变更列表为 SwitchVersionActions（专用于 Push 场景）
+ *
+ * 使用状态机逻辑处理变更压缩，针对 Push 场景特化：
+ * - 本地新建后删除的数据（INSERT → DELETE 且 inversePatch 为 null）不需要 push
+ * - 远程已有数据的删除（inversePatch 不为 null）必须 push DELETE
+ *
+ * @param changes - 原始变更列表（会自动按 id 排序）
+ * @returns 压缩后的操作集合
+ *
+ * @example
+ * ```typescript
+ * // 场景1：本地新建后删除（不需要 push）
+ * const changes1 = [
+ *   { type: 'INSERT', entityId: '1', patch: { name: 'Alice' }, inversePatch: null },
+ *   { type: 'DELETE', entityId: '1', patch: null, inversePatch: null }
+ * ];
+ * const actions1 = compactChanges(changes1);
+ * // actions1.deletes.size === 0（本地数据，服务器从未见过，不需要通知删除）
+ *
+ * // 场景2：远程数据被删除（必须 push DELETE）
+ * const changes2 = [
+ *   { type: 'UPDATE', entityId: '1', patch: { name: 'Bob' }, inversePatch: { name: 'Alice' } },
+ *   { type: 'DELETE', entityId: '1', patch: null, inversePatch: { name: 'Bob' } }
+ * ];
+ * const actions2 = compactChanges(changes2);
+ * // actions2.deletes.size === 1（服务器有这条数据，必须通知删除）
+ * ```
+ *
+ * @remarks
+ * **压缩规则（Push 专用）**：
+ * - `INSERT → DELETE` + `inversePatch === null` → 抵消（本地新建，服务器从未见过）
+ * - `INSERT → DELETE` + `inversePatch !== null` → 保留 DELETE（服务器已有旧数据）
+ * - `INSERT → UPDATE*` → 合并为 INSERT（一次性插入最终状态）
+ * - `UPDATE → UPDATE*` → 合并为 UPDATE（合并所有 patch）
+ * - `UPDATE → DELETE` → 保留 DELETE（服务器必须知道数据被删除）
+ *
+ * **与 `get_switch_version_actions` 的区别**：
+ * - `get_switch_version_actions`：分支切换场景，`INSERT → DELETE` 完全抵消
+ * - `compactChanges`：Push 场景，基于 `inversePatch` 判断是否需要通知服务器
+ */
+export declare function compactChanges<T extends IRxDBChange>(changes: T[], actions?: SwitchVersionActions): SwitchVersionActions;
+//# sourceMappingURL=compact-changes.d.ts.map

package/dist/version/compact-changes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compact-changes.d.ts","sourceRoot":"","sources":["../../src/version/compact-changes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAC5D,OAAO,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AAGrE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AACH,wBAAgB,cAAc,CAAC,CAAC,SAAS,WAAW,EAClD,OAAO,EAAE,CAAC,EAAE,EACZ,OAAO,GAAE,oBAIR,GACA,oBAAoB,CAmFtB"}