@itwin/core-frontend 5.11.0-dev.8 → 5.12.0-dev.1

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

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

package/lib/esm/NativeApp.js

@@ -74,9 +74,7 @@ export class NativeApp {
         this._removeAppNotify = NativeAppNotifyHandler.register(); // receives notifications from backend
         NativeApp.hookBrowserConnectivityEvents();
         // initialize current online state.
-        if (window.navigator.onLine) {
-            await this.setConnectivity(OverriddenBy.Browser, window.navigator.onLine ? InternetConnectivityStatus.Online : InternetConnectivityStatus.Offline);
-        }
+        await this.setConnectivity(OverriddenBy.Browser, window.navigator.onLine ? InternetConnectivityStatus.Online : InternetConnectivityStatus.Offline);
     }
     /** @internal */
     static async shutdown() {

package/lib/esm/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 { BeEvent, GuidString, Logger } from \"@itwin/core-bentley\";\r\nimport {\r\n  BriefcaseDownloader, BriefcaseProps, CatalogIModel, IModelVersion, InternetConnectivityStatus, IpcSocketFrontend, LocalBriefcaseProps,\r\n  NativeAppFunctions, nativeAppIpcStrings, NativeAppNotifications, OverriddenBy,\r\n  RemoveFunction, RequestNewBriefcaseProps, StorageValue, SyncMode,\r\n} from \"@itwin/core-common\";\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  /** A Proxy to call one of the [NativeAppFunctions]($common) functions via IPC. */\r\n  public static nativeAppIpc = IpcApp.makeIpcProxy<NativeAppFunctions>(nativeAppIpcStrings.channelName);\r\n  public static catalogIpc = IpcApp.makeIpcProxy<CatalogIModel.IpcMethods, CatalogIModel.IpcChannel>(\"catalogIModel/ipc\");\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  public static async requestDownloadBriefcase(\r\n    iTwinId: string,\r\n    iModelId: string,\r\n    downloadOptions: DownloadBriefcaseOptions,\r\n    asOf: IModelVersion = IModelVersion.latest()\r\n  ): Promise<BriefcaseDownloader> {\r\n    const shouldReportProgress = !!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        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    let storage = this._storages.get(name);\r\n    if (!storage) {\r\n      storage = new Storage(await this.nativeAppIpc.storageMgrOpen(name));\r\n      this._storages.set(storage.id, storage);\r\n    }\r\n    \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 { BeEvent, GuidString, Logger } from \"@itwin/core-bentley\";\r\nimport {\r\n  BriefcaseDownloader, BriefcaseProps, CatalogIModel, IModelVersion, InternetConnectivityStatus, IpcSocketFrontend, LocalBriefcaseProps,\r\n  NativeAppFunctions, nativeAppIpcStrings, NativeAppNotifications, OverriddenBy,\r\n  RemoveFunction, RequestNewBriefcaseProps, StorageValue, SyncMode,\r\n} from \"@itwin/core-common\";\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  /** A Proxy to call one of the [NativeAppFunctions]($common) functions via IPC. */\r\n  public static nativeAppIpc = IpcApp.makeIpcProxy<NativeAppFunctions>(nativeAppIpcStrings.channelName);\r\n  public static catalogIpc = IpcApp.makeIpcProxy<CatalogIModel.IpcMethods, CatalogIModel.IpcChannel>(\"catalogIModel/ipc\");\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    await this.setConnectivity(OverriddenBy.Browser, window.navigator.onLine ? InternetConnectivityStatus.Online : InternetConnectivityStatus.Offline);\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  public static async requestDownloadBriefcase(\r\n    iTwinId: string,\r\n    iModelId: string,\r\n    downloadOptions: DownloadBriefcaseOptions,\r\n    asOf: IModelVersion = IModelVersion.latest()\r\n  ): Promise<BriefcaseDownloader> {\r\n    const shouldReportProgress = !!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        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    let storage = this._storages.get(name);\r\n    if (!storage) {\r\n      storage = new Storage(await this.nativeAppIpc.storageMgrOpen(name));\r\n      this._storages.set(storage.id, storage);\r\n    }\r\n\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/esm/RealityDataSourceCesiumIonAssetImpl.d.ts

@@ -2,7 +2,7 @@ import { GuidString } from "@itwin/core-bentley";
 import { RealityData, RealityDataSourceKey, RealityDataSourceProps } from "@itwin/core-common";
 import { PublisherProductInfo, RealityDataSource, SpatialLocationAndExtents } from "./RealityDataSource";
 /** This class provides access to the reality data provider services.
- * It encapsulates access to a reality data weiter it be from local access, http or ProjectWise Context Share.
+ * It encapsulates access to a reality data whether it be from local access, http or ProjectWise Context Share.
  * The key provided at the creation determines if this is ProjectWise Context Share reference.
  * If not then it is considered local (ex: C:\temp\TileRoot.json) or plain http access (http://someserver.com/data/TileRoot.json)
  * There is a one to one relationship between a reality data and the instances of present class.

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

@@ -1 +1 @@
-{"version":3,"file":"RealityDataSourceCesiumIonAssetImpl.d.ts","sourceRoot":"","sources":["../../src/RealityDataSourceCesiumIonAssetImpl.ts"],"names":[],"mappings":"AAQA,OAAO,EAAyB,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACxE,OAAO,EAAe,WAAW,EAAuB,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAEjI,OAAO,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAC;AAEzG;;;;;;EAME;AACF,qBAAa,mCAAoC,YAAW,iBAAiB;IAC3E,SAAgB,GAAG,EAAE,oBAAoB,CAAC;IAC1C,2EAA2E;IAC3E,OAAO,CAAC,WAAW,CAAqB;IACxC,sIAAsI;IACtI,OAAO,CAAC,QAAQ,CAAc;IAC9B,6DAA6D;IAC7D,OAAO,CAAC,qBAAqB,CAAC,CAAS;IAEvC;;OAEG;IACH,SAAS,aAAa,KAAK,EAAE,sBAAsB;IAKnD;;OAEG;WACiB,aAAa,CAAC,SAAS,EAAE,oBAAoB,EAAE,OAAO,EAAE,UAAU,GAAG,SAAS,GAAG,OAAO,CAAC,iBAAiB,GAAG,SAAS,CAAC;IAY3I,IAAW,cAAc,IAAI,OAAO,CAEnC;IAED;;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;IAe5E,eAAe,CAAC,OAAO,EAAE,UAAU,GAAG,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC;IAsB3E;;OAEG;IACU,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAO/D;;OAEG;IACU,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC;IAO7C,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAI1D;;;;OAIG;IACU,4BAA4B,IAAI,OAAO,CAAC,yBAAyB,GAAG,SAAS,CAAC;IAK3F;;;;;OAKG;IACU,uBAAuB,IAAI,OAAO,CAAC,oBAAoB,GAAG,SAAS,CAAC;CAIlF"}
+{"version":3,"file":"RealityDataSourceCesiumIonAssetImpl.d.ts","sourceRoot":"","sources":["../../src/RealityDataSourceCesiumIonAssetImpl.ts"],"names":[],"mappings":"AAQA,OAAO,EAAyB,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACxE,OAAO,EAAe,WAAW,EAAuB,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAEjI,OAAO,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAC;AAEzG;;;;;;EAME;AACF,qBAAa,mCAAoC,YAAW,iBAAiB;IAC3E,SAAgB,GAAG,EAAE,oBAAoB,CAAC;IAC1C,2EAA2E;IAC3E,OAAO,CAAC,WAAW,CAAqB;IACxC,sIAAsI;IACtI,OAAO,CAAC,QAAQ,CAAc;IAC9B,6DAA6D;IAC7D,OAAO,CAAC,qBAAqB,CAAC,CAAS;IAEvC;;OAEG;IACH,SAAS,aAAa,KAAK,EAAE,sBAAsB;IAKnD;;OAEG;WACiB,aAAa,CAAC,SAAS,EAAE,oBAAoB,EAAE,OAAO,EAAE,UAAU,GAAG,SAAS,GAAG,OAAO,CAAC,iBAAiB,GAAG,SAAS,CAAC;IAY3I,IAAW,cAAc,IAAI,OAAO,CAEnC;IAED;;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;IAe5E,eAAe,CAAC,OAAO,EAAE,UAAU,GAAG,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC;IAuC3E;;OAEG;IACU,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAO/D;;OAEG;IACU,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC;IAO7C,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAI1D;;;;OAIG;IACU,4BAA4B,IAAI,OAAO,CAAC,yBAAyB,GAAG,SAAS,CAAC;IAK3F;;;;;OAKG;IACU,uBAAuB,IAAI,OAAO,CAAC,oBAAoB,GAAG,SAAS,CAAC;CAIlF"}

package/lib/esm/RealityDataSourceCesiumIonAssetImpl.js

@@ -8,9 +8,9 @@
 import { request } from "./request/Request";
 import { assert, BentleyStatus } from "@itwin/core-bentley";
 import { IModelError, RealityDataProvider } from "@itwin/core-common";
-import { CesiumIonAssetProvider, getCesiumAccessTokenAndEndpointUrl, getCesiumAssetUrl, getCesiumOSMBuildingsUrl } from "./tile/internal";
+import { CesiumIonAssetProvider, getCesiumAccessClient, getCesiumAccessTokenAndEndpointUrl, getCesiumAssetUrl, getCesiumOSMBuildingsUrl } from "./tile/internal";
 /** This class provides access to the reality data provider services.
- * It encapsulates access to a reality data weiter it be from local access, http or ProjectWise Context Share.
+ * It encapsulates access to a reality data whether it be from local access, http or ProjectWise Context Share.
  * The key provided at the creation determines if this is ProjectWise Context Share reference.
  * If not then it is considered local (ex: C:\temp\TileRoot.json) or plain http access (http://someserver.com/data/TileRoot.json)
  * There is a one to one relationship between a reality data and the instances of present class.
@@ -101,10 +101,28 @@ export class RealityDataSourceCesiumIonAssetImpl {
         // The following is only if the reality data is not stored on PW Context Share.
         const cesiumAsset = CesiumIonAssetProvider.parseCesiumUrl(url);
         if (cesiumAsset) {
-            const tokenAndUrl = await getCesiumAccessTokenAndEndpointUrl(`${cesiumAsset.id}`, cesiumAsset.key);
-            if (tokenAndUrl.url && tokenAndUrl.token) {
-                url = tokenAndUrl.url;
-                this._requestAuthorization = `Bearer ${tokenAndUrl.token}`;
+            let resolvedToken;
+            let resolvedUrl;
+            if (cesiumAsset.key) {
+                // Legacy key-bearing URL (e.g. persisted saved view) - authenticate directly with the embedded Ion key.
+                // Such URLs are intentionally exempt from the cesiumAccess-over-cesiumIonKey precedence rule and are not
+                // routed through a registered CesiumAccessClient; see [[CesiumAccessClient]].
+                const tokenAndUrl = await getCesiumAccessTokenAndEndpointUrl(`${cesiumAsset.id}`, cesiumAsset.key);
+                resolvedToken = tokenAndUrl.token;
+                resolvedUrl = tokenAndUrl.url;
+            }
+            else {
+                // delegate to the registered CesiumAccessClient
+                const client = getCesiumAccessClient();
+                const endpoint = await client.getAssetEndpoint(`${cesiumAsset.id}`, iTwinId);
+                if (endpoint) {
+                    resolvedToken = endpoint.accessToken;
+                    resolvedUrl = endpoint.url;
+                }
+            }
+            if (resolvedUrl && resolvedToken) {
+                url = resolvedUrl;
+                this._requestAuthorization = `Bearer ${resolvedToken}`;
             }
         }
         // The following is only if the reality data is not stored on PW Context Share.

package/lib/esm/RealityDataSourceCesiumIonAssetImpl.js.map

@@ -1 +1 @@
-{"version":3,"file":"RealityDataSourceCesiumIonAssetImpl.js","sourceRoot":"","sources":["../../src/RealityDataSourceCesiumIonAssetImpl.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 { request } from \"./request/Request\";\r\nimport { assert, BentleyStatus, GuidString } from \"@itwin/core-bentley\";\r\nimport { IModelError, RealityData, RealityDataProvider, RealityDataSourceKey, RealityDataSourceProps } from \"@itwin/core-common\";\r\nimport { CesiumIonAssetProvider, getCesiumAccessTokenAndEndpointUrl, getCesiumAssetUrl, getCesiumOSMBuildingsUrl } from \"./tile/internal\";\r\nimport { PublisherProductInfo, RealityDataSource, SpatialLocationAndExtents } from \"./RealityDataSource\";\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 RealityDataSourceCesiumIonAssetImpl 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  /** Request authorization for non PW ContextShare requests.*/\r\n  private _requestAuthorization?: 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.CesiumIonAsset);\r\n    this.key = props.sourceKey;\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.CesiumIonAsset)\r\n      return undefined;\r\n    const rdSource = new RealityDataSourceCesiumIonAssetImpl({ sourceKey });\r\n    let tilesetUrl: string | undefined;\r\n    try {\r\n      tilesetUrl = await rdSource.getServiceUrl(iTwinId);\r\n    } catch { }\r\n\r\n    return (tilesetUrl !== undefined) ? rdSource : undefined;\r\n  }\r\n\r\n  public get isContextShare(): boolean {\r\n    return false;\r\n  }\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    // If url was not resolved - resolve it\r\n    this._tilesetUrl = this.key.id;\r\n    if (this.key.id === CesiumIonAssetProvider.osmBuildingId) {\r\n      this._tilesetUrl = getCesiumOSMBuildingsUrl();\r\n    } else {\r\n      const parsedId = CesiumIonAssetProvider.parseCesiumUrl(this.key.id);\r\n      if (parsedId) {\r\n        this._tilesetUrl = getCesiumAssetUrl(parsedId.id, parsedId.key);\r\n      }\r\n    }\r\n\r\n    return this._tilesetUrl;\r\n  }\r\n\r\n  public async getRootDocument(iTwinId: GuidString | undefined): Promise<any> {\r\n    let 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    const cesiumAsset = CesiumIonAssetProvider.parseCesiumUrl(url);\r\n    if (cesiumAsset) {\r\n      const tokenAndUrl = await getCesiumAccessTokenAndEndpointUrl(`${cesiumAsset.id}`, cesiumAsset.key);\r\n      if (tokenAndUrl.url && tokenAndUrl.token) {\r\n        url = tokenAndUrl.url;\r\n        this._requestAuthorization = `Bearer ${tokenAndUrl.token}`;\r\n      }\r\n    }\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    const headers = { authorization: this._requestAuthorization };\r\n\r\n    return request(url, \"json\", { headers });\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    const tileUrl = this._baseUrl + name;\r\n    const headers = { authorization: this._requestAuthorization };\r\n\r\n    return request(tileUrl, \"arraybuffer\", { headers });\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    const tileUrl = this._baseUrl + name;\r\n    const headers = { authorization: this._requestAuthorization };\r\n\r\n    return request(tileUrl, \"json\", { headers });\r\n  }\r\n\r\n  public getTileContentType(url: string): \"tile\" | \"tileset\" {\r\n    return url.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    // Cesium Ion asset we currenlty support are unbound (cover all earth)\r\n    const spatialLocation: SpatialLocationAndExtents | undefined = undefined;\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":"RealityDataSourceCesiumIonAssetImpl.js","sourceRoot":"","sources":["../../src/RealityDataSourceCesiumIonAssetImpl.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 { request } from \"./request/Request\";\r\nimport { assert, BentleyStatus, GuidString } from \"@itwin/core-bentley\";\r\nimport { IModelError, RealityData, RealityDataProvider, RealityDataSourceKey, RealityDataSourceProps } from \"@itwin/core-common\";\r\nimport { CesiumIonAssetProvider, getCesiumAccessClient, getCesiumAccessTokenAndEndpointUrl, getCesiumAssetUrl, getCesiumOSMBuildingsUrl } from \"./tile/internal\";\r\nimport { PublisherProductInfo, RealityDataSource, SpatialLocationAndExtents } from \"./RealityDataSource\";\r\n\r\n/** This class provides access to the reality data provider services.\r\n * It encapsulates access to a reality data whether 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 RealityDataSourceCesiumIonAssetImpl 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  /** Request authorization for non PW ContextShare requests.*/\r\n  private _requestAuthorization?: 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.CesiumIonAsset);\r\n    this.key = props.sourceKey;\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.CesiumIonAsset)\r\n      return undefined;\r\n    const rdSource = new RealityDataSourceCesiumIonAssetImpl({ sourceKey });\r\n    let tilesetUrl: string | undefined;\r\n    try {\r\n      tilesetUrl = await rdSource.getServiceUrl(iTwinId);\r\n    } catch { }\r\n\r\n    return (tilesetUrl !== undefined) ? rdSource : undefined;\r\n  }\r\n\r\n  public get isContextShare(): boolean {\r\n    return false;\r\n  }\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    // If url was not resolved - resolve it\r\n    this._tilesetUrl = this.key.id;\r\n    if (this.key.id === CesiumIonAssetProvider.osmBuildingId) {\r\n      this._tilesetUrl = getCesiumOSMBuildingsUrl();\r\n    } else {\r\n      const parsedId = CesiumIonAssetProvider.parseCesiumUrl(this.key.id);\r\n      if (parsedId) {\r\n        this._tilesetUrl = getCesiumAssetUrl(parsedId.id, parsedId.key);\r\n      }\r\n    }\r\n\r\n    return this._tilesetUrl;\r\n  }\r\n\r\n  public async getRootDocument(iTwinId: GuidString | undefined): Promise<any> {\r\n    let 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    const cesiumAsset = CesiumIonAssetProvider.parseCesiumUrl(url);\r\n    if (cesiumAsset) {\r\n      let resolvedToken: string | undefined;\r\n      let resolvedUrl: string | undefined;\r\n      if (cesiumAsset.key) {\r\n        // Legacy key-bearing URL (e.g. persisted saved view) - authenticate directly with the embedded Ion key.\r\n        // Such URLs are intentionally exempt from the cesiumAccess-over-cesiumIonKey precedence rule and are not\r\n        // routed through a registered CesiumAccessClient; see [[CesiumAccessClient]].\r\n        const tokenAndUrl = await getCesiumAccessTokenAndEndpointUrl(`${cesiumAsset.id}`, cesiumAsset.key);\r\n        resolvedToken = tokenAndUrl.token;\r\n        resolvedUrl = tokenAndUrl.url;\r\n      } else {\r\n        // delegate to the registered CesiumAccessClient\r\n        const client = getCesiumAccessClient();\r\n        const endpoint = await client.getAssetEndpoint(`${cesiumAsset.id}`, iTwinId);\r\n        if (endpoint) {\r\n          resolvedToken = endpoint.accessToken;\r\n          resolvedUrl = endpoint.url;\r\n        }\r\n      }\r\n      if (resolvedUrl && resolvedToken) {\r\n        url = resolvedUrl;\r\n        this._requestAuthorization = `Bearer ${resolvedToken}`;\r\n      }\r\n    }\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    const headers = { authorization: this._requestAuthorization };\r\n\r\n    return request(url, \"json\", { headers });\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    const tileUrl = this._baseUrl + name;\r\n    const headers = { authorization: this._requestAuthorization };\r\n\r\n    return request(tileUrl, \"arraybuffer\", { headers });\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    const tileUrl = this._baseUrl + name;\r\n    const headers = { authorization: this._requestAuthorization };\r\n\r\n    return request(tileUrl, \"json\", { headers });\r\n  }\r\n\r\n  public getTileContentType(url: string): \"tile\" | \"tileset\" {\r\n    return url.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    // Cesium Ion asset we currenlty support are unbound (cover all earth)\r\n    const spatialLocation: SpatialLocationAndExtents | undefined = undefined;\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"]}

package/lib/esm/SubCategoriesCache.d.ts

@@ -1,6 +1,6 @@
 import { Id64Arg, Id64Set, Id64String } from "@itwin/core-bentley";
 import { SubCategoryAppearance, SubCategoryResultRow } from "@itwin/core-common";
-import { IModelConnection } from "./IModelConnection";
+import type { IModelConnection } from "./IModelConnection";
 /** A cancelable paginated request for subcategory information.
  * @see SubCategoriesCache
  * @internal
@@ -9,7 +9,7 @@ export interface SubCategoriesRequest {
     /** The Ids of any categories which were requested but were not yet loaded. */
     readonly missingCategoryIds: Id64Set;
     /** A promise which resolves to true when all of the requested categories have been loaded, or to false if not all categories were loaded.
-     * Categories may fail to load if the request is explicitly canceled or if the IModelConnection is closed before all categories are loaded.
+     * Categories may fail to load if the request is explicitly canceled, if the IModelConnection is closed before all categories are loaded, or if the query fails.
      */
     readonly promise: Promise<boolean>;
     /** Cancels the request. */
@@ -21,10 +21,16 @@ export interface SubCategoriesRequest {
 export declare class SubCategoriesCache {
     private readonly _byCategoryId;
     private readonly _appearances;
+    private readonly _staleCategoryIds;
     private readonly _imodel;
-    private _missingAtTimeOfPreload;
+    private _invalidationGeneration;
+    private readonly _onChanged;
     constructor(imodel: IModelConnection);
     attachToBriefcase(imodel: IModelConnection): void;
+    /** Register a listener to be notified when transaction changes invalidate cached subcategory information.
+     * @internal
+     */
+    addChangedListener(listener: () => void): () => void;
     /** Get the Ids of all subcategories belonging to the category with the specified Id, or undefined if no such information is present. */
     getSubCategories(categoryId: string): Id64Set | undefined;
     /** Get the base appearance of the subcategory with the specified Id, or undefined if no such information is present. */
@@ -47,6 +53,12 @@ export declare class SubCategoriesCache {
      * @internal
      */
     add(categoryId: string, subCategoryId: string, appearance: SubCategoryAppearance, override: boolean): void;
+    private isCategoryStale;
+    private markCategoryFresh;
+    private markAllCategoriesStale;
+    private markCategoriesStale;
+    private hasStaleCategories;
+    private deleteCategory;
     getCategoryInfo(inputCategoryIds: Id64String | Iterable<Id64String>): Promise<Map<Id64String, IModelConnection.Categories.CategoryInfo>>;
     getSubCategoryInfo(categoryId: Id64String, inputSubCategoryIds: Id64String | Iterable<Id64String>): Promise<Map<Id64String, IModelConnection.Categories.SubCategoryInfo>>;
     private mapSubCategoryInfos;

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

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

package/lib/esm/SubCategoriesCache.js

@@ -2,17 +2,18 @@
 * Copyright (c) Bentley Systems, Incorporated. All rights reserved.
 * See LICENSE.md in the project root for license terms and full copyright notice.
 *--------------------------------------------------------------------------------------------*/
-import { assert, CompressedId64Set, Id64, OrderedId64Iterable } from "@itwin/core-bentley";
+import { assert, BeEvent, CompressedId64Set, Id64, OrderedId64Iterable } from "@itwin/core-bentley";
 import { SubCategoryAppearance } from "@itwin/core-common";
-const invalidCategoryIdEntry = new Set();
 /** A cache of information about the subcategories contained within an [[IModelConnection]]. It is populated on demand.
  * @internal
  */
 export class SubCategoriesCache {
     _byCategoryId = new Map();
     _appearances = new Map();
+    _staleCategoryIds = new Set();
     _imodel;
-    _missingAtTimeOfPreload;
+    _invalidationGeneration = 0;
+    _onChanged = new BeEvent();
     constructor(imodel) {
         this._imodel = imodel;
     }
@@ -23,36 +24,58 @@ export class SubCategoriesCache {
         assert(imodel.isBriefcaseConnection());
         imodel.txns.onElementsChanged.addListener((changes) => {
             const affectedSubCategories = new Set();
+            const affectedCategories = new Set();
+            let invalidateAllCategories = false;
+            let changed = false;
             for (const change of changes) {
                 if (change.metadata.is("BisCore:Category")) {
                     if (change.type === "deleted") {
-                        this._byCategoryId.delete(change.id);
+                        this.deleteCategory(change.id);
+                        changed = true;
                     }
                 }
                 else if (change.metadata.is("BisCore:SubCategory")) {
                     if (change.type === "inserted") {
-                        // We don't know to which category the subcategory belongs. Blow away the entire cache.
-                        this._byCategoryId.clear();
-                        this._appearances.clear();
-                        return;
+                        // We don't know to which category the subcategory belongs, so every cached category may be stale.
+                        invalidateAllCategories = true;
+                        changed = true;
+                        continue;
                     }
-                    this._appearances.delete(change.id);
                     affectedSubCategories.add(change.id);
                 }
             }
-            if (affectedSubCategories.size > 0) {
+            if (invalidateAllCategories) {
+                this.markAllCategoriesStale();
+            }
+            else if (affectedSubCategories.size > 0) {
                 for (const [catId, subCatIds] of this._byCategoryId) {
                     for (const subCatId of affectedSubCategories) {
                         if (subCatIds.has(subCatId)) {
-                            this._byCategoryId.delete(catId);
+                            affectedCategories.add(catId);
+                            changed = true;
                             affectedSubCategories.delete(subCatId);
                             break;
                         }
                     }
                 }
+                if (affectedCategories.size > 0)
+                    this.markCategoriesStale(affectedCategories);
+                // If any affected subcategories were NOT found in cache and categories are currently stale,
+                // bump generation to invalidate in-flight reload queries that may return stale data.
+                if (affectedSubCategories.size > 0 && this.hasStaleCategories()) {
+                    changed = true;
+                }
+            }
+            if (changed) {
+                this._invalidationGeneration++;
+                this._onChanged.raiseEvent();
             }
         });
     }
+    /** Register a listener to be notified when transaction changes invalidate cached subcategory information.
+     * @internal
+     */
+    addChangedListener(listener) { return this._onChanged.addListener(listener); }
     /** Get the Ids of all subcategories belonging to the category with the specified Id, or undefined if no such information is present. */
     getSubCategories(categoryId) { return this._byCategoryId.get(categoryId); }
     /** Get the base appearance of the subcategory with the specified Id, or undefined if no such information is present. */
@@ -67,10 +90,14 @@ export class SubCategoriesCache {
         if (undefined === missing)
             return undefined;
         const request = new SubCategoriesCache.Request(missing, this._imodel);
+        const generation = this._invalidationGeneration;
         const promise = request.dispatch().then((result) => {
-            if (undefined !== result)
+            const completed = undefined !== result && !request.wasCanceled && generation === this._invalidationGeneration;
+            if (completed)
                 this.processResults(result, missing);
-            return !request.wasCanceled;
+            // On failure (result undefined due to query error), do NOT cache empty sets for uncached categories.
+            // Leave them absent so getMissing() will include them in subsequent load() retries.
+            return completed;
         });
         return {
             missingCategoryIds: missing,
@@ -81,9 +108,16 @@ export class SubCategoriesCache {
     /** Load all subcategories that come from used spatial categories of the iModel into the cache. */
     async loadAllUsedSpatialSubCategories() {
         try {
+            const generation = this._invalidationGeneration;
             const results = await this._imodel.queryAllUsedSpatialSubCategories();
-            if (undefined !== results) {
-                this.processResults(results, new Set(), false);
+            if (generation === this._invalidationGeneration && undefined !== results) {
+                const staleCategories = new Set(this._staleCategoryIds);
+                // This preload can return partial results on very large iModels, so keep stale categories additive and
+                // preserve their stale state until a targeted reload can fully reconcile them.
+                for (const row of results)
+                    this.add(row.parentId, row.id, SubCategoriesCache.createSubCategoryAppearance(row.appearance), staleCategories.has(row.parentId));
+                if (staleCategories.size > 0)
+                    this.markCategoriesStale(staleCategories);
             }
         }
         catch {
@@ -94,7 +128,7 @@ export class SubCategoriesCache {
     getMissing(categoryIds) {
         let missing;
         for (const catId of Id64.iterable(categoryIds)) {
-            if (undefined === this._byCategoryId.get(catId)) {
+            if (undefined === this._byCategoryId.get(catId) || this.isCategoryStale(catId)) {
                 if (undefined === missing)
                     missing = new Set();
                 missing.add(catId);
@@ -105,6 +139,8 @@ export class SubCategoriesCache {
     clear() {
         this._byCategoryId.clear();
         this._appearances.clear();
+        this._staleCategoryIds.clear();
+        this._invalidationGeneration++;
     }
     onIModelConnectionClose() {
         this.clear();
@@ -115,14 +151,25 @@ export class SubCategoriesCache {
             props = JSON.parse(json);
         return new SubCategoryAppearance(props);
     }
-    processResults(result, missing, override = true) {
+    processResults(result, refreshedCategoryIds, override = true) {
+        const previousSubCategoryIds = new Map();
+        for (const id of refreshedCategoryIds) {
+            const previous = this._byCategoryId.get(id);
+            if (undefined !== previous)
+                previousSubCategoryIds.set(id, previous);
+            this._byCategoryId.set(id, new Set());
+            this.markCategoryFresh(id);
+        }
         for (const row of result) {
             this.add(row.parentId, row.id, SubCategoriesCache.createSubCategoryAppearance(row.appearance), override);
         }
-        // Ensure that any category Ids which returned no results (e.g., non-existent category, invalid Id, etc) are still recorded so they are not repeatedly re-requested
-        for (const id of missing)
-            if (undefined === this._byCategoryId.get(id))
-                this._byCategoryId.set(id, invalidCategoryIdEntry);
+        for (const [categoryId, previous] of previousSubCategoryIds) {
+            const current = this._byCategoryId.get(categoryId);
+            for (const subCategoryId of previous) {
+                if (!current?.has(subCategoryId))
+                    this._appearances.delete(subCategoryId);
+            }
+        }
     }
     /** Exposed strictly for tests.
      * @internal
@@ -132,9 +179,38 @@ export class SubCategoriesCache {
         if (undefined === set)
             this._byCategoryId.set(categoryId, set = new Set());
         set.add(subCategoryId);
+        this.markCategoryFresh(categoryId);
         if (override || !this._appearances.has(subCategoryId))
             this._appearances.set(subCategoryId, appearance);
     }
+    isCategoryStale(categoryId) {
+        return this._staleCategoryIds.has(categoryId);
+    }
+    markCategoryFresh(categoryId) {
+        this._staleCategoryIds.delete(categoryId);
+    }
+    markAllCategoriesStale() {
+        // We don't know which cached category the inserted subcategory belongs to, so every currently-cached
+        // category may now be missing a subcategory. Mark them all stale so they are re-requested on next load.
+        // Categories cached after this point are loaded fresh and are intentionally left out.
+        for (const categoryId of this._byCategoryId.keys())
+            this._staleCategoryIds.add(categoryId);
+    }
+    markCategoriesStale(categoryIds) {
+        for (const categoryId of categoryIds)
+            this._staleCategoryIds.add(categoryId);
+    }
+    hasStaleCategories() {
+        return this._staleCategoryIds.size > 0;
+    }
+    deleteCategory(categoryId) {
+        const subCategoryIds = this._byCategoryId.get(categoryId);
+        if (undefined !== subCategoryIds)
+            for (const subCategoryId of subCategoryIds)
+                this._appearances.delete(subCategoryId);
+        this._byCategoryId.delete(categoryId);
+        this._staleCategoryIds.delete(categoryId);
+    }
     async getCategoryInfo(inputCategoryIds) {
         // Eliminate duplicates...
         const categoryIds = new Set(typeof inputCategoryIds === "string" ? [inputCategoryIds] : inputCategoryIds);
@@ -144,9 +220,7 @@ export class SubCategoriesCache {
         const map = new Map();
         for (const categoryId of categoryIds) {
             const subCategoryIds = this._byCategoryId.get(categoryId);
-            if (!subCategoryIds)
-                continue;
-            const subCategories = this.mapSubCategoryInfos(categoryId, subCategoryIds);
+            const subCategories = undefined !== subCategoryIds ? this.mapSubCategoryInfos(categoryId, subCategoryIds) : new Map();
             map.set(categoryId, { id: categoryId, subCategories });
         }
         return map;
@@ -202,9 +276,7 @@ export class SubCategoriesCache {
                     return undefined;
             }
             catch {
-                // ###TODO: detect cases in which retry is warranted
-                // Note that currently, if we succeed in obtaining some pages of results and fail to retrieve another page, we will end up processing the
-                // incomplete results. Since we're not retrying, that's the best we can do.
+                return undefined;
             }
             // Finished with current batch of categoryIds. Dispatch the next batch if one exists.
             if (++this._curCategoryIdsIndex < this._categoryIds.length) {