@itwin/frontend-tiles 4.7.0-dev.8 → 4.8.0-dev.0

package/CHANGELOG.md

@@ -1,6 +1,11 @@
 # Change Log - @itwin/frontend-tiles
 
-This log was last generated on Wed, 15 May 2024 21:32:22 GMT and should not be manually modified.
+This log was last generated on Wed, 29 May 2024 14:36:43 GMT and should not be manually modified.
+
+## 4.6.1
+Wed, 29 May 2024 14:35:17 GMT
+
+_Version update only_
 
 ## 4.6.0
 Mon, 13 May 2024 20:32:51 GMT

package/lib/cjs/BatchedTile.d.ts

@@ -15,6 +15,7 @@ export declare class BatchedTile extends Tile {
     private readonly _unskippable;
     /** Transform from the tile's local coordinate system to that of the tileset. */
     readonly transformToRoot?: Transform;
+    private readonly _localCache;
     get batchedTree(): BatchedTileTree;
     constructor(params: BatchedTileParams, tree: BatchedTileTree);
     private get _batchedChildren();

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

@@ -1 +1 @@
-{"version":3,"file":"BatchedTile.d.ts","sourceRoot":"","sources":["../../src/BatchedTile.ts"],"names":[],"mappings":"AAKA,OAAO,EAAU,WAAW,EAAsB,MAAM,qBAAqB,CAAC;AAC9E,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EAAY,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAC/D,OAAO,EACU,cAAc,EAAgC,YAAY,EAAE,IAAI,EAAE,iBAAiB,EAAE,WAAW,EAC/G,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,kBAAkB,EAAsB,QAAQ,EAAkB,QAAQ,EAClH,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAGpD,gBAAgB;AAChB,MAAM,WAAW,iBAAkB,SAAQ,UAAU;IACnD,aAAa,EAAE,eAAe,CAAC,IAAI,EAAE,GAAG,SAAS,CAAC;IAClD,uCAAuC;IACvC,eAAe,EAAE,SAAS,GAAG,SAAS,CAAC;CACxC;AAID,gBAAgB;AAChB,qBAAa,WAAY,SAAQ,IAAI;IACnC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAyB;IACzD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAU;IACvC,gFAAgF;IAChF,SAAgB,eAAe,CAAC,EAAE,SAAS,CAAC;IAE5C,IAAW,WAAW,IAAI,eAAe,CAExC;gBAEkB,MAAM,EAAE,iBAAiB,EAAE,IAAI,EAAE,eAAe;IAyBnE,OAAO,KAAK,gBAAgB,GAE3B;IAEe,mBAAmB,CAAC,SAAS,EAAE,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,QAAQ,CAAC,GAAG,MAAM;IAK/F,WAAW,CAAC,QAAQ,EAAE,GAAG,CAAC,WAAW,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,0BAA0B,EAAE,WAAW,GAAG,SAAS,GAAG,IAAI;cAoC1G,aAAa,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,IAAI,EAAE,GAAG,SAAS,KAAK,IAAI,EAAE,MAAM,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,GAAG,IAAI;IAqBvH,IAAoB,OAAO,IAAI,kBAAkB,CAOhD;IAEqB,cAAc,CAAC,WAAW,EAAE,MAAM,OAAO,GAAG,OAAO,CAAC,WAAW,CAAC,QAAQ,CAAC;IAOzE,WAAW,CAAC,IAAI,EAAE,WAAW,CAAC,YAAY,EAAE,MAAM,EAAE,YAAY,EAAE,UAAU,CAAC,EAAE,MAAM,OAAO,GAAG,OAAO,CAAC,WAAW,CAAC;cAmCtH,eAAe,CAAC,OAAO,EAAE,cAAc,EAAE,IAAI,EAAE,iBAAiB,GAAG,IAAI;IAsBnF,KAAK,CAAC,SAAS,EAAE,WAAW,GAAG,IAAI;CAY3C"}
+{"version":3,"file":"BatchedTile.d.ts","sourceRoot":"","sources":["../../src/BatchedTile.ts"],"names":[],"mappings":"AAKA,OAAO,EAAU,WAAW,EAAsB,MAAM,qBAAqB,CAAC;AAC9E,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EAAY,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAC/D,OAAO,EACU,cAAc,EAAiC,YAAY,EAAE,IAAI,EAAE,iBAAiB,EAAE,WAAW,EAChH,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,kBAAkB,EAAsB,QAAQ,EAAkB,QAAQ,EAClH,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAIpD,gBAAgB;AAChB,MAAM,WAAW,iBAAkB,SAAQ,UAAU;IACnD,aAAa,EAAE,eAAe,CAAC,IAAI,EAAE,GAAG,SAAS,CAAC;IAClD,uCAAuC;IACvC,eAAe,EAAE,SAAS,GAAG,SAAS,CAAC;CACxC;AAID,gBAAgB;AAChB,qBAAa,WAAY,SAAQ,IAAI;IACnC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAyB;IACzD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAU;IACvC,gFAAgF;IAChF,SAAgB,eAAe,CAAC,EAAE,SAAS,CAAC;IAC5C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAa;IAEzC,IAAW,WAAW,IAAI,eAAe,CAExC;gBAEkB,MAAM,EAAE,iBAAiB,EAAE,IAAI,EAAE,eAAe;IA4BnE,OAAO,KAAK,gBAAgB,GAE3B;IAEe,mBAAmB,CAAC,SAAS,EAAE,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,QAAQ,CAAC,GAAG,MAAM;IAK/F,WAAW,CAAC,QAAQ,EAAE,GAAG,CAAC,WAAW,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,0BAA0B,EAAE,WAAW,GAAG,SAAS,GAAG,IAAI;cAoC1G,aAAa,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,IAAI,EAAE,GAAG,SAAS,KAAK,IAAI,EAAE,MAAM,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,GAAG,IAAI;IAqBvH,IAAoB,OAAO,IAAI,kBAAkB,CAOhD;IAEqB,cAAc,CAAC,WAAW,EAAE,MAAM,OAAO,GAAG,OAAO,CAAC,WAAW,CAAC,QAAQ,CAAC;IAOzE,WAAW,CAAC,IAAI,EAAE,WAAW,CAAC,YAAY,EAAE,MAAM,EAAE,YAAY,EAAE,UAAU,CAAC,EAAE,MAAM,OAAO,GAAG,OAAO,CAAC,WAAW,CAAC;cAmCtH,eAAe,CAAC,OAAO,EAAE,cAAc,EAAE,IAAI,EAAE,iBAAiB,GAAG,IAAI;IAsBnF,KAAK,CAAC,SAAS,EAAE,WAAW,GAAG,IAAI;CAY3C"}

package/lib/cjs/BatchedTile.js

@@ -10,6 +10,7 @@ const core_common_1 = require("@itwin/core-common");
 const core_frontend_1 = require("@itwin/core-frontend");
 const LoggerCategory_1 = require("./LoggerCategory");
 const FrontendTiles_1 = require("./FrontendTiles");
+const IndexedDBCache_1 = require("./IndexedDBCache");
 let channel;
 /** @internal */
 class BatchedTile extends core_frontend_1.Tile {
@@ -27,6 +28,7 @@ class BatchedTile extends core_frontend_1.Tile {
             // mark "undisplayable"
             this._maximumSize = 0;
         }
+        this._localCache = FrontendTiles_1.frontendTilesOptions.useIndexedDBCache ? new IndexedDBCache_1.IndexedDBCache("BatchedTileCache") : new IndexedDBCache_1.PassThroughCache();
         if (!params.transformToRoot)
             return;
         this.transformToRoot = params.transformToRoot;
@@ -101,8 +103,8 @@ class BatchedTile extends core_frontend_1.Tile {
     async requestContent(_isCanceled) {
         const url = new URL(this.contentId, this.batchedTree.reader.baseUrl);
         url.search = this.batchedTree.reader.baseUrl.search;
-        const response = await fetch(url.toString());
-        return response.arrayBuffer();
+        const response = await this._localCache.fetch(url.pathname.toString(), fetch, url.toString());
+        return response;
     }
     async readContent(data, system, isCanceled) {
         (0, core_bentley_1.assert)(data instanceof Uint8Array);

package/lib/cjs/BatchedTile.js.map

@@ -1 +1 @@
-{"version":3,"file":"BatchedTile.js","sourceRoot":"","sources":["../../src/BatchedTile.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\r\nimport { assert, BeTimePoint, ByteStream, Logger } from \"@itwin/core-bentley\";\r\nimport { Transform } from \"@itwin/core-geometry\";\r\nimport { ColorDef, Tileset3dSchema } from \"@itwin/core-common\";\r\nimport {\r\n  GraphicBranch, GraphicBuilder, IModelApp, RealityTileLoader, RenderSystem, Tile, TileBoundingBoxes, TileContent,\r\n  TileDrawArgs, TileParams, TileRequest, TileRequestChannel, TileTreeLoadStatus, TileUser, TileVisibility, Viewport,\r\n} from \"@itwin/core-frontend\";\r\nimport { loggerCategory } from \"./LoggerCategory\";\r\nimport { BatchedTileTree } from \"./BatchedTileTree\";\r\nimport { frontendTilesOptions } from \"./FrontendTiles\";\r\n\r\n/** @internal */\r\nexport interface BatchedTileParams extends TileParams {\r\n  childrenProps: Tileset3dSchema.Tile[] | undefined;\r\n  /** See BatchedTile.transformToRoot. */\r\n  transformToRoot: Transform | undefined;\r\n}\r\n\r\nlet channel: TileRequestChannel | undefined;\r\n\r\n/** @internal */\r\nexport class BatchedTile extends Tile {\r\n  private readonly _childrenProps?: Tileset3dSchema.Tile[];\r\n  private readonly _unskippable: boolean;\r\n  /** Transform from the tile's local coordinate system to that of the tileset. */\r\n  public readonly transformToRoot?: Transform;\r\n\r\n  public get batchedTree(): BatchedTileTree {\r\n    return this.tree as BatchedTileTree;\r\n  }\r\n\r\n  public constructor(params: BatchedTileParams, tree: BatchedTileTree) {\r\n    super(params, tree);\r\n\r\n    // The root tile never has content, so it doesn't count toward max levels to skip.\r\n    this._unskippable = 0 === (this.depth % frontendTilesOptions.maxLevelsToSkip);\r\n\r\n    if (params.childrenProps?.length)\r\n      this._childrenProps = params.childrenProps;\r\n\r\n    if (!this.contentId) {\r\n      this.setIsReady();\r\n      // mark \"undisplayable\"\r\n      this._maximumSize = 0;\r\n    }\r\n\r\n    if (!params.transformToRoot)\r\n      return;\r\n\r\n    this.transformToRoot = params.transformToRoot;\r\n    this.boundingSphere.transformBy(this.transformToRoot, this.boundingSphere);\r\n    this.transformToRoot.multiplyRange(this.range, this.range);\r\n    if (this._contentRange)\r\n      this.transformToRoot.multiplyRange(this._contentRange, this._contentRange);\r\n  }\r\n\r\n  private get _batchedChildren(): BatchedTile[] | undefined {\r\n    return this.children as BatchedTile[] | undefined;\r\n  }\r\n\r\n  public override computeLoadPriority(viewports: Iterable<Viewport>, _users: Iterable<TileUser>): number {\r\n    // Prioritize tiles closer to camera and center of attention (zoom point or screen center).\r\n    return RealityTileLoader.computeTileLocationPriority(this, viewports, this.tree.iModelTransform);\r\n  }\r\n\r\n  public selectTiles(selected: Set<BatchedTile>, args: TileDrawArgs, closestDisplayableAncestor: BatchedTile | undefined): void {\r\n    const vis = this.computeVisibility(args);\r\n    if (TileVisibility.OutsideFrustum === vis)\r\n      return;\r\n\r\n    if (this._unskippable) {\r\n      // Prevent this tile's content from being unloaded due to memory pressure.\r\n      args.touchedTiles.add(this);\r\n      args.markUsed(this);\r\n    }\r\n\r\n    closestDisplayableAncestor = this.hasGraphics ? this : closestDisplayableAncestor;\r\n    if (TileVisibility.TooCoarse === vis && (this.isReady || !this._unskippable)) {\r\n      args.markUsed(this);\r\n      args.markReady(this);\r\n      const childrenLoadStatus = this.loadChildren();\r\n      if (TileTreeLoadStatus.Loading === childrenLoadStatus)\r\n        args.markChildrenLoading();\r\n\r\n      const children = this._batchedChildren;\r\n      if (children) {\r\n        for (const child of children)\r\n          child.selectTiles(selected, args, closestDisplayableAncestor);\r\n\r\n        return;\r\n      }\r\n    }\r\n\r\n    // We want to display this tile. Request its content if not already loaded.\r\n    if ((TileVisibility.Visible === vis || this._unskippable) && !this.isReady)\r\n      args.insertMissing(this);\r\n\r\n    if (closestDisplayableAncestor)\r\n      selected.add(closestDisplayableAncestor);\r\n  }\r\n\r\n  protected override _loadChildren(resolve: (children: Tile[] | undefined) => void, reject: (error: Error) => void): void {\r\n    let children: BatchedTile[] | undefined;\r\n    if (this._childrenProps) {\r\n      try {\r\n        for (const childProps of this._childrenProps) {\r\n          const params = this.batchedTree.reader.readTileParams(childProps, this);\r\n          const child = new BatchedTile(params, this.batchedTree);\r\n          children = children ?? [];\r\n          children.push(child);\r\n        }\r\n      } catch (err) {\r\n        Logger.logException(loggerCategory, err);\r\n        children = undefined;\r\n        if (err instanceof Error)\r\n          reject(err);\r\n      }\r\n    }\r\n\r\n    resolve(children);\r\n  }\r\n\r\n  public override get channel(): TileRequestChannel {\r\n    if (!channel) {\r\n      channel = new TileRequestChannel(\"itwinjs-batched-models\", 20);\r\n      IModelApp.tileAdmin.channels.add(channel);\r\n    }\r\n\r\n    return channel;\r\n  }\r\n\r\n  public override async requestContent(_isCanceled: () => boolean): Promise<TileRequest.Response> {\r\n    const url = new URL(this.contentId, this.batchedTree.reader.baseUrl);\r\n    url.search = this.batchedTree.reader.baseUrl.search;\r\n    const response = await fetch(url.toString());\r\n    return response.arrayBuffer();\r\n  }\r\n\r\n  public override async readContent(data: TileRequest.ResponseData, system: RenderSystem, isCanceled?: () => boolean): Promise<TileContent> {\r\n    assert(data instanceof Uint8Array);\r\n    if (!(data instanceof Uint8Array))\r\n      return { };\r\n\r\n    try {\r\n      const modelGroups = this.batchedTree.modelGroups;\r\n\r\n      const content = await this.batchedTree.decoder.decode({\r\n        stream: ByteStream.fromUint8Array(data),\r\n        options: { tileId: this.contentId },\r\n        system,\r\n        isCanceled,\r\n        isLeaf: this.isLeaf,\r\n        // Don't waste time attempting to split based on model groupings if all models are in the same group.\r\n        modelGroups: modelGroups && modelGroups.length > 1 ? modelGroups : undefined,\r\n      });\r\n\r\n      if (this.transformToRoot) {\r\n        if (content.graphic) {\r\n          const branch = new GraphicBranch(true);\r\n          branch.add(content.graphic);\r\n          content.graphic = system.createBranch(branch, this.transformToRoot);\r\n        }\r\n\r\n        if (content.contentRange)\r\n          content.contentRange = this.transformToRoot.multiplyRange(content.contentRange);\r\n      }\r\n\r\n      return content;\r\n    } catch {\r\n      return { isLeaf: true };\r\n    }\r\n  }\r\n\r\n  protected override addRangeGraphic(builder: GraphicBuilder, type: TileBoundingBoxes): void {\r\n    if (TileBoundingBoxes.ChildVolumes !== type) {\r\n      super.addRangeGraphic(builder, type);\r\n      return;\r\n    }\r\n\r\n    builder.setSymbology(ColorDef.green, ColorDef.green, 2);\r\n    builder.addRangeBox(this.range);\r\n\r\n    this.loadChildren();\r\n    const children = this.children;\r\n    if (!children)\r\n      return;\r\n\r\n    builder.setSymbology(ColorDef.blue, ColorDef.blue.withTransparency(0xdf), 1);\r\n    for (const child of children) {\r\n      const range = child.range;\r\n      builder.addRangeBox(range);\r\n      builder.addRangeBox(range, true);\r\n    }\r\n  }\r\n\r\n  public prune(olderThan: BeTimePoint): void {\r\n    const children = this._batchedChildren;\r\n    if (!children)\r\n      return;\r\n\r\n    if (this.usageMarker.isExpired(olderThan)) {\r\n      this.disposeChildren();\r\n    } else {\r\n      for (const child of children)\r\n        child.prune(olderThan);\r\n    }\r\n  }\r\n}\r\n"]}
+{"version":3,"file":"BatchedTile.js","sourceRoot":"","sources":["../../src/BatchedTile.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\r\nimport { assert, BeTimePoint, ByteStream, Logger } from \"@itwin/core-bentley\";\r\nimport { Transform } from \"@itwin/core-geometry\";\r\nimport { ColorDef, Tileset3dSchema } from \"@itwin/core-common\";\r\nimport {\r\n  GraphicBranch, GraphicBuilder,  IModelApp, RealityTileLoader, RenderSystem, Tile, TileBoundingBoxes, TileContent,\r\n  TileDrawArgs, TileParams, TileRequest, TileRequestChannel, TileTreeLoadStatus, TileUser, TileVisibility, Viewport,\r\n} from \"@itwin/core-frontend\";\r\nimport { loggerCategory } from \"./LoggerCategory\";\r\nimport { BatchedTileTree } from \"./BatchedTileTree\";\r\nimport { frontendTilesOptions } from \"./FrontendTiles\";\r\nimport { IndexedDBCache, LocalCache, PassThroughCache } from \"./IndexedDBCache\";\r\n\r\n/** @internal */\r\nexport interface BatchedTileParams extends TileParams {\r\n  childrenProps: Tileset3dSchema.Tile[] | undefined;\r\n  /** See BatchedTile.transformToRoot. */\r\n  transformToRoot: Transform | undefined;\r\n}\r\n\r\nlet channel: TileRequestChannel | undefined;\r\n\r\n/** @internal */\r\nexport class BatchedTile extends Tile {\r\n  private readonly _childrenProps?: Tileset3dSchema.Tile[];\r\n  private readonly _unskippable: boolean;\r\n  /** Transform from the tile's local coordinate system to that of the tileset. */\r\n  public readonly transformToRoot?: Transform;\r\n  private readonly _localCache: LocalCache;\r\n\r\n  public get batchedTree(): BatchedTileTree {\r\n    return this.tree as BatchedTileTree;\r\n  }\r\n\r\n  public constructor(params: BatchedTileParams, tree: BatchedTileTree) {\r\n    super(params, tree);\r\n\r\n    // The root tile never has content, so it doesn't count toward max levels to skip.\r\n    this._unskippable = 0 === (this.depth % frontendTilesOptions.maxLevelsToSkip);\r\n\r\n    if (params.childrenProps?.length)\r\n      this._childrenProps = params.childrenProps;\r\n\r\n    if (!this.contentId) {\r\n      this.setIsReady();\r\n      // mark \"undisplayable\"\r\n      this._maximumSize = 0;\r\n    }\r\n\r\n    this._localCache = frontendTilesOptions.useIndexedDBCache ? new IndexedDBCache(\"BatchedTileCache\") : new PassThroughCache();\r\n\r\n    if (!params.transformToRoot)\r\n      return;\r\n\r\n    this.transformToRoot = params.transformToRoot;\r\n    this.boundingSphere.transformBy(this.transformToRoot, this.boundingSphere);\r\n    this.transformToRoot.multiplyRange(this.range, this.range);\r\n    if (this._contentRange)\r\n      this.transformToRoot.multiplyRange(this._contentRange, this._contentRange);\r\n\r\n  }\r\n\r\n  private get _batchedChildren(): BatchedTile[] | undefined {\r\n    return this.children as BatchedTile[] | undefined;\r\n  }\r\n\r\n  public override computeLoadPriority(viewports: Iterable<Viewport>, _users: Iterable<TileUser>): number {\r\n    // Prioritize tiles closer to camera and center of attention (zoom point or screen center).\r\n    return RealityTileLoader.computeTileLocationPriority(this, viewports, this.tree.iModelTransform);\r\n  }\r\n\r\n  public selectTiles(selected: Set<BatchedTile>, args: TileDrawArgs, closestDisplayableAncestor: BatchedTile | undefined): void {\r\n    const vis = this.computeVisibility(args);\r\n    if (TileVisibility.OutsideFrustum === vis)\r\n      return;\r\n\r\n    if (this._unskippable) {\r\n      // Prevent this tile's content from being unloaded due to memory pressure.\r\n      args.touchedTiles.add(this);\r\n      args.markUsed(this);\r\n    }\r\n\r\n    closestDisplayableAncestor = this.hasGraphics ? this : closestDisplayableAncestor;\r\n    if (TileVisibility.TooCoarse === vis && (this.isReady || !this._unskippable)) {\r\n      args.markUsed(this);\r\n      args.markReady(this);\r\n      const childrenLoadStatus = this.loadChildren();\r\n      if (TileTreeLoadStatus.Loading === childrenLoadStatus)\r\n        args.markChildrenLoading();\r\n\r\n      const children = this._batchedChildren;\r\n      if (children) {\r\n        for (const child of children)\r\n          child.selectTiles(selected, args, closestDisplayableAncestor);\r\n\r\n        return;\r\n      }\r\n    }\r\n\r\n    // We want to display this tile. Request its content if not already loaded.\r\n    if ((TileVisibility.Visible === vis || this._unskippable) && !this.isReady)\r\n      args.insertMissing(this);\r\n\r\n    if (closestDisplayableAncestor)\r\n      selected.add(closestDisplayableAncestor);\r\n  }\r\n\r\n  protected override _loadChildren(resolve: (children: Tile[] | undefined) => void, reject: (error: Error) => void): void {\r\n    let children: BatchedTile[] | undefined;\r\n    if (this._childrenProps) {\r\n      try {\r\n        for (const childProps of this._childrenProps) {\r\n          const params = this.batchedTree.reader.readTileParams(childProps, this);\r\n          const child = new BatchedTile(params, this.batchedTree);\r\n          children = children ?? [];\r\n          children.push(child);\r\n        }\r\n      } catch (err) {\r\n        Logger.logException(loggerCategory, err);\r\n        children = undefined;\r\n        if (err instanceof Error)\r\n          reject(err);\r\n      }\r\n    }\r\n\r\n    resolve(children);\r\n  }\r\n\r\n  public override get channel(): TileRequestChannel {\r\n    if (!channel) {\r\n      channel = new TileRequestChannel(\"itwinjs-batched-models\", 20);\r\n      IModelApp.tileAdmin.channels.add(channel);\r\n    }\r\n\r\n    return channel;\r\n  }\r\n\r\n  public override async requestContent(_isCanceled: () => boolean): Promise<TileRequest.Response> {\r\n    const url = new URL(this.contentId, this.batchedTree.reader.baseUrl);\r\n    url.search = this.batchedTree.reader.baseUrl.search;\r\n    const response = await this._localCache.fetch(url.pathname.toString(), fetch, url.toString());\r\n    return response;\r\n  }\r\n\r\n  public override async readContent(data: TileRequest.ResponseData, system: RenderSystem, isCanceled?: () => boolean): Promise<TileContent> {\r\n    assert(data instanceof Uint8Array);\r\n    if (!(data instanceof Uint8Array))\r\n      return { };\r\n\r\n    try {\r\n      const modelGroups = this.batchedTree.modelGroups;\r\n\r\n      const content = await this.batchedTree.decoder.decode({\r\n        stream: ByteStream.fromUint8Array(data),\r\n        options: { tileId: this.contentId },\r\n        system,\r\n        isCanceled,\r\n        isLeaf: this.isLeaf,\r\n        // Don't waste time attempting to split based on model groupings if all models are in the same group.\r\n        modelGroups: modelGroups && modelGroups.length > 1 ? modelGroups : undefined,\r\n      });\r\n\r\n      if (this.transformToRoot) {\r\n        if (content.graphic) {\r\n          const branch = new GraphicBranch(true);\r\n          branch.add(content.graphic);\r\n          content.graphic = system.createBranch(branch, this.transformToRoot);\r\n        }\r\n\r\n        if (content.contentRange)\r\n          content.contentRange = this.transformToRoot.multiplyRange(content.contentRange);\r\n      }\r\n\r\n      return content;\r\n    } catch {\r\n      return { isLeaf: true };\r\n    }\r\n  }\r\n\r\n  protected override addRangeGraphic(builder: GraphicBuilder, type: TileBoundingBoxes): void {\r\n    if (TileBoundingBoxes.ChildVolumes !== type) {\r\n      super.addRangeGraphic(builder, type);\r\n      return;\r\n    }\r\n\r\n    builder.setSymbology(ColorDef.green, ColorDef.green, 2);\r\n    builder.addRangeBox(this.range);\r\n\r\n    this.loadChildren();\r\n    const children = this.children;\r\n    if (!children)\r\n      return;\r\n\r\n    builder.setSymbology(ColorDef.blue, ColorDef.blue.withTransparency(0xdf), 1);\r\n    for (const child of children) {\r\n      const range = child.range;\r\n      builder.addRangeBox(range);\r\n      builder.addRangeBox(range, true);\r\n    }\r\n  }\r\n\r\n  public prune(olderThan: BeTimePoint): void {\r\n    const children = this._batchedChildren;\r\n    if (!children)\r\n      return;\r\n\r\n    if (this.usageMarker.isExpired(olderThan)) {\r\n      this.disposeChildren();\r\n    } else {\r\n      for (const child of children)\r\n        child.prune(olderThan);\r\n    }\r\n  }\r\n}\r\n"]}

package/lib/cjs/FrontendTiles.d.ts

@@ -115,6 +115,11 @@ export interface FrontendTilesOptions {
      * @beta
      */
     enableCDN?: boolean;
+    /** Specifies whether to enable an IndexedDB database for use as a local cache.
+    * Requested tiles will then first be search for in the database, and if not found, fetched as normal.
+    * @internal
+    */
+    useIndexedDBCache?: boolean;
 }
 /** Global configuration initialized by [[initializeFrontendTiles]].
  * @internal
@@ -122,6 +127,7 @@ export interface FrontendTilesOptions {
 export declare const frontendTilesOptions: {
     maxLevelsToSkip: number;
     enableEdges: boolean;
+    useIndexedDBCache: boolean;
 };
 /** Initialize the frontend-tiles package to obtain tiles for spatial views.
  * @beta

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

@@ -1 +1 @@
-{"version":3,"file":"FrontendTiles.d.ts","sourceRoot":"","sources":["../../src/FrontendTiles.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,WAAW,EAAU,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAAa,gBAAgB,EAA+C,MAAM,sBAAsB,CAAC;AAIhH;;;;;GAKG;AACH,MAAM,MAAM,4BAA4B,GAAG,CAAC,MAAM,EAAE,gBAAgB,KAAK,OAAO,CAAC,GAAG,GAAG,SAAS,CAAC,CAAC;AAgBlG;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE;QACP,QAAQ,EAAE,MAAM,CAAC;QACjB,WAAW,EAAE,MAAM,CAAC;QACpB,UAAU,EAAE,MAAM,CAAC;QACnB,eAAe,EAAE,GAAG,CAAC;QACrB,oBAAoB,EAAE,GAAG,CAAC;KAC3B,CAAC;IAGF,MAAM,EAAE;QACN,IAAI,EAAE;YACJ,IAAI,EAAE,MAAM,CAAC;SACd,CAAC;KACH,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,UAAU,EAAE,CAAC;IAGtB,MAAM,EAAE;QACN,IAAI,CAAC,EAAE;YACL,IAAI,EAAE,MAAM,CAAC;SACd,CAAC;KACH,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,wDAAwD;IACxD,WAAW,EAAE,WAAW,CAAC;IACzB,uDAAuD;IACvD,QAAQ,EAAE,MAAM,CAAC;IACjB,yFAAyF;IACzF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,4CAA4C;IAC5C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,qIAAqI;IACrI,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,gFAAgF;IAChF,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;;;GAIG;AACH,wBAAuB,gBAAgB,CAAC,IAAI,EAAE,oBAAoB,GAAG,qBAAqB,CAAC,UAAU,CAAC,CA8BrG;AAED;;GAEG;AACH,MAAM,WAAW,8BAA8B;IAC7C,oDAAoD;IACpD,MAAM,EAAE,gBAAgB,CAAC;IACzB,wDAAwD;IACxD,WAAW,EAAE,WAAW,CAAC;IACzB,4CAA4C;IAC5C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,gFAAgF;IAChF,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;;;;GAKG;AACH,wBAAsB,0BAA0B,CAAC,IAAI,EAAE,8BAA8B,GAAG,OAAO,CAAC,GAAG,GAAG,SAAS,CAAC,CAqC/G;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC;;OAEG;IACH,4BAA4B,CAAC,EAAE,4BAA4B,CAAC;IAC5D;;;;;;;OAOG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;;;;OAKG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;GAEG;AACH,eAAO,MAAM,oBAAoB;;;CAGhC,CAAC;AAEF;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,oBAAoB,GAAG,IAAI,CAY3E"}
+{"version":3,"file":"FrontendTiles.d.ts","sourceRoot":"","sources":["../../src/FrontendTiles.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,WAAW,EAAU,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAAa,gBAAgB,EAA+C,MAAM,sBAAsB,CAAC;AAIhH;;;;;GAKG;AACH,MAAM,MAAM,4BAA4B,GAAG,CAAC,MAAM,EAAE,gBAAgB,KAAK,OAAO,CAAC,GAAG,GAAG,SAAS,CAAC,CAAC;AAgBlG;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE;QACP,QAAQ,EAAE,MAAM,CAAC;QACjB,WAAW,EAAE,MAAM,CAAC;QACpB,UAAU,EAAE,MAAM,CAAC;QACnB,eAAe,EAAE,GAAG,CAAC;QACrB,oBAAoB,EAAE,GAAG,CAAC;KAC3B,CAAC;IAGF,MAAM,EAAE;QACN,IAAI,EAAE;YACJ,IAAI,EAAE,MAAM,CAAC;SACd,CAAC;KACH,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,UAAU,EAAE,CAAC;IAGtB,MAAM,EAAE;QACN,IAAI,CAAC,EAAE;YACL,IAAI,EAAE,MAAM,CAAC;SACd,CAAC;KACH,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,wDAAwD;IACxD,WAAW,EAAE,WAAW,CAAC;IACzB,uDAAuD;IACvD,QAAQ,EAAE,MAAM,CAAC;IACjB,yFAAyF;IACzF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,4CAA4C;IAC5C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,qIAAqI;IACrI,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,gFAAgF;IAChF,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;;;GAIG;AACH,wBAAuB,gBAAgB,CAAC,IAAI,EAAE,oBAAoB,GAAG,qBAAqB,CAAC,UAAU,CAAC,CA8BrG;AAED;;GAEG;AACH,MAAM,WAAW,8BAA8B;IAC7C,oDAAoD;IACpD,MAAM,EAAE,gBAAgB,CAAC;IACzB,wDAAwD;IACxD,WAAW,EAAE,WAAW,CAAC;IACzB,4CAA4C;IAC5C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,gFAAgF;IAChF,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;;;;GAKG;AACH,wBAAsB,0BAA0B,CAAC,IAAI,EAAE,8BAA8B,GAAG,OAAO,CAAC,GAAG,GAAG,SAAS,CAAC,CAqC/G;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC;;OAEG;IACH,4BAA4B,CAAC,EAAE,4BAA4B,CAAC;IAC5D;;;;;;;OAOG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;;;;OAKG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;;MAGE;IACF,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED;;GAEG;AACH,eAAO,MAAM,oBAAoB;;;;CAIhC,CAAC;AAEF;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,oBAAoB,GAAG,IAAI,CAe3E"}

package/lib/cjs/FrontendTiles.js

@@ -100,6 +100,7 @@ exports.obtainMeshExportTilesetUrl = obtainMeshExportTilesetUrl;
 exports.frontendTilesOptions = {
     maxLevelsToSkip: 4,
     enableEdges: false,
+    useIndexedDBCache: false,
 };
 /** Initialize the frontend-tiles package to obtain tiles for spatial views.
  * @beta
@@ -109,6 +110,8 @@ function initializeFrontendTiles(options) {
         exports.frontendTilesOptions.maxLevelsToSkip = options.maxLevelsToSkip;
     if (options.enableEdges)
         exports.frontendTilesOptions.enableEdges = true;
+    if (options.useIndexedDBCache)
+        exports.frontendTilesOptions.useIndexedDBCache = true;
     const computeUrl = options.computeSpatialTilesetBaseUrl ?? (async (iModel) => obtainMeshExportTilesetUrl({ iModel, accessToken: await core_frontend_1.IModelApp.getAccessToken(), enableCDN: options.enableCDN }));
     core_frontend_1.SpatialTileTreeReferences.create = (view) => (0, BatchedSpatialTileTreeRefs_1.createBatchedSpatialTileTreeReferences)(view, computeUrl);
 }

package/lib/cjs/FrontendTiles.js.map

@@ -1 +1 @@
-{"version":3,"file":"FrontendTiles.js","sourceRoot":"","sources":["../../src/FrontendTiles.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\r\nimport { AccessToken, Logger } from \"@itwin/core-bentley\";\r\nimport { IModelApp, IModelConnection, SpatialTileTreeReferences, SpatialViewState } from \"@itwin/core-frontend\";\r\nimport { loggerCategory } from \"./LoggerCategory\";\r\nimport { createBatchedSpatialTileTreeReferences } from \"./BatchedSpatialTileTreeRefs\";\r\n\r\n/** A function that can provide the base URL where a tileset representing all of the spatial models in a given iModel are stored.\r\n * The tileset is expected to reside at \"baseUrl/tileset.json\" and to have been produced by the [mesh export service](https://developer.bentley.com/apis/mesh-export/).\r\n * If no such tileset exists for the given iModel, return `undefined`.\r\n * @see [[FrontendTilesOptions.computeSpatialTilesetBaseUrl]].\r\n * @beta\r\n */\r\nexport type ComputeSpatialTilesetBaseUrl = (iModel: IModelConnection) => Promise<URL | undefined>;\r\n\r\nfunction createMeshExportServiceQueryUrl(args: { iModelId: string, urlPrefix?: string, changesetId?: string, enableCDN?: boolean }): string {\r\n  const prefix = args.urlPrefix ?? \"\";\r\n  let url = `https://${prefix}api.bentley.com/mesh-export/?iModelId=${args.iModelId}&$orderBy=date:desc`;\r\n  if (args.changesetId)\r\n    url = `${url}&changesetId=${args.changesetId}`;\r\n\r\n  if (args.enableCDN)\r\n    url = `${url}&cdn=1`;\r\n\r\n  url = `${url}&tileVersion=1&exportType=IMODEL`;\r\n\r\n  return url;\r\n}\r\n\r\n/** Represents the result of a [mesh export](https://developer.bentley.com/apis/mesh-export/operations/get-export/#export).\r\n * @see [[queryCompletedMeshExports]].\r\n * @beta\r\n */\r\nexport interface MeshExport {\r\n  id: string;\r\n  displayName: string;\r\n  status: string;\r\n  request: {\r\n    iModelId: string;\r\n    changesetId: string;\r\n    exportType: string;\r\n    geometryOptions: any;\r\n    viewDefinitionFilter: any;\r\n  };\r\n\r\n  /* eslint-disable-next-line @typescript-eslint/naming-convention */\r\n  _links: {\r\n    mesh: {\r\n      href: string;\r\n    };\r\n  };\r\n}\r\n\r\n/** Exposed strictly for tests.\r\n * @internal\r\n */\r\nexport interface MeshExports {\r\n  exports: MeshExport[];\r\n\r\n  /* eslint-disable-next-line @typescript-eslint/naming-convention */\r\n  _links: {\r\n    next?: {\r\n      href: string;\r\n    };\r\n  };\r\n}\r\n\r\n/** Arguments supplied to [[queryMeshExports]].\r\n * @beta\r\n */\r\nexport interface QueryMeshExportsArgs {\r\n  /** The token used to access the mesh export service. */\r\n  accessToken: AccessToken;\r\n  /** The Id of the iModel for which to query exports. */\r\n  iModelId: string;\r\n  /** If defined, constrains the query to exports produced from the specified changeset. */\r\n  changesetId?: string;\r\n  /** Chiefly used in testing environments. */\r\n  urlPrefix?: string;\r\n  /** If true, exports whose status is not \"Complete\" (indicating the export successfully finished) will be included in the results. */\r\n  includeIncomplete?: boolean;\r\n  /** If true, enables a CDN (content delivery network) to access tiles faster. */\r\n  enableCDN?: boolean;\r\n}\r\n\r\n/** Query the [mesh export service](https://developer.bentley.com/apis/mesh-export/operations/get-exports/) for exports of type \"IMODEL\" matching\r\n * the specified criteria.\r\n * The exports are sorted from most-recently- to least-recently-produced.\r\n * @beta\r\n */\r\nexport async function* queryMeshExports(args: QueryMeshExportsArgs): AsyncIterableIterator<MeshExport> {\r\n  const headers = {\r\n    /* eslint-disable-next-line @typescript-eslint/naming-convention */\r\n    Authorization: args.accessToken ?? await IModelApp.getAccessToken(),\r\n    /* eslint-disable-next-line @typescript-eslint/naming-convention */\r\n    Accept: \"application/vnd.bentley.itwin-platform.v1+json\",\r\n    /* eslint-disable-next-line @typescript-eslint/naming-convention */\r\n    Prefer: \"return=representation\",\r\n    /* eslint-disable-next-line @typescript-eslint/naming-convention */\r\n    SessionId: IModelApp.sessionId,\r\n  };\r\n\r\n  let url: string | undefined = createMeshExportServiceQueryUrl(args);\r\n  while (url) {\r\n    let result;\r\n    try {\r\n      const response = await fetch(url, { headers });\r\n      result = await response.json() as MeshExports;\r\n    } catch (err) {\r\n      Logger.logException(loggerCategory, err);\r\n      Logger.logError(loggerCategory, `Failed loading exports for iModel ${args.iModelId}`);\r\n      break;\r\n    }\r\n\r\n    const foundExports = result.exports.filter((x) => x.request.exportType === \"IMODEL\" && (args.includeIncomplete || x.status === \"Complete\"));\r\n    for (const foundExport of foundExports)\r\n      yield foundExport;\r\n\r\n    url = result._links.next?.href;\r\n  }\r\n}\r\n\r\n/** Arguments supplied  to [[obtainMeshExportTilesetUrl]].\r\n * @beta\r\n */\r\nexport interface ObtainMeshExportTilesetUrlArgs {\r\n  /** The iModel for which to obtain a tileset URl. */\r\n  iModel: IModelConnection;\r\n  /** The token used to access the mesh export service. */\r\n  accessToken: AccessToken;\r\n  /** Chiefly used in testing environments. */\r\n  urlPrefix?: string;\r\n  /** If true, only exports produced for `iModel`'s specific changeset will be considered; otherwise, if no exports are found for the changeset,\r\n   * the most recent export for any changeset will be used.\r\n   */\r\n  requireExactChangeset?: boolean;\r\n  /** If true, enables a CDN (content delivery network) to access tiles faster. */\r\n  enableCDN?: boolean;\r\n}\r\n\r\n/** Obtains a URL pointing to a tileset appropriate for visualizing a specific iModel.\r\n * [[queryCompletedMeshExports]] is used to obtain a list of available exports. By default, the list is sorted from most to least recently-exported.\r\n * The first export matching the iModel's changeset is selected; or, if no such export exists, the first export in the list is selected.\r\n * @returns A URL from which the tileset can be loaded, or `undefined` if no appropriate URL could be obtained.\r\n * @beta\r\n */\r\nexport async function obtainMeshExportTilesetUrl(args: ObtainMeshExportTilesetUrlArgs): Promise<URL | undefined> {\r\n  if (!args.iModel.iModelId) {\r\n    Logger.logInfo(loggerCategory, \"Cannot obtain exports for an iModel with no iModelId\");\r\n    return undefined;\r\n  }\r\n\r\n  const queryArgs: QueryMeshExportsArgs = {\r\n    accessToken: args.accessToken,\r\n    iModelId: args.iModel.iModelId,\r\n    changesetId: args.iModel.changeset.id,\r\n    urlPrefix: args.urlPrefix,\r\n    enableCDN: args.enableCDN,\r\n  };\r\n\r\n  let selectedExport;\r\n  for await (const exp of queryMeshExports(queryArgs)) {\r\n    selectedExport = exp;\r\n    break;\r\n  }\r\n\r\n  if (!selectedExport && !args.requireExactChangeset) {\r\n    queryArgs.changesetId = undefined;\r\n    for await (const exp of queryMeshExports(queryArgs)) {\r\n      selectedExport = exp;\r\n      Logger.logInfo(loggerCategory, `No exports for iModel ${args.iModel.iModelId} for changeset ${args.iModel.changeset.id}; falling back to most recent`);\r\n      break;\r\n    }\r\n  }\r\n\r\n  if (!selectedExport) {\r\n    Logger.logInfo(loggerCategory, `No exports available for iModel ${args.iModel.iModelId}`);\r\n    return undefined;\r\n  }\r\n\r\n  const url = new URL(selectedExport._links.mesh.href);\r\n  url.pathname = `${url.pathname}/tileset.json`;\r\n  return url;\r\n}\r\n\r\n/** Options supplied to [[initializeFrontendTiles]].\r\n * @beta\r\n */\r\nexport interface FrontendTilesOptions {\r\n  /** Provide the base URL for the pre-published tileset for a given iModel.\r\n   * If omitted, [[obtainMeshExportTilesetUrl]] will be invoked with default arguments, using the access token provided by [[IModelApp]].\r\n   */\r\n  computeSpatialTilesetBaseUrl?: ComputeSpatialTilesetBaseUrl;\r\n  /** The maximum number of levels in the tile tree to skip loading if they do not provide the desired level of detail for the current view.\r\n   * Default: 4.\r\n   * Reducing this value will load more intermediate tiles, which causes more gradual refinement: low-resolution tiles will display quickly, followed more gradually by\r\n   * successively higher-resolution ones.\r\n   * Increasing the value jumps more directly to tiles of the exact level of detail desired, which may load more, smaller tiles up-front, leaving some areas of the view\r\n   * vacant for longer; and when zooming out some newly-exposed areas of the view may remain vacant for longer because no lower-resolution tiles are initially available to\r\n   * fill them. However, tiles close to the viewer (and therefore likely of most interest to them) will refine to an appropriate level of detail more quickly.\r\n   */\r\n  maxLevelsToSkip?: number;\r\n  /** Specifies whether to permit the user to enable visible edges or wireframe mode for batched tiles.\r\n   * The currently-deployed mesh export service does not produce edges, so this currently defaults to `false` to avoid user confusion.\r\n   * Set it to `true` if you are loading tiles created with a version of the exporter that does produce edges.\r\n   * ###TODO delete this option once we deploy an edge-producing version of the exporter to production.\r\n   * @internal\r\n   */\r\n  enableEdges?: boolean;\r\n  /** Specifies whether to enable a CDN (content delivery network) to access tiles faster.\r\n   * This option is only used if computeSpatialTilesetBaseUrl is not defined.\r\n   * @beta\r\n   */\r\n  enableCDN?: boolean;\r\n}\r\n\r\n/** Global configuration initialized by [[initializeFrontendTiles]].\r\n * @internal\r\n */\r\nexport const frontendTilesOptions = {\r\n  maxLevelsToSkip: 4,\r\n  enableEdges: false,\r\n};\r\n\r\n/** Initialize the frontend-tiles package to obtain tiles for spatial views.\r\n * @beta\r\n */\r\nexport function initializeFrontendTiles(options: FrontendTilesOptions): void {\r\n  if (undefined !== options.maxLevelsToSkip && options.maxLevelsToSkip >= 0)\r\n    frontendTilesOptions.maxLevelsToSkip = options.maxLevelsToSkip;\r\n\r\n  if (options.enableEdges)\r\n    frontendTilesOptions.enableEdges = true;\r\n\r\n  const computeUrl = options.computeSpatialTilesetBaseUrl ?? (\r\n    async (iModel: IModelConnection) => obtainMeshExportTilesetUrl({ iModel, accessToken: await IModelApp.getAccessToken(), enableCDN: options.enableCDN })\r\n  );\r\n\r\n  SpatialTileTreeReferences.create = (view: SpatialViewState) => createBatchedSpatialTileTreeReferences(view, computeUrl);\r\n}\r\n"]}
+{"version":3,"file":"FrontendTiles.js","sourceRoot":"","sources":["../../src/FrontendTiles.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\r\nimport { AccessToken, Logger } from \"@itwin/core-bentley\";\r\nimport { IModelApp, IModelConnection, SpatialTileTreeReferences, SpatialViewState } from \"@itwin/core-frontend\";\r\nimport { loggerCategory } from \"./LoggerCategory\";\r\nimport { createBatchedSpatialTileTreeReferences } from \"./BatchedSpatialTileTreeRefs\";\r\n\r\n/** A function that can provide the base URL where a tileset representing all of the spatial models in a given iModel are stored.\r\n * The tileset is expected to reside at \"baseUrl/tileset.json\" and to have been produced by the [mesh export service](https://developer.bentley.com/apis/mesh-export/).\r\n * If no such tileset exists for the given iModel, return `undefined`.\r\n * @see [[FrontendTilesOptions.computeSpatialTilesetBaseUrl]].\r\n * @beta\r\n */\r\nexport type ComputeSpatialTilesetBaseUrl = (iModel: IModelConnection) => Promise<URL | undefined>;\r\n\r\nfunction createMeshExportServiceQueryUrl(args: { iModelId: string, urlPrefix?: string, changesetId?: string, enableCDN?: boolean }): string {\r\n  const prefix = args.urlPrefix ?? \"\";\r\n  let url = `https://${prefix}api.bentley.com/mesh-export/?iModelId=${args.iModelId}&$orderBy=date:desc`;\r\n  if (args.changesetId)\r\n    url = `${url}&changesetId=${args.changesetId}`;\r\n\r\n  if (args.enableCDN)\r\n    url = `${url}&cdn=1`;\r\n\r\n  url = `${url}&tileVersion=1&exportType=IMODEL`;\r\n\r\n  return url;\r\n}\r\n\r\n/** Represents the result of a [mesh export](https://developer.bentley.com/apis/mesh-export/operations/get-export/#export).\r\n * @see [[queryCompletedMeshExports]].\r\n * @beta\r\n */\r\nexport interface MeshExport {\r\n  id: string;\r\n  displayName: string;\r\n  status: string;\r\n  request: {\r\n    iModelId: string;\r\n    changesetId: string;\r\n    exportType: string;\r\n    geometryOptions: any;\r\n    viewDefinitionFilter: any;\r\n  };\r\n\r\n  /* eslint-disable-next-line @typescript-eslint/naming-convention */\r\n  _links: {\r\n    mesh: {\r\n      href: string;\r\n    };\r\n  };\r\n}\r\n\r\n/** Exposed strictly for tests.\r\n * @internal\r\n */\r\nexport interface MeshExports {\r\n  exports: MeshExport[];\r\n\r\n  /* eslint-disable-next-line @typescript-eslint/naming-convention */\r\n  _links: {\r\n    next?: {\r\n      href: string;\r\n    };\r\n  };\r\n}\r\n\r\n/** Arguments supplied to [[queryMeshExports]].\r\n * @beta\r\n */\r\nexport interface QueryMeshExportsArgs {\r\n  /** The token used to access the mesh export service. */\r\n  accessToken: AccessToken;\r\n  /** The Id of the iModel for which to query exports. */\r\n  iModelId: string;\r\n  /** If defined, constrains the query to exports produced from the specified changeset. */\r\n  changesetId?: string;\r\n  /** Chiefly used in testing environments. */\r\n  urlPrefix?: string;\r\n  /** If true, exports whose status is not \"Complete\" (indicating the export successfully finished) will be included in the results. */\r\n  includeIncomplete?: boolean;\r\n  /** If true, enables a CDN (content delivery network) to access tiles faster. */\r\n  enableCDN?: boolean;\r\n}\r\n\r\n/** Query the [mesh export service](https://developer.bentley.com/apis/mesh-export/operations/get-exports/) for exports of type \"IMODEL\" matching\r\n * the specified criteria.\r\n * The exports are sorted from most-recently- to least-recently-produced.\r\n * @beta\r\n */\r\nexport async function* queryMeshExports(args: QueryMeshExportsArgs): AsyncIterableIterator<MeshExport> {\r\n  const headers = {\r\n    /* eslint-disable-next-line @typescript-eslint/naming-convention */\r\n    Authorization: args.accessToken ?? await IModelApp.getAccessToken(),\r\n    /* eslint-disable-next-line @typescript-eslint/naming-convention */\r\n    Accept: \"application/vnd.bentley.itwin-platform.v1+json\",\r\n    /* eslint-disable-next-line @typescript-eslint/naming-convention */\r\n    Prefer: \"return=representation\",\r\n    /* eslint-disable-next-line @typescript-eslint/naming-convention */\r\n    SessionId: IModelApp.sessionId,\r\n  };\r\n\r\n  let url: string | undefined = createMeshExportServiceQueryUrl(args);\r\n  while (url) {\r\n    let result;\r\n    try {\r\n      const response = await fetch(url, { headers });\r\n      result = await response.json() as MeshExports;\r\n    } catch (err) {\r\n      Logger.logException(loggerCategory, err);\r\n      Logger.logError(loggerCategory, `Failed loading exports for iModel ${args.iModelId}`);\r\n      break;\r\n    }\r\n\r\n    const foundExports = result.exports.filter((x) => x.request.exportType === \"IMODEL\" && (args.includeIncomplete || x.status === \"Complete\"));\r\n    for (const foundExport of foundExports)\r\n      yield foundExport;\r\n\r\n    url = result._links.next?.href;\r\n  }\r\n}\r\n\r\n/** Arguments supplied  to [[obtainMeshExportTilesetUrl]].\r\n * @beta\r\n */\r\nexport interface ObtainMeshExportTilesetUrlArgs {\r\n  /** The iModel for which to obtain a tileset URl. */\r\n  iModel: IModelConnection;\r\n  /** The token used to access the mesh export service. */\r\n  accessToken: AccessToken;\r\n  /** Chiefly used in testing environments. */\r\n  urlPrefix?: string;\r\n  /** If true, only exports produced for `iModel`'s specific changeset will be considered; otherwise, if no exports are found for the changeset,\r\n   * the most recent export for any changeset will be used.\r\n   */\r\n  requireExactChangeset?: boolean;\r\n  /** If true, enables a CDN (content delivery network) to access tiles faster. */\r\n  enableCDN?: boolean;\r\n}\r\n\r\n/** Obtains a URL pointing to a tileset appropriate for visualizing a specific iModel.\r\n * [[queryCompletedMeshExports]] is used to obtain a list of available exports. By default, the list is sorted from most to least recently-exported.\r\n * The first export matching the iModel's changeset is selected; or, if no such export exists, the first export in the list is selected.\r\n * @returns A URL from which the tileset can be loaded, or `undefined` if no appropriate URL could be obtained.\r\n * @beta\r\n */\r\nexport async function obtainMeshExportTilesetUrl(args: ObtainMeshExportTilesetUrlArgs): Promise<URL | undefined> {\r\n  if (!args.iModel.iModelId) {\r\n    Logger.logInfo(loggerCategory, \"Cannot obtain exports for an iModel with no iModelId\");\r\n    return undefined;\r\n  }\r\n\r\n  const queryArgs: QueryMeshExportsArgs = {\r\n    accessToken: args.accessToken,\r\n    iModelId: args.iModel.iModelId,\r\n    changesetId: args.iModel.changeset.id,\r\n    urlPrefix: args.urlPrefix,\r\n    enableCDN: args.enableCDN,\r\n  };\r\n\r\n  let selectedExport;\r\n  for await (const exp of queryMeshExports(queryArgs)) {\r\n    selectedExport = exp;\r\n    break;\r\n  }\r\n\r\n  if (!selectedExport && !args.requireExactChangeset) {\r\n    queryArgs.changesetId = undefined;\r\n    for await (const exp of queryMeshExports(queryArgs)) {\r\n      selectedExport = exp;\r\n      Logger.logInfo(loggerCategory, `No exports for iModel ${args.iModel.iModelId} for changeset ${args.iModel.changeset.id}; falling back to most recent`);\r\n      break;\r\n    }\r\n  }\r\n\r\n  if (!selectedExport) {\r\n    Logger.logInfo(loggerCategory, `No exports available for iModel ${args.iModel.iModelId}`);\r\n    return undefined;\r\n  }\r\n\r\n  const url = new URL(selectedExport._links.mesh.href);\r\n  url.pathname = `${url.pathname}/tileset.json`;\r\n  return url;\r\n}\r\n\r\n/** Options supplied to [[initializeFrontendTiles]].\r\n * @beta\r\n */\r\nexport interface FrontendTilesOptions {\r\n  /** Provide the base URL for the pre-published tileset for a given iModel.\r\n   * If omitted, [[obtainMeshExportTilesetUrl]] will be invoked with default arguments, using the access token provided by [[IModelApp]].\r\n   */\r\n  computeSpatialTilesetBaseUrl?: ComputeSpatialTilesetBaseUrl;\r\n  /** The maximum number of levels in the tile tree to skip loading if they do not provide the desired level of detail for the current view.\r\n   * Default: 4.\r\n   * Reducing this value will load more intermediate tiles, which causes more gradual refinement: low-resolution tiles will display quickly, followed more gradually by\r\n   * successively higher-resolution ones.\r\n   * Increasing the value jumps more directly to tiles of the exact level of detail desired, which may load more, smaller tiles up-front, leaving some areas of the view\r\n   * vacant for longer; and when zooming out some newly-exposed areas of the view may remain vacant for longer because no lower-resolution tiles are initially available to\r\n   * fill them. However, tiles close to the viewer (and therefore likely of most interest to them) will refine to an appropriate level of detail more quickly.\r\n   */\r\n  maxLevelsToSkip?: number;\r\n  /** Specifies whether to permit the user to enable visible edges or wireframe mode for batched tiles.\r\n   * The currently-deployed mesh export service does not produce edges, so this currently defaults to `false` to avoid user confusion.\r\n   * Set it to `true` if you are loading tiles created with a version of the exporter that does produce edges.\r\n   * ###TODO delete this option once we deploy an edge-producing version of the exporter to production.\r\n   * @internal\r\n   */\r\n  enableEdges?: boolean;\r\n  /** Specifies whether to enable a CDN (content delivery network) to access tiles faster.\r\n   * This option is only used if computeSpatialTilesetBaseUrl is not defined.\r\n   * @beta\r\n   */\r\n  enableCDN?: boolean;\r\n  /** Specifies whether to enable an IndexedDB database for use as a local cache.\r\n  * Requested tiles will then first be search for in the database, and if not found, fetched as normal.\r\n  * @internal\r\n  */\r\n  useIndexedDBCache?: boolean;\r\n}\r\n\r\n/** Global configuration initialized by [[initializeFrontendTiles]].\r\n * @internal\r\n */\r\nexport const frontendTilesOptions = {\r\n  maxLevelsToSkip: 4,\r\n  enableEdges: false,\r\n  useIndexedDBCache: false,\r\n};\r\n\r\n/** Initialize the frontend-tiles package to obtain tiles for spatial views.\r\n * @beta\r\n */\r\nexport function initializeFrontendTiles(options: FrontendTilesOptions): void {\r\n  if (undefined !== options.maxLevelsToSkip && options.maxLevelsToSkip >= 0)\r\n    frontendTilesOptions.maxLevelsToSkip = options.maxLevelsToSkip;\r\n\r\n  if (options.enableEdges)\r\n    frontendTilesOptions.enableEdges = true;\r\n\r\n  if (options.useIndexedDBCache)\r\n    frontendTilesOptions.useIndexedDBCache = true;\r\n\r\n  const computeUrl = options.computeSpatialTilesetBaseUrl ?? (\r\n    async (iModel: IModelConnection) => obtainMeshExportTilesetUrl({ iModel, accessToken: await IModelApp.getAccessToken(), enableCDN: options.enableCDN })\r\n  );\r\n\r\n  SpatialTileTreeReferences.create = (view: SpatialViewState) => createBatchedSpatialTileTreeReferences(view, computeUrl);\r\n}\r\n"]}

package/lib/cjs/IndexedDBCache.d.ts

@@ -0,0 +1,22 @@
+/** @internal */
+export interface LocalCache {
+    fetch(url: string, callback: (uniqueId: string) => Promise<Response>, callBackUrl?: string): Promise<ArrayBuffer>;
+}
+/** @internal */
+export declare class PassThroughCache implements LocalCache {
+    fetch(uniqueId: string, callback: (url: string) => Promise<Response>, callBackUrl?: string): Promise<ArrayBuffer>;
+}
+/** @internal */
+export declare class IndexedDBCache implements LocalCache {
+    private _db;
+    private _dbName;
+    private _expirationTime?;
+    constructor(dbName: string, expirationTime?: number);
+    protected open(): Promise<unknown>;
+    protected close(): Promise<void>;
+    protected retrieveContent(uniqueId: string): Promise<ArrayBuffer | undefined>;
+    protected deleteContent(uniqueId: string): Promise<unknown>;
+    protected addContent(uniqueId: string, content: ArrayBuffer): Promise<unknown>;
+    fetch(uniqueId: string, callback: (url: string) => Promise<Response>, callBackUrl?: string): Promise<ArrayBuffer>;
+}
+//# sourceMappingURL=IndexedDBCache.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"IndexedDBCache.d.ts","sourceRoot":"","sources":["../../src/IndexedDBCache.ts"],"names":[],"mappings":"AAOA,gBAAgB;AAChB,MAAM,WAAW,UAAU;IACzB,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,QAAQ,CAAC,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;CACnH;AAED,gBAAgB;AAChB,qBAAa,gBAAiB,YAAW,UAAU;IACpC,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,QAAQ,CAAC,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;CAM/H;AAED,gBAAgB;AAChB,qBAAa,cAAe,YAAW,UAAU;IAC/C,OAAO,CAAC,GAAG,CAAM;IACjB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,eAAe,CAAC,CAAS;gBAEd,MAAM,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,MAAM;cAK1C,IAAI;cAqCJ,KAAK;cAIL,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC;cAqCnE,aAAa,CAAC,QAAQ,EAAE,MAAM;cAqB9B,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW;IA+BpD,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,QAAQ,CAAC,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;CAiB/H"}

package/lib/cjs/IndexedDBCache.js

@@ -0,0 +1,144 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IndexedDBCache = exports.PassThroughCache = void 0;
+/*---------------------------------------------------------------------------------------------
+* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+* See LICENSE.md in the project root for license terms and full copyright notice.
+*--------------------------------------------------------------------------------------------*/
+const core_bentley_1 = require("@itwin/core-bentley");
+const loggerCategory = "IndexedDBCache";
+/** @internal */
+class PassThroughCache {
+    async fetch(uniqueId, callback, callBackUrl) {
+        if (callBackUrl) {
+            return (await callback(callBackUrl)).arrayBuffer();
+        }
+        return (await callback(uniqueId)).arrayBuffer();
+    }
+}
+exports.PassThroughCache = PassThroughCache;
+/** @internal */
+class IndexedDBCache {
+    constructor(dbName, expirationTime) {
+        this._dbName = dbName;
+        this._expirationTime = expirationTime ?? undefined;
+    }
+    async open() {
+        // need to return a promise so that we can wait for the db to open before using it
+        return new Promise(function (resolve) {
+            // open the db
+            const openDB = window.indexedDB.open(this._dbName, 1);
+            openDB.onerror = () => {
+                core_bentley_1.Logger.logError(loggerCategory, "Error opening IndexedDB");
+            };
+            // this is the success callback for opening the db, it is called after onupgradeneeded
+            openDB.onsuccess = async (event) => {
+                const target = event.target;
+                if (target) {
+                    this._db = target.result;
+                    return resolve(target.result);
+                }
+            };
+            // This will get called when a new version is needed - including going from no database to first version
+            // So this is how we set up the specifics of the db structure
+            openDB.onupgradeneeded = async (event) => {
+                const target = event.target;
+                if (target)
+                    this._db = target.result;
+                const initialObjectStore = this._db.createObjectStore("cache", { keyPath: "uniqueId" });
+                initialObjectStore.createIndex("content", "content", { unique: false });
+                initialObjectStore.createIndex("timeOfStorage", "timeOfStorage", { unique: false });
+            };
+        }.bind(this));
+    }
+    async close() {
+        await this._db.close();
+    }
+    async retrieveContent(uniqueId) {
+        return new Promise(async (resolve) => {
+            await this.open();
+            const getTransaction = await this._db.transaction("cache", "readonly");
+            const storedResponse = await getTransaction.objectStore("cache").get(uniqueId);
+            // this is successful if the db was successfully searched - not only if a match was found
+            storedResponse.onsuccess = async () => {
+                if (storedResponse.result !== undefined) {
+                    // if the content has an expiration time
+                    if (this._expirationTime) {
+                        // We want to know when the result was stored, and how long it's been since that point
+                        const timeSince = Date.now() - storedResponse.result.timeOfStorage;
+                        // If it's been greater than our time limit, delete it and return undefined.
+                        if (timeSince > this._expirationTime) {
+                            await this.deleteContent(uniqueId);
+                            return resolve(undefined);
+                        }
+                    }
+                    const content = storedResponse.result.content;
+                    await this.close();
+                    return resolve(content);
+                }
+                await this.close();
+                return resolve(undefined);
+            };
+            storedResponse.onerror = async () => {
+                core_bentley_1.Logger.logError(loggerCategory, "Error retrieving content from IndexedDB");
+            };
+        });
+    }
+    async deleteContent(uniqueId) {
+        return new Promise(async (resolve) => {
+            await this.open();
+            const deleteTransaction = await this._db.transaction("cache", "readwrite");
+            const requestDelete = await deleteTransaction.objectStore("cache").delete(uniqueId);
+            requestDelete.onerror = () => {
+                core_bentley_1.Logger.logError(loggerCategory, "Error deleting content from IndexedDB");
+            };
+            deleteTransaction.oncomplete = async () => {
+                await this.close();
+                return resolve(undefined);
+            };
+            deleteTransaction.onerror = async () => {
+                core_bentley_1.Logger.logError(loggerCategory, "Error deleting content from IndexedDB");
+            };
+        });
+    }
+    async addContent(uniqueId, content) {
+        return new Promise(async (resolve) => {
+            await this.open();
+            const addTransaction = await this._db.transaction("cache", "readwrite");
+            const objectStore = await addTransaction.objectStore("cache");
+            const data = {
+                uniqueId,
+                content,
+                timeOfStorage: Date.now(),
+            };
+            const requestAdd = await objectStore.add(data);
+            requestAdd.onerror = () => {
+                core_bentley_1.Logger.logError(loggerCategory, "Error adding content to IndexedDB");
+            };
+            addTransaction.oncomplete = async () => {
+                await this.close();
+                return resolve(undefined);
+            };
+            addTransaction.onerror = async () => {
+                core_bentley_1.Logger.logError(loggerCategory, "Error adding content to IndexedDB in add transaction");
+                await this.close();
+                return resolve(undefined);
+            };
+        });
+    }
+    async fetch(uniqueId, callback, callBackUrl) {
+        let response = await this.retrieveContent(uniqueId);
+        // If nothing was found in the db, fetch normally, then add that content to the db
+        if (response === undefined) {
+            // If necessary, use the callback url
+            if (callBackUrl)
+                response = await (await callback(callBackUrl)).arrayBuffer();
+            else
+                response = await (await callback(uniqueId)).arrayBuffer();
+            await this.addContent(uniqueId, response);
+        }
+        return response;
+    }
+}
+exports.IndexedDBCache = IndexedDBCache;
+//# sourceMappingURL=IndexedDBCache.js.map

package/lib/cjs/IndexedDBCache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IndexedDBCache.js","sourceRoot":"","sources":["../../src/IndexedDBCache.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\nimport { Logger } from \"@itwin/core-bentley\";\r\nconst loggerCategory = \"IndexedDBCache\";\r\n\r\n/** @internal */\r\nexport interface LocalCache {\r\n  fetch(url: string, callback: (uniqueId: string) => Promise<Response>, callBackUrl?: string): Promise<ArrayBuffer>;\r\n}\r\n\r\n/** @internal */\r\nexport class PassThroughCache implements LocalCache {\r\n  public async fetch(uniqueId: string, callback: (url: string) => Promise<Response>, callBackUrl?: string): Promise<ArrayBuffer> {\r\n    if (callBackUrl) {\r\n      return (await callback(callBackUrl)).arrayBuffer();\r\n    }\r\n    return (await callback(uniqueId)).arrayBuffer();\r\n  }\r\n}\r\n\r\n/** @internal */\r\nexport class IndexedDBCache implements LocalCache{\r\n  private _db: any;\r\n  private _dbName: string;\r\n  private _expirationTime?: number;\r\n\r\n  public constructor(dbName: string, expirationTime?: number) {\r\n    this._dbName = dbName;\r\n    this._expirationTime = expirationTime ?? undefined;\r\n  }\r\n\r\n  protected async open(){\r\n\r\n    // need to return a promise so that we can wait for the db to open before using it\r\n    return new Promise(function (this: IndexedDBCache, resolve: any) {\r\n\r\n      // open the db\r\n      const openDB = window.indexedDB.open(this._dbName, 1);\r\n\r\n      openDB.onerror = () => {\r\n        Logger.logError(loggerCategory, \"Error opening IndexedDB\");\r\n      };\r\n\r\n      // this is the success callback for opening the db, it is called after onupgradeneeded\r\n      openDB.onsuccess = async (event) => {\r\n\r\n        const target: any = event.target;\r\n        if (target) {\r\n          this._db = target.result;\r\n          return resolve(target.result);\r\n        }\r\n      };\r\n\r\n      // This will get called when a new version is needed - including going from no database to first version\r\n      // So this is how we set up the specifics of the db structure\r\n      openDB.onupgradeneeded = async (event) => {\r\n        const target: any = event.target;\r\n\r\n        if (target)\r\n          this._db = target.result;\r\n\r\n        const initialObjectStore = this._db.createObjectStore(\"cache\", { keyPath: \"uniqueId\" });\r\n        initialObjectStore.createIndex(\"content\", \"content\", {unique: false});\r\n        initialObjectStore.createIndex(\"timeOfStorage\", \"timeOfStorage\", {unique: false});\r\n      };\r\n    }.bind(this));\r\n  }\r\n\r\n  protected async close() {\r\n    await this._db.close();\r\n  }\r\n\r\n  protected async retrieveContent(uniqueId: string): Promise<ArrayBuffer | undefined> {\r\n    return new Promise(async (resolve) => {\r\n      await this.open();\r\n      const getTransaction = await this._db.transaction(\"cache\", \"readonly\");\r\n      const storedResponse = await getTransaction.objectStore(\"cache\").get(uniqueId);\r\n\r\n      // this is successful if the db was successfully searched - not only if a match was found\r\n      storedResponse.onsuccess = async () => {\r\n\r\n        if (storedResponse.result !== undefined) {\r\n\r\n          // if the content has an expiration time\r\n          if (this._expirationTime) {\r\n            // We want to know when the result was stored, and how long it's been since that point\r\n            const timeSince = Date.now() - storedResponse.result.timeOfStorage;\r\n\r\n            // If it's been greater than our time limit, delete it and return undefined.\r\n            if (timeSince > this._expirationTime) {\r\n              await this.deleteContent(uniqueId);\r\n              return resolve(undefined);\r\n            }\r\n          }\r\n          const content = storedResponse.result.content;\r\n          await this.close();\r\n          return resolve(content);\r\n        }\r\n\r\n        await this.close();\r\n        return resolve(undefined);\r\n      };\r\n\r\n      storedResponse.onerror = async () => {\r\n        Logger.logError(loggerCategory, \"Error retrieving content from IndexedDB\");\r\n      };\r\n    });\r\n  }\r\n\r\n  protected async deleteContent(uniqueId: string) {\r\n    return new Promise(async (resolve) => {\r\n      await this.open();\r\n      const deleteTransaction = await this._db.transaction(\"cache\", \"readwrite\");\r\n      const requestDelete = await deleteTransaction.objectStore(\"cache\").delete(uniqueId);\r\n\r\n      requestDelete.onerror = () => {\r\n        Logger.logError(loggerCategory, \"Error deleting content from IndexedDB\");\r\n      };\r\n\r\n      deleteTransaction.oncomplete = async () => {\r\n        await this.close();\r\n        return resolve(undefined);\r\n      };\r\n\r\n      deleteTransaction.onerror = async () => {\r\n        Logger.logError(loggerCategory, \"Error deleting content from IndexedDB\");\r\n      };\r\n    });\r\n  }\r\n\r\n  protected async addContent(uniqueId: string, content: ArrayBuffer) {\r\n    return new Promise(async (resolve) => {\r\n      await this.open();\r\n      const addTransaction = await this._db.transaction(\"cache\", \"readwrite\");\r\n      const objectStore = await addTransaction.objectStore(\"cache\");\r\n\r\n      const data = {\r\n        uniqueId,\r\n        content,\r\n        timeOfStorage: Date.now(),\r\n      };\r\n\r\n      const requestAdd = await objectStore.add(data);\r\n\r\n      requestAdd.onerror = () => {\r\n        Logger.logError(loggerCategory, \"Error adding content to IndexedDB\");\r\n      };\r\n\r\n      addTransaction.oncomplete = async () => {\r\n        await this.close();\r\n        return resolve(undefined);\r\n      };\r\n\r\n      addTransaction.onerror = async () => {\r\n        Logger.logError(loggerCategory, \"Error adding content to IndexedDB in add transaction\");\r\n        await this.close();\r\n        return resolve(undefined);\r\n      };\r\n    });\r\n  }\r\n\r\n  public async fetch(uniqueId: string, callback: (url: string) => Promise<Response>, callBackUrl?: string): Promise<ArrayBuffer> {\r\n    let response = await this.retrieveContent(uniqueId);\r\n\r\n    // If nothing was found in the db, fetch normally, then add that content to the db\r\n    if (response === undefined) {\r\n\r\n      // If necessary, use the callback url\r\n      if (callBackUrl)\r\n        response = await (await callback(callBackUrl)).arrayBuffer();\r\n      else\r\n        response = await (await callback(uniqueId)).arrayBuffer();\r\n\r\n      await this.addContent(uniqueId, response);\r\n    }\r\n\r\n    return response;\r\n  }\r\n}\r\n\r\n"]}

package/lib/esm/BatchedTile.d.ts

@@ -15,6 +15,7 @@ export declare class BatchedTile extends Tile {
     private readonly _unskippable;
     /** Transform from the tile's local coordinate system to that of the tileset. */
     readonly transformToRoot?: Transform;
+    private readonly _localCache;
     get batchedTree(): BatchedTileTree;
     constructor(params: BatchedTileParams, tree: BatchedTileTree);
     private get _batchedChildren();

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

@@ -1 +1 @@
-{"version":3,"file":"BatchedTile.d.ts","sourceRoot":"","sources":["../../src/BatchedTile.ts"],"names":[],"mappings":"AAKA,OAAO,EAAU,WAAW,EAAsB,MAAM,qBAAqB,CAAC;AAC9E,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EAAY,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAC/D,OAAO,EACU,cAAc,EAAgC,YAAY,EAAE,IAAI,EAAE,iBAAiB,EAAE,WAAW,EAC/G,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,kBAAkB,EAAsB,QAAQ,EAAkB,QAAQ,EAClH,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAGpD,gBAAgB;AAChB,MAAM,WAAW,iBAAkB,SAAQ,UAAU;IACnD,aAAa,EAAE,eAAe,CAAC,IAAI,EAAE,GAAG,SAAS,CAAC;IAClD,uCAAuC;IACvC,eAAe,EAAE,SAAS,GAAG,SAAS,CAAC;CACxC;AAID,gBAAgB;AAChB,qBAAa,WAAY,SAAQ,IAAI;IACnC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAyB;IACzD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAU;IACvC,gFAAgF;IAChF,SAAgB,eAAe,CAAC,EAAE,SAAS,CAAC;IAE5C,IAAW,WAAW,IAAI,eAAe,CAExC;gBAEkB,MAAM,EAAE,iBAAiB,EAAE,IAAI,EAAE,eAAe;IAyBnE,OAAO,KAAK,gBAAgB,GAE3B;IAEe,mBAAmB,CAAC,SAAS,EAAE,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,QAAQ,CAAC,GAAG,MAAM;IAK/F,WAAW,CAAC,QAAQ,EAAE,GAAG,CAAC,WAAW,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,0BAA0B,EAAE,WAAW,GAAG,SAAS,GAAG,IAAI;cAoC1G,aAAa,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,IAAI,EAAE,GAAG,SAAS,KAAK,IAAI,EAAE,MAAM,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,GAAG,IAAI;IAqBvH,IAAoB,OAAO,IAAI,kBAAkB,CAOhD;IAEqB,cAAc,CAAC,WAAW,EAAE,MAAM,OAAO,GAAG,OAAO,CAAC,WAAW,CAAC,QAAQ,CAAC;IAOzE,WAAW,CAAC,IAAI,EAAE,WAAW,CAAC,YAAY,EAAE,MAAM,EAAE,YAAY,EAAE,UAAU,CAAC,EAAE,MAAM,OAAO,GAAG,OAAO,CAAC,WAAW,CAAC;cAmCtH,eAAe,CAAC,OAAO,EAAE,cAAc,EAAE,IAAI,EAAE,iBAAiB,GAAG,IAAI;IAsBnF,KAAK,CAAC,SAAS,EAAE,WAAW,GAAG,IAAI;CAY3C"}
+{"version":3,"file":"BatchedTile.d.ts","sourceRoot":"","sources":["../../src/BatchedTile.ts"],"names":[],"mappings":"AAKA,OAAO,EAAU,WAAW,EAAsB,MAAM,qBAAqB,CAAC;AAC9E,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EAAY,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAC/D,OAAO,EACU,cAAc,EAAiC,YAAY,EAAE,IAAI,EAAE,iBAAiB,EAAE,WAAW,EAChH,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,kBAAkB,EAAsB,QAAQ,EAAkB,QAAQ,EAClH,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAIpD,gBAAgB;AAChB,MAAM,WAAW,iBAAkB,SAAQ,UAAU;IACnD,aAAa,EAAE,eAAe,CAAC,IAAI,EAAE,GAAG,SAAS,CAAC;IAClD,uCAAuC;IACvC,eAAe,EAAE,SAAS,GAAG,SAAS,CAAC;CACxC;AAID,gBAAgB;AAChB,qBAAa,WAAY,SAAQ,IAAI;IACnC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAyB;IACzD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAU;IACvC,gFAAgF;IAChF,SAAgB,eAAe,CAAC,EAAE,SAAS,CAAC;IAC5C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAa;IAEzC,IAAW,WAAW,IAAI,eAAe,CAExC;gBAEkB,MAAM,EAAE,iBAAiB,EAAE,IAAI,EAAE,eAAe;IA4BnE,OAAO,KAAK,gBAAgB,GAE3B;IAEe,mBAAmB,CAAC,SAAS,EAAE,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,QAAQ,CAAC,GAAG,MAAM;IAK/F,WAAW,CAAC,QAAQ,EAAE,GAAG,CAAC,WAAW,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,0BAA0B,EAAE,WAAW,GAAG,SAAS,GAAG,IAAI;cAoC1G,aAAa,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,IAAI,EAAE,GAAG,SAAS,KAAK,IAAI,EAAE,MAAM,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,GAAG,IAAI;IAqBvH,IAAoB,OAAO,IAAI,kBAAkB,CAOhD;IAEqB,cAAc,CAAC,WAAW,EAAE,MAAM,OAAO,GAAG,OAAO,CAAC,WAAW,CAAC,QAAQ,CAAC;IAOzE,WAAW,CAAC,IAAI,EAAE,WAAW,CAAC,YAAY,EAAE,MAAM,EAAE,YAAY,EAAE,UAAU,CAAC,EAAE,MAAM,OAAO,GAAG,OAAO,CAAC,WAAW,CAAC;cAmCtH,eAAe,CAAC,OAAO,EAAE,cAAc,EAAE,IAAI,EAAE,iBAAiB,GAAG,IAAI;IAsBnF,KAAK,CAAC,SAAS,EAAE,WAAW,GAAG,IAAI;CAY3C"}

package/lib/esm/BatchedTile.js

@@ -7,6 +7,7 @@ import { ColorDef } from "@itwin/core-common";
 import { GraphicBranch, IModelApp, RealityTileLoader, Tile, TileBoundingBoxes, TileRequestChannel, TileTreeLoadStatus, TileVisibility, } from "@itwin/core-frontend";
 import { loggerCategory } from "./LoggerCategory";
 import { frontendTilesOptions } from "./FrontendTiles";
+import { IndexedDBCache, PassThroughCache } from "./IndexedDBCache";
 let channel;
 /** @internal */
 export class BatchedTile extends Tile {
@@ -24,6 +25,7 @@ export class BatchedTile extends Tile {
             // mark "undisplayable"
             this._maximumSize = 0;
         }
+        this._localCache = frontendTilesOptions.useIndexedDBCache ? new IndexedDBCache("BatchedTileCache") : new PassThroughCache();
         if (!params.transformToRoot)
             return;
         this.transformToRoot = params.transformToRoot;
@@ -98,8 +100,8 @@ export class BatchedTile extends Tile {
     async requestContent(_isCanceled) {
         const url = new URL(this.contentId, this.batchedTree.reader.baseUrl);
         url.search = this.batchedTree.reader.baseUrl.search;
-        const response = await fetch(url.toString());
-        return response.arrayBuffer();
+        const response = await this._localCache.fetch(url.pathname.toString(), fetch, url.toString());
+        return response;
     }
     async readContent(data, system, isCanceled) {
         assert(data instanceof Uint8Array);

package/lib/esm/BatchedTile.js.map

@@ -1 +1 @@
-{"version":3,"file":"BatchedTile.js","sourceRoot":"","sources":["../../src/BatchedTile.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\r\nimport { assert, BeTimePoint, ByteStream, Logger } from \"@itwin/core-bentley\";\r\nimport { Transform } from \"@itwin/core-geometry\";\r\nimport { ColorDef, Tileset3dSchema } from \"@itwin/core-common\";\r\nimport {\r\n  GraphicBranch, GraphicBuilder, IModelApp, RealityTileLoader, RenderSystem, Tile, TileBoundingBoxes, TileContent,\r\n  TileDrawArgs, TileParams, TileRequest, TileRequestChannel, TileTreeLoadStatus, TileUser, TileVisibility, Viewport,\r\n} from \"@itwin/core-frontend\";\r\nimport { loggerCategory } from \"./LoggerCategory\";\r\nimport { BatchedTileTree } from \"./BatchedTileTree\";\r\nimport { frontendTilesOptions } from \"./FrontendTiles\";\r\n\r\n/** @internal */\r\nexport interface BatchedTileParams extends TileParams {\r\n  childrenProps: Tileset3dSchema.Tile[] | undefined;\r\n  /** See BatchedTile.transformToRoot. */\r\n  transformToRoot: Transform | undefined;\r\n}\r\n\r\nlet channel: TileRequestChannel | undefined;\r\n\r\n/** @internal */\r\nexport class BatchedTile extends Tile {\r\n  private readonly _childrenProps?: Tileset3dSchema.Tile[];\r\n  private readonly _unskippable: boolean;\r\n  /** Transform from the tile's local coordinate system to that of the tileset. */\r\n  public readonly transformToRoot?: Transform;\r\n\r\n  public get batchedTree(): BatchedTileTree {\r\n    return this.tree as BatchedTileTree;\r\n  }\r\n\r\n  public constructor(params: BatchedTileParams, tree: BatchedTileTree) {\r\n    super(params, tree);\r\n\r\n    // The root tile never has content, so it doesn't count toward max levels to skip.\r\n    this._unskippable = 0 === (this.depth % frontendTilesOptions.maxLevelsToSkip);\r\n\r\n    if (params.childrenProps?.length)\r\n      this._childrenProps = params.childrenProps;\r\n\r\n    if (!this.contentId) {\r\n      this.setIsReady();\r\n      // mark \"undisplayable\"\r\n      this._maximumSize = 0;\r\n    }\r\n\r\n    if (!params.transformToRoot)\r\n      return;\r\n\r\n    this.transformToRoot = params.transformToRoot;\r\n    this.boundingSphere.transformBy(this.transformToRoot, this.boundingSphere);\r\n    this.transformToRoot.multiplyRange(this.range, this.range);\r\n    if (this._contentRange)\r\n      this.transformToRoot.multiplyRange(this._contentRange, this._contentRange);\r\n  }\r\n\r\n  private get _batchedChildren(): BatchedTile[] | undefined {\r\n    return this.children as BatchedTile[] | undefined;\r\n  }\r\n\r\n  public override computeLoadPriority(viewports: Iterable<Viewport>, _users: Iterable<TileUser>): number {\r\n    // Prioritize tiles closer to camera and center of attention (zoom point or screen center).\r\n    return RealityTileLoader.computeTileLocationPriority(this, viewports, this.tree.iModelTransform);\r\n  }\r\n\r\n  public selectTiles(selected: Set<BatchedTile>, args: TileDrawArgs, closestDisplayableAncestor: BatchedTile | undefined): void {\r\n    const vis = this.computeVisibility(args);\r\n    if (TileVisibility.OutsideFrustum === vis)\r\n      return;\r\n\r\n    if (this._unskippable) {\r\n      // Prevent this tile's content from being unloaded due to memory pressure.\r\n      args.touchedTiles.add(this);\r\n      args.markUsed(this);\r\n    }\r\n\r\n    closestDisplayableAncestor = this.hasGraphics ? this : closestDisplayableAncestor;\r\n    if (TileVisibility.TooCoarse === vis && (this.isReady || !this._unskippable)) {\r\n      args.markUsed(this);\r\n      args.markReady(this);\r\n      const childrenLoadStatus = this.loadChildren();\r\n      if (TileTreeLoadStatus.Loading === childrenLoadStatus)\r\n        args.markChildrenLoading();\r\n\r\n      const children = this._batchedChildren;\r\n      if (children) {\r\n        for (const child of children)\r\n          child.selectTiles(selected, args, closestDisplayableAncestor);\r\n\r\n        return;\r\n      }\r\n    }\r\n\r\n    // We want to display this tile. Request its content if not already loaded.\r\n    if ((TileVisibility.Visible === vis || this._unskippable) && !this.isReady)\r\n      args.insertMissing(this);\r\n\r\n    if (closestDisplayableAncestor)\r\n      selected.add(closestDisplayableAncestor);\r\n  }\r\n\r\n  protected override _loadChildren(resolve: (children: Tile[] | undefined) => void, reject: (error: Error) => void): void {\r\n    let children: BatchedTile[] | undefined;\r\n    if (this._childrenProps) {\r\n      try {\r\n        for (const childProps of this._childrenProps) {\r\n          const params = this.batchedTree.reader.readTileParams(childProps, this);\r\n          const child = new BatchedTile(params, this.batchedTree);\r\n          children = children ?? [];\r\n          children.push(child);\r\n        }\r\n      } catch (err) {\r\n        Logger.logException(loggerCategory, err);\r\n        children = undefined;\r\n        if (err instanceof Error)\r\n          reject(err);\r\n      }\r\n    }\r\n\r\n    resolve(children);\r\n  }\r\n\r\n  public override get channel(): TileRequestChannel {\r\n    if (!channel) {\r\n      channel = new TileRequestChannel(\"itwinjs-batched-models\", 20);\r\n      IModelApp.tileAdmin.channels.add(channel);\r\n    }\r\n\r\n    return channel;\r\n  }\r\n\r\n  public override async requestContent(_isCanceled: () => boolean): Promise<TileRequest.Response> {\r\n    const url = new URL(this.contentId, this.batchedTree.reader.baseUrl);\r\n    url.search = this.batchedTree.reader.baseUrl.search;\r\n    const response = await fetch(url.toString());\r\n    return response.arrayBuffer();\r\n  }\r\n\r\n  public override async readContent(data: TileRequest.ResponseData, system: RenderSystem, isCanceled?: () => boolean): Promise<TileContent> {\r\n    assert(data instanceof Uint8Array);\r\n    if (!(data instanceof Uint8Array))\r\n      return { };\r\n\r\n    try {\r\n      const modelGroups = this.batchedTree.modelGroups;\r\n\r\n      const content = await this.batchedTree.decoder.decode({\r\n        stream: ByteStream.fromUint8Array(data),\r\n        options: { tileId: this.contentId },\r\n        system,\r\n        isCanceled,\r\n        isLeaf: this.isLeaf,\r\n        // Don't waste time attempting to split based on model groupings if all models are in the same group.\r\n        modelGroups: modelGroups && modelGroups.length > 1 ? modelGroups : undefined,\r\n      });\r\n\r\n      if (this.transformToRoot) {\r\n        if (content.graphic) {\r\n          const branch = new GraphicBranch(true);\r\n          branch.add(content.graphic);\r\n          content.graphic = system.createBranch(branch, this.transformToRoot);\r\n        }\r\n\r\n        if (content.contentRange)\r\n          content.contentRange = this.transformToRoot.multiplyRange(content.contentRange);\r\n      }\r\n\r\n      return content;\r\n    } catch {\r\n      return { isLeaf: true };\r\n    }\r\n  }\r\n\r\n  protected override addRangeGraphic(builder: GraphicBuilder, type: TileBoundingBoxes): void {\r\n    if (TileBoundingBoxes.ChildVolumes !== type) {\r\n      super.addRangeGraphic(builder, type);\r\n      return;\r\n    }\r\n\r\n    builder.setSymbology(ColorDef.green, ColorDef.green, 2);\r\n    builder.addRangeBox(this.range);\r\n\r\n    this.loadChildren();\r\n    const children = this.children;\r\n    if (!children)\r\n      return;\r\n\r\n    builder.setSymbology(ColorDef.blue, ColorDef.blue.withTransparency(0xdf), 1);\r\n    for (const child of children) {\r\n      const range = child.range;\r\n      builder.addRangeBox(range);\r\n      builder.addRangeBox(range, true);\r\n    }\r\n  }\r\n\r\n  public prune(olderThan: BeTimePoint): void {\r\n    const children = this._batchedChildren;\r\n    if (!children)\r\n      return;\r\n\r\n    if (this.usageMarker.isExpired(olderThan)) {\r\n      this.disposeChildren();\r\n    } else {\r\n      for (const child of children)\r\n        child.prune(olderThan);\r\n    }\r\n  }\r\n}\r\n"]}
+{"version":3,"file":"BatchedTile.js","sourceRoot":"","sources":["../../src/BatchedTile.ts"],"names":[],"mappings":"AAAA;;;+FAG+F;AAE/F,OAAO,EAAE,MAAM,EAAe,UAAU,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAE9E,OAAO,EAAE,QAAQ,EAAmB,MAAM,oBAAoB,CAAC;AAC/D,OAAO,EACL,aAAa,EAAmB,SAAS,EAAE,iBAAiB,EAAgB,IAAI,EAAE,iBAAiB,EAC5D,kBAAkB,EAAE,kBAAkB,EAAY,cAAc,GACxG,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElD,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,EAAE,cAAc,EAAc,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAShF,IAAI,OAAuC,CAAC;AAE5C,gBAAgB;AAChB,MAAM,OAAO,WAAY,SAAQ,IAAI;IAOnC,IAAW,WAAW;QACpB,OAAO,IAAI,CAAC,IAAuB,CAAC;IACtC,CAAC;IAED,YAAmB,MAAyB,EAAE,IAAqB;QACjE,KAAK,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QAEpB,kFAAkF;QAClF,IAAI,CAAC,YAAY,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,GAAG,oBAAoB,CAAC,eAAe,CAAC,CAAC;QAE9E,IAAI,MAAM,CAAC,aAAa,EAAE,MAAM;YAC9B,IAAI,CAAC,cAAc,GAAG,MAAM,CAAC,aAAa,CAAC;QAE7C,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;YACpB,IAAI,CAAC,UAAU,EAAE,CAAC;YAClB,uBAAuB;YACvB,IAAI,CAAC,YAAY,GAAG,CAAC,CAAC;QACxB,CAAC;QAED,IAAI,CAAC,WAAW,GAAG,oBAAoB,CAAC,iBAAiB,CAAC,CAAC,CAAC,IAAI,cAAc,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,IAAI,gBAAgB,EAAE,CAAC;QAE5H,IAAI,CAAC,MAAM,CAAC,eAAe;YACzB,OAAO;QAET,IAAI,CAAC,eAAe,GAAG,MAAM,CAAC,eAAe,CAAC;QAC9C,IAAI,CAAC,cAAc,CAAC,WAAW,CAAC,IAAI,CAAC,eAAe,EAAE,IAAI,CAAC,cAAc,CAAC,CAAC;QAC3E,IAAI,CAAC,eAAe,CAAC,aAAa,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;QAC3D,IAAI,IAAI,CAAC,aAAa;YACpB,IAAI,CAAC,eAAe,CAAC,aAAa,CAAC,IAAI,CAAC,aAAa,EAAE,IAAI,CAAC,aAAa,CAAC,CAAC;IAE/E,CAAC;IAED,IAAY,gBAAgB;QAC1B,OAAO,IAAI,CAAC,QAAqC,CAAC;IACpD,CAAC;IAEe,mBAAmB,CAAC,SAA6B,EAAE,MAA0B;QAC3F,2FAA2F;QAC3F,OAAO,iBAAiB,CAAC,2BAA2B,CAAC,IAAI,EAAE,SAAS,EAAE,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;IACnG,CAAC;IAEM,WAAW,CAAC,QAA0B,EAAE,IAAkB,EAAE,0BAAmD;QACpH,MAAM,GAAG,GAAG,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;QACzC,IAAI,cAAc,CAAC,cAAc,KAAK,GAAG;YACvC,OAAO;QAET,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YACtB,0EAA0E;YAC1E,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAC5B,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QACtB,CAAC;QAED,0BAA0B,GAAG,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,0BAA0B,CAAC;QAClF,IAAI,cAAc,CAAC,SAAS,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC;YAC7E,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;YACpB,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;YACrB,MAAM,kBAAkB,GAAG,IAAI,CAAC,YAAY,EAAE,CAAC;YAC/C,IAAI,kBAAkB,CAAC,OAAO,KAAK,kBAAkB;gBACnD,IAAI,CAAC,mBAAmB,EAAE,CAAC;YAE7B,MAAM,QAAQ,GAAG,IAAI,CAAC,gBAAgB,CAAC;YACvC,IAAI,QAAQ,EAAE,CAAC;gBACb,KAAK,MAAM,KAAK,IAAI,QAAQ;oBAC1B,KAAK,CAAC,WAAW,CAAC,QAAQ,EAAE,IAAI,EAAE,0BAA0B,CAAC,CAAC;gBAEhE,OAAO;YACT,CAAC;QACH,CAAC;QAED,2EAA2E;QAC3E,IAAI,CAAC,cAAc,CAAC,OAAO,KAAK,GAAG,IAAI,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO;YACxE,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;QAE3B,IAAI,0BAA0B;YAC5B,QAAQ,CAAC,GAAG,CAAC,0BAA0B,CAAC,CAAC;IAC7C,CAAC;IAEkB,aAAa,CAAC,OAA+C,EAAE,MAA8B;QAC9G,IAAI,QAAmC,CAAC;QACxC,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;YACxB,IAAI,CAAC;gBACH,KAAK,MAAM,UAAU,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;oBAC7C,MAAM,MAAM,GAAG,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,cAAc,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;oBACxE,MAAM,KAAK,GAAG,IAAI,WAAW,CAAC,MAAM,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;oBACxD,QAAQ,GAAG,QAAQ,IAAI,EAAE,CAAC;oBAC1B,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;gBACvB,CAAC;YACH,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,MAAM,CAAC,YAAY,CAAC,cAAc,EAAE,GAAG,CAAC,CAAC;gBACzC,QAAQ,GAAG,SAAS,CAAC;gBACrB,IAAI,GAAG,YAAY,KAAK;oBACtB,MAAM,CAAC,GAAG,CAAC,CAAC;YAChB,CAAC;QACH,CAAC;QAED,OAAO,CAAC,QAAQ,CAAC,CAAC;IACpB,CAAC;IAED,IAAoB,OAAO;QACzB,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,GAAG,IAAI,kBAAkB,CAAC,wBAAwB,EAAE,EAAE,CAAC,CAAC;YAC/D,SAAS,CAAC,SAAS,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAC5C,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;IAEe,KAAK,CAAC,cAAc,CAAC,WAA0B;QAC7D,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACrE,GAAG,CAAC,MAAM,GAAG,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC;QACpD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,QAAQ,EAAE,EAAE,KAAK,EAAE,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAC;QAC9F,OAAO,QAAQ,CAAC;IAClB,CAAC;IAEe,KAAK,CAAC,WAAW,CAAC,IAA8B,EAAE,MAAoB,EAAE,UAA0B;QAChH,MAAM,CAAC,IAAI,YAAY,UAAU,CAAC,CAAC;QACnC,IAAI,CAAC,CAAC,IAAI,YAAY,UAAU,CAAC;YAC/B,OAAO,EAAG,CAAC;QAEb,IAAI,CAAC;YACH,MAAM,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC,WAAW,CAAC;YAEjD,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,MAAM,CAAC;gBACpD,MAAM,EAAE,UAAU,CAAC,cAAc,CAAC,IAAI,CAAC;gBACvC,OAAO,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,SAAS,EAAE;gBACnC,MAAM;gBACN,UAAU;gBACV,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,qGAAqG;gBACrG,WAAW,EAAE,WAAW,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS;aAC7E,CAAC,CAAC;YAEH,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;gBACzB,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;oBACpB,MAAM,MAAM,GAAG,IAAI,aAAa,CAAC,IAAI,CAAC,CAAC;oBACvC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;oBAC5B,OAAO,CAAC,OAAO,GAAG,MAAM,CAAC,YAAY,CAAC,MAAM,EAAE,IAAI,CAAC,eAAe,CAAC,CAAC;gBACtE,CAAC;gBAED,IAAI,OAAO,CAAC,YAAY;oBACtB,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,eAAe,CAAC,aAAa,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;YACpF,CAAC;YAED,OAAO,OAAO,CAAC;QACjB,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;QAC1B,CAAC;IACH,CAAC;IAEkB,eAAe,CAAC,OAAuB,EAAE,IAAuB;QACjF,IAAI,iBAAiB,CAAC,YAAY,KAAK,IAAI,EAAE,CAAC;YAC5C,KAAK,CAAC,eAAe,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;YACrC,OAAO;QACT,CAAC;QAED,OAAO,CAAC,YAAY,CAAC,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;QACxD,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAEhC,IAAI,CAAC,YAAY,EAAE,CAAC;QACpB,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;QAC/B,IAAI,CAAC,QAAQ;YACX,OAAO;QAET,OAAO,CAAC,YAAY,CAAC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;QAC7E,KAAK,MAAM,KAAK,IAAI,QAAQ,EAAE,CAAC;YAC7B,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC;YAC1B,OAAO,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;YAC3B,OAAO,CAAC,WAAW,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QACnC,CAAC;IACH,CAAC;IAEM,KAAK,CAAC,SAAsB;QACjC,MAAM,QAAQ,GAAG,IAAI,CAAC,gBAAgB,CAAC;QACvC,IAAI,CAAC,QAAQ;YACX,OAAO;QAET,IAAI,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC,SAAS,CAAC,EAAE,CAAC;YAC1C,IAAI,CAAC,eAAe,EAAE,CAAC;QACzB,CAAC;aAAM,CAAC;YACN,KAAK,MAAM,KAAK,IAAI,QAAQ;gBAC1B,KAAK,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QAC3B,CAAC;IACH,CAAC;CACF","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\r\nimport { assert, BeTimePoint, ByteStream, Logger } from \"@itwin/core-bentley\";\r\nimport { Transform } from \"@itwin/core-geometry\";\r\nimport { ColorDef, Tileset3dSchema } from \"@itwin/core-common\";\r\nimport {\r\n  GraphicBranch, GraphicBuilder,  IModelApp, RealityTileLoader, RenderSystem, Tile, TileBoundingBoxes, TileContent,\r\n  TileDrawArgs, TileParams, TileRequest, TileRequestChannel, TileTreeLoadStatus, TileUser, TileVisibility, Viewport,\r\n} from \"@itwin/core-frontend\";\r\nimport { loggerCategory } from \"./LoggerCategory\";\r\nimport { BatchedTileTree } from \"./BatchedTileTree\";\r\nimport { frontendTilesOptions } from \"./FrontendTiles\";\r\nimport { IndexedDBCache, LocalCache, PassThroughCache } from \"./IndexedDBCache\";\r\n\r\n/** @internal */\r\nexport interface BatchedTileParams extends TileParams {\r\n  childrenProps: Tileset3dSchema.Tile[] | undefined;\r\n  /** See BatchedTile.transformToRoot. */\r\n  transformToRoot: Transform | undefined;\r\n}\r\n\r\nlet channel: TileRequestChannel | undefined;\r\n\r\n/** @internal */\r\nexport class BatchedTile extends Tile {\r\n  private readonly _childrenProps?: Tileset3dSchema.Tile[];\r\n  private readonly _unskippable: boolean;\r\n  /** Transform from the tile's local coordinate system to that of the tileset. */\r\n  public readonly transformToRoot?: Transform;\r\n  private readonly _localCache: LocalCache;\r\n\r\n  public get batchedTree(): BatchedTileTree {\r\n    return this.tree as BatchedTileTree;\r\n  }\r\n\r\n  public constructor(params: BatchedTileParams, tree: BatchedTileTree) {\r\n    super(params, tree);\r\n\r\n    // The root tile never has content, so it doesn't count toward max levels to skip.\r\n    this._unskippable = 0 === (this.depth % frontendTilesOptions.maxLevelsToSkip);\r\n\r\n    if (params.childrenProps?.length)\r\n      this._childrenProps = params.childrenProps;\r\n\r\n    if (!this.contentId) {\r\n      this.setIsReady();\r\n      // mark \"undisplayable\"\r\n      this._maximumSize = 0;\r\n    }\r\n\r\n    this._localCache = frontendTilesOptions.useIndexedDBCache ? new IndexedDBCache(\"BatchedTileCache\") : new PassThroughCache();\r\n\r\n    if (!params.transformToRoot)\r\n      return;\r\n\r\n    this.transformToRoot = params.transformToRoot;\r\n    this.boundingSphere.transformBy(this.transformToRoot, this.boundingSphere);\r\n    this.transformToRoot.multiplyRange(this.range, this.range);\r\n    if (this._contentRange)\r\n      this.transformToRoot.multiplyRange(this._contentRange, this._contentRange);\r\n\r\n  }\r\n\r\n  private get _batchedChildren(): BatchedTile[] | undefined {\r\n    return this.children as BatchedTile[] | undefined;\r\n  }\r\n\r\n  public override computeLoadPriority(viewports: Iterable<Viewport>, _users: Iterable<TileUser>): number {\r\n    // Prioritize tiles closer to camera and center of attention (zoom point or screen center).\r\n    return RealityTileLoader.computeTileLocationPriority(this, viewports, this.tree.iModelTransform);\r\n  }\r\n\r\n  public selectTiles(selected: Set<BatchedTile>, args: TileDrawArgs, closestDisplayableAncestor: BatchedTile | undefined): void {\r\n    const vis = this.computeVisibility(args);\r\n    if (TileVisibility.OutsideFrustum === vis)\r\n      return;\r\n\r\n    if (this._unskippable) {\r\n      // Prevent this tile's content from being unloaded due to memory pressure.\r\n      args.touchedTiles.add(this);\r\n      args.markUsed(this);\r\n    }\r\n\r\n    closestDisplayableAncestor = this.hasGraphics ? this : closestDisplayableAncestor;\r\n    if (TileVisibility.TooCoarse === vis && (this.isReady || !this._unskippable)) {\r\n      args.markUsed(this);\r\n      args.markReady(this);\r\n      const childrenLoadStatus = this.loadChildren();\r\n      if (TileTreeLoadStatus.Loading === childrenLoadStatus)\r\n        args.markChildrenLoading();\r\n\r\n      const children = this._batchedChildren;\r\n      if (children) {\r\n        for (const child of children)\r\n          child.selectTiles(selected, args, closestDisplayableAncestor);\r\n\r\n        return;\r\n      }\r\n    }\r\n\r\n    // We want to display this tile. Request its content if not already loaded.\r\n    if ((TileVisibility.Visible === vis || this._unskippable) && !this.isReady)\r\n      args.insertMissing(this);\r\n\r\n    if (closestDisplayableAncestor)\r\n      selected.add(closestDisplayableAncestor);\r\n  }\r\n\r\n  protected override _loadChildren(resolve: (children: Tile[] | undefined) => void, reject: (error: Error) => void): void {\r\n    let children: BatchedTile[] | undefined;\r\n    if (this._childrenProps) {\r\n      try {\r\n        for (const childProps of this._childrenProps) {\r\n          const params = this.batchedTree.reader.readTileParams(childProps, this);\r\n          const child = new BatchedTile(params, this.batchedTree);\r\n          children = children ?? [];\r\n          children.push(child);\r\n        }\r\n      } catch (err) {\r\n        Logger.logException(loggerCategory, err);\r\n        children = undefined;\r\n        if (err instanceof Error)\r\n          reject(err);\r\n      }\r\n    }\r\n\r\n    resolve(children);\r\n  }\r\n\r\n  public override get channel(): TileRequestChannel {\r\n    if (!channel) {\r\n      channel = new TileRequestChannel(\"itwinjs-batched-models\", 20);\r\n      IModelApp.tileAdmin.channels.add(channel);\r\n    }\r\n\r\n    return channel;\r\n  }\r\n\r\n  public override async requestContent(_isCanceled: () => boolean): Promise<TileRequest.Response> {\r\n    const url = new URL(this.contentId, this.batchedTree.reader.baseUrl);\r\n    url.search = this.batchedTree.reader.baseUrl.search;\r\n    const response = await this._localCache.fetch(url.pathname.toString(), fetch, url.toString());\r\n    return response;\r\n  }\r\n\r\n  public override async readContent(data: TileRequest.ResponseData, system: RenderSystem, isCanceled?: () => boolean): Promise<TileContent> {\r\n    assert(data instanceof Uint8Array);\r\n    if (!(data instanceof Uint8Array))\r\n      return { };\r\n\r\n    try {\r\n      const modelGroups = this.batchedTree.modelGroups;\r\n\r\n      const content = await this.batchedTree.decoder.decode({\r\n        stream: ByteStream.fromUint8Array(data),\r\n        options: { tileId: this.contentId },\r\n        system,\r\n        isCanceled,\r\n        isLeaf: this.isLeaf,\r\n        // Don't waste time attempting to split based on model groupings if all models are in the same group.\r\n        modelGroups: modelGroups && modelGroups.length > 1 ? modelGroups : undefined,\r\n      });\r\n\r\n      if (this.transformToRoot) {\r\n        if (content.graphic) {\r\n          const branch = new GraphicBranch(true);\r\n          branch.add(content.graphic);\r\n          content.graphic = system.createBranch(branch, this.transformToRoot);\r\n        }\r\n\r\n        if (content.contentRange)\r\n          content.contentRange = this.transformToRoot.multiplyRange(content.contentRange);\r\n      }\r\n\r\n      return content;\r\n    } catch {\r\n      return { isLeaf: true };\r\n    }\r\n  }\r\n\r\n  protected override addRangeGraphic(builder: GraphicBuilder, type: TileBoundingBoxes): void {\r\n    if (TileBoundingBoxes.ChildVolumes !== type) {\r\n      super.addRangeGraphic(builder, type);\r\n      return;\r\n    }\r\n\r\n    builder.setSymbology(ColorDef.green, ColorDef.green, 2);\r\n    builder.addRangeBox(this.range);\r\n\r\n    this.loadChildren();\r\n    const children = this.children;\r\n    if (!children)\r\n      return;\r\n\r\n    builder.setSymbology(ColorDef.blue, ColorDef.blue.withTransparency(0xdf), 1);\r\n    for (const child of children) {\r\n      const range = child.range;\r\n      builder.addRangeBox(range);\r\n      builder.addRangeBox(range, true);\r\n    }\r\n  }\r\n\r\n  public prune(olderThan: BeTimePoint): void {\r\n    const children = this._batchedChildren;\r\n    if (!children)\r\n      return;\r\n\r\n    if (this.usageMarker.isExpired(olderThan)) {\r\n      this.disposeChildren();\r\n    } else {\r\n      for (const child of children)\r\n        child.prune(olderThan);\r\n    }\r\n  }\r\n}\r\n"]}

package/lib/esm/FrontendTiles.d.ts

@@ -115,6 +115,11 @@ export interface FrontendTilesOptions {
      * @beta
      */
     enableCDN?: boolean;
+    /** Specifies whether to enable an IndexedDB database for use as a local cache.
+    * Requested tiles will then first be search for in the database, and if not found, fetched as normal.
+    * @internal
+    */
+    useIndexedDBCache?: boolean;
 }
 /** Global configuration initialized by [[initializeFrontendTiles]].
  * @internal
@@ -122,6 +127,7 @@ export interface FrontendTilesOptions {
 export declare const frontendTilesOptions: {
     maxLevelsToSkip: number;
     enableEdges: boolean;
+    useIndexedDBCache: boolean;
 };
 /** Initialize the frontend-tiles package to obtain tiles for spatial views.
  * @beta

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

@@ -1 +1 @@
-{"version":3,"file":"FrontendTiles.d.ts","sourceRoot":"","sources":["../../src/FrontendTiles.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,WAAW,EAAU,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAAa,gBAAgB,EAA+C,MAAM,sBAAsB,CAAC;AAIhH;;;;;GAKG;AACH,MAAM,MAAM,4BAA4B,GAAG,CAAC,MAAM,EAAE,gBAAgB,KAAK,OAAO,CAAC,GAAG,GAAG,SAAS,CAAC,CAAC;AAgBlG;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE;QACP,QAAQ,EAAE,MAAM,CAAC;QACjB,WAAW,EAAE,MAAM,CAAC;QACpB,UAAU,EAAE,MAAM,CAAC;QACnB,eAAe,EAAE,GAAG,CAAC;QACrB,oBAAoB,EAAE,GAAG,CAAC;KAC3B,CAAC;IAGF,MAAM,EAAE;QACN,IAAI,EAAE;YACJ,IAAI,EAAE,MAAM,CAAC;SACd,CAAC;KACH,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,UAAU,EAAE,CAAC;IAGtB,MAAM,EAAE;QACN,IAAI,CAAC,EAAE;YACL,IAAI,EAAE,MAAM,CAAC;SACd,CAAC;KACH,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,wDAAwD;IACxD,WAAW,EAAE,WAAW,CAAC;IACzB,uDAAuD;IACvD,QAAQ,EAAE,MAAM,CAAC;IACjB,yFAAyF;IACzF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,4CAA4C;IAC5C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,qIAAqI;IACrI,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,gFAAgF;IAChF,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;;;GAIG;AACH,wBAAuB,gBAAgB,CAAC,IAAI,EAAE,oBAAoB,GAAG,qBAAqB,CAAC,UAAU,CAAC,CA8BrG;AAED;;GAEG;AACH,MAAM,WAAW,8BAA8B;IAC7C,oDAAoD;IACpD,MAAM,EAAE,gBAAgB,CAAC;IACzB,wDAAwD;IACxD,WAAW,EAAE,WAAW,CAAC;IACzB,4CAA4C;IAC5C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,gFAAgF;IAChF,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;;;;GAKG;AACH,wBAAsB,0BAA0B,CAAC,IAAI,EAAE,8BAA8B,GAAG,OAAO,CAAC,GAAG,GAAG,SAAS,CAAC,CAqC/G;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC;;OAEG;IACH,4BAA4B,CAAC,EAAE,4BAA4B,CAAC;IAC5D;;;;;;;OAOG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;;;;OAKG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;GAEG;AACH,eAAO,MAAM,oBAAoB;;;CAGhC,CAAC;AAEF;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,oBAAoB,GAAG,IAAI,CAY3E"}
+{"version":3,"file":"FrontendTiles.d.ts","sourceRoot":"","sources":["../../src/FrontendTiles.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,WAAW,EAAU,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAAa,gBAAgB,EAA+C,MAAM,sBAAsB,CAAC;AAIhH;;;;;GAKG;AACH,MAAM,MAAM,4BAA4B,GAAG,CAAC,MAAM,EAAE,gBAAgB,KAAK,OAAO,CAAC,GAAG,GAAG,SAAS,CAAC,CAAC;AAgBlG;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE;QACP,QAAQ,EAAE,MAAM,CAAC;QACjB,WAAW,EAAE,MAAM,CAAC;QACpB,UAAU,EAAE,MAAM,CAAC;QACnB,eAAe,EAAE,GAAG,CAAC;QACrB,oBAAoB,EAAE,GAAG,CAAC;KAC3B,CAAC;IAGF,MAAM,EAAE;QACN,IAAI,EAAE;YACJ,IAAI,EAAE,MAAM,CAAC;SACd,CAAC;KACH,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,UAAU,EAAE,CAAC;IAGtB,MAAM,EAAE;QACN,IAAI,CAAC,EAAE;YACL,IAAI,EAAE,MAAM,CAAC;SACd,CAAC;KACH,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,wDAAwD;IACxD,WAAW,EAAE,WAAW,CAAC;IACzB,uDAAuD;IACvD,QAAQ,EAAE,MAAM,CAAC;IACjB,yFAAyF;IACzF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,4CAA4C;IAC5C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,qIAAqI;IACrI,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,gFAAgF;IAChF,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;;;GAIG;AACH,wBAAuB,gBAAgB,CAAC,IAAI,EAAE,oBAAoB,GAAG,qBAAqB,CAAC,UAAU,CAAC,CA8BrG;AAED;;GAEG;AACH,MAAM,WAAW,8BAA8B;IAC7C,oDAAoD;IACpD,MAAM,EAAE,gBAAgB,CAAC;IACzB,wDAAwD;IACxD,WAAW,EAAE,WAAW,CAAC;IACzB,4CAA4C;IAC5C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,gFAAgF;IAChF,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;;;;GAKG;AACH,wBAAsB,0BAA0B,CAAC,IAAI,EAAE,8BAA8B,GAAG,OAAO,CAAC,GAAG,GAAG,SAAS,CAAC,CAqC/G;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC;;OAEG;IACH,4BAA4B,CAAC,EAAE,4BAA4B,CAAC;IAC5D;;;;;;;OAOG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;;;;OAKG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;;MAGE;IACF,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED;;GAEG;AACH,eAAO,MAAM,oBAAoB;;;;CAIhC,CAAC;AAEF;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,oBAAoB,GAAG,IAAI,CAe3E"}

package/lib/esm/FrontendTiles.js

@@ -95,6 +95,7 @@ export async function obtainMeshExportTilesetUrl(args) {
 export const frontendTilesOptions = {
     maxLevelsToSkip: 4,
     enableEdges: false,
+    useIndexedDBCache: false,
 };
 /** Initialize the frontend-tiles package to obtain tiles for spatial views.
  * @beta
@@ -104,6 +105,8 @@ export function initializeFrontendTiles(options) {
         frontendTilesOptions.maxLevelsToSkip = options.maxLevelsToSkip;
     if (options.enableEdges)
         frontendTilesOptions.enableEdges = true;
+    if (options.useIndexedDBCache)
+        frontendTilesOptions.useIndexedDBCache = true;
     const computeUrl = options.computeSpatialTilesetBaseUrl ?? (async (iModel) => obtainMeshExportTilesetUrl({ iModel, accessToken: await IModelApp.getAccessToken(), enableCDN: options.enableCDN }));
     SpatialTileTreeReferences.create = (view) => createBatchedSpatialTileTreeReferences(view, computeUrl);
 }

package/lib/esm/FrontendTiles.js.map

@@ -1 +1 @@
-{"version":3,"file":"FrontendTiles.js","sourceRoot":"","sources":["../../src/FrontendTiles.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\r\nimport { AccessToken, Logger } from \"@itwin/core-bentley\";\r\nimport { IModelApp, IModelConnection, SpatialTileTreeReferences, SpatialViewState } from \"@itwin/core-frontend\";\r\nimport { loggerCategory } from \"./LoggerCategory\";\r\nimport { createBatchedSpatialTileTreeReferences } from \"./BatchedSpatialTileTreeRefs\";\r\n\r\n/** A function that can provide the base URL where a tileset representing all of the spatial models in a given iModel are stored.\r\n * The tileset is expected to reside at \"baseUrl/tileset.json\" and to have been produced by the [mesh export service](https://developer.bentley.com/apis/mesh-export/).\r\n * If no such tileset exists for the given iModel, return `undefined`.\r\n * @see [[FrontendTilesOptions.computeSpatialTilesetBaseUrl]].\r\n * @beta\r\n */\r\nexport type ComputeSpatialTilesetBaseUrl = (iModel: IModelConnection) => Promise<URL | undefined>;\r\n\r\nfunction createMeshExportServiceQueryUrl(args: { iModelId: string, urlPrefix?: string, changesetId?: string, enableCDN?: boolean }): string {\r\n  const prefix = args.urlPrefix ?? \"\";\r\n  let url = `https://${prefix}api.bentley.com/mesh-export/?iModelId=${args.iModelId}&$orderBy=date:desc`;\r\n  if (args.changesetId)\r\n    url = `${url}&changesetId=${args.changesetId}`;\r\n\r\n  if (args.enableCDN)\r\n    url = `${url}&cdn=1`;\r\n\r\n  url = `${url}&tileVersion=1&exportType=IMODEL`;\r\n\r\n  return url;\r\n}\r\n\r\n/** Represents the result of a [mesh export](https://developer.bentley.com/apis/mesh-export/operations/get-export/#export).\r\n * @see [[queryCompletedMeshExports]].\r\n * @beta\r\n */\r\nexport interface MeshExport {\r\n  id: string;\r\n  displayName: string;\r\n  status: string;\r\n  request: {\r\n    iModelId: string;\r\n    changesetId: string;\r\n    exportType: string;\r\n    geometryOptions: any;\r\n    viewDefinitionFilter: any;\r\n  };\r\n\r\n  /* eslint-disable-next-line @typescript-eslint/naming-convention */\r\n  _links: {\r\n    mesh: {\r\n      href: string;\r\n    };\r\n  };\r\n}\r\n\r\n/** Exposed strictly for tests.\r\n * @internal\r\n */\r\nexport interface MeshExports {\r\n  exports: MeshExport[];\r\n\r\n  /* eslint-disable-next-line @typescript-eslint/naming-convention */\r\n  _links: {\r\n    next?: {\r\n      href: string;\r\n    };\r\n  };\r\n}\r\n\r\n/** Arguments supplied to [[queryMeshExports]].\r\n * @beta\r\n */\r\nexport interface QueryMeshExportsArgs {\r\n  /** The token used to access the mesh export service. */\r\n  accessToken: AccessToken;\r\n  /** The Id of the iModel for which to query exports. */\r\n  iModelId: string;\r\n  /** If defined, constrains the query to exports produced from the specified changeset. */\r\n  changesetId?: string;\r\n  /** Chiefly used in testing environments. */\r\n  urlPrefix?: string;\r\n  /** If true, exports whose status is not \"Complete\" (indicating the export successfully finished) will be included in the results. */\r\n  includeIncomplete?: boolean;\r\n  /** If true, enables a CDN (content delivery network) to access tiles faster. */\r\n  enableCDN?: boolean;\r\n}\r\n\r\n/** Query the [mesh export service](https://developer.bentley.com/apis/mesh-export/operations/get-exports/) for exports of type \"IMODEL\" matching\r\n * the specified criteria.\r\n * The exports are sorted from most-recently- to least-recently-produced.\r\n * @beta\r\n */\r\nexport async function* queryMeshExports(args: QueryMeshExportsArgs): AsyncIterableIterator<MeshExport> {\r\n  const headers = {\r\n    /* eslint-disable-next-line @typescript-eslint/naming-convention */\r\n    Authorization: args.accessToken ?? await IModelApp.getAccessToken(),\r\n    /* eslint-disable-next-line @typescript-eslint/naming-convention */\r\n    Accept: \"application/vnd.bentley.itwin-platform.v1+json\",\r\n    /* eslint-disable-next-line @typescript-eslint/naming-convention */\r\n    Prefer: \"return=representation\",\r\n    /* eslint-disable-next-line @typescript-eslint/naming-convention */\r\n    SessionId: IModelApp.sessionId,\r\n  };\r\n\r\n  let url: string | undefined = createMeshExportServiceQueryUrl(args);\r\n  while (url) {\r\n    let result;\r\n    try {\r\n      const response = await fetch(url, { headers });\r\n      result = await response.json() as MeshExports;\r\n    } catch (err) {\r\n      Logger.logException(loggerCategory, err);\r\n      Logger.logError(loggerCategory, `Failed loading exports for iModel ${args.iModelId}`);\r\n      break;\r\n    }\r\n\r\n    const foundExports = result.exports.filter((x) => x.request.exportType === \"IMODEL\" && (args.includeIncomplete || x.status === \"Complete\"));\r\n    for (const foundExport of foundExports)\r\n      yield foundExport;\r\n\r\n    url = result._links.next?.href;\r\n  }\r\n}\r\n\r\n/** Arguments supplied  to [[obtainMeshExportTilesetUrl]].\r\n * @beta\r\n */\r\nexport interface ObtainMeshExportTilesetUrlArgs {\r\n  /** The iModel for which to obtain a tileset URl. */\r\n  iModel: IModelConnection;\r\n  /** The token used to access the mesh export service. */\r\n  accessToken: AccessToken;\r\n  /** Chiefly used in testing environments. */\r\n  urlPrefix?: string;\r\n  /** If true, only exports produced for `iModel`'s specific changeset will be considered; otherwise, if no exports are found for the changeset,\r\n   * the most recent export for any changeset will be used.\r\n   */\r\n  requireExactChangeset?: boolean;\r\n  /** If true, enables a CDN (content delivery network) to access tiles faster. */\r\n  enableCDN?: boolean;\r\n}\r\n\r\n/** Obtains a URL pointing to a tileset appropriate for visualizing a specific iModel.\r\n * [[queryCompletedMeshExports]] is used to obtain a list of available exports. By default, the list is sorted from most to least recently-exported.\r\n * The first export matching the iModel's changeset is selected; or, if no such export exists, the first export in the list is selected.\r\n * @returns A URL from which the tileset can be loaded, or `undefined` if no appropriate URL could be obtained.\r\n * @beta\r\n */\r\nexport async function obtainMeshExportTilesetUrl(args: ObtainMeshExportTilesetUrlArgs): Promise<URL | undefined> {\r\n  if (!args.iModel.iModelId) {\r\n    Logger.logInfo(loggerCategory, \"Cannot obtain exports for an iModel with no iModelId\");\r\n    return undefined;\r\n  }\r\n\r\n  const queryArgs: QueryMeshExportsArgs = {\r\n    accessToken: args.accessToken,\r\n    iModelId: args.iModel.iModelId,\r\n    changesetId: args.iModel.changeset.id,\r\n    urlPrefix: args.urlPrefix,\r\n    enableCDN: args.enableCDN,\r\n  };\r\n\r\n  let selectedExport;\r\n  for await (const exp of queryMeshExports(queryArgs)) {\r\n    selectedExport = exp;\r\n    break;\r\n  }\r\n\r\n  if (!selectedExport && !args.requireExactChangeset) {\r\n    queryArgs.changesetId = undefined;\r\n    for await (const exp of queryMeshExports(queryArgs)) {\r\n      selectedExport = exp;\r\n      Logger.logInfo(loggerCategory, `No exports for iModel ${args.iModel.iModelId} for changeset ${args.iModel.changeset.id}; falling back to most recent`);\r\n      break;\r\n    }\r\n  }\r\n\r\n  if (!selectedExport) {\r\n    Logger.logInfo(loggerCategory, `No exports available for iModel ${args.iModel.iModelId}`);\r\n    return undefined;\r\n  }\r\n\r\n  const url = new URL(selectedExport._links.mesh.href);\r\n  url.pathname = `${url.pathname}/tileset.json`;\r\n  return url;\r\n}\r\n\r\n/** Options supplied to [[initializeFrontendTiles]].\r\n * @beta\r\n */\r\nexport interface FrontendTilesOptions {\r\n  /** Provide the base URL for the pre-published tileset for a given iModel.\r\n   * If omitted, [[obtainMeshExportTilesetUrl]] will be invoked with default arguments, using the access token provided by [[IModelApp]].\r\n   */\r\n  computeSpatialTilesetBaseUrl?: ComputeSpatialTilesetBaseUrl;\r\n  /** The maximum number of levels in the tile tree to skip loading if they do not provide the desired level of detail for the current view.\r\n   * Default: 4.\r\n   * Reducing this value will load more intermediate tiles, which causes more gradual refinement: low-resolution tiles will display quickly, followed more gradually by\r\n   * successively higher-resolution ones.\r\n   * Increasing the value jumps more directly to tiles of the exact level of detail desired, which may load more, smaller tiles up-front, leaving some areas of the view\r\n   * vacant for longer; and when zooming out some newly-exposed areas of the view may remain vacant for longer because no lower-resolution tiles are initially available to\r\n   * fill them. However, tiles close to the viewer (and therefore likely of most interest to them) will refine to an appropriate level of detail more quickly.\r\n   */\r\n  maxLevelsToSkip?: number;\r\n  /** Specifies whether to permit the user to enable visible edges or wireframe mode for batched tiles.\r\n   * The currently-deployed mesh export service does not produce edges, so this currently defaults to `false` to avoid user confusion.\r\n   * Set it to `true` if you are loading tiles created with a version of the exporter that does produce edges.\r\n   * ###TODO delete this option once we deploy an edge-producing version of the exporter to production.\r\n   * @internal\r\n   */\r\n  enableEdges?: boolean;\r\n  /** Specifies whether to enable a CDN (content delivery network) to access tiles faster.\r\n   * This option is only used if computeSpatialTilesetBaseUrl is not defined.\r\n   * @beta\r\n   */\r\n  enableCDN?: boolean;\r\n}\r\n\r\n/** Global configuration initialized by [[initializeFrontendTiles]].\r\n * @internal\r\n */\r\nexport const frontendTilesOptions = {\r\n  maxLevelsToSkip: 4,\r\n  enableEdges: false,\r\n};\r\n\r\n/** Initialize the frontend-tiles package to obtain tiles for spatial views.\r\n * @beta\r\n */\r\nexport function initializeFrontendTiles(options: FrontendTilesOptions): void {\r\n  if (undefined !== options.maxLevelsToSkip && options.maxLevelsToSkip >= 0)\r\n    frontendTilesOptions.maxLevelsToSkip = options.maxLevelsToSkip;\r\n\r\n  if (options.enableEdges)\r\n    frontendTilesOptions.enableEdges = true;\r\n\r\n  const computeUrl = options.computeSpatialTilesetBaseUrl ?? (\r\n    async (iModel: IModelConnection) => obtainMeshExportTilesetUrl({ iModel, accessToken: await IModelApp.getAccessToken(), enableCDN: options.enableCDN })\r\n  );\r\n\r\n  SpatialTileTreeReferences.create = (view: SpatialViewState) => createBatchedSpatialTileTreeReferences(view, computeUrl);\r\n}\r\n"]}
+{"version":3,"file":"FrontendTiles.js","sourceRoot":"","sources":["../../src/FrontendTiles.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\r\nimport { AccessToken, Logger } from \"@itwin/core-bentley\";\r\nimport { IModelApp, IModelConnection, SpatialTileTreeReferences, SpatialViewState } from \"@itwin/core-frontend\";\r\nimport { loggerCategory } from \"./LoggerCategory\";\r\nimport { createBatchedSpatialTileTreeReferences } from \"./BatchedSpatialTileTreeRefs\";\r\n\r\n/** A function that can provide the base URL where a tileset representing all of the spatial models in a given iModel are stored.\r\n * The tileset is expected to reside at \"baseUrl/tileset.json\" and to have been produced by the [mesh export service](https://developer.bentley.com/apis/mesh-export/).\r\n * If no such tileset exists for the given iModel, return `undefined`.\r\n * @see [[FrontendTilesOptions.computeSpatialTilesetBaseUrl]].\r\n * @beta\r\n */\r\nexport type ComputeSpatialTilesetBaseUrl = (iModel: IModelConnection) => Promise<URL | undefined>;\r\n\r\nfunction createMeshExportServiceQueryUrl(args: { iModelId: string, urlPrefix?: string, changesetId?: string, enableCDN?: boolean }): string {\r\n  const prefix = args.urlPrefix ?? \"\";\r\n  let url = `https://${prefix}api.bentley.com/mesh-export/?iModelId=${args.iModelId}&$orderBy=date:desc`;\r\n  if (args.changesetId)\r\n    url = `${url}&changesetId=${args.changesetId}`;\r\n\r\n  if (args.enableCDN)\r\n    url = `${url}&cdn=1`;\r\n\r\n  url = `${url}&tileVersion=1&exportType=IMODEL`;\r\n\r\n  return url;\r\n}\r\n\r\n/** Represents the result of a [mesh export](https://developer.bentley.com/apis/mesh-export/operations/get-export/#export).\r\n * @see [[queryCompletedMeshExports]].\r\n * @beta\r\n */\r\nexport interface MeshExport {\r\n  id: string;\r\n  displayName: string;\r\n  status: string;\r\n  request: {\r\n    iModelId: string;\r\n    changesetId: string;\r\n    exportType: string;\r\n    geometryOptions: any;\r\n    viewDefinitionFilter: any;\r\n  };\r\n\r\n  /* eslint-disable-next-line @typescript-eslint/naming-convention */\r\n  _links: {\r\n    mesh: {\r\n      href: string;\r\n    };\r\n  };\r\n}\r\n\r\n/** Exposed strictly for tests.\r\n * @internal\r\n */\r\nexport interface MeshExports {\r\n  exports: MeshExport[];\r\n\r\n  /* eslint-disable-next-line @typescript-eslint/naming-convention */\r\n  _links: {\r\n    next?: {\r\n      href: string;\r\n    };\r\n  };\r\n}\r\n\r\n/** Arguments supplied to [[queryMeshExports]].\r\n * @beta\r\n */\r\nexport interface QueryMeshExportsArgs {\r\n  /** The token used to access the mesh export service. */\r\n  accessToken: AccessToken;\r\n  /** The Id of the iModel for which to query exports. */\r\n  iModelId: string;\r\n  /** If defined, constrains the query to exports produced from the specified changeset. */\r\n  changesetId?: string;\r\n  /** Chiefly used in testing environments. */\r\n  urlPrefix?: string;\r\n  /** If true, exports whose status is not \"Complete\" (indicating the export successfully finished) will be included in the results. */\r\n  includeIncomplete?: boolean;\r\n  /** If true, enables a CDN (content delivery network) to access tiles faster. */\r\n  enableCDN?: boolean;\r\n}\r\n\r\n/** Query the [mesh export service](https://developer.bentley.com/apis/mesh-export/operations/get-exports/) for exports of type \"IMODEL\" matching\r\n * the specified criteria.\r\n * The exports are sorted from most-recently- to least-recently-produced.\r\n * @beta\r\n */\r\nexport async function* queryMeshExports(args: QueryMeshExportsArgs): AsyncIterableIterator<MeshExport> {\r\n  const headers = {\r\n    /* eslint-disable-next-line @typescript-eslint/naming-convention */\r\n    Authorization: args.accessToken ?? await IModelApp.getAccessToken(),\r\n    /* eslint-disable-next-line @typescript-eslint/naming-convention */\r\n    Accept: \"application/vnd.bentley.itwin-platform.v1+json\",\r\n    /* eslint-disable-next-line @typescript-eslint/naming-convention */\r\n    Prefer: \"return=representation\",\r\n    /* eslint-disable-next-line @typescript-eslint/naming-convention */\r\n    SessionId: IModelApp.sessionId,\r\n  };\r\n\r\n  let url: string | undefined = createMeshExportServiceQueryUrl(args);\r\n  while (url) {\r\n    let result;\r\n    try {\r\n      const response = await fetch(url, { headers });\r\n      result = await response.json() as MeshExports;\r\n    } catch (err) {\r\n      Logger.logException(loggerCategory, err);\r\n      Logger.logError(loggerCategory, `Failed loading exports for iModel ${args.iModelId}`);\r\n      break;\r\n    }\r\n\r\n    const foundExports = result.exports.filter((x) => x.request.exportType === \"IMODEL\" && (args.includeIncomplete || x.status === \"Complete\"));\r\n    for (const foundExport of foundExports)\r\n      yield foundExport;\r\n\r\n    url = result._links.next?.href;\r\n  }\r\n}\r\n\r\n/** Arguments supplied  to [[obtainMeshExportTilesetUrl]].\r\n * @beta\r\n */\r\nexport interface ObtainMeshExportTilesetUrlArgs {\r\n  /** The iModel for which to obtain a tileset URl. */\r\n  iModel: IModelConnection;\r\n  /** The token used to access the mesh export service. */\r\n  accessToken: AccessToken;\r\n  /** Chiefly used in testing environments. */\r\n  urlPrefix?: string;\r\n  /** If true, only exports produced for `iModel`'s specific changeset will be considered; otherwise, if no exports are found for the changeset,\r\n   * the most recent export for any changeset will be used.\r\n   */\r\n  requireExactChangeset?: boolean;\r\n  /** If true, enables a CDN (content delivery network) to access tiles faster. */\r\n  enableCDN?: boolean;\r\n}\r\n\r\n/** Obtains a URL pointing to a tileset appropriate for visualizing a specific iModel.\r\n * [[queryCompletedMeshExports]] is used to obtain a list of available exports. By default, the list is sorted from most to least recently-exported.\r\n * The first export matching the iModel's changeset is selected; or, if no such export exists, the first export in the list is selected.\r\n * @returns A URL from which the tileset can be loaded, or `undefined` if no appropriate URL could be obtained.\r\n * @beta\r\n */\r\nexport async function obtainMeshExportTilesetUrl(args: ObtainMeshExportTilesetUrlArgs): Promise<URL | undefined> {\r\n  if (!args.iModel.iModelId) {\r\n    Logger.logInfo(loggerCategory, \"Cannot obtain exports for an iModel with no iModelId\");\r\n    return undefined;\r\n  }\r\n\r\n  const queryArgs: QueryMeshExportsArgs = {\r\n    accessToken: args.accessToken,\r\n    iModelId: args.iModel.iModelId,\r\n    changesetId: args.iModel.changeset.id,\r\n    urlPrefix: args.urlPrefix,\r\n    enableCDN: args.enableCDN,\r\n  };\r\n\r\n  let selectedExport;\r\n  for await (const exp of queryMeshExports(queryArgs)) {\r\n    selectedExport = exp;\r\n    break;\r\n  }\r\n\r\n  if (!selectedExport && !args.requireExactChangeset) {\r\n    queryArgs.changesetId = undefined;\r\n    for await (const exp of queryMeshExports(queryArgs)) {\r\n      selectedExport = exp;\r\n      Logger.logInfo(loggerCategory, `No exports for iModel ${args.iModel.iModelId} for changeset ${args.iModel.changeset.id}; falling back to most recent`);\r\n      break;\r\n    }\r\n  }\r\n\r\n  if (!selectedExport) {\r\n    Logger.logInfo(loggerCategory, `No exports available for iModel ${args.iModel.iModelId}`);\r\n    return undefined;\r\n  }\r\n\r\n  const url = new URL(selectedExport._links.mesh.href);\r\n  url.pathname = `${url.pathname}/tileset.json`;\r\n  return url;\r\n}\r\n\r\n/** Options supplied to [[initializeFrontendTiles]].\r\n * @beta\r\n */\r\nexport interface FrontendTilesOptions {\r\n  /** Provide the base URL for the pre-published tileset for a given iModel.\r\n   * If omitted, [[obtainMeshExportTilesetUrl]] will be invoked with default arguments, using the access token provided by [[IModelApp]].\r\n   */\r\n  computeSpatialTilesetBaseUrl?: ComputeSpatialTilesetBaseUrl;\r\n  /** The maximum number of levels in the tile tree to skip loading if they do not provide the desired level of detail for the current view.\r\n   * Default: 4.\r\n   * Reducing this value will load more intermediate tiles, which causes more gradual refinement: low-resolution tiles will display quickly, followed more gradually by\r\n   * successively higher-resolution ones.\r\n   * Increasing the value jumps more directly to tiles of the exact level of detail desired, which may load more, smaller tiles up-front, leaving some areas of the view\r\n   * vacant for longer; and when zooming out some newly-exposed areas of the view may remain vacant for longer because no lower-resolution tiles are initially available to\r\n   * fill them. However, tiles close to the viewer (and therefore likely of most interest to them) will refine to an appropriate level of detail more quickly.\r\n   */\r\n  maxLevelsToSkip?: number;\r\n  /** Specifies whether to permit the user to enable visible edges or wireframe mode for batched tiles.\r\n   * The currently-deployed mesh export service does not produce edges, so this currently defaults to `false` to avoid user confusion.\r\n   * Set it to `true` if you are loading tiles created with a version of the exporter that does produce edges.\r\n   * ###TODO delete this option once we deploy an edge-producing version of the exporter to production.\r\n   * @internal\r\n   */\r\n  enableEdges?: boolean;\r\n  /** Specifies whether to enable a CDN (content delivery network) to access tiles faster.\r\n   * This option is only used if computeSpatialTilesetBaseUrl is not defined.\r\n   * @beta\r\n   */\r\n  enableCDN?: boolean;\r\n  /** Specifies whether to enable an IndexedDB database for use as a local cache.\r\n  * Requested tiles will then first be search for in the database, and if not found, fetched as normal.\r\n  * @internal\r\n  */\r\n  useIndexedDBCache?: boolean;\r\n}\r\n\r\n/** Global configuration initialized by [[initializeFrontendTiles]].\r\n * @internal\r\n */\r\nexport const frontendTilesOptions = {\r\n  maxLevelsToSkip: 4,\r\n  enableEdges: false,\r\n  useIndexedDBCache: false,\r\n};\r\n\r\n/** Initialize the frontend-tiles package to obtain tiles for spatial views.\r\n * @beta\r\n */\r\nexport function initializeFrontendTiles(options: FrontendTilesOptions): void {\r\n  if (undefined !== options.maxLevelsToSkip && options.maxLevelsToSkip >= 0)\r\n    frontendTilesOptions.maxLevelsToSkip = options.maxLevelsToSkip;\r\n\r\n  if (options.enableEdges)\r\n    frontendTilesOptions.enableEdges = true;\r\n\r\n  if (options.useIndexedDBCache)\r\n    frontendTilesOptions.useIndexedDBCache = true;\r\n\r\n  const computeUrl = options.computeSpatialTilesetBaseUrl ?? (\r\n    async (iModel: IModelConnection) => obtainMeshExportTilesetUrl({ iModel, accessToken: await IModelApp.getAccessToken(), enableCDN: options.enableCDN })\r\n  );\r\n\r\n  SpatialTileTreeReferences.create = (view: SpatialViewState) => createBatchedSpatialTileTreeReferences(view, computeUrl);\r\n}\r\n"]}

package/lib/esm/IndexedDBCache.d.ts

@@ -0,0 +1,22 @@
+/** @internal */
+export interface LocalCache {
+    fetch(url: string, callback: (uniqueId: string) => Promise<Response>, callBackUrl?: string): Promise<ArrayBuffer>;
+}
+/** @internal */
+export declare class PassThroughCache implements LocalCache {
+    fetch(uniqueId: string, callback: (url: string) => Promise<Response>, callBackUrl?: string): Promise<ArrayBuffer>;
+}
+/** @internal */
+export declare class IndexedDBCache implements LocalCache {
+    private _db;
+    private _dbName;
+    private _expirationTime?;
+    constructor(dbName: string, expirationTime?: number);
+    protected open(): Promise<unknown>;
+    protected close(): Promise<void>;
+    protected retrieveContent(uniqueId: string): Promise<ArrayBuffer | undefined>;
+    protected deleteContent(uniqueId: string): Promise<unknown>;
+    protected addContent(uniqueId: string, content: ArrayBuffer): Promise<unknown>;
+    fetch(uniqueId: string, callback: (url: string) => Promise<Response>, callBackUrl?: string): Promise<ArrayBuffer>;
+}
+//# sourceMappingURL=IndexedDBCache.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"IndexedDBCache.d.ts","sourceRoot":"","sources":["../../src/IndexedDBCache.ts"],"names":[],"mappings":"AAOA,gBAAgB;AAChB,MAAM,WAAW,UAAU;IACzB,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,QAAQ,CAAC,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;CACnH;AAED,gBAAgB;AAChB,qBAAa,gBAAiB,YAAW,UAAU;IACpC,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,QAAQ,CAAC,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;CAM/H;AAED,gBAAgB;AAChB,qBAAa,cAAe,YAAW,UAAU;IAC/C,OAAO,CAAC,GAAG,CAAM;IACjB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,eAAe,CAAC,CAAS;gBAEd,MAAM,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,MAAM;cAK1C,IAAI;cAqCJ,KAAK;cAIL,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC;cAqCnE,aAAa,CAAC,QAAQ,EAAE,MAAM;cAqB9B,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW;IA+BpD,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,QAAQ,CAAC,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;CAiB/H"}

package/lib/esm/IndexedDBCache.js

@@ -0,0 +1,139 @@
+/*---------------------------------------------------------------------------------------------
+* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+* See LICENSE.md in the project root for license terms and full copyright notice.
+*--------------------------------------------------------------------------------------------*/
+import { Logger } from "@itwin/core-bentley";
+const loggerCategory = "IndexedDBCache";
+/** @internal */
+export class PassThroughCache {
+    async fetch(uniqueId, callback, callBackUrl) {
+        if (callBackUrl) {
+            return (await callback(callBackUrl)).arrayBuffer();
+        }
+        return (await callback(uniqueId)).arrayBuffer();
+    }
+}
+/** @internal */
+export class IndexedDBCache {
+    constructor(dbName, expirationTime) {
+        this._dbName = dbName;
+        this._expirationTime = expirationTime ?? undefined;
+    }
+    async open() {
+        // need to return a promise so that we can wait for the db to open before using it
+        return new Promise(function (resolve) {
+            // open the db
+            const openDB = window.indexedDB.open(this._dbName, 1);
+            openDB.onerror = () => {
+                Logger.logError(loggerCategory, "Error opening IndexedDB");
+            };
+            // this is the success callback for opening the db, it is called after onupgradeneeded
+            openDB.onsuccess = async (event) => {
+                const target = event.target;
+                if (target) {
+                    this._db = target.result;
+                    return resolve(target.result);
+                }
+            };
+            // This will get called when a new version is needed - including going from no database to first version
+            // So this is how we set up the specifics of the db structure
+            openDB.onupgradeneeded = async (event) => {
+                const target = event.target;
+                if (target)
+                    this._db = target.result;
+                const initialObjectStore = this._db.createObjectStore("cache", { keyPath: "uniqueId" });
+                initialObjectStore.createIndex("content", "content", { unique: false });
+                initialObjectStore.createIndex("timeOfStorage", "timeOfStorage", { unique: false });
+            };
+        }.bind(this));
+    }
+    async close() {
+        await this._db.close();
+    }
+    async retrieveContent(uniqueId) {
+        return new Promise(async (resolve) => {
+            await this.open();
+            const getTransaction = await this._db.transaction("cache", "readonly");
+            const storedResponse = await getTransaction.objectStore("cache").get(uniqueId);
+            // this is successful if the db was successfully searched - not only if a match was found
+            storedResponse.onsuccess = async () => {
+                if (storedResponse.result !== undefined) {
+                    // if the content has an expiration time
+                    if (this._expirationTime) {
+                        // We want to know when the result was stored, and how long it's been since that point
+                        const timeSince = Date.now() - storedResponse.result.timeOfStorage;
+                        // If it's been greater than our time limit, delete it and return undefined.
+                        if (timeSince > this._expirationTime) {
+                            await this.deleteContent(uniqueId);
+                            return resolve(undefined);
+                        }
+                    }
+                    const content = storedResponse.result.content;
+                    await this.close();
+                    return resolve(content);
+                }
+                await this.close();
+                return resolve(undefined);
+            };
+            storedResponse.onerror = async () => {
+                Logger.logError(loggerCategory, "Error retrieving content from IndexedDB");
+            };
+        });
+    }
+    async deleteContent(uniqueId) {
+        return new Promise(async (resolve) => {
+            await this.open();
+            const deleteTransaction = await this._db.transaction("cache", "readwrite");
+            const requestDelete = await deleteTransaction.objectStore("cache").delete(uniqueId);
+            requestDelete.onerror = () => {
+                Logger.logError(loggerCategory, "Error deleting content from IndexedDB");
+            };
+            deleteTransaction.oncomplete = async () => {
+                await this.close();
+                return resolve(undefined);
+            };
+            deleteTransaction.onerror = async () => {
+                Logger.logError(loggerCategory, "Error deleting content from IndexedDB");
+            };
+        });
+    }
+    async addContent(uniqueId, content) {
+        return new Promise(async (resolve) => {
+            await this.open();
+            const addTransaction = await this._db.transaction("cache", "readwrite");
+            const objectStore = await addTransaction.objectStore("cache");
+            const data = {
+                uniqueId,
+                content,
+                timeOfStorage: Date.now(),
+            };
+            const requestAdd = await objectStore.add(data);
+            requestAdd.onerror = () => {
+                Logger.logError(loggerCategory, "Error adding content to IndexedDB");
+            };
+            addTransaction.oncomplete = async () => {
+                await this.close();
+                return resolve(undefined);
+            };
+            addTransaction.onerror = async () => {
+                Logger.logError(loggerCategory, "Error adding content to IndexedDB in add transaction");
+                await this.close();
+                return resolve(undefined);
+            };
+        });
+    }
+    async fetch(uniqueId, callback, callBackUrl) {
+        let response = await this.retrieveContent(uniqueId);
+        // If nothing was found in the db, fetch normally, then add that content to the db
+        if (response === undefined) {
+            // If necessary, use the callback url
+            if (callBackUrl)
+                response = await (await callback(callBackUrl)).arrayBuffer();
+            else
+                response = await (await callback(uniqueId)).arrayBuffer();
+            await this.addContent(uniqueId, response);
+        }
+        return response;
+    }
+}
+//# sourceMappingURL=IndexedDBCache.js.map

package/lib/esm/IndexedDBCache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IndexedDBCache.js","sourceRoot":"","sources":["../../src/IndexedDBCache.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\nimport { Logger } from \"@itwin/core-bentley\";\r\nconst loggerCategory = \"IndexedDBCache\";\r\n\r\n/** @internal */\r\nexport interface LocalCache {\r\n  fetch(url: string, callback: (uniqueId: string) => Promise<Response>, callBackUrl?: string): Promise<ArrayBuffer>;\r\n}\r\n\r\n/** @internal */\r\nexport class PassThroughCache implements LocalCache {\r\n  public async fetch(uniqueId: string, callback: (url: string) => Promise<Response>, callBackUrl?: string): Promise<ArrayBuffer> {\r\n    if (callBackUrl) {\r\n      return (await callback(callBackUrl)).arrayBuffer();\r\n    }\r\n    return (await callback(uniqueId)).arrayBuffer();\r\n  }\r\n}\r\n\r\n/** @internal */\r\nexport class IndexedDBCache implements LocalCache{\r\n  private _db: any;\r\n  private _dbName: string;\r\n  private _expirationTime?: number;\r\n\r\n  public constructor(dbName: string, expirationTime?: number) {\r\n    this._dbName = dbName;\r\n    this._expirationTime = expirationTime ?? undefined;\r\n  }\r\n\r\n  protected async open(){\r\n\r\n    // need to return a promise so that we can wait for the db to open before using it\r\n    return new Promise(function (this: IndexedDBCache, resolve: any) {\r\n\r\n      // open the db\r\n      const openDB = window.indexedDB.open(this._dbName, 1);\r\n\r\n      openDB.onerror = () => {\r\n        Logger.logError(loggerCategory, \"Error opening IndexedDB\");\r\n      };\r\n\r\n      // this is the success callback for opening the db, it is called after onupgradeneeded\r\n      openDB.onsuccess = async (event) => {\r\n\r\n        const target: any = event.target;\r\n        if (target) {\r\n          this._db = target.result;\r\n          return resolve(target.result);\r\n        }\r\n      };\r\n\r\n      // This will get called when a new version is needed - including going from no database to first version\r\n      // So this is how we set up the specifics of the db structure\r\n      openDB.onupgradeneeded = async (event) => {\r\n        const target: any = event.target;\r\n\r\n        if (target)\r\n          this._db = target.result;\r\n\r\n        const initialObjectStore = this._db.createObjectStore(\"cache\", { keyPath: \"uniqueId\" });\r\n        initialObjectStore.createIndex(\"content\", \"content\", {unique: false});\r\n        initialObjectStore.createIndex(\"timeOfStorage\", \"timeOfStorage\", {unique: false});\r\n      };\r\n    }.bind(this));\r\n  }\r\n\r\n  protected async close() {\r\n    await this._db.close();\r\n  }\r\n\r\n  protected async retrieveContent(uniqueId: string): Promise<ArrayBuffer | undefined> {\r\n    return new Promise(async (resolve) => {\r\n      await this.open();\r\n      const getTransaction = await this._db.transaction(\"cache\", \"readonly\");\r\n      const storedResponse = await getTransaction.objectStore(\"cache\").get(uniqueId);\r\n\r\n      // this is successful if the db was successfully searched - not only if a match was found\r\n      storedResponse.onsuccess = async () => {\r\n\r\n        if (storedResponse.result !== undefined) {\r\n\r\n          // if the content has an expiration time\r\n          if (this._expirationTime) {\r\n            // We want to know when the result was stored, and how long it's been since that point\r\n            const timeSince = Date.now() - storedResponse.result.timeOfStorage;\r\n\r\n            // If it's been greater than our time limit, delete it and return undefined.\r\n            if (timeSince > this._expirationTime) {\r\n              await this.deleteContent(uniqueId);\r\n              return resolve(undefined);\r\n            }\r\n          }\r\n          const content = storedResponse.result.content;\r\n          await this.close();\r\n          return resolve(content);\r\n        }\r\n\r\n        await this.close();\r\n        return resolve(undefined);\r\n      };\r\n\r\n      storedResponse.onerror = async () => {\r\n        Logger.logError(loggerCategory, \"Error retrieving content from IndexedDB\");\r\n      };\r\n    });\r\n  }\r\n\r\n  protected async deleteContent(uniqueId: string) {\r\n    return new Promise(async (resolve) => {\r\n      await this.open();\r\n      const deleteTransaction = await this._db.transaction(\"cache\", \"readwrite\");\r\n      const requestDelete = await deleteTransaction.objectStore(\"cache\").delete(uniqueId);\r\n\r\n      requestDelete.onerror = () => {\r\n        Logger.logError(loggerCategory, \"Error deleting content from IndexedDB\");\r\n      };\r\n\r\n      deleteTransaction.oncomplete = async () => {\r\n        await this.close();\r\n        return resolve(undefined);\r\n      };\r\n\r\n      deleteTransaction.onerror = async () => {\r\n        Logger.logError(loggerCategory, \"Error deleting content from IndexedDB\");\r\n      };\r\n    });\r\n  }\r\n\r\n  protected async addContent(uniqueId: string, content: ArrayBuffer) {\r\n    return new Promise(async (resolve) => {\r\n      await this.open();\r\n      const addTransaction = await this._db.transaction(\"cache\", \"readwrite\");\r\n      const objectStore = await addTransaction.objectStore(\"cache\");\r\n\r\n      const data = {\r\n        uniqueId,\r\n        content,\r\n        timeOfStorage: Date.now(),\r\n      };\r\n\r\n      const requestAdd = await objectStore.add(data);\r\n\r\n      requestAdd.onerror = () => {\r\n        Logger.logError(loggerCategory, \"Error adding content to IndexedDB\");\r\n      };\r\n\r\n      addTransaction.oncomplete = async () => {\r\n        await this.close();\r\n        return resolve(undefined);\r\n      };\r\n\r\n      addTransaction.onerror = async () => {\r\n        Logger.logError(loggerCategory, \"Error adding content to IndexedDB in add transaction\");\r\n        await this.close();\r\n        return resolve(undefined);\r\n      };\r\n    });\r\n  }\r\n\r\n  public async fetch(uniqueId: string, callback: (url: string) => Promise<Response>, callBackUrl?: string): Promise<ArrayBuffer> {\r\n    let response = await this.retrieveContent(uniqueId);\r\n\r\n    // If nothing was found in the db, fetch normally, then add that content to the db\r\n    if (response === undefined) {\r\n\r\n      // If necessary, use the callback url\r\n      if (callBackUrl)\r\n        response = await (await callback(callBackUrl)).arrayBuffer();\r\n      else\r\n        response = await (await callback(uniqueId)).arrayBuffer();\r\n\r\n      await this.addContent(uniqueId, response);\r\n    }\r\n\r\n    return response;\r\n  }\r\n}\r\n\r\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@itwin/frontend-tiles",
-  "version": "4.7.0-dev.8",
+  "version": "4.8.0-dev.0",
   "description": "Experimental alternative technique for visualizing the contents of iModels",
   "main": "lib/cjs/frontend-tiles.js",
   "module": "lib/esm/frontend-tiles.js",
@@ -21,10 +21,10 @@
     "url": "http://www.bentley.com"
   },
   "peerDependencies": {
-    "@itwin/core-bentley": "4.7.0-dev.8",
-    "@itwin/core-frontend": "4.7.0-dev.8",
-    "@itwin/core-geometry": "4.7.0-dev.8",
-    "@itwin/core-common": "4.7.0-dev.8"
+    "@itwin/core-bentley": "4.8.0-dev.0",
+    "@itwin/core-common": "4.8.0-dev.0",
+    "@itwin/core-frontend": "4.8.0-dev.0",
+    "@itwin/core-geometry": "4.8.0-dev.0"
   },
   "devDependencies": {
     "@itwin/eslint-plugin": "^4.0.2",
@@ -45,12 +45,12 @@
     "source-map-loader": "^4.0.0",
     "typescript": "~5.3.3",
     "webpack": "^5.76.0",
-    "@itwin/build-tools": "4.7.0-dev.8",
-    "@itwin/core-bentley": "4.7.0-dev.8",
-    "@itwin/core-common": "4.7.0-dev.8",
-    "@itwin/certa": "4.7.0-dev.8",
-    "@itwin/core-frontend": "4.7.0-dev.8",
-    "@itwin/core-geometry": "4.7.0-dev.8"
+    "@itwin/build-tools": "4.8.0-dev.0",
+    "@itwin/certa": "4.8.0-dev.0",
+    "@itwin/core-bentley": "4.8.0-dev.0",
+    "@itwin/core-common": "4.8.0-dev.0",
+    "@itwin/core-frontend": "4.8.0-dev.0",
+    "@itwin/core-geometry": "4.8.0-dev.0"
   },
   "scripts": {
     "build": "npm run -s build:cjs && npm run -s build:esm",