@itwin/core-backend 5.14.0-dev.7 → 5.14.0-dev.9

package/lib/esm/IpcHost.d.ts.map

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

package/lib/esm/IpcHost.js

@@ -6,7 +6,7 @@
  * @module NativeApp
  */
 import { assert, Logger, LogLevel } from "@itwin/core-bentley";
-import { createIpcDispatcher, createIpcProxy, getPullChangesIpcChannel, IModelError, IModelNotFoundResponse, ipcAppChannels, iTwinChannel, unwrapIpcInvokeReturn, } from "@itwin/core-common";
+import { createIpcDispatcher, createIpcProxy, getPullChangesIpcChannel, getPushChangesIpcChannel, IModelError, IModelNotFoundResponse, ipcAppChannels, iTwinChannel, unwrapIpcInvokeReturn, } from "@itwin/core-common";
 import { ProgressStatus } from "./CheckpointManager";
 import { BriefcaseDb, IModelDb, SnapshotDb, StandaloneDb } from "./IModelDb";
 import { IModelHost } from "./IModelHost";
@@ -191,7 +191,10 @@ export class IpcHandler {
  */
 class IpcAppHandler extends IpcHandler {
     get channelName() { return ipcAppChannels.functions; }
+    /** Tracks cancellation of the changeset download initiated by [[pullChanges]]. */
     _iModelKeyToPullStatus = new Map();
+    /** Tracks cancellation of the changeset download that [[pushChanges]] performs before uploading. */
+    _iModelKeyToPushStatus = new Map();
     async log(_timestamp, level, category, message, metaData) {
         switch (level) {
             case LogLevel.Error:
@@ -257,37 +260,69 @@ class IpcAppHandler extends IpcHandler {
     async getRedoString(key) {
         return IModelDb.findByKey(key)[_nativeDb].getRedoString();
     }
-    async pullChanges(key, toIndex, options) {
-        const iModelDb = BriefcaseDb.findByKey(key);
-        this._iModelKeyToPullStatus.set(key, ProgressStatus.Continue);
-        const checkAbort = () => this._iModelKeyToPullStatus.get(key) ?? ProgressStatus.Continue;
-        let onProgress;
-        if (options?.reportProgress) {
+    /** Creates the [[ProgressFunction]] used to relay changeset download progress to the frontend over `channel`, and to observe
+     * cancellation requests recorded in `statusMap`. Shared by [[pullChanges]] and the merge that [[pushChanges]] performs before uploading.
+     * @returns the progress function, and a function to stop tracking the operation.
+     */
+    createDownloadProgressHandler(args) {
+        const { key, channel, statusMap, reportProgress, progressInterval, enableCancellation } = args;
+        statusMap.set(key, ProgressStatus.Continue);
+        const checkAbort = () => statusMap.get(key) ?? ProgressStatus.Continue;
+        const done = () => statusMap.delete(key);
+        if (reportProgress) {
             const progressCallback = (loaded, total) => {
-                IpcHost.send(getPullChangesIpcChannel(iModelDb.iModelId), { loaded, total });
+                IpcHost.send(channel, { loaded, total });
                 return checkAbort();
             };
-            onProgress = throttleProgressCallback(progressCallback, checkAbort, options?.progressInterval);
-        }
-        else if (options?.enableCancellation) {
-            onProgress = checkAbort;
+            const throttledProgressCallback = throttleProgressCallback(progressCallback, checkAbort, progressInterval);
+            return { onDownloadProgress: throttledProgressCallback, done };
         }
+        if (enableCancellation)
+            return { onDownloadProgress: checkAbort, done };
+        return { onDownloadProgress: undefined, done };
+    }
+    async pullChanges(key, toIndex, options) {
+        const iModelDb = BriefcaseDb.findByKey(key);
+        const { onDownloadProgress, done } = this.createDownloadProgressHandler({
+            key,
+            channel: getPullChangesIpcChannel(key),
+            statusMap: this._iModelKeyToPullStatus,
+            reportProgress: options?.reportProgress,
+            progressInterval: options?.progressInterval,
+            enableCancellation: options?.enableCancellation,
+        });
         try {
-            await iModelDb.pullChanges({ toIndex, onProgress });
+            await iModelDb.pullChanges({ toIndex, onProgress: onDownloadProgress });
         }
         finally {
-            this._iModelKeyToPullStatus.delete(key);
+            done();
         }
         return iModelDb.changeset;
     }
     async cancelPullChangesRequest(key) {
         this._iModelKeyToPullStatus.set(key, ProgressStatus.Abort);
     }
-    async pushChanges(key, description) {
+    async pushChanges(key, description, options) {
         const iModelDb = BriefcaseDb.findByKey(key);
-        await iModelDb.pushChanges({ description });
+        const { onDownloadProgress, done } = this.createDownloadProgressHandler({
+            key,
+            channel: getPushChangesIpcChannel(key),
+            statusMap: this._iModelKeyToPushStatus,
+            reportProgress: options?.reportDownloadProgress,
+            progressInterval: options?.downloadProgressInterval,
+            enableCancellation: options?.enableCancellation,
+        });
+        try {
+            await iModelDb.pushChanges({ description, onDownloadProgress });
+        }
+        finally {
+            done();
+        }
         return iModelDb.changeset;
     }
+    async cancelPushChangesRequest(key) {
+        this._iModelKeyToPushStatus.set(key, ProgressStatus.Abort);
+    }
     async toggleGraphicalEditingScope(key, startSession) {
         const val = IModelDb.findByKey(key)[_nativeDb].setGeometricModelTrackingEnabled(startSession);
         if (val.error)
@@ -330,7 +365,7 @@ class IpcAppHandler extends IpcHandler {
 export function throttleProgressCallback(func, checkAbort, progressInterval) {
     const interval = progressInterval ?? 250; // by default, only send progress events every 250 milliseconds
     let nextTime = Date.now() + interval;
-    const progressCallback = (loaded, total) => {
+    return (loaded, total) => {
         const now = Date.now();
         if (loaded >= total || now >= nextTime) {
             nextTime = now + interval;
@@ -338,6 +373,5 @@ export function throttleProgressCallback(func, checkAbort, progressInterval) {
         }
         return checkAbort();
     };
-    return progressCallback;
 }
 //# sourceMappingURL=IpcHost.js.map

package/lib/esm/IpcHost.js.map

@@ -1 +1 @@
-{"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 { IModelJsNative } from \"@bentley/imodeljs-native\";\r\nimport { assert, IModelStatus, Logger, LogLevel, OpenMode, PickAsyncMethods } from \"@itwin/core-bentley\";\r\nimport {\r\n  BriefcaseConnectionProps,\r\n  ChangesetIndex, ChangesetIndexAndId, createIpcDispatcher, createIpcProxy, EditingScopeNotifications, getPullChangesIpcChannel, IModelConnectionProps, IModelError, IModelNotFoundResponse, IModelRpcProps,\r\n  ipcAppChannels, IpcAppFunctions, IpcAppNotifications, IpcInvokeReturn, IpcListener, IpcSocketBackend, iTwinChannel,\r\n  OpenBriefcaseProps, OpenCheckpointArgs, PullChangesOptions, ReinstateTxnArgs, RemoveFunction, ReverseTxnArgs, SnapshotOpenOptions,\r\n  StandaloneOpenOptions, TileTreeContentIds, TxnNotifications, unwrapIpcInvokeReturn,\r\n} from \"@itwin/core-common\";\r\nimport { ProgressFunction, ProgressStatus } from \"./CheckpointManager\";\r\nimport { BriefcaseDb, IModelDb, SnapshotDb, StandaloneDb } from \"./IModelDb\";\r\nimport { IModelHost, IModelHostOptions } from \"./IModelHost\";\r\nimport { IModelNative } from \"./internal/NativePlatform\";\r\nimport { _implicitTxn, _nativeDb } from \"./internal/Symbols\";\r\nimport { cancelTileContentRequests } from \"./rpc-impl/IModelTileRpcImpl\";\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 _nextInvokeId = 0;\r\n  private static _pendingInvokes = new Map<number, () => void>();\r\n\r\n  /**\r\n   * Send a message to the frontend via `channel` and expect a result asynchronously. The handler must be established on the frontend via [[IpcApp.handle]]\r\n   * @param channel The name of the channel for the method.\r\n   * @note `args` are serialized with the [Structured Clone Algorithm](https://developer.mozilla.org/en-US/docs/Web/API/Web_Workers_API/Structured_clone_algorithm), so only\r\n   * primitive types and `ArrayBuffers` are allowed.\r\n   * @note The returned Promise rejects if [[shutdown]] is called before the frontend responds.\r\n   * @beta\r\n   */\r\n  public static async invoke(channel: string, ...args: any[]): Promise<any> {\r\n    // Electron has no main->renderer `invoke` (see https://www.electronjs.org/docs/latest/tutorial/ipc#pattern-3-main-to-renderer),\r\n    // so we synthesize request/response from the universally-available `send`/`addListener` primitives: push the request via\r\n    // `send` together with a unique per-request response channel, and resolve when the frontend handler replies on that channel.\r\n    const requestId = ++this._nextInvokeId % Number.MAX_SAFE_INTEGER;\r\n    const responseChannel = iTwinChannel(`${channel}-invoke_response-${requestId}`);\r\n\r\n    return new Promise((resolve, reject) => {\r\n      let removeListener: RemoveFunction = () => { };\r\n      const cleanup = () => {\r\n        removeListener();\r\n        this._pendingInvokes.delete(requestId);\r\n      };\r\n\r\n      removeListener = this.ipc.addListener(responseChannel, (_evt: Event, result: any) => {\r\n        cleanup();\r\n        resolve(result);\r\n      });\r\n\r\n      // allow [[shutdown]] to reject any in-flight invoke rather than leaking its listener forever.\r\n      this._pendingInvokes.set(requestId, () => {\r\n        cleanup();\r\n        reject(new Error(`IpcHost was shut down before the frontend responded on channel \"${channel}\"`));\r\n      });\r\n\r\n      try {\r\n        this.send(channel, responseChannel, ...args);\r\n      } catch (err) {\r\n        // `send` can throw synchronously (e.g. a destroyed Electron window, or a closed websocket). Without this,\r\n        // the listener and _pendingInvokes entry registered above would leak for the life of the process.\r\n        cleanup();\r\n        reject(err instanceof Error ? err : new Error(String(err)));\r\n      }\r\n    });\r\n  }\r\n\r\n  /**\r\n   * Call a method on the frontend through an Ipc channel.\r\n   * @param channelName the channel registered by the frontend handler.\r\n   * @param methodName the name of a method implemented by the frontend handler.\r\n   * @param args arguments to `methodName`\r\n   * @returns a Promise with the return value from `methodName`\r\n   */\r\n  private static async callIpcChannel(channelName: string, methodName: string, ...args: any[]): Promise<any> {\r\n    const retVal = await this.invoke(channelName, methodName, ...args) as IpcInvokeReturn;\r\n    return unwrapIpcInvokeReturn(retVal);\r\n  }\r\n\r\n  /**\r\n   * Create a type safe Proxy object to make IPC calls to a registered frontend interface.\r\n   * @param channelName the channel registered by the frontend handler.\r\n   * @beta\r\n   */\r\n  public static makeIpcProxy<K, C extends string = string>(channelName: C): PickAsyncMethods<K> {\r\n    return createIpcProxy<K>(async (methodName: string, ...args: any[]) => IpcHost.callIpcChannel(channelName, methodName, ...args));\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(ipcAppChannels.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(ipcAppChannels.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(ipcAppChannels.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\r\n    // reject any in-flight invokes so their callers don't hang forever after the socket is gone.\r\n    const pending = [...this._pendingInvokes.values()];\r\n    this._pendingInvokes.clear();\r\n    for (const rejectPending of pending)\r\n      rejectPending();\r\n\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  /**\r\n   * All subclasses *must* implement this method to specify their channel name.\r\n   *\r\n   * Channel names are the key that connects Handlers and senders. The channel name of IpcHandlers must exactly match the name used by senders.\r\n   * By convention, channel names should be prefixed by a *namespace* (e.g. `${appName}/`)\r\n   * unique enough to disambiguate them from channels for other apps that may be running in the same processes.\r\n   */\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    const dispatch = createIpcDispatcher(impl, impl.channelName, () => !IpcHost.noStack);\r\n    return IpcHost.handle(impl.channelName, async (_evt: Event, funcName: string, ...args: any[]): Promise<IpcInvokeReturn> => dispatch(funcName, ...args));\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 ipcAppChannels.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<BriefcaseConnectionProps> {\r\n    const db = await BriefcaseDb.open(args);\r\n    return db.toJSON();\r\n  }\r\n  public async openCheckpoint(checkpoint: OpenCheckpointArgs): Promise<IModelConnectionProps> {\r\n    return (await SnapshotDb.openCheckpoint(checkpoint)).getConnectionProps();\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 openSnapshot(filePath: string, opts?: SnapshotOpenOptions): Promise<IModelConnectionProps> {\r\n    let resolvedFileName: string | undefined = filePath;\r\n    if (IModelHost.snapshotFileNameResolver) { // eslint-disable-line @typescript-eslint/no-deprecated\r\n      resolvedFileName = IModelHost.snapshotFileNameResolver.tryResolveFileName(filePath); // eslint-disable-line @typescript-eslint/no-deprecated\r\n      if (!resolvedFileName)\r\n        throw new IModelNotFoundResponse(); // eslint-disable-line @typescript-eslint/only-throw-error\r\n    }\r\n    return SnapshotDb.openFile(resolvedFileName, 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)[_implicitTxn].saveChanges(description);\r\n  }\r\n  public async abandonChanges(key: string): Promise<void> {\r\n    IModelDb.findByKey(key)[_implicitTxn].abandonChanges();\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].getRedoString();\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 BriefcaseDb.findByKey(key).txns.reverseTxns(numOperations);\r\n  }\r\n\r\n  public async reverseTxnsAsync(key: string, numOperations: number, args?: ReverseTxnArgs): Promise<void> {\r\n    return BriefcaseDb.findByKey(key).txns.reverseTxnsAsync(numOperations, args);\r\n  }\r\n\r\n  public async reverseAllTxn(key: string): Promise<IModelStatus> {\r\n    return BriefcaseDb.findByKey(key).txns.reverseAll();\r\n  }\r\n\r\n  public async reverseAllTxnsAsync(key: string, args?: ReverseTxnArgs): Promise<void> {\r\n    return BriefcaseDb.findByKey(key).txns.reverseAllTxnsAsync(args);\r\n  }\r\n\r\n  public async reinstateTxn(key: string): Promise<IModelStatus> {\r\n    return BriefcaseDb.findByKey(key).txns.reinstateTxn();\r\n  }\r\n\r\n  public async reinstateTxnAsync(key: string, args?: ReinstateTxnArgs): Promise<void> {\r\n    return BriefcaseDb.findByKey(key).txns.reinstateTxnAsync(args);\r\n  }\r\n\r\n  public async restartTxnSession(key: string): Promise<void> {\r\n    return IModelDb.findByKey(key).restartTxnSession();\r\n  }\r\n\r\n  public async queryConcurrency(pool: \"io\" | \"cpu\"): Promise<number> {\r\n    return IModelNative.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"]}
+{"version":3,"file":"IpcHost.js","sourceRoot":"","sources":["../../src/IpcHost.ts"],"names":[],"mappings":"AAAA;;;+FAG+F;AAC/F;;GAEG;AAGH,OAAO,EAAE,MAAM,EAAgB,MAAM,EAAE,QAAQ,EAA8B,MAAM,qBAAqB,CAAC;AACzG,OAAO,EAEgC,mBAAmB,EAAE,cAAc,EAA6B,wBAAwB,EAAE,wBAAwB,EAAyB,WAAW,EAAE,sBAAsB,EACnN,cAAc,EAAwF,YAAY,EAErD,qBAAqB,GACnF,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAoB,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACvE,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC7E,OAAO,EAAE,UAAU,EAAqB,MAAM,cAAc,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,EAAE,yBAAyB,EAAE,MAAM,8BAA8B,CAAC;AAmBzE;;;;GAIG;AACH,MAAM,OAAO,OAAO;IACX,MAAM,CAAC,OAAO,GAAG,KAAK,CAAC;IACtB,MAAM,CAAC,IAAI,CAA+B;IAClD,2EAA2E;IACnE,MAAM,KAAK,GAAG,KAAuB,OAAO,IAAI,CAAC,IAAK,CAAC,CAAC,CAAC,CAAC,+DAA+D;IACjI,gIAAgI;IACzH,MAAM,KAAK,OAAO,KAAc,OAAO,SAAS,KAAK,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IAExE;;;;OAIG;IACI,MAAM,CAAC,IAAI,CAAC,OAAe,EAAE,GAAG,IAAW;QAChD,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC;IAChD,CAAC;IAED;;;;;OAKG;IACI,MAAM,CAAC,MAAM,CAAC,OAAe,EAAE,OAAyC;QAC7E,OAAO,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,YAAY,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,CAAC;IACzD,CAAC;IACD;;;;;OAKG;IACI,MAAM,CAAC,WAAW,CAAC,OAAe,EAAE,QAAqB;QAC9D,OAAO,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,YAAY,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,CAAC;IAC/D,CAAC;IACD;;;;OAIG;IACI,MAAM,CAAC,cAAc,CAAC,OAAe,EAAE,QAAqB;QACjE,IAAI,CAAC,GAAG,CAAC,cAAc,CAAC,YAAY,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,CAAC;IAC3D,CAAC;IAEO,MAAM,CAAC,aAAa,GAAG,CAAC,CAAC;IACzB,MAAM,CAAC,eAAe,GAAG,IAAI,GAAG,EAAsB,CAAC;IAE/D;;;;;;;OAOG;IACI,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,OAAe,EAAE,GAAG,IAAW;QACxD,gIAAgI;QAChI,yHAAyH;QACzH,6HAA6H;QAC7H,MAAM,SAAS,GAAG,EAAE,IAAI,CAAC,aAAa,GAAG,MAAM,CAAC,gBAAgB,CAAC;QACjE,MAAM,eAAe,GAAG,YAAY,CAAC,GAAG,OAAO,oBAAoB,SAAS,EAAE,CAAC,CAAC;QAEhF,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACrC,IAAI,cAAc,GAAmB,GAAG,EAAE,GAAG,CAAC,CAAC;YAC/C,MAAM,OAAO,GAAG,GAAG,EAAE;gBACnB,cAAc,EAAE,CAAC;gBACjB,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;YACzC,CAAC,CAAC;YAEF,cAAc,GAAG,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,eAAe,EAAE,CAAC,IAAW,EAAE,MAAW,EAAE,EAAE;gBAClF,OAAO,EAAE,CAAC;gBACV,OAAO,CAAC,MAAM,CAAC,CAAC;YAClB,CAAC,CAAC,CAAC;YAEH,8FAA8F;YAC9F,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,SAAS,EAAE,GAAG,EAAE;gBACvC,OAAO,EAAE,CAAC;gBACV,MAAM,CAAC,IAAI,KAAK,CAAC,mEAAmE,OAAO,GAAG,CAAC,CAAC,CAAC;YACnG,CAAC,CAAC,CAAC;YAEH,IAAI,CAAC;gBACH,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,eAAe,EAAE,GAAG,IAAI,CAAC,CAAC;YAC/C,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,0GAA0G;gBAC1G,kGAAkG;gBAClG,OAAO,EAAE,CAAC;gBACV,MAAM,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;YAC9D,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;;;;;OAMG;IACK,MAAM,CAAC,KAAK,CAAC,cAAc,CAAC,WAAmB,EAAE,UAAkB,EAAE,GAAG,IAAW;QACzF,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,UAAU,EAAE,GAAG,IAAI,CAAoB,CAAC;QACtF,OAAO,qBAAqB,CAAC,MAAM,CAAC,CAAC;IACvC,CAAC;IAED;;;;OAIG;IACI,MAAM,CAAC,YAAY,CAA+B,WAAc;QACrE,OAAO,cAAc,CAAI,KAAK,EAAE,UAAkB,EAAE,GAAG,IAAW,EAAE,EAAE,CAAC,OAAO,CAAC,cAAc,CAAC,WAAW,EAAE,UAAU,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC;IACnI,CAAC;IAEO,MAAM,CAAC,MAAM,CAAC,OAAe,EAAE,SAAqC,EAAE,UAAkB,EAAE,GAAG,IAAW;QAC9G,IAAI,IAAI,CAAC,OAAO;YACd,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,OAAO,IAAI,SAAS,CAAC,GAAG,EAAE,EAAE,UAAU,EAAE,GAAG,IAAI,CAAC,CAAC;IACzE,CAAC;IAED,gBAAgB;IACT,MAAM,CAAC,iBAAiB,CAAsC,UAAa,EAAE,GAAG,IAAwC;QAC7H,OAAO,OAAO,CAAC,IAAI,CAAC,cAAc,CAAC,SAAS,EAAE,UAAU,EAAE,GAAG,IAAI,CAAC,CAAC;IACrE,CAAC;IAED,gBAAgB;IACT,MAAM,CAAC,UAAU,CAAmC,SAAqC,EAAE,UAAa,EAAE,GAAG,IAAqC;QACvJ,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,SAAS,EAAE,UAAU,EAAE,GAAG,IAAI,CAAC,CAAC;IACnE,CAAC;IAED,gBAAgB;IACT,MAAM,CAAC,kBAAkB,CAA4C,SAAqC,EAAE,UAAa,EAAE,GAAG,IAA8C;QACjL,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC,YAAY,EAAE,SAAS,EAAE,UAAU,EAAE,GAAG,IAAI,CAAC,CAAC;IAC3E,CAAC;IAED;;;;OAIG;IACI,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,GAAiB;QAC3C,IAAI,CAAC,IAAI,GAAG,GAAG,EAAE,OAAO,EAAE,MAAM,CAAC;QACjC,IAAI,GAAG,EAAE,OAAO,EAAE,UAAU,EAAE,OAAO;YACnC,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QAEtB,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,sDAAsD;YACxE,aAAa,CAAC,QAAQ,EAAE,CAAC;QAC3B,CAAC;QAED,MAAM,UAAU,CAAC,OAAO,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;IAC5C,CAAC;IAED,mEAAmE;IAC5D,MAAM,CAAC,KAAK,CAAC,QAAQ;QAC1B,IAAI,CAAC,IAAI,GAAG,SAAS,CAAC;QAEtB,6FAA6F;QAC7F,MAAM,OAAO,GAAG,CAAC,GAAG,IAAI,CAAC,eAAe,CAAC,MAAM,EAAE,CAAC,CAAC;QACnD,IAAI,CAAC,eAAe,CAAC,KAAK,EAAE,CAAC;QAC7B,KAAK,MAAM,aAAa,IAAI,OAAO;YACjC,aAAa,EAAE,CAAC;QAElB,MAAM,UAAU,CAAC,QAAQ,EAAE,CAAC;IAC9B,CAAC;;AAGH;;;;;;;;;;;GAWG;AACH,MAAM,OAAgB,UAAU;IAU9B;;;;;OAKG;IACI,MAAM,CAAC,QAAQ;QACpB,MAAM,IAAI,GAAG,IAAK,IAAY,EAAgB,CAAC,CAAC,uFAAuF;QACvI,MAAM,QAAQ,GAAG,mBAAmB,CAAC,IAAI,EAAE,IAAI,CAAC,WAAW,EAAE,GAAG,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QACrF,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,EAAE,IAAW,EAAE,QAAgB,EAAE,GAAG,IAAW,EAA4B,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC;IAC1J,CAAC;CACF;AAED;;GAEG;AACH,MAAM,aAAc,SAAQ,UAAU;IACpC,IAAW,WAAW,KAAK,OAAO,cAAc,CAAC,SAAS,CAAC,CAAC,CAAC;IAE7D,kFAAkF;IAC1E,sBAAsB,GAAG,IAAI,GAAG,EAA0B,CAAC;IACnE,oGAAoG;IAC5F,sBAAsB,GAAG,IAAI,GAAG,EAA0B,CAAC;IAE5D,KAAK,CAAC,GAAG,CAAC,UAAkB,EAAE,KAAe,EAAE,QAAgB,EAAE,OAAe,EAAE,QAAc;QACrG,QAAQ,KAAK,EAAE,CAAC;YACd,KAAK,QAAQ,CAAC,KAAK;gBACjB,MAAM,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;gBAC7C,MAAM;YACR,KAAK,QAAQ,CAAC,IAAI;gBAChB,MAAM,CAAC,OAAO,CAAC,QAAQ,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;gBAC5C,MAAM;YACR,KAAK,QAAQ,CAAC,KAAK;gBACjB,MAAM,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;gBAC7C,MAAM;YACR,KAAK,QAAQ,CAAC,OAAO;gBACnB,MAAM,CAAC,UAAU,CAAC,QAAQ,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;gBAC/C,MAAM;QACV,CAAC;IACH,CAAC;IAEM,KAAK,CAAC,yBAAyB,CAAC,UAA0B,EAAE,UAAgC;QACjG,OAAO,yBAAyB,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;IAC3D,CAAC;IACM,KAAK,CAAC,6BAA6B,CAAC,GAAW,EAAE,UAAoB;QAC1E,OAAO,QAAQ,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC,6BAA6B,CAAC,UAAU,CAAC,CAAC;IACtF,CAAC;IACM,KAAK,CAAC,aAAa,CAAC,IAAwB;QACjD,MAAM,EAAE,GAAG,MAAM,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACxC,OAAO,EAAE,CAAC,MAAM,EAAE,CAAC;IACrB,CAAC;IACM,KAAK,CAAC,cAAc,CAAC,UAA8B;QACxD,OAAO,CAAC,MAAM,UAAU,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC,CAAC,kBAAkB,EAAE,CAAC;IAC5E,CAAC;IACM,KAAK,CAAC,cAAc,CAAC,QAAgB,EAAE,QAAkB,EAAE,IAA4B;QAC5F,OAAO,YAAY,CAAC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC,kBAAkB,EAAE,CAAC;IAC9E,CAAC;IACM,KAAK,CAAC,YAAY,CAAC,QAAgB,EAAE,IAA0B;QACpE,IAAI,gBAAgB,GAAuB,QAAQ,CAAC;QACpD,IAAI,UAAU,CAAC,wBAAwB,EAAE,CAAC,CAAC,uDAAuD;YAChG,gBAAgB,GAAG,UAAU,CAAC,wBAAwB,CAAC,kBAAkB,CAAC,QAAQ,CAAC,CAAC,CAAC,uDAAuD;YAC5I,IAAI,CAAC,gBAAgB;gBACnB,MAAM,IAAI,sBAAsB,EAAE,CAAC,CAAC,0DAA0D;QAClG,CAAC;QACD,OAAO,UAAU,CAAC,QAAQ,CAAC,gBAAgB,EAAE,IAAI,CAAC,CAAC,kBAAkB,EAAE,CAAC;IAC1E,CAAC;IACM,KAAK,CAAC,WAAW,CAAC,GAAW;QAClC,QAAQ,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC;IAClC,CAAC;IACM,KAAK,CAAC,WAAW,CAAC,GAAW,EAAE,WAAoB;QACxD,QAAQ,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,YAAY,CAAC,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC;IACjE,CAAC;IACM,KAAK,CAAC,cAAc,CAAC,GAAW;QACrC,QAAQ,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,YAAY,CAAC,CAAC,cAAc,EAAE,CAAC;IACzD,CAAC;IACM,KAAK,CAAC,cAAc,CAAC,GAAW;QACrC,OAAO,QAAQ,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC,cAAc,EAAE,CAAC;IAC7D,CAAC;IAEM,KAAK,CAAC,cAAc,CAAC,GAAW;QACrC,OAAO,QAAQ,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC,cAAc,EAAE,CAAC;IAC7D,CAAC;IACM,KAAK,CAAC,cAAc,CAAC,GAAW;QACrC,OAAO,QAAQ,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC,cAAc,EAAE,CAAC;IAC7D,CAAC;IACM,KAAK,CAAC,aAAa,CAAC,GAAW;QACpC,OAAO,QAAQ,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC,aAAa,EAAE,CAAC;IAC5D,CAAC;IACM,KAAK,CAAC,aAAa,CAAC,GAAW;QACpC,OAAO,QAAQ,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC,aAAa,EAAE,CAAC;IAC5D,CAAC;IAED;;;OAGG;IACK,6BAA6B,CAAC,IAOrC;QACC,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,GAAG,IAAI,CAAC;QAE/F,SAAS,CAAC,GAAG,CAAC,GAAG,EAAE,cAAc,CAAC,QAAQ,CAAC,CAAC;QAC5C,MAAM,UAAU,GAAG,GAAG,EAAE,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,cAAc,CAAC,QAAQ,CAAC;QACvE,MAAM,IAAI,GAAG,GAAG,EAAE,CAAC,SAAS,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAEzC,IAAI,cAAc,EAAE,CAAC;YACnB,MAAM,gBAAgB,GAAqB,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE;gBAC3D,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;gBACzC,OAAO,UAAU,EAAE,CAAC;YACtB,CAAC,CAAC;YACF,MAAM,yBAAyB,GAAG,wBAAwB,CAAC,gBAAgB,EAAE,UAAU,EAAE,gBAAgB,CAAC,CAAC;YAE3G,OAAO,EAAE,kBAAkB,EAAE,yBAAyB,EAAE,IAAI,EAAE,CAAC;QACjE,CAAC;QAED,IAAI,kBAAkB;YACpB,OAAO,EAAE,kBAAkB,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC;QAElD,OAAO,EAAE,kBAAkB,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;IACjD,CAAC;IAEM,KAAK,CAAC,WAAW,CAAC,GAAW,EAAE,OAAwB,EAAE,OAA4B;QAC1F,MAAM,QAAQ,GAAG,WAAW,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;QAE5C,MAAM,EAAE,kBAAkB,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC,6BAA6B,CAAC;YACtE,GAAG;YACH,OAAO,EAAE,wBAAwB,CAAC,GAAG,CAAC;YACtC,SAAS,EAAE,IAAI,CAAC,sBAAsB;YACtC,cAAc,EAAE,OAAO,EAAE,cAAc;YACvC,gBAAgB,EAAE,OAAO,EAAE,gBAAgB;YAC3C,kBAAkB,EAAE,OAAO,EAAE,kBAAkB;SAChD,CAAC,CAAC;QAEH,IAAI,CAAC;YACH,MAAM,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,EAAE,UAAU,EAAE,kBAAkB,EAAE,CAAC,CAAC;QAC1E,CAAC;gBAAS,CAAC;YACT,IAAI,EAAE,CAAC;QACT,CAAC;QAED,OAAO,QAAQ,CAAC,SAAgC,CAAC;IACnD,CAAC;IACM,KAAK,CAAC,wBAAwB,CAAC,GAAW;QAC/C,IAAI,CAAC,sBAAsB,CAAC,GAAG,CAAC,GAAG,EAAE,cAAc,CAAC,KAAK,CAAC,CAAC;IAC7D,CAAC;IAEM,KAAK,CAAC,WAAW,CAAC,GAAW,EAAE,WAAmB,EAAE,OAA4B;QACrF,MAAM,QAAQ,GAAG,WAAW,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;QAE5C,MAAM,EAAE,kBAAkB,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC,6BAA6B,CAAC;YACtE,GAAG;YACH,OAAO,EAAE,wBAAwB,CAAC,GAAG,CAAC;YACtC,SAAS,EAAE,IAAI,CAAC,sBAAsB;YACtC,cAAc,EAAE,OAAO,EAAE,sBAAsB;YAC/C,gBAAgB,EAAE,OAAO,EAAE,wBAAwB;YACnD,kBAAkB,EAAE,OAAO,EAAE,kBAAkB;SAChD,CAAC,CAAC;QAEH,IAAI,CAAC;YACH,MAAM,QAAQ,CAAC,WAAW,CAAC,EAAE,WAAW,EAAE,kBAAkB,EAAE,CAAC,CAAC;QAClE,CAAC;gBAAS,CAAC;YACT,IAAI,EAAE,CAAC;QACT,CAAC;QAED,OAAO,QAAQ,CAAC,SAAgC,CAAC;IACnD,CAAC;IACM,KAAK,CAAC,wBAAwB,CAAC,GAAW;QAC/C,IAAI,CAAC,sBAAsB,CAAC,GAAG,CAAC,GAAG,EAAE,cAAc,CAAC,KAAK,CAAC,CAAC;IAC7D,CAAC;IAEM,KAAK,CAAC,2BAA2B,CAAC,GAAW,EAAE,YAAqB;QACzE,MAAM,GAAG,GAAqD,QAAQ,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC,gCAAgC,CAAC,YAAY,CAAC,CAAC;QAChJ,IAAI,GAAG,CAAC,KAAK;YACX,MAAM,IAAI,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,EAAE,0CAA0C,CAAC,CAAC;QACtF,MAAM,CAAC,SAAS,KAAK,GAAG,CAAC,MAAM,CAAC,CAAC;QACjC,OAAO,GAAG,CAAC,MAAM,CAAC;IACpB,CAAC;IACM,KAAK,CAAC,2BAA2B,CAAC,GAAW;QAClD,OAAO,QAAQ,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC,iCAAiC,EAAE,CAAC;IAChF,CAAC;IAEM,KAAK,CAAC,WAAW,CAAC,GAAW,EAAE,aAAqB;QACzD,OAAO,WAAW,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,aAAa,CAAC,CAAC;IACpE,CAAC;IAEM,KAAK,CAAC,gBAAgB,CAAC,GAAW,EAAE,aAAqB,EAAE,IAAqB;QACrF,OAAO,WAAW,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,aAAa,EAAE,IAAI,CAAC,CAAC;IAC/E,CAAC;IAEM,KAAK,CAAC,aAAa,CAAC,GAAW;QACpC,OAAO,WAAW,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC;IACtD,CAAC;IAEM,KAAK,CAAC,mBAAmB,CAAC,GAAW,EAAE,IAAqB;QACjE,OAAO,WAAW,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC;IACnE,CAAC;IAEM,KAAK,CAAC,YAAY,CAAC,GAAW;QACnC,OAAO,WAAW,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC;IACxD,CAAC;IAEM,KAAK,CAAC,iBAAiB,CAAC,GAAW,EAAE,IAAuB;QACjE,OAAO,WAAW,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;IACjE,CAAC;IAEM,KAAK,CAAC,iBAAiB,CAAC,GAAW;QACxC,OAAO,QAAQ,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,iBAAiB,EAAE,CAAC;IACrD,CAAC;IAEM,KAAK,CAAC,gBAAgB,CAAC,IAAkB;QAC9C,OAAO,YAAY,CAAC,QAAQ,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC;IACtD,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,UAAU,wBAAwB,CAAC,IAAsB,EAAE,UAAgC,EAAE,gBAAyB;IAC1H,MAAM,QAAQ,GAAG,gBAAgB,IAAI,GAAG,CAAC,CAAC,+DAA+D;IACzG,IAAI,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,QAAQ,CAAC;IAErC,OAAO,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE;QACvB,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,IAAI,MAAM,IAAI,KAAK,IAAI,GAAG,IAAI,QAAQ,EAAE,CAAC;YACvC,QAAQ,GAAG,GAAG,GAAG,QAAQ,CAAC;YAC1B,OAAO,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QAC7B,CAAC;QACD,OAAO,UAAU,EAAE,CAAC;IACtB,CAAC,CAAC;AACJ,CAAC","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 { IModelJsNative } from \"@bentley/imodeljs-native\";\r\nimport { assert, IModelStatus, Logger, LogLevel, OpenMode, PickAsyncMethods } from \"@itwin/core-bentley\";\r\nimport {\r\n  BriefcaseConnectionProps,\r\n  ChangesetIndex, ChangesetIndexAndId, createIpcDispatcher, createIpcProxy, EditingScopeNotifications, getPullChangesIpcChannel, getPushChangesIpcChannel, IModelConnectionProps, IModelError, IModelNotFoundResponse, IModelRpcProps,\r\n  ipcAppChannels, IpcAppFunctions, IpcAppNotifications, IpcInvokeReturn, IpcListener, IpcSocketBackend, iTwinChannel,\r\n  OpenBriefcaseProps, OpenCheckpointArgs, PullChangesOptions, PushChangesOptions, ReinstateTxnArgs, RemoveFunction, ReverseTxnArgs, SnapshotOpenOptions,\r\n  StandaloneOpenOptions, TileTreeContentIds, TxnNotifications, unwrapIpcInvokeReturn,\r\n} from \"@itwin/core-common\";\r\nimport { ProgressFunction, ProgressStatus } from \"./CheckpointManager\";\r\nimport { BriefcaseDb, IModelDb, SnapshotDb, StandaloneDb } from \"./IModelDb\";\r\nimport { IModelHost, IModelHostOptions } from \"./IModelHost\";\r\nimport { IModelNative } from \"./internal/NativePlatform\";\r\nimport { _implicitTxn, _nativeDb } from \"./internal/Symbols\";\r\nimport { cancelTileContentRequests } from \"./rpc-impl/IModelTileRpcImpl\";\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 _nextInvokeId = 0;\r\n  private static _pendingInvokes = new Map<number, () => void>();\r\n\r\n  /**\r\n   * Send a message to the frontend via `channel` and expect a result asynchronously. The handler must be established on the frontend via [[IpcApp.handle]]\r\n   * @param channel The name of the channel for the method.\r\n   * @note `args` are serialized with the [Structured Clone Algorithm](https://developer.mozilla.org/en-US/docs/Web/API/Web_Workers_API/Structured_clone_algorithm), so only\r\n   * primitive types and `ArrayBuffers` are allowed.\r\n   * @note The returned Promise rejects if [[shutdown]] is called before the frontend responds.\r\n   * @beta\r\n   */\r\n  public static async invoke(channel: string, ...args: any[]): Promise<any> {\r\n    // Electron has no main->renderer `invoke` (see https://www.electronjs.org/docs/latest/tutorial/ipc#pattern-3-main-to-renderer),\r\n    // so we synthesize request/response from the universally-available `send`/`addListener` primitives: push the request via\r\n    // `send` together with a unique per-request response channel, and resolve when the frontend handler replies on that channel.\r\n    const requestId = ++this._nextInvokeId % Number.MAX_SAFE_INTEGER;\r\n    const responseChannel = iTwinChannel(`${channel}-invoke_response-${requestId}`);\r\n\r\n    return new Promise((resolve, reject) => {\r\n      let removeListener: RemoveFunction = () => { };\r\n      const cleanup = () => {\r\n        removeListener();\r\n        this._pendingInvokes.delete(requestId);\r\n      };\r\n\r\n      removeListener = this.ipc.addListener(responseChannel, (_evt: Event, result: any) => {\r\n        cleanup();\r\n        resolve(result);\r\n      });\r\n\r\n      // allow [[shutdown]] to reject any in-flight invoke rather than leaking its listener forever.\r\n      this._pendingInvokes.set(requestId, () => {\r\n        cleanup();\r\n        reject(new Error(`IpcHost was shut down before the frontend responded on channel \"${channel}\"`));\r\n      });\r\n\r\n      try {\r\n        this.send(channel, responseChannel, ...args);\r\n      } catch (err) {\r\n        // `send` can throw synchronously (e.g. a destroyed Electron window, or a closed websocket). Without this,\r\n        // the listener and _pendingInvokes entry registered above would leak for the life of the process.\r\n        cleanup();\r\n        reject(err instanceof Error ? err : new Error(String(err)));\r\n      }\r\n    });\r\n  }\r\n\r\n  /**\r\n   * Call a method on the frontend through an Ipc channel.\r\n   * @param channelName the channel registered by the frontend handler.\r\n   * @param methodName the name of a method implemented by the frontend handler.\r\n   * @param args arguments to `methodName`\r\n   * @returns a Promise with the return value from `methodName`\r\n   */\r\n  private static async callIpcChannel(channelName: string, methodName: string, ...args: any[]): Promise<any> {\r\n    const retVal = await this.invoke(channelName, methodName, ...args) as IpcInvokeReturn;\r\n    return unwrapIpcInvokeReturn(retVal);\r\n  }\r\n\r\n  /**\r\n   * Create a type safe Proxy object to make IPC calls to a registered frontend interface.\r\n   * @param channelName the channel registered by the frontend handler.\r\n   * @beta\r\n   */\r\n  public static makeIpcProxy<K, C extends string = string>(channelName: C): PickAsyncMethods<K> {\r\n    return createIpcProxy<K>(async (methodName: string, ...args: any[]) => IpcHost.callIpcChannel(channelName, methodName, ...args));\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(ipcAppChannels.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(ipcAppChannels.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(ipcAppChannels.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\r\n    // reject any in-flight invokes so their callers don't hang forever after the socket is gone.\r\n    const pending = [...this._pendingInvokes.values()];\r\n    this._pendingInvokes.clear();\r\n    for (const rejectPending of pending)\r\n      rejectPending();\r\n\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  /**\r\n   * All subclasses *must* implement this method to specify their channel name.\r\n   *\r\n   * Channel names are the key that connects Handlers and senders. The channel name of IpcHandlers must exactly match the name used by senders.\r\n   * By convention, channel names should be prefixed by a *namespace* (e.g. `${appName}/`)\r\n   * unique enough to disambiguate them from channels for other apps that may be running in the same processes.\r\n   */\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    const dispatch = createIpcDispatcher(impl, impl.channelName, () => !IpcHost.noStack);\r\n    return IpcHost.handle(impl.channelName, async (_evt: Event, funcName: string, ...args: any[]): Promise<IpcInvokeReturn> => dispatch(funcName, ...args));\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 ipcAppChannels.functions; }\r\n\r\n  /** Tracks cancellation of the changeset download initiated by [[pullChanges]]. */\r\n  private _iModelKeyToPullStatus = new Map<string, ProgressStatus>();\r\n  /** Tracks cancellation of the changeset download that [[pushChanges]] performs before uploading. */\r\n  private _iModelKeyToPushStatus = 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<BriefcaseConnectionProps> {\r\n    const db = await BriefcaseDb.open(args);\r\n    return db.toJSON();\r\n  }\r\n  public async openCheckpoint(checkpoint: OpenCheckpointArgs): Promise<IModelConnectionProps> {\r\n    return (await SnapshotDb.openCheckpoint(checkpoint)).getConnectionProps();\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 openSnapshot(filePath: string, opts?: SnapshotOpenOptions): Promise<IModelConnectionProps> {\r\n    let resolvedFileName: string | undefined = filePath;\r\n    if (IModelHost.snapshotFileNameResolver) { // eslint-disable-line @typescript-eslint/no-deprecated\r\n      resolvedFileName = IModelHost.snapshotFileNameResolver.tryResolveFileName(filePath); // eslint-disable-line @typescript-eslint/no-deprecated\r\n      if (!resolvedFileName)\r\n        throw new IModelNotFoundResponse(); // eslint-disable-line @typescript-eslint/only-throw-error\r\n    }\r\n    return SnapshotDb.openFile(resolvedFileName, 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)[_implicitTxn].saveChanges(description);\r\n  }\r\n  public async abandonChanges(key: string): Promise<void> {\r\n    IModelDb.findByKey(key)[_implicitTxn].abandonChanges();\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].getRedoString();\r\n  }\r\n\r\n  /** Creates the [[ProgressFunction]] used to relay changeset download progress to the frontend over `channel`, and to observe\r\n   * cancellation requests recorded in `statusMap`. Shared by [[pullChanges]] and the merge that [[pushChanges]] performs before uploading.\r\n   * @returns the progress function, and a function to stop tracking the operation.\r\n   */\r\n  private createDownloadProgressHandler(args: {\r\n    key: string,\r\n    channel: string,\r\n    statusMap: Map<string, ProgressStatus>,\r\n    reportProgress?: boolean,\r\n    progressInterval?: number,\r\n    enableCancellation?: boolean,\r\n  }): { onDownloadProgress?: ProgressFunction, done: () => void } {\r\n    const { key, channel, statusMap, reportProgress, progressInterval, enableCancellation } = args;\r\n\r\n    statusMap.set(key, ProgressStatus.Continue);\r\n    const checkAbort = () => statusMap.get(key) ?? ProgressStatus.Continue;\r\n    const done = () => statusMap.delete(key);\r\n\r\n    if (reportProgress) {\r\n      const progressCallback: ProgressFunction = (loaded, total) => {\r\n        IpcHost.send(channel, { loaded, total });\r\n        return checkAbort();\r\n      };\r\n      const throttledProgressCallback = throttleProgressCallback(progressCallback, checkAbort, progressInterval);\r\n\r\n      return { onDownloadProgress: throttledProgressCallback, done };\r\n    }\r\n\r\n    if (enableCancellation)\r\n      return { onDownloadProgress: checkAbort, done };\r\n\r\n    return { onDownloadProgress: undefined, done };\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    const { onDownloadProgress, done } = this.createDownloadProgressHandler({\r\n      key,\r\n      channel: getPullChangesIpcChannel(key),\r\n      statusMap: this._iModelKeyToPullStatus,\r\n      reportProgress: options?.reportProgress,\r\n      progressInterval: options?.progressInterval,\r\n      enableCancellation: options?.enableCancellation,\r\n    });\r\n\r\n    try {\r\n      await iModelDb.pullChanges({ toIndex, onProgress: onDownloadProgress });\r\n    } finally {\r\n      done();\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, options?: PushChangesOptions): Promise<ChangesetIndexAndId> {\r\n    const iModelDb = BriefcaseDb.findByKey(key);\r\n\r\n    const { onDownloadProgress, done } = this.createDownloadProgressHandler({\r\n      key,\r\n      channel: getPushChangesIpcChannel(key),\r\n      statusMap: this._iModelKeyToPushStatus,\r\n      reportProgress: options?.reportDownloadProgress,\r\n      progressInterval: options?.downloadProgressInterval,\r\n      enableCancellation: options?.enableCancellation,\r\n    });\r\n\r\n    try {\r\n      await iModelDb.pushChanges({ description, onDownloadProgress });\r\n    } finally {\r\n      done();\r\n    }\r\n\r\n    return iModelDb.changeset as ChangesetIndexAndId;\r\n  }\r\n  public async cancelPushChangesRequest(key: string): Promise<void> {\r\n    this._iModelKeyToPushStatus.set(key, ProgressStatus.Abort);\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 BriefcaseDb.findByKey(key).txns.reverseTxns(numOperations);\r\n  }\r\n\r\n  public async reverseTxnsAsync(key: string, numOperations: number, args?: ReverseTxnArgs): Promise<void> {\r\n    return BriefcaseDb.findByKey(key).txns.reverseTxnsAsync(numOperations, args);\r\n  }\r\n\r\n  public async reverseAllTxn(key: string): Promise<IModelStatus> {\r\n    return BriefcaseDb.findByKey(key).txns.reverseAll();\r\n  }\r\n\r\n  public async reverseAllTxnsAsync(key: string, args?: ReverseTxnArgs): Promise<void> {\r\n    return BriefcaseDb.findByKey(key).txns.reverseAllTxnsAsync(args);\r\n  }\r\n\r\n  public async reinstateTxn(key: string): Promise<IModelStatus> {\r\n    return BriefcaseDb.findByKey(key).txns.reinstateTxn();\r\n  }\r\n\r\n  public async reinstateTxnAsync(key: string, args?: ReinstateTxnArgs): Promise<void> {\r\n    return BriefcaseDb.findByKey(key).txns.reinstateTxnAsync(args);\r\n  }\r\n\r\n  public async restartTxnSession(key: string): Promise<void> {\r\n    return IModelDb.findByKey(key).restartTxnSession();\r\n  }\r\n\r\n  public async queryConcurrency(pool: \"io\" | \"cpu\"): Promise<number> {\r\n    return IModelNative.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\r\n  return (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"]}

package/lib/esm/TxnManager.js

@@ -628,25 +628,25 @@ export class RebaseManager {
             case "Inserted": {
                 if (!props)
                     throw new IModelError(IModelStatus.BadRequest, "InstancePatch with op 'Inserted' must have props");
-                const options = { forceUseId: true, useJsNames: true };
+                const options = { forceUseId: true, convertClassIdsToClassNames: true };
                 const id = nativeDb.insertInstance(props, options);
                 if (!Id64.isValidId64(id))
-                    throw new IModelError(IModelStatus.BadRequest, `Failed to insert instance with id ${props.id}`);
+                    throw new IModelError(IModelStatus.BadRequest, `Failed to insert instance with id ${props.ECInstanceId}`);
                 break;
             }
             case "Updated": {
                 if (!props)
                     throw new IModelError(IModelStatus.BadRequest, "InstancePatch with op 'Updated' must have props");
-                const isSuccess = nativeDb.updateInstance(props, { useJsNames: true });
+                const isSuccess = nativeDb.updateInstance(props, { convertClassIdsToClassNames: true });
                 if (!isSuccess)
-                    throw new IModelError(IModelStatus.BadRequest, `Failed to update instance with id ${props.id}`);
+                    throw new IModelError(IModelStatus.BadRequest, `Failed to update instance with id ${props.ECInstanceId}`);
                 break;
             }
             case "Deleted": {
-                const key = { id: props.id, classFullName: props.className };
-                const isSuccess = nativeDb.deleteInstance(key, { useJsNames: true });
+                const key = { ECInstanceId: props.ECInstanceId, ECClassId: props.ECClassId }; // eslint-disable-line @typescript-eslint/naming-convention
+                const isSuccess = nativeDb.deleteInstance(key, { convertClassIdsToClassNames: true });
                 if (!isSuccess)
-                    throw new IModelError(IModelStatus.BadRequest, `Failed to delete instance with id ${props.id}`);
+                    throw new IModelError(IModelStatus.BadRequest, `Failed to delete instance with id ${props.ECInstanceId}`);
                 break;
             }
             default:
@@ -907,7 +907,7 @@ export class TxnManager {
             // so using strict mode will cause error in this case when we will try to capture changes for first txn
             // because the number of columns in table A will be different than what it was when the changes were originally made.
             // So to avoid this issue we are not using strict mode here.
-            const reader = __addDisposableResource(env_1, ChangesetReader.openTxn({ db: this._iModel, txnId: id, rowOptions: { useJsName: true, abbreviateBlobs: false } }), false);
+            const reader = __addDisposableResource(env_1, ChangesetReader.openTxn({ db: this._iModel, txnId: id, rowOptions: { classIdsToClassNames: true, abbreviateBlobs: false } }), false);
             const pcu = __addDisposableResource(env_1, new PartialChangeUnifier(ChangeUnifierCache.createSqliteBackedCache()), false);
             while (reader.step()) {
                 pcu.appendFrom(reader);