@itwin/core-backend 5.14.0-dev.2 → 5.14.0-dev.21

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":"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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, 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/SchemaSync.d.ts

@@ -1,8 +1,9 @@
 import { CloudSqlite } from "./CloudSqlite";
 import { SQLiteDb, VersionedSqliteDb } from "./SQLiteDb";
-import { IModelDb } from "./IModelDb";
+import { BriefcaseDb, IModelDb } from "./IModelDb";
 import { GuidString, Id64String, OpenMode } from "@itwin/core-bentley";
 import { Code, LocalFileName } from "@itwin/core-common";
+import type { BlobContainer } from "./BlobContainerService";
 /** @internal */
 export declare namespace SchemaSync {
     /** Identifies an element to be reserved in a `SchemaSyncDb`. @internal */
@@ -21,13 +22,13 @@ export declare namespace SchemaSync {
         findReservedElement(federationGuid: GuidString): ReservedElement | undefined;
     }
     interface WriteMethods {
-        /** Reserve the specified elements in the `SchemaSyncDb`.  Throws if any of the requested reservations conflict with existing reservations. */
+        /** Reserve the specified elements in the `SchemaSyncDb`. Throws if any requested reservation conflicts with an existing reservation. */
         reserveElements(identities: ProposedElementReservation[]): Promise<void>;
     }
     /** A CloudSqlite database for synchronizing schema changes across briefcases.  */
     class SchemaSyncDb extends VersionedSqliteDb implements ReadMethods, WriteMethods {
         private _supportsReservations?;
-        readonly myVersion = "4.1.0";
+        readonly myVersion = "5.0.0";
         protected createDDL(): void;
         openDb(dbName: string, openMode: OpenMode | SQLiteDb.OpenParams, container?: CloudSqlite.CloudContainer): void;
         private ensureReservedElementsTable;
@@ -38,28 +39,133 @@ export declare namespace SchemaSync {
         private getNextReservedElementLocalId;
         private setNextReservedElementLocalId;
     }
-    const setTestCache: (iModel: IModelDb, cacheName?: string) => void;
-    const getCloudAccess: (arg: IModelDb | {
+    /** The `containerType` recorded on a BlobContainer that holds an iModel's `SchemaSyncDb`. */
+    const containerType = "schemasync";
+    function setTestCache(iModel: IModelDb, cacheName?: string): void;
+    /** Either an open iModel or the name of a closed briefcase file. Every local read below accepts both, so
+     * a caller that has only a file name does not have to open a `BriefcaseDb` to ask a question about it.
+     */
+    type IModelOrFileName = IModelDb | {
         readonly fileName: LocalFileName;
-    }) => Promise<CloudAccess>;
-    const withLockedAccess: (iModel: IModelDb | {
-        readonly fileName: LocalFileName;
-    }, args: {
+    };
+    /** Whether this iModel's ECSchemas are governed by a `SchemaSyncDb`.
+     *
+     * This is the single question every schema operation branches on. It reads one `be_Prop` row written when
+     * schema sync was enabled and carried to every other briefcase by that changeset - no cloud access, and it
+     * works on a readonly briefcase, a checkpoint, or a closed file.
+     * @note This says nothing about whether the container is reachable, or even named. Use
+     * [[queryContainerProps]] for that. The two are separate on purpose: a file that says it is governed by a
+     * sync db must never fall back to importing schemas on its own, whatever state the container is in.
+     */
+    function isEnabled(arg: IModelOrFileName): boolean;
+    /** The container holding this iModel's `SchemaSyncDb`, or `undefined` if schema sync was never enabled.
+     *
+     * Local read of the same `be_Prop` file property that [[initializeForIModel]] wrote. Requesting an access
+     * token for the container is a separate, asynchronous step.
+     */
+    function queryContainerProps(arg: IModelOrFileName): CloudSqlite.ContainerProps | undefined;
+    function getCloudAccess(arg: IModelOrFileName): Promise<CloudAccess>;
+    /** Release an access obtained through [[getCloudAccess]]. */
+    function releaseCloudAccess(access: CloudAccess): void;
+    /** Arguments for [[withLockedAccess]]. */
+    interface WithLockedAccessArgs {
         operationName: string;
         openMode?: OpenMode;
         user?: string;
-    }, operation: (access: CloudAccess) => Promise<void>) => Promise<void>;
-    const withReadonlyAccess: (iModel: IModelDb | {
-        readonly fileName: LocalFileName;
-    }, operation: (access: CloudAccess) => Promise<void>) => Promise<void>;
-    const isEnabled: (iModel: IModelDb) => boolean;
-    /** Synchronize local briefcase schemas with cloud container */
-    const pull: (iModel: IModelDb) => Promise<void>;
-    const initializeForIModel: (arg: {
+    }
+    function withLockedAccess(iModel: IModelOrFileName, args: WithLockedAccessArgs, operation: (access: CloudAccess) => Promise<void>): Promise<void>;
+    /** Build the tables and indexes the briefcase's `ec_` rows describe. A merged schema changeset carries
+     * those rows but no DDL, so the physical columns are missing until this runs. Needs no cloud access.
+     */
+    function updateDbSchema(iModel: IModelDb): void;
+    /** Whether a failed [[IModelDb.importSchemas]] can be retried through the upgrade path.
+     *
+     * The update tier refuses two kinds of change: one that has to move data between columns, and one
+     * that destroys instances or property values. They arrive as different statuses because they are
+     * different changes, but they mean one thing to a caller - this needs
+     * [[BriefcaseDb.upgradeSchemas]], which takes the exclusive schema lock.
+     *
+     * The retry is the app's decision, not the platform's: taking that lock disturbs everyone else, so
+     * only the app knows whether to do it now, schedule it, or tell the user.
+     * ```ts
+     * try {
+     *   await db.importSchemas(files);
+     * } catch (e) {
+     *   if (!SchemaSync.requiresUpgrade(e)) throw e;
+     *   await db.upgradeSchemas(files, { description: "..." });
+     * }
+     * ```
+     * @internal
+     */
+    function requiresUpgrade(error: unknown): boolean;
+    /** Arguments for [[createContainerForIModel]]. */
+    interface CreateContainerForIModelArgs {
+        iModel: IModelDb;
+        label?: string;
+        description?: string;
+    }
+    /** Create a cloud container to hold this iModel's `SchemaSyncDb`, and initialize it as empty.
+     *
+     * The container is scoped to the iModel, so the service deletes it when the iModel is deleted. Pass the
+     * returned props to [[initializeForIModel]] - the two calls together are what enables schema sync on an
+     * iModel that was created without it.
+     * @note The current user must be authorized to create containers for the iTwin.
+     */
+    function createContainerForIModel(arg: CreateContainerForIModelArgs): Promise<CloudSqlite.ContainerProps>;
+    /** Arguments for [[initializeForIModel]]. */
+    interface InitializeForIModelArgs {
         iModel: IModelDb;
         containerProps: CloudSqlite.ContainerProps;
+        /** Replace the container already recorded on this iModel instead of failing. */
         overrideContainer?: boolean;
-    }) => Promise<void>;
+    }
+    /** Enable schema sync for an iModel, seeding the container from this briefcase.
+     * @note Takes the exclusive schema lock, refuses local changes, and pulls the briefcase to the tip before writing the container.
+     * If this operation fails after acquiring the schema lock, it leaves the lock held.
+     */
+    function initializeForIModel(arg: InitializeForIModelArgs): Promise<void>;
+    /** The part of a SchemaSyncDb to restore from an authoritative briefcase. @alpha */
+    type RepairScope = "schemaMetadata" | "schemaMetadataAndProfile";
+    /** Arguments for [[repairForIModel]]. @alpha */
+    interface RepairForIModelArgs {
+        /** A clean SchemaSync-enabled briefcase at the tip of the iModel timeline. */
+        iModel: BriefcaseDb;
+        /** Include the schema-owned EC and BeSQLite profile table definitions. */
+        scope?: RepairScope;
+    }
+    /** Restore the schema-owned portion of the SchemaSyncDb from a briefcase at the tip of the timeline.
+     *
+     * This operation takes the exclusive schema lock and refuses to pull or modify the briefcase. Element
+     * reservations and all other target-only state in the SchemaSyncDb are preserved.
+     * @alpha
+     */
+    function repairForIModel(arg: RepairForIModelArgs): Promise<void>;
+    /** Arguments for [[enableForIModel]]. */
+    interface EnableForIModelArgs {
+        iModel: IModelDb;
+        /** An existing container to use. When omitted one is created for this iModel. */
+        containerProps?: CloudSqlite.ContainerProps;
+        /** Replace the container already recorded on this iModel instead of failing. */
+        overrideContainer?: boolean;
+        label?: string;
+        description?: string;
+    }
+    /** Turn schema sync on for an iModel: create the container if needed, record it, and seed it.
+     *
+     * The single call callers should use. [[createContainerForIModel]] and [[initializeForIModel]] have
+     * to happen in this order, and an iModel left between the two is one that names a container nothing
+     * has seeded.
+     * @returns the container props recorded on the iModel.
+     * @note Takes the exclusive schema lock and pushes, same protocol as [[BriefcaseDb.upgradeSchemas]] -
+     * every operation that changes how a file is governed uses it. If this operation fails after acquiring the schema lock,
+     * it leaves the lock held.
+     */
+    function enableForIModel(arg: EnableForIModelArgs): Promise<CloudSqlite.ContainerProps>;
+    /** Arguments for [[CloudAccess.createNewContainer]]. */
+    interface CreateNewContainerProps {
+        scope: BlobContainer.Scope;
+        metadata: Omit<BlobContainer.Metadata, "containerType">;
+    }
     /** Provides access to a cloud-based `SchemaSyncDb` to hold ECSchemas.  */
     class CloudAccess extends CloudSqlite.DbAccess<SchemaSyncDb, ReadMethods, WriteMethods> {
         constructor(props: CloudSqlite.ContainerAccessProps);
@@ -70,6 +176,8 @@ export declare namespace SchemaSync {
        * @note this deletes any existing content in the container.
        */
         static initializeDb(props: CloudSqlite.ContainerProps): Promise<void>;
+        /** Create and initialize a new `schemasync` BlobContainer to hold a `SchemaSyncDb`. */
+        static createNewContainer(args: CreateNewContainerProps): Promise<CloudSqlite.ContainerProps>;
     }
 }
 //# sourceMappingURL=SchemaSync.d.ts.map

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

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