@itwin/core-frontend 5.0.0-dev.4 → 5.0.0-dev.41

package/lib/cjs/IpcApp.js

@@ -8,6 +8,7 @@
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.NotificationHandler = exports.IpcApp = void 0;
+const core_bentley_1 = require("@itwin/core-bentley");
 const core_common_1 = require("@itwin/core-common");
 const IModelApp_1 = require("./IModelApp");
 const Symbols_1 = require("./common/internal/Symbols");
@@ -120,6 +121,8 @@ class IpcApp {
     static async callIpcHost(methodName, ...args) {
         return this[Symbols_1._callIpcChannel](core_common_1.ipcAppChannels.functions, methodName, ...args);
     }
+    /** A Proxy to call one of the [IpcAppFunctions]($common) functions via IPC. */
+    static { this.appFunctionIpc = IpcApp.makeIpcProxy(core_common_1.ipcAppChannels.functions); }
     /** start an IpcApp.
      * @note this should not be called directly. It is called by NativeApp.startup */
     static async startup(ipc, opts) {
@@ -134,8 +137,6 @@ class IpcApp {
     }
 }
 exports.IpcApp = IpcApp;
-/** A Proxy to call one of the [IpcAppFunctions]($common) functions via IPC. */
-IpcApp.appFunctionIpc = IpcApp.makeIpcProxy(core_common_1.ipcAppChannels.functions);
 /**
  * Base class for all implementations of an Ipc notification response interface. This class is implemented on your frontend to supply
  * methods to receive notifications from your backend.
@@ -155,7 +156,7 @@ class NotificationHandler {
         return IpcApp.addListener(this.channelName, (_evt, funcName, ...args) => {
             const func = this[funcName];
             if (typeof func !== "function")
-                throw new core_common_1.IModelError(core_common_1.IModelStatus.FunctionNotFound, `Method "${this.constructor.name}.${funcName}" not found on NotificationHandler registered for channel: ${this.channelName}`);
+                throw new core_common_1.IModelError(core_bentley_1.IModelStatus.FunctionNotFound, `Method "${this.constructor.name}.${funcName}" not found on NotificationHandler registered for channel: ${this.channelName}`);
             func.call(this, ...args);
         });
     }

package/lib/cjs/IpcApp.js.map

@@ -1 +1 @@
-{"version":3,"file":"IpcApp.js","sourceRoot":"","sources":["../../src/IpcApp.ts"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\r\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\r\n* See LICENSE.md in the project root for license terms and full copyright notice.\r\n*--------------------------------------------------------------------------------------------*/\r\n/** @packageDocumentation\r\n * @module NativeApp\r\n */\r\n\r\nimport { AsyncMethodsOf, PickAsyncMethods, PromiseReturnType } from \"@itwin/core-bentley\";\r\nimport {\r\n  BackendError, IModelError, IModelStatus, ipcAppChannels, IpcAppFunctions, IpcAppNotifications, IpcInvokeReturn, IpcListener, IpcSocketFrontend, iTwinChannel, RemoveFunction,\r\n} from \"@itwin/core-common\";\r\nimport { IModelApp, IModelAppOptions } from \"./IModelApp\";\r\nimport { _callIpcChannel } from \"./common/internal/Symbols\";\r\n\r\n/**\r\n * Options for [[IpcApp.startup]]\r\n * @public\r\n */\r\nexport interface IpcAppOptions {\r\n  iModelApp?: IModelAppOptions;\r\n}\r\n\r\n/**\r\n * The frontend of apps with a dedicated backend that can use [Ipc]($docs/learning/IpcInterface.md).\r\n * @public\r\n */\r\nexport class IpcApp {\r\n  private static _ipc: IpcSocketFrontend | undefined;\r\n  /** Get the implementation of the [[IpcSocketFrontend]] interface. */\r\n\r\n  private static get ipc(): IpcSocketFrontend { return this._ipc!; }\r\n\r\n  /** Determine whether Ipc is available for this frontend. This will only be true if [[startup]] has been called on this class. */\r\n  public static get isValid(): boolean { return undefined !== this._ipc; }\r\n\r\n  /**\r\n   * Establish a message handler function for the supplied channel over Ipc. The handler will be called when messages are sent for\r\n   * the channel via  [[BackendIpc.send]].\r\n   * @param channel the name of the channel\r\n   * @param handler the message handler\r\n   * @returns A function to remove the handler\r\n   * @note Ipc is only supported if [[isValid]] is true.\r\n   */\r\n  public static addListener(channel: string, handler: IpcListener): RemoveFunction {\r\n    return this.ipc.addListener(iTwinChannel(channel), handler);\r\n  }\r\n\r\n  /**\r\n   * Remove a previously registered listener\r\n   * @param channel The name of the channel for the listener previously registered with [[addListener]]\r\n   * @param listener The function passed to [[addListener]]\r\n   */\r\n  public static removeListener(channel: string, listener: IpcListener) {\r\n    this.ipc.removeListener(iTwinChannel(channel), listener);\r\n  }\r\n\r\n  /**\r\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]]\r\n   * @param channel The name of the channel for the method.\r\n   * @see Electron [ipcRenderer.invoke](https://www.electronjs.org/docs/api/ipc-renderer) documentation for details.\r\n   * Note that this interface may be implemented via Electron for desktop apps, or via\r\n   * [WebSockets](https://developer.mozilla.org/en-US/docs/Web/API/WebSockets_API) for mobile or web-based\r\n   * Ipc connections. In either case, the Electron documentation provides the specifications for how it works.\r\n   * @note `args` are serialized with the [Structured Clone Algorithm](https://developer.mozilla.org/en-US/docs/Web/API/Web_Workers_API/Structured_clone_algorithm), so only\r\n   * primitive types and `ArrayBuffers` are allowed.\r\n   */\r\n  public static async invoke(channel: string, ...args: any[]): Promise<any> {\r\n    return this.ipc.invoke(iTwinChannel(channel), ...args);\r\n  }\r\n\r\n  /**\r\n   * Send a message over the socket.\r\n   * @param channel The name of the channel for the message.\r\n   * @param data The optional data of the message.\r\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\r\n   * primitive types and `ArrayBuffers` are allowed.\r\n   */\r\n  public static send(channel: string, ...data: any[]) {\r\n    return this.ipc.send(iTwinChannel(channel), ...data);\r\n  }\r\n\r\n  /**\r\n   * Call a method on the backend through an Ipc channel.\r\n   * @param channelName the channel registered by the backend handler.\r\n   * @param methodName  the name of a method implemented by the backend handler.\r\n   * @param args arguments to `methodName`\r\n   * @return a Promise with the return value from `methodName`\r\n   * @note If the backend implementation throws an exception, this method will throw a [[BackendError]] exception\r\n   * with the `errorNumber` and `message` from the backend.\r\n   * @note Ipc is only supported if [[isValid]] is true.\r\n   * @internal Use [[makeIpcProxy]] for a type-safe interface.\r\n   */\r\n  public static async [_callIpcChannel](channelName: string, methodName: string, ...args: any[]): Promise<any> {\r\n    const retVal = (await this.invoke(channelName, methodName, ...args)) as IpcInvokeReturn;\r\n\r\n    if (undefined !== retVal.iTwinError) {\r\n      const error = new Error();\r\n      if (retVal.iTwinError.stack === undefined)\r\n        delete retVal.iTwinError.stack;\r\n      Object.assign(error, retVal.iTwinError);\r\n      throw error;\r\n    } else if (undefined !== retVal.error) {\r\n      const err = new BackendError(retVal.error.errorNumber, retVal.error.name, retVal.error.message);\r\n      err.stack = retVal.error.stack;\r\n      throw err;\r\n    }\r\n    return retVal.result;\r\n  }\r\n\r\n  /** @internal\r\n   * @deprecated in 4.8. Use [[makeIpcProxy]] for a type-safe interface.\r\n   */\r\n  public static async callIpcChannel(channelName: string, methodName: string, ...args: any[]): Promise<any> {\r\n    return this[_callIpcChannel](channelName, methodName, ...args);\r\n  }\r\n\r\n  /** Create a type safe Proxy object to make IPC calls to a registered backend interface.\r\n   * @param channelName the channel registered by the backend handler.\r\n   */\r\n  public static makeIpcProxy<K>(channelName: string): PickAsyncMethods<K> {\r\n    return new Proxy({} as PickAsyncMethods<K>, {\r\n      get(_target, methodName: string) {\r\n        return async (...args: any[]) =>\r\n          IpcApp[_callIpcChannel](channelName, methodName, ...args);\r\n      },\r\n    });\r\n  }\r\n\r\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\r\n   * @param channelName the channel registered by the backend handler.\r\n   * @param functionName the function to call on the handler.\r\n   */\r\n  public static makeIpcFunctionProxy<K>(channelName: string, functionName: string): PickAsyncMethods<K> {\r\n    return new Proxy({} as PickAsyncMethods<K>, {\r\n      get(_target, methodName: string) {\r\n        return async (...args: any[]) =>\r\n          IpcApp[_callIpcChannel](channelName, functionName, methodName, ...args);\r\n      },\r\n    });\r\n  }\r\n\r\n  /** @deprecated in 3.x. use [[appFunctionIpc]] */\r\n  public static async callIpcHost<T extends AsyncMethodsOf<IpcAppFunctions>>(methodName: T, ...args: Parameters<IpcAppFunctions[T]>) {\r\n    return this[_callIpcChannel](ipcAppChannels.functions, methodName, ...args) as PromiseReturnType<IpcAppFunctions[T]>;\r\n  }\r\n\r\n  /** A Proxy to call one of the [IpcAppFunctions]($common) functions via IPC. */\r\n  public static appFunctionIpc = IpcApp.makeIpcProxy<IpcAppFunctions>(ipcAppChannels.functions);\r\n\r\n  /** start an IpcApp.\r\n   * @note this should not be called directly. It is called by NativeApp.startup */\r\n  public static async startup(ipc: IpcSocketFrontend, opts?: IpcAppOptions) {\r\n    this._ipc = ipc;\r\n    IpcAppNotifyHandler.register(); // receives notifications from backend\r\n    await IModelApp.startup(opts?.iModelApp);\r\n  }\r\n\r\n  /** @internal */\r\n  public static async shutdown() {\r\n    this._ipc = undefined;\r\n    await IModelApp.shutdown();\r\n  }\r\n}\r\n\r\n/**\r\n * Base class for all implementations of an Ipc notification response interface. This class is implemented on your frontend to supply\r\n * methods to receive notifications from your backend.\r\n *\r\n * Create a subclass to implement your Ipc response interface. Your class should be declared like this:\r\n * ```ts\r\n * class MyNotificationHandler extends NotificationHandler implements MyNotifications\r\n * ```\r\n * to ensure all method names and signatures are correct. Your methods cannot have a return value.\r\n *\r\n * Then, call `MyNotificationHandler.register` at startup to connect your class to your channel.\r\n * @public\r\n * @extensions\r\n */\r\nexport abstract class NotificationHandler {\r\n  /** All subclasses must implement this method to specify their response channel name. */\r\n  public abstract get channelName(): string;\r\n\r\n  public registerImpl(): RemoveFunction {\r\n    return IpcApp.addListener(this.channelName, (_evt: Event, funcName: string, ...args: any[]) => {\r\n      const func = (this as any)[funcName];\r\n      if (typeof func !== \"function\")\r\n        throw new IModelError(IModelStatus.FunctionNotFound, `Method \"${this.constructor.name}.${funcName}\" not found on NotificationHandler registered for channel: ${this.channelName}`);\r\n\r\n      func.call(this, ...args);\r\n    });\r\n  }\r\n\r\n  /**\r\n   * Register this class as the handler for notifications on its channel. This static method creates a new instance\r\n   * that becomes the notification handler and is `this` when its methods are called.\r\n   * @returns A function that can be called to remove the handler.\r\n   * @note this method should only be called once per channel. If it is called multiple times, multiple handlers are established.\r\n   */\r\n  public static register(): RemoveFunction {\r\n    return (new (this as any)() as NotificationHandler).registerImpl(); // create an instance of subclass. \"as any\" is necessary because base class is abstract\r\n  }\r\n}\r\n\r\n/** IpcApp notifications from backend */\r\nclass IpcAppNotifyHandler extends NotificationHandler implements IpcAppNotifications {\r\n  public get channelName() { return ipcAppChannels.appNotify; }\r\n  public notifyApp() { }\r\n}\r\n"]}
+{"version":3,"file":"IpcApp.js","sourceRoot":"","sources":["../../src/IpcApp.ts"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\r\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\r\n* See LICENSE.md in the project root for license terms and full copyright notice.\r\n*--------------------------------------------------------------------------------------------*/\r\n/** @packageDocumentation\r\n * @module NativeApp\r\n */\r\n\r\nimport { AsyncMethodsOf, IModelStatus, PickAsyncMethods, PromiseReturnType } from \"@itwin/core-bentley\";\r\nimport {\r\n  BackendError, IModelError, ipcAppChannels, IpcAppFunctions, IpcAppNotifications, IpcInvokeReturn, IpcListener, IpcSocketFrontend, iTwinChannel, RemoveFunction,\r\n} from \"@itwin/core-common\";\r\nimport { IModelApp, IModelAppOptions } from \"./IModelApp\";\r\nimport { _callIpcChannel } from \"./common/internal/Symbols\";\r\n\r\n/**\r\n * Options for [[IpcApp.startup]]\r\n * @public\r\n */\r\nexport interface IpcAppOptions {\r\n  iModelApp?: IModelAppOptions;\r\n}\r\n\r\n/**\r\n * The frontend of apps with a dedicated backend that can use [Ipc]($docs/learning/IpcInterface.md).\r\n * @public\r\n */\r\nexport class IpcApp {\r\n  private static _ipc: IpcSocketFrontend | undefined;\r\n  /** Get the implementation of the [[IpcSocketFrontend]] interface. */\r\n\r\n  private static get ipc(): IpcSocketFrontend { return this._ipc!; }\r\n\r\n  /** Determine whether Ipc is available for this frontend. This will only be true if [[startup]] has been called on this class. */\r\n  public static get isValid(): boolean { return undefined !== this._ipc; }\r\n\r\n  /**\r\n   * Establish a message handler function for the supplied channel over Ipc. The handler will be called when messages are sent for\r\n   * the channel via  [[BackendIpc.send]].\r\n   * @param channel the name of the channel\r\n   * @param handler the message handler\r\n   * @returns A function to remove the handler\r\n   * @note Ipc is only supported if [[isValid]] is true.\r\n   */\r\n  public static addListener(channel: string, handler: IpcListener): RemoveFunction {\r\n    return this.ipc.addListener(iTwinChannel(channel), handler);\r\n  }\r\n\r\n  /**\r\n   * Remove a previously registered listener\r\n   * @param channel The name of the channel for the listener previously registered with [[addListener]]\r\n   * @param listener The function passed to [[addListener]]\r\n   */\r\n  public static removeListener(channel: string, listener: IpcListener) {\r\n    this.ipc.removeListener(iTwinChannel(channel), listener);\r\n  }\r\n\r\n  /**\r\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]]\r\n   * @param channel The name of the channel for the method.\r\n   * @see Electron [ipcRenderer.invoke](https://www.electronjs.org/docs/api/ipc-renderer) documentation for details.\r\n   * Note that this interface may be implemented via Electron for desktop apps, or via\r\n   * [WebSockets](https://developer.mozilla.org/en-US/docs/Web/API/WebSockets_API) for mobile or web-based\r\n   * Ipc connections. In either case, the Electron documentation provides the specifications for how it works.\r\n   * @note `args` are serialized with the [Structured Clone Algorithm](https://developer.mozilla.org/en-US/docs/Web/API/Web_Workers_API/Structured_clone_algorithm), so only\r\n   * primitive types and `ArrayBuffers` are allowed.\r\n   */\r\n  public static async invoke(channel: string, ...args: any[]): Promise<any> {\r\n    return this.ipc.invoke(iTwinChannel(channel), ...args);\r\n  }\r\n\r\n  /**\r\n   * Send a message over the socket.\r\n   * @param channel The name of the channel for the message.\r\n   * @param data The optional data of the message.\r\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\r\n   * primitive types and `ArrayBuffers` are allowed.\r\n   */\r\n  public static send(channel: string, ...data: any[]) {\r\n    return this.ipc.send(iTwinChannel(channel), ...data);\r\n  }\r\n\r\n  /**\r\n   * Call a method on the backend through an Ipc channel.\r\n   * @param channelName the channel registered by the backend handler.\r\n   * @param methodName  the name of a method implemented by the backend handler.\r\n   * @param args arguments to `methodName`\r\n   * @return a Promise with the return value from `methodName`\r\n   * @note If the backend implementation throws an exception, this method will throw a [[BackendError]] exception\r\n   * with the `errorNumber` and `message` from the backend.\r\n   * @note Ipc is only supported if [[isValid]] is true.\r\n   * @internal Use [[makeIpcProxy]] for a type-safe interface.\r\n   */\r\n  public static async [_callIpcChannel](channelName: string, methodName: string, ...args: any[]): Promise<any> {\r\n    const retVal = (await this.invoke(channelName, methodName, ...args)) as IpcInvokeReturn;\r\n\r\n    if (undefined !== retVal.iTwinError) {\r\n      const error = new Error();\r\n      if (retVal.iTwinError.stack === undefined)\r\n        delete retVal.iTwinError.stack;\r\n      Object.assign(error, retVal.iTwinError);\r\n      throw error;\r\n    } else if (undefined !== retVal.error) {\r\n      const err = new BackendError(retVal.error.errorNumber, retVal.error.name, retVal.error.message);\r\n      err.stack = retVal.error.stack;\r\n      throw err;\r\n    }\r\n    return retVal.result;\r\n  }\r\n\r\n  /** @internal\r\n   * @deprecated in 4.8. Use [[makeIpcProxy]] for a type-safe interface.\r\n   */\r\n  public static async callIpcChannel(channelName: string, methodName: string, ...args: any[]): Promise<any> {\r\n    return this[_callIpcChannel](channelName, methodName, ...args);\r\n  }\r\n\r\n  /** Create a type safe Proxy object to make IPC calls to a registered backend interface.\r\n   * @param channelName the channel registered by the backend handler.\r\n   */\r\n  public static makeIpcProxy<K>(channelName: string): PickAsyncMethods<K> {\r\n    return new Proxy({} as PickAsyncMethods<K>, {\r\n      get(_target, methodName: string) {\r\n        return async (...args: any[]) =>\r\n          IpcApp[_callIpcChannel](channelName, methodName, ...args);\r\n      },\r\n    });\r\n  }\r\n\r\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\r\n   * @param channelName the channel registered by the backend handler.\r\n   * @param functionName the function to call on the handler.\r\n   */\r\n  public static makeIpcFunctionProxy<K>(channelName: string, functionName: string): PickAsyncMethods<K> {\r\n    return new Proxy({} as PickAsyncMethods<K>, {\r\n      get(_target, methodName: string) {\r\n        return async (...args: any[]) =>\r\n          IpcApp[_callIpcChannel](channelName, functionName, methodName, ...args);\r\n      },\r\n    });\r\n  }\r\n\r\n  /** @deprecated in 3.x. use [[appFunctionIpc]] */\r\n  public static async callIpcHost<T extends AsyncMethodsOf<IpcAppFunctions>>(methodName: T, ...args: Parameters<IpcAppFunctions[T]>) {\r\n    return this[_callIpcChannel](ipcAppChannels.functions, methodName, ...args) as PromiseReturnType<IpcAppFunctions[T]>;\r\n  }\r\n\r\n  /** A Proxy to call one of the [IpcAppFunctions]($common) functions via IPC. */\r\n  public static appFunctionIpc = IpcApp.makeIpcProxy<IpcAppFunctions>(ipcAppChannels.functions);\r\n\r\n  /** start an IpcApp.\r\n   * @note this should not be called directly. It is called by NativeApp.startup */\r\n  public static async startup(ipc: IpcSocketFrontend, opts?: IpcAppOptions) {\r\n    this._ipc = ipc;\r\n    IpcAppNotifyHandler.register(); // receives notifications from backend\r\n    await IModelApp.startup(opts?.iModelApp);\r\n  }\r\n\r\n  /** @internal */\r\n  public static async shutdown() {\r\n    this._ipc = undefined;\r\n    await IModelApp.shutdown();\r\n  }\r\n}\r\n\r\n/**\r\n * Base class for all implementations of an Ipc notification response interface. This class is implemented on your frontend to supply\r\n * methods to receive notifications from your backend.\r\n *\r\n * Create a subclass to implement your Ipc response interface. Your class should be declared like this:\r\n * ```ts\r\n * class MyNotificationHandler extends NotificationHandler implements MyNotifications\r\n * ```\r\n * to ensure all method names and signatures are correct. Your methods cannot have a return value.\r\n *\r\n * Then, call `MyNotificationHandler.register` at startup to connect your class to your channel.\r\n * @public\r\n * @extensions\r\n */\r\nexport abstract class NotificationHandler {\r\n  /** All subclasses must implement this method to specify their response channel name. */\r\n  public abstract get channelName(): string;\r\n\r\n  public registerImpl(): RemoveFunction {\r\n    return IpcApp.addListener(this.channelName, (_evt: Event, funcName: string, ...args: any[]) => {\r\n      const func = (this as any)[funcName];\r\n      if (typeof func !== \"function\")\r\n        throw new IModelError(IModelStatus.FunctionNotFound, `Method \"${this.constructor.name}.${funcName}\" not found on NotificationHandler registered for channel: ${this.channelName}`);\r\n\r\n      func.call(this, ...args);\r\n    });\r\n  }\r\n\r\n  /**\r\n   * Register this class as the handler for notifications on its channel. This static method creates a new instance\r\n   * that becomes the notification handler and is `this` when its methods are called.\r\n   * @returns A function that can be called to remove the handler.\r\n   * @note this method should only be called once per channel. If it is called multiple times, multiple handlers are established.\r\n   */\r\n  public static register(): RemoveFunction {\r\n    return (new (this as any)() as NotificationHandler).registerImpl(); // create an instance of subclass. \"as any\" is necessary because base class is abstract\r\n  }\r\n}\r\n\r\n/** IpcApp notifications from backend */\r\nclass IpcAppNotifyHandler extends NotificationHandler implements IpcAppNotifications {\r\n  public get channelName() { return ipcAppChannels.appNotify; }\r\n  public notifyApp() { }\r\n}\r\n"]}

package/lib/cjs/LocalhostIpcApp.js

@@ -60,6 +60,7 @@ class LocalSession extends core_common_1.IpcSession {
  *  @internal
  */
 class LocalhostIpcApp {
+    static { this._initialized = false; }
     static buildUrlForSocket(base, path = "ipc") {
         const url = new URL(base);
         url.protocol = "ws";
@@ -80,5 +81,4 @@ class LocalhostIpcApp {
     }
 }
 exports.LocalhostIpcApp = LocalhostIpcApp;
-LocalhostIpcApp._initialized = false;
 //# sourceMappingURL=LocalhostIpcApp.js.map

package/lib/cjs/LocalhostIpcApp.js.map

@@ -1 +1 @@
-{"version":3,"file":"LocalhostIpcApp.js","sourceRoot":"","sources":["../../src/LocalhostIpcApp.ts"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\r\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\r\n* See LICENSE.md in the project root for license terms and full copyright notice.\r\n*--------------------------------------------------------------------------------------------*/\r\n/** @packageDocumentation\r\n * @module IModelApp\r\n */\r\n\r\nimport { InterceptedRpcRequest, IpcSession, IpcWebSocket, IpcWebSocketFrontend, IpcWebSocketMessage, IpcWebSocketTransport, rpcOverIpcStrings } from \"@itwin/core-common\";\r\nimport { IpcApp } from \"./IpcApp\";\r\nimport { IModelApp, IModelAppOptions } from \"./IModelApp\";\r\nimport { _callIpcChannel } from \"./common/internal/Symbols\";\r\n\r\n/** @internal */\r\nexport interface LocalHostIpcAppOpts {\r\n  iModelApp?: IModelAppOptions;\r\n\r\n  localhostIpcApp?: {\r\n    socketPort?: number;\r\n    socketUrl?: URL;\r\n  };\r\n}\r\n\r\nclass LocalTransport extends IpcWebSocketTransport {\r\n  private _client: WebSocket;\r\n  private _next: number;\r\n  private _pending?: IpcWebSocketMessage[] = [];\r\n\r\n  public constructor(opts: LocalHostIpcAppOpts) {\r\n    super();\r\n\r\n    let url: URL;\r\n    if (opts?.localhostIpcApp?.socketUrl) {\r\n      url = opts?.localhostIpcApp?.socketUrl;\r\n    } else {\r\n      const port = opts?.localhostIpcApp?.socketPort ?? 3002;\r\n      url = new URL(`ws://localhost:${port}/`);\r\n    }\r\n\r\n    this._client = new WebSocket(url);\r\n    this._next = -1;\r\n\r\n    this._client.addEventListener(\"open\", () => {\r\n      const pending = this._pending!;\r\n      this._pending = undefined;\r\n      pending.forEach((m) => this.send(m));\r\n    });\r\n\r\n    this._client.addEventListener(\"message\", async (event) => {\r\n      const message = await this.notifyIncoming(event.data, this._client);\r\n      if (IpcWebSocketMessage.skip(message)) {\r\n        return;\r\n      }\r\n\r\n      for (const listener of IpcWebSocket.receivers)\r\n        listener({} as Event, message);\r\n    });\r\n  }\r\n\r\n  public send(message: IpcWebSocketMessage): void {\r\n    if (this._pending) {\r\n      this._pending.push(message);\r\n      return;\r\n    }\r\n\r\n    message.sequence = ++this._next;\r\n    const parts = this.serialize(message);\r\n    parts.forEach((part) => this._client.send(part));\r\n  }\r\n}\r\n\r\nclass LocalSession extends IpcSession {\r\n  public override async handleRpc(info: InterceptedRpcRequest) {\r\n    return IpcApp[_callIpcChannel](rpcOverIpcStrings.channelName, \"request\", info);\r\n  }\r\n}\r\n\r\n/**\r\n * To be used only by test applications that want to test web-based editing using localhost.\r\n *  @internal\r\n */\r\nexport class LocalhostIpcApp {\r\n  private static _initialized = false;\r\n  private static _ipc: IpcWebSocketFrontend;\r\n\r\n  public static buildUrlForSocket(base: URL, path = \"ipc\"): URL {\r\n    const url = new URL(base);\r\n    url.protocol = \"ws\";\r\n    url.pathname = [...url.pathname.split(\"/\"), path].filter((v) => v).join(\"/\");\r\n    return url;\r\n  }\r\n\r\n  public static async startup(opts: LocalHostIpcAppOpts) {\r\n    if (!this._initialized) {\r\n      IpcWebSocket.transport = new LocalTransport(opts);\r\n      this._ipc = new IpcWebSocketFrontend();\r\n      this._initialized = true;\r\n    }\r\n\r\n    await IpcApp.startup(this._ipc, opts);\r\n\r\n    if (!IpcSession.active) {\r\n      IpcSession.start(new LocalSession());\r\n      IModelApp.onBeforeShutdown.addListener(() => IpcSession.stop());\r\n    }\r\n  }\r\n}\r\n"]}
+{"version":3,"file":"LocalhostIpcApp.js","sourceRoot":"","sources":["../../src/LocalhostIpcApp.ts"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\r\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\r\n* See LICENSE.md in the project root for license terms and full copyright notice.\r\n*--------------------------------------------------------------------------------------------*/\r\n/** @packageDocumentation\r\n * @module IModelApp\r\n */\r\n\r\nimport { InterceptedRpcRequest, IpcSession, IpcWebSocket, IpcWebSocketFrontend, IpcWebSocketMessage, IpcWebSocketTransport, rpcOverIpcStrings } from \"@itwin/core-common\";\r\nimport { IpcApp } from \"./IpcApp\";\r\nimport { IModelApp, IModelAppOptions } from \"./IModelApp\";\r\nimport { _callIpcChannel } from \"./common/internal/Symbols\";\r\n\r\n/** @internal */\r\nexport interface LocalHostIpcAppOpts {\r\n  iModelApp?: IModelAppOptions;\r\n\r\n  localhostIpcApp?: {\r\n    socketPort?: number;\r\n    socketUrl?: URL;\r\n  };\r\n}\r\n\r\nclass LocalTransport extends IpcWebSocketTransport {\r\n  private _client: WebSocket;\r\n  private _next: number;\r\n  private _pending?: IpcWebSocketMessage[] = [];\r\n\r\n  public constructor(opts: LocalHostIpcAppOpts) {\r\n    super();\r\n\r\n    let url: URL;\r\n    if (opts?.localhostIpcApp?.socketUrl) {\r\n      url = opts?.localhostIpcApp?.socketUrl;\r\n    } else {\r\n      const port = opts?.localhostIpcApp?.socketPort ?? 3002;\r\n      url = new URL(`ws://localhost:${port}/`);\r\n    }\r\n\r\n    this._client = new WebSocket(url);\r\n    this._next = -1;\r\n\r\n    this._client.addEventListener(\"open\", () => {\r\n      const pending = this._pending!;\r\n      this._pending = undefined;\r\n      pending.forEach((m) => this.send(m));\r\n    });\r\n\r\n    this._client.addEventListener(\"message\", async (event) => {\r\n      const message = await this.notifyIncoming(event.data, this._client);\r\n      if (IpcWebSocketMessage.skip(message)) {\r\n        return;\r\n      }\r\n\r\n      for (const listener of IpcWebSocket.receivers)\r\n        listener({} as Event, message);\r\n    });\r\n  }\r\n\r\n  public send(message: IpcWebSocketMessage): void {\r\n    if (this._pending) {\r\n      this._pending.push(message);\r\n      return;\r\n    }\r\n\r\n    message.sequence = ++this._next;\r\n    const parts = this.serialize(message);\r\n    parts.forEach((part) => this._client.send(part));\r\n  }\r\n}\r\n\r\nclass LocalSession extends IpcSession {\r\n  public override async handleRpc(info: InterceptedRpcRequest) {\r\n    return IpcApp[_callIpcChannel](rpcOverIpcStrings.channelName, \"request\", info);\r\n  }\r\n}\r\n\r\n/**\r\n * To be used only by test applications that want to test web-based editing using localhost.\r\n *  @internal\r\n */\r\nexport class LocalhostIpcApp {\r\n  private static _initialized = false;\r\n  private static _ipc: IpcWebSocketFrontend;\r\n\r\n  public static buildUrlForSocket(base: URL, path = \"ipc\"): URL {\r\n    const url = new URL(base);\r\n    url.protocol = \"ws\";\r\n    url.pathname = [...url.pathname.split(\"/\"), path].filter((v) => v).join(\"/\");\r\n    return url;\r\n  }\r\n\r\n  public static async startup(opts: LocalHostIpcAppOpts) {\r\n    if (!this._initialized) {\r\n      IpcWebSocket.transport = new LocalTransport(opts);\r\n      this._ipc = new IpcWebSocketFrontend();\r\n      this._initialized = true;\r\n    }\r\n\r\n    await IpcApp.startup(this._ipc, opts);\r\n\r\n    if (!IpcSession.active) {\r\n      IpcSession.start(new LocalSession());\r\n      IModelApp.onBeforeShutdown.addListener(() => IpcSession.stop());\r\n    }\r\n  }\r\n}\r\n"]}

package/lib/cjs/NativeApp.js

@@ -6,7 +6,6 @@
 /** @packageDocumentation
  * @module NativeApp
  */
-var _a;
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Storage = exports.NativeApp = void 0;
 const core_bentley_1 = require("@itwin/core-bentley");
@@ -33,6 +32,15 @@ class NativeApp {
     static async callNativeHost(methodName, ...args) {
         return IpcApp_1.IpcApp[Symbols_1._callIpcChannel](core_common_1.nativeAppIpcStrings.channelName, methodName, ...args);
     }
+    /** A Proxy to call one of the [NativeAppFunctions]($common) functions via IPC. */
+    static { this.nativeAppIpc = IpcApp_1.IpcApp.makeIpcProxy(core_common_1.nativeAppIpcStrings.channelName); }
+    static { this._storages = new Map(); }
+    static { this._onOnline = async () => {
+        await NativeApp.setConnectivity(core_common_1.OverriddenBy.Browser, core_common_1.InternetConnectivityStatus.Online);
+    }; }
+    static { this._onOffline = async () => {
+        await NativeApp.setConnectivity(core_common_1.OverriddenBy.Browser, core_common_1.InternetConnectivityStatus.Offline);
+    }; }
     static async setConnectivity(by, status) {
         await this.nativeAppIpc.overrideInternetConnectivity(by, status);
     }
@@ -48,6 +56,8 @@ class NativeApp {
             window.removeEventListener("offline", this._onOffline);
         }
     }
+    /** event called when internet connectivity changes, if known */
+    static { this.onInternetConnectivityChanged = new core_bentley_1.BeEvent(); }
     /** determine whether the app currently has internet connectivity, if known */
     static async checkInternetConnectivity() {
         return this.nativeAppIpc.checkInternetConnectivity();
@@ -56,6 +66,7 @@ class NativeApp {
     static async overrideInternetConnectivity(status) {
         return this.nativeAppIpc.overrideInternetConnectivity(core_common_1.OverriddenBy.User, status);
     }
+    static { this._isValid = false; }
     static get isValid() { return this._isValid; }
     /**
      * This is called by either ElectronApp.startup or MobileApp.startup - it should not be called directly
@@ -67,7 +78,7 @@ class NativeApp {
             return;
         this._isValid = true;
         this._removeAppNotify = NativeAppNotifyHandler.register(); // receives notifications from backend
-        _a.hookBrowserConnectivityEvents();
+        NativeApp.hookBrowserConnectivityEvents();
         // initialize current online state.
         if (window.navigator.onLine) {
             await this.setConnectivity(core_common_1.OverriddenBy.Browser, window.navigator.onLine ? core_common_1.InternetConnectivityStatus.Online : core_common_1.InternetConnectivityStatus.Offline);
@@ -76,7 +87,7 @@ class NativeApp {
     /** @internal */
     static async shutdown() {
         this._removeAppNotify?.();
-        _a.unhookBrowserConnectivityEvents();
+        NativeApp.unhookBrowserConnectivityEvents();
         await NativeAppLogger_1.NativeAppLogger.flush();
         await IpcApp_1.IpcApp.shutdown();
         this._isValid = false;
@@ -150,23 +161,10 @@ class NativeApp {
     }
     /** Get the list of existing Storages on the local disk. */
     static async getStorageNames() {
-        return _a.nativeAppIpc.storageMgrNames();
+        return NativeApp.nativeAppIpc.storageMgrNames();
     }
 }
 exports.NativeApp = NativeApp;
-_a = NativeApp;
-/** A Proxy to call one of the [NativeAppFunctions]($common) functions via IPC. */
-NativeApp.nativeAppIpc = IpcApp_1.IpcApp.makeIpcProxy(core_common_1.nativeAppIpcStrings.channelName);
-NativeApp._storages = new Map();
-NativeApp._onOnline = async () => {
-    await _a.setConnectivity(core_common_1.OverriddenBy.Browser, core_common_1.InternetConnectivityStatus.Online);
-};
-NativeApp._onOffline = async () => {
-    await _a.setConnectivity(core_common_1.OverriddenBy.Browser, core_common_1.InternetConnectivityStatus.Offline);
-};
-/** event called when internet connectivity changes, if known */
-NativeApp.onInternetConnectivityChanged = new core_bentley_1.BeEvent();
-NativeApp._isValid = false;
 /**
  *  A local disk-based cache for key value pairs for NativeApps.
  * @note This should be used only for local caching, since its not guaranteed to exist permanently.

package/lib/cjs/NativeApp.js.map

@@ -1 +1 @@
-{"version":3,"file":"NativeApp.js","sourceRoot":"","sources":["../../src/NativeApp.ts"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\r\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\r\n* See LICENSE.md in the project root for license terms and full copyright notice.\r\n*--------------------------------------------------------------------------------------------*/\r\n/** @packageDocumentation\r\n * @module NativeApp\r\n */\r\n\r\nimport { AsyncMethodsOf, BeEvent, GuidString, Logger, PromiseReturnType } from \"@itwin/core-bentley\";\r\nimport {\r\n  BriefcaseDownloader, BriefcaseProps, IModelVersion, InternetConnectivityStatus, IpcSocketFrontend, LocalBriefcaseProps,\r\n  NativeAppFunctions, nativeAppIpcStrings, NativeAppNotifications, OverriddenBy,\r\n  RemoveFunction, RequestNewBriefcaseProps, StorageValue, SyncMode,\r\n} from \"@itwin/core-common\";\r\nimport { ProgressCallback } from \"./request/Request\";\r\nimport { FrontendLoggerCategory } from \"./common/FrontendLoggerCategory\";\r\nimport { IpcApp, IpcAppOptions, NotificationHandler } from \"./IpcApp\";\r\nimport { NativeAppLogger } from \"./NativeAppLogger\";\r\nimport { OnDownloadProgress } from \"./BriefcaseConnection\";\r\nimport { _callIpcChannel } from \"./common/internal/Symbols\";\r\n\r\n/** Properties for specifying the BriefcaseId for downloading. May either specify a BriefcaseId directly (preferable) or, for\r\n * backwards compatibility, a [SyncMode]($common). If [SyncMode.PullAndPush]($common) is supplied, a new briefcaseId will be acquired.\r\n * @public\r\n */\r\nexport type DownloadBriefcaseId =\r\n  { syncMode?: SyncMode, briefcaseId?: never } |\r\n  { briefcaseId: number, syncMode?: never };\r\n\r\n/**\r\n* Options to download a briefcase\r\n* @public\r\n*/\r\nexport type DownloadBriefcaseOptions = DownloadBriefcaseId & {\r\n  /** the full path for the briefcase file */\r\n  fileName?: string;\r\n  /** Function called regularly to report progress of download. */\r\n  progressCallback?: OnDownloadProgress;\r\n  /** interval for calling progress function, in milliseconds */\r\n  progressInterval?: number;\r\n};\r\n\r\n/** NativeApp notifications from backend */\r\nclass NativeAppNotifyHandler extends NotificationHandler implements NativeAppNotifications {\r\n  public get channelName() { return nativeAppIpcStrings.notifyChannel; }\r\n  public notifyInternetConnectivityChanged(status: InternetConnectivityStatus) {\r\n    Logger.logInfo(FrontendLoggerCategory.NativeApp, \"Internet connectivity changed\");\r\n    NativeApp.onInternetConnectivityChanged.raiseEvent(status);\r\n  }\r\n}\r\n\r\n/**\r\n * Options for [[NativeApp.startup]]\r\n * @public\r\n */\r\nexport interface NativeAppOpts extends IpcAppOptions {\r\n  nativeApp?: object;\r\n}\r\n\r\n/**\r\n * The frontend of a native application\r\n * @see [Native Applications]($docs/learning/NativeApps.md)\r\n * @public\r\n */\r\nexport class NativeApp {\r\n  private static _removeAppNotify?: RemoveFunction;\r\n\r\n  /** @deprecated in 3.x. use nativeAppIpc */\r\n  public static async callNativeHost<T extends AsyncMethodsOf<NativeAppFunctions>>(methodName: T, ...args: Parameters<NativeAppFunctions[T]>) {\r\n    return IpcApp[_callIpcChannel](nativeAppIpcStrings.channelName, methodName, ...args) as PromiseReturnType<NativeAppFunctions[T]>;\r\n  }\r\n  /** A Proxy to call one of the [NativeAppFunctions]($common) functions via IPC. */\r\n  public static nativeAppIpc = IpcApp.makeIpcProxy<NativeAppFunctions>(nativeAppIpcStrings.channelName);\r\n\r\n  private static _storages = new Map<string, Storage>();\r\n  private static _onOnline = async () => {\r\n    await NativeApp.setConnectivity(OverriddenBy.Browser, InternetConnectivityStatus.Online);\r\n  };\r\n  private static _onOffline = async () => {\r\n    await NativeApp.setConnectivity(OverriddenBy.Browser, InternetConnectivityStatus.Offline);\r\n  };\r\n  private static async setConnectivity(by: OverriddenBy, status: InternetConnectivityStatus) {\r\n    await this.nativeAppIpc.overrideInternetConnectivity(by, status);\r\n  }\r\n  private static hookBrowserConnectivityEvents() {\r\n    if (typeof window === \"object\" && window.ononline && window.onoffline) {\r\n      window.addEventListener(\"online\", this._onOnline);\r\n      window.addEventListener(\"offline\", this._onOffline);\r\n    }\r\n  }\r\n  private static unhookBrowserConnectivityEvents() {\r\n    if (typeof window === \"object\" && window.ononline && window.onoffline) {\r\n      window.removeEventListener(\"online\", this._onOnline);\r\n      window.removeEventListener(\"offline\", this._onOffline);\r\n    }\r\n  }\r\n  /** event called when internet connectivity changes, if known */\r\n  public static onInternetConnectivityChanged = new BeEvent<(status: InternetConnectivityStatus) => void>();\r\n\r\n  /** determine whether the app currently has internet connectivity, if known */\r\n  public static async checkInternetConnectivity(): Promise<InternetConnectivityStatus> {\r\n    return this.nativeAppIpc.checkInternetConnectivity();\r\n  }\r\n  /** @internal */\r\n  public static async overrideInternetConnectivity(status: InternetConnectivityStatus): Promise<void> {\r\n    return this.nativeAppIpc.overrideInternetConnectivity(OverriddenBy.User, status);\r\n  }\r\n  private static _isValid = false;\r\n  public static get isValid(): boolean { return this._isValid; }\r\n\r\n  /**\r\n   * This is called by either ElectronApp.startup or MobileApp.startup - it should not be called directly\r\n   * @internal\r\n   */\r\n  public static async startup(ipc: IpcSocketFrontend, opts?: NativeAppOpts) {\r\n    await IpcApp.startup(ipc, opts);\r\n    if (this._isValid)\r\n      return;\r\n    this._isValid = true;\r\n\r\n    this._removeAppNotify = NativeAppNotifyHandler.register(); // receives notifications from backend\r\n    NativeApp.hookBrowserConnectivityEvents();\r\n\r\n    // initialize current online state.\r\n    if (window.navigator.onLine) {\r\n      await this.setConnectivity(OverriddenBy.Browser, window.navigator.onLine ? InternetConnectivityStatus.Online : InternetConnectivityStatus.Offline);\r\n    }\r\n  }\r\n\r\n  /** @internal */\r\n  public static async shutdown() {\r\n    this._removeAppNotify?.();\r\n    NativeApp.unhookBrowserConnectivityEvents();\r\n    await NativeAppLogger.flush();\r\n    await IpcApp.shutdown();\r\n    this._isValid = false;\r\n  }\r\n\r\n  public static async requestDownloadBriefcase(iTwinId: string, iModelId: string, downloadOptions: DownloadBriefcaseOptions,\r\n    asOf?: IModelVersion): Promise<BriefcaseDownloader>;\r\n\r\n  /**\r\n   * @deprecated in 3.6. `progress` argument is now deprecated, use [[DownloadBriefcaseOptions.progressCallback]] instead.\r\n   */\r\n  public static async requestDownloadBriefcase(iTwinId: string, iModelId: string, downloadOptions: DownloadBriefcaseOptions,\r\n    // eslint-disable-next-line @typescript-eslint/unified-signatures, @typescript-eslint/no-deprecated\r\n    asOf?: IModelVersion, progress?: ProgressCallback): Promise<BriefcaseDownloader>;\r\n\r\n  public static async requestDownloadBriefcase(\r\n    iTwinId: string,\r\n    iModelId: string,\r\n    downloadOptions: DownloadBriefcaseOptions,\r\n    asOf: IModelVersion = IModelVersion.latest(),\r\n    progress?: ProgressCallback, // eslint-disable-line @typescript-eslint/no-deprecated\r\n  ): Promise<BriefcaseDownloader> {\r\n    const shouldReportProgress = !!progress || !!downloadOptions.progressCallback;\r\n\r\n    let stopProgressEvents = () => { };\r\n    if (shouldReportProgress) {\r\n      const handleProgress = (_evt: Event, data: { loaded: number, total: number }) => {\r\n        progress?.(data);\r\n        downloadOptions.progressCallback?.(data);\r\n      };\r\n\r\n      stopProgressEvents = IpcApp.addListener(`nativeApp.progress-${iModelId}`, handleProgress);\r\n    }\r\n\r\n    const briefcaseId = (undefined !== downloadOptions.briefcaseId) ? downloadOptions.briefcaseId :\r\n      (downloadOptions.syncMode === SyncMode.PullOnly ? 0 : await this.nativeAppIpc.acquireNewBriefcaseId(iModelId));\r\n\r\n    const fileName = downloadOptions.fileName ?? await this.getBriefcaseFileName({ briefcaseId, iModelId });\r\n    const requestProps: RequestNewBriefcaseProps = { iModelId, briefcaseId, iTwinId, asOf: asOf.toJSON(), fileName };\r\n\r\n    const doDownload = async (): Promise<void> => {\r\n      try {\r\n        await this.nativeAppIpc.downloadBriefcase(requestProps, shouldReportProgress, downloadOptions.progressInterval);\r\n      } finally {\r\n        stopProgressEvents();\r\n      }\r\n    };\r\n\r\n    const requestCancel = async (): Promise<boolean> => {\r\n      const status = await this.nativeAppIpc.requestCancelDownloadBriefcase(fileName);\r\n      if (status)\r\n        stopProgressEvents();\r\n      return status;\r\n    };\r\n\r\n    return { briefcaseId, fileName, downloadPromise: doDownload(), requestCancel };\r\n  }\r\n\r\n  /** Get the full path filename for a briefcase within the briefcase cache */\r\n  public static async getBriefcaseFileName(props: BriefcaseProps): Promise<string> {\r\n    return this.nativeAppIpc.getBriefcaseFileName(props);\r\n  }\r\n\r\n  /** Delete an existing briefcase\r\n   * @param fileName the briefcase fileName\r\n   */\r\n  public static async deleteBriefcase(fileName: string): Promise<void> {\r\n    await this.nativeAppIpc.deleteBriefcaseFiles(fileName);\r\n  }\r\n\r\n  /** Get a list of all briefcase files held in the local briefcase cache directory */\r\n  public static async getCachedBriefcases(iModelId?: GuidString): Promise<LocalBriefcaseProps[]> {\r\n    return this.nativeAppIpc.getCachedBriefcases(iModelId);\r\n  }\r\n\r\n  /**\r\n   * Open a [[Storage]]. Creates a new Storage with that name if it does not already exist.\r\n   * @param name Should be a local filename without an extension.\r\n   * @returns a Promise for the [[Storage]].\r\n   */\r\n  public static async openStorage(name: string): Promise<Storage> {\r\n    if (this._storages.has(name))\r\n      return this._storages.get(name)!;\r\n\r\n    const storage = new Storage(await this.nativeAppIpc.storageMgrOpen(name));\r\n    this._storages.set(storage.id, storage);\r\n    return storage;\r\n  }\r\n\r\n  /**\r\n   * Close a Storage and optionally delete it.\r\n   * @param storage normally not call directly instead use Storage.close()\r\n   * @param deleteStorage if true, delete the storage from disk after closing it.\r\n   */\r\n  public static async closeStorage(storage: Storage, deleteStorage: boolean = false): Promise<void> {\r\n    if (!this._storages.has(storage.id))\r\n      throw new Error(`Storage [Id=${storage.id}] not open`);\r\n\r\n    await this.nativeAppIpc.storageMgrClose(storage.id, deleteStorage);\r\n    this._storages.delete(storage.id);\r\n  }\r\n\r\n  /** Get the list of existing Storages on the local disk. */\r\n  public static async getStorageNames(): Promise<string[]> {\r\n    return NativeApp.nativeAppIpc.storageMgrNames();\r\n  }\r\n}\r\n\r\n/**\r\n *  A local disk-based cache for key value pairs for NativeApps.\r\n * @note This should be used only for local caching, since its not guaranteed to exist permanently.\r\n * @public\r\n */\r\nexport class Storage {\r\n  constructor(public readonly id: string) { }\r\n\r\n  /** get the type of a value for a key, or undefined if not present. */\r\n  public async getValueType(key: string): Promise<\"number\" | \"string\" | \"boolean\" | \"Uint8Array\" | \"null\" | undefined> {\r\n    return NativeApp.nativeAppIpc.storageGetValueType(this.id, key);\r\n  }\r\n\r\n  /** Get the value for a key */\r\n  public async getData(key: string): Promise<StorageValue> {\r\n    return NativeApp.nativeAppIpc.storageGet(this.id, key);\r\n  }\r\n\r\n  /** Set value for a key */\r\n  public async setData(key: string, value: StorageValue): Promise<void> {\r\n    return NativeApp.nativeAppIpc.storageSet(this.id, key, value);\r\n  }\r\n\r\n  /**\r\n   * Return an array of all keys in this Storage.\r\n   * @note This can be expensive, depending on the number of keys present.\r\n   */\r\n  public async getKeys(): Promise<string[]> {\r\n    return NativeApp.nativeAppIpc.storageKeys(this.id);\r\n  }\r\n\r\n  /** Remove a key and its data. */\r\n  public async removeData(key: string): Promise<void> {\r\n    return NativeApp.nativeAppIpc.storageRemove(this.id, key);\r\n  }\r\n\r\n  /** Remove all keys and their data. */\r\n  public async removeAll(): Promise<void> {\r\n    return NativeApp.nativeAppIpc.storageRemoveAll(this.id);\r\n  }\r\n}\r\n"]}
+{"version":3,"file":"NativeApp.js","sourceRoot":"","sources":["../../src/NativeApp.ts"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\r\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\r\n* See LICENSE.md in the project root for license terms and full copyright notice.\r\n*--------------------------------------------------------------------------------------------*/\r\n/** @packageDocumentation\r\n * @module NativeApp\r\n */\r\n\r\nimport { AsyncMethodsOf, BeEvent, GuidString, Logger, PromiseReturnType } from \"@itwin/core-bentley\";\r\nimport {\r\n  BriefcaseDownloader, BriefcaseProps, IModelVersion, InternetConnectivityStatus, IpcSocketFrontend, LocalBriefcaseProps,\r\n  NativeAppFunctions, nativeAppIpcStrings, NativeAppNotifications, OverriddenBy,\r\n  RemoveFunction, RequestNewBriefcaseProps, StorageValue, SyncMode,\r\n} from \"@itwin/core-common\";\r\nimport { ProgressCallback } from \"./request/Request\";\r\nimport { FrontendLoggerCategory } from \"./common/FrontendLoggerCategory\";\r\nimport { IpcApp, IpcAppOptions, NotificationHandler } from \"./IpcApp\";\r\nimport { NativeAppLogger } from \"./NativeAppLogger\";\r\nimport { OnDownloadProgress } from \"./BriefcaseConnection\";\r\nimport { _callIpcChannel } from \"./common/internal/Symbols\";\r\n\r\n/** Properties for specifying the BriefcaseId for downloading. May either specify a BriefcaseId directly (preferable) or, for\r\n * backwards compatibility, a [SyncMode]($common). If [SyncMode.PullAndPush]($common) is supplied, a new briefcaseId will be acquired.\r\n * @public\r\n */\r\nexport type DownloadBriefcaseId =\r\n  { syncMode?: SyncMode, briefcaseId?: never } |\r\n  { briefcaseId: number, syncMode?: never };\r\n\r\n/**\r\n* Options to download a briefcase\r\n* @public\r\n*/\r\nexport type DownloadBriefcaseOptions = DownloadBriefcaseId & {\r\n  /** the full path for the briefcase file */\r\n  fileName?: string;\r\n  /** Function called regularly to report progress of download. */\r\n  progressCallback?: OnDownloadProgress;\r\n  /** interval for calling progress function, in milliseconds */\r\n  progressInterval?: number;\r\n};\r\n\r\n/** NativeApp notifications from backend */\r\nclass NativeAppNotifyHandler extends NotificationHandler implements NativeAppNotifications {\r\n  public get channelName() { return nativeAppIpcStrings.notifyChannel; }\r\n  public notifyInternetConnectivityChanged(status: InternetConnectivityStatus) {\r\n    Logger.logInfo(FrontendLoggerCategory.NativeApp, \"Internet connectivity changed\");\r\n    NativeApp.onInternetConnectivityChanged.raiseEvent(status);\r\n  }\r\n}\r\n\r\n/**\r\n * Options for [[NativeApp.startup]]\r\n * @public\r\n */\r\nexport interface NativeAppOpts extends IpcAppOptions {\r\n  nativeApp?: object;\r\n}\r\n\r\n/**\r\n * The frontend of a native application\r\n * @see [Native Applications]($docs/learning/NativeApps.md)\r\n * @public\r\n */\r\nexport class NativeApp {\r\n  private static _removeAppNotify?: RemoveFunction;\r\n\r\n  /** @deprecated in 3.x. use nativeAppIpc */\r\n  public static async callNativeHost<T extends AsyncMethodsOf<NativeAppFunctions>>(methodName: T, ...args: Parameters<NativeAppFunctions[T]>) {\r\n    return IpcApp[_callIpcChannel](nativeAppIpcStrings.channelName, methodName, ...args) as PromiseReturnType<NativeAppFunctions[T]>;\r\n  }\r\n  /** A Proxy to call one of the [NativeAppFunctions]($common) functions via IPC. */\r\n  public static nativeAppIpc = IpcApp.makeIpcProxy<NativeAppFunctions>(nativeAppIpcStrings.channelName);\r\n\r\n  private static _storages = new Map<string, Storage>();\r\n  private static _onOnline = async () => {\r\n    await NativeApp.setConnectivity(OverriddenBy.Browser, InternetConnectivityStatus.Online);\r\n  };\r\n  private static _onOffline = async () => {\r\n    await NativeApp.setConnectivity(OverriddenBy.Browser, InternetConnectivityStatus.Offline);\r\n  };\r\n  private static async setConnectivity(by: OverriddenBy, status: InternetConnectivityStatus) {\r\n    await this.nativeAppIpc.overrideInternetConnectivity(by, status);\r\n  }\r\n  private static hookBrowserConnectivityEvents() {\r\n    if (typeof window === \"object\" && window.ononline && window.onoffline) {\r\n      window.addEventListener(\"online\", this._onOnline);\r\n      window.addEventListener(\"offline\", this._onOffline);\r\n    }\r\n  }\r\n  private static unhookBrowserConnectivityEvents() {\r\n    if (typeof window === \"object\" && window.ononline && window.onoffline) {\r\n      window.removeEventListener(\"online\", this._onOnline);\r\n      window.removeEventListener(\"offline\", this._onOffline);\r\n    }\r\n  }\r\n  /** event called when internet connectivity changes, if known */\r\n  public static onInternetConnectivityChanged = new BeEvent<(status: InternetConnectivityStatus) => void>();\r\n\r\n  /** determine whether the app currently has internet connectivity, if known */\r\n  public static async checkInternetConnectivity(): Promise<InternetConnectivityStatus> {\r\n    return this.nativeAppIpc.checkInternetConnectivity();\r\n  }\r\n  /** @internal */\r\n  public static async overrideInternetConnectivity(status: InternetConnectivityStatus): Promise<void> {\r\n    return this.nativeAppIpc.overrideInternetConnectivity(OverriddenBy.User, status);\r\n  }\r\n  private static _isValid = false;\r\n  public static get isValid(): boolean { return this._isValid; }\r\n\r\n  /**\r\n   * This is called by either ElectronApp.startup or MobileApp.startup - it should not be called directly\r\n   * @internal\r\n   */\r\n  public static async startup(ipc: IpcSocketFrontend, opts?: NativeAppOpts) {\r\n    await IpcApp.startup(ipc, opts);\r\n    if (this._isValid)\r\n      return;\r\n    this._isValid = true;\r\n\r\n    this._removeAppNotify = NativeAppNotifyHandler.register(); // receives notifications from backend\r\n    NativeApp.hookBrowserConnectivityEvents();\r\n\r\n    // initialize current online state.\r\n    if (window.navigator.onLine) {\r\n      await this.setConnectivity(OverriddenBy.Browser, window.navigator.onLine ? InternetConnectivityStatus.Online : InternetConnectivityStatus.Offline);\r\n    }\r\n  }\r\n\r\n  /** @internal */\r\n  public static async shutdown() {\r\n    this._removeAppNotify?.();\r\n    NativeApp.unhookBrowserConnectivityEvents();\r\n    await NativeAppLogger.flush();\r\n    await IpcApp.shutdown();\r\n    this._isValid = false;\r\n  }\r\n\r\n  public static async requestDownloadBriefcase(iTwinId: string, iModelId: string, downloadOptions: DownloadBriefcaseOptions,\r\n    asOf?: IModelVersion): Promise<BriefcaseDownloader>;\r\n\r\n  /**\r\n   * @deprecated in 3.6. `progress` argument is now deprecated, use [[DownloadBriefcaseOptions.progressCallback]] instead.\r\n   */\r\n  public static async requestDownloadBriefcase(iTwinId: string, iModelId: string, downloadOptions: DownloadBriefcaseOptions,\r\n    // eslint-disable-next-line @typescript-eslint/unified-signatures, @typescript-eslint/no-deprecated\r\n    asOf?: IModelVersion, progress?: ProgressCallback): Promise<BriefcaseDownloader>;\r\n\r\n  public static async requestDownloadBriefcase(\r\n    iTwinId: string,\r\n    iModelId: string,\r\n    downloadOptions: DownloadBriefcaseOptions,\r\n    asOf: IModelVersion = IModelVersion.latest(),\r\n    progress?: ProgressCallback, // eslint-disable-line @typescript-eslint/no-deprecated\r\n  ): Promise<BriefcaseDownloader> {\r\n    const shouldReportProgress = !!progress || !!downloadOptions.progressCallback;\r\n\r\n    let stopProgressEvents = () => { };\r\n    if (shouldReportProgress) {\r\n      const handleProgress = (_evt: Event, data: { loaded: number, total: number }) => {\r\n        progress?.(data);\r\n        downloadOptions.progressCallback?.(data);\r\n      };\r\n\r\n      stopProgressEvents = IpcApp.addListener(`nativeApp.progress-${iModelId}`, handleProgress);\r\n    }\r\n\r\n    const briefcaseId = (undefined !== downloadOptions.briefcaseId) ? downloadOptions.briefcaseId :\r\n      (downloadOptions.syncMode === SyncMode.PullOnly ? 0 : await this.nativeAppIpc.acquireNewBriefcaseId(iModelId));\r\n\r\n    const fileName = downloadOptions.fileName ?? await this.getBriefcaseFileName({ briefcaseId, iModelId });\r\n    const requestProps: RequestNewBriefcaseProps = { iModelId, briefcaseId, iTwinId, asOf: asOf.toJSON(), fileName };\r\n\r\n    const doDownload = async (): Promise<void> => {\r\n      try {\r\n        await this.nativeAppIpc.downloadBriefcase(requestProps, shouldReportProgress, downloadOptions.progressInterval);\r\n      } finally {\r\n        stopProgressEvents();\r\n      }\r\n    };\r\n\r\n    const requestCancel = async (): Promise<boolean> => {\r\n      const status = await this.nativeAppIpc.requestCancelDownloadBriefcase(fileName);\r\n      if (status)\r\n        stopProgressEvents();\r\n      return status;\r\n    };\r\n\r\n    return { briefcaseId, fileName, downloadPromise: doDownload(), requestCancel };\r\n  }\r\n\r\n  /** Get the full path filename for a briefcase within the briefcase cache */\r\n  public static async getBriefcaseFileName(props: BriefcaseProps): Promise<string> {\r\n    return this.nativeAppIpc.getBriefcaseFileName(props);\r\n  }\r\n\r\n  /** Delete an existing briefcase\r\n   * @param fileName the briefcase fileName\r\n   */\r\n  public static async deleteBriefcase(fileName: string): Promise<void> {\r\n    await this.nativeAppIpc.deleteBriefcaseFiles(fileName);\r\n  }\r\n\r\n  /** Get a list of all briefcase files held in the local briefcase cache directory */\r\n  public static async getCachedBriefcases(iModelId?: GuidString): Promise<LocalBriefcaseProps[]> {\r\n    return this.nativeAppIpc.getCachedBriefcases(iModelId);\r\n  }\r\n\r\n  /**\r\n   * Open a [[Storage]]. Creates a new Storage with that name if it does not already exist.\r\n   * @param name Should be a local filename without an extension.\r\n   * @returns a Promise for the [[Storage]].\r\n   */\r\n  public static async openStorage(name: string): Promise<Storage> {\r\n    if (this._storages.has(name))\r\n      return this._storages.get(name)!;\r\n\r\n    const storage = new Storage(await this.nativeAppIpc.storageMgrOpen(name));\r\n    this._storages.set(storage.id, storage);\r\n    return storage;\r\n  }\r\n\r\n  /**\r\n   * Close a Storage and optionally delete it.\r\n   * @param storage normally not call directly instead use Storage.close()\r\n   * @param deleteStorage if true, delete the storage from disk after closing it.\r\n   */\r\n  public static async closeStorage(storage: Storage, deleteStorage: boolean = false): Promise<void> {\r\n    if (!this._storages.has(storage.id))\r\n      throw new Error(`Storage [Id=${storage.id}] not open`);\r\n\r\n    await this.nativeAppIpc.storageMgrClose(storage.id, deleteStorage);\r\n    this._storages.delete(storage.id);\r\n  }\r\n\r\n  /** Get the list of existing Storages on the local disk. */\r\n  public static async getStorageNames(): Promise<string[]> {\r\n    return NativeApp.nativeAppIpc.storageMgrNames();\r\n  }\r\n}\r\n\r\n/**\r\n *  A local disk-based cache for key value pairs for NativeApps.\r\n * @note This should be used only for local caching, since its not guaranteed to exist permanently.\r\n * @public\r\n */\r\nexport class Storage {\r\n  constructor(public readonly id: string) { }\r\n\r\n  /** get the type of a value for a key, or undefined if not present. */\r\n  public async getValueType(key: string): Promise<\"number\" | \"string\" | \"boolean\" | \"Uint8Array\" | \"null\" | undefined> {\r\n    return NativeApp.nativeAppIpc.storageGetValueType(this.id, key);\r\n  }\r\n\r\n  /** Get the value for a key */\r\n  public async getData(key: string): Promise<StorageValue> {\r\n    return NativeApp.nativeAppIpc.storageGet(this.id, key);\r\n  }\r\n\r\n  /** Set value for a key */\r\n  public async setData(key: string, value: StorageValue): Promise<void> {\r\n    return NativeApp.nativeAppIpc.storageSet(this.id, key, value);\r\n  }\r\n\r\n  /**\r\n   * Return an array of all keys in this Storage.\r\n   * @note This can be expensive, depending on the number of keys present.\r\n   */\r\n  public async getKeys(): Promise<string[]> {\r\n    return NativeApp.nativeAppIpc.storageKeys(this.id);\r\n  }\r\n\r\n  /** Remove a key and its data. */\r\n  public async removeData(key: string): Promise<void> {\r\n    return NativeApp.nativeAppIpc.storageRemove(this.id, key);\r\n  }\r\n\r\n  /** Remove all keys and their data. */\r\n  public async removeAll(): Promise<void> {\r\n    return NativeApp.nativeAppIpc.storageRemoveAll(this.id);\r\n  }\r\n}\r\n"]}

package/lib/cjs/NativeAppLogger.js

@@ -15,6 +15,7 @@ const IpcApp_1 = require("./IpcApp");
  * @internal
  */
 class NativeAppLogger {
+    static { this._messages = []; }
     static flushToBackend() {
         if (!this._onFlushed && this._messages.length > 0) {
             this._onFlushed = new Promise(() => this._onFlushed = undefined);
@@ -73,5 +74,4 @@ class NativeAppLogger {
     }
 }
 exports.NativeAppLogger = NativeAppLogger;
-NativeAppLogger._messages = [];
 //# sourceMappingURL=NativeAppLogger.js.map

package/lib/cjs/NativeAppLogger.js.map

@@ -1 +1 @@
-{"version":3,"file":"NativeAppLogger.js","sourceRoot":"","sources":["../../src/NativeAppLogger.ts"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\r\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\r\n* See LICENSE.md in the project root for license terms and full copyright notice.\r\n*--------------------------------------------------------------------------------------------*/\r\n/** @packageDocumentation\r\n * @module NativeApp\r\n */\r\n\r\nimport { BentleyError, Logger, LoggingMetaData, LogLevel } from \"@itwin/core-bentley\";\r\nimport { IpcApp } from \"./IpcApp\";\r\n\r\n/**\r\n * Describe log message\r\n * @internal\r\n */\r\ninterface LogMessage {\r\n  timestamp: number;\r\n  level: LogLevel;\r\n  category: string;\r\n  message: string;\r\n  metaData: any;\r\n}\r\n/**\r\n * NativeAppLogger send log message from frontend to backend. It works on native app only.\r\n * @internal\r\n */\r\nexport class NativeAppLogger {\r\n  private static _messages: LogMessage[] = [];\r\n  private static _onFlushed: Promise<void> | undefined;\r\n  private static flushToBackend() {\r\n    if (!this._onFlushed && this._messages.length > 0) {\r\n      this._onFlushed = new Promise<void>(() => this._onFlushed = undefined);\r\n      const messages = this._messages;\r\n      this._messages = [];\r\n      setTimeout(async () => this.flushBucket(messages));\r\n    }\r\n  }\r\n\r\n  private static async flushBucket(messages: LogMessage[]): Promise<void> {\r\n    try {\r\n      while (messages.length > 0) {\r\n        const msg: LogMessage = messages.shift()!;\r\n        await IpcApp.appFunctionIpc.log(msg.timestamp, msg.level, msg.category, msg.message, { ...msg.metaData });\r\n      }\r\n    } finally {\r\n      // Put back unsent messages.\r\n      this._messages.unshift(...messages);\r\n      if (this._messages.length > 0) {\r\n        this.flushToBackend();\r\n      } else {\r\n        // eslint-disable-next-line @typescript-eslint/no-floating-promises\r\n        Promise.resolve(this._onFlushed);\r\n      }\r\n    }\r\n  }\r\n\r\n  private static log(level: LogLevel, category: string, message: string, metaData: LoggingMetaData) {\r\n    this._messages.push({ timestamp: Date.now(), level, category, message, metaData: BentleyError.getMetaData(metaData) });\r\n    this.flushToBackend();\r\n  }\r\n\r\n  public static logError(category: string, message: string, metaData: LoggingMetaData) {\r\n    this.log(LogLevel.Error, category, message, metaData);\r\n  }\r\n\r\n  public static logInfo(category: string, message: string, metaData: LoggingMetaData) {\r\n    this.log(LogLevel.Info, category, message, metaData);\r\n  }\r\n\r\n  public static logTrace(category: string, message: string, metaData: LoggingMetaData) {\r\n    this.log(LogLevel.Trace, category, message, metaData);\r\n  }\r\n\r\n  public static logWarning(category: string, message: string, metaData: LoggingMetaData) {\r\n    this.log(LogLevel.Warning, category, message, metaData);\r\n  }\r\n\r\n  public static async flush(): Promise<void> {\r\n    this.flushToBackend();\r\n    if (this._onFlushed) {\r\n      return this._onFlushed;\r\n    }\r\n  }\r\n\r\n  public static initialize() {\r\n    const errCb = (category: string, message: string, metaData: LoggingMetaData) => this.logError(category, message, metaData);\r\n    const warnCb = (category: string, message: string, metaData: LoggingMetaData) => this.logWarning(category, message, metaData);\r\n    const infoCb = (category: string, message: string, metaData: LoggingMetaData) => this.logInfo(category, message, metaData);\r\n    const traceCb = (category: string, message: string, metaData: LoggingMetaData) => this.logTrace(category, message, metaData);\r\n\r\n    Logger.initialize(errCb, warnCb, infoCb, traceCb);\r\n  }\r\n}\r\n"]}
+{"version":3,"file":"NativeAppLogger.js","sourceRoot":"","sources":["../../src/NativeAppLogger.ts"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\r\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\r\n* See LICENSE.md in the project root for license terms and full copyright notice.\r\n*--------------------------------------------------------------------------------------------*/\r\n/** @packageDocumentation\r\n * @module NativeApp\r\n */\r\n\r\nimport { BentleyError, Logger, LoggingMetaData, LogLevel } from \"@itwin/core-bentley\";\r\nimport { IpcApp } from \"./IpcApp\";\r\n\r\n/**\r\n * Describe log message\r\n * @internal\r\n */\r\ninterface LogMessage {\r\n  timestamp: number;\r\n  level: LogLevel;\r\n  category: string;\r\n  message: string;\r\n  metaData: any;\r\n}\r\n/**\r\n * NativeAppLogger send log message from frontend to backend. It works on native app only.\r\n * @internal\r\n */\r\nexport class NativeAppLogger {\r\n  private static _messages: LogMessage[] = [];\r\n  private static _onFlushed: Promise<void> | undefined;\r\n  private static flushToBackend() {\r\n    if (!this._onFlushed && this._messages.length > 0) {\r\n      this._onFlushed = new Promise<void>(() => this._onFlushed = undefined);\r\n      const messages = this._messages;\r\n      this._messages = [];\r\n      setTimeout(async () => this.flushBucket(messages));\r\n    }\r\n  }\r\n\r\n  private static async flushBucket(messages: LogMessage[]): Promise<void> {\r\n    try {\r\n      while (messages.length > 0) {\r\n        const msg: LogMessage = messages.shift()!;\r\n        await IpcApp.appFunctionIpc.log(msg.timestamp, msg.level, msg.category, msg.message, { ...msg.metaData });\r\n      }\r\n    } finally {\r\n      // Put back unsent messages.\r\n      this._messages.unshift(...messages);\r\n      if (this._messages.length > 0) {\r\n        this.flushToBackend();\r\n      } else {\r\n        // eslint-disable-next-line @typescript-eslint/no-floating-promises\r\n        Promise.resolve(this._onFlushed);\r\n      }\r\n    }\r\n  }\r\n\r\n  private static log(level: LogLevel, category: string, message: string, metaData: LoggingMetaData) {\r\n    this._messages.push({ timestamp: Date.now(), level, category, message, metaData: BentleyError.getMetaData(metaData) });\r\n    this.flushToBackend();\r\n  }\r\n\r\n  public static logError(category: string, message: string, metaData: LoggingMetaData) {\r\n    this.log(LogLevel.Error, category, message, metaData);\r\n  }\r\n\r\n  public static logInfo(category: string, message: string, metaData: LoggingMetaData) {\r\n    this.log(LogLevel.Info, category, message, metaData);\r\n  }\r\n\r\n  public static logTrace(category: string, message: string, metaData: LoggingMetaData) {\r\n    this.log(LogLevel.Trace, category, message, metaData);\r\n  }\r\n\r\n  public static logWarning(category: string, message: string, metaData: LoggingMetaData) {\r\n    this.log(LogLevel.Warning, category, message, metaData);\r\n  }\r\n\r\n  public static async flush(): Promise<void> {\r\n    this.flushToBackend();\r\n    if (this._onFlushed) {\r\n      return this._onFlushed;\r\n    }\r\n  }\r\n\r\n  public static initialize() {\r\n    const errCb = (category: string, message: string, metaData: LoggingMetaData) => this.logError(category, message, metaData);\r\n    const warnCb = (category: string, message: string, metaData: LoggingMetaData) => this.logWarning(category, message, metaData);\r\n    const infoCb = (category: string, message: string, metaData: LoggingMetaData) => this.logInfo(category, message, metaData);\r\n    const traceCb = (category: string, message: string, metaData: LoggingMetaData) => this.logTrace(category, message, metaData);\r\n\r\n    Logger.initialize(errCb, warnCb, infoCb, traceCb);\r\n  }\r\n}\r\n"]}

package/lib/cjs/NoRenderApp.js

@@ -25,6 +25,7 @@ class NullTarget extends RenderTarget_1.RenderTarget {
         super(...arguments);
         this[_a] = undefined;
     }
+    static { _a = Symbols_1._implementationProhibited; }
     get analysisFraction() { return 0; }
     set analysisFraction(_fraction) { }
     get renderSystem() { return undefined; }
@@ -51,7 +52,6 @@ class NullTarget extends RenderTarget_1.RenderTarget {
     set screenSpaceEffects(_effects) { }
 }
 exports.NullTarget = NullTarget;
-_a = Symbols_1._implementationProhibited;
 /**
  * A RenderSystem for applications that must run in environments where WebGL is not present.
  * This is typically used in tests.

package/lib/cjs/NoRenderApp.js.map

@@ -1 +1 @@
-{"version":3,"file":"NoRenderApp.js","sourceRoot":"","sources":["../../src/NoRenderApp.ts"],"names":[],"mappings":";AAAA;;;+FAG+F;AAC/F;;GAEG;;;;AAEH,oDAAuD;AACvD,2CAA0D;AAE1D,wDAAqD;AACrD,wDAAqD;AACrD,gDAA6C;AAC7C,uDAAsE;AAEtE;;;;GAIG;AACH,MAAa,UAAW,SAAQ,2BAAY;IAA5C;;QAC8B,QAA2B,GAAG,SAAS,CAAC;IAyBtE,CAAC;IAxBC,IAAW,gBAAgB,KAAa,OAAO,CAAC,CAAC,CAAC,CAAC;IACnD,IAAW,gBAAgB,CAAC,SAAiB,IAAI,CAAC;IAClD,IAAW,YAAY,KAAK,OAAO,SAAgB,CAAC,CAAC,CAAC;IACtD,IAAW,QAAQ,KAAe,OAAO,IAAI,mBAAQ,EAAE,CAAC,CAAC,CAAC;IAC1D,IAAW,yBAAyB,KAAc,OAAO,KAAK,CAAC,CAAC,CAAC;IACjE,IAAoB,iBAAiB,KAAwC,OAAO,SAAS,CAAC,CAAC,CAAC;IAChG,IAAoB,iBAAiB,CAAC,SAA4C,IAAI,CAAC;IAChF,SAAS,KAAW,CAAC;IACZ,KAAK,KAAW,CAAC;IAC1B,WAAW,KAAW,CAAC;IACvB,cAAc,KAAW,CAAC;IAC1B,iBAAiB,KAAW,CAAC;IAC7B,gBAAgB,KAAW,CAAC;IAC5B,SAAS,CAAC,mBAA4B,IAAU,CAAC;IACxC,wBAAwB,KAAW,CAAC;IACpC,YAAY,KAAW,CAAC;IACxB,UAAU,KAAW,CAAC;IAC/B,WAAW,KAAW,CAAC;IACd,SAAS,KAAW,CAAC;IACrB,OAAO,KAAW,CAAC;IAC5B,cAAc,KAAc,OAAO,KAAK,CAAC,CAAC,CAAC;IAC3C,UAAU,KAAW,CAAC;IAC7B,IAAW,kBAAkB,KAAuB,OAAO,EAAE,CAAC,CAAC,CAAC;IAChE,IAAW,kBAAkB,CAAC,QAA0B,IAAI,CAAC;CAC9D;AA1BD,gCA0BC;KAzB8B,mCAAyB;AA2BxD;;;;GAIG;AACH,MAAa,gBAAiB,SAAQ,2BAAY;IAChD,IAAW,OAAO,KAAc,OAAO,KAAK,CAAC,CAAC,CAAC;IACxC,UAAU,KAAc,OAAO,KAAK,CAAC,CAAC,CAAC;IACvC,YAAY,KAAK,OAAO,IAAI,UAAU,EAAE,CAAC,CAAC,CAAC;IAC3C,qBAAqB,KAAK,OAAO,IAAI,UAAU,EAAE,CAAC,CAAC,CAAC;IACpD,aAAa,KAAK,OAAO,SAAgB,CAAC,CAAC,CAAC;IAC5C,iBAAiB,KAAK,OAAO,SAAgB,CAAC,CAAC,CAAC;IAChD,mBAAmB,KAAK,OAAO,SAAgB,CAAC,CAAC,CAAC;IAClD,WAAW,KAAK,OAAO,SAAgB,CAAC,CAAC,CAAC;IAC1C,OAAO,KAAK,CAAC;IACpB,gBAAuB,KAAK,EAAE,CAAC,CAAC,CAAC;IACjB,mBAAmB,KAAK,OAAO,SAAS,CAAC,CAAC,CAAC;IAC3C,yBAAyB,KAAK,OAAO,SAAgB,CAAC,CAAC,CAAC;CACzE;AAbD,4CAaC;AAED;;;;;GAKG;AACH,MAAa,WAAW;IACtB;;OAEG;IACI,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,IAAuB;QACjD,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;QACxB,IAAI,CAAC,SAAS,GAAG,IAAI,gBAAgB,EAAE,CAAC;QACxC,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;QACrB,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,YAAY,IAAI,IAAI,+BAAiB,EAAE,CAAC;QACjE,MAAM,qBAAS,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAChC,CAAC;CACF;AAXD,kCAWC","sourcesContent":["/*---------------------------------------------------------------------------------------------\r\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\r\n* See LICENSE.md in the project root for license terms and full copyright notice.\r\n*--------------------------------------------------------------------------------------------*/\r\n/** @packageDocumentation\r\n * @module IModelApp\r\n */\r\n\r\nimport { EmptyLocalization } from \"@itwin/core-common\";\r\nimport { IModelApp, IModelAppOptions } from \"./IModelApp\";\r\nimport { AnimationBranchStates } from \"./render/GraphicBranch\";\r\nimport { RenderSystem } from \"./render/RenderSystem\";\r\nimport { RenderTarget } from \"./render/RenderTarget\";\r\nimport { ViewRect } from \"./common/ViewRect\";\r\nimport { _implementationProhibited } from \"./common/internal/Symbols\";\r\n\r\n/**\r\n * A RenderTarget for applications that must run in environments where WebGL is not present.\r\n * This is typically used in tests.\r\n * @internal\r\n */\r\nexport class NullTarget extends RenderTarget {\r\n  protected override readonly [_implementationProhibited] = undefined;\r\n  public get analysisFraction(): number { return 0; }\r\n  public set analysisFraction(_fraction: number) { }\r\n  public get renderSystem() { return undefined as any; }\r\n  public get viewRect(): ViewRect { return new ViewRect(); }\r\n  public get wantInvertBlackBackground(): boolean { return false; }\r\n  public override get animationBranches(): AnimationBranchStates | undefined { return undefined; }\r\n  public override set animationBranches(_branches: AnimationBranchStates | undefined) { }\r\n  public onDestroy(): void { }\r\n  public override reset(): void { }\r\n  public changeScene(): void { }\r\n  public changeDynamics(): void { }\r\n  public changeDecorations(): void { }\r\n  public changeRenderPlan(): void { }\r\n  public drawFrame(_sceneMilSecElapsed?: number): void { }\r\n  public override overrideFeatureSymbology(): void { }\r\n  public override setHiliteSet(): void { }\r\n  public override setFlashed(): void { }\r\n  public setViewRect(): void { }\r\n  public override onResized(): void { }\r\n  public override dispose(): void { }\r\n  public updateViewRect(): boolean { return false; }\r\n  public readPixels(): void { }\r\n  public get screenSpaceEffects(): Iterable<string> { return []; }\r\n  public set screenSpaceEffects(_effects: Iterable<string>) { }\r\n}\r\n\r\n/**\r\n * A RenderSystem for applications that must run in environments where WebGL is not present.\r\n * This is typically used in tests.\r\n * @internal\r\n */\r\nexport class NullRenderSystem extends RenderSystem {\r\n  public get isValid(): boolean { return false; }\r\n  public doIdleWork(): boolean { return false; }\r\n  public createTarget() { return new NullTarget(); }\r\n  public createOffscreenTarget() { return new NullTarget(); }\r\n  public createGraphic() { return undefined as any; }\r\n  public createGraphicList() { return undefined as any; }\r\n  public createGraphicBranch() { return undefined as any; }\r\n  public createBatch() { return undefined as any; }\r\n  public dispose() { }\r\n  public constructor() { super(); }\r\n  public override createRenderGraphic() { return undefined; }\r\n  public override createGraphicFromTemplate() { return undefined as any; }\r\n}\r\n\r\n/** A utility class intended for applications (primarily test-runners) that run in environments that lack support for WebGL.\r\n * It installs a [[RenderSystem]] that produces no graphics.\r\n * Use [[NoRenderApp.startup]] instead of [[IModelApp.startup]] to initialize your application frontend.\r\n * You may then use the [[IModelApp]] API as normal.\r\n * @public\r\n */\r\nexport class NoRenderApp {\r\n  /** Initializes [[IModelApp]] with a [[RenderSystem]] that produces no graphics.\r\n   * Use this in place of [[IModelApp.startup]], then proceed to use [[IModelApp]]'s API as normal.\r\n   */\r\n  public static async startup(opts?: IModelAppOptions): Promise<void> {\r\n    opts = opts ? opts : {};\r\n    opts.renderSys = new NullRenderSystem();\r\n    opts.noRender = true;\r\n    opts.localization = opts.localization ?? new EmptyLocalization();\r\n    await IModelApp.startup(opts);\r\n  }\r\n}\r\n"]}
+{"version":3,"file":"NoRenderApp.js","sourceRoot":"","sources":["../../src/NoRenderApp.ts"],"names":[],"mappings":";AAAA;;;+FAG+F;AAC/F;;GAEG;;;;AAEH,oDAAuD;AACvD,2CAA0D;AAE1D,wDAAqD;AACrD,wDAAqD;AACrD,gDAA6C;AAC7C,uDAAsE;AAEtE;;;;GAIG;AACH,MAAa,UAAW,SAAQ,2BAAY;IAA5C;;QAC8B,QAA2B,GAAG,SAAS,CAAC;IAyBtE,CAAC;kBAzB8B,mCAAyB;IACtD,IAAW,gBAAgB,KAAa,OAAO,CAAC,CAAC,CAAC,CAAC;IACnD,IAAW,gBAAgB,CAAC,SAAiB,IAAI,CAAC;IAClD,IAAW,YAAY,KAAK,OAAO,SAAgB,CAAC,CAAC,CAAC;IACtD,IAAW,QAAQ,KAAe,OAAO,IAAI,mBAAQ,EAAE,CAAC,CAAC,CAAC;IAC1D,IAAW,yBAAyB,KAAc,OAAO,KAAK,CAAC,CAAC,CAAC;IACjE,IAAoB,iBAAiB,KAAwC,OAAO,SAAS,CAAC,CAAC,CAAC;IAChG,IAAoB,iBAAiB,CAAC,SAA4C,IAAI,CAAC;IAChF,SAAS,KAAW,CAAC;IACZ,KAAK,KAAW,CAAC;IAC1B,WAAW,KAAW,CAAC;IACvB,cAAc,KAAW,CAAC;IAC1B,iBAAiB,KAAW,CAAC;IAC7B,gBAAgB,KAAW,CAAC;IAC5B,SAAS,CAAC,mBAA4B,IAAU,CAAC;IACxC,wBAAwB,KAAW,CAAC;IACpC,YAAY,KAAW,CAAC;IACxB,UAAU,KAAW,CAAC;IAC/B,WAAW,KAAW,CAAC;IACd,SAAS,KAAW,CAAC;IACrB,OAAO,KAAW,CAAC;IAC5B,cAAc,KAAc,OAAO,KAAK,CAAC,CAAC,CAAC;IAC3C,UAAU,KAAW,CAAC;IAC7B,IAAW,kBAAkB,KAAuB,OAAO,EAAE,CAAC,CAAC,CAAC;IAChE,IAAW,kBAAkB,CAAC,QAA0B,IAAI,CAAC;CAC9D;AA1BD,gCA0BC;AAED;;;;GAIG;AACH,MAAa,gBAAiB,SAAQ,2BAAY;IAChD,IAAW,OAAO,KAAc,OAAO,KAAK,CAAC,CAAC,CAAC;IACxC,UAAU,KAAc,OAAO,KAAK,CAAC,CAAC,CAAC;IACvC,YAAY,KAAK,OAAO,IAAI,UAAU,EAAE,CAAC,CAAC,CAAC;IAC3C,qBAAqB,KAAK,OAAO,IAAI,UAAU,EAAE,CAAC,CAAC,CAAC;IACpD,aAAa,KAAK,OAAO,SAAgB,CAAC,CAAC,CAAC;IAC5C,iBAAiB,KAAK,OAAO,SAAgB,CAAC,CAAC,CAAC;IAChD,mBAAmB,KAAK,OAAO,SAAgB,CAAC,CAAC,CAAC;IAClD,WAAW,KAAK,OAAO,SAAgB,CAAC,CAAC,CAAC;IAC1C,OAAO,KAAK,CAAC;IACpB,gBAAuB,KAAK,EAAE,CAAC,CAAC,CAAC;IACjB,mBAAmB,KAAK,OAAO,SAAS,CAAC,CAAC,CAAC;IAC3C,yBAAyB,KAAK,OAAO,SAAgB,CAAC,CAAC,CAAC;CACzE;AAbD,4CAaC;AAED;;;;;GAKG;AACH,MAAa,WAAW;IACtB;;OAEG;IACI,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,IAAuB;QACjD,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;QACxB,IAAI,CAAC,SAAS,GAAG,IAAI,gBAAgB,EAAE,CAAC;QACxC,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;QACrB,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,YAAY,IAAI,IAAI,+BAAiB,EAAE,CAAC;QACjE,MAAM,qBAAS,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAChC,CAAC;CACF;AAXD,kCAWC","sourcesContent":["/*---------------------------------------------------------------------------------------------\r\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\r\n* See LICENSE.md in the project root for license terms and full copyright notice.\r\n*--------------------------------------------------------------------------------------------*/\r\n/** @packageDocumentation\r\n * @module IModelApp\r\n */\r\n\r\nimport { EmptyLocalization } from \"@itwin/core-common\";\r\nimport { IModelApp, IModelAppOptions } from \"./IModelApp\";\r\nimport { AnimationBranchStates } from \"./render/GraphicBranch\";\r\nimport { RenderSystem } from \"./render/RenderSystem\";\r\nimport { RenderTarget } from \"./render/RenderTarget\";\r\nimport { ViewRect } from \"./common/ViewRect\";\r\nimport { _implementationProhibited } from \"./common/internal/Symbols\";\r\n\r\n/**\r\n * A RenderTarget for applications that must run in environments where WebGL is not present.\r\n * This is typically used in tests.\r\n * @internal\r\n */\r\nexport class NullTarget extends RenderTarget {\r\n  protected override readonly [_implementationProhibited] = undefined;\r\n  public get analysisFraction(): number { return 0; }\r\n  public set analysisFraction(_fraction: number) { }\r\n  public get renderSystem() { return undefined as any; }\r\n  public get viewRect(): ViewRect { return new ViewRect(); }\r\n  public get wantInvertBlackBackground(): boolean { return false; }\r\n  public override get animationBranches(): AnimationBranchStates | undefined { return undefined; }\r\n  public override set animationBranches(_branches: AnimationBranchStates | undefined) { }\r\n  public onDestroy(): void { }\r\n  public override reset(): void { }\r\n  public changeScene(): void { }\r\n  public changeDynamics(): void { }\r\n  public changeDecorations(): void { }\r\n  public changeRenderPlan(): void { }\r\n  public drawFrame(_sceneMilSecElapsed?: number): void { }\r\n  public override overrideFeatureSymbology(): void { }\r\n  public override setHiliteSet(): void { }\r\n  public override setFlashed(): void { }\r\n  public setViewRect(): void { }\r\n  public override onResized(): void { }\r\n  public override dispose(): void { }\r\n  public updateViewRect(): boolean { return false; }\r\n  public readPixels(): void { }\r\n  public get screenSpaceEffects(): Iterable<string> { return []; }\r\n  public set screenSpaceEffects(_effects: Iterable<string>) { }\r\n}\r\n\r\n/**\r\n * A RenderSystem for applications that must run in environments where WebGL is not present.\r\n * This is typically used in tests.\r\n * @internal\r\n */\r\nexport class NullRenderSystem extends RenderSystem {\r\n  public get isValid(): boolean { return false; }\r\n  public doIdleWork(): boolean { return false; }\r\n  public createTarget() { return new NullTarget(); }\r\n  public createOffscreenTarget() { return new NullTarget(); }\r\n  public createGraphic() { return undefined as any; }\r\n  public createGraphicList() { return undefined as any; }\r\n  public createGraphicBranch() { return undefined as any; }\r\n  public createBatch() { return undefined as any; }\r\n  public dispose() { }\r\n  public constructor() { super(); }\r\n  public override createRenderGraphic() { return undefined; }\r\n  public override createGraphicFromTemplate() { return undefined as any; }\r\n}\r\n\r\n/** A utility class intended for applications (primarily test-runners) that run in environments that lack support for WebGL.\r\n * It installs a [[RenderSystem]] that produces no graphics.\r\n * Use [[NoRenderApp.startup]] instead of [[IModelApp.startup]] to initialize your application frontend.\r\n * You may then use the [[IModelApp]] API as normal.\r\n * @public\r\n */\r\nexport class NoRenderApp {\r\n  /** Initializes [[IModelApp]] with a [[RenderSystem]] that produces no graphics.\r\n   * Use this in place of [[IModelApp.startup]], then proceed to use [[IModelApp]]'s API as normal.\r\n   */\r\n  public static async startup(opts?: IModelAppOptions): Promise<void> {\r\n    opts = opts ? opts : {};\r\n    opts.renderSys = new NullRenderSystem();\r\n    opts.noRender = true;\r\n    opts.localization = opts.localization ?? new EmptyLocalization();\r\n    await IModelApp.startup(opts);\r\n  }\r\n}\r\n"]}

package/lib/cjs/RealityDataSourceTilesetUrlImpl.d.ts

@@ -17,6 +17,8 @@ export declare class RealityDataSourceTilesetUrlImpl implements RealityDataSourc
     private _tilesetUrl;
     /** For use by all Reality Data. For RD stored on PW Context Share, represents the portion from the root of the Azure Blob Container*/
     private _baseUrl;
+    /** Need to be passed down to child tile requests when requesting from blob storage, e.g. a Cesium export from the Mesh Export Service*/
+    private _searchParams;
     /** Construct a new reality data source.
      * @param props JSON representation of the reality data source
      */
@@ -43,7 +45,10 @@ export declare class RealityDataSourceTilesetUrlImpl implements RealityDataSourc
     getServiceUrl(_iTwinId: GuidString | undefined): Promise<string | undefined>;
     getRootDocument(iTwinId: GuidString | undefined): Promise<any>;
     private isValidURL;
-    /** Returns the tile URL. If the tile path is a full URL, it is returned as is. Otherwise, the base URL is prepended to the tile path. */
+    /** Returns the tile URL.
+     * If the tile path is a relative URL, the base URL is prepended to it.
+     * For both absolute and relative tile path URLs, the search parameters are checked. If the search params are empty, the base URL's search params are appended to the tile path.
+     */
     private getTileUrl;
     /**
      * Returns the tile content. The path to the tile is relative to the base url of present reality data whatever the type.

package/lib/cjs/RealityDataSourceTilesetUrlImpl.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"RealityDataSourceTilesetUrlImpl.d.ts","sourceRoot":"","sources":["../../src/RealityDataSourceTilesetUrlImpl.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,OAAO,EAAyB,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACxE,OAAO,EAAe,WAAW,EAA0C,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAGpJ,OAAO,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAC;AAGzG;;;;;;EAME;AACF,qBAAa,+BAAgC,YAAW,iBAAiB;IACvE,SAAgB,GAAG,EAAE,oBAAoB,CAAC;IAC1C,2EAA2E;IAC3E,OAAO,CAAC,WAAW,CAAqB;IACxC,sIAAsI;IACtI,OAAO,CAAC,QAAQ,CAAc;IAE9B;;OAEG;IACH,SAAS,aAAa,KAAK,EAAE,sBAAsB;IAMnD;;OAEG;WACiB,aAAa,CAAC,SAAS,EAAE,oBAAoB,EAAE,QAAQ,EAAE,UAAU,GAAG,SAAS,GAAG,OAAO,CAAC,iBAAiB,GAAG,SAAS,CAAC;IAO5I,IAAW,cAAc,IAAI,OAAO,CAEnC;IACD;;MAEE;IACF,IAAW,WAAW,IAAI,WAAW,GAAG,SAAS,CAEhD;IACD,IAAW,aAAa,IAAI,MAAM,GAAG,SAAS,CAE7C;IACD;;OAEG;IACH,IAAW,eAAe,IAAI,MAAM,GAAG,SAAS,CAE/C;IAOD,OAAO,CAAC,UAAU;IASlB;;;OAGG;IACU,aAAa,CAAC,QAAQ,EAAE,UAAU,GAAG,SAAS,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAI5E,eAAe,CAAC,OAAO,EAAE,UAAU,GAAG,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC;IAU3E,OAAO,CAAC,UAAU;IASlB,yIAAyI;IACzI,OAAO,CAAC,UAAU;IAIlB;;OAEG;IACU,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAI/D;;OAEG;IACU,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC;IAI7C,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAI1D;;;;OAIG;IACU,4BAA4B,IAAI,OAAO,CAAC,yBAAyB,GAAG,SAAS,CAAC;IAQ3F;;;;;OAKG;IACU,uBAAuB,IAAI,OAAO,CAAC,oBAAoB,GAAG,SAAS,CAAC;CAIlF"}
+{"version":3,"file":"RealityDataSourceTilesetUrlImpl.d.ts","sourceRoot":"","sources":["../../src/RealityDataSourceTilesetUrlImpl.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,OAAO,EAAyB,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACxE,OAAO,EAAe,WAAW,EAA0C,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAGpJ,OAAO,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAC;AAGzG;;;;;;EAME;AACF,qBAAa,+BAAgC,YAAW,iBAAiB;IACvE,SAAgB,GAAG,EAAE,oBAAoB,CAAC;IAC1C,2EAA2E;IAC3E,OAAO,CAAC,WAAW,CAAqB;IACxC,sIAAsI;IACtI,OAAO,CAAC,QAAQ,CAAc;IAC9B,wIAAwI;IACxI,OAAO,CAAC,aAAa,CAAc;IAEnC;;OAEG;IACH,SAAS,aAAa,KAAK,EAAE,sBAAsB;IAMnD;;OAEG;WACiB,aAAa,CAAC,SAAS,EAAE,oBAAoB,EAAE,QAAQ,EAAE,UAAU,GAAG,SAAS,GAAG,OAAO,CAAC,iBAAiB,GAAG,SAAS,CAAC;IAO5I,IAAW,cAAc,IAAI,OAAO,CAEnC;IACD;;MAEE;IACF,IAAW,WAAW,IAAI,WAAW,GAAG,SAAS,CAEhD;IACD,IAAW,aAAa,IAAI,MAAM,GAAG,SAAS,CAE7C;IACD;;OAEG;IACH,IAAW,eAAe,IAAI,MAAM,GAAG,SAAS,CAE/C;IAQD,OAAO,CAAC,UAAU;IAWlB;;;OAGG;IACU,aAAa,CAAC,QAAQ,EAAE,UAAU,GAAG,SAAS,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAI5E,eAAe,CAAC,OAAO,EAAE,UAAU,GAAG,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC;IAU3E,OAAO,CAAC,UAAU;IASlB;;;OAGG;IACH,OAAO,CAAC,UAAU;IAQlB;;OAEG;IACU,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAI/D;;OAEG;IACU,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC;IAI7C,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAI1D;;;;OAIG;IACU,4BAA4B,IAAI,OAAO,CAAC,yBAAyB,GAAG,SAAS,CAAC;IAQ3F;;;;;OAKG;IACU,uBAAuB,IAAI,OAAO,CAAC,oBAAoB,GAAG,SAAS,CAAC;CAIlF"}

package/lib/cjs/RealityDataSourceTilesetUrlImpl.js

@@ -26,6 +26,8 @@ class RealityDataSourceTilesetUrlImpl {
     constructor(props) {
         /** For use by all Reality Data. For RD stored on PW Context Share, represents the portion from the root of the Azure Blob Container*/
         this._baseUrl = "";
+        /** Need to be passed down to child tile requests when requesting from blob storage, e.g. a Cesium export from the Mesh Export Service*/
+        this._searchParams = "";
         (0, core_bentley_1.assert)(props.sourceKey.provider === core_common_1.RealityDataProvider.TilesetUrl || props.sourceKey.provider === core_common_1.RealityDataProvider.OrbitGtBlob);
         this.key = props.sourceKey;
         this._tilesetUrl = this.key.id;
@@ -62,8 +64,11 @@ class RealityDataSourceTilesetUrlImpl {
     // otherwise the full path to root document is given.
     // The base URL contains the base URL from which tile relative path are constructed.
     // The tile's path root will need to be reinserted for child tiles to return a 200
+    // If the original url includes search paramaters, they are stored in _searchParams to be reinserted into child tile requests.
     setBaseUrl(url) {
         const urlParts = url.split("/");
+        const newUrl = new URL(url);
+        this._searchParams = newUrl.search;
         urlParts.pop();
         if (urlParts.length === 0)
             this._baseUrl = "";
@@ -94,9 +99,16 @@ class RealityDataSourceTilesetUrlImpl {
         }
         return true;
     }
-    /** Returns the tile URL. If the tile path is a full URL, it is returned as is. Otherwise, the base URL is prepended to the tile path. */
+    /** Returns the tile URL.
+     * If the tile path is a relative URL, the base URL is prepended to it.
+     * For both absolute and relative tile path URLs, the search parameters are checked. If the search params are empty, the base URL's search params are appended to the tile path.
+     */
     getTileUrl(tilePath) {
-        return this.isValidURL(tilePath) ? tilePath : this._baseUrl + tilePath;
+        if (this.isValidURL(tilePath)) {
+            const url = new URL(tilePath);
+            return url.search === "" ? `${tilePath}${this._searchParams}` : tilePath;
+        }
+        return tilePath.includes("?") ? `${this._baseUrl}${tilePath}` : `${this._baseUrl}${tilePath}${this._searchParams}`;
     }
     /**
      * Returns the tile content. The path to the tile is relative to the base url of present reality data whatever the type.

package/lib/cjs/RealityDataSourceTilesetUrlImpl.js.map

@@ -1 +1 @@
-{"version":3,"file":"RealityDataSourceTilesetUrlImpl.js","sourceRoot":"","sources":["../../src/RealityDataSourceTilesetUrlImpl.ts"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\r\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\r\n* See LICENSE.md in the project root for license terms and full copyright notice.\r\n*--------------------------------------------------------------------------------------------*/\r\n/** @packageDocumentation\r\n * @module Tiles\r\n */\r\nimport { assert, BentleyStatus, GuidString } from \"@itwin/core-bentley\";\r\nimport { IModelError, RealityData, RealityDataFormat, RealityDataProvider, RealityDataSourceKey, RealityDataSourceProps } from \"@itwin/core-common\";\r\n\r\nimport { request } from \"./request/Request\";\r\nimport { PublisherProductInfo, RealityDataSource, SpatialLocationAndExtents } from \"./RealityDataSource\";\r\nimport { ThreeDTileFormatInterpreter } from \"./tile/internal\";\r\n\r\n/** This class provides access to the reality data provider services.\r\n * It encapsulates access to a reality data weiter it be from local access, http or ProjectWise Context Share.\r\n * The key provided at the creation determines if this is ProjectWise Context Share reference.\r\n * If not then it is considered local (ex: C:\\temp\\TileRoot.json) or plain http access (http://someserver.com/data/TileRoot.json)\r\n * There is a one to one relationship between a reality data and the instances of present class.\r\n* @internal\r\n*/\r\nexport class RealityDataSourceTilesetUrlImpl implements RealityDataSource {\r\n  public readonly key: RealityDataSourceKey;\r\n  /** The URL that supplies the 3d tiles for displaying the reality model. */\r\n  private _tilesetUrl: string | undefined;\r\n  /** For use by all Reality Data. For RD stored on PW Context Share, represents the portion from the root of the Azure Blob Container*/\r\n  private _baseUrl: string = \"\";\r\n\r\n  /** Construct a new reality data source.\r\n   * @param props JSON representation of the reality data source\r\n   */\r\n  protected constructor(props: RealityDataSourceProps) {\r\n    assert(props.sourceKey.provider === RealityDataProvider.TilesetUrl || props.sourceKey.provider === RealityDataProvider.OrbitGtBlob);\r\n    this.key = props.sourceKey;\r\n    this._tilesetUrl = this.key.id;\r\n  }\r\n\r\n  /**\r\n   * Create an instance of this class from a source key and iTwin context/\r\n   */\r\n  public static async createFromKey(sourceKey: RealityDataSourceKey, _iTwinId: GuidString | undefined): Promise<RealityDataSource | undefined> {\r\n    if (sourceKey.provider !== RealityDataProvider.TilesetUrl)\r\n      return undefined;\r\n    const rdSource = new RealityDataSourceTilesetUrlImpl({ sourceKey });\r\n    return rdSource;\r\n  }\r\n\r\n  public get isContextShare(): boolean {\r\n    return false;\r\n  }\r\n  /**\r\n   * Returns Reality Data if available\r\n  */\r\n  public get realityData(): RealityData | undefined {\r\n    return undefined;\r\n  }\r\n  public get realityDataId(): string | undefined {\r\n    return undefined;\r\n  }\r\n  /**\r\n   * Returns Reality Data type if available\r\n   */\r\n  public get realityDataType(): string | undefined {\r\n    return undefined;\r\n  }\r\n\r\n  // This is to set the root url from the provided root document path.\r\n  // If the root document is stored on PW Context Share then the root document property of the Reality Data is provided,\r\n  // otherwise the full path to root document is given.\r\n  // The base URL contains the base URL from which tile relative path are constructed.\r\n  // The tile's path root will need to be reinserted for child tiles to return a 200\r\n  private setBaseUrl(url: string): void {\r\n    const urlParts = url.split(\"/\");\r\n    urlParts.pop();\r\n    if (urlParts.length === 0)\r\n      this._baseUrl = \"\";\r\n    else\r\n      this._baseUrl = `${urlParts.join(\"/\")}/`;\r\n  }\r\n\r\n  /**\r\n   * This method returns the URL to access the actual 3d tiles from the service provider.\r\n   * @returns string containing the URL to reality data.\r\n   */\r\n  public async getServiceUrl(_iTwinId: GuidString | undefined): Promise<string | undefined> {\r\n    return this._tilesetUrl;\r\n  }\r\n\r\n  public async getRootDocument(iTwinId: GuidString | undefined): Promise<any> {\r\n    const url = await this.getServiceUrl(iTwinId);\r\n    if (!url)\r\n      throw new IModelError(BentleyStatus.ERROR, \"Unable to get service url\");\r\n\r\n    // The following is only if the reality data is not stored on PW Context Share.\r\n    this.setBaseUrl(url);\r\n    return request(url, \"json\");\r\n  }\r\n\r\n  private isValidURL(url: string){\r\n    try {\r\n      new URL(url);\r\n    } catch {\r\n      return false;\r\n    }\r\n    return true;\r\n  }\r\n\r\n  /** Returns the tile URL. If the tile path is a full URL, it is returned as is. Otherwise, the base URL is prepended to the tile path. */\r\n  private getTileUrl(tilePath: string){\r\n    return this.isValidURL(tilePath) ? tilePath : this._baseUrl + tilePath;\r\n  }\r\n\r\n  /**\r\n   * Returns the tile content. The path to the tile is relative to the base url of present reality data whatever the type.\r\n   */\r\n  public async getTileContent(name: string): Promise<ArrayBuffer> {\r\n    return request(this.getTileUrl(name), \"arraybuffer\");\r\n  }\r\n\r\n  /**\r\n   * Returns the tile content in json format. The path to the tile is relative to the base url of present reality data whatever the type.\r\n   */\r\n  public async getTileJson(name: string): Promise<any> {\r\n    return request(this.getTileUrl(name), \"json\");\r\n  }\r\n\r\n  public getTileContentType(url: string): \"tile\" | \"tileset\" {\r\n    return new URL(url, \"https://localhost/\").pathname.toLowerCase().endsWith(\"json\") ? \"tileset\" : \"tile\";\r\n  }\r\n\r\n  /**\r\n   * Gets spatial location and extents of this reality data source\r\n   * @returns spatial location and extents\r\n   * @internal\r\n   */\r\n  public async getSpatialLocationAndExtents(): Promise<SpatialLocationAndExtents | undefined> {\r\n    let spatialLocation: SpatialLocationAndExtents | undefined;\r\n    if (this.key.format === RealityDataFormat.ThreeDTile) {\r\n      const rootDocument = await this.getRootDocument(undefined);\r\n      spatialLocation = ThreeDTileFormatInterpreter.getSpatialLocationAndExtents(rootDocument);\r\n    }\r\n    return spatialLocation;\r\n  }\r\n  /**\r\n   * Gets information to identify the product and engine that create this reality data\r\n   * Will return undefined if cannot be resolved\r\n   * @returns information to identify the product and engine that create this reality data\r\n   * @alpha\r\n   */\r\n  public async getPublisherProductInfo(): Promise<PublisherProductInfo | undefined> {\r\n    let publisherInfo: PublisherProductInfo | undefined;\r\n    return publisherInfo;\r\n  }\r\n}\r\n\r\n"]}
+{"version":3,"file":"RealityDataSourceTilesetUrlImpl.js","sourceRoot":"","sources":["../../src/RealityDataSourceTilesetUrlImpl.ts"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\r\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\r\n* See LICENSE.md in the project root for license terms and full copyright notice.\r\n*--------------------------------------------------------------------------------------------*/\r\n/** @packageDocumentation\r\n * @module Tiles\r\n */\r\nimport { assert, BentleyStatus, GuidString } from \"@itwin/core-bentley\";\r\nimport { IModelError, RealityData, RealityDataFormat, RealityDataProvider, RealityDataSourceKey, RealityDataSourceProps } from \"@itwin/core-common\";\r\n\r\nimport { request } from \"./request/Request\";\r\nimport { PublisherProductInfo, RealityDataSource, SpatialLocationAndExtents } from \"./RealityDataSource\";\r\nimport { ThreeDTileFormatInterpreter } from \"./tile/internal\";\r\n\r\n/** This class provides access to the reality data provider services.\r\n * It encapsulates access to a reality data weiter it be from local access, http or ProjectWise Context Share.\r\n * The key provided at the creation determines if this is ProjectWise Context Share reference.\r\n * If not then it is considered local (ex: C:\\temp\\TileRoot.json) or plain http access (http://someserver.com/data/TileRoot.json)\r\n * There is a one to one relationship between a reality data and the instances of present class.\r\n* @internal\r\n*/\r\nexport class RealityDataSourceTilesetUrlImpl implements RealityDataSource {\r\n  public readonly key: RealityDataSourceKey;\r\n  /** The URL that supplies the 3d tiles for displaying the reality model. */\r\n  private _tilesetUrl: string | undefined;\r\n  /** For use by all Reality Data. For RD stored on PW Context Share, represents the portion from the root of the Azure Blob Container*/\r\n  private _baseUrl: string = \"\";\r\n  /** Need to be passed down to child tile requests when requesting from blob storage, e.g. a Cesium export from the Mesh Export Service*/\r\n  private _searchParams: string = \"\";\r\n\r\n  /** Construct a new reality data source.\r\n   * @param props JSON representation of the reality data source\r\n   */\r\n  protected constructor(props: RealityDataSourceProps) {\r\n    assert(props.sourceKey.provider === RealityDataProvider.TilesetUrl || props.sourceKey.provider === RealityDataProvider.OrbitGtBlob);\r\n    this.key = props.sourceKey;\r\n    this._tilesetUrl = this.key.id;\r\n  }\r\n\r\n  /**\r\n   * Create an instance of this class from a source key and iTwin context/\r\n   */\r\n  public static async createFromKey(sourceKey: RealityDataSourceKey, _iTwinId: GuidString | undefined): Promise<RealityDataSource | undefined> {\r\n    if (sourceKey.provider !== RealityDataProvider.TilesetUrl)\r\n      return undefined;\r\n    const rdSource = new RealityDataSourceTilesetUrlImpl({ sourceKey });\r\n    return rdSource;\r\n  }\r\n\r\n  public get isContextShare(): boolean {\r\n    return false;\r\n  }\r\n  /**\r\n   * Returns Reality Data if available\r\n  */\r\n  public get realityData(): RealityData | undefined {\r\n    return undefined;\r\n  }\r\n  public get realityDataId(): string | undefined {\r\n    return undefined;\r\n  }\r\n  /**\r\n   * Returns Reality Data type if available\r\n   */\r\n  public get realityDataType(): string | undefined {\r\n    return undefined;\r\n  }\r\n\r\n  // This is to set the root url from the provided root document path.\r\n  // If the root document is stored on PW Context Share then the root document property of the Reality Data is provided,\r\n  // otherwise the full path to root document is given.\r\n  // The base URL contains the base URL from which tile relative path are constructed.\r\n  // The tile's path root will need to be reinserted for child tiles to return a 200\r\n  // If the original url includes search paramaters, they are stored in _searchParams to be reinserted into child tile requests.\r\n  private setBaseUrl(url: string): void {\r\n    const urlParts = url.split(\"/\");\r\n    const newUrl = new URL(url);\r\n    this._searchParams = newUrl.search;\r\n    urlParts.pop();\r\n    if (urlParts.length === 0)\r\n      this._baseUrl = \"\";\r\n    else\r\n      this._baseUrl = `${urlParts.join(\"/\")}/`;\r\n  }\r\n\r\n  /**\r\n   * This method returns the URL to access the actual 3d tiles from the service provider.\r\n   * @returns string containing the URL to reality data.\r\n   */\r\n  public async getServiceUrl(_iTwinId: GuidString | undefined): Promise<string | undefined> {\r\n    return this._tilesetUrl;\r\n  }\r\n\r\n  public async getRootDocument(iTwinId: GuidString | undefined): Promise<any> {\r\n    const url = await this.getServiceUrl(iTwinId);\r\n    if (!url)\r\n      throw new IModelError(BentleyStatus.ERROR, \"Unable to get service url\");\r\n\r\n    // The following is only if the reality data is not stored on PW Context Share.\r\n    this.setBaseUrl(url);\r\n    return request(url, \"json\");\r\n  }\r\n\r\n  private isValidURL(url: string){\r\n    try {\r\n      new URL(url);\r\n    } catch {\r\n      return false;\r\n    }\r\n    return true;\r\n  }\r\n\r\n  /** Returns the tile URL.\r\n   * If the tile path is a relative URL, the base URL is prepended to it.\r\n   * For both absolute and relative tile path URLs, the search parameters are checked. If the search params are empty, the base URL's search params are appended to the tile path.\r\n   */\r\n  private getTileUrl(tilePath: string){\r\n    if (this.isValidURL(tilePath)) {\r\n      const url = new URL(tilePath);\r\n      return url.search === \"\" ? `${tilePath}${this._searchParams}` : tilePath;\r\n    }\r\n    return tilePath.includes(\"?\") ? `${this._baseUrl}${tilePath}` : `${this._baseUrl}${tilePath}${this._searchParams}`;\r\n  }\r\n\r\n  /**\r\n   * Returns the tile content. The path to the tile is relative to the base url of present reality data whatever the type.\r\n   */\r\n  public async getTileContent(name: string): Promise<ArrayBuffer> {\r\n    return request(this.getTileUrl(name), \"arraybuffer\");\r\n  }\r\n\r\n  /**\r\n   * Returns the tile content in json format. The path to the tile is relative to the base url of present reality data whatever the type.\r\n   */\r\n  public async getTileJson(name: string): Promise<any> {\r\n    return request(this.getTileUrl(name), \"json\");\r\n  }\r\n\r\n  public getTileContentType(url: string): \"tile\" | \"tileset\" {\r\n    return new URL(url, \"https://localhost/\").pathname.toLowerCase().endsWith(\"json\") ? \"tileset\" : \"tile\";\r\n  }\r\n\r\n  /**\r\n   * Gets spatial location and extents of this reality data source\r\n   * @returns spatial location and extents\r\n   * @internal\r\n   */\r\n  public async getSpatialLocationAndExtents(): Promise<SpatialLocationAndExtents | undefined> {\r\n    let spatialLocation: SpatialLocationAndExtents | undefined;\r\n    if (this.key.format === RealityDataFormat.ThreeDTile) {\r\n      const rootDocument = await this.getRootDocument(undefined);\r\n      spatialLocation = ThreeDTileFormatInterpreter.getSpatialLocationAndExtents(rootDocument);\r\n    }\r\n    return spatialLocation;\r\n  }\r\n  /**\r\n   * Gets information to identify the product and engine that create this reality data\r\n   * Will return undefined if cannot be resolved\r\n   * @returns information to identify the product and engine that create this reality data\r\n   * @alpha\r\n   */\r\n  public async getPublisherProductInfo(): Promise<PublisherProductInfo | undefined> {\r\n    let publisherInfo: PublisherProductInfo | undefined;\r\n    return publisherInfo;\r\n  }\r\n}\r\n\r\n"]}