@itwin/core-frontend 5.1.0-dev.38 → 5.1.0-dev.39

package/lib/cjs/IpcApp.js.map

@@ -1 +1 @@
-{"version":3,"file":"IpcApp.js","sourceRoot":"","sources":["../../src/IpcApp.ts"],"names":[],"mappings":";AAAA;;;+FAG+F;AAC/F;;GAEG;;;AAEH,sDAA8F;AAC9F,oDAG4B;AAC5B,uDAA4D;AAC5D,2CAA0D;AAU1D;;;GAGG;AACH,MAAa,MAAM;IACT,MAAM,CAAC,IAAI,CAAgC;IAC3C,MAAM,CAAC,gBAAgB,CAA6B;IAC5D,qEAAqE;IAE7D,MAAM,KAAK,GAAG,KAAwB,OAAO,IAAI,CAAC,IAAK,CAAC,CAAC,CAAC;IAElE,iIAAiI;IAC1H,MAAM,KAAK,OAAO,KAAc,OAAO,SAAS,KAAK,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IAExE;;;;;;;OAOG;IACI,MAAM,CAAC,WAAW,CAAC,OAAe,EAAE,OAAoB;QAC7D,OAAO,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,IAAA,0BAAY,EAAC,OAAO,CAAC,EAAE,OAAO,CAAC,CAAC;IAC9D,CAAC;IAED;;;;OAIG;IACI,MAAM,CAAC,cAAc,CAAC,OAAe,EAAE,QAAqB;QACjE,IAAI,CAAC,GAAG,CAAC,cAAc,CAAC,IAAA,0BAAY,EAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,CAAC;IAC3D,CAAC;IAED;;;;;;;;;OASG;IACI,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,OAAe,EAAE,GAAG,IAAW;QACxD,OAAO,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,IAAA,0BAAY,EAAC,OAAO,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC;IACzD,CAAC;IAED;;;;;;OAMG;IACI,MAAM,CAAC,IAAI,CAAC,OAAe,EAAE,GAAG,IAAW;QAChD,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,IAAA,0BAAY,EAAC,OAAO,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC;IACvD,CAAC;IAED;;;;;;;;OAQG;IACI,MAAM,CAAC,KAAK,CAAC,CAAC,yBAAe,CAAC,CAAC,WAAmB,EAAE,UAAkB,EAAE,GAAG,IAAW;QAC3F,MAAM,MAAM,GAAG,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,UAAU,EAAE,GAAG,IAAI,CAAC,CAAoB,CAAC;QAExF,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS;YAC5B,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,wBAAwB;QAEhD,sDAAsD;QACtD,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC;QACzB,IAAI,CAAC,wBAAS,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YAC7B,8BAA8B;YAC9B,MAAM,MAAM,CAAC,KAAK,CAAC,CAAC,0DAA0D;QAChF,CAAC;QAED,yIAAyI;QACzI,IAAI,CAAC,2BAAY,CAAC,OAAO,CAAC,GAAG,CAAC;YAC5B,MAAM,MAAM,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,OAAO,GAAG,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,CAAC,EAAE,GAAG,CAAC,CAAC;QAEvG,MAAM,OAAO,GAAG,EAAE,GAAG,GAAG,EAAS,CAAC;QAClC,OAAO,OAAO,CAAC,YAAY,CAAA,CAAC,0EAA0E;QACtG,OAAO,OAAO,CAAC,eAAe,CAAC;QAC/B,MAAM,MAAM,CAAC,MAAM,CAAC,IAAI,0BAAY,CAAC,GAAG,CAAC,WAAW,EAAE,GAAG,CAAC,YAAY,CAAC,GAAG,EAAE,GAAG,CAAC,OAAO,EAAE,GAAG,CAAC,eAAe,CAAC,EAAE,OAAO,CAAC,CAAC;IAC1H,CAAC;IAED;;OAEG;IACI,MAAM,CAAC,KAAK,CAAC,cAAc,CAAC,WAAmB,EAAE,UAAkB,EAAE,GAAG,IAAW;QACxF,OAAO,IAAI,CAAC,yBAAe,CAAC,CAAC,WAAW,EAAE,UAAU,EAAE,GAAG,IAAI,CAAC,CAAC;IACjE,CAAC;IAED;;OAEG;IACI,MAAM,CAAC,YAAY,CAA+B,WAAc;QACrE,OAAO,IAAI,KAAK,CAAC,EAAyB,EAAE;YAC1C,GAAG,CAAC,OAAO,EAAE,UAAkB;gBAC7B,OAAO,KAAK,EAAE,GAAG,IAAW,EAAE,EAAE,CAC9B,MAAM,CAAC,yBAAe,CAAC,CAAC,WAAW,EAAE,UAAU,EAAE,GAAG,IAAI,CAAC,CAAC;YAC9D,CAAC;SACF,CAAC,CAAC;IACL,CAAC;IAED;;;OAGG;IACI,MAAM,CAAC,oBAAoB,CAAI,WAAmB,EAAE,YAAoB;QAC7E,OAAO,IAAI,KAAK,CAAC,EAAyB,EAAE;YAC1C,GAAG,CAAC,OAAO,EAAE,UAAkB;gBAC7B,OAAO,KAAK,EAAE,GAAG,IAAW,EAAE,EAAE,CAC9B,MAAM,CAAC,yBAAe,CAAC,CAAC,WAAW,EAAE,YAAY,EAAE,UAAU,EAAE,GAAG,IAAI,CAAC,CAAC;YAC5E,CAAC;SACF,CAAC,CAAC;IACL,CAAC;IAED,+EAA+E;IACxE,MAAM,CAAC,cAAc,GAAG,MAAM,CAAC,YAAY,CAAkB,4BAAc,CAAC,SAAS,CAAC,CAAC;IAE9F;qFACiF;IAC1E,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,GAAsB,EAAE,IAAoB;QACtE,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC;QAChB,IAAI,CAAC,gBAAgB,GAAG,mBAAmB,CAAC,QAAQ,EAAE,CAAC,CAAC,sCAAsC;QAC9F,MAAM,qBAAS,CAAC,OAAO,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;IAC3C,CAAC;IAED,gBAAgB;IACT,MAAM,CAAC,KAAK,CAAC,QAAQ;QAC1B,IAAI,CAAC,gBAAgB,EAAE,EAAE,CAAC;QAC1B,IAAI,CAAC,IAAI,GAAG,SAAS,CAAC;QACtB,MAAM,qBAAS,CAAC,QAAQ,EAAE,CAAC;IAC7B,CAAC;;AAxIH,wBAyIC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAsB,mBAAmB;IAIhC,YAAY;QACjB,OAAO,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,IAAW,EAAE,QAAgB,EAAE,GAAG,IAAW,EAAE,EAAE;YAC5F,MAAM,IAAI,GAAI,IAAY,CAAC,QAAQ,CAAC,CAAC;YACrC,IAAI,OAAO,IAAI,KAAK,UAAU;gBAC5B,MAAM,IAAI,yBAAW,CAAC,2BAAY,CAAC,gBAAgB,EAAE,WAAW,IAAI,CAAC,WAAW,CAAC,IAAI,IAAI,QAAQ,8DAA8D,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;YAErL,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,CAAC;QAC3B,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;;;;OAKG;IACI,MAAM,CAAC,QAAQ;QACpB,OAAQ,IAAK,IAAY,EAA0B,CAAC,YAAY,EAAE,CAAC,CAAC,uFAAuF;IAC7J,CAAC;CACF;AAvBD,kDAuBC;AAED,wCAAwC;AACxC,MAAM,mBAAoB,SAAQ,mBAAmB;IACnD,IAAW,WAAW,KAAK,OAAO,4BAAc,CAAC,SAAS,CAAC,CAAC,CAAC;IACtD,SAAS,KAAK,CAAC;CACvB","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 { BentleyError, IModelStatus, JsonUtils, PickAsyncMethods } from \"@itwin/core-bentley\";\nimport {\n  BackendError, IModelError, ipcAppChannels, IpcAppFunctions, IpcAppNotifications, IpcInvokeReturn, IpcListener, IpcSocketFrontend, iTwinChannel,\n  RemoveFunction,\n} from \"@itwin/core-common\";\nimport { _callIpcChannel } from \"./common/internal/Symbols\";\nimport { IModelApp, IModelAppOptions } from \"./IModelApp\";\n\n/**\n * Options for [[IpcApp.startup]]\n * @public\n */\nexport interface IpcAppOptions {\n  iModelApp?: IModelAppOptions;\n}\n\n/**\n * The frontend of apps with a dedicated backend that can use [Ipc]($docs/learning/IpcInterface.md).\n * @public\n */\nexport class IpcApp {\n  private static _ipc: IpcSocketFrontend | undefined;\n  private static _removeAppNotify: RemoveFunction | undefined;\n  /** Get the implementation of the [[IpcSocketFrontend]] interface. */\n\n  private static get ipc(): IpcSocketFrontend { return this._ipc!; }\n\n  /** Determine whether Ipc is available for this frontend. 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   * Establish a message handler function for the supplied channel over Ipc. The handler will be called when messages are sent for\n   * the channel via  [[BackendIpc.send]].\n   * @param channel the name of the channel\n   * @param handler the message handler\n   * @returns A function to remove the handler\n   * @note Ipc is only supported if [[isValid]] is true.\n   */\n  public static addListener(channel: string, handler: IpcListener): RemoveFunction {\n    return this.ipc.addListener(iTwinChannel(channel), handler);\n  }\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) {\n    this.ipc.removeListener(iTwinChannel(channel), listener);\n  }\n\n  /**\n   * Send a message to the backend via `channel` and expect a result asynchronously. The handler must be established on the backend via [[BackendIpc.handle]]\n   * @param channel The name of the channel for the method.\n   * @see Electron [ipcRenderer.invoke](https://www.electronjs.org/docs/api/ipc-renderer) documentation for details.\n   * Note that this interface may be implemented via Electron for desktop apps, or via\n   * [WebSockets](https://developer.mozilla.org/en-US/docs/Web/API/WebSockets_API) for mobile or web-based\n   * Ipc connections. In either case, the Electron documentation provides the specifications for how it works.\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   */\n  public static async invoke(channel: string, ...args: any[]): Promise<any> {\n    return this.ipc.invoke(iTwinChannel(channel), ...args);\n  }\n\n  /**\n   * Send a message over the socket.\n   * @param channel The name of the channel for the message.\n   * @param data The optional data of the message.\n   * @note `data` is 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   */\n  public static send(channel: string, ...data: any[]) {\n    return this.ipc.send(iTwinChannel(channel), ...data);\n  }\n\n  /**\n   * Call a method on the backend through an Ipc channel.\n   * @param channelName the channel registered by the backend handler.\n   * @param methodName  the name of a method implemented by the backend handler.\n   * @param args arguments to `methodName`\n   * @return a Promise with the return value from `methodName`\n   * @note If the backend implementation throws an exception, this method will throw an exception with its contents\n   * @internal Use [[makeIpcProxy]] for a type-safe interface.\n   */\n  public static async [_callIpcChannel](channelName: string, methodName: string, ...args: any[]): Promise<any> {\n    const retVal = (await this.invoke(channelName, methodName, ...args)) as IpcInvokeReturn;\n\n    if (retVal.error === undefined)\n      return retVal.result; // method was successful\n\n    // backend threw an exception, rethrow one on frontend\n    const err = retVal.error;\n    if (!JsonUtils.isObject(err)) {\n      // Exception wasn't an object?\n      throw retVal.error; // eslint-disable-line @typescript-eslint/only-throw-error\n    }\n\n    // Note: for backwards compatibility, if the exception was from a BentleyError on the backend, throw an exception of type `BackendError`.\n    if (!BentleyError.isError(err))\n      throw Object.assign(new Error(typeof err.message === \"string\" ? err.message : \"unknown error\"), err);\n\n    const trimErr = { ...err } as any;\n    delete trimErr.iTwinErrorId // these are methods on BackendError and will cause Object.assign to fail.\n    delete trimErr.loggingMetadata;\n    throw Object.assign(new BackendError(err.errorNumber, err.iTwinErrorId.key, err.message, err.loggingMetadata), trimErr);\n  }\n\n  /** @internal\n   * @deprecated in 4.8. Use [[makeIpcProxy]] for a type-safe interface.\n   */\n  public static async callIpcChannel(channelName: string, methodName: string, ...args: any[]): Promise<any> {\n    return this[_callIpcChannel](channelName, methodName, ...args);\n  }\n\n  /** Create a type safe Proxy object to make IPC calls to a registered backend interface.\n   * @param channelName the channel registered by the backend handler.\n   */\n  public static makeIpcProxy<K, C extends string = string>(channelName: C): PickAsyncMethods<K> {\n    return new Proxy({} as PickAsyncMethods<K>, {\n      get(_target, methodName: string) {\n        return async (...args: any[]) =>\n          IpcApp[_callIpcChannel](channelName, methodName, ...args);\n      },\n    });\n  }\n\n  /** Create a type safe Proxy object to call an IPC function on a of registered backend handler that accepts a \"methodName\" argument followed by optional arguments\n   * @param channelName the channel registered by the backend handler.\n   * @param functionName the function to call on the handler.\n   */\n  public static makeIpcFunctionProxy<K>(channelName: string, functionName: string): PickAsyncMethods<K> {\n    return new Proxy({} as PickAsyncMethods<K>, {\n      get(_target, methodName: string) {\n        return async (...args: any[]) =>\n          IpcApp[_callIpcChannel](channelName, functionName, methodName, ...args);\n      },\n    });\n  }\n\n  /** A Proxy to call one of the [IpcAppFunctions]($common) functions via IPC. */\n  public static appFunctionIpc = IpcApp.makeIpcProxy<IpcAppFunctions>(ipcAppChannels.functions);\n\n  /** start an IpcApp.\n   * @note this should not be called directly. It is called by NativeApp.startup */\n  public static async startup(ipc: IpcSocketFrontend, opts?: IpcAppOptions) {\n    this._ipc = ipc;\n    this._removeAppNotify = IpcAppNotifyHandler.register(); // receives notifications from backend\n    await IModelApp.startup(opts?.iModelApp);\n  }\n\n  /** @internal */\n  public static async shutdown() {\n    this._removeAppNotify?.();\n    this._ipc = undefined;\n    await IModelApp.shutdown();\n  }\n}\n\n/**\n * Base class for all implementations of an Ipc notification response interface. This class is implemented on your frontend to supply\n * methods to receive notifications from your backend.\n *\n * Create a subclass to implement your Ipc response interface. Your class should be declared like this:\n * ```ts\n * class MyNotificationHandler extends NotificationHandler implements MyNotifications\n * ```\n * to ensure all method names and signatures are correct. Your methods cannot have a return value.\n *\n * Then, call `MyNotificationHandler.register` at startup to connect your class to your channel.\n * @public\n * @extensions\n */\nexport abstract class NotificationHandler {\n  /** All subclasses must implement this method to specify their response channel name. */\n  public abstract get channelName(): string;\n\n  public registerImpl(): RemoveFunction {\n    return IpcApp.addListener(this.channelName, (_evt: Event, funcName: string, ...args: any[]) => {\n      const func = (this as any)[funcName];\n      if (typeof func !== \"function\")\n        throw new IModelError(IModelStatus.FunctionNotFound, `Method \"${this.constructor.name}.${funcName}\" not found on NotificationHandler registered for channel: ${this.channelName}`);\n\n      func.call(this, ...args);\n    });\n  }\n\n  /**\n   * Register this class as the handler for notifications on its channel. This static method creates a new instance\n   * that becomes the notification 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, multiple handlers are established.\n   */\n  public static register(): RemoveFunction {\n    return (new (this as any)() as NotificationHandler).registerImpl(); // create an instance of subclass. \"as any\" is necessary because base class is abstract\n  }\n}\n\n/** IpcApp notifications from backend */\nclass IpcAppNotifyHandler extends NotificationHandler implements IpcAppNotifications {\n  public get channelName() { return ipcAppChannels.appNotify; }\n  public notifyApp() { }\n}\n"]}
+{"version":3,"file":"IpcApp.js","sourceRoot":"","sources":["../../src/IpcApp.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 { BentleyError, IModelStatus, JsonUtils, PickAsyncMethods } from \"@itwin/core-bentley\";\nimport {\n  BackendError, IModelError, ipcAppChannels, IpcAppFunctions, IpcAppNotifications, IpcInvokeReturn, IpcListener, IpcSocketFrontend, iTwinChannel,\n  RemoveFunction,\n} from \"@itwin/core-common\";\nimport { _callIpcChannel } from \"./common/internal/Symbols\";\nimport { IModelApp, IModelAppOptions } from \"./IModelApp\";\n\n/**\n * Options for [[IpcApp.startup]]\n * @public\n */\nexport interface IpcAppOptions {\n  iModelApp?: IModelAppOptions;\n}\n\n/**\n * The frontend of apps with a dedicated backend that can use [Ipc]($docs/learning/IpcInterface.md).\n * @public\n */\nexport class IpcApp {\n  private static _ipc: IpcSocketFrontend | undefined;\n  private static _removeAppNotify: RemoveFunction | undefined;\n  /** Get the implementation of the [[IpcSocketFrontend]] interface. */\n\n  private static get ipc(): IpcSocketFrontend { return this._ipc!; }\n\n  /** Determine whether Ipc is available for this frontend. 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   * Establish a message handler function for the supplied channel over Ipc. The handler will be called when messages are sent for\n   * the channel via  [[BackendIpc.send]].\n   * @param channel the name of the channel\n   * @param handler the message handler\n   * @returns A function to remove the handler\n   * @note Ipc is only supported if [[isValid]] is true.\n   */\n  public static addListener(channel: string, handler: IpcListener): RemoveFunction {\n    return this.ipc.addListener(iTwinChannel(channel), handler);\n  }\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) {\n    this.ipc.removeListener(iTwinChannel(channel), listener);\n  }\n\n  /**\n   * Send a message to the backend via `channel` and expect a result asynchronously. The handler must be established on the backend via [[BackendIpc.handle]]\n   * @param channel The name of the channel for the method.\n   * @see Electron [ipcRenderer.invoke](https://www.electronjs.org/docs/api/ipc-renderer) documentation for details.\n   * Note that this interface may be implemented via Electron for desktop apps, or via\n   * [WebSockets](https://developer.mozilla.org/en-US/docs/Web/API/WebSockets_API) for mobile or web-based\n   * Ipc connections. In either case, the Electron documentation provides the specifications for how it works.\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   */\n  public static async invoke(channel: string, ...args: any[]): Promise<any> {\n    return this.ipc.invoke(iTwinChannel(channel), ...args);\n  }\n\n  /**\n   * Send a message over the socket.\n   * @param channel The name of the channel for the message.\n   * @param data The optional data of the message.\n   * @note `data` is 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   */\n  public static send(channel: string, ...data: any[]) {\n    return this.ipc.send(iTwinChannel(channel), ...data);\n  }\n\n  /**\n   * Call a method on the backend through an Ipc channel.\n   * @param channelName the channel registered by the backend handler.\n   * @param methodName  the name of a method implemented by the backend handler.\n   * @param args arguments to `methodName`\n   * @return a Promise with the return value from `methodName`\n   * @note If the backend implementation throws an exception, this method will throw an exception with its contents\n   * @internal Use [[makeIpcProxy]] for a type-safe interface.\n   */\n  public static async [_callIpcChannel](channelName: string, methodName: string, ...args: any[]): Promise<any> {\n    const retVal = (await this.invoke(channelName, methodName, ...args)) as IpcInvokeReturn;\n\n    if (retVal.error === undefined)\n      return retVal.result; // method was successful\n\n    // backend threw an exception, rethrow one on frontend\n    const err = retVal.error;\n    if (!JsonUtils.isObject(err)) {\n      // Exception wasn't an object?\n      throw retVal.error; // eslint-disable-line @typescript-eslint/only-throw-error\n    }\n\n    // Note: for backwards compatibility, if the exception was from a BentleyError on the backend, throw an exception of type `BackendError`.\n    if (!BentleyError.isError(err))\n      throw Object.assign(new Error(typeof err.message === \"string\" ? err.message : \"unknown error\"), err);\n\n    const trimErr = { ...err } as any;\n    delete trimErr.iTwinErrorId // these are methods on BackendError and will cause Object.assign to fail.\n    delete trimErr.loggingMetadata;\n    throw Object.assign(new BackendError(err.errorNumber, err.iTwinErrorId.key, err.message, err.loggingMetadata), trimErr);\n  }\n\n  /** @internal\n   * @deprecated in 4.8 - might be removed in next major version. Use [[makeIpcProxy]] for a type-safe interface.\n   */\n  public static async callIpcChannel(channelName: string, methodName: string, ...args: any[]): Promise<any> {\n    return this[_callIpcChannel](channelName, methodName, ...args);\n  }\n\n  /** Create a type safe Proxy object to make IPC calls to a registered backend interface.\n   * @param channelName the channel registered by the backend handler.\n   */\n  public static makeIpcProxy<K, C extends string = string>(channelName: C): PickAsyncMethods<K> {\n    return new Proxy({} as PickAsyncMethods<K>, {\n      get(_target, methodName: string) {\n        return async (...args: any[]) =>\n          IpcApp[_callIpcChannel](channelName, methodName, ...args);\n      },\n    });\n  }\n\n  /** Create a type safe Proxy object to call an IPC function on a of registered backend handler that accepts a \"methodName\" argument followed by optional arguments\n   * @param channelName the channel registered by the backend handler.\n   * @param functionName the function to call on the handler.\n   */\n  public static makeIpcFunctionProxy<K>(channelName: string, functionName: string): PickAsyncMethods<K> {\n    return new Proxy({} as PickAsyncMethods<K>, {\n      get(_target, methodName: string) {\n        return async (...args: any[]) =>\n          IpcApp[_callIpcChannel](channelName, functionName, methodName, ...args);\n      },\n    });\n  }\n\n  /** A Proxy to call one of the [IpcAppFunctions]($common) functions via IPC. */\n  public static appFunctionIpc = IpcApp.makeIpcProxy<IpcAppFunctions>(ipcAppChannels.functions);\n\n  /** start an IpcApp.\n   * @note this should not be called directly. It is called by NativeApp.startup */\n  public static async startup(ipc: IpcSocketFrontend, opts?: IpcAppOptions) {\n    this._ipc = ipc;\n    this._removeAppNotify = IpcAppNotifyHandler.register(); // receives notifications from backend\n    await IModelApp.startup(opts?.iModelApp);\n  }\n\n  /** @internal */\n  public static async shutdown() {\n    this._removeAppNotify?.();\n    this._ipc = undefined;\n    await IModelApp.shutdown();\n  }\n}\n\n/**\n * Base class for all implementations of an Ipc notification response interface. This class is implemented on your frontend to supply\n * methods to receive notifications from your backend.\n *\n * Create a subclass to implement your Ipc response interface. Your class should be declared like this:\n * ```ts\n * class MyNotificationHandler extends NotificationHandler implements MyNotifications\n * ```\n * to ensure all method names and signatures are correct. Your methods cannot have a return value.\n *\n * Then, call `MyNotificationHandler.register` at startup to connect your class to your channel.\n * @public\n * @extensions\n */\nexport abstract class NotificationHandler {\n  /** All subclasses must implement this method to specify their response channel name. */\n  public abstract get channelName(): string;\n\n  public registerImpl(): RemoveFunction {\n    return IpcApp.addListener(this.channelName, (_evt: Event, funcName: string, ...args: any[]) => {\n      const func = (this as any)[funcName];\n      if (typeof func !== \"function\")\n        throw new IModelError(IModelStatus.FunctionNotFound, `Method \"${this.constructor.name}.${funcName}\" not found on NotificationHandler registered for channel: ${this.channelName}`);\n\n      func.call(this, ...args);\n    });\n  }\n\n  /**\n   * Register this class as the handler for notifications on its channel. This static method creates a new instance\n   * that becomes the notification 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, multiple handlers are established.\n   */\n  public static register(): RemoveFunction {\n    return (new (this as any)() as NotificationHandler).registerImpl(); // create an instance of subclass. \"as any\" is necessary because base class is abstract\n  }\n}\n\n/** IpcApp notifications from backend */\nclass IpcAppNotifyHandler extends NotificationHandler implements IpcAppNotifications {\n  public get channelName() { return ipcAppChannels.appNotify; }\n  public notifyApp() { }\n}\n"]}

package/lib/cjs/internal/tile/RealityModelTileTree.d.ts

@@ -8,6 +8,7 @@ import { DisplayStyleState } from "../../DisplayStyleState";
 import { HitDetail } from "../../HitDetail";
 import { IModelConnection } from "../../IModelConnection";
 import { PlanarClipMaskState } from "../../PlanarClipMaskState";
+import { RealityDataSource } from "../../RealityDataSource";
 import { RenderMemory } from "../../render/RenderMemory";
 import { SceneContext } from "../../ViewContext";
 import { ViewState } from "../../ViewState";
@@ -46,6 +47,19 @@ export declare class RealityModelTileUtils {
     static maximumSizeFromGeometricTolerance(range: Range3d, geometricError: number): number;
     static transformFromJson(jTrans: number[] | undefined): Transform;
 }
+/** Exported strictly for tests. */
+export declare class RealityModelTileTreeProps {
+    readonly tilesetToEcef?: Transform | undefined;
+    location: Transform;
+    tilesetJson: any;
+    doDrapeBackgroundMap: boolean;
+    dataSource: RealityDataSource;
+    yAxisUp: boolean;
+    root: any;
+    readonly maximumScreenSpaceError?: number;
+    get usesGeometricError(): boolean;
+    constructor(json: any, root: any, rdSource: RealityDataSource, tilesetToDbTransform: Transform, tilesetToEcef?: Transform | undefined);
+}
 export type RealityModelSource = ViewState | DisplayStyleState;
 /** @internal */
 export declare class RealityModelTileTree extends RealityTileTree {

package/lib/cjs/internal/tile/RealityModelTileTree.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"RealityModelTileTree.d.ts","sourceRoot":"","sources":["../../../../src/internal/tile/RealityModelTileTree.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"RealityModelTileTree.d.ts","sourceRoot":"","sources":["../../../../src/internal/tile/RealityModelTileTree.ts"],"names":[],"mappings":"AAIA;;GAEG;AAEH,OAAO,EAE+C,UAAU,EAC/D,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,iBAAiB,EACoC,gBAAgB,EAA2E,sBAAsB,EACjJ,oBAAoB,EAAE,2BAA2B,EACvE,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAwC,OAAO,EAAE,OAAO,EAAS,SAAS,EAAE,cAAc,EAAiB,MAAM,sBAAsB,CAAC;AAE/I,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EACwG,oBAAoB,EAAE,yBAAyB,EAClI,oBAAoB,EAAiC,yBAAyB,EAAE,mBAAmB,EAAE,WAAW,EAAwC,eAAe,EAAE,qBAAqB,EAAE,kCAAkC,EAC5P,YAAY,EAAiC,QAAQ,EAAE,aAAa,EAAE,iBAAiB,EACxF,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,uBAAuB,EAAE,MAAM,+BAA+B,CAAC;AAgGxE,wBAAgB,8BAA8B,CAAC,KAAK,EAAE,oBAAoB,CAAC,cAAc,GAAG,oBAAoB,CAAC,SAAS,CAEzH;AAMD,qBAAa,iBAAiB;gBAChB,MAAM,EAAE;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE;IAQ3I,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;WAEX,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,iBAAiB;WAU3C,QAAQ,CAAC,cAAc,EAAE,GAAG;IAGnC,QAAQ,IAAI;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,OAAO,EAAE,CAAA;KAAE;CA0B3D;AAED,gBAAgB;AAChB,qBAAa,qBAAqB;WAClB,uBAAuB,CAAC,cAAc,EAAE,GAAG,GAAG;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,OAAO,EAAE,CAAC;QAAC,MAAM,CAAC,EAAE,iBAAiB,CAAA;KAAE,GAAG,SAAS;WAkC7H,iCAAiC,CAAC,KAAK,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,GAAG,MAAM;WAQjF,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,SAAS,GAAG,SAAS;CAGzE;AAQD,mCAAmC;AACnC,qBAAa,yBAAyB;aAa4E,aAAa,CAAC,EAAE,SAAS;IAZlI,QAAQ,EAAE,SAAS,CAAC;IACpB,WAAW,EAAE,GAAG,CAAC;IACjB,oBAAoB,EAAE,OAAO,CAAS;IACtC,UAAU,EAAE,iBAAiB,CAAC;IAC9B,OAAO,UAAS;IAChB,IAAI,EAAE,GAAG,CAAC;IACjB,SAAgB,uBAAuB,CAAC,EAAE,MAAM,CAAC;IAEjD,IAAW,kBAAkB,IAAI,OAAO,CAEvC;gBAEW,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,QAAQ,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,SAAS,EAAkB,aAAa,CAAC,EAAE,SAAS,YAAA;CAgB1I;AAuQD,MAAM,MAAM,kBAAkB,GAAG,SAAS,GAAG,iBAAiB,CAAC;AAE/D,gBAAgB;AAChB,qBAAa,oBAAqB,SAAQ,eAAe;IACvD,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAU;IAC9C,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAuB;IAC9C,iBAAiB,EAAE,mBAAmB,EAAE,CAAM;IAErD,IAAoB,YAAY,yBAAiC;gBAE9C,MAAM,EAAE,qBAAqB;IAOhD,IAAoB,kBAAkB,YAAuC;cAE1D,yBAAyB,CAAC,IAAI,EAAE,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE;CAI9F;AAED,yBAAiB,oBAAoB,CAAC;IACpC,UAAiB,kBAAkB;QACjC,MAAM,EAAE,gBAAgB,CAAC;QACzB,MAAM,EAAE,kBAAkB,CAAC;QAC3B,WAAW,EAAE,oBAAoB,CAAC;QAClC,OAAO,CAAC,EAAE,UAAU,CAAC;QACrB,oBAAoB,CAAC,EAAE,cAAc,CAAC;QACtC,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,WAAW,CAAC,EAAE,uBAAuB,CAAC;QACtC,cAAc,CAAC,EAAE,sBAAsB,CAAC;QACxC,kBAAkB,IAAI,2BAA2B,CAAC;QAClD,iBAAiB,CAAC,IAAI,iBAAiB,CAAC;QACxC,mBAAmB,CAAC,IAAI,gBAAgB,EAAE,CAAC;KAC5C;IAED,UAAiB,cAAe,SAAQ,kBAAkB;QACxD,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,oBAAoB,CAAC,EAAE,MAAM,CAAC;QAC9B,eAAe,CAAC,EAAE,OAAO,CAAC;KAC3B;IAED,eAAsB,SAAU,SAAQ,iBAAiB;QACvD,SAAS,CAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QACjC,SAAS,CAAC,UAAU,CAAC,EAAE,SAAS,CAAC;QACjC,OAAO,CAAC,SAAS,CAAC,CAAU;QAC5B,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAE,kBAAkB,CAAC;QAC/C,SAAS,CAAC,eAAe,CAAC,EAAE,mBAAmB,CAAC;QAChD,SAAS,CAAC,WAAW,CAAC,EAAE,kCAAkC,CAAC;QAC3D,SAAS,CAAC,aAAa,CAAC,EAAE,iBAAiB,CAAC;QAC5C,SAAS,CAAC,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;QACjE,OAAO,CAAC,gBAAgB,CAAgC;QACxD,SAAgB,MAAM,EAAE,gBAAgB,CAAC;QAGzC,aAAoB,OAAO,IAAI,UAAU,CAAC;QAE1C,IAAW,cAAc,IAAI,mBAAmB,GAAG,SAAS,CAAiC;QAC7F,IAAW,cAAc,CAAC,cAAc,EAAE,mBAAmB,GAAG,SAAS,EAA4C;QAErH,IAAoB,sBAAsB,IAAI,MAAM,CAKnD;QAED,SAAS,KAAK,YAAY,IAAI,MAAM,GAAG,SAAS,CAE/C;QAEM,gBAAgB,CAAC,YAAY,CAAC,EAAE,yBAAyB,GAAG,OAAO;oBAOvD,KAAK,EAAE,oBAAoB,CAAC,kBAAkB;QA2BjE,IAAW,uBAAuB,mDAAgI;QAElJ,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI;QAMnD,IAAoB,QAAQ,YAO3B;QAEe,UAAU,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI;QAavD,SAAS,CAAC,gCAAgC,CAAC,OAAO,EAAE,YAAY;QAahD,iBAAiB,CAAC,KAAK,EAAE,oBAAoB,GAAG,IAAI;QAepD,iBAAiB,CAAC,KAAK,EAAE,YAAY,CAAC,UAAU,GAAG,IAAI;QAQvD,cAAc,CAAC,OAAO,EAAE,YAAY,GAAG,YAAY,GAAG,SAAS;KAehF;IAED,SAAsB,0BAA0B,CAC9C,WAAW,EAAE,oBAAoB,EACjC,MAAM,EAAE,gBAAgB,EACxB,OAAO,EAAE,UAAU,EACnB,WAAW,EAAE,SAAS,GAAG,SAAS,EAClC,IAAI,CAAC,EAAE;QAAE,mBAAmB,CAAC,EAAE,OAAO,CAAC;QAAC,eAAe,CAAC,EAAE,OAAO,CAAA;KAAE,GAClE,OAAO,CAAC,QAAQ,GAAG,SAAS,CAAC,CAiB/B;CAqDF;AAED;GACG;AACH,qBAAa,oBAAqB,SAAQ,oBAAoB,CAAC,SAAS;IACtE,SAAS,CAAC,YAAY,EAAE,oBAAoB,CAAC;IAC7C,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAC,CAAU;IAC5C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAa;gBAEnB,KAAK,EAAE,oBAAoB,CAAC,cAAc;IAsB7D,IAAoB,OAAO,WAA4B;IAEvD,OAAO,CAAC,YAAY;IAYpB,IAAW,SAAS,IAAI,aAAa,CAEpC;cAEkB,4BAA4B,IAAI,yBAAyB;IAe5E,OAAO,KAAK,aAAa,GAExB;IAED,IAAoB,YAAY,YAE/B;IAED,cAAuB,kBAAkB,IAAI,OAAO,CAEnD;IAEe,cAAc,CAAC,OAAO,EAAE,YAAY,GAAG,YAAY,GAAG,SAAS;IAmB/D,UAAU,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI;IAWvC,gBAAgB,CAAC,GAAG,EAAE,SAAS,GAAG,OAAO;IAUnC,UAAU,CAAC,GAAG,EAAE,SAAS,GAAG,OAAO,CAAC,WAAW,GAAG,MAAM,GAAG,SAAS,CAAC;IAc3F,OAAO,CAAC,WAAW;IA+CjB,wDAAwD;IAC1C,YAAY,CAAC,KAAK,EAAE,gBAAgB,GAAG,IAAI;IAOrC,eAAe,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;CAI9E"}

package/lib/cjs/internal/tile/RealityModelTileTree.js

@@ -7,7 +7,7 @@
  * @module Utils
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.RealityTreeReference = exports.RealityModelTileTree = exports.RealityModelTileUtils = exports.RealityTileRegion = void 0;
+exports.RealityTreeReference = exports.RealityModelTileTree = exports.RealityModelTileTreeProps = exports.RealityModelTileUtils = exports.RealityTileRegion = void 0;
 exports.createRealityTileTreeReference = createRealityTileTreeReference;
 const core_bentley_1 = require("@itwin/core-bentley");
 const core_common_1 = require("@itwin/core-common");
@@ -199,24 +199,38 @@ var SMTextureType;
     SMTextureType[SMTextureType["Embedded"] = 1] = "Embedded";
     SMTextureType[SMTextureType["Streaming"] = 2] = "Streaming";
 })(SMTextureType || (SMTextureType = {}));
+/** Exported strictly for tests. */
 class RealityModelTileTreeProps {
     tilesetToEcef;
     location;
     tilesetJson;
     doDrapeBackgroundMap = false;
-    rdSource;
+    dataSource;
     yAxisUp = false;
     root;
+    maximumScreenSpaceError;
+    get usesGeometricError() {
+        return undefined !== this.maximumScreenSpaceError;
+    }
     constructor(json, root, rdSource, tilesetToDbTransform, tilesetToEcef) {
         this.tilesetToEcef = tilesetToEcef;
         this.tilesetJson = root;
-        this.rdSource = rdSource;
+        this.dataSource = rdSource;
         this.location = tilesetToDbTransform;
         this.doDrapeBackgroundMap = (json.root && json.root.SMMasterHeader && SMTextureType.Streaming === json.root.SMMasterHeader.IsTextured);
-        if (json.asset.gltfUpAxis === undefined || json.asset.gltfUpAxis === "y" || json.asset.gltfUpAxis === "Y")
+        if (json.asset.gltfUpAxis === undefined || json.asset.gltfUpAxis === "y" || json.asset.gltfUpAxis === "Y") {
             this.yAxisUp = true;
+        }
+        const maxSSE = json.asset.extras?.maximumScreenSpaceError;
+        if (typeof maxSSE === "number") {
+            this.maximumScreenSpaceError = json.asset.extras?.maximumScreenSpaceError;
+        }
+        else if (rdSource.usesGeometricError) {
+            this.maximumScreenSpaceError = rdSource.maximumScreenSpaceError ?? 1;
+        }
     }
 }
+exports.RealityModelTileTreeProps = RealityModelTileTreeProps;
 class RealityModelTileTreeParams {
     gcsConverterAvailable;
     rootToEcef;
@@ -243,7 +257,7 @@ class RealityModelTileTreeParams {
             id: "",
             // If not specified explicitly, additiveRefinement is inherited from parent tile.
             additiveRefinement: undefined !== refine ? "ADD" === refine : undefined,
-            usesGeometricError: loader.tree.rdSource.usesGeometricError,
+            usesGeometricError: loader.tree.usesGeometricError,
         });
         this.baseUrl = baseUrl;
     }
@@ -375,7 +389,7 @@ class RealityModelTileLoader extends internal_1.RealityTileLoader {
     get clipLowResolutionTiles() { return true; }
     get viewFlagOverrides() { return this._viewFlagOverrides; }
     get maximumScreenSpaceError() {
-        return this.tree.rdSource.maximumScreenSpaceError;
+        return this.tree.maximumScreenSpaceError;
     }
     async loadChildren(tile) {
         const props = await this.getChildrenProps(tile);
@@ -404,7 +418,7 @@ class RealityModelTileLoader extends internal_1.RealityTileLoader {
                         transformToRoot: foundChild.transformToRoot,
                         // If not specified explicitly, additiveRefinement is inherited from parent tile.
                         additiveRefinement: undefined !== refine ? refine === "ADD" : undefined,
-                        usesGeometricError: this.tree.rdSource.usesGeometricError,
+                        usesGeometricError: this.tree.usesGeometricError,
                     }));
                 }
             }
@@ -419,7 +433,7 @@ class RealityModelTileLoader extends internal_1.RealityTileLoader {
         const foundChild = await this.findTileInJson(this.tree.tilesetJson, tile.contentId, "");
         if (undefined === foundChild || undefined === foundChild.json.content || isCanceled())
             return undefined;
-        return this.tree.rdSource.getTileContent(getUrl(foundChild.json.content));
+        return this.tree.dataSource.getTileContent(getUrl(foundChild.json.content));
     }
     async findTileInJson(tilesetJson, id, parentId, transformToRoot) {
         if (id.length === 0)
@@ -440,7 +454,7 @@ class RealityModelTileLoader extends internal_1.RealityTileLoader {
         if (separatorIndex >= 0) {
             return this.findTileInJson(foundChild, id.substring(separatorIndex + 1), thisParentId, transformToRoot);
         }
-        tilesetJson.children[childIndex] = await expandSubTree(foundChild, this.tree.rdSource);
+        tilesetJson.children[childIndex] = await expandSubTree(foundChild, this.tree.dataSource);
         return new FindChildResult(thisParentId, tilesetJson.children[childIndex], transformToRoot);
     }
 }
@@ -752,7 +766,7 @@ class RealityTreeReference extends RealityModelTileTree.Reference {
             return undefined;
         const strings = [];
         const loader = tree.loader;
-        const type = loader.tree.rdSource.realityDataType;
+        const type = loader.tree.dataSource.realityDataType;
         // If a type is specified, display it
         if (type !== undefined) {
             // Case insensitive