@itwin/core-backend 3.6.0-dev.52 → 3.6.0-dev.53

package/lib/cjs/TxnManager.js

@@ -1,357 +1,357 @@
-"use strict";
-/*---------------------------------------------------------------------------------------------
-* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
-* See LICENSE.md in the project root for license terms and full copyright notice.
-*--------------------------------------------------------------------------------------------*/
-/** @packageDocumentation
- * @module iModels
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.TxnManager = exports.setMaxEntitiesPerEvent = void 0;
-const core_bentley_1 = require("@itwin/core-bentley");
-const BackendLoggerCategory_1 = require("./BackendLoggerCategory");
-const IpcHost_1 = require("./IpcHost");
-/** Strictly for tests. @internal */
-function setMaxEntitiesPerEvent(max) {
-    const prevMax = ChangedEntitiesProc.maxPerEvent;
-    ChangedEntitiesProc.maxPerEvent = max;
-    return prevMax;
-}
-exports.setMaxEntitiesPerEvent = setMaxEntitiesPerEvent;
-/** Maintains an ordered array of entity Ids and a parallel array containing the index of the corresponding entity's class Id. */
-class ChangedEntitiesArray {
-    constructor(classIds) {
-        this.entityIds = new core_bentley_1.OrderedId64Array();
-        this._classIndices = [];
-        this._classIds = classIds;
-    }
-    insert(entityId, classId) {
-        const entityIndex = this.entityIds.insert(entityId);
-        const classIndex = this._classIds.insert(classId);
-        (0, core_bentley_1.assert)(classIndex >= 0);
-        if (this.entityIds.length !== this._classIndices.length) {
-            // New entity - insert corresponding class index entry.
-            this._classIndices.splice(entityIndex, 0, classIndex);
-        }
-        else {
-            // Existing entity - update corresponding class index.
-            // (We do this because apparently connectors can (very rarely) change the class Id of an existing element).
-            this._classIndices[entityIndex] = classIndex;
-        }
-        (0, core_bentley_1.assert)(this.entityIds.length === this._classIndices.length);
-    }
-    clear() {
-        this.entityIds.clear();
-        this._classIndices.length = 0;
-    }
-    addToChangedEntities(entities, type) {
-        if (this.entityIds.length > 0)
-            entities[type] = core_bentley_1.CompressedId64Set.compressIds(this.entityIds);
-    }
-    iterable(classIds) {
-        function* iterator(entityIds, classIndices) {
-            const entity = { id: "", classId: "" };
-            for (let i = 0; i < entityIds.length; i++) {
-                entity.id = entityIds[i];
-                entity.classId = classIds[classIndices[i]];
-                yield entity;
-            }
-        }
-        return {
-            [Symbol.iterator]: () => iterator(this.entityIds.array, this._classIndices),
-        };
-    }
-}
-class ChangedEntitiesProc {
-    constructor() {
-        this._classIds = new core_bentley_1.IndexMap((lhs, rhs) => (0, core_bentley_1.compareStrings)(lhs, rhs));
-        this._inserted = new ChangedEntitiesArray(this._classIds);
-        this._deleted = new ChangedEntitiesArray(this._classIds);
-        this._updated = new ChangedEntitiesArray(this._classIds);
-        this._currSize = 0;
-    }
-    static process(iModel, mgr) {
-        if (mgr.isDisposed) {
-            // The iModel is being closed. Do not prepare new sqlite statements.
-            return;
-        }
-        this.processChanges(iModel, mgr.onElementsChanged, "notifyElementsChanged");
-        this.processChanges(iModel, mgr.onModelsChanged, "notifyModelsChanged");
-    }
-    sendEvent(iModel, evt, evtName) {
-        if (this._currSize === 0)
-            return;
-        const classIds = this._classIds.toArray();
-        // Notify backend listeners.
-        const txnEntities = {
-            inserts: this._inserted.iterable(classIds),
-            deletes: this._deleted.iterable(classIds),
-            updates: this._updated.iterable(classIds),
-        };
-        evt.raiseEvent(txnEntities);
-        // Notify frontend listeners.
-        const entities = {};
-        this._inserted.addToChangedEntities(entities, "inserted");
-        this._deleted.addToChangedEntities(entities, "deleted");
-        this._updated.addToChangedEntities(entities, "updated");
-        IpcHost_1.IpcHost.notifyTxns(iModel, evtName, entities);
-        // Reset state.
-        this._inserted.clear();
-        this._deleted.clear();
-        this._updated.clear();
-        this._classIds.clear();
-        this._currSize = 0;
-    }
-    static processChanges(iModel, changedEvent, evtName) {
-        try {
-            const maxSize = this.maxPerEvent;
-            const changes = new ChangedEntitiesProc();
-            const select = "notifyElementsChanged" === evtName
-                ? "SELECT ElementId, ChangeType, ECClassId FROM temp.txn_Elements"
-                : "SELECT ModelId, ChangeType, ECClassId FROM temp.txn_Models";
-            iModel.withPreparedSqliteStatement(select, (sql) => {
-                const stmt = sql.stmt;
-                while (sql.step() === core_bentley_1.DbResult.BE_SQLITE_ROW) {
-                    const id = stmt.getValueId(0);
-                    const classId = stmt.getValueId(2);
-                    switch (stmt.getValueInteger(1)) {
-                        case 0:
-                            changes._inserted.insert(id, classId);
-                            break;
-                        case 1:
-                            changes._updated.insert(id, classId);
-                            break;
-                        case 2:
-                            changes._deleted.insert(id, classId);
-                            break;
-                    }
-                    if (++changes._currSize >= maxSize)
-                        changes.sendEvent(iModel, changedEvent, evtName);
-                }
-            });
-            changes.sendEvent(iModel, changedEvent, evtName);
-        }
-        catch (err) {
-            core_bentley_1.Logger.logError(BackendLoggerCategory_1.BackendLoggerCategory.IModelDb, core_bentley_1.BentleyError.getErrorMessage(err));
-        }
-    }
-}
-ChangedEntitiesProc.maxPerEvent = 1000;
-/** Manages local changes to a [[BriefcaseDb]] or [[StandaloneDb]] via [Txns]($docs/learning/InteractiveEditing.md)
- * @public
- */
-class TxnManager {
-    /** @internal */
-    constructor(_iModel) {
-        this._iModel = _iModel;
-        /** @internal */
-        this._isDisposed = false;
-        /** Array of errors from dependency propagation */
-        this.validationErrors = [];
-        /** @internal */
-        this.onEndValidation = new core_bentley_1.BeEvent();
-        /** Called after validation completes from [[IModelDb.saveChanges]].
-         * The argument to the event holds the list of elements that were inserted, updated, and deleted.
-         * @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.
-         */
-        this.onElementsChanged = new core_bentley_1.BeEvent();
-        /** Called after validation completes from [[IModelDb.saveChanges]].
-         * The argument to the event holds the list of models that were inserted, updated, and deleted.
-         * @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.
-         */
-        this.onModelsChanged = new core_bentley_1.BeEvent();
-        /** Event raised after the geometry within one or more [[GeometricModel]]s is modified by applying a changeset or validation of a transaction.
-         * A model's geometry can change as a result of:
-         *  - Insertion or deletion of a geometric element within the model; or
-         *  - Modification of an existing element's geometric properties; or
-         *  - An explicit request to flag it as changed via [[IModelDb.Models.updateModel]].
-         */
-        this.onModelGeometryChanged = new core_bentley_1.BeEvent();
-        this.onGeometryChanged = new core_bentley_1.BeEvent();
-        /** Event raised before a commit operation is performed. Initiated by a call to [[IModelDb.saveChanges]], unless there are no changes to save. */
-        this.onCommit = new core_bentley_1.BeEvent();
-        /** Event raised after a commit operation has been performed. Initiated by a call to [[IModelDb.saveChanges]], even if there were no changes to save. */
-        this.onCommitted = new core_bentley_1.BeEvent();
-        /** Event raised after a ChangeSet has been applied to this briefcase */
-        this.onChangesApplied = new core_bentley_1.BeEvent();
-        /** Event raised before an undo/redo operation is performed. */
-        this.onBeforeUndoRedo = new core_bentley_1.BeEvent();
-        /** Event raised after an undo/redo operation has been performed.
-         * @param _action The action that was performed.
-         */
-        this.onAfterUndoRedo = new core_bentley_1.BeEvent();
-        _iModel.onBeforeClose.addOnce(() => {
-            this._isDisposed = true;
-        });
-    }
-    /** @internal */
-    get isDisposed() {
-        return this._isDisposed;
-    }
-    get _nativeDb() { return this._iModel.nativeDb; }
-    _getElementClass(elClassName) {
-        return this._iModel.getJsClass(elClassName);
-    }
-    _getRelationshipClass(relClassName) {
-        return this._iModel.getJsClass(relClassName);
-    }
-    /** @internal */
-    _onBeforeOutputsHandled(elClassName, elId) {
-        this._getElementClass(elClassName).onBeforeOutputsHandled(elId, this._iModel);
-    }
-    /** @internal */
-    _onAllInputsHandled(elClassName, elId) {
-        this._getElementClass(elClassName).onAllInputsHandled(elId, this._iModel);
-    }
-    /** @internal */
-    _onRootChanged(props) {
-        this._getRelationshipClass(props.classFullName).onRootChanged(props, this._iModel);
-    }
-    /** @internal */
-    _onDeletedDependency(props) {
-        this._getRelationshipClass(props.classFullName).onDeletedDependency(props, this._iModel);
-    }
-    /** @internal */
-    _onBeginValidate() { this.validationErrors.length = 0; }
-    /** called from native code after validation of a Txn, either from saveChanges or apply changeset.
-     * @internal
-     */
-    _onEndValidate() {
-        ChangedEntitiesProc.process(this._iModel, this);
-        this.onEndValidation.raiseEvent();
-        // TODO: if (this.validationErrors.length !== 0) throw new IModelError(validation ...)
-    }
-    /** @internal */
-    _onGeometryChanged(modelProps) {
-        this.onGeometryChanged.raiseEvent(modelProps);
-        IpcHost_1.IpcHost.notifyEditingScope(this._iModel, "notifyGeometryChanged", modelProps); // send to frontend
-    }
-    /** @internal */
-    _onGeometryGuidsChanged(changes) {
-        this.onModelGeometryChanged.raiseEvent(changes);
-        IpcHost_1.IpcHost.notifyTxns(this._iModel, "notifyGeometryGuidsChanged", changes);
-    }
-    /** @internal */
-    _onCommit() {
-        this.onCommit.raiseEvent();
-        IpcHost_1.IpcHost.notifyTxns(this._iModel, "notifyCommit");
-    }
-    /** @internal */
-    _onCommitted() {
-        this.onCommitted.raiseEvent();
-        IpcHost_1.IpcHost.notifyTxns(this._iModel, "notifyCommitted", this.hasPendingTxns, Date.now());
-    }
-    /** @internal */
-    _onChangesApplied() {
-        ChangedEntitiesProc.process(this._iModel, this);
-        this.onChangesApplied.raiseEvent();
-        IpcHost_1.IpcHost.notifyTxns(this._iModel, "notifyChangesApplied");
-    }
-    /** @internal */
-    _onBeforeUndoRedo(isUndo) {
-        this.onBeforeUndoRedo.raiseEvent(isUndo);
-        IpcHost_1.IpcHost.notifyTxns(this._iModel, "notifyBeforeUndoRedo", isUndo);
-    }
-    /** @internal */
-    _onAfterUndoRedo(isUndo) {
-        this.onAfterUndoRedo.raiseEvent(isUndo);
-        IpcHost_1.IpcHost.notifyTxns(this._iModel, "notifyAfterUndoRedo", isUndo);
-    }
-    /** Dependency handlers may call method this to report a validation error.
-     * @param error The error. If error.fatal === true, the transaction will cancel rather than commit.
-     */
-    reportError(error) {
-        this.validationErrors.push(error);
-        this._nativeDb.logTxnError(error.fatal);
-    }
-    /** Determine whether any fatal validation errors have occurred during dependency propagation.  */
-    get hasFatalError() { return this._nativeDb.hasFatalTxnError(); }
-    /**
-     * 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
-     * under extreme circumstances where damage to the file or session could happen if the currently committed are reversed. Use sparingly and with care.
-     * Probably a good idea to alert the user it happened.
-     */
-    restartSession() {
-        this._nativeDb.restartTxnSession();
-    }
-    /** Determine whether current txn is propagating indirect changes or not. */
-    get isIndirectChanges() { return this._nativeDb.isIndirectChanges(); }
-    /** Determine if there are currently any reversible (undoable) changes from this editing session. */
-    get isUndoPossible() { return this._nativeDb.isUndoPossible(); }
-    /** Determine if there are currently any reinstatable (redoable) changes */
-    get isRedoPossible() { return this._nativeDb.isRedoPossible(); }
-    /** Get the description of the operation that would be reversed by calling reverseTxns(1).
-     * This is useful for showing the operation that would be undone, for example in a menu.
-     */
-    getUndoString() { return this._nativeDb.getUndoString(); }
-    /** Get a description of the operation that would be reinstated by calling reinstateTxn.
-     * This is useful for showing the operation that would be redone, in a pull-down menu for example.
-     */
-    getRedoString() { return this._nativeDb.getRedoString(); }
-    /** Begin a new multi-Txn operation. This can be used to cause a series of Txns that would normally
-     * be considered separate actions for undo to be grouped into a single undoable operation. This means that when reverseTxns(1) is called,
-     * the entire group of changes are undone together. Multi-Txn operations can be nested and until the outermost operation is closed
-     * all changes constitute a single operation.
-     * @note This method must always be paired with a call to endMultiTxnAction.
-     */
-    beginMultiTxnOperation() { return this._nativeDb.beginMultiTxnOperation(); }
-    /** End a multi-Txn operation */
-    endMultiTxnOperation() { return this._nativeDb.endMultiTxnOperation(); }
-    /** Return the depth of the multi-Txn stack. Generally for diagnostic use only. */
-    getMultiTxnOperationDepth() { return this._nativeDb.getMultiTxnOperationDepth(); }
-    /** Reverse (undo) the most recent operation(s) to this IModelDb.
-     * @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.
-     * @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.
-     */
-    reverseTxns(numOperations) {
-        return this._iModel.reverseTxns(numOperations);
-    }
-    /** Reverse the most recent operation. */
-    reverseSingleTxn() { return this.reverseTxns(1); }
-    /** Reverse all changes back to the beginning of the session. */
-    reverseAll() { return this._nativeDb.reverseAll(); }
-    /** Reverse all changes back to a previously saved TxnId.
-     * @param txnId a TxnId obtained from a previous call to GetCurrentTxnId.
-     * @returns Success if the transactions were reversed, error status otherwise.
-     * @see  [[getCurrentTxnId]] [[cancelTo]]
-     */
-    reverseTo(txnId) { return this._nativeDb.reverseTo(txnId); }
-    /** Reverse and then cancel (make non-reinstatable) all changes back to a previous TxnId.
-     * @param txnId a TxnId obtained from a previous call to [[getCurrentTxnId]]
-     * @returns Success if the transactions were reversed and cleared, error status otherwise.
-     */
-    cancelTo(txnId) { return this._nativeDb.cancelTo(txnId); }
-    /** Reinstate 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.
-     * @note If there are any outstanding uncommitted changes, they are canceled before the Txn is reinstated.
-     */
-    reinstateTxn() { return this._iModel.reinstateTxn(); }
-    /** Get the Id of the first transaction, if any.
-     */
-    queryFirstTxnId() { return this._nativeDb.queryFirstTxnId(); }
-    /** Get the successor of the specified TxnId */
-    queryNextTxnId(txnId) { return this._nativeDb.queryNextTxnId(txnId); }
-    /** Get the predecessor of the specified TxnId */
-    queryPreviousTxnId(txnId) { return this._nativeDb.queryPreviousTxnId(txnId); }
-    /** Get the Id of the current (tip) transaction.  */
-    getCurrentTxnId() { return this._nativeDb.getCurrentTxnId(); }
-    /** Get the description that was supplied when the specified transaction was saved. */
-    getTxnDescription(txnId) { return this._nativeDb.getTxnDescription(txnId); }
-    /** Test if a TxnId is valid */
-    isTxnIdValid(txnId) { return this._nativeDb.isTxnIdValid(txnId); }
-    /** Query if there are any pending Txns in this IModelDb that are waiting to be pushed.  */
-    get hasPendingTxns() { return this._nativeDb.hasPendingTxns(); }
-    /** Query if there are any changes in memory that have yet to be saved to the IModelDb. */
-    get hasUnsavedChanges() { return this._nativeDb.hasUnsavedChanges(); }
-    /** Query if there are un-saved or un-pushed local changes. */
-    get hasLocalChanges() { return this.hasUnsavedChanges || this.hasPendingTxns; }
-}
-exports.TxnManager = TxnManager;
+"use strict";
+/*---------------------------------------------------------------------------------------------
+* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+* See LICENSE.md in the project root for license terms and full copyright notice.
+*--------------------------------------------------------------------------------------------*/
+/** @packageDocumentation
+ * @module iModels
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TxnManager = exports.setMaxEntitiesPerEvent = void 0;
+const core_bentley_1 = require("@itwin/core-bentley");
+const BackendLoggerCategory_1 = require("./BackendLoggerCategory");
+const IpcHost_1 = require("./IpcHost");
+/** Strictly for tests. @internal */
+function setMaxEntitiesPerEvent(max) {
+    const prevMax = ChangedEntitiesProc.maxPerEvent;
+    ChangedEntitiesProc.maxPerEvent = max;
+    return prevMax;
+}
+exports.setMaxEntitiesPerEvent = setMaxEntitiesPerEvent;
+/** Maintains an ordered array of entity Ids and a parallel array containing the index of the corresponding entity's class Id. */
+class ChangedEntitiesArray {
+    constructor(classIds) {
+        this.entityIds = new core_bentley_1.OrderedId64Array();
+        this._classIndices = [];
+        this._classIds = classIds;
+    }
+    insert(entityId, classId) {
+        const entityIndex = this.entityIds.insert(entityId);
+        const classIndex = this._classIds.insert(classId);
+        (0, core_bentley_1.assert)(classIndex >= 0);
+        if (this.entityIds.length !== this._classIndices.length) {
+            // New entity - insert corresponding class index entry.
+            this._classIndices.splice(entityIndex, 0, classIndex);
+        }
+        else {
+            // Existing entity - update corresponding class index.
+            // (We do this because apparently connectors can (very rarely) change the class Id of an existing element).
+            this._classIndices[entityIndex] = classIndex;
+        }
+        (0, core_bentley_1.assert)(this.entityIds.length === this._classIndices.length);
+    }
+    clear() {
+        this.entityIds.clear();
+        this._classIndices.length = 0;
+    }
+    addToChangedEntities(entities, type) {
+        if (this.entityIds.length > 0)
+            entities[type] = core_bentley_1.CompressedId64Set.compressIds(this.entityIds);
+    }
+    iterable(classIds) {
+        function* iterator(entityIds, classIndices) {
+            const entity = { id: "", classId: "" };
+            for (let i = 0; i < entityIds.length; i++) {
+                entity.id = entityIds[i];
+                entity.classId = classIds[classIndices[i]];
+                yield entity;
+            }
+        }
+        return {
+            [Symbol.iterator]: () => iterator(this.entityIds.array, this._classIndices),
+        };
+    }
+}
+class ChangedEntitiesProc {
+    constructor() {
+        this._classIds = new core_bentley_1.IndexMap((lhs, rhs) => (0, core_bentley_1.compareStrings)(lhs, rhs));
+        this._inserted = new ChangedEntitiesArray(this._classIds);
+        this._deleted = new ChangedEntitiesArray(this._classIds);
+        this._updated = new ChangedEntitiesArray(this._classIds);
+        this._currSize = 0;
+    }
+    static process(iModel, mgr) {
+        if (mgr.isDisposed) {
+            // The iModel is being closed. Do not prepare new sqlite statements.
+            return;
+        }
+        this.processChanges(iModel, mgr.onElementsChanged, "notifyElementsChanged");
+        this.processChanges(iModel, mgr.onModelsChanged, "notifyModelsChanged");
+    }
+    sendEvent(iModel, evt, evtName) {
+        if (this._currSize === 0)
+            return;
+        const classIds = this._classIds.toArray();
+        // Notify backend listeners.
+        const txnEntities = {
+            inserts: this._inserted.iterable(classIds),
+            deletes: this._deleted.iterable(classIds),
+            updates: this._updated.iterable(classIds),
+        };
+        evt.raiseEvent(txnEntities);
+        // Notify frontend listeners.
+        const entities = {};
+        this._inserted.addToChangedEntities(entities, "inserted");
+        this._deleted.addToChangedEntities(entities, "deleted");
+        this._updated.addToChangedEntities(entities, "updated");
+        IpcHost_1.IpcHost.notifyTxns(iModel, evtName, entities);
+        // Reset state.
+        this._inserted.clear();
+        this._deleted.clear();
+        this._updated.clear();
+        this._classIds.clear();
+        this._currSize = 0;
+    }
+    static processChanges(iModel, changedEvent, evtName) {
+        try {
+            const maxSize = this.maxPerEvent;
+            const changes = new ChangedEntitiesProc();
+            const select = "notifyElementsChanged" === evtName
+                ? "SELECT ElementId, ChangeType, ECClassId FROM temp.txn_Elements"
+                : "SELECT ModelId, ChangeType, ECClassId FROM temp.txn_Models";
+            iModel.withPreparedSqliteStatement(select, (sql) => {
+                const stmt = sql.stmt;
+                while (sql.step() === core_bentley_1.DbResult.BE_SQLITE_ROW) {
+                    const id = stmt.getValueId(0);
+                    const classId = stmt.getValueId(2);
+                    switch (stmt.getValueInteger(1)) {
+                        case 0:
+                            changes._inserted.insert(id, classId);
+                            break;
+                        case 1:
+                            changes._updated.insert(id, classId);
+                            break;
+                        case 2:
+                            changes._deleted.insert(id, classId);
+                            break;
+                    }
+                    if (++changes._currSize >= maxSize)
+                        changes.sendEvent(iModel, changedEvent, evtName);
+                }
+            });
+            changes.sendEvent(iModel, changedEvent, evtName);
+        }
+        catch (err) {
+            core_bentley_1.Logger.logError(BackendLoggerCategory_1.BackendLoggerCategory.IModelDb, core_bentley_1.BentleyError.getErrorMessage(err));
+        }
+    }
+}
+ChangedEntitiesProc.maxPerEvent = 1000;
+/** Manages local changes to a [[BriefcaseDb]] or [[StandaloneDb]] via [Txns]($docs/learning/InteractiveEditing.md)
+ * @public
+ */
+class TxnManager {
+    /** @internal */
+    constructor(_iModel) {
+        this._iModel = _iModel;
+        /** @internal */
+        this._isDisposed = false;
+        /** Array of errors from dependency propagation */
+        this.validationErrors = [];
+        /** @internal */
+        this.onEndValidation = new core_bentley_1.BeEvent();
+        /** Called after validation completes from [[IModelDb.saveChanges]].
+         * The argument to the event holds the list of elements that were inserted, updated, and deleted.
+         * @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.
+         */
+        this.onElementsChanged = new core_bentley_1.BeEvent();
+        /** Called after validation completes from [[IModelDb.saveChanges]].
+         * The argument to the event holds the list of models that were inserted, updated, and deleted.
+         * @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.
+         */
+        this.onModelsChanged = new core_bentley_1.BeEvent();
+        /** Event raised after the geometry within one or more [[GeometricModel]]s is modified by applying a changeset or validation of a transaction.
+         * A model's geometry can change as a result of:
+         *  - Insertion or deletion of a geometric element within the model; or
+         *  - Modification of an existing element's geometric properties; or
+         *  - An explicit request to flag it as changed via [[IModelDb.Models.updateModel]].
+         */
+        this.onModelGeometryChanged = new core_bentley_1.BeEvent();
+        this.onGeometryChanged = new core_bentley_1.BeEvent();
+        /** Event raised before a commit operation is performed. Initiated by a call to [[IModelDb.saveChanges]], unless there are no changes to save. */
+        this.onCommit = new core_bentley_1.BeEvent();
+        /** Event raised after a commit operation has been performed. Initiated by a call to [[IModelDb.saveChanges]], even if there were no changes to save. */
+        this.onCommitted = new core_bentley_1.BeEvent();
+        /** Event raised after a ChangeSet has been applied to this briefcase */
+        this.onChangesApplied = new core_bentley_1.BeEvent();
+        /** Event raised before an undo/redo operation is performed. */
+        this.onBeforeUndoRedo = new core_bentley_1.BeEvent();
+        /** Event raised after an undo/redo operation has been performed.
+         * @param _action The action that was performed.
+         */
+        this.onAfterUndoRedo = new core_bentley_1.BeEvent();
+        _iModel.onBeforeClose.addOnce(() => {
+            this._isDisposed = true;
+        });
+    }
+    /** @internal */
+    get isDisposed() {
+        return this._isDisposed;
+    }
+    get _nativeDb() { return this._iModel.nativeDb; }
+    _getElementClass(elClassName) {
+        return this._iModel.getJsClass(elClassName);
+    }
+    _getRelationshipClass(relClassName) {
+        return this._iModel.getJsClass(relClassName);
+    }
+    /** @internal */
+    _onBeforeOutputsHandled(elClassName, elId) {
+        this._getElementClass(elClassName).onBeforeOutputsHandled(elId, this._iModel);
+    }
+    /** @internal */
+    _onAllInputsHandled(elClassName, elId) {
+        this._getElementClass(elClassName).onAllInputsHandled(elId, this._iModel);
+    }
+    /** @internal */
+    _onRootChanged(props) {
+        this._getRelationshipClass(props.classFullName).onRootChanged(props, this._iModel);
+    }
+    /** @internal */
+    _onDeletedDependency(props) {
+        this._getRelationshipClass(props.classFullName).onDeletedDependency(props, this._iModel);
+    }
+    /** @internal */
+    _onBeginValidate() { this.validationErrors.length = 0; }
+    /** called from native code after validation of a Txn, either from saveChanges or apply changeset.
+     * @internal
+     */
+    _onEndValidate() {
+        ChangedEntitiesProc.process(this._iModel, this);
+        this.onEndValidation.raiseEvent();
+        // TODO: if (this.validationErrors.length !== 0) throw new IModelError(validation ...)
+    }
+    /** @internal */
+    _onGeometryChanged(modelProps) {
+        this.onGeometryChanged.raiseEvent(modelProps);
+        IpcHost_1.IpcHost.notifyEditingScope(this._iModel, "notifyGeometryChanged", modelProps); // send to frontend
+    }
+    /** @internal */
+    _onGeometryGuidsChanged(changes) {
+        this.onModelGeometryChanged.raiseEvent(changes);
+        IpcHost_1.IpcHost.notifyTxns(this._iModel, "notifyGeometryGuidsChanged", changes);
+    }
+    /** @internal */
+    _onCommit() {
+        this.onCommit.raiseEvent();
+        IpcHost_1.IpcHost.notifyTxns(this._iModel, "notifyCommit");
+    }
+    /** @internal */
+    _onCommitted() {
+        this.onCommitted.raiseEvent();
+        IpcHost_1.IpcHost.notifyTxns(this._iModel, "notifyCommitted", this.hasPendingTxns, Date.now());
+    }
+    /** @internal */
+    _onChangesApplied() {
+        ChangedEntitiesProc.process(this._iModel, this);
+        this.onChangesApplied.raiseEvent();
+        IpcHost_1.IpcHost.notifyTxns(this._iModel, "notifyChangesApplied");
+    }
+    /** @internal */
+    _onBeforeUndoRedo(isUndo) {
+        this.onBeforeUndoRedo.raiseEvent(isUndo);
+        IpcHost_1.IpcHost.notifyTxns(this._iModel, "notifyBeforeUndoRedo", isUndo);
+    }
+    /** @internal */
+    _onAfterUndoRedo(isUndo) {
+        this.onAfterUndoRedo.raiseEvent(isUndo);
+        IpcHost_1.IpcHost.notifyTxns(this._iModel, "notifyAfterUndoRedo", isUndo);
+    }
+    /** Dependency handlers may call method this to report a validation error.
+     * @param error The error. If error.fatal === true, the transaction will cancel rather than commit.
+     */
+    reportError(error) {
+        this.validationErrors.push(error);
+        this._nativeDb.logTxnError(error.fatal);
+    }
+    /** Determine whether any fatal validation errors have occurred during dependency propagation.  */
+    get hasFatalError() { return this._nativeDb.hasFatalTxnError(); }
+    /**
+     * 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
+     * under extreme circumstances where damage to the file or session could happen if the currently committed are reversed. Use sparingly and with care.
+     * Probably a good idea to alert the user it happened.
+     */
+    restartSession() {
+        this._nativeDb.restartTxnSession();
+    }
+    /** Determine whether current txn is propagating indirect changes or not. */
+    get isIndirectChanges() { return this._nativeDb.isIndirectChanges(); }
+    /** Determine if there are currently any reversible (undoable) changes from this editing session. */
+    get isUndoPossible() { return this._nativeDb.isUndoPossible(); }
+    /** Determine if there are currently any reinstatable (redoable) changes */
+    get isRedoPossible() { return this._nativeDb.isRedoPossible(); }
+    /** Get the description of the operation that would be reversed by calling reverseTxns(1).
+     * This is useful for showing the operation that would be undone, for example in a menu.
+     */
+    getUndoString() { return this._nativeDb.getUndoString(); }
+    /** Get a description of the operation that would be reinstated by calling reinstateTxn.
+     * This is useful for showing the operation that would be redone, in a pull-down menu for example.
+     */
+    getRedoString() { return this._nativeDb.getRedoString(); }
+    /** Begin a new multi-Txn operation. This can be used to cause a series of Txns that would normally
+     * be considered separate actions for undo to be grouped into a single undoable operation. This means that when reverseTxns(1) is called,
+     * the entire group of changes are undone together. Multi-Txn operations can be nested and until the outermost operation is closed
+     * all changes constitute a single operation.
+     * @note This method must always be paired with a call to endMultiTxnAction.
+     */
+    beginMultiTxnOperation() { return this._nativeDb.beginMultiTxnOperation(); }
+    /** End a multi-Txn operation */
+    endMultiTxnOperation() { return this._nativeDb.endMultiTxnOperation(); }
+    /** Return the depth of the multi-Txn stack. Generally for diagnostic use only. */
+    getMultiTxnOperationDepth() { return this._nativeDb.getMultiTxnOperationDepth(); }
+    /** Reverse (undo) the most recent operation(s) to this IModelDb.
+     * @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.
+     * @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.
+     */
+    reverseTxns(numOperations) {
+        return this._iModel.reverseTxns(numOperations);
+    }
+    /** Reverse the most recent operation. */
+    reverseSingleTxn() { return this.reverseTxns(1); }
+    /** Reverse all changes back to the beginning of the session. */
+    reverseAll() { return this._nativeDb.reverseAll(); }
+    /** Reverse all changes back to a previously saved TxnId.
+     * @param txnId a TxnId obtained from a previous call to GetCurrentTxnId.
+     * @returns Success if the transactions were reversed, error status otherwise.
+     * @see  [[getCurrentTxnId]] [[cancelTo]]
+     */
+    reverseTo(txnId) { return this._nativeDb.reverseTo(txnId); }
+    /** Reverse and then cancel (make non-reinstatable) all changes back to a previous TxnId.
+     * @param txnId a TxnId obtained from a previous call to [[getCurrentTxnId]]
+     * @returns Success if the transactions were reversed and cleared, error status otherwise.
+     */
+    cancelTo(txnId) { return this._nativeDb.cancelTo(txnId); }
+    /** Reinstate 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.
+     * @note If there are any outstanding uncommitted changes, they are canceled before the Txn is reinstated.
+     */
+    reinstateTxn() { return this._iModel.reinstateTxn(); }
+    /** Get the Id of the first transaction, if any.
+     */
+    queryFirstTxnId() { return this._nativeDb.queryFirstTxnId(); }
+    /** Get the successor of the specified TxnId */
+    queryNextTxnId(txnId) { return this._nativeDb.queryNextTxnId(txnId); }
+    /** Get the predecessor of the specified TxnId */
+    queryPreviousTxnId(txnId) { return this._nativeDb.queryPreviousTxnId(txnId); }
+    /** Get the Id of the current (tip) transaction.  */
+    getCurrentTxnId() { return this._nativeDb.getCurrentTxnId(); }
+    /** Get the description that was supplied when the specified transaction was saved. */
+    getTxnDescription(txnId) { return this._nativeDb.getTxnDescription(txnId); }
+    /** Test if a TxnId is valid */
+    isTxnIdValid(txnId) { return this._nativeDb.isTxnIdValid(txnId); }
+    /** Query if there are any pending Txns in this IModelDb that are waiting to be pushed.  */
+    get hasPendingTxns() { return this._nativeDb.hasPendingTxns(); }
+    /** Query if there are any changes in memory that have yet to be saved to the IModelDb. */
+    get hasUnsavedChanges() { return this._nativeDb.hasUnsavedChanges(); }
+    /** Query if there are un-saved or un-pushed local changes. */
+    get hasLocalChanges() { return this.hasUnsavedChanges || this.hasPendingTxns; }
+}
+exports.TxnManager = TxnManager;
 //# sourceMappingURL=TxnManager.js.map