@itwin/frontend-tiles 4.0.2 → 4.0.4

package/CHANGELOG.md

@@ -1,6 +1,19 @@
 # Change Log - @itwin/frontend-tiles
 
-This log was last generated on Wed, 21 Jun 2023 22:04:43 GMT and should not be manually modified.
+This log was last generated on Wed, 12 Jul 2023 15:50:01 GMT and should not be manually modified.
+
+## 4.0.4
+Wed, 12 Jul 2023 15:50:01 GMT
+
+_Version update only_
+
+## 4.0.3
+Mon, 03 Jul 2023 15:28:41 GMT
+
+### Updates
+
+- Promote APIs to beta.
+- Provide functions for obtaining URLs from mesh export service.
 
 ## 4.0.2
 Wed, 21 Jun 2023 22:04:43 GMT
@@ -23,6 +36,16 @@ Mon, 22 May 2023 15:34:14 GMT
 - Ensure fitting the view fits to the extents of the currently-viewed models.
 - Add new experimental package providing alternate technique for visualizing iModels.
 
+## 3.7.11
+Tue, 11 Jul 2023 17:17:22 GMT
+
+_Version update only_
+
+## 3.7.10
+Wed, 05 Jul 2023 13:41:21 GMT
+
+_Version update only_
+
 ## 3.7.9
 Tue, 20 Jun 2023 12:51:02 GMT
 

package/lib/cjs/FrontendTiles.d.ts

@@ -1,17 +1,95 @@
+import { AccessToken } from "@itwin/core-bentley";
 import { IModelConnection, SpatialTileTreeReferences } from "@itwin/core-frontend";
 /** A function that can provide the base URL where a tileset representing all of the spatial models in a given iModel are stored.
  * 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/).
  * If no such tileset exists for the given iModel, return `undefined`.
  * @see [[FrontendTilesOptions.computeSpatialTilesetBaseUrl]].
- * @alpha
+ * @beta
  */
 export type ComputeSpatialTilesetBaseUrl = (iModel: IModelConnection) => Promise<URL | undefined>;
+/** Represents the result of a [mesh export](https://developer.bentley.com/apis/mesh-export/operations/get-export/#export).
+ * @see [[queryCompletedMeshExports]].
+ * @beta
+ */
+export interface MeshExport {
+    id: string;
+    displayName: string;
+    status: string;
+    request: {
+        iModelId: string;
+        changesetId: string;
+        exportType: string;
+        geometryOptions: any;
+        viewDefinitionFilter: any;
+    };
+    _links: {
+        mesh: {
+            href: string;
+        };
+    };
+}
+/** Exposed strictly for tests.
+ * @internal
+ */
+export interface MeshExports {
+    exports: MeshExport[];
+    _links: {
+        next?: {
+            href: string;
+        };
+    };
+}
+/** Arguments supplied to [[queryMeshExports]].
+ * @beta
+ */
+export interface QueryMeshExportsArgs {
+    /** The token used to access the mesh export service. */
+    accessToken: AccessToken;
+    /** The Id of the iModel for which to query exports. */
+    iModelId: string;
+    /** If defined, constrains the query to exports produced from the specified changeset. */
+    changesetId?: string;
+    /** Chiefly used in testing environments. */
+    urlPrefix?: string;
+    /** If true, exports whose status is not "Complete" (indicating the export successfully finished) will be included in the results. */
+    includeIncomplete?: boolean;
+}
+/** Query the [mesh export service](https://developer.bentley.com/apis/mesh-export/operations/get-exports/) for exports of type "IMODEL" matching
+ * the specified criteria.
+ * The exports are sorted from most-recently- to least-recently-produced.
+ * @beta
+ */
+export declare function queryMeshExports(args: QueryMeshExportsArgs): AsyncIterableIterator<MeshExport>;
+/** Arguments supplied  to [[obtainMeshExportTilesetUrl]].
+ * @beta
+ */
+export interface ObtainMeshExportTilesetUrlArgs {
+    /** The iModel for which to obtain a tileset URl. */
+    iModel: IModelConnection;
+    /** The token used to access the mesh export service. */
+    accessToken: AccessToken;
+    /** Chiefly used in testing environments. */
+    urlPrefix?: string;
+    /** If true, only exports produced for `iModel`'s specific changeset will be considered; otherwise, if no exports are found for the changeset,
+     * the most recent export for any changeset will be used.
+     */
+    requireExactChangeset?: boolean;
+}
+/** Obtains a URL pointing to a tileset appropriate for visualizing a specific iModel.
+ * [[queryCompletedMeshExports]] is used to obtain a list of available exports. By default, the list is sorted from most to least recently-exported.
+ * The first export matching the iModel's changeset is selected; or, if no such export exists, the first export in the list is selected.
+ * @returns A URL from which the tileset can be loaded, or `undefined` if no appropriate URL could be obtained.
+ * @beta
+ */
+export declare function obtainMeshExportTilesetUrl(args: ObtainMeshExportTilesetUrlArgs): Promise<URL | undefined>;
 /** Options supplied to [[initializeFrontendTiles]].
- * @alpha
+ * @beta
  */
 export interface FrontendTilesOptions {
-    /** Provide the base URL for the pre-published tileset for a given iModel. */
-    computeSpatialTilesetBaseUrl: ComputeSpatialTilesetBaseUrl;
+    /** Provide the base URL for the pre-published tileset for a given iModel.
+     * If omitted, [[obtainMeshExportTilesetUrl]] will be invoked with default arguments, using the access token provided by [[IModelApp]].
+     */
+    computeSpatialTilesetBaseUrl?: ComputeSpatialTilesetBaseUrl;
     /** 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.
      * Default: 4.
      * Reducing this value will load more intermediate tiles, which causes more gradual refinement: low-resolution tiles will display quickly, followed more gradually by
@@ -27,7 +105,7 @@ export declare const createFallbackSpatialTileTreeReferences: typeof SpatialTile
 /** @internal */
 export declare function getMaxLevelsToSkip(): number;
 /** Initialize the frontend-tiles package to obtain tiles for spatial views.
- * @alpha
+ * @beta
  */
 export declare function initializeFrontendTiles(options: FrontendTilesOptions): void;
 //# sourceMappingURL=FrontendTiles.d.ts.map

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,gBAAgB,EAAE,yBAAyB,EAAoB,MAAM,sBAAsB,CAAC;AAGrG;;;;;GAKG;AACH,MAAM,MAAM,4BAA4B,GAAG,CAAC,MAAM,EAAE,gBAAgB,KAAK,OAAO,CAAC,GAAG,GAAG,SAAS,CAAC,CAAC;AAElG;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,6EAA6E;IAC7E,4BAA4B,EAAE,4BAA4B,CAAC;IAC3D;;;;;;;OAOG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,gBAAgB;AAChB,eAAO,MAAM,uCAAuC,yCAAmC,CAAC;AAIxF,gBAAgB;AAChB,wBAAgB,kBAAkB,IAAI,MAAM,CAE3C;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,oBAAoB,GAAG,IAAI,CAK3E"}
+{"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,EAAE,yBAAyB,EAAoB,MAAM,sBAAsB,CAAC;AAIhH;;;;;GAKG;AACH,MAAM,MAAM,4BAA4B,GAAG,CAAC,MAAM,EAAE,gBAAgB,KAAK,OAAO,CAAC,GAAG,GAAG,SAAS,CAAC,CAAC;AAWlG;;;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;CAC7B;AAED;;;;GAIG;AACH,wBAAwB,gBAAgB,CAAC,IAAI,EAAE,oBAAoB,GAAG,qBAAqB,CAAC,UAAU,CAAC,CA4BtG;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;CACjC;AAED;;;;;GAKG;AACH,wBAAsB,0BAA0B,CAAC,IAAI,EAAE,8BAA8B,GAAG,OAAO,CAAC,GAAG,GAAG,SAAS,CAAC,CAoC/G;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC;;OAEG;IACH,4BAA4B,CAAC,EAAE,4BAA4B,CAAC;IAC5D;;;;;;;OAOG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,gBAAgB;AAChB,eAAO,MAAM,uCAAuC,yCAAmC,CAAC;AAIxF,gBAAgB;AAChB,wBAAgB,kBAAkB,IAAI,MAAM,CAE3C;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,oBAAoB,GAAG,IAAI,CAS3E"}

package/lib/cjs/FrontendTiles.js

@@ -4,9 +4,90 @@
 * See LICENSE.md in the project root for license terms and full copyright notice.
 *--------------------------------------------------------------------------------------------*/
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.initializeFrontendTiles = exports.getMaxLevelsToSkip = exports.createFallbackSpatialTileTreeReferences = void 0;
+exports.initializeFrontendTiles = exports.getMaxLevelsToSkip = exports.createFallbackSpatialTileTreeReferences = exports.obtainMeshExportTilesetUrl = exports.queryMeshExports = void 0;
+const core_bentley_1 = require("@itwin/core-bentley");
 const core_frontend_1 = require("@itwin/core-frontend");
+const LoggerCategory_1 = require("./LoggerCategory");
 const BatchedSpatialTileTreeRefs_1 = require("./BatchedSpatialTileTreeRefs");
+function createMeshExportServiceQueryUrl(args) {
+    const prefix = args.urlPrefix ?? "";
+    let url = `https://${prefix}api.bentley.com/mesh-export/?iModelId=${args.iModelId}&$orderBy=date:desc`;
+    if (args.changesetId)
+        url = `${url}&changesetId=${args.changesetId}`;
+    return url;
+}
+/** Query the [mesh export service](https://developer.bentley.com/apis/mesh-export/operations/get-exports/) for exports of type "IMODEL" matching
+ * the specified criteria.
+ * The exports are sorted from most-recently- to least-recently-produced.
+ * @beta
+ */
+async function* queryMeshExports(args) {
+    const headers = {
+        /* eslint-disable-next-line @typescript-eslint/naming-convention */
+        Authorization: args.accessToken ?? await core_frontend_1.IModelApp.getAccessToken(),
+        /* eslint-disable-next-line @typescript-eslint/naming-convention */
+        Accept: "application/vnd.bentley.itwin-platform.v1+json",
+        /* eslint-disable-next-line @typescript-eslint/naming-convention */
+        Prefer: "return=representation",
+    };
+    let url = createMeshExportServiceQueryUrl(args);
+    while (url) {
+        let result;
+        try {
+            const response = await fetch(url, { headers });
+            result = await response.json();
+        }
+        catch (err) {
+            core_bentley_1.Logger.logException(LoggerCategory_1.loggerCategory, err);
+            core_bentley_1.Logger.logError(LoggerCategory_1.loggerCategory, `Failed loading exports for iModel ${args.iModelId}`);
+            break;
+        }
+        const foundExports = result.exports.filter((x) => x.request.exportType === "IMODEL" && (args.includeIncomplete || x.status === "Complete"));
+        for (const foundExport of foundExports)
+            yield foundExport;
+        url = result._links.next?.href;
+    }
+}
+exports.queryMeshExports = queryMeshExports;
+/** Obtains a URL pointing to a tileset appropriate for visualizing a specific iModel.
+ * [[queryCompletedMeshExports]] is used to obtain a list of available exports. By default, the list is sorted from most to least recently-exported.
+ * The first export matching the iModel's changeset is selected; or, if no such export exists, the first export in the list is selected.
+ * @returns A URL from which the tileset can be loaded, or `undefined` if no appropriate URL could be obtained.
+ * @beta
+ */
+async function obtainMeshExportTilesetUrl(args) {
+    if (!args.iModel.iModelId) {
+        core_bentley_1.Logger.logInfo(LoggerCategory_1.loggerCategory, "Cannot obtain exports for an iModel with no iModelId");
+        return undefined;
+    }
+    const queryArgs = {
+        accessToken: args.accessToken,
+        iModelId: args.iModel.iModelId,
+        changesetId: args.iModel.changeset.id,
+        urlPrefix: args.urlPrefix,
+    };
+    let selectedExport;
+    for await (const exp of queryMeshExports(queryArgs)) {
+        selectedExport = exp;
+        break;
+    }
+    if (!selectedExport && !args.requireExactChangeset) {
+        queryArgs.changesetId = undefined;
+        for await (const exp of queryMeshExports(queryArgs)) {
+            selectedExport = exp;
+            core_bentley_1.Logger.logInfo(LoggerCategory_1.loggerCategory, `No exports for iModel ${args.iModel.iModelId} for changeset ${args.iModel.changeset.id}; falling back to most recent`);
+            break;
+        }
+    }
+    if (!selectedExport) {
+        core_bentley_1.Logger.logInfo(LoggerCategory_1.loggerCategory, `No exports available for iModel ${args.iModel.iModelId}`);
+        return undefined;
+    }
+    const url = new URL(selectedExport._links.mesh.href);
+    url.pathname = `${url.pathname}/tileset.json`;
+    return url;
+}
+exports.obtainMeshExportTilesetUrl = obtainMeshExportTilesetUrl;
 /** @internal */
 exports.createFallbackSpatialTileTreeReferences = core_frontend_1.SpatialTileTreeReferences.create;
 let maxLevelsToSkip = 4;
@@ -16,12 +97,13 @@ function getMaxLevelsToSkip() {
 }
 exports.getMaxLevelsToSkip = getMaxLevelsToSkip;
 /** Initialize the frontend-tiles package to obtain tiles for spatial views.
- * @alpha
+ * @beta
  */
 function initializeFrontendTiles(options) {
     if (undefined !== options.maxLevelsToSkip && options.maxLevelsToSkip >= 0)
         maxLevelsToSkip = options.maxLevelsToSkip;
-    core_frontend_1.SpatialTileTreeReferences.create = (view) => (0, BatchedSpatialTileTreeRefs_1.createBatchedSpatialTileTreeReferences)(view, options.computeSpatialTilesetBaseUrl);
+    const computeUrl = options.computeSpatialTilesetBaseUrl ?? (async (iModel) => obtainMeshExportTilesetUrl({ iModel, accessToken: await core_frontend_1.IModelApp.getAccessToken() }));
+    core_frontend_1.SpatialTileTreeReferences.create = (view) => (0, BatchedSpatialTileTreeRefs_1.createBatchedSpatialTileTreeReferences)(view, computeUrl);
 }
 exports.initializeFrontendTiles = initializeFrontendTiles;
 //# sourceMappingURL=FrontendTiles.js.map

package/lib/cjs/FrontendTiles.js.map

@@ -1 +1 @@
-{"version":3,"file":"FrontendTiles.js","sourceRoot":"","sources":["../../src/FrontendTiles.ts"],"names":[],"mappings":";AAAA;;;+FAG+F;;;AAE/F,wDAAqG;AACrG,6EAAsF;AA2BtF,gBAAgB;AACH,QAAA,uCAAuC,GAAG,yCAAyB,CAAC,MAAM,CAAC;AAExF,IAAI,eAAe,GAAG,CAAC,CAAC;AAExB,gBAAgB;AAChB,SAAgB,kBAAkB;IAChC,OAAO,eAAe,CAAC;AACzB,CAAC;AAFD,gDAEC;AAED;;GAEG;AACH,SAAgB,uBAAuB,CAAC,OAA6B;IACnE,IAAI,SAAS,KAAK,OAAO,CAAC,eAAe,IAAI,OAAO,CAAC,eAAe,IAAI,CAAC;QACvE,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC;IAE5C,yCAAyB,CAAC,MAAM,GAAG,CAAC,IAAsB,EAAE,EAAE,CAAC,IAAA,mEAAsC,EAAC,IAAI,EAAE,OAAO,CAAC,4BAA4B,CAAC,CAAC;AACpJ,CAAC;AALD,0DAKC","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 { IModelConnection, SpatialTileTreeReferences, SpatialViewState } from \"@itwin/core-frontend\";\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 * @alpha\r\n */\r\nexport type ComputeSpatialTilesetBaseUrl = (iModel: IModelConnection) => Promise<URL | undefined>;\r\n\r\n/** Options supplied to [[initializeFrontendTiles]].\r\n * @alpha\r\n */\r\nexport interface FrontendTilesOptions {\r\n  /** Provide the base URL for the pre-published tileset for a given iModel. */\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}\r\n\r\n/** @internal */\r\nexport const createFallbackSpatialTileTreeReferences = SpatialTileTreeReferences.create;\r\n\r\nlet maxLevelsToSkip = 4;\r\n\r\n/** @internal */\r\nexport function getMaxLevelsToSkip(): number {\r\n  return maxLevelsToSkip;\r\n}\r\n\r\n/** Initialize the frontend-tiles package to obtain tiles for spatial views.\r\n * @alpha\r\n */\r\nexport function initializeFrontendTiles(options: FrontendTilesOptions): void {\r\n  if (undefined !== options.maxLevelsToSkip && options.maxLevelsToSkip >= 0)\r\n    maxLevelsToSkip = options.maxLevelsToSkip;\r\n\r\n  SpatialTileTreeReferences.create = (view: SpatialViewState) => createBatchedSpatialTileTreeReferences(view, options.computeSpatialTilesetBaseUrl);\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 }): 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  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}\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  };\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}\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  };\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}\r\n\r\n/** @internal */\r\nexport const createFallbackSpatialTileTreeReferences = SpatialTileTreeReferences.create;\r\n\r\nlet maxLevelsToSkip = 4;\r\n\r\n/** @internal */\r\nexport function getMaxLevelsToSkip(): number {\r\n  return maxLevelsToSkip;\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    maxLevelsToSkip = options.maxLevelsToSkip;\r\n\r\n  const computeUrl = options.computeSpatialTilesetBaseUrl ?? (\r\n    async (iModel: IModelConnection) => obtainMeshExportTilesetUrl({ iModel, accessToken: await IModelApp.getAccessToken() })\r\n  );\r\n\r\n  SpatialTileTreeReferences.create = (view: SpatialViewState) => createBatchedSpatialTileTreeReferences(view, computeUrl);\r\n}\r\n"]}

package/lib/esm/FrontendTiles.d.ts

@@ -1,17 +1,95 @@
+import { AccessToken } from "@itwin/core-bentley";
 import { IModelConnection, SpatialTileTreeReferences } from "@itwin/core-frontend";
 /** A function that can provide the base URL where a tileset representing all of the spatial models in a given iModel are stored.
  * 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/).
  * If no such tileset exists for the given iModel, return `undefined`.
  * @see [[FrontendTilesOptions.computeSpatialTilesetBaseUrl]].
- * @alpha
+ * @beta
  */
 export type ComputeSpatialTilesetBaseUrl = (iModel: IModelConnection) => Promise<URL | undefined>;
+/** Represents the result of a [mesh export](https://developer.bentley.com/apis/mesh-export/operations/get-export/#export).
+ * @see [[queryCompletedMeshExports]].
+ * @beta
+ */
+export interface MeshExport {
+    id: string;
+    displayName: string;
+    status: string;
+    request: {
+        iModelId: string;
+        changesetId: string;
+        exportType: string;
+        geometryOptions: any;
+        viewDefinitionFilter: any;
+    };
+    _links: {
+        mesh: {
+            href: string;
+        };
+    };
+}
+/** Exposed strictly for tests.
+ * @internal
+ */
+export interface MeshExports {
+    exports: MeshExport[];
+    _links: {
+        next?: {
+            href: string;
+        };
+    };
+}
+/** Arguments supplied to [[queryMeshExports]].
+ * @beta
+ */
+export interface QueryMeshExportsArgs {
+    /** The token used to access the mesh export service. */
+    accessToken: AccessToken;
+    /** The Id of the iModel for which to query exports. */
+    iModelId: string;
+    /** If defined, constrains the query to exports produced from the specified changeset. */
+    changesetId?: string;
+    /** Chiefly used in testing environments. */
+    urlPrefix?: string;
+    /** If true, exports whose status is not "Complete" (indicating the export successfully finished) will be included in the results. */
+    includeIncomplete?: boolean;
+}
+/** Query the [mesh export service](https://developer.bentley.com/apis/mesh-export/operations/get-exports/) for exports of type "IMODEL" matching
+ * the specified criteria.
+ * The exports are sorted from most-recently- to least-recently-produced.
+ * @beta
+ */
+export declare function queryMeshExports(args: QueryMeshExportsArgs): AsyncIterableIterator<MeshExport>;
+/** Arguments supplied  to [[obtainMeshExportTilesetUrl]].
+ * @beta
+ */
+export interface ObtainMeshExportTilesetUrlArgs {
+    /** The iModel for which to obtain a tileset URl. */
+    iModel: IModelConnection;
+    /** The token used to access the mesh export service. */
+    accessToken: AccessToken;
+    /** Chiefly used in testing environments. */
+    urlPrefix?: string;
+    /** If true, only exports produced for `iModel`'s specific changeset will be considered; otherwise, if no exports are found for the changeset,
+     * the most recent export for any changeset will be used.
+     */
+    requireExactChangeset?: boolean;
+}
+/** Obtains a URL pointing to a tileset appropriate for visualizing a specific iModel.
+ * [[queryCompletedMeshExports]] is used to obtain a list of available exports. By default, the list is sorted from most to least recently-exported.
+ * The first export matching the iModel's changeset is selected; or, if no such export exists, the first export in the list is selected.
+ * @returns A URL from which the tileset can be loaded, or `undefined` if no appropriate URL could be obtained.
+ * @beta
+ */
+export declare function obtainMeshExportTilesetUrl(args: ObtainMeshExportTilesetUrlArgs): Promise<URL | undefined>;
 /** Options supplied to [[initializeFrontendTiles]].
- * @alpha
+ * @beta
  */
 export interface FrontendTilesOptions {
-    /** Provide the base URL for the pre-published tileset for a given iModel. */
-    computeSpatialTilesetBaseUrl: ComputeSpatialTilesetBaseUrl;
+    /** Provide the base URL for the pre-published tileset for a given iModel.
+     * If omitted, [[obtainMeshExportTilesetUrl]] will be invoked with default arguments, using the access token provided by [[IModelApp]].
+     */
+    computeSpatialTilesetBaseUrl?: ComputeSpatialTilesetBaseUrl;
     /** 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.
      * Default: 4.
      * Reducing this value will load more intermediate tiles, which causes more gradual refinement: low-resolution tiles will display quickly, followed more gradually by
@@ -27,7 +105,7 @@ export declare const createFallbackSpatialTileTreeReferences: typeof SpatialTile
 /** @internal */
 export declare function getMaxLevelsToSkip(): number;
 /** Initialize the frontend-tiles package to obtain tiles for spatial views.
- * @alpha
+ * @beta
  */
 export declare function initializeFrontendTiles(options: FrontendTilesOptions): void;
 //# sourceMappingURL=FrontendTiles.d.ts.map

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,gBAAgB,EAAE,yBAAyB,EAAoB,MAAM,sBAAsB,CAAC;AAGrG;;;;;GAKG;AACH,MAAM,MAAM,4BAA4B,GAAG,CAAC,MAAM,EAAE,gBAAgB,KAAK,OAAO,CAAC,GAAG,GAAG,SAAS,CAAC,CAAC;AAElG;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,6EAA6E;IAC7E,4BAA4B,EAAE,4BAA4B,CAAC;IAC3D;;;;;;;OAOG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,gBAAgB;AAChB,eAAO,MAAM,uCAAuC,yCAAmC,CAAC;AAIxF,gBAAgB;AAChB,wBAAgB,kBAAkB,IAAI,MAAM,CAE3C;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,oBAAoB,GAAG,IAAI,CAK3E"}
+{"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,EAAE,yBAAyB,EAAoB,MAAM,sBAAsB,CAAC;AAIhH;;;;;GAKG;AACH,MAAM,MAAM,4BAA4B,GAAG,CAAC,MAAM,EAAE,gBAAgB,KAAK,OAAO,CAAC,GAAG,GAAG,SAAS,CAAC,CAAC;AAWlG;;;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;CAC7B;AAED;;;;GAIG;AACH,wBAAwB,gBAAgB,CAAC,IAAI,EAAE,oBAAoB,GAAG,qBAAqB,CAAC,UAAU,CAAC,CA4BtG;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;CACjC;AAED;;;;;GAKG;AACH,wBAAsB,0BAA0B,CAAC,IAAI,EAAE,8BAA8B,GAAG,OAAO,CAAC,GAAG,GAAG,SAAS,CAAC,CAoC/G;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC;;OAEG;IACH,4BAA4B,CAAC,EAAE,4BAA4B,CAAC;IAC5D;;;;;;;OAOG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,gBAAgB;AAChB,eAAO,MAAM,uCAAuC,yCAAmC,CAAC;AAIxF,gBAAgB;AAChB,wBAAgB,kBAAkB,IAAI,MAAM,CAE3C;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,oBAAoB,GAAG,IAAI,CAS3E"}

package/lib/esm/FrontendTiles.js

@@ -2,8 +2,87 @@
 * Copyright (c) Bentley Systems, Incorporated. All rights reserved.
 * See LICENSE.md in the project root for license terms and full copyright notice.
 *--------------------------------------------------------------------------------------------*/
-import { SpatialTileTreeReferences } from "@itwin/core-frontend";
+import { Logger } from "@itwin/core-bentley";
+import { IModelApp, SpatialTileTreeReferences } from "@itwin/core-frontend";
+import { loggerCategory } from "./LoggerCategory";
 import { createBatchedSpatialTileTreeReferences } from "./BatchedSpatialTileTreeRefs";
+function createMeshExportServiceQueryUrl(args) {
+    const prefix = args.urlPrefix ?? "";
+    let url = `https://${prefix}api.bentley.com/mesh-export/?iModelId=${args.iModelId}&$orderBy=date:desc`;
+    if (args.changesetId)
+        url = `${url}&changesetId=${args.changesetId}`;
+    return url;
+}
+/** Query the [mesh export service](https://developer.bentley.com/apis/mesh-export/operations/get-exports/) for exports of type "IMODEL" matching
+ * the specified criteria.
+ * The exports are sorted from most-recently- to least-recently-produced.
+ * @beta
+ */
+export async function* queryMeshExports(args) {
+    const headers = {
+        /* eslint-disable-next-line @typescript-eslint/naming-convention */
+        Authorization: args.accessToken ?? await IModelApp.getAccessToken(),
+        /* eslint-disable-next-line @typescript-eslint/naming-convention */
+        Accept: "application/vnd.bentley.itwin-platform.v1+json",
+        /* eslint-disable-next-line @typescript-eslint/naming-convention */
+        Prefer: "return=representation",
+    };
+    let url = createMeshExportServiceQueryUrl(args);
+    while (url) {
+        let result;
+        try {
+            const response = await fetch(url, { headers });
+            result = await response.json();
+        }
+        catch (err) {
+            Logger.logException(loggerCategory, err);
+            Logger.logError(loggerCategory, `Failed loading exports for iModel ${args.iModelId}`);
+            break;
+        }
+        const foundExports = result.exports.filter((x) => x.request.exportType === "IMODEL" && (args.includeIncomplete || x.status === "Complete"));
+        for (const foundExport of foundExports)
+            yield foundExport;
+        url = result._links.next?.href;
+    }
+}
+/** Obtains a URL pointing to a tileset appropriate for visualizing a specific iModel.
+ * [[queryCompletedMeshExports]] is used to obtain a list of available exports. By default, the list is sorted from most to least recently-exported.
+ * The first export matching the iModel's changeset is selected; or, if no such export exists, the first export in the list is selected.
+ * @returns A URL from which the tileset can be loaded, or `undefined` if no appropriate URL could be obtained.
+ * @beta
+ */
+export async function obtainMeshExportTilesetUrl(args) {
+    if (!args.iModel.iModelId) {
+        Logger.logInfo(loggerCategory, "Cannot obtain exports for an iModel with no iModelId");
+        return undefined;
+    }
+    const queryArgs = {
+        accessToken: args.accessToken,
+        iModelId: args.iModel.iModelId,
+        changesetId: args.iModel.changeset.id,
+        urlPrefix: args.urlPrefix,
+    };
+    let selectedExport;
+    for await (const exp of queryMeshExports(queryArgs)) {
+        selectedExport = exp;
+        break;
+    }
+    if (!selectedExport && !args.requireExactChangeset) {
+        queryArgs.changesetId = undefined;
+        for await (const exp of queryMeshExports(queryArgs)) {
+            selectedExport = exp;
+            Logger.logInfo(loggerCategory, `No exports for iModel ${args.iModel.iModelId} for changeset ${args.iModel.changeset.id}; falling back to most recent`);
+            break;
+        }
+    }
+    if (!selectedExport) {
+        Logger.logInfo(loggerCategory, `No exports available for iModel ${args.iModel.iModelId}`);
+        return undefined;
+    }
+    const url = new URL(selectedExport._links.mesh.href);
+    url.pathname = `${url.pathname}/tileset.json`;
+    return url;
+}
 /** @internal */
 export const createFallbackSpatialTileTreeReferences = SpatialTileTreeReferences.create;
 let maxLevelsToSkip = 4;
@@ -12,11 +91,12 @@ export function getMaxLevelsToSkip() {
     return maxLevelsToSkip;
 }
 /** Initialize the frontend-tiles package to obtain tiles for spatial views.
- * @alpha
+ * @beta
  */
 export function initializeFrontendTiles(options) {
     if (undefined !== options.maxLevelsToSkip && options.maxLevelsToSkip >= 0)
         maxLevelsToSkip = options.maxLevelsToSkip;
-    SpatialTileTreeReferences.create = (view) => createBatchedSpatialTileTreeReferences(view, options.computeSpatialTilesetBaseUrl);
+    const computeUrl = options.computeSpatialTilesetBaseUrl ?? (async (iModel) => obtainMeshExportTilesetUrl({ iModel, accessToken: await IModelApp.getAccessToken() }));
+    SpatialTileTreeReferences.create = (view) => createBatchedSpatialTileTreeReferences(view, computeUrl);
 }
 //# sourceMappingURL=FrontendTiles.js.map

package/lib/esm/FrontendTiles.js.map

@@ -1 +1 @@
-{"version":3,"file":"FrontendTiles.js","sourceRoot":"","sources":["../../src/FrontendTiles.ts"],"names":[],"mappings":"AAAA;;;+FAG+F;AAE/F,OAAO,EAAoB,yBAAyB,EAAoB,MAAM,sBAAsB,CAAC;AACrG,OAAO,EAAE,sCAAsC,EAAE,MAAM,8BAA8B,CAAC;AA2BtF,gBAAgB;AAChB,MAAM,CAAC,MAAM,uCAAuC,GAAG,yBAAyB,CAAC,MAAM,CAAC;AAExF,IAAI,eAAe,GAAG,CAAC,CAAC;AAExB,gBAAgB;AAChB,MAAM,UAAU,kBAAkB;IAChC,OAAO,eAAe,CAAC;AACzB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,uBAAuB,CAAC,OAA6B;IACnE,IAAI,SAAS,KAAK,OAAO,CAAC,eAAe,IAAI,OAAO,CAAC,eAAe,IAAI,CAAC;QACvE,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC;IAE5C,yBAAyB,CAAC,MAAM,GAAG,CAAC,IAAsB,EAAE,EAAE,CAAC,sCAAsC,CAAC,IAAI,EAAE,OAAO,CAAC,4BAA4B,CAAC,CAAC;AACpJ,CAAC","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 { IModelConnection, SpatialTileTreeReferences, SpatialViewState } from \"@itwin/core-frontend\";\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 * @alpha\r\n */\r\nexport type ComputeSpatialTilesetBaseUrl = (iModel: IModelConnection) => Promise<URL | undefined>;\r\n\r\n/** Options supplied to [[initializeFrontendTiles]].\r\n * @alpha\r\n */\r\nexport interface FrontendTilesOptions {\r\n  /** Provide the base URL for the pre-published tileset for a given iModel. */\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}\r\n\r\n/** @internal */\r\nexport const createFallbackSpatialTileTreeReferences = SpatialTileTreeReferences.create;\r\n\r\nlet maxLevelsToSkip = 4;\r\n\r\n/** @internal */\r\nexport function getMaxLevelsToSkip(): number {\r\n  return maxLevelsToSkip;\r\n}\r\n\r\n/** Initialize the frontend-tiles package to obtain tiles for spatial views.\r\n * @alpha\r\n */\r\nexport function initializeFrontendTiles(options: FrontendTilesOptions): void {\r\n  if (undefined !== options.maxLevelsToSkip && options.maxLevelsToSkip >= 0)\r\n    maxLevelsToSkip = options.maxLevelsToSkip;\r\n\r\n  SpatialTileTreeReferences.create = (view: SpatialViewState) => createBatchedSpatialTileTreeReferences(view, options.computeSpatialTilesetBaseUrl);\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 }): 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  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}\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  };\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}\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  };\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}\r\n\r\n/** @internal */\r\nexport const createFallbackSpatialTileTreeReferences = SpatialTileTreeReferences.create;\r\n\r\nlet maxLevelsToSkip = 4;\r\n\r\n/** @internal */\r\nexport function getMaxLevelsToSkip(): number {\r\n  return maxLevelsToSkip;\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    maxLevelsToSkip = options.maxLevelsToSkip;\r\n\r\n  const computeUrl = options.computeSpatialTilesetBaseUrl ?? (\r\n    async (iModel: IModelConnection) => obtainMeshExportTilesetUrl({ iModel, accessToken: await IModelApp.getAccessToken() })\r\n  );\r\n\r\n  SpatialTileTreeReferences.create = (view: SpatialViewState) => createBatchedSpatialTileTreeReferences(view, computeUrl);\r\n}\r\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@itwin/frontend-tiles",
-  "version": "4.0.2",
+  "version": "4.0.4",
   "description": "Experimental alternative technique for visualizing the contents of iModels",
   "main": "lib/cjs/frontend-tiles.js",
   "module": "lib/esm/frontend-tiles.js",
@@ -23,22 +23,36 @@
     "url": "http://www.bentley.com"
   },
   "peerDependencies": {
-    "@itwin/core-bentley": "4.0.2",
-    "@itwin/core-frontend": "4.0.2",
-    "@itwin/core-common": "4.0.2",
-    "@itwin/core-geometry": "4.0.2"
+    "@itwin/core-bentley": "4.0.4",
+    "@itwin/core-common": "4.0.4",
+    "@itwin/core-frontend": "4.0.4",
+    "@itwin/core-geometry": "4.0.4"
   },
   "devDependencies": {
     "@itwin/eslint-plugin": "^4.0.0-dev.33",
+    "@types/chai": "4.3.1",
+    "@types/chai-as-promised": "^7",
+    "@types/mocha": "^8.2.2",
     "@types/node": "^18.11.5",
+    "@types/sinon": "^9.0.0",
+    "babel-loader": "~8.2.5",
+    "babel-plugin-istanbul": "~6.1.1",
+    "chai": "^4.1.2",
+    "chai-as-promised": "^7",
     "eslint": "^8.36.0",
+    "glob": "^7.1.2",
+    "mocha": "^10.0.0",
     "rimraf": "^3.0.2",
+    "sinon": "^9.0.2",
+    "source-map-loader": "^4.0.0",
     "typescript": "~5.0.2",
-    "@itwin/core-frontend": "4.0.2",
-    "@itwin/build-tools": "4.0.2",
-    "@itwin/core-bentley": "4.0.2",
-    "@itwin/core-common": "4.0.2",
-    "@itwin/core-geometry": "4.0.2"
+    "webpack": "^5.76.0",
+    "@itwin/core-frontend": "4.0.4",
+    "@itwin/build-tools": "4.0.4",
+    "@itwin/core-bentley": "4.0.4",
+    "@itwin/certa": "4.0.4",
+    "@itwin/core-common": "4.0.4",
+    "@itwin/core-geometry": "4.0.4"
   },
   "eslintConfig": {
     "plugins": [
@@ -51,10 +65,11 @@
     "build:cjs": "tsc 1>&2 --outDir lib/cjs",
     "build:esm": "tsc 1>&2 --module ES2020 --outDir lib/esm",
     "clean": "rimraf lib .rush/temp/package-deps*.json",
+    "cover": "npm -s test",
     "docs": "",
     "extract-api": "betools extract-api --entry=frontend-tiles",
     "lint": "eslint -f visualstudio \"./src/**/*.ts\" 1>&2",
-    "test": "",
-    "cover": ""
+    "test": "npm run -s webpackTests && certa -r chrome",
+    "webpackTests": "webpack --config ./src/test/utils/webpack-config.js 1>&2"
   }
 }

package/.rush/temp/operation/build/all.log

@@ -1,3 +0,0 @@
-This project was not found in the local build cache. Querying the cloud build cache.
-This project was not found in the build cache.
-Invoking: npm run -s build:cjs && npm run -s build:esm 

package/.rush/temp/operation/build/state.json

@@ -1,3 +0,0 @@
-{
-  "nonCachedDurationMs": 12306.159400001168
-}