@itwin/core-frontend 5.9.0-dev.1 → 5.9.0-dev.10

package/CHANGELOG.md

@@ -1,6 +1,34 @@
 # Change Log - @itwin/core-frontend
 
-This log was last generated on Tue, 24 Mar 2026 14:30:44 GMT and should not be manually modified.
+This log was last generated on Thu, 16 Apr 2026 11:06:21 GMT and should not be manually modified.
+
+## 5.8.2
+Thu, 16 Apr 2026 11:05:01 GMT
+
+_Version update only_
+
+## 5.8.1
+Fri, 10 Apr 2026 13:02:00 GMT
+
+_Version update only_
+
+## 5.8.0
+Thu, 02 Apr 2026 18:19:33 GMT
+
+### Minor changes
+
+- Add support for the proposed BENTLEY_materials_line_style glTF extension, including line width and custom line-pattern rendering for glTF line primitives.
+
+### Updates
+
+- Fix default KOQ -> QuantityType map value for CivilUnits.LENGTH
+- Support geometry collection for reality meshes with glTF tiles
+- Fix reality data not being reprojected correctly when its CRS is different than iModel
+- New LockService interface and new BriefcaseConnection.locks property
+- Update measure tool to fallback to QuantityType
+- Fix crash when QuantityFormatter.setUnitsProvider is called after IModelApp shutdown — ToolAdmin no longer emits activeToolChanged with an undefined tool.
+- Revert metric LengthEngineering default format back to meters (meter4) from millimeters (millimeter3).
+- Add support for WMTS sparse tilesets
 
 ## 5.7.3
 Tue, 24 Mar 2026 14:29:17 GMT

package/lib/cjs/BriefcaseConnection.d.ts

@@ -144,9 +144,12 @@ export declare class BriefcaseConnection extends IModelConnection {
     hasPendingTxns(): Promise<boolean>;
     /** Commit pending changes to this briefcase.
      * @param description Optional description of the changes.
+     * @deprecated Use methods on EditCommand instead.
      */
     saveChanges(description?: string): Promise<void>;
-    /** Abandon pending changes to this briefcase. */
+    /** Abandon pending changes to this briefcase.
+     * @deprecated Use methods on EditCommand instead.
+     */
     abandonChanges(): Promise<void>;
     /** Pull (and potentially merge if there are local changes) up to a specified changeset from iModelHub into this briefcase
      * @param toIndex The changeset index to pull changes to. If `undefined`, pull all changes.

package/lib/cjs/BriefcaseConnection.d.ts.map

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

package/lib/cjs/BriefcaseConnection.js

@@ -248,13 +248,16 @@ class BriefcaseConnection extends IModelConnection_1.IModelConnection {
     }
     /** Commit pending changes to this briefcase.
      * @param description Optional description of the changes.
+     * @deprecated Use methods on EditCommand instead.
      */
     async saveChanges(description) {
-        await IpcApp_1.IpcApp.appFunctionIpc.saveChanges(this.key, description);
+        await IpcApp_1.IpcApp.appFunctionIpc.saveChanges(this.key, description); // eslint-disable-line @typescript-eslint/no-deprecated
     }
-    /** Abandon pending changes to this briefcase. */
+    /** Abandon pending changes to this briefcase.
+     * @deprecated Use methods on EditCommand instead.
+     */
     async abandonChanges() {
-        await IpcApp_1.IpcApp.appFunctionIpc.abandonChanges(this.key);
+        await IpcApp_1.IpcApp.appFunctionIpc.abandonChanges(this.key); // eslint-disable-line @typescript-eslint/no-deprecated
     }
     /** Pull (and potentially merge if there are local changes) up to a specified changeset from iModelHub into this briefcase
      * @param toIndex The changeset index to pull changes to. If `undefined`, pull all changes.

package/lib/cjs/BriefcaseConnection.js.map

@@ -1 +1 @@
-{"version":3,"file":"BriefcaseConnection.js","sourceRoot":"","sources":["../../src/BriefcaseConnection.ts"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n* See LICENSE.md in the project root for license terms and full copyright notice.\n*--------------------------------------------------------------------------------------------*/\n/** @packageDocumentation\n * @module IModelConnection\n */\n\nimport { assert, BeEvent, CompressedId64Set, Guid, GuidString, Id64Set, Id64String, IModelStatus, OpenMode } from \"@itwin/core-bentley\";\nimport {\n  BriefcaseConnectionProps, ChangesetIndex, ChangesetIndexAndId, getPullChangesIpcChannel, IModelError,\n  PullChangesOptions as IpcAppPullChangesOptions, LockState, OpenBriefcaseProps, StandaloneOpenOptions,\n} from \"@itwin/core-common\";\nimport { BriefcaseTxns } from \"./BriefcaseTxns\";\nimport { GraphicalEditingScope } from \"./GraphicalEditingScope\";\nimport { IModelApp } from \"./IModelApp\";\nimport { IModelConnection } from \"./IModelConnection\";\nimport { IpcApp } from \"./IpcApp\";\nimport { disposeTileTreesForGeometricModels } from \"./tile/internal\";\nimport { Viewport } from \"./Viewport\";\n\n/**\n * Download progress information.\n * @public\n */\nexport interface DownloadProgressInfo {\n  /** Bytes downloaded. */\n  loaded: number;\n  /** Total size of the download in bytes. */\n  total: number;\n}\n\n/**\n * Called to show progress during a download.\n * @public\n */\nexport type OnDownloadProgress = (progress: DownloadProgressInfo) => void;\n\n/**\n * Partial interface of AbortSignal.\n * @see https://developer.mozilla.org/en-US/docs/Web/API/AbortSignal\n * @beta\n */\nexport interface GenericAbortSignal {\n  /** Add Listener for abort signal. */\n  addEventListener: (type: \"abort\", listener: (this: GenericAbortSignal, ev: any) => any) => void;\n  /** Remove Listener for abort signal. */\n  removeEventListener: (type: \"abort\", listener: (this: GenericAbortSignal, ev: any) => any) => void;\n}\n\n/**\n * Options for pulling iModel changes.\n * @public\n */\nexport interface PullChangesOptions {\n  /** Function called regularly to report progress of changes download. */\n  downloadProgressCallback?: OnDownloadProgress;\n  /** Interval for calling progress callback (in milliseconds). */\n  progressInterval?: number;\n  /** Signal for cancelling the download.\n   * @beta\n   */\n  abortSignal?: GenericAbortSignal;\n}\n\n/** Keeps track of changes to models, buffering them until synchronization points.\n * While a GraphicalEditingScope is open, the changes are buffered until the scope exits, at which point they are processed.\n * Otherwise, the buffered changes are processed after undo/redo, commit, or pull+merge changes.\n */\nclass ModelChangeMonitor {\n  private _editingScope?: GraphicalEditingScope;\n  private readonly _briefcase: BriefcaseConnection;\n  private readonly _deletedModels = new Set<string>();\n  private readonly _modelIdToGuid = new Map<string, string>();\n  private readonly _removals: VoidFunction[] = [];\n\n  public constructor(briefcase: BriefcaseConnection) {\n    this._briefcase = briefcase;\n\n    // Buffer updated geometry guids.\n    this._removals.push(briefcase.txns.onModelGeometryChanged.addListener((changes) => {\n      for (const change of changes) {\n        this._deletedModels.delete(change.id);\n        this._modelIdToGuid.set(change.id, change.guid);\n      }\n    }));\n\n    // Buffer deletions of models.\n    this._removals.push(briefcase.txns.onModelsChanged.addListener((changes) => {\n      if (changes.deleted) {\n        for (const id of CompressedId64Set.iterable(changes.deleted)) {\n          this._modelIdToGuid.delete(id);\n          this._deletedModels.add(id);\n        }\n      }\n    }));\n\n    // Outside of an editing scope, we want to update viewport contents after commit, undo/redo, or merging changes.\n    const maybeProcess = async () => {\n      if (this.editingScope)\n        return;\n\n      const modelIds = Array.from(this._modelIdToGuid.keys());\n      if (modelIds.length > 0)\n        await IModelApp.tileAdmin.purgeTileTrees(this._briefcase, modelIds);\n\n      this.processBuffered();\n    };\n\n    this._removals.push(briefcase.txns.onCommitted.addListener(maybeProcess));\n    this._removals.push(briefcase.txns.onReplayedExternalTxns.addListener(maybeProcess));\n    this._removals.push(briefcase.txns.onAfterUndoRedo.addListener(maybeProcess));\n    this._removals.push(briefcase.txns.onChangesPulled.addListener(maybeProcess));\n  }\n\n  public async close(): Promise<void> {\n    for (const removal of this._removals)\n      removal();\n\n    this._removals.length = 0;\n\n    if (this._editingScope) {\n      await this._editingScope.exit();\n      this._editingScope = undefined;\n    }\n  }\n\n  public get editingScope(): GraphicalEditingScope | undefined {\n    return this._editingScope;\n  }\n\n  public async enterEditingScope(): Promise<GraphicalEditingScope> {\n    if (this._editingScope)\n      throw new Error(\"Cannot create an editing scope for an iModel that already has one\");\n\n    this._editingScope = await GraphicalEditingScope.enter(this._briefcase);\n\n    const removeGeomListener = this._editingScope.onGeometryChanges.addListener((changes) => {\n      const modelIds = [];\n      for (const change of changes)\n        modelIds.push(change.id);\n\n      this.invalidateScenes(modelIds);\n    });\n\n    this._editingScope.onExited.addOnce((scope) => {\n      assert(scope === this._editingScope);\n      this._editingScope = undefined;\n      removeGeomListener();\n      this.processBuffered();\n    });\n\n    return this._editingScope;\n  }\n\n  private processBuffered(): void {\n    const models = this._briefcase.models;\n    for (const [id, guid] of this._modelIdToGuid) {\n      const model = models.getLoaded(id)?.asGeometricModel;\n      if (model)\n        model.geometryGuid = guid;\n    }\n\n    const modelIds = new Set<string>(this._modelIdToGuid.keys());\n    for (const deleted of this._deletedModels) {\n      modelIds.add(deleted);\n      models.unload(deleted);\n    }\n\n    this.invalidateScenes(modelIds);\n    disposeTileTreesForGeometricModels(modelIds, this._briefcase);\n\n    this._briefcase.onBufferedModelChanges.raiseEvent(modelIds);\n\n    this._modelIdToGuid.clear();\n    this._deletedModels.clear();\n  }\n\n  private invalidateScenes(changedModels: Iterable<Id64String>): void {\n    for (const user of IModelApp.tileAdmin.tileUsers) {\n      if (user instanceof Viewport && user.iModel === this._briefcase) {\n        for (const modelId of changedModels) {\n          if (user.view.viewsModel(modelId)) {\n            user.invalidateScene();\n            user.setFeatureOverrideProviderChanged();\n            break;\n          }\n        }\n      }\n    }\n  }\n}\n\n/**\n * Provides access to lock information in the iModel.\n * @see [[BriefcaseConnection.locks]]\n * @alpha\n */\nexport interface LockService {\n  /** Get all elements with exclusive locks owned by other briefcases. */\n  getExclusiveForeignLocks(): Promise<Id64Set>;\n  /** Get all elements with shared locks owned by other briefcases. */\n  getSharedForeignLocks(): Promise<Id64Set>;\n  /** Check whether it's possible to acquire a lock for the element. */\n  checkElementLockAvailability(elementId: Id64String, lock: LockState): Promise<boolean>;\n}\n\n/** Function for creating a [[LockService]] for a [[BriefcaseConnection]].\n * @alpha\n */\nexport type LockServiceFactory = (iModel: BriefcaseConnection) => Promise<LockService>;\n\n/** Settings that can be used to control the behavior of [[Tool]]s that modify a [[BriefcaseConnection]].\n * For example, tools that want to create new elements can consult the briefcase's editor tool settings to\n * determine into which model and category to insert the elements.\n * Specialized tools are free to ignore these settings.\n * @see [[BriefcaseConnection.editorToolSettings]] to query or modify the current settings for a briefcase.\n * @see [CreateElementTool]($editor-frontend) for an example of a tool that uses these settings.\n * @beta\n */\nexport class BriefcaseEditorToolSettings {\n  private _category?: Id64String;\n  private _model?: Id64String;\n\n  /** An event raised just after the default [[category]] is changed. */\n  public readonly onCategoryChanged = new BeEvent<(previousCategory: Id64String | undefined) => void>();\n\n  /** An event raised just after the default [[model]] is changed. */\n  public readonly onModelChanged = new BeEvent<(previousModel: Id64String | undefined) => void>();\n\n  /** The [Category]($backend) into which new elements should be inserted by default.\n   * Specialized tools are free to ignore this setting and instead use their own logic to select an appropriate category.\n   * @see [[onCategoryChanged]] to be notified when this property is modified.\n   * @see [CreateElementTool.targetCategory]($editor-frontend) for an example of a tool that uses this setting.\n   */\n  public get category(): Id64String | undefined {\n    return this._category;\n  }\n  public set category(category: Id64String | undefined) {\n    const previousCategory = this.category;\n    if (category !== this.category) {\n      this._category = category;\n      this.onCategoryChanged.raiseEvent(previousCategory);\n    }\n  }\n\n  /** The [Model]($backend) into which new elements should be inserted by default.\n   * Specialized tools are free to ignore this setting and instead use their own logic to select an appropriate model.\n   * @see [[onModelChanged]] to be notified when this property is modified.\n   * @see [CreateElementTool.targetModelId]($editor-frontend) for an example of a tool that uses this setting.\n   */\n  public get model(): Id64String | undefined {\n    return this._model;\n  }\n  public set model(model: Id64String | undefined) {\n    const previousModel = this.model;\n    if (model !== this.model) {\n      this._model = model;\n      this.onModelChanged.raiseEvent(previousModel);\n    }\n  }\n}\n\n/** A connection to an editable briefcase on the backend. This class uses [Ipc]($docs/learning/IpcInterface.md) to communicate\n * to the backend and may only be used by [[IpcApp]]s.\n * @public\n */\nexport class BriefcaseConnection extends IModelConnection {\n  protected _isClosed?: boolean;\n  private readonly _modelsMonitor: ModelChangeMonitor;\n  private _locks?: LockService;\n\n  /** The ID of the briefcase.\n   * @beta\n   */\n  public readonly briefcaseId?: number;\n\n  /** Default settings that can be used to control the behavior of [[Tool]]s that modify this briefcase.\n   * @beta\n   */\n  public readonly editorToolSettings = new BriefcaseEditorToolSettings();\n\n  /** Manages local changes to the briefcase via [Txns]($docs/learning/InteractiveEditing.md). */\n  public readonly txns: BriefcaseTxns;\n\n  /** Information about locks held on this iModel.\n   * @note This is intended to be used by tools and other UI elements, to provide information about the current lock state. Implementations are expected to cache lock information and so may not reflect changes to locks immediately.\n   * @alpha\n   */\n  public get locks(): LockService | undefined { return this._locks; }\n\n  public override isBriefcaseConnection(): this is BriefcaseConnection { return true; }\n\n  /** The Guid that identifies the iTwin that owns this iModel. */\n  public override get iTwinId(): GuidString { return super.iTwinId ?? Guid.empty; } // GuidString | undefined for IModelConnection, but required for BriefcaseConnection\n\n  /** The Guid that identifies this iModel. */\n  public override get iModelId(): GuidString { return super.iModelId ?? Guid.empty; } // GuidString | undefined for IModelConnection, but required for BriefcaseConnection\n\n  protected constructor(props: BriefcaseConnectionProps, openMode: OpenMode) {\n    super(props);\n    this._openMode = openMode;\n    this.briefcaseId = props.briefcaseId;\n    this.txns = new BriefcaseTxns(this);\n    this._modelsMonitor = new ModelChangeMonitor(this);\n    if (OpenMode.ReadWrite === this._openMode)\n      this.txns.onAfterUndoRedo.addListener(async () => { await IModelApp.toolAdmin.restartPrimitiveTool(); });\n\n    this.categories.cache.attachToBriefcase(this);\n  }\n\n  /** Open a BriefcaseConnection to a [BriefcaseDb]($backend). */\n  public static async openFile(briefcaseProps: OpenBriefcaseProps): Promise<BriefcaseConnection>;\n\n  /** Open a BriefcaseConnection to a [BriefcaseDb]($backend).\n   * @alpha\n   */\n  public static async openFile(briefcaseProps: OpenBriefcaseProps, lockServiceFactory?: LockServiceFactory): Promise<BriefcaseConnection>\n\n  public static async openFile(briefcaseProps: OpenBriefcaseProps, lockServiceFactory?: LockServiceFactory): Promise<BriefcaseConnection> {\n    const iModelProps = await IpcApp.appFunctionIpc.openBriefcase(briefcaseProps);\n    const connection = new this({ ...briefcaseProps, ...iModelProps }, briefcaseProps.readonly ? OpenMode.Readonly : OpenMode.ReadWrite);\n    if (lockServiceFactory)\n      connection._locks = await lockServiceFactory(connection);\n\n    IModelConnection.onOpen.raiseEvent(connection);\n    return connection;\n  }\n\n  /** Open a BriefcaseConnection to a [StandaloneDb]($backend)\n   * @note StandaloneDbs, by definition, may not push or pull changes. Attempting to do so will throw exceptions.\n   */\n  public static async openStandalone(filePath: string, openMode: OpenMode = OpenMode.ReadWrite, opts?: StandaloneOpenOptions): Promise<BriefcaseConnection> {\n    const openResponse = await IpcApp.appFunctionIpc.openStandalone(filePath, openMode, opts);\n    const connection = new this(openResponse, openMode);\n    IModelConnection.onOpen.raiseEvent(connection);\n    return connection;\n  }\n\n  /** Returns `true` if [[close]] has already been called. */\n  public get isClosed(): boolean { return this._isClosed === true; }\n\n  /**\n   * Close this BriefcaseConnection.\n   * @note make sure to call [[saveChanges]] before calling this method. Unsaved local changes are abandoned.\n   */\n  public async close(): Promise<void> {\n    if (this.isClosed)\n      return;\n\n    await this._modelsMonitor.close();\n\n    this.beforeClose();\n    this.txns[Symbol.dispose]();\n\n    this._isClosed = true;\n    await IpcApp.appFunctionIpc.closeIModel(this._fileKey);\n  }\n\n  protected requireTimeline() {\n    if (this.iTwinId === Guid.empty)\n      throw new IModelError(IModelStatus.WrongIModel, \"iModel has no timeline\");\n  }\n\n  /** Query if there are any pending Txns in this briefcase that are waiting to be pushed. */\n  public async hasPendingTxns(): Promise<boolean> { // eslint-disable-line @itwin/prefer-get\n    return this.txns.hasPendingTxns();\n  }\n\n  /** Commit pending changes to this briefcase.\n   * @param description Optional description of the changes.\n   */\n  public async saveChanges(description?: string): Promise<void> {\n    await IpcApp.appFunctionIpc.saveChanges(this.key, description);\n  }\n\n  /** Abandon pending changes to this briefcase. */\n  public async abandonChanges(): Promise<void> {\n    await IpcApp.appFunctionIpc.abandonChanges(this.key);\n  }\n\n  /** Pull (and potentially merge if there are local changes) up to a specified changeset from iModelHub into this briefcase\n   * @param toIndex The changeset index to pull changes to. If `undefined`, pull all changes.\n   * @param options Options for pulling changes.\n   * @see [[BriefcaseTxns.onChangesPulled]] for the event dispatched after changes are pulled.\n   */\n  public async pullChanges(toIndex?: ChangesetIndex, options?: PullChangesOptions): Promise<void> {\n    const removeListeners: VoidFunction[] = [];\n    const shouldReportProgress = !!options?.downloadProgressCallback;\n\n    if (shouldReportProgress) {\n      const handleProgress = (_evt: Event, data: { loaded: number, total: number }) => {\n        options?.downloadProgressCallback?.(data);\n      };\n\n      const removeProgressListener = IpcApp.addListener(\n        getPullChangesIpcChannel(this.iModelId),\n        handleProgress,\n      );\n      removeListeners.push(removeProgressListener);\n    }\n\n    if (options?.abortSignal) {\n      const abort = () => void IpcApp.appFunctionIpc.cancelPullChangesRequest(this.key);\n      options?.abortSignal.addEventListener(\"abort\", abort);\n      removeListeners.push(() => options?.abortSignal?.removeEventListener(\"abort\", abort));\n    }\n\n    this.requireTimeline();\n    const ipcAppOptions: IpcAppPullChangesOptions = {\n      reportProgress: shouldReportProgress,\n      progressInterval: options?.progressInterval,\n      enableCancellation: !!options?.abortSignal,\n    };\n    try {\n      this.changeset = await IpcApp.appFunctionIpc.pullChanges(this.key, toIndex, ipcAppOptions);\n    } finally {\n      removeListeners.forEach((remove) => remove());\n    }\n  }\n\n  /** Create a changeset from local Txns and push to iModelHub. On success, clear Txn table.\n   * @param description The description for the changeset\n   * @returns the changesetId of the pushed changes\n   * @see [[BriefcaseTxns.onChangesPushed]] for the event dispatched after changes are pushed.\n   */\n  public async pushChanges(description: string): Promise<ChangesetIndexAndId> {\n    this.requireTimeline();\n    return IpcApp.appFunctionIpc.pushChanges(this.key, description);\n  }\n\n  /** The current graphical editing scope, if one is in progress.\n   * @see [[enterEditingScope]] to begin graphical editing.\n   */\n  public get editingScope(): GraphicalEditingScope | undefined {\n    return this._modelsMonitor.editingScope;\n  }\n\n  /** Return whether graphical editing is supported for this briefcase. It is not supported if the briefcase is read-only, or the briefcase contains a version of\n   * the BisCore ECSchema older than v0.1.11.\n   * @see [[enterEditingScope]] to enable graphical editing.\n   */\n  public async supportsGraphicalEditing(): Promise<boolean> {\n    return IpcApp.appFunctionIpc.isGraphicalEditingSupported(this.key);\n  }\n\n  /** Begin a new graphical editing scope.\n   * @throws Error if an editing scope already exists or one could not be created.\n   * @see [[GraphicalEditingScope.exit]] to exit the scope.\n   * @see [[supportsGraphicalEditing]] to determine whether this method should be expected to succeed.\n   * @see [[editingScope]] to obtain the current editing scope, if one is in progress.\n   */\n  public async enterEditingScope(): Promise<GraphicalEditingScope> {\n    return this._modelsMonitor.enterEditingScope();\n  }\n\n  /** Strictly for tests - dispatched from ModelChangeMonitor.processBuffered.\n   * @internal\n   */\n  public readonly onBufferedModelChanges = new BeEvent<(changedModelIds: Set<string>) => void>();\n}\n"]}
+{"version":3,"file":"BriefcaseConnection.js","sourceRoot":"","sources":["../../src/BriefcaseConnection.ts"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n* See LICENSE.md in the project root for license terms and full copyright notice.\n*--------------------------------------------------------------------------------------------*/\n/** @packageDocumentation\n * @module IModelConnection\n */\n\nimport { assert, BeEvent, CompressedId64Set, Guid, GuidString, Id64Set, Id64String, IModelStatus, OpenMode } from \"@itwin/core-bentley\";\nimport {\n  BriefcaseConnectionProps, ChangesetIndex, ChangesetIndexAndId, getPullChangesIpcChannel, IModelError,\n  PullChangesOptions as IpcAppPullChangesOptions, LockState, OpenBriefcaseProps, StandaloneOpenOptions,\n} from \"@itwin/core-common\";\nimport { BriefcaseTxns } from \"./BriefcaseTxns\";\nimport { GraphicalEditingScope } from \"./GraphicalEditingScope\";\nimport { IModelApp } from \"./IModelApp\";\nimport { IModelConnection } from \"./IModelConnection\";\nimport { IpcApp } from \"./IpcApp\";\nimport { disposeTileTreesForGeometricModels } from \"./tile/internal\";\nimport { Viewport } from \"./Viewport\";\n\n/**\n * Download progress information.\n * @public\n */\nexport interface DownloadProgressInfo {\n  /** Bytes downloaded. */\n  loaded: number;\n  /** Total size of the download in bytes. */\n  total: number;\n}\n\n/**\n * Called to show progress during a download.\n * @public\n */\nexport type OnDownloadProgress = (progress: DownloadProgressInfo) => void;\n\n/**\n * Partial interface of AbortSignal.\n * @see https://developer.mozilla.org/en-US/docs/Web/API/AbortSignal\n * @beta\n */\nexport interface GenericAbortSignal {\n  /** Add Listener for abort signal. */\n  addEventListener: (type: \"abort\", listener: (this: GenericAbortSignal, ev: any) => any) => void;\n  /** Remove Listener for abort signal. */\n  removeEventListener: (type: \"abort\", listener: (this: GenericAbortSignal, ev: any) => any) => void;\n}\n\n/**\n * Options for pulling iModel changes.\n * @public\n */\nexport interface PullChangesOptions {\n  /** Function called regularly to report progress of changes download. */\n  downloadProgressCallback?: OnDownloadProgress;\n  /** Interval for calling progress callback (in milliseconds). */\n  progressInterval?: number;\n  /** Signal for cancelling the download.\n   * @beta\n   */\n  abortSignal?: GenericAbortSignal;\n}\n\n/** Keeps track of changes to models, buffering them until synchronization points.\n * While a GraphicalEditingScope is open, the changes are buffered until the scope exits, at which point they are processed.\n * Otherwise, the buffered changes are processed after undo/redo, commit, or pull+merge changes.\n */\nclass ModelChangeMonitor {\n  private _editingScope?: GraphicalEditingScope;\n  private readonly _briefcase: BriefcaseConnection;\n  private readonly _deletedModels = new Set<string>();\n  private readonly _modelIdToGuid = new Map<string, string>();\n  private readonly _removals: VoidFunction[] = [];\n\n  public constructor(briefcase: BriefcaseConnection) {\n    this._briefcase = briefcase;\n\n    // Buffer updated geometry guids.\n    this._removals.push(briefcase.txns.onModelGeometryChanged.addListener((changes) => {\n      for (const change of changes) {\n        this._deletedModels.delete(change.id);\n        this._modelIdToGuid.set(change.id, change.guid);\n      }\n    }));\n\n    // Buffer deletions of models.\n    this._removals.push(briefcase.txns.onModelsChanged.addListener((changes) => {\n      if (changes.deleted) {\n        for (const id of CompressedId64Set.iterable(changes.deleted)) {\n          this._modelIdToGuid.delete(id);\n          this._deletedModels.add(id);\n        }\n      }\n    }));\n\n    // Outside of an editing scope, we want to update viewport contents after commit, undo/redo, or merging changes.\n    const maybeProcess = async () => {\n      if (this.editingScope)\n        return;\n\n      const modelIds = Array.from(this._modelIdToGuid.keys());\n      if (modelIds.length > 0)\n        await IModelApp.tileAdmin.purgeTileTrees(this._briefcase, modelIds);\n\n      this.processBuffered();\n    };\n\n    this._removals.push(briefcase.txns.onCommitted.addListener(maybeProcess));\n    this._removals.push(briefcase.txns.onReplayedExternalTxns.addListener(maybeProcess));\n    this._removals.push(briefcase.txns.onAfterUndoRedo.addListener(maybeProcess));\n    this._removals.push(briefcase.txns.onChangesPulled.addListener(maybeProcess));\n  }\n\n  public async close(): Promise<void> {\n    for (const removal of this._removals)\n      removal();\n\n    this._removals.length = 0;\n\n    if (this._editingScope) {\n      await this._editingScope.exit();\n      this._editingScope = undefined;\n    }\n  }\n\n  public get editingScope(): GraphicalEditingScope | undefined {\n    return this._editingScope;\n  }\n\n  public async enterEditingScope(): Promise<GraphicalEditingScope> {\n    if (this._editingScope)\n      throw new Error(\"Cannot create an editing scope for an iModel that already has one\");\n\n    this._editingScope = await GraphicalEditingScope.enter(this._briefcase);\n\n    const removeGeomListener = this._editingScope.onGeometryChanges.addListener((changes) => {\n      const modelIds = [];\n      for (const change of changes)\n        modelIds.push(change.id);\n\n      this.invalidateScenes(modelIds);\n    });\n\n    this._editingScope.onExited.addOnce((scope) => {\n      assert(scope === this._editingScope);\n      this._editingScope = undefined;\n      removeGeomListener();\n      this.processBuffered();\n    });\n\n    return this._editingScope;\n  }\n\n  private processBuffered(): void {\n    const models = this._briefcase.models;\n    for (const [id, guid] of this._modelIdToGuid) {\n      const model = models.getLoaded(id)?.asGeometricModel;\n      if (model)\n        model.geometryGuid = guid;\n    }\n\n    const modelIds = new Set<string>(this._modelIdToGuid.keys());\n    for (const deleted of this._deletedModels) {\n      modelIds.add(deleted);\n      models.unload(deleted);\n    }\n\n    this.invalidateScenes(modelIds);\n    disposeTileTreesForGeometricModels(modelIds, this._briefcase);\n\n    this._briefcase.onBufferedModelChanges.raiseEvent(modelIds);\n\n    this._modelIdToGuid.clear();\n    this._deletedModels.clear();\n  }\n\n  private invalidateScenes(changedModels: Iterable<Id64String>): void {\n    for (const user of IModelApp.tileAdmin.tileUsers) {\n      if (user instanceof Viewport && user.iModel === this._briefcase) {\n        for (const modelId of changedModels) {\n          if (user.view.viewsModel(modelId)) {\n            user.invalidateScene();\n            user.setFeatureOverrideProviderChanged();\n            break;\n          }\n        }\n      }\n    }\n  }\n}\n\n/**\n * Provides access to lock information in the iModel.\n * @see [[BriefcaseConnection.locks]]\n * @alpha\n */\nexport interface LockService {\n  /** Get all elements with exclusive locks owned by other briefcases. */\n  getExclusiveForeignLocks(): Promise<Id64Set>;\n  /** Get all elements with shared locks owned by other briefcases. */\n  getSharedForeignLocks(): Promise<Id64Set>;\n  /** Check whether it's possible to acquire a lock for the element. */\n  checkElementLockAvailability(elementId: Id64String, lock: LockState): Promise<boolean>;\n}\n\n/** Function for creating a [[LockService]] for a [[BriefcaseConnection]].\n * @alpha\n */\nexport type LockServiceFactory = (iModel: BriefcaseConnection) => Promise<LockService>;\n\n/** Settings that can be used to control the behavior of [[Tool]]s that modify a [[BriefcaseConnection]].\n * For example, tools that want to create new elements can consult the briefcase's editor tool settings to\n * determine into which model and category to insert the elements.\n * Specialized tools are free to ignore these settings.\n * @see [[BriefcaseConnection.editorToolSettings]] to query or modify the current settings for a briefcase.\n * @see [CreateElementTool]($editor-frontend) for an example of a tool that uses these settings.\n * @beta\n */\nexport class BriefcaseEditorToolSettings {\n  private _category?: Id64String;\n  private _model?: Id64String;\n\n  /** An event raised just after the default [[category]] is changed. */\n  public readonly onCategoryChanged = new BeEvent<(previousCategory: Id64String | undefined) => void>();\n\n  /** An event raised just after the default [[model]] is changed. */\n  public readonly onModelChanged = new BeEvent<(previousModel: Id64String | undefined) => void>();\n\n  /** The [Category]($backend) into which new elements should be inserted by default.\n   * Specialized tools are free to ignore this setting and instead use their own logic to select an appropriate category.\n   * @see [[onCategoryChanged]] to be notified when this property is modified.\n   * @see [CreateElementTool.targetCategory]($editor-frontend) for an example of a tool that uses this setting.\n   */\n  public get category(): Id64String | undefined {\n    return this._category;\n  }\n  public set category(category: Id64String | undefined) {\n    const previousCategory = this.category;\n    if (category !== this.category) {\n      this._category = category;\n      this.onCategoryChanged.raiseEvent(previousCategory);\n    }\n  }\n\n  /** The [Model]($backend) into which new elements should be inserted by default.\n   * Specialized tools are free to ignore this setting and instead use their own logic to select an appropriate model.\n   * @see [[onModelChanged]] to be notified when this property is modified.\n   * @see [CreateElementTool.targetModelId]($editor-frontend) for an example of a tool that uses this setting.\n   */\n  public get model(): Id64String | undefined {\n    return this._model;\n  }\n  public set model(model: Id64String | undefined) {\n    const previousModel = this.model;\n    if (model !== this.model) {\n      this._model = model;\n      this.onModelChanged.raiseEvent(previousModel);\n    }\n  }\n}\n\n/** A connection to an editable briefcase on the backend. This class uses [Ipc]($docs/learning/IpcInterface.md) to communicate\n * to the backend and may only be used by [[IpcApp]]s.\n * @public\n */\nexport class BriefcaseConnection extends IModelConnection {\n  protected _isClosed?: boolean;\n  private readonly _modelsMonitor: ModelChangeMonitor;\n  private _locks?: LockService;\n\n  /** The ID of the briefcase.\n   * @beta\n   */\n  public readonly briefcaseId?: number;\n\n  /** Default settings that can be used to control the behavior of [[Tool]]s that modify this briefcase.\n   * @beta\n   */\n  public readonly editorToolSettings = new BriefcaseEditorToolSettings();\n\n  /** Manages local changes to the briefcase via [Txns]($docs/learning/InteractiveEditing.md). */\n  public readonly txns: BriefcaseTxns;\n\n  /** Information about locks held on this iModel.\n   * @note This is intended to be used by tools and other UI elements, to provide information about the current lock state. Implementations are expected to cache lock information and so may not reflect changes to locks immediately.\n   * @alpha\n   */\n  public get locks(): LockService | undefined { return this._locks; }\n\n  public override isBriefcaseConnection(): this is BriefcaseConnection { return true; }\n\n  /** The Guid that identifies the iTwin that owns this iModel. */\n  public override get iTwinId(): GuidString { return super.iTwinId ?? Guid.empty; } // GuidString | undefined for IModelConnection, but required for BriefcaseConnection\n\n  /** The Guid that identifies this iModel. */\n  public override get iModelId(): GuidString { return super.iModelId ?? Guid.empty; } // GuidString | undefined for IModelConnection, but required for BriefcaseConnection\n\n  protected constructor(props: BriefcaseConnectionProps, openMode: OpenMode) {\n    super(props);\n    this._openMode = openMode;\n    this.briefcaseId = props.briefcaseId;\n    this.txns = new BriefcaseTxns(this);\n    this._modelsMonitor = new ModelChangeMonitor(this);\n    if (OpenMode.ReadWrite === this._openMode)\n      this.txns.onAfterUndoRedo.addListener(async () => { await IModelApp.toolAdmin.restartPrimitiveTool(); });\n\n    this.categories.cache.attachToBriefcase(this);\n  }\n\n  /** Open a BriefcaseConnection to a [BriefcaseDb]($backend). */\n  public static async openFile(briefcaseProps: OpenBriefcaseProps): Promise<BriefcaseConnection>;\n\n  /** Open a BriefcaseConnection to a [BriefcaseDb]($backend).\n   * @alpha\n   */\n  public static async openFile(briefcaseProps: OpenBriefcaseProps, lockServiceFactory?: LockServiceFactory): Promise<BriefcaseConnection>\n\n  public static async openFile(briefcaseProps: OpenBriefcaseProps, lockServiceFactory?: LockServiceFactory): Promise<BriefcaseConnection> {\n    const iModelProps = await IpcApp.appFunctionIpc.openBriefcase(briefcaseProps);\n    const connection = new this({ ...briefcaseProps, ...iModelProps }, briefcaseProps.readonly ? OpenMode.Readonly : OpenMode.ReadWrite);\n    if (lockServiceFactory)\n      connection._locks = await lockServiceFactory(connection);\n\n    IModelConnection.onOpen.raiseEvent(connection);\n    return connection;\n  }\n\n  /** Open a BriefcaseConnection to a [StandaloneDb]($backend)\n   * @note StandaloneDbs, by definition, may not push or pull changes. Attempting to do so will throw exceptions.\n   */\n  public static async openStandalone(filePath: string, openMode: OpenMode = OpenMode.ReadWrite, opts?: StandaloneOpenOptions): Promise<BriefcaseConnection> {\n    const openResponse = await IpcApp.appFunctionIpc.openStandalone(filePath, openMode, opts);\n    const connection = new this(openResponse, openMode);\n    IModelConnection.onOpen.raiseEvent(connection);\n    return connection;\n  }\n\n  /** Returns `true` if [[close]] has already been called. */\n  public get isClosed(): boolean { return this._isClosed === true; }\n\n  /**\n   * Close this BriefcaseConnection.\n   * @note make sure to call [[saveChanges]] before calling this method. Unsaved local changes are abandoned.\n   */\n  public async close(): Promise<void> {\n    if (this.isClosed)\n      return;\n\n    await this._modelsMonitor.close();\n\n    this.beforeClose();\n    this.txns[Symbol.dispose]();\n\n    this._isClosed = true;\n    await IpcApp.appFunctionIpc.closeIModel(this._fileKey);\n  }\n\n  protected requireTimeline() {\n    if (this.iTwinId === Guid.empty)\n      throw new IModelError(IModelStatus.WrongIModel, \"iModel has no timeline\");\n  }\n\n  /** Query if there are any pending Txns in this briefcase that are waiting to be pushed. */\n  public async hasPendingTxns(): Promise<boolean> { // eslint-disable-line @itwin/prefer-get\n    return this.txns.hasPendingTxns();\n  }\n\n  /** Commit pending changes to this briefcase.\n   * @param description Optional description of the changes.\n   * @deprecated Use methods on EditCommand instead.\n   */\n  public async saveChanges(description?: string): Promise<void> {\n    await IpcApp.appFunctionIpc.saveChanges(this.key, description); // eslint-disable-line @typescript-eslint/no-deprecated\n  }\n\n  /** Abandon pending changes to this briefcase.\n   * @deprecated Use methods on EditCommand instead.\n   */\n  public async abandonChanges(): Promise<void> {\n    await IpcApp.appFunctionIpc.abandonChanges(this.key); // eslint-disable-line @typescript-eslint/no-deprecated\n  }\n\n  /** Pull (and potentially merge if there are local changes) up to a specified changeset from iModelHub into this briefcase\n   * @param toIndex The changeset index to pull changes to. If `undefined`, pull all changes.\n   * @param options Options for pulling changes.\n   * @see [[BriefcaseTxns.onChangesPulled]] for the event dispatched after changes are pulled.\n   */\n  public async pullChanges(toIndex?: ChangesetIndex, options?: PullChangesOptions): Promise<void> {\n    const removeListeners: VoidFunction[] = [];\n    const shouldReportProgress = !!options?.downloadProgressCallback;\n\n    if (shouldReportProgress) {\n      const handleProgress = (_evt: Event, data: { loaded: number, total: number }) => {\n        options?.downloadProgressCallback?.(data);\n      };\n\n      const removeProgressListener = IpcApp.addListener(\n        getPullChangesIpcChannel(this.iModelId),\n        handleProgress,\n      );\n      removeListeners.push(removeProgressListener);\n    }\n\n    if (options?.abortSignal) {\n      const abort = () => void IpcApp.appFunctionIpc.cancelPullChangesRequest(this.key);\n      options?.abortSignal.addEventListener(\"abort\", abort);\n      removeListeners.push(() => options?.abortSignal?.removeEventListener(\"abort\", abort));\n    }\n\n    this.requireTimeline();\n    const ipcAppOptions: IpcAppPullChangesOptions = {\n      reportProgress: shouldReportProgress,\n      progressInterval: options?.progressInterval,\n      enableCancellation: !!options?.abortSignal,\n    };\n    try {\n      this.changeset = await IpcApp.appFunctionIpc.pullChanges(this.key, toIndex, ipcAppOptions);\n    } finally {\n      removeListeners.forEach((remove) => remove());\n    }\n  }\n\n  /** Create a changeset from local Txns and push to iModelHub. On success, clear Txn table.\n   * @param description The description for the changeset\n   * @returns the changesetId of the pushed changes\n   * @see [[BriefcaseTxns.onChangesPushed]] for the event dispatched after changes are pushed.\n   */\n  public async pushChanges(description: string): Promise<ChangesetIndexAndId> {\n    this.requireTimeline();\n    return IpcApp.appFunctionIpc.pushChanges(this.key, description);\n  }\n\n  /** The current graphical editing scope, if one is in progress.\n   * @see [[enterEditingScope]] to begin graphical editing.\n   */\n  public get editingScope(): GraphicalEditingScope | undefined {\n    return this._modelsMonitor.editingScope;\n  }\n\n  /** Return whether graphical editing is supported for this briefcase. It is not supported if the briefcase is read-only, or the briefcase contains a version of\n   * the BisCore ECSchema older than v0.1.11.\n   * @see [[enterEditingScope]] to enable graphical editing.\n   */\n  public async supportsGraphicalEditing(): Promise<boolean> {\n    return IpcApp.appFunctionIpc.isGraphicalEditingSupported(this.key);\n  }\n\n  /** Begin a new graphical editing scope.\n   * @throws Error if an editing scope already exists or one could not be created.\n   * @see [[GraphicalEditingScope.exit]] to exit the scope.\n   * @see [[supportsGraphicalEditing]] to determine whether this method should be expected to succeed.\n   * @see [[editingScope]] to obtain the current editing scope, if one is in progress.\n   */\n  public async enterEditingScope(): Promise<GraphicalEditingScope> {\n    return this._modelsMonitor.enterEditingScope();\n  }\n\n  /** Strictly for tests - dispatched from ModelChangeMonitor.processBuffered.\n   * @internal\n   */\n  public readonly onBufferedModelChanges = new BeEvent<(changedModelIds: Set<string>) => void>();\n}\n"]}

package/lib/cjs/BriefcaseTxns.d.ts

@@ -2,7 +2,7 @@
  * @module IModelConnection
  */
 import { BeEvent, IModelStatus } from "@itwin/core-bentley";
-import { ChangesetIdWithIndex, ChangesetIndexAndId, ChangesetProps, EcefLocationProps, GeographicCRSProps, ModelIdAndGeometryGuid, NotifyEntitiesChangedArgs, RootSubjectProps, TxnNotifications, TxnProps } from "@itwin/core-common";
+import { ChangesetIdWithIndex, ChangesetIndexAndId, ChangesetProps, EcefLocationProps, GeographicCRSProps, ModelIdAndGeometryGuid, NotifyEntitiesChangedArgs, ReinstateTxnArgs, ReverseTxnArgs, RootSubjectProps, TxnNotifications, TxnProps } from "@itwin/core-common";
 import { Range3dProps, XYZProps } from "@itwin/core-geometry";
 import { BriefcaseConnection } from "./BriefcaseConnection";
 import { NotificationHandler } from "./IpcApp";
@@ -161,6 +161,21 @@ export declare class BriefcaseTxns extends BriefcaseNotificationHandler implemen
      * @see [[isUndoPossible]] to determine if any reversible operations exist.
      */
     reverseSingleTxn(): Promise<IModelStatus>;
+    /** Reverse (undo) the most recent operation to this briefcase in the current session. By default, this method also
+     * abandons the locks that were acquired for that operation.
+     * @beta
+     * @note This method will also abandon locks associated with any later, reversed Txns, if they have not
+     * already been abandoned. For example, if a call to [[reverseTxns]] reverses Txn 2 without abandoning
+     * its locks, and then this method is called to reverse Txn 1, it will abandon the locks associated
+     * with _both_ Txn 1 and Txn 2.
+     * @note If there are any outstanding uncommitted changes, they are reversed.
+     * @note The term "operation" is used rather than Txn, since multiple Txns can be grouped together via [TxnManager.beginMultiTxnOperation]($backend). So,
+     * even though this method reverses only one operation, multiple Txns may be reversed if they were grouped together when they were made.
+     * @note If there are no reversible operations, this method does nothing and returns Success.
+     * @param args Optional arguments to control the behavior of the reverse operation, such as whether to retain locks.
+     * @returns A Promise that resolves to success if the transactions were reversed, or rejects with an IModelError otherwise.
+     */
+    reverseSingleTxnAsync(args?: ReverseTxnArgs): Promise<void>;
     /** Reverse (undo) the most recent operation(s) to the briefcase in the current session.
      * @param numOperations the number of operations to reverse. If this is greater than 1, the entire set of operations will
      *  be reinstated together when/if [[reinstateTxn]] is called.
@@ -170,12 +185,43 @@ export declare class BriefcaseTxns extends BriefcaseNotificationHandler implemen
      * @note If numOperations is too large only the number of reversible operations are reversed.
      */
     reverseTxns(numOperations: number): Promise<IModelStatus>;
+    /** Reverse (undo) the most recent operation(s) to the briefcase in the current session. By default, this method also
+     * abandons the locks that were acquired for those operations.
+     * @beta
+     * @note This method will also abandon locks associated with any later, reversed Txns, if they have not
+     * already been abandoned. For example, if a call to [[reverseTxns]] reverses Txn 2 without abandoning
+     * its locks, and then this method is called to reverse Txn 1, it will abandon the locks associated
+     * with _both_ Txn 1 and Txn 2.
+     * @note If you do not want to abandon any locks, set [ReverseTxnArgs.retainLocks]($common) to true.
+     * @note If there are any outstanding uncommitted changes, they are reversed.
+     * @note The term "operation" is used rather than Txn, since multiple Txns can be grouped together via [[beginMultiTxnOperation]]. So,
+     * even if numOperations is 1, multiple Txns may be reversed if they were grouped together when they were made.
+     * @note If numOperations is too large only the operations are reversible are reversed.
+     * @param numOperations the number of operations to reverse. If this is greater than 1, the entire set of operations will
+     *  be reinstated together when/if ReinstateTxn is called.
+     * @param args Optional arguments to control the behavior of the reverse operation, such as whether to retain locks.
+     * @returns A Promise that resolves to success if the transactions were reversed, or rejects with an IModelError otherwise.
+     */
+    reverseTxnsAsync(numOperations: number, args?: ReverseTxnArgs): Promise<void>;
     /** Reverse (undo) all changes back to the beginning of the session.
      * @see [[reinstateTxn]] to redo changes.
      * @see [[reverseSingleTxn]] to undo only the most recent operation.
      * @see [[isUndoPossible]] to determine if any reversible operations exist.
      */
     reverseAll(): Promise<IModelStatus>;
+    /** Reverse (undo) all operations back to the beginning of the session. By default, this method also
+     * abandons the locks that were acquired for those operations.
+     * @beta
+     * @note This method will also abandon locks associated with any later, reversed Txns, if they have not
+     * already been abandoned. For example, if a call to [[reverseTxns]] reverses Txn 2 without abandoning
+     * its locks, and then this method is called to reverse Txn 1, it will abandon the locks associated
+     * with _both_ Txn 1 and Txn 2.
+     * @note If there are any outstanding uncommitted changes, they are reversed.
+     * @note If there are no reversible operations, this method does nothing and returns Success.
+     * @param args Optional arguments to control the behavior of the reverse operation, such as whether to retain locks.
+     * @returns A Promise that resolves to success if the transactions were reversed, or rejects with an IModelError otherwise.
+     */
+    reverseAllTxnsAsync(args?: ReverseTxnArgs): Promise<void>;
     /** Reinstate (redo) the most recently reversed transaction. Since at any time multiple transactions can be reversed, it
      * may take multiple calls to this method to reinstate all reversed operations.
      * @returns Success if a reversed transaction was reinstated, error status otherwise.
@@ -184,6 +230,17 @@ export declare class BriefcaseTxns extends BriefcaseNotificationHandler implemen
      * @see [[reverseSingleTxn]] or [[reverseAll]] to undo changes.
      */
     reinstateTxn(): Promise<IModelStatus>;
+    /** Reinstate (redo) the most recently reversed transaction. Since at any time multiple transactions can be reversed, it
+     * may take multiple calls to this method to reinstate all reversed operations. This method also
+     * re-acquires the locks that were abandoned when those operations were reversed.
+     * @beta
+     * @param args Optional arguments to control the behavior of the reinstate operation.
+     * @returns Success if a reversed transaction was reinstated, error status otherwise.
+     * @note If there are any outstanding uncommitted changes, they are canceled before the Txn is reinstated.
+     * @see [[isRedoPossible]] to determine if any reinstatable operations exist.
+     * @see [[reverseSingleTxn]] or [[reverseAll]] to undo changes.
+     */
+    reinstateTxnAsync(args?: ReinstateTxnArgs): Promise<void>;
     /** Restart the current TxnManager session. This causes all Txns in the current session to no longer be undoable (as if the file was closed
      * and reopened.)
      * @note This can be quite disconcerting to the user expecting to be able to undo previously made changes. It should only be used

package/lib/cjs/BriefcaseTxns.d.ts.map

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

package/lib/cjs/BriefcaseTxns.js

@@ -215,6 +215,23 @@ class BriefcaseTxns extends BriefcaseNotificationHandler {
     async reverseSingleTxn() {
         return this.reverseTxns(1);
     }
+    /** Reverse (undo) the most recent operation to this briefcase in the current session. By default, this method also
+     * abandons the locks that were acquired for that operation.
+     * @beta
+     * @note This method will also abandon locks associated with any later, reversed Txns, if they have not
+     * already been abandoned. For example, if a call to [[reverseTxns]] reverses Txn 2 without abandoning
+     * its locks, and then this method is called to reverse Txn 1, it will abandon the locks associated
+     * with _both_ Txn 1 and Txn 2.
+     * @note If there are any outstanding uncommitted changes, they are reversed.
+     * @note The term "operation" is used rather than Txn, since multiple Txns can be grouped together via [TxnManager.beginMultiTxnOperation]($backend). So,
+     * even though this method reverses only one operation, multiple Txns may be reversed if they were grouped together when they were made.
+     * @note If there are no reversible operations, this method does nothing and returns Success.
+     * @param args Optional arguments to control the behavior of the reverse operation, such as whether to retain locks.
+     * @returns A Promise that resolves to success if the transactions were reversed, or rejects with an IModelError otherwise.
+     */
+    async reverseSingleTxnAsync(args) {
+        await this.reverseTxnsAsync(1, args);
+    }
     /** Reverse (undo) the most recent operation(s) to the briefcase in the current session.
      * @param numOperations the number of operations to reverse. If this is greater than 1, the entire set of operations will
      *  be reinstated together when/if [[reinstateTxn]] is called.
@@ -226,6 +243,26 @@ class BriefcaseTxns extends BriefcaseNotificationHandler {
     async reverseTxns(numOperations) {
         return IpcApp_1.IpcApp.appFunctionIpc.reverseTxns(this._iModel.key, numOperations);
     }
+    /** Reverse (undo) the most recent operation(s) to the briefcase in the current session. By default, this method also
+     * abandons the locks that were acquired for those operations.
+     * @beta
+     * @note This method will also abandon locks associated with any later, reversed Txns, if they have not
+     * already been abandoned. For example, if a call to [[reverseTxns]] reverses Txn 2 without abandoning
+     * its locks, and then this method is called to reverse Txn 1, it will abandon the locks associated
+     * with _both_ Txn 1 and Txn 2.
+     * @note If you do not want to abandon any locks, set [ReverseTxnArgs.retainLocks]($common) to true.
+     * @note If there are any outstanding uncommitted changes, they are reversed.
+     * @note The term "operation" is used rather than Txn, since multiple Txns can be grouped together via [[beginMultiTxnOperation]]. So,
+     * even if numOperations is 1, multiple Txns may be reversed if they were grouped together when they were made.
+     * @note If numOperations is too large only the operations are reversible are reversed.
+     * @param numOperations the number of operations to reverse. If this is greater than 1, the entire set of operations will
+     *  be reinstated together when/if ReinstateTxn is called.
+     * @param args Optional arguments to control the behavior of the reverse operation, such as whether to retain locks.
+     * @returns A Promise that resolves to success if the transactions were reversed, or rejects with an IModelError otherwise.
+     */
+    async reverseTxnsAsync(numOperations, args) {
+        return IpcApp_1.IpcApp.appFunctionIpc.reverseTxnsAsync(this._iModel.key, numOperations, args);
+    }
     /** Reverse (undo) all changes back to the beginning of the session.
      * @see [[reinstateTxn]] to redo changes.
      * @see [[reverseSingleTxn]] to undo only the most recent operation.
@@ -234,6 +271,21 @@ class BriefcaseTxns extends BriefcaseNotificationHandler {
     async reverseAll() {
         return IpcApp_1.IpcApp.appFunctionIpc.reverseAllTxn(this._iModel.key);
     }
+    /** Reverse (undo) all operations back to the beginning of the session. By default, this method also
+     * abandons the locks that were acquired for those operations.
+     * @beta
+     * @note This method will also abandon locks associated with any later, reversed Txns, if they have not
+     * already been abandoned. For example, if a call to [[reverseTxns]] reverses Txn 2 without abandoning
+     * its locks, and then this method is called to reverse Txn 1, it will abandon the locks associated
+     * with _both_ Txn 1 and Txn 2.
+     * @note If there are any outstanding uncommitted changes, they are reversed.
+     * @note If there are no reversible operations, this method does nothing and returns Success.
+     * @param args Optional arguments to control the behavior of the reverse operation, such as whether to retain locks.
+     * @returns A Promise that resolves to success if the transactions were reversed, or rejects with an IModelError otherwise.
+     */
+    async reverseAllTxnsAsync(args) {
+        return IpcApp_1.IpcApp.appFunctionIpc.reverseAllTxnsAsync(this._iModel.key, args);
+    }
     /** Reinstate (redo) the most recently reversed transaction. Since at any time multiple transactions can be reversed, it
      * may take multiple calls to this method to reinstate all reversed operations.
      * @returns Success if a reversed transaction was reinstated, error status otherwise.
@@ -244,6 +296,19 @@ class BriefcaseTxns extends BriefcaseNotificationHandler {
     async reinstateTxn() {
         return IpcApp_1.IpcApp.appFunctionIpc.reinstateTxn(this._iModel.key);
     }
+    /** Reinstate (redo) the most recently reversed transaction. Since at any time multiple transactions can be reversed, it
+     * may take multiple calls to this method to reinstate all reversed operations. This method also
+     * re-acquires the locks that were abandoned when those operations were reversed.
+     * @beta
+     * @param args Optional arguments to control the behavior of the reinstate operation.
+     * @returns Success if a reversed transaction was reinstated, error status otherwise.
+     * @note If there are any outstanding uncommitted changes, they are canceled before the Txn is reinstated.
+     * @see [[isRedoPossible]] to determine if any reinstatable operations exist.
+     * @see [[reverseSingleTxn]] or [[reverseAll]] to undo changes.
+     */
+    async reinstateTxnAsync(args) {
+        return IpcApp_1.IpcApp.appFunctionIpc.reinstateTxnAsync(this._iModel.key, args);
+    }
     /** Restart the current TxnManager session. This causes all Txns in the current session to no longer be undoable (as if the file was closed
      * and reopened.)
      * @note This can be quite disconcerting to the user expecting to be able to undo previously made changes. It should only be used

package/lib/cjs/BriefcaseTxns.js.map

@@ -1 +1 @@
-{"version":3,"file":"BriefcaseTxns.js","sourceRoot":"","sources":["../../src/BriefcaseTxns.ts"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n* See LICENSE.md in the project root for license terms and full copyright notice.\n*--------------------------------------------------------------------------------------------*/\n/** @packageDocumentation\n * @module IModelConnection\n */\n\nimport { BeEvent, IModelStatus } from \"@itwin/core-bentley\";\nimport {\n  ChangesetIdWithIndex,\n  ChangesetIndexAndId, ChangesetProps, EcefLocation, EcefLocationProps, GeographicCRS, GeographicCRSProps, ipcAppChannels,\n  ModelIdAndGeometryGuid, NotifyEntitiesChangedArgs, RemoveFunction, RootSubjectProps, TxnNotifications,\n  TxnProps,\n} from \"@itwin/core-common\";\nimport { Point3d, Range3d, Range3dProps, XYZProps } from \"@itwin/core-geometry\";\nimport { BriefcaseConnection } from \"./BriefcaseConnection\";\nimport { IpcApp, NotificationHandler } from \"./IpcApp\";\nimport { EntityChanges, TxnEntityChanges } from \"./TxnEntityChanges\";\n\n/**\n * Base class for notification handlers for events from the backend that are specific to a [[BriefcaseConnection]].\n * @see [[BriefcaseTxns]].\n * @public\n */\nexport abstract class BriefcaseNotificationHandler extends NotificationHandler {\n  constructor(private _key: string) { super(); }\n  public abstract get briefcaseChannelName(): string;\n  public get channelName() { return `${this.briefcaseChannelName}/${this._key}`; }\n}\n\n/** Manages local changes to a [[BriefcaseConnection]] via [Txns]($docs/learning/InteractiveEditing.md).\n * @see [[BriefcaseConnection.txns]].\n * @see [TxnManager]($backend) for the backend counterpart.\n * @public\n */\nexport class BriefcaseTxns extends BriefcaseNotificationHandler implements TxnNotifications {\n  private readonly _iModel: BriefcaseConnection;\n  private _cleanup?: RemoveFunction;\n\n  /** @internal */\n  public get briefcaseChannelName() {\n    return ipcAppChannels.txns;\n  }\n\n  /** Event raised after Txn validation or changeset application to indicate the set of changed elements.\n   * @note If there are many changed elements in a single Txn, the notifications are sent in batches so this event *may be called multiple times* per Txn.\n   */\n  public readonly onElementsChanged = new BeEvent<(changes: TxnEntityChanges) => void>();\n\n  /** Event raised after Txn validation or changeset application to indicate the set of changed models.\n   * @note If there are many changed models in a single Txn, the notifications are sent in batches so this event *may be called multiple times* per Txn.\n   */\n  public readonly onModelsChanged = new BeEvent<(changes: TxnEntityChanges) => void>();\n\n  /** Event raised after the geometry within one or more [[GeometricModelState]]s is modified by applying a changeset or validation of a transaction.\n   * A model's geometry can change as a result of:\n   *  - Insertion or deletion of a geometric element within the model; or\n   *  - Modification of an existing element's geometric properties; or\n   *  - An explicit request to flag it as changed via [IModelDb.Models.updateModel]($backend).\n   */\n  public readonly onModelGeometryChanged = new BeEvent<(changes: ReadonlyArray<ModelIdAndGeometryGuid>) => void>();\n\n  /** Event raised before a commit operation is performed. Initiated by a call to [[BriefcaseConnection.saveChanges]], unless there are no changes to save.\n   * @see [[onCommitted]] for the event raised after the operation.\n   */\n  public readonly onCommit = new BeEvent<() => void>();\n\n  /** Event raised after a commit operation is performed. Initiated by a call to [[BriefcaseConnection.saveChanges]], even if there were no changes to save.\n   * The event supplies the following information:\n   *  - `hasPendingTxns`: true if the briefcase has local changes not yet pushed to the server.\n   *  - `time`: the time at which changes were saved on the backend (obtained via `Date.now()`).\n   * @see [[onCommit]] for the event raised before the operation.\n   */\n  public readonly onCommitted = new BeEvent<(hasPendingTxns: boolean, time: number) => void>();\n\n  /** Event raised for a read-only briefcase that was opened with the `watchForChanges` flag enabled when changes made by another connection are applied to the briefcase.\n   * @see [[onReplayedExternalTxns]] for the event raised after all such changes have been applied.\n   */\n  public readonly onReplayExternalTxns = new BeEvent<() => void>();\n\n  /** Event raised for a read-only briefcase that was opened with the `watchForChanges` flag enabled when changes made by another connection are applied to the briefcase.\n   * @see [[onReplayExternalTxns]] for the event raised before the changes are applied.\n   */\n  public readonly onReplayedExternalTxns = new BeEvent<() => void>();\n\n  /** Event raised after a changeset has been applied to the briefcase.\n   * Changesets may be applied as a result of [[BriefcaseConnection.pullChanges]], or by undo/redo operations.\n   */\n  public readonly onChangesApplied = new BeEvent<() => void>();\n\n  /** Event raised before an undo/redo operation is performed.\n   * @see [[onAfterUndoRedo]] for the event raised after the operation.\n   */\n  public readonly onBeforeUndoRedo = new BeEvent<(isUndo: boolean) => void>();\n\n  /** Event raised after an undo/redo operation is performed.\n   * @see [[onBeforeUndoRedo]] for the event raised before to the operation.\n   */\n  public readonly onAfterUndoRedo = new BeEvent<(isUndo: boolean) => void>();\n\n  /** Event raised after changes are pulled and merged into the briefcase.\n   * @see [[BriefcaseConnection.pullAndMergeChanges]].\n   */\n  public readonly onChangesPulled = new BeEvent<(parentChangeset: ChangesetIndexAndId) => void>();\n\n  /** Event raised after the briefcase's local changes are pushed.\n   * @see [[BriefcaseConnection.pushChanges]].\n   */\n  public readonly onChangesPushed = new BeEvent<(parentChangeset: ChangesetIndexAndId) => void>();\n\n  /** Event raised before pull merge process begins.\n   * @alpha\n   */\n  public readonly onPullMergeBegin = new BeEvent<(changeset: ChangesetIdWithIndex) => void>();\n\n  /** Event raised before a rebase operation begins.\n   * @alpha\n   */\n  public readonly onRebaseBegin = new BeEvent<(txns: TxnProps[]) => void>();\n\n  /** Event raised before a transaction is rebased.\n   * @alpha\n   */\n  public readonly onRebaseTxnBegin = new BeEvent<(txnProps: TxnProps) => void>();\n\n  /**\n   * Event raised after a transaction is rebased.\n   * @alpha\n   */\n  public readonly onRebaseTxnEnd = new BeEvent<(txnProps: TxnProps) => void>();\n\n  /**\n   * Event raised after a rebase operation ends.\n   * @alpha\n   */\n  public readonly onRebaseEnd = new BeEvent<(txns: TxnProps[]) => void>();\n\n  /**\n   * Event raised after the pull merge process ends.\n   * @alpha\n   */\n  public readonly onPullMergeEnd = new BeEvent<(changeset: ChangesetIdWithIndex) => void>();\n\n  /** Event raised before incoming changes are applied.\n   * @alpha\n   */\n  public readonly onApplyIncomingChangesBegin = new BeEvent<(changesets: ChangesetProps[]) => void>();\n\n  /** Event raised after incoming changes are applied.\n   * @alpha\n   */\n  public readonly onApplyIncomingChangesEnd = new BeEvent<(changes: ChangesetProps[]) => void>();\n\n  /** Event raised before local changes are reversed.\n   * @alpha\n   */\n  public readonly onReverseLocalChangesBegin = new BeEvent<() => void>();\n\n  /** Event raised after local changes are reversed.\n   * @alpha\n   */\n  public readonly onReverseLocalChangesEnd = new BeEvent<(txns: TxnProps[]) => void>();\n\n  /** Event raised before downloading changesets begins.\n   * @alpha\n   */\n  public readonly onDownloadChangesetsBegin = new BeEvent<() => void>();\n\n  /** Event raised after downloading changesets ends.\n   * @alpha\n   */\n  public readonly onDownloadChangesetsEnd = new BeEvent<() => void>();\n\n  /** @internal */\n  public constructor(iModel: BriefcaseConnection) {\n    super(iModel.key);\n    this._iModel = iModel;\n    this._cleanup = this.registerImpl();\n  }\n\n  /** @internal */\n  public [Symbol.dispose](): void {\n    if (this._cleanup) {\n      this._cleanup();\n      this._cleanup = undefined;\n\n      this.onAfterUndoRedo.clear();\n      this.onApplyIncomingChangesBegin.clear();\n      this.onApplyIncomingChangesEnd.clear();\n      this.onBeforeUndoRedo.clear();\n      this.onChangesApplied.clear();\n      this.onChangesPulled.clear();\n      this.onChangesPushed.clear();\n      this.onCommit.clear();\n      this.onCommitted.clear();\n      this.onDownloadChangesetsBegin.clear();\n      this.onDownloadChangesetsEnd.clear();\n      this.onElementsChanged.clear();\n      this.onModelGeometryChanged.clear();\n      this.onModelsChanged.clear();\n      this.onPullMergeBegin.clear();\n      this.onPullMergeEnd.clear();\n      this.onRebaseBegin.clear();\n      this.onRebaseEnd.clear();\n      this.onRebaseTxnBegin.clear();\n      this.onRebaseTxnEnd.clear();\n      this.onReverseLocalChangesBegin.clear();\n      this.onReverseLocalChangesEnd.clear();\n    }\n  }\n\n  /** Query if the briefcase has any pending Txns waiting to be pushed. */\n  public async hasPendingTxns(): Promise<boolean> { // eslint-disable-line @itwin/prefer-get\n    return IpcApp.appFunctionIpc.hasPendingTxns(this._iModel.key);\n  }\n\n  /** Determine if any reversible (undoable) changes exist.\n   * @see [[reverseSingleTxn]] or [[reverseAll]] to undo changes.\n   */\n  public async isUndoPossible(): Promise<boolean> { // eslint-disable-line @itwin/prefer-get\n    return IpcApp.appFunctionIpc.isUndoPossible(this._iModel.key);\n  }\n\n  /** Determine if any reinstatable (redoable) changes exist.\n   * @see [[reinstateTxn]] to redo changes.\n   */\n  public async isRedoPossible(): Promise<boolean> { // eslint-disable-line @itwin/prefer-get\n    return IpcApp.appFunctionIpc.isRedoPossible(this._iModel.key);\n  }\n\n  /** Get the description of the operation that would be reversed by calling [[reverseTxns]]`(1)`.\n   * This is useful for showing the operation that would be undone, for example in a menu.\n   */\n  public async getUndoString(): Promise<string> {\n    return IpcApp.appFunctionIpc.getUndoString(this._iModel.key);\n  }\n\n  /** Get a description of the operation that would be reinstated by calling [[reinstateTxn]].\n   * This is useful for showing the operation that would be redone, in a pull-down menu for example.\n   */\n  public async getRedoString(): Promise<string> {\n    return IpcApp.appFunctionIpc.getRedoString(this._iModel.key);\n  }\n\n  /** Reverse (undo) the most recent operation.\n   * @see [[reinstateTxn]] to redo operations.\n   * @see [[reverseAll]] to undo all operations.\n   * @see [[isUndoPossible]] to determine if any reversible operations exist.\n   */\n  public async reverseSingleTxn(): Promise<IModelStatus> {\n    return this.reverseTxns(1);\n  }\n\n  /** Reverse (undo) the most recent operation(s) to the briefcase in the current session.\n   * @param numOperations the number of operations to reverse. If this is greater than 1, the entire set of operations will\n   *  be reinstated together when/if [[reinstateTxn]] is called.\n   * @note If there are any outstanding uncommitted changes, they are reversed.\n   * @note The term \"operation\" is used rather than Txn, since multiple Txns can be grouped together via [TxnManager.beginMultiTxnOperation]($backend). So,\n   * even if numOperations is 1, multiple Txns may be reversed if they were grouped together when they were made.\n   * @note If numOperations is too large only the number of reversible operations are reversed.\n   */\n  public async reverseTxns(numOperations: number): Promise<IModelStatus> {\n    return IpcApp.appFunctionIpc.reverseTxns(this._iModel.key, numOperations);\n  }\n\n  /** Reverse (undo) all changes back to the beginning of the session.\n   * @see [[reinstateTxn]] to redo changes.\n   * @see [[reverseSingleTxn]] to undo only the most recent operation.\n   * @see [[isUndoPossible]] to determine if any reversible operations exist.\n   */\n  public async reverseAll(): Promise<IModelStatus> {\n    return IpcApp.appFunctionIpc.reverseAllTxn(this._iModel.key);\n  }\n\n  /** Reinstate (redo) the most recently reversed transaction. Since at any time multiple transactions can be reversed, it\n   * may take multiple calls to this method to reinstate all reversed operations.\n   * @returns Success if a reversed transaction was reinstated, error status otherwise.\n   * @note If there are any outstanding uncommitted changes, they are canceled before the Txn is reinstated.\n   * @see [[isRedoPossible]] to determine if any reinstatable operations exist.\n   * @see [[reverseSingleTxn]] or [[reverseAll]] to undo changes.\n   */\n  public async reinstateTxn(): Promise<IModelStatus> {\n    return IpcApp.appFunctionIpc.reinstateTxn(this._iModel.key);\n  }\n\n  /** Restart the current TxnManager session. This causes all Txns in the current session to no longer be undoable (as if the file was closed\n   * and reopened.)\n   * @note This can be quite disconcerting to the user expecting to be able to undo previously made changes. It should only be used\n   * under extreme circumstances where damage to the file or session could happen if the currently committed are reversed. Use sparingly and with care.\n   * Probably a good idea to alert the user it happened.\n   */\n  public async restartTxnSession(): Promise<void> {\n    await IpcApp.appFunctionIpc.restartTxnSession(this._iModel.key);\n  }\n\n  /** @internal */\n  public notifyElementsChanged(changed: NotifyEntitiesChangedArgs): void {\n    this.onElementsChanged.raiseEvent(new EntityChanges(changed));\n  }\n\n  /** @internal */\n  public notifyModelsChanged(changed: NotifyEntitiesChangedArgs): void {\n    this.onModelsChanged.raiseEvent(new EntityChanges(changed));\n  }\n\n  /** @internal */\n  public notifyGeometryGuidsChanged(changes: ModelIdAndGeometryGuid[]): void {\n    this.onModelGeometryChanged.raiseEvent(changes);\n  }\n\n  /** @internal */\n  public notifyCommit() {\n    this.onCommit.raiseEvent();\n  }\n\n  /** @internal */\n  public notifyCommitted(hasPendingTxns: boolean, time: number) {\n    this.onCommitted.raiseEvent(hasPendingTxns, time);\n  }\n\n  /** @internal */\n  public notifyReplayExternalTxns() {\n    this.onReplayExternalTxns.raiseEvent();\n  }\n\n  /** @internal */\n  public notifyReplayedExternalTxns() {\n    this.onReplayedExternalTxns.raiseEvent();\n  }\n\n  /** @internal */\n  public notifyChangesApplied() {\n    this.onChangesApplied.raiseEvent();\n  }\n\n  /** @internal */\n  public notifyBeforeUndoRedo(isUndo: boolean) {\n    this.onBeforeUndoRedo.raiseEvent(isUndo);\n  }\n\n  /** @internal */\n  public notifyAfterUndoRedo(isUndo: boolean) {\n    this.onAfterUndoRedo.raiseEvent(isUndo);\n  }\n\n  /** @internal */\n  public notifyPulledChanges(parentChangeset: ChangesetIndexAndId) {\n    this.onChangesPulled.raiseEvent(parentChangeset);\n  }\n\n  /** @internal */\n  public notifyPushedChanges(parentChangeset: ChangesetIndexAndId) {\n    this.onChangesPushed.raiseEvent(parentChangeset);\n  }\n\n  /** @internal */\n  public notifyIModelNameChanged(name: string) {\n    this._iModel.name = name;\n  }\n\n  /** @internal */\n  public notifyRootSubjectChanged(subject: RootSubjectProps) {\n    this._iModel.rootSubject = subject;\n  }\n\n  /** @internal */\n  public notifyProjectExtentsChanged(range: Range3dProps) {\n    this._iModel.projectExtents = Range3d.fromJSON(range);\n  }\n\n  /** @internal */\n  public notifyGlobalOriginChanged(origin: XYZProps) {\n    this._iModel.globalOrigin = Point3d.fromJSON(origin);\n  }\n\n  /** @internal */\n  public notifyEcefLocationChanged(ecef: EcefLocationProps | undefined) {\n    this._iModel.ecefLocation = ecef ? new EcefLocation(ecef) : undefined;\n  }\n\n  /** @internal */\n  public notifyGeographicCoordinateSystemChanged(gcs: GeographicCRSProps | undefined) {\n    this._iModel.geographicCoordinateSystem = gcs ? new GeographicCRS(gcs) : undefined;\n  }\n\n  /** @internal */\n  public notifyPullMergeBegin(changeset: ChangesetIdWithIndex) {\n    this.onPullMergeBegin.raiseEvent(changeset);\n  }\n  /** @internal */\n  public notifyPullMergeEnd(changeset: ChangesetIdWithIndex) {\n    this.onPullMergeEnd.raiseEvent(changeset);\n  }\n  /** @internal */\n  public notifyApplyIncomingChangesBegin(changes: ChangesetProps[]) {\n    this.onApplyIncomingChangesBegin.raiseEvent(changes);\n  }\n  /** @internal */\n  public notifyApplyIncomingChangesEnd(changes: ChangesetProps[]) {\n    this.onApplyIncomingChangesEnd.raiseEvent(changes);\n  }\n  /** @internal */\n  public notifyReverseLocalChangesBegin() {\n    this.onReverseLocalChangesBegin.raiseEvent();\n  }\n  /** @internal */\n  public notifyReverseLocalChangesEnd(txns: TxnProps[]) {\n    this.onReverseLocalChangesEnd.raiseEvent(txns);\n  }\n  /** @internal */\n  public notifyDownloadChangesetsBegin() {\n    this.onDownloadChangesetsBegin.raiseEvent();\n  }\n  /** @internal */\n  public notifyDownloadChangesetsEnd() {\n    this.onDownloadChangesetsEnd.raiseEvent();\n  }\n  /** @internal */\n  public notifyRebaseBegin(txns: TxnProps[]) {\n    this.onRebaseBegin.raiseEvent(txns);\n  }\n  /** @internal */\n  public notifyRebaseEnd(txns: TxnProps[]) {\n    this.onRebaseEnd.raiseEvent(txns);\n  }\n  /** @internal */\n  public notifyRebaseTxnBegin(txn: TxnProps) {\n    this.onRebaseTxnBegin.raiseEvent(txn);\n  }\n  /** @internal */\n  public notifyRebaseTxnEnd(txn: TxnProps) {\n    this.onRebaseTxnEnd.raiseEvent(txn);\n  }\n}\n"]}
+{"version":3,"file":"BriefcaseTxns.js","sourceRoot":"","sources":["../../src/BriefcaseTxns.ts"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n* See LICENSE.md in the project root for license terms and full copyright notice.\n*--------------------------------------------------------------------------------------------*/\n/** @packageDocumentation\n * @module IModelConnection\n */\n\nimport { BeEvent, IModelStatus } from \"@itwin/core-bentley\";\nimport {\n  ChangesetIdWithIndex,\n  ChangesetIndexAndId, ChangesetProps, EcefLocation, EcefLocationProps, GeographicCRS, GeographicCRSProps, ipcAppChannels,\n  ModelIdAndGeometryGuid, NotifyEntitiesChangedArgs, ReinstateTxnArgs, RemoveFunction, ReverseTxnArgs, RootSubjectProps, TxnNotifications,\n  TxnProps,\n} from \"@itwin/core-common\";\nimport { Point3d, Range3d, Range3dProps, XYZProps } from \"@itwin/core-geometry\";\nimport { BriefcaseConnection } from \"./BriefcaseConnection\";\nimport { IpcApp, NotificationHandler } from \"./IpcApp\";\nimport { EntityChanges, TxnEntityChanges } from \"./TxnEntityChanges\";\n\n/**\n * Base class for notification handlers for events from the backend that are specific to a [[BriefcaseConnection]].\n * @see [[BriefcaseTxns]].\n * @public\n */\nexport abstract class BriefcaseNotificationHandler extends NotificationHandler {\n  constructor(private _key: string) { super(); }\n  public abstract get briefcaseChannelName(): string;\n  public get channelName() { return `${this.briefcaseChannelName}/${this._key}`; }\n}\n\n/** Manages local changes to a [[BriefcaseConnection]] via [Txns]($docs/learning/InteractiveEditing.md).\n * @see [[BriefcaseConnection.txns]].\n * @see [TxnManager]($backend) for the backend counterpart.\n * @public\n */\nexport class BriefcaseTxns extends BriefcaseNotificationHandler implements TxnNotifications {\n  private readonly _iModel: BriefcaseConnection;\n  private _cleanup?: RemoveFunction;\n\n  /** @internal */\n  public get briefcaseChannelName() {\n    return ipcAppChannels.txns;\n  }\n\n  /** Event raised after Txn validation or changeset application to indicate the set of changed elements.\n   * @note If there are many changed elements in a single Txn, the notifications are sent in batches so this event *may be called multiple times* per Txn.\n   */\n  public readonly onElementsChanged = new BeEvent<(changes: TxnEntityChanges) => void>();\n\n  /** Event raised after Txn validation or changeset application to indicate the set of changed models.\n   * @note If there are many changed models in a single Txn, the notifications are sent in batches so this event *may be called multiple times* per Txn.\n   */\n  public readonly onModelsChanged = new BeEvent<(changes: TxnEntityChanges) => void>();\n\n  /** Event raised after the geometry within one or more [[GeometricModelState]]s is modified by applying a changeset or validation of a transaction.\n   * A model's geometry can change as a result of:\n   *  - Insertion or deletion of a geometric element within the model; or\n   *  - Modification of an existing element's geometric properties; or\n   *  - An explicit request to flag it as changed via [IModelDb.Models.updateModel]($backend).\n   */\n  public readonly onModelGeometryChanged = new BeEvent<(changes: ReadonlyArray<ModelIdAndGeometryGuid>) => void>();\n\n  /** Event raised before a commit operation is performed. Initiated by a call to [[BriefcaseConnection.saveChanges]], unless there are no changes to save.\n   * @see [[onCommitted]] for the event raised after the operation.\n   */\n  public readonly onCommit = new BeEvent<() => void>();\n\n  /** Event raised after a commit operation is performed. Initiated by a call to [[BriefcaseConnection.saveChanges]], even if there were no changes to save.\n   * The event supplies the following information:\n   *  - `hasPendingTxns`: true if the briefcase has local changes not yet pushed to the server.\n   *  - `time`: the time at which changes were saved on the backend (obtained via `Date.now()`).\n   * @see [[onCommit]] for the event raised before the operation.\n   */\n  public readonly onCommitted = new BeEvent<(hasPendingTxns: boolean, time: number) => void>();\n\n  /** Event raised for a read-only briefcase that was opened with the `watchForChanges` flag enabled when changes made by another connection are applied to the briefcase.\n   * @see [[onReplayedExternalTxns]] for the event raised after all such changes have been applied.\n   */\n  public readonly onReplayExternalTxns = new BeEvent<() => void>();\n\n  /** Event raised for a read-only briefcase that was opened with the `watchForChanges` flag enabled when changes made by another connection are applied to the briefcase.\n   * @see [[onReplayExternalTxns]] for the event raised before the changes are applied.\n   */\n  public readonly onReplayedExternalTxns = new BeEvent<() => void>();\n\n  /** Event raised after a changeset has been applied to the briefcase.\n   * Changesets may be applied as a result of [[BriefcaseConnection.pullChanges]], or by undo/redo operations.\n   */\n  public readonly onChangesApplied = new BeEvent<() => void>();\n\n  /** Event raised before an undo/redo operation is performed.\n   * @see [[onAfterUndoRedo]] for the event raised after the operation.\n   */\n  public readonly onBeforeUndoRedo = new BeEvent<(isUndo: boolean) => void>();\n\n  /** Event raised after an undo/redo operation is performed.\n   * @see [[onBeforeUndoRedo]] for the event raised before to the operation.\n   */\n  public readonly onAfterUndoRedo = new BeEvent<(isUndo: boolean) => void>();\n\n  /** Event raised after changes are pulled and merged into the briefcase.\n   * @see [[BriefcaseConnection.pullAndMergeChanges]].\n   */\n  public readonly onChangesPulled = new BeEvent<(parentChangeset: ChangesetIndexAndId) => void>();\n\n  /** Event raised after the briefcase's local changes are pushed.\n   * @see [[BriefcaseConnection.pushChanges]].\n   */\n  public readonly onChangesPushed = new BeEvent<(parentChangeset: ChangesetIndexAndId) => void>();\n\n  /** Event raised before pull merge process begins.\n   * @alpha\n   */\n  public readonly onPullMergeBegin = new BeEvent<(changeset: ChangesetIdWithIndex) => void>();\n\n  /** Event raised before a rebase operation begins.\n   * @alpha\n   */\n  public readonly onRebaseBegin = new BeEvent<(txns: TxnProps[]) => void>();\n\n  /** Event raised before a transaction is rebased.\n   * @alpha\n   */\n  public readonly onRebaseTxnBegin = new BeEvent<(txnProps: TxnProps) => void>();\n\n  /**\n   * Event raised after a transaction is rebased.\n   * @alpha\n   */\n  public readonly onRebaseTxnEnd = new BeEvent<(txnProps: TxnProps) => void>();\n\n  /**\n   * Event raised after a rebase operation ends.\n   * @alpha\n   */\n  public readonly onRebaseEnd = new BeEvent<(txns: TxnProps[]) => void>();\n\n  /**\n   * Event raised after the pull merge process ends.\n   * @alpha\n   */\n  public readonly onPullMergeEnd = new BeEvent<(changeset: ChangesetIdWithIndex) => void>();\n\n  /** Event raised before incoming changes are applied.\n   * @alpha\n   */\n  public readonly onApplyIncomingChangesBegin = new BeEvent<(changesets: ChangesetProps[]) => void>();\n\n  /** Event raised after incoming changes are applied.\n   * @alpha\n   */\n  public readonly onApplyIncomingChangesEnd = new BeEvent<(changes: ChangesetProps[]) => void>();\n\n  /** Event raised before local changes are reversed.\n   * @alpha\n   */\n  public readonly onReverseLocalChangesBegin = new BeEvent<() => void>();\n\n  /** Event raised after local changes are reversed.\n   * @alpha\n   */\n  public readonly onReverseLocalChangesEnd = new BeEvent<(txns: TxnProps[]) => void>();\n\n  /** Event raised before downloading changesets begins.\n   * @alpha\n   */\n  public readonly onDownloadChangesetsBegin = new BeEvent<() => void>();\n\n  /** Event raised after downloading changesets ends.\n   * @alpha\n   */\n  public readonly onDownloadChangesetsEnd = new BeEvent<() => void>();\n\n  /** @internal */\n  public constructor(iModel: BriefcaseConnection) {\n    super(iModel.key);\n    this._iModel = iModel;\n    this._cleanup = this.registerImpl();\n  }\n\n  /** @internal */\n  public [Symbol.dispose](): void {\n    if (this._cleanup) {\n      this._cleanup();\n      this._cleanup = undefined;\n\n      this.onAfterUndoRedo.clear();\n      this.onApplyIncomingChangesBegin.clear();\n      this.onApplyIncomingChangesEnd.clear();\n      this.onBeforeUndoRedo.clear();\n      this.onChangesApplied.clear();\n      this.onChangesPulled.clear();\n      this.onChangesPushed.clear();\n      this.onCommit.clear();\n      this.onCommitted.clear();\n      this.onDownloadChangesetsBegin.clear();\n      this.onDownloadChangesetsEnd.clear();\n      this.onElementsChanged.clear();\n      this.onModelGeometryChanged.clear();\n      this.onModelsChanged.clear();\n      this.onPullMergeBegin.clear();\n      this.onPullMergeEnd.clear();\n      this.onRebaseBegin.clear();\n      this.onRebaseEnd.clear();\n      this.onRebaseTxnBegin.clear();\n      this.onRebaseTxnEnd.clear();\n      this.onReverseLocalChangesBegin.clear();\n      this.onReverseLocalChangesEnd.clear();\n    }\n  }\n\n  /** Query if the briefcase has any pending Txns waiting to be pushed. */\n  public async hasPendingTxns(): Promise<boolean> { // eslint-disable-line @itwin/prefer-get\n    return IpcApp.appFunctionIpc.hasPendingTxns(this._iModel.key);\n  }\n\n  /** Determine if any reversible (undoable) changes exist.\n   * @see [[reverseSingleTxn]] or [[reverseAll]] to undo changes.\n   */\n  public async isUndoPossible(): Promise<boolean> { // eslint-disable-line @itwin/prefer-get\n    return IpcApp.appFunctionIpc.isUndoPossible(this._iModel.key);\n  }\n\n  /** Determine if any reinstatable (redoable) changes exist.\n   * @see [[reinstateTxn]] to redo changes.\n   */\n  public async isRedoPossible(): Promise<boolean> { // eslint-disable-line @itwin/prefer-get\n    return IpcApp.appFunctionIpc.isRedoPossible(this._iModel.key);\n  }\n\n  /** Get the description of the operation that would be reversed by calling [[reverseTxns]]`(1)`.\n   * This is useful for showing the operation that would be undone, for example in a menu.\n   */\n  public async getUndoString(): Promise<string> {\n    return IpcApp.appFunctionIpc.getUndoString(this._iModel.key);\n  }\n\n  /** Get a description of the operation that would be reinstated by calling [[reinstateTxn]].\n   * This is useful for showing the operation that would be redone, in a pull-down menu for example.\n   */\n  public async getRedoString(): Promise<string> {\n    return IpcApp.appFunctionIpc.getRedoString(this._iModel.key);\n  }\n\n  /** Reverse (undo) the most recent operation.\n   * @see [[reinstateTxn]] to redo operations.\n   * @see [[reverseAll]] to undo all operations.\n   * @see [[isUndoPossible]] to determine if any reversible operations exist.\n   */\n  public async reverseSingleTxn(): Promise<IModelStatus> {\n    return this.reverseTxns(1);\n  }\n\n  /** Reverse (undo) the most recent operation to this briefcase in the current session. By default, this method also\n   * abandons the locks that were acquired for that operation.\n   * @beta\n   * @note This method will also abandon locks associated with any later, reversed Txns, if they have not\n   * already been abandoned. For example, if a call to [[reverseTxns]] reverses Txn 2 without abandoning\n   * its locks, and then this method is called to reverse Txn 1, it will abandon the locks associated\n   * with _both_ Txn 1 and Txn 2.\n   * @note If there are any outstanding uncommitted changes, they are reversed.\n   * @note The term \"operation\" is used rather than Txn, since multiple Txns can be grouped together via [TxnManager.beginMultiTxnOperation]($backend). So,\n   * even though this method reverses only one operation, multiple Txns may be reversed if they were grouped together when they were made.\n   * @note If there are no reversible operations, this method does nothing and returns Success.\n   * @param args Optional arguments to control the behavior of the reverse operation, such as whether to retain locks.\n   * @returns A Promise that resolves to success if the transactions were reversed, or rejects with an IModelError otherwise.\n   */\n  public async reverseSingleTxnAsync(args?: ReverseTxnArgs): Promise<void> {\n    await this.reverseTxnsAsync(1, args);\n  }\n\n  /** Reverse (undo) the most recent operation(s) to the briefcase in the current session.\n   * @param numOperations the number of operations to reverse. If this is greater than 1, the entire set of operations will\n   *  be reinstated together when/if [[reinstateTxn]] is called.\n   * @note If there are any outstanding uncommitted changes, they are reversed.\n   * @note The term \"operation\" is used rather than Txn, since multiple Txns can be grouped together via [TxnManager.beginMultiTxnOperation]($backend). So,\n   * even if numOperations is 1, multiple Txns may be reversed if they were grouped together when they were made.\n   * @note If numOperations is too large only the number of reversible operations are reversed.\n   */\n  public async reverseTxns(numOperations: number): Promise<IModelStatus> {\n    return IpcApp.appFunctionIpc.reverseTxns(this._iModel.key, numOperations);\n  }\n\n  /** Reverse (undo) the most recent operation(s) to the briefcase in the current session. By default, this method also\n   * abandons the locks that were acquired for those operations.\n   * @beta\n   * @note This method will also abandon locks associated with any later, reversed Txns, if they have not\n   * already been abandoned. For example, if a call to [[reverseTxns]] reverses Txn 2 without abandoning\n   * its locks, and then this method is called to reverse Txn 1, it will abandon the locks associated\n   * with _both_ Txn 1 and Txn 2.\n   * @note If you do not want to abandon any locks, set [ReverseTxnArgs.retainLocks]($common) to true.\n   * @note If there are any outstanding uncommitted changes, they are reversed.\n   * @note The term \"operation\" is used rather than Txn, since multiple Txns can be grouped together via [[beginMultiTxnOperation]]. So,\n   * even if numOperations is 1, multiple Txns may be reversed if they were grouped together when they were made.\n   * @note If numOperations is too large only the operations are reversible are reversed.\n   * @param numOperations the number of operations to reverse. If this is greater than 1, the entire set of operations will\n   *  be reinstated together when/if ReinstateTxn is called.\n   * @param args Optional arguments to control the behavior of the reverse operation, such as whether to retain locks.\n   * @returns A Promise that resolves to success if the transactions were reversed, or rejects with an IModelError otherwise.\n   */\n  public async reverseTxnsAsync(numOperations: number, args?: ReverseTxnArgs): Promise<void> {\n    return IpcApp.appFunctionIpc.reverseTxnsAsync(this._iModel.key, numOperations, args);\n  }\n\n  /** Reverse (undo) all changes back to the beginning of the session.\n   * @see [[reinstateTxn]] to redo changes.\n   * @see [[reverseSingleTxn]] to undo only the most recent operation.\n   * @see [[isUndoPossible]] to determine if any reversible operations exist.\n   */\n  public async reverseAll(): Promise<IModelStatus> {\n    return IpcApp.appFunctionIpc.reverseAllTxn(this._iModel.key);\n  }\n\n  /** Reverse (undo) all operations back to the beginning of the session. By default, this method also\n   * abandons the locks that were acquired for those operations.\n   * @beta\n   * @note This method will also abandon locks associated with any later, reversed Txns, if they have not\n   * already been abandoned. For example, if a call to [[reverseTxns]] reverses Txn 2 without abandoning\n   * its locks, and then this method is called to reverse Txn 1, it will abandon the locks associated\n   * with _both_ Txn 1 and Txn 2.\n   * @note If there are any outstanding uncommitted changes, they are reversed.\n   * @note If there are no reversible operations, this method does nothing and returns Success.\n   * @param args Optional arguments to control the behavior of the reverse operation, such as whether to retain locks.\n   * @returns A Promise that resolves to success if the transactions were reversed, or rejects with an IModelError otherwise.\n   */\n  public async reverseAllTxnsAsync(args?: ReverseTxnArgs): Promise<void> {\n    return IpcApp.appFunctionIpc.reverseAllTxnsAsync(this._iModel.key, args);\n  }\n\n  /** Reinstate (redo) the most recently reversed transaction. Since at any time multiple transactions can be reversed, it\n   * may take multiple calls to this method to reinstate all reversed operations.\n   * @returns Success if a reversed transaction was reinstated, error status otherwise.\n   * @note If there are any outstanding uncommitted changes, they are canceled before the Txn is reinstated.\n   * @see [[isRedoPossible]] to determine if any reinstatable operations exist.\n   * @see [[reverseSingleTxn]] or [[reverseAll]] to undo changes.\n   */\n  public async reinstateTxn(): Promise<IModelStatus> {\n    return IpcApp.appFunctionIpc.reinstateTxn(this._iModel.key);\n  }\n\n  /** Reinstate (redo) the most recently reversed transaction. Since at any time multiple transactions can be reversed, it\n   * may take multiple calls to this method to reinstate all reversed operations. This method also\n   * re-acquires the locks that were abandoned when those operations were reversed.\n   * @beta\n   * @param args Optional arguments to control the behavior of the reinstate operation.\n   * @returns Success if a reversed transaction was reinstated, error status otherwise.\n   * @note If there are any outstanding uncommitted changes, they are canceled before the Txn is reinstated.\n   * @see [[isRedoPossible]] to determine if any reinstatable operations exist.\n   * @see [[reverseSingleTxn]] or [[reverseAll]] to undo changes.\n   */\n  public async reinstateTxnAsync(args?: ReinstateTxnArgs): Promise<void> {\n    return IpcApp.appFunctionIpc.reinstateTxnAsync(this._iModel.key, args);\n  }\n\n  /** Restart the current TxnManager session. This causes all Txns in the current session to no longer be undoable (as if the file was closed\n   * and reopened.)\n   * @note This can be quite disconcerting to the user expecting to be able to undo previously made changes. It should only be used\n   * under extreme circumstances where damage to the file or session could happen if the currently committed are reversed. Use sparingly and with care.\n   * Probably a good idea to alert the user it happened.\n   */\n  public async restartTxnSession(): Promise<void> {\n    await IpcApp.appFunctionIpc.restartTxnSession(this._iModel.key);\n  }\n\n  /** @internal */\n  public notifyElementsChanged(changed: NotifyEntitiesChangedArgs): void {\n    this.onElementsChanged.raiseEvent(new EntityChanges(changed));\n  }\n\n  /** @internal */\n  public notifyModelsChanged(changed: NotifyEntitiesChangedArgs): void {\n    this.onModelsChanged.raiseEvent(new EntityChanges(changed));\n  }\n\n  /** @internal */\n  public notifyGeometryGuidsChanged(changes: ModelIdAndGeometryGuid[]): void {\n    this.onModelGeometryChanged.raiseEvent(changes);\n  }\n\n  /** @internal */\n  public notifyCommit() {\n    this.onCommit.raiseEvent();\n  }\n\n  /** @internal */\n  public notifyCommitted(hasPendingTxns: boolean, time: number) {\n    this.onCommitted.raiseEvent(hasPendingTxns, time);\n  }\n\n  /** @internal */\n  public notifyReplayExternalTxns() {\n    this.onReplayExternalTxns.raiseEvent();\n  }\n\n  /** @internal */\n  public notifyReplayedExternalTxns() {\n    this.onReplayedExternalTxns.raiseEvent();\n  }\n\n  /** @internal */\n  public notifyChangesApplied() {\n    this.onChangesApplied.raiseEvent();\n  }\n\n  /** @internal */\n  public notifyBeforeUndoRedo(isUndo: boolean) {\n    this.onBeforeUndoRedo.raiseEvent(isUndo);\n  }\n\n  /** @internal */\n  public notifyAfterUndoRedo(isUndo: boolean) {\n    this.onAfterUndoRedo.raiseEvent(isUndo);\n  }\n\n  /** @internal */\n  public notifyPulledChanges(parentChangeset: ChangesetIndexAndId) {\n    this.onChangesPulled.raiseEvent(parentChangeset);\n  }\n\n  /** @internal */\n  public notifyPushedChanges(parentChangeset: ChangesetIndexAndId) {\n    this.onChangesPushed.raiseEvent(parentChangeset);\n  }\n\n  /** @internal */\n  public notifyIModelNameChanged(name: string) {\n    this._iModel.name = name;\n  }\n\n  /** @internal */\n  public notifyRootSubjectChanged(subject: RootSubjectProps) {\n    this._iModel.rootSubject = subject;\n  }\n\n  /** @internal */\n  public notifyProjectExtentsChanged(range: Range3dProps) {\n    this._iModel.projectExtents = Range3d.fromJSON(range);\n  }\n\n  /** @internal */\n  public notifyGlobalOriginChanged(origin: XYZProps) {\n    this._iModel.globalOrigin = Point3d.fromJSON(origin);\n  }\n\n  /** @internal */\n  public notifyEcefLocationChanged(ecef: EcefLocationProps | undefined) {\n    this._iModel.ecefLocation = ecef ? new EcefLocation(ecef) : undefined;\n  }\n\n  /** @internal */\n  public notifyGeographicCoordinateSystemChanged(gcs: GeographicCRSProps | undefined) {\n    this._iModel.geographicCoordinateSystem = gcs ? new GeographicCRS(gcs) : undefined;\n  }\n\n  /** @internal */\n  public notifyPullMergeBegin(changeset: ChangesetIdWithIndex) {\n    this.onPullMergeBegin.raiseEvent(changeset);\n  }\n  /** @internal */\n  public notifyPullMergeEnd(changeset: ChangesetIdWithIndex) {\n    this.onPullMergeEnd.raiseEvent(changeset);\n  }\n  /** @internal */\n  public notifyApplyIncomingChangesBegin(changes: ChangesetProps[]) {\n    this.onApplyIncomingChangesBegin.raiseEvent(changes);\n  }\n  /** @internal */\n  public notifyApplyIncomingChangesEnd(changes: ChangesetProps[]) {\n    this.onApplyIncomingChangesEnd.raiseEvent(changes);\n  }\n  /** @internal */\n  public notifyReverseLocalChangesBegin() {\n    this.onReverseLocalChangesBegin.raiseEvent();\n  }\n  /** @internal */\n  public notifyReverseLocalChangesEnd(txns: TxnProps[]) {\n    this.onReverseLocalChangesEnd.raiseEvent(txns);\n  }\n  /** @internal */\n  public notifyDownloadChangesetsBegin() {\n    this.onDownloadChangesetsBegin.raiseEvent();\n  }\n  /** @internal */\n  public notifyDownloadChangesetsEnd() {\n    this.onDownloadChangesetsEnd.raiseEvent();\n  }\n  /** @internal */\n  public notifyRebaseBegin(txns: TxnProps[]) {\n    this.onRebaseBegin.raiseEvent(txns);\n  }\n  /** @internal */\n  public notifyRebaseEnd(txns: TxnProps[]) {\n    this.onRebaseEnd.raiseEvent(txns);\n  }\n  /** @internal */\n  public notifyRebaseTxnBegin(txn: TxnProps) {\n    this.onRebaseTxnBegin.raiseEvent(txn);\n  }\n  /** @internal */\n  public notifyRebaseTxnEnd(txn: TxnProps) {\n    this.onRebaseTxnEnd.raiseEvent(txn);\n  }\n}\n"]}

package/lib/cjs/ContextRealityModelState.d.ts

@@ -25,6 +25,8 @@ export declare class ContextRealityModelState extends ContextRealityModel {
     constructor(props: ContextRealityModelProps, iModel: IModelConnection, displayStyle: DisplayStyleState);
     /** The tile tree reference responsible for drawing the reality model into a [[Viewport]]. */
     get treeRef(): TileTreeReference;
+    /** @internal */
+    detachLayerListeners(): void;
     /** The set of available [[ActiveSpatialClassifier]]s that can be used to classify the reality model. */
     get classifiers(): SpatialClassifiersState;
     /** The transient Id assigned to this reality model at run-time. */

package/lib/cjs/ContextRealityModelState.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ContextRealityModelState.d.ts","sourceRoot":"","sources":["../../src/ContextRealityModelState.ts"],"names":[],"mappings":"AAIA;;GAEG;AAEH,OAAO,EAAU,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,mBAAmB,EAAE,wBAAwB,EAAwC,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC/I,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAGtD,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACpE,OAAO,EAAwF,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAE1I;;;;;;;GAOG;AACH,qBAAa,wBAAyB,SAAQ,mBAAmB;IAC/D,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAiC;IAC1D,6DAA6D;IAC7D,SAAgB,MAAM,EAAE,gBAAgB,CAAC;IACzC,8EAA8E;IAC9E,SAAyB,WAAW,EAAE,oBAAoB,CAAC;IAE3D,gBAAgB;gBACG,KAAK,EAAE,wBAAwB,EAAE,MAAM,EAAE,gBAAgB,EAAE,YAAY,EAAE,iBAAiB;IAsC7G,6FAA6F;IAC7F,IAAW,OAAO,IAAI,iBAAiB,CAA0B;IAEjE,wGAAwG;IACxG,IAAoB,WAAW,IAAI,uBAAuB,CAGzD;IAED,mEAAmE;IACnE,IAAW,OAAO,IAAI,UAAU,GAAG,SAAS,CAE3C;IAED,kEAAkE;IAClE,IAAW,QAAQ,IAAI,OAAO,CAE7B;CACF"}
+{"version":3,"file":"ContextRealityModelState.d.ts","sourceRoot":"","sources":["../../src/ContextRealityModelState.ts"],"names":[],"mappings":"AAIA;;GAEG;AAEH,OAAO,EAAU,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,mBAAmB,EAAE,wBAAwB,EAAwC,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC/I,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAGtD,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACpE,OAAO,EAAwF,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAE1I;;;;;;;GAOG;AACH,qBAAa,wBAAyB,SAAQ,mBAAmB;IAC/D,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAiC;IAC1D,6DAA6D;IAC7D,SAAgB,MAAM,EAAE,gBAAgB,CAAC;IACzC,8EAA8E;IAC9E,SAAyB,WAAW,EAAE,oBAAoB,CAAC;IAE3D,gBAAgB;gBACG,KAAK,EAAE,wBAAwB,EAAE,MAAM,EAAE,gBAAgB,EAAE,YAAY,EAAE,iBAAiB;IAsC7G,6FAA6F;IAC7F,IAAW,OAAO,IAAI,iBAAiB,CAA0B;IAEjE,gBAAgB;IACT,oBAAoB,IAAI,IAAI;IAInC,wGAAwG;IACxG,IAAoB,WAAW,IAAI,uBAAuB,CAGzD;IAED,mEAAmE;IACnE,IAAW,OAAO,IAAI,UAAU,GAAG,SAAS,CAE3C;IAED,kEAAkE;IAClE,IAAW,QAAQ,IAAI,OAAO,CAE7B;CACF"}

package/lib/cjs/ContextRealityModelState.js

@@ -68,6 +68,10 @@ class ContextRealityModelState extends core_common_1.ContextRealityModel {
     }
     /** The tile tree reference responsible for drawing the reality model into a [[Viewport]]. */
     get treeRef() { return this._treeRef; }
+    /** @internal */
+    detachLayerListeners() {
+        this._treeRef.detachLayerListeners();
+    }
     /** The set of available [[ActiveSpatialClassifier]]s that can be used to classify the reality model. */
     get classifiers() {
         (0, core_bentley_1.assert)(super.classifiers instanceof SpatialClassifiersState_1.SpatialClassifiersState);