@itwin/core-backend 3.5.0-dev.27 → 3.5.0-dev.29

package/lib/cjs/IpcHost.js

@@ -1,235 +1,279 @@
-"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 NativeApp
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.IpcHandler = exports.IpcHost = void 0;
-const core_bentley_1 = require("@itwin/core-bentley");
-const core_common_1 = require("@itwin/core-common");
-const IModelDb_1 = require("./IModelDb");
-const IModelHost_1 = require("./IModelHost");
-const IModelTileRpcImpl_1 = require("./rpc-impl/IModelTileRpcImpl");
-/**
- * Used by applications that have a dedicated backend. IpcHosts may send messages to their corresponding IpcApp.
- * @note if either end terminates, the other must too.
- * @public
- */
-class IpcHost {
-    /** Get the implementation of the [IpcSocketBackend]($common) interface. */
-    static get ipc() { return this._ipc; } // eslint-disable-line @typescript-eslint/no-non-null-assertion
-    /** Determine whether Ipc is available for this backend. This will only be true if [[startup]] has been called on this class. */
-    static get isValid() { return undefined !== this._ipc; }
-    /**
-     * Send a message to the frontend over an Ipc channel.
-     * @param channel the name of the channel matching the name registered with [[IpcApp.addListener]].
-     * @param data The content of the message.
-     */
-    static send(channel, ...data) {
-        this.ipc.send((0, core_common_1.iTwinChannel)(channel), ...data);
-    }
-    /**
-     * Establish a handler for an Ipc channel to receive [[Frontend.invoke]] calls
-     * @param channel The name of the channel for this handler.
-     * @param handler A function that supplies the implementation for `channel`
-     * @note returns A function to call to remove the handler.
-     */
-    static handle(channel, handler) {
-        return this.ipc.handle((0, core_common_1.iTwinChannel)(channel), handler);
-    }
-    /**
-     * Establish a handler to receive messages sent via [[IpcApp.send]].
-     * @param channel The name of the channel for the messages.
-     * @param listener A function called when messages are sent over `channel`
-     * @note returns A function to call to remove the listener.
-     */
-    static addListener(channel, listener) {
-        return this.ipc.addListener((0, core_common_1.iTwinChannel)(channel), listener);
-    }
-    /**
-     * Remove a previously registered listener
-     * @param channel The name of the channel for the listener previously registered with [[addListener]]
-     * @param listener The function passed to [[addListener]]
-     */
-    static removeListener(channel, listener) {
-        this.ipc.removeListener((0, core_common_1.iTwinChannel)(channel), listener);
-    }
-    static notify(channel, briefcase, methodName, ...args) {
-        if (this.isValid)
-            return this.send(`${channel}:${briefcase.key}`, methodName, ...args);
-    }
-    /** @internal */
-    static notifyIpcFrontend(methodName, ...args) {
-        return IpcHost.send(core_common_1.IpcAppChannel.AppNotify, methodName, ...args);
-    }
-    /** @internal */
-    static notifyTxns(briefcase, methodName, ...args) {
-        this.notify(core_common_1.IpcAppChannel.Txns, briefcase, methodName, ...args);
-    }
-    /** @internal */
-    static notifyEditingScope(briefcase, methodName, ...args) {
-        this.notify(core_common_1.IpcAppChannel.EditingScope, briefcase, methodName, ...args);
-    }
-    /**
-     * Start the backend of an Ipc app.
-     * @param opt
-     * @note this method calls [[IModelHost.startup]] internally.
-     */
-    static async startup(opt) {
-        var _a, _b, _c;
-        this._ipc = (_a = opt === null || opt === void 0 ? void 0 : opt.ipcHost) === null || _a === void 0 ? void 0 : _a.socket;
-        if ((_c = (_b = opt === null || opt === void 0 ? void 0 : opt.ipcHost) === null || _b === void 0 ? void 0 : _b.exceptions) === null || _c === void 0 ? void 0 : _c.noStack)
-            this.noStack = true;
-        if (this.isValid) { // for tests, we use IpcHost but don't have a frontend
-            IpcAppHandler.register();
-        }
-        await IModelHost_1.IModelHost.startup(opt === null || opt === void 0 ? void 0 : opt.iModelHost);
-    }
-    /** Shutdown IpcHost backend. Also calls [[IModelHost.shutdown]] */
-    static async shutdown() {
-        this._ipc = undefined;
-        await IModelHost_1.IModelHost.shutdown();
-    }
-}
-exports.IpcHost = IpcHost;
-IpcHost.noStack = false;
-/**
- * Base class for all implementations of an Ipc interface.
- *
- * Create a subclass to implement your Ipc interface. Your class should be declared like this:
- * ```ts
- * class MyHandler extends IpcHandler implements MyInterface
- * ```
- * to ensure all methods and signatures are correct.
- *
- * Then, call `MyClass.register` at startup to connect your class to your channel.
- * @public
- */
-class IpcHandler {
-    /**
-     * Register this class as the handler for methods on its channel. This static method creates a new instance
-     * that becomes the handler and is `this` when its methods are called.
-     * @returns A function that can be called to remove the handler.
-     * @note this method should only be called once per channel. If it is called multiple times, subsequent calls replace the previous ones.
-     */
-    static register() {
-        const impl = new this(); // create an instance of subclass. "as any" is necessary because base class is abstract
-        return IpcHost.handle(impl.channelName, async (_evt, funcName, ...args) => {
-            var _a;
-            try {
-                const func = impl[funcName];
-                if (typeof func !== "function")
-                    throw new core_common_1.IModelError(core_bentley_1.IModelStatus.FunctionNotFound, `Method "${impl.constructor.name}.${funcName}" not found on IpcHandler registered for channel: ${impl.channelName}`);
-                return { result: await func.call(impl, ...args) };
-            }
-            catch (err) {
-                const ret = {
-                    error: {
-                        name: (err && typeof err === "object") ? err.constructor.name : "Unknown Error",
-                        message: core_bentley_1.BentleyError.getErrorMessage(err),
-                        errorNumber: (_a = err.errorNumber) !== null && _a !== void 0 ? _a : 0,
-                    },
-                };
-                if (!IpcHost.noStack)
-                    ret.error.stack = core_bentley_1.BentleyError.getErrorStack(err);
-                return ret;
-            }
-        });
-    }
-}
-exports.IpcHandler = IpcHandler;
-/**
- * Implementation  of IpcAppFunctions
- */
-class IpcAppHandler extends IpcHandler {
-    get channelName() { return core_common_1.IpcAppChannel.Functions; }
-    async log(_timestamp, level, category, message, metaData) {
-        switch (level) {
-            case core_bentley_1.LogLevel.Error:
-                core_bentley_1.Logger.logError(category, message, metaData);
-                break;
-            case core_bentley_1.LogLevel.Info:
-                core_bentley_1.Logger.logInfo(category, message, metaData);
-                break;
-            case core_bentley_1.LogLevel.Trace:
-                core_bentley_1.Logger.logTrace(category, message, metaData);
-                break;
-            case core_bentley_1.LogLevel.Warning:
-                core_bentley_1.Logger.logWarning(category, message, metaData);
-                break;
-        }
-    }
-    async cancelTileContentRequests(tokenProps, contentIds) {
-        return (0, IModelTileRpcImpl_1.cancelTileContentRequests)(tokenProps, contentIds);
-    }
-    async cancelElementGraphicsRequests(key, requestIds) {
-        return IModelDb_1.IModelDb.findByKey(key).nativeDb.cancelElementGraphicsRequests(requestIds);
-    }
-    async openBriefcase(args) {
-        const db = await IModelDb_1.BriefcaseDb.open(args);
-        return db.toJSON();
-    }
-    async openStandalone(filePath, openMode, opts) {
-        return IModelDb_1.StandaloneDb.openFile(filePath, openMode, opts).getConnectionProps();
-    }
-    async closeIModel(key) {
-        IModelDb_1.IModelDb.findByKey(key).close();
-    }
-    async saveChanges(key, description) {
-        IModelDb_1.IModelDb.findByKey(key).saveChanges(description);
-    }
-    async hasPendingTxns(key) {
-        return IModelDb_1.IModelDb.findByKey(key).nativeDb.hasPendingTxns();
-    }
-    async isUndoPossible(key) {
-        return IModelDb_1.IModelDb.findByKey(key).nativeDb.isUndoPossible();
-    }
-    async isRedoPossible(key) {
-        return IModelDb_1.IModelDb.findByKey(key).nativeDb.isRedoPossible();
-    }
-    async getUndoString(key) {
-        return IModelDb_1.IModelDb.findByKey(key).nativeDb.getUndoString();
-    }
-    async getRedoString(key) {
-        return IModelDb_1.IModelDb.findByKey(key).nativeDb.getUndoString();
-    }
-    async pullChanges(key, toIndex) {
-        const iModelDb = IModelDb_1.BriefcaseDb.findByKey(key);
-        await iModelDb.pullChanges({ toIndex });
-        return iModelDb.changeset;
-    }
-    async pushChanges(key, description) {
-        const iModelDb = IModelDb_1.BriefcaseDb.findByKey(key);
-        await iModelDb.pushChanges({ description });
-        return iModelDb.changeset;
-    }
-    async toggleGraphicalEditingScope(key, startSession) {
-        const val = IModelDb_1.IModelDb.findByKey(key).nativeDb.setGeometricModelTrackingEnabled(startSession);
-        if (val.error)
-            throw new core_common_1.IModelError(val.error.status, "Failed to toggle graphical editing scope");
-        (0, core_bentley_1.assert)(undefined !== val.result);
-        return val.result;
-    }
-    async isGraphicalEditingSupported(key) {
-        return IModelDb_1.IModelDb.findByKey(key).nativeDb.isGeometricModelTrackingSupported();
-    }
-    async reverseTxns(key, numOperations) {
-        return IModelDb_1.IModelDb.findByKey(key).nativeDb.reverseTxns(numOperations);
-    }
-    async reverseAllTxn(key) {
-        return IModelDb_1.IModelDb.findByKey(key).nativeDb.reverseAll();
-    }
-    async reinstateTxn(key) {
-        return IModelDb_1.IModelDb.findByKey(key).nativeDb.reinstateTxn();
-    }
-    async restartTxnSession(key) {
-        return IModelDb_1.IModelDb.findByKey(key).nativeDb.restartTxnSession();
-    }
-    async queryConcurrency(pool) {
-        return IModelHost_1.IModelHost.platform.queryConcurrency(pool);
-    }
-}
+"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 NativeApp
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.throttleProgressCallback = exports.IpcHandler = exports.IpcHost = void 0;
+const core_bentley_1 = require("@itwin/core-bentley");
+const core_common_1 = require("@itwin/core-common");
+const IModelDb_1 = require("./IModelDb");
+const IModelHost_1 = require("./IModelHost");
+const IModelTileRpcImpl_1 = require("./rpc-impl/IModelTileRpcImpl");
+const CheckpointManager_1 = require("./CheckpointManager");
+/**
+ * Used by applications that have a dedicated backend. IpcHosts may send messages to their corresponding IpcApp.
+ * @note if either end terminates, the other must too.
+ * @public
+ */
+class IpcHost {
+    /** Get the implementation of the [IpcSocketBackend]($common) interface. */
+    static get ipc() { return this._ipc; } // eslint-disable-line @typescript-eslint/no-non-null-assertion
+    /** Determine whether Ipc is available for this backend. This will only be true if [[startup]] has been called on this class. */
+    static get isValid() { return undefined !== this._ipc; }
+    /**
+     * Send a message to the frontend over an Ipc channel.
+     * @param channel the name of the channel matching the name registered with [[IpcApp.addListener]].
+     * @param data The content of the message.
+     */
+    static send(channel, ...data) {
+        this.ipc.send((0, core_common_1.iTwinChannel)(channel), ...data);
+    }
+    /**
+     * Establish a handler for an Ipc channel to receive [[Frontend.invoke]] calls
+     * @param channel The name of the channel for this handler.
+     * @param handler A function that supplies the implementation for `channel`
+     * @note returns A function to call to remove the handler.
+     */
+    static handle(channel, handler) {
+        return this.ipc.handle((0, core_common_1.iTwinChannel)(channel), handler);
+    }
+    /**
+     * Establish a handler to receive messages sent via [[IpcApp.send]].
+     * @param channel The name of the channel for the messages.
+     * @param listener A function called when messages are sent over `channel`
+     * @note returns A function to call to remove the listener.
+     */
+    static addListener(channel, listener) {
+        return this.ipc.addListener((0, core_common_1.iTwinChannel)(channel), listener);
+    }
+    /**
+     * Remove a previously registered listener
+     * @param channel The name of the channel for the listener previously registered with [[addListener]]
+     * @param listener The function passed to [[addListener]]
+     */
+    static removeListener(channel, listener) {
+        this.ipc.removeListener((0, core_common_1.iTwinChannel)(channel), listener);
+    }
+    static notify(channel, briefcase, methodName, ...args) {
+        if (this.isValid)
+            return this.send(`${channel}:${briefcase.key}`, methodName, ...args);
+    }
+    /** @internal */
+    static notifyIpcFrontend(methodName, ...args) {
+        return IpcHost.send(core_common_1.IpcAppChannel.AppNotify, methodName, ...args);
+    }
+    /** @internal */
+    static notifyTxns(briefcase, methodName, ...args) {
+        this.notify(core_common_1.IpcAppChannel.Txns, briefcase, methodName, ...args);
+    }
+    /** @internal */
+    static notifyEditingScope(briefcase, methodName, ...args) {
+        this.notify(core_common_1.IpcAppChannel.EditingScope, briefcase, methodName, ...args);
+    }
+    /**
+     * Start the backend of an Ipc app.
+     * @param opt
+     * @note this method calls [[IModelHost.startup]] internally.
+     */
+    static async startup(opt) {
+        var _a, _b, _c;
+        this._ipc = (_a = opt === null || opt === void 0 ? void 0 : opt.ipcHost) === null || _a === void 0 ? void 0 : _a.socket;
+        if ((_c = (_b = opt === null || opt === void 0 ? void 0 : opt.ipcHost) === null || _b === void 0 ? void 0 : _b.exceptions) === null || _c === void 0 ? void 0 : _c.noStack)
+            this.noStack = true;
+        if (this.isValid) { // for tests, we use IpcHost but don't have a frontend
+            IpcAppHandler.register();
+        }
+        await IModelHost_1.IModelHost.startup(opt === null || opt === void 0 ? void 0 : opt.iModelHost);
+    }
+    /** Shutdown IpcHost backend. Also calls [[IModelHost.shutdown]] */
+    static async shutdown() {
+        this._ipc = undefined;
+        await IModelHost_1.IModelHost.shutdown();
+    }
+}
+exports.IpcHost = IpcHost;
+IpcHost.noStack = false;
+/**
+ * Base class for all implementations of an Ipc interface.
+ *
+ * Create a subclass to implement your Ipc interface. Your class should be declared like this:
+ * ```ts
+ * class MyHandler extends IpcHandler implements MyInterface
+ * ```
+ * to ensure all methods and signatures are correct.
+ *
+ * Then, call `MyClass.register` at startup to connect your class to your channel.
+ * @public
+ */
+class IpcHandler {
+    /**
+     * Register this class as the handler for methods on its channel. This static method creates a new instance
+     * that becomes the handler and is `this` when its methods are called.
+     * @returns A function that can be called to remove the handler.
+     * @note this method should only be called once per channel. If it is called multiple times, subsequent calls replace the previous ones.
+     */
+    static register() {
+        const impl = new this(); // create an instance of subclass. "as any" is necessary because base class is abstract
+        return IpcHost.handle(impl.channelName, async (_evt, funcName, ...args) => {
+            var _a;
+            try {
+                const func = impl[funcName];
+                if (typeof func !== "function")
+                    throw new core_common_1.IModelError(core_bentley_1.IModelStatus.FunctionNotFound, `Method "${impl.constructor.name}.${funcName}" not found on IpcHandler registered for channel: ${impl.channelName}`);
+                return { result: await func.call(impl, ...args) };
+            }
+            catch (err) {
+                const ret = {
+                    error: {
+                        name: (err && typeof err === "object") ? err.constructor.name : "Unknown Error",
+                        message: core_bentley_1.BentleyError.getErrorMessage(err),
+                        errorNumber: (_a = err.errorNumber) !== null && _a !== void 0 ? _a : 0,
+                    },
+                };
+                if (!IpcHost.noStack)
+                    ret.error.stack = core_bentley_1.BentleyError.getErrorStack(err);
+                return ret;
+            }
+        });
+    }
+}
+exports.IpcHandler = IpcHandler;
+/**
+ * Implementation  of IpcAppFunctions
+ */
+class IpcAppHandler extends IpcHandler {
+    constructor() {
+        super(...arguments);
+        this._iModelKeyToPullStatus = new Map();
+    }
+    get channelName() { return core_common_1.IpcAppChannel.Functions; }
+    async log(_timestamp, level, category, message, metaData) {
+        switch (level) {
+            case core_bentley_1.LogLevel.Error:
+                core_bentley_1.Logger.logError(category, message, metaData);
+                break;
+            case core_bentley_1.LogLevel.Info:
+                core_bentley_1.Logger.logInfo(category, message, metaData);
+                break;
+            case core_bentley_1.LogLevel.Trace:
+                core_bentley_1.Logger.logTrace(category, message, metaData);
+                break;
+            case core_bentley_1.LogLevel.Warning:
+                core_bentley_1.Logger.logWarning(category, message, metaData);
+                break;
+        }
+    }
+    async cancelTileContentRequests(tokenProps, contentIds) {
+        return (0, IModelTileRpcImpl_1.cancelTileContentRequests)(tokenProps, contentIds);
+    }
+    async cancelElementGraphicsRequests(key, requestIds) {
+        return IModelDb_1.IModelDb.findByKey(key).nativeDb.cancelElementGraphicsRequests(requestIds);
+    }
+    async openBriefcase(args) {
+        const db = await IModelDb_1.BriefcaseDb.open(args);
+        return db.toJSON();
+    }
+    async openStandalone(filePath, openMode, opts) {
+        return IModelDb_1.StandaloneDb.openFile(filePath, openMode, opts).getConnectionProps();
+    }
+    async closeIModel(key) {
+        IModelDb_1.IModelDb.findByKey(key).close();
+    }
+    async saveChanges(key, description) {
+        IModelDb_1.IModelDb.findByKey(key).saveChanges(description);
+    }
+    async hasPendingTxns(key) {
+        return IModelDb_1.IModelDb.findByKey(key).nativeDb.hasPendingTxns();
+    }
+    async isUndoPossible(key) {
+        return IModelDb_1.IModelDb.findByKey(key).nativeDb.isUndoPossible();
+    }
+    async isRedoPossible(key) {
+        return IModelDb_1.IModelDb.findByKey(key).nativeDb.isRedoPossible();
+    }
+    async getUndoString(key) {
+        return IModelDb_1.IModelDb.findByKey(key).nativeDb.getUndoString();
+    }
+    async getRedoString(key) {
+        return IModelDb_1.IModelDb.findByKey(key).nativeDb.getUndoString();
+    }
+    async pullChanges(key, toIndex, options) {
+        const iModelDb = IModelDb_1.BriefcaseDb.findByKey(key);
+        this._iModelKeyToPullStatus.set(key, CheckpointManager_1.ProgressStatus.Continue);
+        const checkAbort = () => { var _a; return (_a = this._iModelKeyToPullStatus.get(key)) !== null && _a !== void 0 ? _a : CheckpointManager_1.ProgressStatus.Continue; };
+        let onProgress;
+        if (options === null || options === void 0 ? void 0 : options.reportProgress) {
+            const progressCallback = (loaded, total) => {
+                IpcHost.send((0, core_common_1.getPullChangesIpcChannel)(iModelDb.iModelId), { loaded, total });
+                return checkAbort();
+            };
+            onProgress = throttleProgressCallback(progressCallback, checkAbort, options === null || options === void 0 ? void 0 : options.progressInterval);
+        }
+        else if (options === null || options === void 0 ? void 0 : options.enableCancellation) {
+            onProgress = checkAbort;
+        }
+        try {
+            await iModelDb.pullChanges({ toIndex, onProgress });
+        }
+        finally {
+            this._iModelKeyToPullStatus.delete(key);
+        }
+        return iModelDb.changeset;
+    }
+    async cancelPullChangesRequest(key) {
+        this._iModelKeyToPullStatus.set(key, CheckpointManager_1.ProgressStatus.Abort);
+    }
+    async pushChanges(key, description) {
+        const iModelDb = IModelDb_1.BriefcaseDb.findByKey(key);
+        await iModelDb.pushChanges({ description });
+        return iModelDb.changeset;
+    }
+    async toggleGraphicalEditingScope(key, startSession) {
+        const val = IModelDb_1.IModelDb.findByKey(key).nativeDb.setGeometricModelTrackingEnabled(startSession);
+        if (val.error)
+            throw new core_common_1.IModelError(val.error.status, "Failed to toggle graphical editing scope");
+        (0, core_bentley_1.assert)(undefined !== val.result);
+        return val.result;
+    }
+    async isGraphicalEditingSupported(key) {
+        return IModelDb_1.IModelDb.findByKey(key).nativeDb.isGeometricModelTrackingSupported();
+    }
+    async reverseTxns(key, numOperations) {
+        return IModelDb_1.IModelDb.findByKey(key).nativeDb.reverseTxns(numOperations);
+    }
+    async reverseAllTxn(key) {
+        return IModelDb_1.IModelDb.findByKey(key).nativeDb.reverseAll();
+    }
+    async reinstateTxn(key) {
+        return IModelDb_1.IModelDb.findByKey(key).nativeDb.reinstateTxn();
+    }
+    async restartTxnSession(key) {
+        return IModelDb_1.IModelDb.findByKey(key).nativeDb.restartTxnSession();
+    }
+    async queryConcurrency(pool) {
+        return IModelHost_1.IModelHost.platform.queryConcurrency(pool);
+    }
+}
+/**
+ * Prevents progress callback being called more frequently when provided interval.
+ * @internal
+ */
+function throttleProgressCallback(func, checkAbort, progressInterval) {
+    const interval = progressInterval !== null && progressInterval !== void 0 ? progressInterval : 250; // by default, only send progress events every 250 milliseconds
+    let nextTime = Date.now() + interval;
+    const progressCallback = (loaded, total) => {
+        const now = Date.now();
+        if (loaded >= total || now >= nextTime) {
+            nextTime = now + interval;
+            return func(loaded, total);
+        }
+        return checkAbort();
+    };
+    return progressCallback;
+}
+exports.throttleProgressCallback = throttleProgressCallback;
 //# sourceMappingURL=IpcHost.js.map

package/lib/cjs/IpcHost.js.map

@@ -1 +1 @@
-{"version":3,"file":"IpcHost.js","sourceRoot":"","sources":["../../src/IpcHost.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 NativeApp\n */\n\nimport { assert, BentleyError, IModelStatus, Logger, LogLevel, OpenMode } from \"@itwin/core-bentley\";\nimport {\n  ChangesetIndex, ChangesetIndexAndId, EditingScopeNotifications, IModelConnectionProps, IModelError, IModelRpcProps, IpcAppChannel, IpcAppFunctions,\n  IpcAppNotifications, IpcInvokeReturn, IpcListener, IpcSocketBackend, iTwinChannel, OpenBriefcaseProps, RemoveFunction, StandaloneOpenOptions,\n  TileTreeContentIds, TxnNotifications,\n} from \"@itwin/core-common\";\nimport { IModelJsNative } from \"@bentley/imodeljs-native\";\nimport { BriefcaseDb, IModelDb, StandaloneDb } from \"./IModelDb\";\nimport { IModelHost, IModelHostOptions } from \"./IModelHost\";\nimport { cancelTileContentRequests } from \"./rpc-impl/IModelTileRpcImpl\";\n\n/**\n  * Options for [[IpcHost.startup]]\n  * @public\n  */\nexport interface IpcHostOpts {\n  iModelHost?: IModelHostOptions;\n  ipcHost?: {\n    /** The Ipc socket to use for communications with frontend. Allows undefined only for headless tests. */\n    socket?: IpcSocketBackend;\n\n    /** don't send stack information on exceptions */\n    exceptions?: {\n      noStack?: boolean;\n    };\n  };\n}\n\n/**\n * Used by applications that have a dedicated backend. IpcHosts may send messages to their corresponding IpcApp.\n * @note if either end terminates, the other must too.\n * @public\n */\nexport class IpcHost {\n  public static noStack = false;\n  private static _ipc: IpcSocketBackend | undefined;\n  /** Get the implementation of the [IpcSocketBackend]($common) interface. */\n  private static get ipc(): IpcSocketBackend { return this._ipc!; } // eslint-disable-line @typescript-eslint/no-non-null-assertion\n  /** Determine whether Ipc is available for this backend. This will only be true if [[startup]] has been called on this class. */\n  public static get isValid(): boolean { return undefined !== this._ipc; }\n\n  /**\n   * Send a message to the frontend over an Ipc channel.\n   * @param channel the name of the channel matching the name registered with [[IpcApp.addListener]].\n   * @param data The content of the message.\n   */\n  public static send(channel: string, ...data: any[]): void {\n    this.ipc.send(iTwinChannel(channel), ...data);\n  }\n\n  /**\n   * Establish a handler for an Ipc channel to receive [[Frontend.invoke]] calls\n   * @param channel The name of the channel for this handler.\n   * @param handler A function that supplies the implementation for `channel`\n   * @note returns A function to call to remove the handler.\n   */\n  public static handle(channel: string, handler: (...args: any[]) => Promise<any>): RemoveFunction {\n    return this.ipc.handle(iTwinChannel(channel), handler);\n  }\n  /**\n   * Establish a handler to receive messages sent via [[IpcApp.send]].\n   * @param channel The name of the channel for the messages.\n   * @param listener A function called when messages are sent over `channel`\n   * @note returns A function to call to remove the listener.\n   */\n  public static addListener(channel: string, listener: IpcListener): RemoveFunction {\n    return this.ipc.addListener(iTwinChannel(channel), listener);\n  }\n  /**\n   * Remove a previously registered listener\n   * @param channel The name of the channel for the listener previously registered with [[addListener]]\n   * @param listener The function passed to [[addListener]]\n   */\n  public static removeListener(channel: string, listener: IpcListener): void {\n    this.ipc.removeListener(iTwinChannel(channel), listener);\n  }\n\n  private static notify(channel: string, briefcase: BriefcaseDb | StandaloneDb, methodName: string, ...args: any[]) {\n    if (this.isValid)\n      return this.send(`${channel}:${briefcase.key}`, methodName, ...args);\n  }\n\n  /** @internal */\n  public static notifyIpcFrontend<T extends keyof IpcAppNotifications>(methodName: T, ...args: Parameters<IpcAppNotifications[T]>) {\n    return IpcHost.send(IpcAppChannel.AppNotify, methodName, ...args);\n  }\n\n  /** @internal */\n  public static notifyTxns<T extends keyof TxnNotifications>(briefcase: BriefcaseDb | StandaloneDb, methodName: T, ...args: Parameters<TxnNotifications[T]>) {\n    this.notify(IpcAppChannel.Txns, briefcase, methodName, ...args);\n  }\n\n  /** @internal */\n  public static notifyEditingScope<T extends keyof EditingScopeNotifications>(briefcase: BriefcaseDb | StandaloneDb, methodName: T, ...args: Parameters<EditingScopeNotifications[T]>) {\n    this.notify(IpcAppChannel.EditingScope, briefcase, methodName, ...args);\n  }\n\n  /**\n   * Start the backend of an Ipc app.\n   * @param opt\n   * @note this method calls [[IModelHost.startup]] internally.\n   */\n  public static async startup(opt?: IpcHostOpts): Promise<void> {\n    this._ipc = opt?.ipcHost?.socket;\n    if (opt?.ipcHost?.exceptions?.noStack)\n      this.noStack = true;\n\n    if (this.isValid) { // for tests, we use IpcHost but don't have a frontend\n      IpcAppHandler.register();\n    }\n\n    await IModelHost.startup(opt?.iModelHost);\n  }\n\n  /** Shutdown IpcHost backend. Also calls [[IModelHost.shutdown]] */\n  public static async shutdown(): Promise<void> {\n    this._ipc = undefined;\n    await IModelHost.shutdown();\n  }\n}\n\n/**\n * Base class for all implementations of an Ipc interface.\n *\n * Create a subclass to implement your Ipc interface. Your class should be declared like this:\n * ```ts\n * class MyHandler extends IpcHandler implements MyInterface\n * ```\n * to ensure all methods and signatures are correct.\n *\n * Then, call `MyClass.register` at startup to connect your class to your channel.\n * @public\n */\nexport abstract class IpcHandler {\n  /** All subclasses must implement this method to specify their channel name. */\n  public abstract get channelName(): string;\n\n  /**\n   * Register this class as the handler for methods on its channel. This static method creates a new instance\n   * that becomes the handler and is `this` when its methods are called.\n   * @returns A function that can be called to remove the handler.\n   * @note this method should only be called once per channel. If it is called multiple times, subsequent calls replace the previous ones.\n   */\n  public static register(): RemoveFunction {\n    const impl = new (this as any)() as IpcHandler; // create an instance of subclass. \"as any\" is necessary because base class is abstract\n    return IpcHost.handle(impl.channelName, async (_evt: Event, funcName: string, ...args: any[]): Promise<IpcInvokeReturn> => {\n      try {\n        const func = (impl as any)[funcName];\n        if (typeof func !== \"function\")\n          throw new IModelError(IModelStatus.FunctionNotFound, `Method \"${impl.constructor.name}.${funcName}\" not found on IpcHandler registered for channel: ${impl.channelName}`);\n\n        return { result: await func.call(impl, ...args) };\n      } catch (err: any) {\n        const ret: IpcInvokeReturn = {\n          error: {\n            name: (err && typeof err === \"object\") ? err.constructor.name : \"Unknown Error\",\n            message: BentleyError.getErrorMessage(err),\n            errorNumber: err.errorNumber ?? 0,\n          },\n        };\n        if (!IpcHost.noStack)\n          ret.error.stack = BentleyError.getErrorStack(err);\n        return ret;\n      }\n    });\n  }\n}\n\n/**\n * Implementation  of IpcAppFunctions\n */\nclass IpcAppHandler extends IpcHandler implements IpcAppFunctions {\n  public get channelName() { return IpcAppChannel.Functions; }\n\n  public async log(_timestamp: number, level: LogLevel, category: string, message: string, metaData?: any): Promise<void> {\n    switch (level) {\n      case LogLevel.Error:\n        Logger.logError(category, message, metaData);\n        break;\n      case LogLevel.Info:\n        Logger.logInfo(category, message, metaData);\n        break;\n      case LogLevel.Trace:\n        Logger.logTrace(category, message, metaData);\n        break;\n      case LogLevel.Warning:\n        Logger.logWarning(category, message, metaData);\n        break;\n    }\n  }\n\n  public async cancelTileContentRequests(tokenProps: IModelRpcProps, contentIds: TileTreeContentIds[]): Promise<void> {\n    return cancelTileContentRequests(tokenProps, contentIds);\n  }\n  public async cancelElementGraphicsRequests(key: string, requestIds: string[]): Promise<void> {\n    return IModelDb.findByKey(key).nativeDb.cancelElementGraphicsRequests(requestIds);\n  }\n  public async openBriefcase(args: OpenBriefcaseProps): Promise<IModelConnectionProps> {\n    const db = await BriefcaseDb.open(args);\n    return db.toJSON();\n  }\n  public async openStandalone(filePath: string, openMode: OpenMode, opts?: StandaloneOpenOptions): Promise<IModelConnectionProps> {\n    return StandaloneDb.openFile(filePath, openMode, opts).getConnectionProps();\n  }\n  public async closeIModel(key: string): Promise<void> {\n    IModelDb.findByKey(key).close();\n  }\n  public async saveChanges(key: string, description?: string): Promise<void> {\n    IModelDb.findByKey(key).saveChanges(description);\n  }\n  public async hasPendingTxns(key: string): Promise<boolean> {\n    return IModelDb.findByKey(key).nativeDb.hasPendingTxns();\n  }\n\n  public async isUndoPossible(key: string): Promise<boolean> {\n    return IModelDb.findByKey(key).nativeDb.isUndoPossible();\n  }\n  public async isRedoPossible(key: string): Promise<boolean> {\n    return IModelDb.findByKey(key).nativeDb.isRedoPossible();\n  }\n  public async getUndoString(key: string): Promise<string> {\n    return IModelDb.findByKey(key).nativeDb.getUndoString();\n  }\n  public async getRedoString(key: string): Promise<string> {\n    return IModelDb.findByKey(key).nativeDb.getUndoString();\n  }\n\n  public async pullChanges(key: string, toIndex?: ChangesetIndex): Promise<ChangesetIndexAndId> {\n    const iModelDb = BriefcaseDb.findByKey(key);\n    await iModelDb.pullChanges({ toIndex });\n    return iModelDb.changeset as ChangesetIndexAndId;\n  }\n  public async pushChanges(key: string, description: string): Promise<ChangesetIndexAndId> {\n    const iModelDb = BriefcaseDb.findByKey(key);\n    await iModelDb.pushChanges({ description });\n    return iModelDb.changeset as ChangesetIndexAndId;\n  }\n\n  public async toggleGraphicalEditingScope(key: string, startSession: boolean): Promise<boolean> {\n    const val: IModelJsNative.ErrorStatusOrResult<any, boolean> = IModelDb.findByKey(key).nativeDb.setGeometricModelTrackingEnabled(startSession);\n    if (val.error)\n      throw new IModelError(val.error.status, \"Failed to toggle graphical editing scope\");\n    assert(undefined !== val.result);\n    return val.result;\n  }\n  public async isGraphicalEditingSupported(key: string): Promise<boolean> {\n    return IModelDb.findByKey(key).nativeDb.isGeometricModelTrackingSupported();\n  }\n\n  public async reverseTxns(key: string, numOperations: number): Promise<IModelStatus> {\n    return IModelDb.findByKey(key).nativeDb.reverseTxns(numOperations);\n  }\n  public async reverseAllTxn(key: string): Promise<IModelStatus> {\n    return IModelDb.findByKey(key).nativeDb.reverseAll();\n  }\n  public async reinstateTxn(key: string): Promise<IModelStatus> {\n    return IModelDb.findByKey(key).nativeDb.reinstateTxn();\n  }\n  public async restartTxnSession(key: string): Promise<void> {\n    return IModelDb.findByKey(key).nativeDb.restartTxnSession();\n  }\n\n  public async queryConcurrency(pool: \"io\" | \"cpu\"): Promise<number> {\n    return IModelHost.platform.queryConcurrency(pool);\n  }\n}\n"]}
+{"version":3,"file":"IpcHost.js","sourceRoot":"","sources":["../../src/IpcHost.ts"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\r\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\r\n* See LICENSE.md in the project root for license terms and full copyright notice.\r\n*--------------------------------------------------------------------------------------------*/\r\n/** @packageDocumentation\r\n * @module NativeApp\r\n */\r\n\r\nimport { assert, BentleyError, IModelStatus, Logger, LogLevel, OpenMode } from \"@itwin/core-bentley\";\r\nimport {\r\n  ChangesetIndex, ChangesetIndexAndId, EditingScopeNotifications, getPullChangesIpcChannel, IModelConnectionProps, IModelError, IModelRpcProps,\r\n  IpcAppChannel, IpcAppFunctions, IpcAppNotifications, IpcInvokeReturn, IpcListener, IpcSocketBackend, iTwinChannel, OpenBriefcaseProps,\r\n  PullChangesOptions, RemoveFunction, StandaloneOpenOptions, TileTreeContentIds, TxnNotifications,\r\n} from \"@itwin/core-common\";\r\nimport { IModelJsNative } from \"@bentley/imodeljs-native\";\r\nimport { BriefcaseDb, IModelDb, StandaloneDb } from \"./IModelDb\";\r\nimport { IModelHost, IModelHostOptions } from \"./IModelHost\";\r\nimport { cancelTileContentRequests } from \"./rpc-impl/IModelTileRpcImpl\";\r\nimport { ProgressFunction, ProgressStatus } from \"./CheckpointManager\";\r\n\r\n/**\r\n  * Options for [[IpcHost.startup]]\r\n  * @public\r\n  */\r\nexport interface IpcHostOpts {\r\n  iModelHost?: IModelHostOptions;\r\n  ipcHost?: {\r\n    /** The Ipc socket to use for communications with frontend. Allows undefined only for headless tests. */\r\n    socket?: IpcSocketBackend;\r\n\r\n    /** don't send stack information on exceptions */\r\n    exceptions?: {\r\n      noStack?: boolean;\r\n    };\r\n  };\r\n}\r\n\r\n/**\r\n * Used by applications that have a dedicated backend. IpcHosts may send messages to their corresponding IpcApp.\r\n * @note if either end terminates, the other must too.\r\n * @public\r\n */\r\nexport class IpcHost {\r\n  public static noStack = false;\r\n  private static _ipc: IpcSocketBackend | undefined;\r\n  /** Get the implementation of the [IpcSocketBackend]($common) interface. */\r\n  private static get ipc(): IpcSocketBackend { return this._ipc!; } // eslint-disable-line @typescript-eslint/no-non-null-assertion\r\n  /** Determine whether Ipc is available for this backend. This will only be true if [[startup]] has been called on this class. */\r\n  public static get isValid(): boolean { return undefined !== this._ipc; }\r\n\r\n  /**\r\n   * Send a message to the frontend over an Ipc channel.\r\n   * @param channel the name of the channel matching the name registered with [[IpcApp.addListener]].\r\n   * @param data The content of the message.\r\n   */\r\n  public static send(channel: string, ...data: any[]): void {\r\n    this.ipc.send(iTwinChannel(channel), ...data);\r\n  }\r\n\r\n  /**\r\n   * Establish a handler for an Ipc channel to receive [[Frontend.invoke]] calls\r\n   * @param channel The name of the channel for this handler.\r\n   * @param handler A function that supplies the implementation for `channel`\r\n   * @note returns A function to call to remove the handler.\r\n   */\r\n  public static handle(channel: string, handler: (...args: any[]) => Promise<any>): RemoveFunction {\r\n    return this.ipc.handle(iTwinChannel(channel), handler);\r\n  }\r\n  /**\r\n   * Establish a handler to receive messages sent via [[IpcApp.send]].\r\n   * @param channel The name of the channel for the messages.\r\n   * @param listener A function called when messages are sent over `channel`\r\n   * @note returns A function to call to remove the listener.\r\n   */\r\n  public static addListener(channel: string, listener: IpcListener): RemoveFunction {\r\n    return this.ipc.addListener(iTwinChannel(channel), listener);\r\n  }\r\n  /**\r\n   * Remove a previously registered listener\r\n   * @param channel The name of the channel for the listener previously registered with [[addListener]]\r\n   * @param listener The function passed to [[addListener]]\r\n   */\r\n  public static removeListener(channel: string, listener: IpcListener): void {\r\n    this.ipc.removeListener(iTwinChannel(channel), listener);\r\n  }\r\n\r\n  private static notify(channel: string, briefcase: BriefcaseDb | StandaloneDb, methodName: string, ...args: any[]) {\r\n    if (this.isValid)\r\n      return this.send(`${channel}:${briefcase.key}`, methodName, ...args);\r\n  }\r\n\r\n  /** @internal */\r\n  public static notifyIpcFrontend<T extends keyof IpcAppNotifications>(methodName: T, ...args: Parameters<IpcAppNotifications[T]>) {\r\n    return IpcHost.send(IpcAppChannel.AppNotify, methodName, ...args);\r\n  }\r\n\r\n  /** @internal */\r\n  public static notifyTxns<T extends keyof TxnNotifications>(briefcase: BriefcaseDb | StandaloneDb, methodName: T, ...args: Parameters<TxnNotifications[T]>) {\r\n    this.notify(IpcAppChannel.Txns, briefcase, methodName, ...args);\r\n  }\r\n\r\n  /** @internal */\r\n  public static notifyEditingScope<T extends keyof EditingScopeNotifications>(briefcase: BriefcaseDb | StandaloneDb, methodName: T, ...args: Parameters<EditingScopeNotifications[T]>) {\r\n    this.notify(IpcAppChannel.EditingScope, briefcase, methodName, ...args);\r\n  }\r\n\r\n  /**\r\n   * Start the backend of an Ipc app.\r\n   * @param opt\r\n   * @note this method calls [[IModelHost.startup]] internally.\r\n   */\r\n  public static async startup(opt?: IpcHostOpts): Promise<void> {\r\n    this._ipc = opt?.ipcHost?.socket;\r\n    if (opt?.ipcHost?.exceptions?.noStack)\r\n      this.noStack = true;\r\n\r\n    if (this.isValid) { // for tests, we use IpcHost but don't have a frontend\r\n      IpcAppHandler.register();\r\n    }\r\n\r\n    await IModelHost.startup(opt?.iModelHost);\r\n  }\r\n\r\n  /** Shutdown IpcHost backend. Also calls [[IModelHost.shutdown]] */\r\n  public static async shutdown(): Promise<void> {\r\n    this._ipc = undefined;\r\n    await IModelHost.shutdown();\r\n  }\r\n}\r\n\r\n/**\r\n * Base class for all implementations of an Ipc interface.\r\n *\r\n * Create a subclass to implement your Ipc interface. Your class should be declared like this:\r\n * ```ts\r\n * class MyHandler extends IpcHandler implements MyInterface\r\n * ```\r\n * to ensure all methods and signatures are correct.\r\n *\r\n * Then, call `MyClass.register` at startup to connect your class to your channel.\r\n * @public\r\n */\r\nexport abstract class IpcHandler {\r\n  /** All subclasses must implement this method to specify their channel name. */\r\n  public abstract get channelName(): string;\r\n\r\n  /**\r\n   * Register this class as the handler for methods on its channel. This static method creates a new instance\r\n   * that becomes the handler and is `this` when its methods are called.\r\n   * @returns A function that can be called to remove the handler.\r\n   * @note this method should only be called once per channel. If it is called multiple times, subsequent calls replace the previous ones.\r\n   */\r\n  public static register(): RemoveFunction {\r\n    const impl = new (this as any)() as IpcHandler; // create an instance of subclass. \"as any\" is necessary because base class is abstract\r\n    return IpcHost.handle(impl.channelName, async (_evt: Event, funcName: string, ...args: any[]): Promise<IpcInvokeReturn> => {\r\n      try {\r\n        const func = (impl as any)[funcName];\r\n        if (typeof func !== \"function\")\r\n          throw new IModelError(IModelStatus.FunctionNotFound, `Method \"${impl.constructor.name}.${funcName}\" not found on IpcHandler registered for channel: ${impl.channelName}`);\r\n\r\n        return { result: await func.call(impl, ...args) };\r\n      } catch (err: any) {\r\n        const ret: IpcInvokeReturn = {\r\n          error: {\r\n            name: (err && typeof err === \"object\") ? err.constructor.name : \"Unknown Error\",\r\n            message: BentleyError.getErrorMessage(err),\r\n            errorNumber: err.errorNumber ?? 0,\r\n          },\r\n        };\r\n        if (!IpcHost.noStack)\r\n          ret.error.stack = BentleyError.getErrorStack(err);\r\n        return ret;\r\n      }\r\n    });\r\n  }\r\n}\r\n\r\n/**\r\n * Implementation  of IpcAppFunctions\r\n */\r\nclass IpcAppHandler extends IpcHandler implements IpcAppFunctions {\r\n  public get channelName() { return IpcAppChannel.Functions; }\r\n\r\n  private _iModelKeyToPullStatus = new Map<string, ProgressStatus>();\r\n\r\n  public async log(_timestamp: number, level: LogLevel, category: string, message: string, metaData?: any): Promise<void> {\r\n    switch (level) {\r\n      case LogLevel.Error:\r\n        Logger.logError(category, message, metaData);\r\n        break;\r\n      case LogLevel.Info:\r\n        Logger.logInfo(category, message, metaData);\r\n        break;\r\n      case LogLevel.Trace:\r\n        Logger.logTrace(category, message, metaData);\r\n        break;\r\n      case LogLevel.Warning:\r\n        Logger.logWarning(category, message, metaData);\r\n        break;\r\n    }\r\n  }\r\n\r\n  public async cancelTileContentRequests(tokenProps: IModelRpcProps, contentIds: TileTreeContentIds[]): Promise<void> {\r\n    return cancelTileContentRequests(tokenProps, contentIds);\r\n  }\r\n  public async cancelElementGraphicsRequests(key: string, requestIds: string[]): Promise<void> {\r\n    return IModelDb.findByKey(key).nativeDb.cancelElementGraphicsRequests(requestIds);\r\n  }\r\n  public async openBriefcase(args: OpenBriefcaseProps): Promise<IModelConnectionProps> {\r\n    const db = await BriefcaseDb.open(args);\r\n    return db.toJSON();\r\n  }\r\n  public async openStandalone(filePath: string, openMode: OpenMode, opts?: StandaloneOpenOptions): Promise<IModelConnectionProps> {\r\n    return StandaloneDb.openFile(filePath, openMode, opts).getConnectionProps();\r\n  }\r\n  public async closeIModel(key: string): Promise<void> {\r\n    IModelDb.findByKey(key).close();\r\n  }\r\n  public async saveChanges(key: string, description?: string): Promise<void> {\r\n    IModelDb.findByKey(key).saveChanges(description);\r\n  }\r\n  public async hasPendingTxns(key: string): Promise<boolean> {\r\n    return IModelDb.findByKey(key).nativeDb.hasPendingTxns();\r\n  }\r\n\r\n  public async isUndoPossible(key: string): Promise<boolean> {\r\n    return IModelDb.findByKey(key).nativeDb.isUndoPossible();\r\n  }\r\n  public async isRedoPossible(key: string): Promise<boolean> {\r\n    return IModelDb.findByKey(key).nativeDb.isRedoPossible();\r\n  }\r\n  public async getUndoString(key: string): Promise<string> {\r\n    return IModelDb.findByKey(key).nativeDb.getUndoString();\r\n  }\r\n  public async getRedoString(key: string): Promise<string> {\r\n    return IModelDb.findByKey(key).nativeDb.getUndoString();\r\n  }\r\n\r\n  public async pullChanges(key: string, toIndex?: ChangesetIndex, options?: PullChangesOptions): Promise<ChangesetIndexAndId> {\r\n    const iModelDb = BriefcaseDb.findByKey(key);\r\n\r\n    this._iModelKeyToPullStatus.set(key, ProgressStatus.Continue);\r\n    const checkAbort = () => this._iModelKeyToPullStatus.get(key) ?? ProgressStatus.Continue;\r\n\r\n    let onProgress: ProgressFunction | undefined;\r\n    if (options?.reportProgress) {\r\n      const progressCallback: ProgressFunction = (loaded, total) => {\r\n        IpcHost.send(getPullChangesIpcChannel(iModelDb.iModelId), { loaded, total });\r\n        return checkAbort();\r\n      };\r\n      onProgress = throttleProgressCallback(progressCallback, checkAbort, options?.progressInterval);\r\n    } else if (options?.enableCancellation) {\r\n      onProgress = checkAbort;\r\n    }\r\n\r\n    try {\r\n      await iModelDb.pullChanges({ toIndex, onProgress });\r\n    } finally {\r\n      this._iModelKeyToPullStatus.delete(key);\r\n    }\r\n\r\n    return iModelDb.changeset as ChangesetIndexAndId;\r\n  }\r\n  public async cancelPullChangesRequest(key: string): Promise<void> {\r\n    this._iModelKeyToPullStatus.set(key, ProgressStatus.Abort);\r\n  }\r\n\r\n  public async pushChanges(key: string, description: string): Promise<ChangesetIndexAndId> {\r\n    const iModelDb = BriefcaseDb.findByKey(key);\r\n    await iModelDb.pushChanges({ description });\r\n    return iModelDb.changeset as ChangesetIndexAndId;\r\n  }\r\n\r\n  public async toggleGraphicalEditingScope(key: string, startSession: boolean): Promise<boolean> {\r\n    const val: IModelJsNative.ErrorStatusOrResult<any, boolean> = IModelDb.findByKey(key).nativeDb.setGeometricModelTrackingEnabled(startSession);\r\n    if (val.error)\r\n      throw new IModelError(val.error.status, \"Failed to toggle graphical editing scope\");\r\n    assert(undefined !== val.result);\r\n    return val.result;\r\n  }\r\n  public async isGraphicalEditingSupported(key: string): Promise<boolean> {\r\n    return IModelDb.findByKey(key).nativeDb.isGeometricModelTrackingSupported();\r\n  }\r\n\r\n  public async reverseTxns(key: string, numOperations: number): Promise<IModelStatus> {\r\n    return IModelDb.findByKey(key).nativeDb.reverseTxns(numOperations);\r\n  }\r\n  public async reverseAllTxn(key: string): Promise<IModelStatus> {\r\n    return IModelDb.findByKey(key).nativeDb.reverseAll();\r\n  }\r\n  public async reinstateTxn(key: string): Promise<IModelStatus> {\r\n    return IModelDb.findByKey(key).nativeDb.reinstateTxn();\r\n  }\r\n  public async restartTxnSession(key: string): Promise<void> {\r\n    return IModelDb.findByKey(key).nativeDb.restartTxnSession();\r\n  }\r\n\r\n  public async queryConcurrency(pool: \"io\" | \"cpu\"): Promise<number> {\r\n    return IModelHost.platform.queryConcurrency(pool);\r\n  }\r\n}\r\n\r\n/**\r\n * Prevents progress callback being called more frequently when provided interval.\r\n * @internal\r\n */\r\nexport function throttleProgressCallback(func: ProgressFunction, checkAbort: () => ProgressStatus, progressInterval?: number): ProgressFunction {\r\n  const interval = progressInterval ?? 250; // by default, only send progress events every 250 milliseconds\r\n  let nextTime = Date.now() + interval;\r\n  const progressCallback: ProgressFunction = (loaded, total) => {\r\n    const now = Date.now();\r\n    if (loaded >= total || now >= nextTime) {\r\n      nextTime = now + interval;\r\n      return func(loaded, total);\r\n    }\r\n    return checkAbort();\r\n  };\r\n\r\n  return progressCallback;\r\n}\r\n"]}