@itwin/core-backend 5.12.0-dev.13 → 5.12.0-dev.15

package/lib/esm/IpcHost.d.ts

@@ -1,6 +1,7 @@
 /** @packageDocumentation
  * @module NativeApp
  */
+import { PickAsyncMethods } from "@itwin/core-bentley";
 import { EditingScopeNotifications, IpcAppNotifications, IpcListener, IpcSocketBackend, RemoveFunction, TxnNotifications } from "@itwin/core-common";
 import { ProgressFunction, ProgressStatus } from "./CheckpointManager";
 import { BriefcaseDb, StandaloneDb } from "./IModelDb";
@@ -58,6 +59,31 @@ export declare class IpcHost {
      * @param listener The function passed to [[addListener]]
      */
     static removeListener(channel: string, listener: IpcListener): void;
+    private static _nextInvokeId;
+    private static _pendingInvokes;
+    /**
+     * Send a message to the frontend via `channel` and expect a result asynchronously. The handler must be established on the frontend via [[IpcApp.handle]]
+     * @param channel The name of the channel for the method.
+     * @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
+     * primitive types and `ArrayBuffers` are allowed.
+     * @note The returned Promise rejects if [[shutdown]] is called before the frontend responds.
+     * @beta
+     */
+    static invoke(channel: string, ...args: any[]): Promise<any>;
+    /**
+     * Call a method on the frontend through an Ipc channel.
+     * @param channelName the channel registered by the frontend handler.
+     * @param methodName the name of a method implemented by the frontend handler.
+     * @param args arguments to `methodName`
+     * @returns a Promise with the return value from `methodName`
+     */
+    private static callIpcChannel;
+    /**
+     * Create a type safe Proxy object to make IPC calls to a registered frontend interface.
+     * @param channelName the channel registered by the frontend handler.
+     * @beta
+     */
+    static makeIpcProxy<K, C extends string = string>(channelName: C): PickAsyncMethods<K>;
     private static notify;
     /** @internal */
     static notifyIpcFrontend<T extends keyof IpcAppNotifications>(methodName: T, ...args: Parameters<IpcAppNotifications[T]>): void;

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

@@ -1 +1 @@
-{"version":3,"file":"IpcHost.d.ts","sourceRoot":"","sources":["../../src/IpcHost.ts"],"names":[],"mappings":"AAIA;;GAEG;AAIH,OAAO,EAEgC,yBAAyB,EAC7B,mBAAmB,EAAmB,WAAW,EAAE,gBAAgB,EACtB,cAAc,EACjD,gBAAgB,EAC5D,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACvE,OAAO,EAAE,WAAW,EAAwB,YAAY,EAAE,MAAM,YAAY,CAAC;AAC7E,OAAO,EAAc,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAK7D;;;IAGI;AACJ,MAAM,WAAW,WAAW;IAC1B,UAAU,CAAC,EAAE,iBAAiB,CAAC;IAC/B,OAAO,CAAC,EAAE;QACR,wGAAwG;QACxG,MAAM,CAAC,EAAE,gBAAgB,CAAC;QAE1B,iDAAiD;QACjD,UAAU,CAAC,EAAE;YACX,OAAO,CAAC,EAAE,OAAO,CAAC;SACnB,CAAC;KACH,CAAC;CACH;AAED;;;;GAIG;AACH,qBAAa,OAAO;IAClB,OAAc,OAAO,UAAS;IAC9B,OAAO,CAAC,MAAM,CAAC,IAAI,CAA+B;IAClD,2EAA2E;IAC3E,OAAO,CAAC,MAAM,KAAK,GAAG,GAA2C;IACjE,gIAAgI;IAChI,WAAkB,OAAO,IAAI,OAAO,CAAoC;IAExE;;;;OAIG;WACW,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI;IAIzD;;;;;OAKG;WACW,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,OAAO,CAAC,GAAG,CAAC,GAAG,cAAc;IAGhG;;;;;OAKG;WACW,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,GAAG,cAAc;IAGjF;;;;OAIG;WACW,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,GAAG,IAAI;IAI1E,OAAO,CAAC,MAAM,CAAC,MAAM;IAKrB,gBAAgB;WACF,iBAAiB,CAAC,CAAC,SAAS,MAAM,mBAAmB,EAAE,UAAU,EAAE,CAAC,EAAE,GAAG,IAAI,EAAE,UAAU,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC;IAI/H,gBAAgB;WACF,UAAU,CAAC,CAAC,SAAS,MAAM,gBAAgB,EAAE,SAAS,EAAE,WAAW,GAAG,YAAY,EAAE,UAAU,EAAE,CAAC,EAAE,GAAG,IAAI,EAAE,UAAU,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC;IAIzJ,gBAAgB;WACF,kBAAkB,CAAC,CAAC,SAAS,MAAM,yBAAyB,EAAE,SAAS,EAAE,WAAW,GAAG,YAAY,EAAE,UAAU,EAAE,CAAC,EAAE,GAAG,IAAI,EAAE,UAAU,CAAC,yBAAyB,CAAC,CAAC,CAAC,CAAC;IAInL;;;;OAIG;WACiB,OAAO,CAAC,GAAG,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAY7D,mEAAmE;WAC/C,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAI9C;AAED;;;;;;;;;;;GAWG;AACH,8BAAsB,UAAU;IAC9B;;;;;;OAMG;IACH,aAAoB,WAAW,IAAI,MAAM,CAAC;IAE1C;;;;;OAKG;WACW,QAAQ,IAAI,cAAc;CA0EzC;AA6JD;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,cAAc,EAAE,gBAAgB,CAAC,EAAE,MAAM,GAAG,gBAAgB,CAa9I"}
+{"version":3,"file":"IpcHost.d.ts","sourceRoot":"","sources":["../../src/IpcHost.ts"],"names":[],"mappings":"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"}

package/lib/esm/IpcHost.js

@@ -5,8 +5,8 @@
 /** @packageDocumentation
  * @module NativeApp
  */
-import { assert, BentleyError, IModelStatus, JsonUtils, Logger, LogLevel } from "@itwin/core-bentley";
-import { getPullChangesIpcChannel, IModelError, IModelNotFoundResponse, ipcAppChannels, iTwinChannel, } from "@itwin/core-common";
+import { assert, Logger, LogLevel } from "@itwin/core-bentley";
+import { createIpcDispatcher, createIpcProxy, getPullChangesIpcChannel, IModelError, IModelNotFoundResponse, ipcAppChannels, iTwinChannel, unwrapIpcInvokeReturn, } from "@itwin/core-common";
 import { ProgressStatus } from "./CheckpointManager";
 import { BriefcaseDb, IModelDb, SnapshotDb, StandaloneDb } from "./IModelDb";
 import { IModelHost } from "./IModelHost";
@@ -59,6 +59,67 @@ export class IpcHost {
     static removeListener(channel, listener) {
         this.ipc.removeListener(iTwinChannel(channel), listener);
     }
+    static _nextInvokeId = 0;
+    static _pendingInvokes = new Map();
+    /**
+     * Send a message to the frontend via `channel` and expect a result asynchronously. The handler must be established on the frontend via [[IpcApp.handle]]
+     * @param channel The name of the channel for the method.
+     * @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
+     * primitive types and `ArrayBuffers` are allowed.
+     * @note The returned Promise rejects if [[shutdown]] is called before the frontend responds.
+     * @beta
+     */
+    static async invoke(channel, ...args) {
+        // Electron has no main->renderer `invoke` (see https://www.electronjs.org/docs/latest/tutorial/ipc#pattern-3-main-to-renderer),
+        // so we synthesize request/response from the universally-available `send`/`addListener` primitives: push the request via
+        // `send` together with a unique per-request response channel, and resolve when the frontend handler replies on that channel.
+        const requestId = ++this._nextInvokeId % Number.MAX_SAFE_INTEGER;
+        const responseChannel = iTwinChannel(`${channel}-invoke_response-${requestId}`);
+        return new Promise((resolve, reject) => {
+            let removeListener = () => { };
+            const cleanup = () => {
+                removeListener();
+                this._pendingInvokes.delete(requestId);
+            };
+            removeListener = this.ipc.addListener(responseChannel, (_evt, result) => {
+                cleanup();
+                resolve(result);
+            });
+            // allow [[shutdown]] to reject any in-flight invoke rather than leaking its listener forever.
+            this._pendingInvokes.set(requestId, () => {
+                cleanup();
+                reject(new Error(`IpcHost was shut down before the frontend responded on channel "${channel}"`));
+            });
+            try {
+                this.send(channel, responseChannel, ...args);
+            }
+            catch (err) {
+                // `send` can throw synchronously (e.g. a destroyed Electron window, or a closed websocket). Without this,
+                // the listener and _pendingInvokes entry registered above would leak for the life of the process.
+                cleanup();
+                reject(err instanceof Error ? err : new Error(String(err)));
+            }
+        });
+    }
+    /**
+     * Call a method on the frontend through an Ipc channel.
+     * @param channelName the channel registered by the frontend handler.
+     * @param methodName the name of a method implemented by the frontend handler.
+     * @param args arguments to `methodName`
+     * @returns a Promise with the return value from `methodName`
+     */
+    static async callIpcChannel(channelName, methodName, ...args) {
+        const retVal = await this.invoke(channelName, methodName, ...args);
+        return unwrapIpcInvokeReturn(retVal);
+    }
+    /**
+     * Create a type safe Proxy object to make IPC calls to a registered frontend interface.
+     * @param channelName the channel registered by the frontend handler.
+     * @beta
+     */
+    static makeIpcProxy(channelName) {
+        return createIpcProxy(async (methodName, ...args) => IpcHost.callIpcChannel(channelName, methodName, ...args));
+    }
     static notify(channel, briefcase, methodName, ...args) {
         if (this.isValid)
             return this.send(`${channel}/${briefcase.key}`, methodName, ...args);
@@ -92,6 +153,11 @@ export class IpcHost {
     /** Shutdown IpcHost backend. Also calls [[IModelHost.shutdown]] */
     static async shutdown() {
         this._ipc = undefined;
+        // reject any in-flight invokes so their callers don't hang forever after the socket is gone.
+        const pending = [...this._pendingInvokes.values()];
+        this._pendingInvokes.clear();
+        for (const rejectPending of pending)
+            rejectPending();
         await IModelHost.shutdown();
     }
 }
@@ -116,67 +182,8 @@ export class IpcHandler {
      */
     static register() {
         const impl = new this(); // create an instance of subclass. "as any" is necessary because base class is abstract
-        const prohibitedFunctions = Object.getOwnPropertyNames(Object.getPrototypeOf({}));
-        return IpcHost.handle(impl.channelName, async (_evt, funcName, ...args) => {
-            try {
-                if (prohibitedFunctions.includes(funcName))
-                    throw new Error(`Method "${funcName}" not available for channel: ${impl.channelName}`);
-                const func = impl[funcName];
-                if (typeof func !== "function")
-                    throw new IModelError(IModelStatus.FunctionNotFound, `Method "${impl.constructor.name}.${funcName}" not found on IpcHandler registered for channel: ${impl.channelName}`);
-                return { result: await func.call(impl, ...args) };
-            }
-            catch (err) {
-                if (!JsonUtils.isObject(err)) // if the exception isn't an object, just forward it
-                    return { error: err };
-                const serializeError = (e, includeStack, visited = new WeakSet()) => {
-                    if (visited.has(e))
-                        return undefined;
-                    visited.add(e);
-                    try {
-                        const serialized = { ...e };
-                        for (const sym of Object.getOwnPropertySymbols(serialized))
-                            delete serialized[sym]; // symbol-keyed properties cannot be structured-cloned
-                        if (e instanceof Error) {
-                            serialized.message = e.message; // NB: .message and .stack are non-enumerable on Error instances
-                            if (includeStack)
-                                serialized.stack = e.stack;
-                            // Error.cause is typically non-enumerable and must be copied explicitly.
-                            if (Object.prototype.hasOwnProperty.call(e, "cause"))
-                                serialized.cause = e.cause;
-                        }
-                        if (e instanceof BentleyError) {
-                            serialized.iTwinErrorId = e.iTwinErrorId;
-                            if (e.hasMetaData)
-                                serialized.loggingMetadata = e.loggingMetadata;
-                            delete serialized._metaData;
-                        }
-                        // Only recurse into Error instances and plain objects — not class instances like Date or Buffer.
-                        const shouldRecurse = (val) => val instanceof Error || (JsonUtils.isObject(val) && Object.getPrototypeOf(val) === Object.prototype);
-                        const isSerializableLeaf = (val) => {
-                            const t = typeof val;
-                            return val === null || val === undefined || val instanceof Date
-                                || t === "string" || t === "number" || t === "boolean";
-                        };
-                        for (const key of Object.keys(serialized)) {
-                            const val = serialized[key];
-                            if (Array.isArray(val))
-                                serialized[key] = val.map((item) => shouldRecurse(item) ? serializeError(item, includeStack, visited) : isSerializableLeaf(item) ? item : undefined);
-                            else if (shouldRecurse(val))
-                                serialized[key] = serializeError(val, includeStack, visited);
-                            else if (!isSerializableLeaf(val))
-                                delete serialized[key]; // strip non-cloneable values (functions, class instances, etc.)
-                        }
-                        return serialized;
-                    }
-                    finally {
-                        // Remove from the stack so a sibling branch can still serialize this object.
-                        visited.delete(e);
-                    }
-                };
-                return { error: serializeError(err, !IpcHost.noStack) };
-            }
-        });
+        const dispatch = createIpcDispatcher(impl, impl.channelName, () => !IpcHost.noStack);
+        return IpcHost.handle(impl.channelName, async (_evt, funcName, ...args) => dispatch(funcName, ...args));
     }
 }
 /**

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":["/*---------------------------------------------------------------------------------------------\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n* See LICENSE.md in the project root for license terms and full copyright notice.\n*--------------------------------------------------------------------------------------------*/\n/** @packageDocumentation\n * @module NativeApp\n */\n\nimport { IModelJsNative } from \"@bentley/imodeljs-native\";\nimport { assert, BentleyError, IModelStatus, JsonUtils, Logger, LogLevel, OpenMode } from \"@itwin/core-bentley\";\nimport {\n  BriefcaseConnectionProps,\n  ChangesetIndex, ChangesetIndexAndId, EditingScopeNotifications, getPullChangesIpcChannel, IModelConnectionProps, IModelError, IModelNotFoundResponse, IModelRpcProps,\n  ipcAppChannels, IpcAppFunctions, IpcAppNotifications, IpcInvokeReturn, IpcListener, IpcSocketBackend, iTwinChannel,\n  OpenBriefcaseProps, OpenCheckpointArgs, PullChangesOptions, ReinstateTxnArgs, RemoveFunction, ReverseTxnArgs, SnapshotOpenOptions,\n  StandaloneOpenOptions, TileTreeContentIds, TxnNotifications,\n} from \"@itwin/core-common\";\nimport { ProgressFunction, ProgressStatus } from \"./CheckpointManager\";\nimport { BriefcaseDb, IModelDb, SnapshotDb, StandaloneDb } from \"./IModelDb\";\nimport { IModelHost, IModelHostOptions } from \"./IModelHost\";\nimport { IModelNative } from \"./internal/NativePlatform\";\nimport { _implicitTxn, _nativeDb } from \"./internal/Symbols\";\nimport { cancelTileContentRequests } from \"./rpc-impl/IModelTileRpcImpl\";\n\n/**\n  * Options for [[IpcHost.startup]]\n  * @public\n  */\nexport interface IpcHostOpts {\n  iModelHost?: IModelHostOptions;\n  ipcHost?: {\n    /** The Ipc socket to use for communications with frontend. Allows undefined only for headless tests. */\n    socket?: IpcSocketBackend;\n\n    /** don't send stack information on exceptions */\n    exceptions?: {\n      noStack?: boolean;\n    };\n  };\n}\n\n/**\n * Used by applications that have a dedicated backend. IpcHosts may send messages to their corresponding IpcApp.\n * @note if either end terminates, the other must too.\n * @public\n */\nexport class IpcHost {\n  public static noStack = false;\n  private static _ipc: IpcSocketBackend | undefined;\n  /** Get the implementation of the [IpcSocketBackend]($common) interface. */\n  private static get ipc(): IpcSocketBackend { return this._ipc!; } // eslint-disable-line @typescript-eslint/no-non-null-assertion\n  /** Determine whether Ipc is available for this backend. This will only be true if [[startup]] has been called on this class. */\n  public static get isValid(): boolean { return undefined !== this._ipc; }\n\n  /**\n   * Send a message to the frontend over an Ipc channel.\n   * @param channel the name of the channel matching the name registered with [[IpcApp.addListener]].\n   * @param data The content of the message.\n   */\n  public static send(channel: string, ...data: any[]): void {\n    this.ipc.send(iTwinChannel(channel), ...data);\n  }\n\n  /**\n   * Establish a handler for an Ipc channel to receive [[Frontend.invoke]] calls\n   * @param channel The name of the channel for this handler.\n   * @param handler A function that supplies the implementation for `channel`\n   * @note returns A function to call to remove the handler.\n   */\n  public static handle(channel: string, handler: (...args: any[]) => Promise<any>): RemoveFunction {\n    return this.ipc.handle(iTwinChannel(channel), handler);\n  }\n  /**\n   * Establish a handler to receive messages sent via [[IpcApp.send]].\n   * @param channel The name of the channel for the messages.\n   * @param listener A function called when messages are sent over `channel`\n   * @note returns A function to call to remove the listener.\n   */\n  public static addListener(channel: string, listener: IpcListener): RemoveFunction {\n    return this.ipc.addListener(iTwinChannel(channel), listener);\n  }\n  /**\n   * Remove a previously registered listener\n   * @param channel The name of the channel for the listener previously registered with [[addListener]]\n   * @param listener The function passed to [[addListener]]\n   */\n  public static removeListener(channel: string, listener: IpcListener): void {\n    this.ipc.removeListener(iTwinChannel(channel), listener);\n  }\n\n  private static notify(channel: string, briefcase: BriefcaseDb | StandaloneDb, methodName: string, ...args: any[]) {\n    if (this.isValid)\n      return this.send(`${channel}/${briefcase.key}`, methodName, ...args);\n  }\n\n  /** @internal */\n  public static notifyIpcFrontend<T extends keyof IpcAppNotifications>(methodName: T, ...args: Parameters<IpcAppNotifications[T]>) {\n    return IpcHost.send(ipcAppChannels.appNotify, methodName, ...args);\n  }\n\n  /** @internal */\n  public static notifyTxns<T extends keyof TxnNotifications>(briefcase: BriefcaseDb | StandaloneDb, methodName: T, ...args: Parameters<TxnNotifications[T]>) {\n    this.notify(ipcAppChannels.txns, briefcase, methodName, ...args);\n  }\n\n  /** @internal */\n  public static notifyEditingScope<T extends keyof EditingScopeNotifications>(briefcase: BriefcaseDb | StandaloneDb, methodName: T, ...args: Parameters<EditingScopeNotifications[T]>) {\n    this.notify(ipcAppChannels.editingScope, briefcase, methodName, ...args);\n  }\n\n  /**\n   * Start the backend of an Ipc app.\n   * @param opt\n   * @note this method calls [[IModelHost.startup]] internally.\n   */\n  public static async startup(opt?: IpcHostOpts): Promise<void> {\n    this._ipc = opt?.ipcHost?.socket;\n    if (opt?.ipcHost?.exceptions?.noStack)\n      this.noStack = true;\n\n    if (this.isValid) { // for tests, we use IpcHost but don't have a frontend\n      IpcAppHandler.register();\n    }\n\n    await IModelHost.startup(opt?.iModelHost);\n  }\n\n  /** Shutdown IpcHost backend. Also calls [[IModelHost.shutdown]] */\n  public static async shutdown(): Promise<void> {\n    this._ipc = undefined;\n    await IModelHost.shutdown();\n  }\n}\n\n/**\n * Base class for all implementations of an Ipc interface.\n *\n * Create a subclass to implement your Ipc interface. Your class should be declared like this:\n * ```ts\n * class MyHandler extends IpcHandler implements MyInterface\n * ```\n * to ensure all methods and signatures are correct.\n *\n * Then, call `MyClass.register` at startup to connect your class to your channel.\n * @public\n */\nexport abstract class IpcHandler {\n  /**\n   * All subclasses *must* implement this method to specify their channel name.\n   *\n   * Channel names are the key that connects Handlers and senders. The channel name of IpcHandlers must exactly match the name used by senders.\n   * By convention, channel names should be prefixed by a *namespace* (e.g. `${appName}/`)\n   * unique enough to disambiguate them from channels for other apps that may be running in the same processes.\n   */\n  public abstract get channelName(): string;\n\n  /**\n   * Register this class as the handler for methods on its channel. This static method creates a new instance\n   * that becomes the handler and is `this` when its methods are called.\n   * @returns A function that can be called to remove the handler.\n   * @note this method should only be called once per channel. If it is called multiple times, subsequent calls replace the previous ones.\n   */\n  public static register(): RemoveFunction {\n    const impl = new (this as any)() as IpcHandler; // create an instance of subclass. \"as any\" is necessary because base class is abstract\n    const prohibitedFunctions = Object.getOwnPropertyNames(Object.getPrototypeOf({}));\n\n    return IpcHost.handle(impl.channelName, async (_evt: Event, funcName: string, ...args: any[]): Promise<IpcInvokeReturn> => {\n      try {\n        if (prohibitedFunctions.includes(funcName))\n          throw new Error(`Method \"${funcName}\" not available for channel: ${impl.channelName}`);\n\n        const func = (impl as any)[funcName];\n        if (typeof func !== \"function\")\n          throw new IModelError(IModelStatus.FunctionNotFound, `Method \"${impl.constructor.name}.${funcName}\" not found on IpcHandler registered for channel: ${impl.channelName}`);\n\n        return { result: await func.call(impl, ...args) };\n      } catch (err: unknown) {\n\n        if (!JsonUtils.isObject(err)) // if the exception isn't an object, just forward it\n          return { error: err };\n\n        const serializeError = (e: any, includeStack: boolean, visited = new WeakSet<object>()): any => {\n          if (visited.has(e))\n            return undefined;\n          visited.add(e);\n          try {\n            const serialized: any = { ...e };\n\n            for (const sym of Object.getOwnPropertySymbols(serialized))\n              delete serialized[sym]; // symbol-keyed properties cannot be structured-cloned\n\n            if (e instanceof Error) {\n              serialized.message = e.message; // NB: .message and .stack are non-enumerable on Error instances\n              if (includeStack)\n                serialized.stack = e.stack;\n\n              // Error.cause is typically non-enumerable and must be copied explicitly.\n              if (Object.prototype.hasOwnProperty.call(e, \"cause\"))\n                serialized.cause = (e as { cause?: unknown }).cause;\n            }\n\n            if (e instanceof BentleyError) {\n              serialized.iTwinErrorId = e.iTwinErrorId;\n              if (e.hasMetaData)\n                serialized.loggingMetadata = e.loggingMetadata;\n              delete serialized._metaData;\n            }\n\n            // Only recurse into Error instances and plain objects — not class instances like Date or Buffer.\n            const shouldRecurse = (val: any) => val instanceof Error || (JsonUtils.isObject(val) && Object.getPrototypeOf(val) === Object.prototype);\n            const isSerializableLeaf = (val: unknown): boolean => {\n              const t = typeof val;\n              return val === null || val === undefined || val instanceof Date\n                || t === \"string\" || t === \"number\" || t === \"boolean\";\n            };\n            for (const key of Object.keys(serialized)) {\n              const val = serialized[key];\n              if (Array.isArray(val))\n                serialized[key] = val.map((item) => shouldRecurse(item) ? serializeError(item, includeStack, visited) : isSerializableLeaf(item) ? item : undefined);\n              else if (shouldRecurse(val))\n                serialized[key] = serializeError(val, includeStack, visited);\n              else if (!isSerializableLeaf(val))\n                delete serialized[key]; // strip non-cloneable values (functions, class instances, etc.)\n            }\n\n            return serialized;\n          } finally {\n            // Remove from the stack so a sibling branch can still serialize this object.\n            visited.delete(e);\n          }\n        };\n\n        return { error: serializeError(err, !IpcHost.noStack) };\n      }\n    });\n  }\n}\n\n/**\n * Implementation  of IpcAppFunctions\n */\nclass IpcAppHandler extends IpcHandler implements IpcAppFunctions {\n  public get channelName() { return ipcAppChannels.functions; }\n\n  private _iModelKeyToPullStatus = new Map<string, ProgressStatus>();\n\n  public async log(_timestamp: number, level: LogLevel, category: string, message: string, metaData?: any): Promise<void> {\n    switch (level) {\n      case LogLevel.Error:\n        Logger.logError(category, message, metaData);\n        break;\n      case LogLevel.Info:\n        Logger.logInfo(category, message, metaData);\n        break;\n      case LogLevel.Trace:\n        Logger.logTrace(category, message, metaData);\n        break;\n      case LogLevel.Warning:\n        Logger.logWarning(category, message, metaData);\n        break;\n    }\n  }\n\n  public async cancelTileContentRequests(tokenProps: IModelRpcProps, contentIds: TileTreeContentIds[]): Promise<void> {\n    return cancelTileContentRequests(tokenProps, contentIds);\n  }\n  public async cancelElementGraphicsRequests(key: string, requestIds: string[]): Promise<void> {\n    return IModelDb.findByKey(key)[_nativeDb].cancelElementGraphicsRequests(requestIds);\n  }\n  public async openBriefcase(args: OpenBriefcaseProps): Promise<BriefcaseConnectionProps> {\n    const db = await BriefcaseDb.open(args);\n    return db.toJSON();\n  }\n  public async openCheckpoint(checkpoint: OpenCheckpointArgs): Promise<IModelConnectionProps> {\n    return (await SnapshotDb.openCheckpoint(checkpoint)).getConnectionProps();\n  }\n  public async openStandalone(filePath: string, openMode: OpenMode, opts?: StandaloneOpenOptions): Promise<IModelConnectionProps> {\n    return StandaloneDb.openFile(filePath, openMode, opts).getConnectionProps();\n  }\n  public async openSnapshot(filePath: string, opts?: SnapshotOpenOptions): Promise<IModelConnectionProps> {\n    let resolvedFileName: string | undefined = filePath;\n    if (IModelHost.snapshotFileNameResolver) { // eslint-disable-line @typescript-eslint/no-deprecated\n      resolvedFileName = IModelHost.snapshotFileNameResolver.tryResolveFileName(filePath); // eslint-disable-line @typescript-eslint/no-deprecated\n      if (!resolvedFileName)\n        throw new IModelNotFoundResponse(); // eslint-disable-line @typescript-eslint/only-throw-error\n    }\n    return SnapshotDb.openFile(resolvedFileName, opts).getConnectionProps();\n  }\n  public async closeIModel(key: string): Promise<void> {\n    IModelDb.findByKey(key).close();\n  }\n  public async saveChanges(key: string, description?: string): Promise<void> {\n    IModelDb.findByKey(key)[_implicitTxn].saveChanges(description);\n  }\n  public async abandonChanges(key: string): Promise<void> {\n    IModelDb.findByKey(key)[_implicitTxn].abandonChanges();\n  }\n  public async hasPendingTxns(key: string): Promise<boolean> {\n    return IModelDb.findByKey(key)[_nativeDb].hasPendingTxns();\n  }\n\n  public async isUndoPossible(key: string): Promise<boolean> {\n    return IModelDb.findByKey(key)[_nativeDb].isUndoPossible();\n  }\n  public async isRedoPossible(key: string): Promise<boolean> {\n    return IModelDb.findByKey(key)[_nativeDb].isRedoPossible();\n  }\n  public async getUndoString(key: string): Promise<string> {\n    return IModelDb.findByKey(key)[_nativeDb].getUndoString();\n  }\n  public async getRedoString(key: string): Promise<string> {\n    return IModelDb.findByKey(key)[_nativeDb].getRedoString();\n  }\n\n  public async pullChanges(key: string, toIndex?: ChangesetIndex, options?: PullChangesOptions): Promise<ChangesetIndexAndId> {\n    const iModelDb = BriefcaseDb.findByKey(key);\n\n    this._iModelKeyToPullStatus.set(key, ProgressStatus.Continue);\n    const checkAbort = () => this._iModelKeyToPullStatus.get(key) ?? ProgressStatus.Continue;\n\n    let onProgress: ProgressFunction | undefined;\n    if (options?.reportProgress) {\n      const progressCallback: ProgressFunction = (loaded, total) => {\n        IpcHost.send(getPullChangesIpcChannel(iModelDb.iModelId), { loaded, total });\n        return checkAbort();\n      };\n      onProgress = throttleProgressCallback(progressCallback, checkAbort, options?.progressInterval);\n    } else if (options?.enableCancellation) {\n      onProgress = checkAbort;\n    }\n\n    try {\n      await iModelDb.pullChanges({ toIndex, onProgress });\n    } finally {\n      this._iModelKeyToPullStatus.delete(key);\n    }\n\n    return iModelDb.changeset as ChangesetIndexAndId;\n  }\n  public async cancelPullChangesRequest(key: string): Promise<void> {\n    this._iModelKeyToPullStatus.set(key, ProgressStatus.Abort);\n  }\n\n  public async pushChanges(key: string, description: string): Promise<ChangesetIndexAndId> {\n    const iModelDb = BriefcaseDb.findByKey(key);\n    await iModelDb.pushChanges({ description });\n    return iModelDb.changeset as ChangesetIndexAndId;\n  }\n\n  public async toggleGraphicalEditingScope(key: string, startSession: boolean): Promise<boolean> {\n    const val: IModelJsNative.ErrorStatusOrResult<any, boolean> = IModelDb.findByKey(key)[_nativeDb].setGeometricModelTrackingEnabled(startSession);\n    if (val.error)\n      throw new IModelError(val.error.status, \"Failed to toggle graphical editing scope\");\n    assert(undefined !== val.result);\n    return val.result;\n  }\n  public async isGraphicalEditingSupported(key: string): Promise<boolean> {\n    return IModelDb.findByKey(key)[_nativeDb].isGeometricModelTrackingSupported();\n  }\n\n  public async reverseTxns(key: string, numOperations: number): Promise<IModelStatus> {\n    return BriefcaseDb.findByKey(key).txns.reverseTxns(numOperations);\n  }\n\n  public async reverseTxnsAsync(key: string, numOperations: number, args?: ReverseTxnArgs): Promise<void> {\n    return BriefcaseDb.findByKey(key).txns.reverseTxnsAsync(numOperations, args);\n  }\n\n  public async reverseAllTxn(key: string): Promise<IModelStatus> {\n    return BriefcaseDb.findByKey(key).txns.reverseAll();\n  }\n\n  public async reverseAllTxnsAsync(key: string, args?: ReverseTxnArgs): Promise<void> {\n    return BriefcaseDb.findByKey(key).txns.reverseAllTxnsAsync(args);\n  }\n\n  public async reinstateTxn(key: string): Promise<IModelStatus> {\n    return BriefcaseDb.findByKey(key).txns.reinstateTxn();\n  }\n\n  public async reinstateTxnAsync(key: string, args?: ReinstateTxnArgs): Promise<void> {\n    return BriefcaseDb.findByKey(key).txns.reinstateTxnAsync(args);\n  }\n\n  public async restartTxnSession(key: string): Promise<void> {\n    return IModelDb.findByKey(key).restartTxnSession();\n  }\n\n  public async queryConcurrency(pool: \"io\" | \"cpu\"): Promise<number> {\n    return IModelNative.platform.queryConcurrency(pool);\n  }\n}\n\n/**\n * Prevents progress callback being called more frequently when provided interval.\n * @internal\n */\nexport function throttleProgressCallback(func: ProgressFunction, checkAbort: () => ProgressStatus, progressInterval?: number): ProgressFunction {\n  const interval = progressInterval ?? 250; // by default, only send progress events every 250 milliseconds\n  let nextTime = Date.now() + interval;\n  const progressCallback: ProgressFunction = (loaded, total) => {\n    const now = Date.now();\n    if (loaded >= total || now >= nextTime) {\n      nextTime = now + interval;\n      return func(loaded, total);\n    }\n    return checkAbort();\n  };\n\n  return progressCallback;\n}\n"]}
+{"version":3,"file":"IpcHost.js","sourceRoot":"","sources":["../../src/IpcHost.ts"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n* See LICENSE.md in the project root for license terms and full copyright notice.\n*--------------------------------------------------------------------------------------------*/\n/** @packageDocumentation\n * @module NativeApp\n */\n\nimport { IModelJsNative } from \"@bentley/imodeljs-native\";\nimport { assert, IModelStatus, Logger, LogLevel, OpenMode, PickAsyncMethods } from \"@itwin/core-bentley\";\nimport {\n  BriefcaseConnectionProps,\n  ChangesetIndex, ChangesetIndexAndId, createIpcDispatcher, createIpcProxy, EditingScopeNotifications, getPullChangesIpcChannel, IModelConnectionProps, IModelError, IModelNotFoundResponse, IModelRpcProps,\n  ipcAppChannels, IpcAppFunctions, IpcAppNotifications, IpcInvokeReturn, IpcListener, IpcSocketBackend, iTwinChannel,\n  OpenBriefcaseProps, OpenCheckpointArgs, PullChangesOptions, ReinstateTxnArgs, RemoveFunction, ReverseTxnArgs, SnapshotOpenOptions,\n  StandaloneOpenOptions, TileTreeContentIds, TxnNotifications, unwrapIpcInvokeReturn,\n} from \"@itwin/core-common\";\nimport { ProgressFunction, ProgressStatus } from \"./CheckpointManager\";\nimport { BriefcaseDb, IModelDb, SnapshotDb, StandaloneDb } from \"./IModelDb\";\nimport { IModelHost, IModelHostOptions } from \"./IModelHost\";\nimport { IModelNative } from \"./internal/NativePlatform\";\nimport { _implicitTxn, _nativeDb } from \"./internal/Symbols\";\nimport { cancelTileContentRequests } from \"./rpc-impl/IModelTileRpcImpl\";\n\n/**\n  * Options for [[IpcHost.startup]]\n  * @public\n  */\nexport interface IpcHostOpts {\n  iModelHost?: IModelHostOptions;\n  ipcHost?: {\n    /** The Ipc socket to use for communications with frontend. Allows undefined only for headless tests. */\n    socket?: IpcSocketBackend;\n\n    /** don't send stack information on exceptions */\n    exceptions?: {\n      noStack?: boolean;\n    };\n  };\n}\n\n/**\n * Used by applications that have a dedicated backend. IpcHosts may send messages to their corresponding IpcApp.\n * @note if either end terminates, the other must too.\n * @public\n */\nexport class IpcHost {\n  public static noStack = false;\n  private static _ipc: IpcSocketBackend | undefined;\n  /** Get the implementation of the [IpcSocketBackend]($common) interface. */\n  private static get ipc(): IpcSocketBackend { return this._ipc!; } // eslint-disable-line @typescript-eslint/no-non-null-assertion\n  /** Determine whether Ipc is available for this backend. This will only be true if [[startup]] has been called on this class. */\n  public static get isValid(): boolean { return undefined !== this._ipc; }\n\n  /**\n   * Send a message to the frontend over an Ipc channel.\n   * @param channel the name of the channel matching the name registered with [[IpcApp.addListener]].\n   * @param data The content of the message.\n   */\n  public static send(channel: string, ...data: any[]): void {\n    this.ipc.send(iTwinChannel(channel), ...data);\n  }\n\n  /**\n   * Establish a handler for an Ipc channel to receive [[Frontend.invoke]] calls\n   * @param channel The name of the channel for this handler.\n   * @param handler A function that supplies the implementation for `channel`\n   * @note returns A function to call to remove the handler.\n   */\n  public static handle(channel: string, handler: (...args: any[]) => Promise<any>): RemoveFunction {\n    return this.ipc.handle(iTwinChannel(channel), handler);\n  }\n  /**\n   * Establish a handler to receive messages sent via [[IpcApp.send]].\n   * @param channel The name of the channel for the messages.\n   * @param listener A function called when messages are sent over `channel`\n   * @note returns A function to call to remove the listener.\n   */\n  public static addListener(channel: string, listener: IpcListener): RemoveFunction {\n    return this.ipc.addListener(iTwinChannel(channel), listener);\n  }\n  /**\n   * Remove a previously registered listener\n   * @param channel The name of the channel for the listener previously registered with [[addListener]]\n   * @param listener The function passed to [[addListener]]\n   */\n  public static removeListener(channel: string, listener: IpcListener): void {\n    this.ipc.removeListener(iTwinChannel(channel), listener);\n  }\n\n  private static _nextInvokeId = 0;\n  private static _pendingInvokes = new Map<number, () => void>();\n\n  /**\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]]\n   * @param channel The name of the channel for the method.\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\n   * primitive types and `ArrayBuffers` are allowed.\n   * @note The returned Promise rejects if [[shutdown]] is called before the frontend responds.\n   * @beta\n   */\n  public static async invoke(channel: string, ...args: any[]): Promise<any> {\n    // Electron has no main->renderer `invoke` (see https://www.electronjs.org/docs/latest/tutorial/ipc#pattern-3-main-to-renderer),\n    // so we synthesize request/response from the universally-available `send`/`addListener` primitives: push the request via\n    // `send` together with a unique per-request response channel, and resolve when the frontend handler replies on that channel.\n    const requestId = ++this._nextInvokeId % Number.MAX_SAFE_INTEGER;\n    const responseChannel = iTwinChannel(`${channel}-invoke_response-${requestId}`);\n\n    return new Promise((resolve, reject) => {\n      let removeListener: RemoveFunction = () => { };\n      const cleanup = () => {\n        removeListener();\n        this._pendingInvokes.delete(requestId);\n      };\n\n      removeListener = this.ipc.addListener(responseChannel, (_evt: Event, result: any) => {\n        cleanup();\n        resolve(result);\n      });\n\n      // allow [[shutdown]] to reject any in-flight invoke rather than leaking its listener forever.\n      this._pendingInvokes.set(requestId, () => {\n        cleanup();\n        reject(new Error(`IpcHost was shut down before the frontend responded on channel \"${channel}\"`));\n      });\n\n      try {\n        this.send(channel, responseChannel, ...args);\n      } catch (err) {\n        // `send` can throw synchronously (e.g. a destroyed Electron window, or a closed websocket). Without this,\n        // the listener and _pendingInvokes entry registered above would leak for the life of the process.\n        cleanup();\n        reject(err instanceof Error ? err : new Error(String(err)));\n      }\n    });\n  }\n\n  /**\n   * Call a method on the frontend through an Ipc channel.\n   * @param channelName the channel registered by the frontend handler.\n   * @param methodName the name of a method implemented by the frontend handler.\n   * @param args arguments to `methodName`\n   * @returns a Promise with the return value from `methodName`\n   */\n  private static async callIpcChannel(channelName: string, methodName: string, ...args: any[]): Promise<any> {\n    const retVal = await this.invoke(channelName, methodName, ...args) as IpcInvokeReturn;\n    return unwrapIpcInvokeReturn(retVal);\n  }\n\n  /**\n   * Create a type safe Proxy object to make IPC calls to a registered frontend interface.\n   * @param channelName the channel registered by the frontend handler.\n   * @beta\n   */\n  public static makeIpcProxy<K, C extends string = string>(channelName: C): PickAsyncMethods<K> {\n    return createIpcProxy<K>(async (methodName: string, ...args: any[]) => IpcHost.callIpcChannel(channelName, methodName, ...args));\n  }\n\n  private static notify(channel: string, briefcase: BriefcaseDb | StandaloneDb, methodName: string, ...args: any[]) {\n    if (this.isValid)\n      return this.send(`${channel}/${briefcase.key}`, methodName, ...args);\n  }\n\n  /** @internal */\n  public static notifyIpcFrontend<T extends keyof IpcAppNotifications>(methodName: T, ...args: Parameters<IpcAppNotifications[T]>) {\n    return IpcHost.send(ipcAppChannels.appNotify, methodName, ...args);\n  }\n\n  /** @internal */\n  public static notifyTxns<T extends keyof TxnNotifications>(briefcase: BriefcaseDb | StandaloneDb, methodName: T, ...args: Parameters<TxnNotifications[T]>) {\n    this.notify(ipcAppChannels.txns, briefcase, methodName, ...args);\n  }\n\n  /** @internal */\n  public static notifyEditingScope<T extends keyof EditingScopeNotifications>(briefcase: BriefcaseDb | StandaloneDb, methodName: T, ...args: Parameters<EditingScopeNotifications[T]>) {\n    this.notify(ipcAppChannels.editingScope, briefcase, methodName, ...args);\n  }\n\n  /**\n   * Start the backend of an Ipc app.\n   * @param opt\n   * @note this method calls [[IModelHost.startup]] internally.\n   */\n  public static async startup(opt?: IpcHostOpts): Promise<void> {\n    this._ipc = opt?.ipcHost?.socket;\n    if (opt?.ipcHost?.exceptions?.noStack)\n      this.noStack = true;\n\n    if (this.isValid) { // for tests, we use IpcHost but don't have a frontend\n      IpcAppHandler.register();\n    }\n\n    await IModelHost.startup(opt?.iModelHost);\n  }\n\n  /** Shutdown IpcHost backend. Also calls [[IModelHost.shutdown]] */\n  public static async shutdown(): Promise<void> {\n    this._ipc = undefined;\n\n    // reject any in-flight invokes so their callers don't hang forever after the socket is gone.\n    const pending = [...this._pendingInvokes.values()];\n    this._pendingInvokes.clear();\n    for (const rejectPending of pending)\n      rejectPending();\n\n    await IModelHost.shutdown();\n  }\n}\n\n/**\n * Base class for all implementations of an Ipc interface.\n *\n * Create a subclass to implement your Ipc interface. Your class should be declared like this:\n * ```ts\n * class MyHandler extends IpcHandler implements MyInterface\n * ```\n * to ensure all methods and signatures are correct.\n *\n * Then, call `MyClass.register` at startup to connect your class to your channel.\n * @public\n */\nexport abstract class IpcHandler {\n  /**\n   * All subclasses *must* implement this method to specify their channel name.\n   *\n   * Channel names are the key that connects Handlers and senders. The channel name of IpcHandlers must exactly match the name used by senders.\n   * By convention, channel names should be prefixed by a *namespace* (e.g. `${appName}/`)\n   * unique enough to disambiguate them from channels for other apps that may be running in the same processes.\n   */\n  public abstract get channelName(): string;\n\n  /**\n   * Register this class as the handler for methods on its channel. This static method creates a new instance\n   * that becomes the handler and is `this` when its methods are called.\n   * @returns A function that can be called to remove the handler.\n   * @note this method should only be called once per channel. If it is called multiple times, subsequent calls replace the previous ones.\n   */\n  public static register(): RemoveFunction {\n    const impl = new (this as any)() as IpcHandler; // create an instance of subclass. \"as any\" is necessary because base class is abstract\n    const dispatch = createIpcDispatcher(impl, impl.channelName, () => !IpcHost.noStack);\n    return IpcHost.handle(impl.channelName, async (_evt: Event, funcName: string, ...args: any[]): Promise<IpcInvokeReturn> => dispatch(funcName, ...args));\n  }\n}\n\n/**\n * Implementation  of IpcAppFunctions\n */\nclass IpcAppHandler extends IpcHandler implements IpcAppFunctions {\n  public get channelName() { return ipcAppChannels.functions; }\n\n  private _iModelKeyToPullStatus = new Map<string, ProgressStatus>();\n\n  public async log(_timestamp: number, level: LogLevel, category: string, message: string, metaData?: any): Promise<void> {\n    switch (level) {\n      case LogLevel.Error:\n        Logger.logError(category, message, metaData);\n        break;\n      case LogLevel.Info:\n        Logger.logInfo(category, message, metaData);\n        break;\n      case LogLevel.Trace:\n        Logger.logTrace(category, message, metaData);\n        break;\n      case LogLevel.Warning:\n        Logger.logWarning(category, message, metaData);\n        break;\n    }\n  }\n\n  public async cancelTileContentRequests(tokenProps: IModelRpcProps, contentIds: TileTreeContentIds[]): Promise<void> {\n    return cancelTileContentRequests(tokenProps, contentIds);\n  }\n  public async cancelElementGraphicsRequests(key: string, requestIds: string[]): Promise<void> {\n    return IModelDb.findByKey(key)[_nativeDb].cancelElementGraphicsRequests(requestIds);\n  }\n  public async openBriefcase(args: OpenBriefcaseProps): Promise<BriefcaseConnectionProps> {\n    const db = await BriefcaseDb.open(args);\n    return db.toJSON();\n  }\n  public async openCheckpoint(checkpoint: OpenCheckpointArgs): Promise<IModelConnectionProps> {\n    return (await SnapshotDb.openCheckpoint(checkpoint)).getConnectionProps();\n  }\n  public async openStandalone(filePath: string, openMode: OpenMode, opts?: StandaloneOpenOptions): Promise<IModelConnectionProps> {\n    return StandaloneDb.openFile(filePath, openMode, opts).getConnectionProps();\n  }\n  public async openSnapshot(filePath: string, opts?: SnapshotOpenOptions): Promise<IModelConnectionProps> {\n    let resolvedFileName: string | undefined = filePath;\n    if (IModelHost.snapshotFileNameResolver) { // eslint-disable-line @typescript-eslint/no-deprecated\n      resolvedFileName = IModelHost.snapshotFileNameResolver.tryResolveFileName(filePath); // eslint-disable-line @typescript-eslint/no-deprecated\n      if (!resolvedFileName)\n        throw new IModelNotFoundResponse(); // eslint-disable-line @typescript-eslint/only-throw-error\n    }\n    return SnapshotDb.openFile(resolvedFileName, opts).getConnectionProps();\n  }\n  public async closeIModel(key: string): Promise<void> {\n    IModelDb.findByKey(key).close();\n  }\n  public async saveChanges(key: string, description?: string): Promise<void> {\n    IModelDb.findByKey(key)[_implicitTxn].saveChanges(description);\n  }\n  public async abandonChanges(key: string): Promise<void> {\n    IModelDb.findByKey(key)[_implicitTxn].abandonChanges();\n  }\n  public async hasPendingTxns(key: string): Promise<boolean> {\n    return IModelDb.findByKey(key)[_nativeDb].hasPendingTxns();\n  }\n\n  public async isUndoPossible(key: string): Promise<boolean> {\n    return IModelDb.findByKey(key)[_nativeDb].isUndoPossible();\n  }\n  public async isRedoPossible(key: string): Promise<boolean> {\n    return IModelDb.findByKey(key)[_nativeDb].isRedoPossible();\n  }\n  public async getUndoString(key: string): Promise<string> {\n    return IModelDb.findByKey(key)[_nativeDb].getUndoString();\n  }\n  public async getRedoString(key: string): Promise<string> {\n    return IModelDb.findByKey(key)[_nativeDb].getRedoString();\n  }\n\n  public async pullChanges(key: string, toIndex?: ChangesetIndex, options?: PullChangesOptions): Promise<ChangesetIndexAndId> {\n    const iModelDb = BriefcaseDb.findByKey(key);\n\n    this._iModelKeyToPullStatus.set(key, ProgressStatus.Continue);\n    const checkAbort = () => this._iModelKeyToPullStatus.get(key) ?? ProgressStatus.Continue;\n\n    let onProgress: ProgressFunction | undefined;\n    if (options?.reportProgress) {\n      const progressCallback: ProgressFunction = (loaded, total) => {\n        IpcHost.send(getPullChangesIpcChannel(iModelDb.iModelId), { loaded, total });\n        return checkAbort();\n      };\n      onProgress = throttleProgressCallback(progressCallback, checkAbort, options?.progressInterval);\n    } else if (options?.enableCancellation) {\n      onProgress = checkAbort;\n    }\n\n    try {\n      await iModelDb.pullChanges({ toIndex, onProgress });\n    } finally {\n      this._iModelKeyToPullStatus.delete(key);\n    }\n\n    return iModelDb.changeset as ChangesetIndexAndId;\n  }\n  public async cancelPullChangesRequest(key: string): Promise<void> {\n    this._iModelKeyToPullStatus.set(key, ProgressStatus.Abort);\n  }\n\n  public async pushChanges(key: string, description: string): Promise<ChangesetIndexAndId> {\n    const iModelDb = BriefcaseDb.findByKey(key);\n    await iModelDb.pushChanges({ description });\n    return iModelDb.changeset as ChangesetIndexAndId;\n  }\n\n  public async toggleGraphicalEditingScope(key: string, startSession: boolean): Promise<boolean> {\n    const val: IModelJsNative.ErrorStatusOrResult<any, boolean> = IModelDb.findByKey(key)[_nativeDb].setGeometricModelTrackingEnabled(startSession);\n    if (val.error)\n      throw new IModelError(val.error.status, \"Failed to toggle graphical editing scope\");\n    assert(undefined !== val.result);\n    return val.result;\n  }\n  public async isGraphicalEditingSupported(key: string): Promise<boolean> {\n    return IModelDb.findByKey(key)[_nativeDb].isGeometricModelTrackingSupported();\n  }\n\n  public async reverseTxns(key: string, numOperations: number): Promise<IModelStatus> {\n    return BriefcaseDb.findByKey(key).txns.reverseTxns(numOperations);\n  }\n\n  public async reverseTxnsAsync(key: string, numOperations: number, args?: ReverseTxnArgs): Promise<void> {\n    return BriefcaseDb.findByKey(key).txns.reverseTxnsAsync(numOperations, args);\n  }\n\n  public async reverseAllTxn(key: string): Promise<IModelStatus> {\n    return BriefcaseDb.findByKey(key).txns.reverseAll();\n  }\n\n  public async reverseAllTxnsAsync(key: string, args?: ReverseTxnArgs): Promise<void> {\n    return BriefcaseDb.findByKey(key).txns.reverseAllTxnsAsync(args);\n  }\n\n  public async reinstateTxn(key: string): Promise<IModelStatus> {\n    return BriefcaseDb.findByKey(key).txns.reinstateTxn();\n  }\n\n  public async reinstateTxnAsync(key: string, args?: ReinstateTxnArgs): Promise<void> {\n    return BriefcaseDb.findByKey(key).txns.reinstateTxnAsync(args);\n  }\n\n  public async restartTxnSession(key: string): Promise<void> {\n    return IModelDb.findByKey(key).restartTxnSession();\n  }\n\n  public async queryConcurrency(pool: \"io\" | \"cpu\"): Promise<number> {\n    return IModelNative.platform.queryConcurrency(pool);\n  }\n}\n\n/**\n * Prevents progress callback being called more frequently when provided interval.\n * @internal\n */\nexport function throttleProgressCallback(func: ProgressFunction, checkAbort: () => ProgressStatus, progressInterval?: number): ProgressFunction {\n  const interval = progressInterval ?? 250; // by default, only send progress events every 250 milliseconds\n  let nextTime = Date.now() + interval;\n  const progressCallback: ProgressFunction = (loaded, total) => {\n    const now = Date.now();\n    if (loaded >= total || now >= nextTime) {\n      nextTime = now + interval;\n      return func(loaded, total);\n    }\n    return checkAbort();\n  };\n\n  return progressCallback;\n}\n"]}

package/lib/esm/SQLiteDb.d.ts

@@ -102,10 +102,12 @@ export declare class SQLiteDb {
     /** Abandon (cancel) the outermost transaction, discarding all changes since last save. Then, restart the default transaction. */
     abandonChanges(): void;
     /**
-     * Apply a changeset file - in the same on-disk format used for iModel changesets - to this SQLiteDb.
-     * Unlike `BriefcaseDb.pullChanges`, this does *not* validate the changeset header (e.g. parentId/changesetId)
-     * against the current state of the database - it simply applies the changes it contains. If applying the
-     * changeset encounters any conflict, or otherwise fails, this method throws (conflicts are never resolved
+     * Apply a raw sqlite changeset file - the plain, uncompressed byte stream produced by the sqlite session
+     * extension - to this SQLiteDb. This is *not* the same on-disk format used for iModel changesets.
+     * Unlike `BriefcaseDb.pullChanges`, this does *not* perform any iModel-style changeset relationship validation (e.g. parentId/changesetId)
+     * against the current state of the database (raw sqlite changesets have no header) - it simply applies the changes it contains. It also does *not*
+     * support DDL/schema changes - raw sqlite changesets cannot represent them. If applying the changeset
+     * encounters any conflict, or otherwise fails, this method throws (conflicts are never resolved
      * automatically).
      * @note this method only throws on failure - it does *not* commit or abandon any changes itself. If it
      * throws, some (but not necessarily all) of the changeset's changes may have already been applied to the
@@ -116,21 +118,28 @@ export declare class SQLiteDb {
      */
     applyChangeset(changesetFile: LocalFileName): void;
     /**
-     * Begin capturing DDL and data changes made to this SQLiteDb, so they may later be saved via [[createChangeset]].
+     * Begin capturing data changes made to this SQLiteDb, so they may later be saved via [[createChangeset]].
      * Intended only to produce changeset files for testing [[applyChangeset]] - not for any other purpose.
+     * @note DDL/schema changes are *not* captured - the raw sqlite changeset format produced by [[createChangeset]]
+     * cannot represent them. [[createChangeset]] throws if any DDL was executed via [[executeDdl]] since tracking began.
      * @internal
      */
     startChangeTracking(): void;
     /**
-     * Execute a DDL statement (e.g. `CREATE TABLE`) so that, if change tracking is active (see [[startChangeTracking]]),
-     * the DDL is captured for inclusion in the changeset produced by [[createChangeset]]. DDL executed via [[executeSQL]]
-     * is *not* captured for change tracking purposes.
+     * Execute a DDL statement (e.g. `CREATE TABLE`). DDL cannot be represented in the raw sqlite changeset format
+     * produced by [[createChangeset]], so it is never included in a changeset regardless of how it is executed.
+     * However, unlike DDL executed via [[executeSQL]], DDL executed via this method *is* recorded by change
+     * tracking (see [[startChangeTracking]]) for detection purposes: if any DDL is executed via this method while
+     * tracking is active, [[createChangeset]] throws rather than silently producing a changeset that omits the
+     * schema change.
      * @internal
      */
     executeDdl(ddl: string): void;
     /**
-     * Write out the changes captured since [[startChangeTracking]] was called to a changeset file, in the same
-     * on-disk format used for iModel changesets.
+     * Write out the changes captured since [[startChangeTracking]] was called to a changeset file, holding the
+     * raw sqlite changeset (the plain, uncompressed byte stream produced by the sqlite session extension). This
+     * is *not* the same on-disk format used for iModel changesets. Throws if any DDL/schema changes were captured,
+     * since raw sqlite changesets cannot represent them.
      * @param changesetFile the local file name to write the changeset to.
      * @internal
      */

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

@@ -1 +1 @@
-{"version":3,"file":"SQLiteDb.d.ts","sourceRoot":"","sources":["../../src/SQLiteDb.ts"],"names":[],"mappings":"AAIA;;GAEG;AAKH,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,aAAa,EAAe,MAAM,oBAAoB,CAAC;AAChE,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAG5C,OAAO,EAAE,eAAe,EAAkB,MAAM,mBAAmB,CAAC;AACpE,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAI/C;;;GAGG;AACH,qBAAa,QAAQ;IACnB,gBAAgB;IAChB,SAAgB,CAAC,SAAS,CAAC,0BAAwC;IACnE,OAAO,CAAC,qBAAqB,CAAyC;IAEtE,gBAAgB;WACF,YAAY,IAAI,QAAQ,CAAC,MAAM;IAI7C;;OAEG;IACI,OAAO,IAAI,IAAI;IAItB;;OAEG;IACI,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IACrC,YAAY;IACL,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,WAAW,CAAC,cAAc,EAAE,MAAM,CAAC,EAAE,QAAQ,CAAC,YAAY,GAAG,IAAI;IAK7G;;OAEG;IACI,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,GAAG,QAAQ,CAAC,UAAU,GAAG,IAAI;IAC7E;;;OAGG;IACI,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,GAAG,QAAQ,CAAC,UAAU,EAAE,SAAS,CAAC,EAAE,WAAW,CAAC,cAAc,GAAG,IAAI;IAKrH;;OAEG;IACI,OAAO,CAAC,WAAW,CAAC,EAAE,OAAO,GAAG,IAAI;IAO3C,4CAA4C;IAC5C,IAAW,MAAM,IAAI,OAAO,CAAqC;IAEjE,qDAAqD;IACrD,IAAW,UAAU,IAAI,OAAO,CAAyC;IAEzE,2CAA2C;IAC3C,SAAS,CAAC,WAAW,CAAC,IAAI,EAAE;QAC1B,uCAAuC;QACvC,SAAS,EAAE,MAAM,CAAC;QAClB,uCAAuC;QACvC,OAAO,EAAE,MAAM,CAAC;QAChB,4CAA4C;QAC5C,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,yFAAyF;QACzF,YAAY,CAAC,EAAE,OAAO,CAAC;KACxB;IAQD;;;MAGE;IACK,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAO9D;;;;;;;;;;;OAWG;IACI,UAAU,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,CAAC,cAAc,EAAE,SAAS,EAAE,MAAM,CAAC,GAAG,CAAC;IAgB1E;;OAEG;IACH,IAAW,cAAc,IAAI,WAAW,CAAC,cAAc,GAAG,SAAS,CAElE;IAED,+JAA+J;IACxJ,kBAAkB,IAAI,MAAM;IAInC;;;;;;;;;;;;OAYG;IACU,mBAAmB,CAAC,CAAC,EAAE,IAAI,EAAE,WAAW,CAAC,eAAe,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC;IAIlG;;OAEG;IACI,MAAM,CAAC,IAAI,CAAC,EAAE,QAAQ,CAAC,YAAY;IAI1C,4GAA4G;IACrG,WAAW,IAAI,IAAI;IAI1B,iIAAiI;IAC1H,cAAc,IAAI,IAAI;IAI7B;;;;;;;;;;;;OAYG;IACI,cAAc,CAAC,aAAa,EAAE,aAAa,GAAG,IAAI;IAIzD;;;;OAIG;IACI,mBAAmB,IAAI,IAAI;IAIlC;;;;;OAKG;IACI,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAIpC;;;;;OAKG;IACI,eAAe,CAAC,aAAa,EAAE,aAAa,GAAG,IAAI;IAI1D;;;;;;;;;OASG;IACI,2BAA2B,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,IAAI,EAAE,eAAe,KAAK,CAAC,GAAG,CAAC;IAa7F;;;;;;;OAOG;IACI,mBAAmB,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,IAAI,EAAE,eAAe,KAAK,CAAC,GAAG,CAAC;IAarF;;;;OAIG;IACI,aAAa,CAAC,aAAa,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,IAAI;IAcjE;;;;SAIK;IACE,sBAAsB,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,UAAO,GAAG,eAAe;IAM7E,+BAA+B;IACxB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,QAAQ;CAIzC;AAED;;;;;;;;;;GAUG;AACH,8BAAsB,iBAAkB,SAAQ,QAAQ;IACtD,SAAS,CAAC,MAAM,CAAC,aAAa;;;MAAwD;IAEtF;;;;;;;;MAQE;IACF,SAAgB,SAAS,EAAE,MAAM,CAAC;IAElC;;;;;OAKG;IACI,mBAAmB,CAAC,QAAQ,EAAE,QAAQ,CAAC,qBAAqB;IAKnE,gFAAgF;IACzE,mBAAmB;IAa1B;;OAEG;IACH,SAAS,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,EAAE,GAAG,GAAG,IAAI;IAE7C;;;OAGG;WACW,WAAW,CAAC,QAAQ,EAAE,aAAa,EAAE,SAAS,CAAC,EAAE,GAAG;IAalE;;;OAGG;IACH,SAAS,CAAC,cAAc;IAaxB;;;;OAIG;IACa,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,GAAG,QAAQ,CAAC,UAAU,EAAE,SAAS,CAAC,EAAE,WAAW,CAAC,cAAc;IAK1G,aAAa,CAAC,GAAG,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,aAAa,CAAC,EAAE;YAAE,SAAS,EAAE,WAAW,CAAC,cAAc,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC;QAAC,SAAS,EAAE,MAAM,IAAI,CAAA;KAAE,yBAAN,IAAI;CAMjJ;AAED,cAAc;AACd,yBAAiB,QAAQ,CAAC;IACxB;;OAEG;IACH,KAAY,YAAY,GAAG,MAAM,CAAC;IAElC;;;OAGG;IACH,UAAiB,qBAAqB;QACpC,uFAAuF;QACvF,QAAQ,CAAC,WAAW,EAAE,YAAY,CAAC;QACnC,qFAAqF;QACrF,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAC;KACrC;IAED;;OAEG;IACH,UAAiB,MAAM;QACrB;;YAEI;QACJ,KAAK,IAAI,IAAI,CAAC;QACd,gDAAgD;QAChD,WAAW,IAAI,MAAM,CAAC;QACtB,mGAAmG;QACnG,OAAO,IAAI,OAAO,CAAC;QACnB,0DAA0D;QAC1D,IAAI;QACF,gCAAgC;QAChC,EAAE,EAAE,cAAc,CAAC,KAAK,EACxB,IAAI,EAAE;YACJ,wCAAwC;YACxC,SAAS,EAAE,MAAM,CAAC;YAClB,0CAA0C;YAC1C,UAAU,EAAE,MAAM,CAAC;YACnB,4BAA4B;YAC5B,GAAG,EAAE,MAAM,CAAC;YACZ,iDAAiD;YACjD,SAAS,CAAC,EAAE,OAAO,CAAC;SACrB,GAAG,IAAI,CAAC;QACX;;aAEK;QACL,IAAI,CAAC,IAAI,EAAE;YACT,kCAAkC;YAClC,QAAQ,EAAE,MAAM,CAAC;YACjB,8CAA8C;YAC9C,MAAM,EAAE,MAAM,CAAC;YACf,6EAA6E;YAC7E,IAAI,CAAC,EAAE,WAAW,CAAC;SACpB,GAAG,UAAU,CAAC;QACf;;aAEK;QACL,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;QAC7B,sBAAsB;QACtB,KAAK,CAAC,IAAI,EAAE;YACV,oCAAoC;YACpC,QAAQ,EAAE,MAAM,CAAC;YACjB,+CAA+C;YAC/C,MAAM,EAAE,MAAM,CAAC;YACf,yBAAyB;YACzB,IAAI,EAAE,WAAW,CAAC;SACnB,GAAG,IAAI,CAAC;KACV;IAED;;OAEG;IACH,KAAY,cAAc;QACxB,4GAA4G;QAC5G,IAAI,IAAI;QACR,4FAA4F;QAC5F,QAAQ,IAAI;QACZ,yEAAyE;QACzE,SAAS,IAAI;QACb,yEAAyE;QACzE,SAAS,IAAI;KACd;IAED,8DAA8D;IAC9D,UAAiB,kBAAkB;QACjC,6DAA6D;QAC7D,SAAS,CAAC,EAAE,OAAO,CAAC;QACpB,sEAAsE;QACtE,SAAS,CAAC,EAAE,OAAO,CAAC;QACpB,oFAAoF;QACpF,aAAa,CAAC,EAAE,OAAO,CAAC;QACxB;;QAEA;QACA,UAAU,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC3B,2FAA2F;QAC3F,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB;IAED,kDAAkD;IAClD,UAAiB,UAAW,SAAQ,kBAAkB;QACpD,gEAAgE;QAChE,QAAQ,EAAE,QAAQ,CAAC;KACpB;IAED,uCAAuC;IACvC,UAAiB,QAAQ;QACvB,8DAA8D;QAC9D,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB;IAED,6CAA6C;IAC7C,KAAY,YAAY,GAAG,kBAAkB,GAAG,QAAQ,CAAC;IAEzD,0CAA0C;IAC1C,UAAiB,cAAc;QAC7B,uCAAuC;QACvC,MAAM,EAAE,MAAM,CAAC;QACf,wEAAwE;QACxE,QAAQ,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAC,UAAU,CAAC;QAC1C,gBAAgB;QAChB,SAAS,CAAC,EAAE,WAAW,CAAC,cAAc,CAAC;KACxC;IAED,sCAAsC;IACtC,UAAiB,YAAa,SAAQ,QAAQ;QAC5C,6FAA6F;QAC7F,IAAI,CAAC,EAAE,aAAa,CAAC;KACtB;CACF"}
+{"version":3,"file":"SQLiteDb.d.ts","sourceRoot":"","sources":["../../src/SQLiteDb.ts"],"names":[],"mappings":"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"}

package/lib/esm/SQLiteDb.js

@@ -191,10 +191,12 @@ export class SQLiteDb {
         this[_nativeDb].abandonChanges();
     }
     /**
-     * Apply a changeset file - in the same on-disk format used for iModel changesets - to this SQLiteDb.
-     * Unlike `BriefcaseDb.pullChanges`, this does *not* validate the changeset header (e.g. parentId/changesetId)
-     * against the current state of the database - it simply applies the changes it contains. If applying the
-     * changeset encounters any conflict, or otherwise fails, this method throws (conflicts are never resolved
+     * Apply a raw sqlite changeset file - the plain, uncompressed byte stream produced by the sqlite session
+     * extension - to this SQLiteDb. This is *not* the same on-disk format used for iModel changesets.
+     * Unlike `BriefcaseDb.pullChanges`, this does *not* perform any iModel-style changeset relationship validation (e.g. parentId/changesetId)
+     * against the current state of the database (raw sqlite changesets have no header) - it simply applies the changes it contains. It also does *not*
+     * support DDL/schema changes - raw sqlite changesets cannot represent them. If applying the changeset
+     * encounters any conflict, or otherwise fails, this method throws (conflicts are never resolved
      * automatically).
      * @note this method only throws on failure - it does *not* commit or abandon any changes itself. If it
      * throws, some (but not necessarily all) of the changeset's changes may have already been applied to the
@@ -207,25 +209,32 @@ export class SQLiteDb {
         this[_nativeDb].applyChangeset(changesetFile);
     }
     /**
-     * Begin capturing DDL and data changes made to this SQLiteDb, so they may later be saved via [[createChangeset]].
+     * Begin capturing data changes made to this SQLiteDb, so they may later be saved via [[createChangeset]].
      * Intended only to produce changeset files for testing [[applyChangeset]] - not for any other purpose.
+     * @note DDL/schema changes are *not* captured - the raw sqlite changeset format produced by [[createChangeset]]
+     * cannot represent them. [[createChangeset]] throws if any DDL was executed via [[executeDdl]] since tracking began.
      * @internal
      */
     startChangeTracking() {
         this[_nativeDb].startChangeTracking();
     }
     /**
-     * Execute a DDL statement (e.g. `CREATE TABLE`) so that, if change tracking is active (see [[startChangeTracking]]),
-     * the DDL is captured for inclusion in the changeset produced by [[createChangeset]]. DDL executed via [[executeSQL]]
-     * is *not* captured for change tracking purposes.
+     * Execute a DDL statement (e.g. `CREATE TABLE`). DDL cannot be represented in the raw sqlite changeset format
+     * produced by [[createChangeset]], so it is never included in a changeset regardless of how it is executed.
+     * However, unlike DDL executed via [[executeSQL]], DDL executed via this method *is* recorded by change
+     * tracking (see [[startChangeTracking]]) for detection purposes: if any DDL is executed via this method while
+     * tracking is active, [[createChangeset]] throws rather than silently producing a changeset that omits the
+     * schema change.
      * @internal
      */
     executeDdl(ddl) {
         this[_nativeDb].executeDdl(ddl);
     }
     /**
-     * Write out the changes captured since [[startChangeTracking]] was called to a changeset file, in the same
-     * on-disk format used for iModel changesets.
+     * Write out the changes captured since [[startChangeTracking]] was called to a changeset file, holding the
+     * raw sqlite changeset (the plain, uncompressed byte stream produced by the sqlite session extension). This
+     * is *not* the same on-disk format used for iModel changesets. Throws if any DDL/schema changes were captured,
+     * since raw sqlite changesets cannot represent them.
      * @param changesetFile the local file name to write the changeset to.
      * @internal
      */