@itwin/core-frontend 4.0.0-dev.4 → 4.0.0-dev.40

package/lib/esm/GeoServices.js

@@ -1,156 +1,161 @@
+/*---------------------------------------------------------------------------------------------
+* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+* See LICENSE.md in the project root for license terms and full copyright notice.
+*--------------------------------------------------------------------------------------------*/
+// cspell:ignore GCRS
+import { assert, BeEvent, Dictionary, Logger, SortedArray, } from "@itwin/core-bentley";
 import { GeoCoordStatus, IModelReadRpcInterface, } from "@itwin/core-common";
-// this class is used to cache results from conversion of geoCoordinates to IModelCoordinates.
-class GCtoIMCResultCache {
-    constructor(iModel, source) {
-        this._iModel = iModel;
-        this._cache = {};
-        this._source = source;
+import { FrontendLoggerCategory } from "./FrontendLoggerCategory";
+function compareXYAndZ(lhs, rhs) {
+    return lhs.x - rhs.x || lhs.y - rhs.y || lhs.z - rhs.z;
+}
+function cloneXYAndZ(xyz) {
+    return { x: xyz.x, y: xyz.y, z: xyz.z };
+}
+/** Performs conversion of coordinates from one coordinate system to another.
+ * A [[GeoConverter]] has a pair of these for converting between iModel coordinates and geographic coordinates.
+ * Uses a cache to avoid repeatedly requesting the same points, and a batching strategy to avoid making frequent small requests.
+ * The cache stores every point that was ever converted by [[convert]]. It is currently permitted to grow to unbounded size.
+ * The batching works as follows:
+ *  When a conversion is requested via [[convert]], if all the requested points are in the cache, they are returned immediately.
+ *  Otherwise, any points not in the cache and not in the current in-flight request (if any) are placed onto the queue of pending requests.
+ *  A pending request is scheduled if one hasn't already been scheduled, via requestAnimationFrame.
+ *  In the animation frame callback, the pending requests are split into batches of no more than options.maxPointsPerRequest and dispatched to the backend.
+ *  Once the response is received, the results are loaded into and returned from the cache.
+ *  If more calls to convert occurred while the request was in flight, another request is dispatched.
+ * @internal exported strictly for tests.
+ */
+export class CoordinateConverter {
+    constructor(opts) {
+        this._state = "idle";
+        // An event fired when the next request completes.
+        this._onCompleted = new BeEvent();
+        // Used for creating cache keys (XYAndZ) from XYZProps without having to allocate temporary objects.
+        this._scratchXYZ = { x: 0, y: 0, z: 0 };
+        this._maxPointsPerRequest = Math.max(1, opts.maxPointsPerRequest ?? 300);
+        this._iModel = opts.iModel;
+        this._requestPoints = opts.requestPoints;
+        this._cache = new Dictionary(compareXYAndZ, cloneXYAndZ);
+        this._pending = new SortedArray(compareXYAndZ, false, cloneXYAndZ);
+        this._inflight = new SortedArray(compareXYAndZ, false, cloneXYAndZ);
     }
-    /** @internal */
-    findInCache(geoPoints) {
-        const result = [];
-        let missing;
-        for (const geoPoint of geoPoints) {
-            const key = JSON.stringify(geoPoint);
-            const imodelCoord = this._cache[key];
-            result.push(imodelCoord);
-            if (undefined === imodelCoord) {
-                if (undefined === missing)
-                    missing = [];
-                missing.push(geoPoint);
-            }
+    toXYAndZ(input, output) {
+        if (Array.isArray(input)) {
+            output.x = input[0] ?? 0;
+            output.y = input[1] ?? 0;
+            output.z = input[2] ?? 0;
         }
-        return { result, missing };
-    }
-    async findInCacheOrRequest(request) {
-        const response = { iModelCoords: [], fromCache: 0 };
-        let missing;
-        // Index by cache key to obtain index in input array.
-        const originalPositions = {};
-        for (let iPoint = 0; iPoint < request.geoCoords.length; ++iPoint) {
-            const thisGeoCoord = request.geoCoords[iPoint];
-            // we use the JSON string as the key into our cache of previously returned results.
-            const thisCacheKey = JSON.stringify(thisGeoCoord);
-            // put something in each output that corresponds to the input.
-            if (this._cache[thisCacheKey]) {
-                response.iModelCoords.push(this._cache[thisCacheKey]);
-            }
-            else {
-                if (undefined === missing)
-                    missing = [];
-                // add this geoCoord to the request we are going to send.
-                missing.push(thisGeoCoord);
-                // keep track of the original position of this point.
-                if (originalPositions.hasOwnProperty(thisCacheKey)) {
-                    // it is a duplicate of an earlier point (or points)
-                    if (Array.isArray(originalPositions[thisCacheKey])) {
-                        originalPositions[thisCacheKey].push(iPoint);
-                    }
-                    else {
-                        const list = [originalPositions[thisCacheKey], iPoint];
-                        originalPositions[thisCacheKey] = list;
-                    }
-                }
-                else {
-                    originalPositions[thisCacheKey] = iPoint;
-                }
-                // mark the response as pending.
-                response.iModelCoords.push({ p: [0, 0, 0], s: GeoCoordStatus.Pending });
-            }
+        else {
+            output.x = input.x ?? 0;
+            output.y = input.y ?? 0;
+            output.z = input.z ?? 0;
         }
-        // if none are missing from the cache, resolve the promise immediately
-        if (undefined === missing) {
-            response.fromCache = request.geoCoords.length;
+        return output;
+    }
+    async dispatch() {
+        assert(this._state === "scheduled");
+        if (this._iModel.isClosed || this._pending.isEmpty) {
+            this._state = "idle";
+            this._onCompleted.raiseEvent();
+            return;
         }
-        else {
-            // keep track of how many came from the cache (mostly for tests).
-            response.fromCache = request.geoCoords.length - missing.length;
-            // Avoiding requesting too many points at once, exceeding max request length (this definition of "too many" should be safely conservative)  - but enough to load 4 levels of tile corners.
-            const maxPointsPerRequest = 300;
-            const promises = [];
-            for (let i = 0; i < missing.length; i += maxPointsPerRequest) {
-                const remainingRequest = { source: this._source, geoCoords: missing.slice(i, i + maxPointsPerRequest) };
-                const promise = IModelReadRpcInterface.getClientForRouting(this._iModel.routingContext.token).getIModelCoordinatesFromGeoCoordinates(this._iModel.getRpcProps(), remainingRequest).then((remainingResponse) => {
-                    // put the responses into the cache, and fill in the output response for each
-                    for (let iResponse = 0; iResponse < remainingResponse.iModelCoords.length; ++iResponse) {
-                        const thisPoint = remainingResponse.iModelCoords[iResponse];
-                        // put the answer in the cache.
-                        const thisGeoCoord = remainingRequest.geoCoords[iResponse];
-                        const thisCacheKey = JSON.stringify(thisGeoCoord);
-                        this._cache[thisCacheKey] = thisPoint;
-                        // transfer the answer stored in remainingResponse to the correct position in the overall response.
-                        const responseIndex = originalPositions[thisCacheKey];
-                        if (Array.isArray(responseIndex)) {
-                            for (const thisIndex of responseIndex) {
-                                response.iModelCoords[thisIndex] = thisPoint;
-                            }
-                        }
-                        else {
-                            response.iModelCoords[responseIndex] = thisPoint;
-                        }
-                    }
-                });
-                promises.push(promise);
-            }
-            await Promise.all(promises);
+        this._state = "in-flight";
+        // Ensure subsequently-enqueued requests listen for the *next* response to be received.
+        const onCompleted = this._onCompleted;
+        this._onCompleted = new BeEvent();
+        // Pending requests are now in flight. Start a new list of pending requests. It's cheaper to swap than to allocate new objects.
+        const inflight = this._pending;
+        this._pending = this._inflight;
+        assert(this._pending.isEmpty);
+        this._inflight = inflight;
+        // Split requests if necessary to avoid requesting more than the maximum allowed number of points.
+        const promises = [];
+        for (let i = 0; i < inflight.length; i += this._maxPointsPerRequest) {
+            const requests = inflight.slice(i, i + this._maxPointsPerRequest).extractArray();
+            const promise = this._requestPoints(requests).then((results) => {
+                if (this._iModel.isClosed)
+                    return;
+                if (results.length !== requests.length)
+                    Logger.logError(`${FrontendLoggerCategory.Package}.geoservices`, `requested conversion of ${requests.length} points, but received ${results.length} points`);
+                for (let j = 0; j < results.length; j++) {
+                    if (j < requests.length)
+                        this._cache.set(requests[j], results[j]);
+                }
+            }).catch((err) => {
+                Logger.logException(`${FrontendLoggerCategory.Package}.geoservices`, err);
+            });
+            promises.push(promise);
         }
-        return response;
+        await Promise.all(promises);
+        assert(this._state === "in-flight");
+        this._state = "idle";
+        this._inflight.clear();
+        // If any more pending conversions arrived while awaiting this request, schedule another request.
+        if (!this._pending.isEmpty)
+            this.scheduleDispatch(); // eslint-disable-line @typescript-eslint/no-floating-promises
+        // Resolve promises of all callers who were awaiting this request.
+        onCompleted.raiseEvent();
     }
-}
-// this class is used to cache results from conversion of IModelCoordinates to GeoCoordinates.
-class IMCtoGCResultCache {
-    constructor(iModel, target) {
-        this._iModel = iModel;
-        this._cache = {};
-        this._target = target;
+    // Add any points not present in cache to pending request list.
+    // Return the number of points present in cache.
+    enqueue(points) {
+        let numInCache = 0;
+        for (const point of points) {
+            const xyz = this.toXYAndZ(point, this._scratchXYZ);
+            if (this._cache.get(xyz))
+                ++numInCache;
+            else if (!this._inflight.contains(xyz))
+                this._pending.insert(xyz);
+        }
+        return numInCache;
     }
-    async findInCacheOrRequest(request) {
-        let missing = false;
-        const response = { geoCoords: [], fromCache: 0 };
-        let remainingRequest;
-        const originalPositions = [];
-        for (let iPoint = 0; iPoint < request.iModelCoords.length; ++iPoint) {
-            const thisIModelCoord = request.iModelCoords[iPoint];
-            // we use the JSON string as the key into our cache of previously returned results.
-            const thisCacheKey = JSON.stringify(thisIModelCoord);
-            // put something in each output that corresponds to the input.
-            if (this._cache[thisCacheKey]) {
-                response.geoCoords.push(this._cache[thisCacheKey]);
-            }
-            else {
-                if (!remainingRequest)
-                    remainingRequest = { target: this._target, iModelCoords: [] };
-                // add this geoCoord to the request we are going to send.
-                remainingRequest.iModelCoords.push(thisIModelCoord);
-                // keep track of the original position of this point.
-                originalPositions.push(iPoint);
-                // mark the response as pending.
-                response.geoCoords.push({ p: [0, 0, 0], s: GeoCoordStatus.Pending });
-                missing = true;
-            }
+    // Obtain converted points from the cache. The assumption is that every point in `inputs` is already present in the cache.
+    // Any point not present will be returned unconverted with an error status.
+    getFromCache(inputs) {
+        const outputs = [];
+        for (const input of inputs) {
+            const xyz = this.toXYAndZ(input, this._scratchXYZ);
+            let output = this._cache.get(xyz);
+            if (!output)
+                output = { p: { ...xyz }, s: GeoCoordStatus.CSMapError };
+            outputs.push(output);
         }
-        // if none are missing from the cache, resolve the promise immediately
-        if (!missing) {
-            response.fromCache = request.iModelCoords.length;
-            return response;
+        return outputs;
+    }
+    async scheduleDispatch() {
+        if ("idle" === this._state) {
+            this._state = "scheduled";
+            requestAnimationFrame(() => {
+                this.dispatch(); // eslint-disable-line @typescript-eslint/no-floating-promises
+            });
         }
-        else {
-            // keep track of how many came from the cache (mostly for tests).
-            response.fromCache = request.iModelCoords.length - originalPositions.length;
-            const remainingResponse = await IModelReadRpcInterface.getClientForRouting(this._iModel.routingContext.token).getGeoCoordinatesFromIModelCoordinates(this._iModel.getRpcProps(), remainingRequest);
-            // put the responses into the cache, and fill in the output response for each
-            for (let iResponse = 0; iResponse < remainingResponse.geoCoords.length; ++iResponse) {
-                const thisPoint = remainingResponse.geoCoords[iResponse];
-                // transfer the answer stored in remainingResponse to the correct position in the overall response.
-                const responseIndex = originalPositions[iResponse];
-                response.geoCoords[responseIndex] = thisPoint;
-                // put the answer in the cache.
-                const thisIModelCoord = remainingRequest.iModelCoords[iResponse];
-                const thisCacheKey = JSON.stringify(thisIModelCoord);
-                this._cache[thisCacheKey] = thisPoint;
+        return new Promise((resolve) => {
+            this._onCompleted.addOnce(() => resolve());
+        });
+    }
+    async convert(inputs) {
+        const fromCache = this.enqueue(inputs);
+        assert(fromCache >= 0);
+        assert(fromCache <= inputs.length);
+        if (fromCache === inputs.length)
+            return { points: this.getFromCache(inputs), fromCache };
+        await this.scheduleDispatch();
+        return { points: this.getFromCache(inputs), fromCache };
+    }
+    findCached(inputs) {
+        const result = [];
+        let missing;
+        for (const input of inputs) {
+            const key = this.toXYAndZ(input, this._scratchXYZ);
+            const output = this._cache.get(key);
+            result.push(output);
+            if (!output) {
+                if (!missing)
+                    missing = [];
+                missing.push(input);
             }
-            return response;
         }
+        return { result, missing };
     }
 }
 /** The GeoConverter class communicates with the backend to convert longitude/latitude coordinates to iModel coordinates and vice-versa
@@ -158,23 +163,42 @@ class IMCtoGCResultCache {
  */
 export class GeoConverter {
     constructor(iModel, datumOrGCRS) {
-        if (typeof (datumOrGCRS) === "object")
-            this._datumOrGCRS = JSON.stringify(datumOrGCRS);
-        else
-            this._datumOrGCRS = datumOrGCRS;
-        this._gCtoIMCResultCache = new GCtoIMCResultCache(iModel, this._datumOrGCRS);
-        this._iMCtoGCResultCache = new IMCtoGCResultCache(iModel, this._datumOrGCRS);
+        const datum = typeof datumOrGCRS === "object" ? JSON.stringify(datumOrGCRS) : datumOrGCRS;
+        this._geoToIModel = new CoordinateConverter({
+            iModel,
+            requestPoints: async (geoCoords) => {
+                const request = { source: datum, geoCoords };
+                const rpc = IModelReadRpcInterface.getClientForRouting(iModel.routingContext.token);
+                const response = await rpc.getIModelCoordinatesFromGeoCoordinates(iModel.getRpcProps(), request);
+                return response.iModelCoords;
+            },
+        });
+        this._iModelToGeo = new CoordinateConverter({
+            iModel,
+            requestPoints: async (iModelCoords) => {
+                const request = { target: datum, iModelCoords };
+                const rpc = IModelReadRpcInterface.getClientForRouting(iModel.routingContext.token);
+                const response = await rpc.getGeoCoordinatesFromIModelCoordinates(iModel.getRpcProps(), request);
+                return response.geoCoords;
+            },
+        });
     }
     async getIModelCoordinatesFromGeoCoordinates(geoPoints) {
-        const requestProps = { source: this._datumOrGCRS, geoCoords: geoPoints };
-        return this._gCtoIMCResultCache.findInCacheOrRequest(requestProps);
-    }
-    getCachedIModelCoordinatesFromGeoCoordinates(geoPoints) {
-        return this._gCtoIMCResultCache.findInCache(geoPoints);
+        const result = await this._geoToIModel.convert(geoPoints);
+        return {
+            iModelCoords: result.points,
+            fromCache: result.fromCache,
+        };
     }
     async getGeoCoordinatesFromIModelCoordinates(iModelPoints) {
-        const requestProps = { target: this._datumOrGCRS, iModelCoords: iModelPoints };
-        return this._iMCtoGCResultCache.findInCacheOrRequest(requestProps);
+        const result = await this._iModelToGeo.convert(iModelPoints);
+        return {
+            geoCoords: result.points,
+            fromCache: result.fromCache,
+        };
+    }
+    getCachedIModelCoordinatesFromGeoCoordinates(geoPoints) {
+        return this._geoToIModel.findCached(geoPoints);
     }
 }
 /** The Geographic Services available for an [[IModelConnection]].

package/lib/esm/GeoServices.js.map

@@ -1 +1 @@
-{"version":3,"file":"GeoServices.js","sourceRoot":"","sources":["../../src/GeoServices.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// cspell:ignore GCRS\r\nimport { XYZProps } from \"@itwin/core-geometry\";\r\nimport {\r\n  GeoCoordinatesRequestProps, GeoCoordinatesResponseProps, GeoCoordStatus, GeographicCRSProps, IModelCoordinatesRequestProps, IModelCoordinatesResponseProps,\r\n  IModelReadRpcInterface, PointWithStatus,\r\n} from \"@itwin/core-common\";\r\nimport { IModelConnection } from \"./IModelConnection\";\r\n\r\n/** Response to a request to obtain imodel coordinates from cache.\r\n * @internal\r\n */\r\nexport interface CachedIModelCoordinatesResponseProps {\r\n  /** An array of the same length as the input array, with undefined entries at indices corresponding to points not found in cache. */\r\n  result: Array<PointWithStatus | undefined>;\r\n  /** An array of points in the input array which were not found in the cache, or undefined if all points were found in the cache. */\r\n  missing?: XYZProps[];\r\n}\r\n\r\n// this class is used to cache results from conversion of geoCoordinates to IModelCoordinates.\r\nclass GCtoIMCResultCache {\r\n  // see fast-memoize npm package where the author demonstrated that an object is the fastest\r\n  //     lookup (faster than Map), and JSON.stringify is the fastest serializer.\r\n  private _cache: any;\r\n  private _iModel: IModelConnection;\r\n  private _source: string;\r\n\r\n  constructor(iModel: IModelConnection, source: string) {\r\n    this._iModel = iModel;\r\n    this._cache = {};\r\n    this._source = source;\r\n  }\r\n\r\n  /** @internal */\r\n  public findInCache(geoPoints: XYZProps[]): CachedIModelCoordinatesResponseProps {\r\n    const result: Array<PointWithStatus | undefined> = [];\r\n    let missing: XYZProps[] | undefined;\r\n    for (const geoPoint of geoPoints) {\r\n      const key = JSON.stringify(geoPoint);\r\n      const imodelCoord = this._cache[key];\r\n      result.push(imodelCoord);\r\n      if (undefined === imodelCoord) {\r\n        if (undefined === missing)\r\n          missing = [];\r\n\r\n        missing.push(geoPoint);\r\n      }\r\n    }\r\n\r\n    return { result, missing };\r\n  }\r\n\r\n  public async findInCacheOrRequest(request: IModelCoordinatesRequestProps): Promise<IModelCoordinatesResponseProps> {\r\n    const response: IModelCoordinatesResponseProps = { iModelCoords: [], fromCache: 0 };\r\n    let missing: XYZProps[] | undefined;\r\n\r\n    // Index by cache key to obtain index in input array.\r\n    const originalPositions: any = {};\r\n\r\n    for (let iPoint: number = 0; iPoint < request.geoCoords.length; ++iPoint) {\r\n      const thisGeoCoord: XYZProps = request.geoCoords[iPoint];\r\n\r\n      // we use the JSON string as the key into our cache of previously returned results.\r\n      const thisCacheKey: string = JSON.stringify(thisGeoCoord);\r\n\r\n      // put something in each output that corresponds to the input.\r\n      if (this._cache[thisCacheKey]) {\r\n        response.iModelCoords.push(this._cache[thisCacheKey]);\r\n      } else {\r\n        if (undefined === missing)\r\n          missing = [];\r\n\r\n        // add this geoCoord to the request we are going to send.\r\n        missing.push(thisGeoCoord);\r\n\r\n        // keep track of the original position of this point.\r\n        if (originalPositions.hasOwnProperty(thisCacheKey)) {\r\n          // it is a duplicate of an earlier point (or points)\r\n          if (Array.isArray(originalPositions[thisCacheKey])) {\r\n            originalPositions[thisCacheKey].push(iPoint);\r\n          } else {\r\n            const list: number[] = [originalPositions[thisCacheKey], iPoint];\r\n            originalPositions[thisCacheKey] = list;\r\n          }\r\n        } else {\r\n          originalPositions[thisCacheKey] = iPoint;\r\n        }\r\n\r\n        // mark the response as pending.\r\n        response.iModelCoords.push({ p: [0, 0, 0], s: GeoCoordStatus.Pending });\r\n      }\r\n    }\r\n\r\n    // if none are missing from the cache, resolve the promise immediately\r\n    if (undefined === missing) {\r\n      response.fromCache = request.geoCoords.length;\r\n    } else {\r\n      // keep track of how many came from the cache (mostly for tests).\r\n      response.fromCache = request.geoCoords.length - missing.length;\r\n\r\n      // Avoiding requesting too many points at once, exceeding max request length (this definition of \"too many\" should be safely conservative)  - but enough to load 4 levels of tile corners.\r\n      const maxPointsPerRequest = 300;\r\n      const promises: Array<Promise<void>> = [];\r\n      for (let i = 0; i < missing.length; i += maxPointsPerRequest) {\r\n        const remainingRequest = { source: this._source, geoCoords: missing.slice(i, i + maxPointsPerRequest) };\r\n        const promise = IModelReadRpcInterface.getClientForRouting(this._iModel.routingContext.token).getIModelCoordinatesFromGeoCoordinates(this._iModel.getRpcProps(), remainingRequest).then((remainingResponse) => {\r\n          // put the responses into the cache, and fill in the output response for each\r\n          for (let iResponse: number = 0; iResponse < remainingResponse.iModelCoords.length; ++iResponse) {\r\n            const thisPoint: PointWithStatus = remainingResponse.iModelCoords[iResponse];\r\n\r\n            // put the answer in the cache.\r\n            const thisGeoCoord: XYZProps = remainingRequest.geoCoords[iResponse];\r\n            const thisCacheKey: string = JSON.stringify(thisGeoCoord);\r\n            this._cache[thisCacheKey] = thisPoint;\r\n\r\n            // transfer the answer stored in remainingResponse to the correct position in the overall response.\r\n            const responseIndex = originalPositions[thisCacheKey];\r\n            if (Array.isArray(responseIndex)) {\r\n              for (const thisIndex of responseIndex) {\r\n                response.iModelCoords[thisIndex] = thisPoint;\r\n              }\r\n            } else {\r\n              response.iModelCoords[responseIndex] = thisPoint;\r\n            }\r\n          }\r\n        });\r\n\r\n        promises.push(promise);\r\n      }\r\n\r\n      await Promise.all(promises);\r\n    }\r\n\r\n    return response;\r\n  }\r\n}\r\n\r\n// this class is used to cache results from conversion of IModelCoordinates to GeoCoordinates.\r\nclass IMCtoGCResultCache {\r\n  // see fast-memoize npm package where the author demonstrated that an object is the fastest\r\n  //     lookup (faster than Map), and JSON.stringify is the fastest serializer.\r\n  private _cache: any;\r\n  private _iModel: IModelConnection;\r\n  private _target: string;\r\n\r\n  constructor(iModel: IModelConnection, target: string) {\r\n    this._iModel = iModel;\r\n    this._cache = {};\r\n    this._target = target;\r\n  }\r\n\r\n  public async findInCacheOrRequest(request: GeoCoordinatesRequestProps): Promise<GeoCoordinatesResponseProps> {\r\n    let missing: boolean = false;\r\n    const response: GeoCoordinatesResponseProps = { geoCoords: [], fromCache: 0 };\r\n    let remainingRequest: GeoCoordinatesRequestProps | undefined;\r\n    const originalPositions: number[] = [];\r\n\r\n    for (let iPoint = 0; iPoint < request.iModelCoords.length; ++iPoint) {\r\n      const thisIModelCoord = request.iModelCoords[iPoint];\r\n\r\n      // we use the JSON string as the key into our cache of previously returned results.\r\n      const thisCacheKey = JSON.stringify(thisIModelCoord);\r\n\r\n      // put something in each output that corresponds to the input.\r\n      if (this._cache[thisCacheKey]) {\r\n        response.geoCoords.push(this._cache[thisCacheKey]);\r\n      } else {\r\n        if (!remainingRequest)\r\n          remainingRequest = { target: this._target, iModelCoords: [] };\r\n\r\n        // add this geoCoord to the request we are going to send.\r\n        remainingRequest.iModelCoords.push(thisIModelCoord);\r\n        // keep track of the original position of this point.\r\n        originalPositions.push(iPoint);\r\n\r\n        // mark the response as pending.\r\n        response.geoCoords.push({ p: [0, 0, 0], s: GeoCoordStatus.Pending });\r\n\r\n        missing = true;\r\n      }\r\n    }\r\n\r\n    // if none are missing from the cache, resolve the promise immediately\r\n    if (!missing) {\r\n      response.fromCache = request.iModelCoords.length;\r\n      return response;\r\n    } else {\r\n      // keep track of how many came from the cache (mostly for tests).\r\n      response.fromCache = request.iModelCoords.length - originalPositions.length;\r\n      const remainingResponse = await IModelReadRpcInterface.getClientForRouting(this._iModel.routingContext.token).getGeoCoordinatesFromIModelCoordinates(this._iModel.getRpcProps(), remainingRequest!);\r\n      // put the responses into the cache, and fill in the output response for each\r\n      for (let iResponse = 0; iResponse < remainingResponse.geoCoords.length; ++iResponse) {\r\n        const thisPoint: PointWithStatus = remainingResponse.geoCoords[iResponse];\r\n\r\n        // transfer the answer stored in remainingResponse to the correct position in the overall response.\r\n        const responseIndex = originalPositions[iResponse];\r\n        response.geoCoords[responseIndex] = thisPoint;\r\n\r\n        // put the answer in the cache.\r\n        const thisIModelCoord = remainingRequest!.iModelCoords[iResponse];\r\n        const thisCacheKey = JSON.stringify(thisIModelCoord);\r\n        this._cache[thisCacheKey] = thisPoint;\r\n      }\r\n      return response;\r\n    }\r\n  }\r\n}\r\n\r\n/** The GeoConverter class communicates with the backend to convert longitude/latitude coordinates to iModel coordinates and vice-versa\r\n * @internal\r\n */\r\nexport class GeoConverter {\r\n  private _datumOrGCRS: string;\r\n  private _gCtoIMCResultCache: GCtoIMCResultCache;\r\n  private _iMCtoGCResultCache: IMCtoGCResultCache;\r\n  constructor(iModel: IModelConnection, datumOrGCRS: string | GeographicCRSProps) {\r\n    if (typeof (datumOrGCRS) === \"object\")\r\n      this._datumOrGCRS = JSON.stringify(datumOrGCRS);\r\n    else\r\n      this._datumOrGCRS = datumOrGCRS;\r\n    this._gCtoIMCResultCache = new GCtoIMCResultCache(iModel, this._datumOrGCRS);\r\n    this._iMCtoGCResultCache = new IMCtoGCResultCache(iModel, this._datumOrGCRS);\r\n  }\r\n\r\n  public async getIModelCoordinatesFromGeoCoordinates(geoPoints: XYZProps[]): Promise<IModelCoordinatesResponseProps> {\r\n    const requestProps: IModelCoordinatesRequestProps = { source: this._datumOrGCRS, geoCoords: geoPoints };\r\n    return this._gCtoIMCResultCache.findInCacheOrRequest(requestProps);\r\n  }\r\n\r\n  public getCachedIModelCoordinatesFromGeoCoordinates(geoPoints: XYZProps[]): CachedIModelCoordinatesResponseProps {\r\n    return this._gCtoIMCResultCache.findInCache(geoPoints);\r\n  }\r\n\r\n  public async getGeoCoordinatesFromIModelCoordinates(iModelPoints: XYZProps[]): Promise<GeoCoordinatesResponseProps> {\r\n    const requestProps: GeoCoordinatesRequestProps = { target: this._datumOrGCRS, iModelCoords: iModelPoints };\r\n    return this._iMCtoGCResultCache.findInCacheOrRequest(requestProps);\r\n  }\r\n}\r\n\r\n/** The Geographic Services available for an [[IModelConnection]].\r\n * @internal\r\n */\r\nexport class GeoServices {\r\n  private _iModel: IModelConnection;\r\n\r\n  constructor(iModel: IModelConnection) {\r\n    this._iModel = iModel;\r\n  }\r\n\r\n  public getConverter(datumOrGCRS?: string | GeographicCRSProps): GeoConverter | undefined {\r\n    return this._iModel.isOpen ? new GeoConverter(this._iModel, datumOrGCRS ? datumOrGCRS : \"\") : undefined;\r\n  }\r\n}\r\n"]}
+{"version":3,"file":"GeoServices.js","sourceRoot":"","sources":["../../src/GeoServices.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// cspell:ignore GCRS\r\nimport {\r\n  assert, BeEvent, Dictionary, Logger, SortedArray,\r\n} from \"@itwin/core-bentley\";\r\nimport { WritableXYAndZ, XYAndZ, XYZProps } from \"@itwin/core-geometry\";\r\nimport {\r\n  GeoCoordinatesResponseProps, GeoCoordStatus, GeographicCRSProps, IModelCoordinatesResponseProps, IModelReadRpcInterface, PointWithStatus,\r\n} from \"@itwin/core-common\";\r\nimport { IModelConnection } from \"./IModelConnection\";\r\nimport { FrontendLoggerCategory } from \"./FrontendLoggerCategory\";\r\n\r\n/** Options used to create a [[CoordinateConverter]].\r\n * @internal exported strictly for tests.\r\n */\r\nexport interface CoordinateConverterOptions {\r\n  /** The iModel for which to perform the conversions. */\r\n  iModel: IModelConnection;\r\n  /** Asynchronously convert each point. The resultant array should have the same number and order of points as the input. */\r\n  requestPoints: (points: XYAndZ[]) => Promise<PointWithStatus[]>;\r\n  /** Maximum number of points to include in each request. Default: 300. */\r\n  maxPointsPerRequest?: number;\r\n}\r\n\r\nfunction compareXYAndZ(lhs: XYAndZ, rhs: XYAndZ): number {\r\n  return lhs.x - rhs.x || lhs.y - rhs.y || lhs.z - rhs.z;\r\n}\r\n\r\nfunction cloneXYAndZ(xyz: XYAndZ): XYAndZ {\r\n  return { x: xyz.x, y: xyz.y, z: xyz.z };\r\n}\r\n\r\ntype CoordinateConverterState =\r\n  // No pending requests.\r\n  \"idle\" |\r\n  // We have scheduled a requestAnimationFrame to dispatch all pending requests.\r\n  \"scheduled\" |\r\n  // We have dispatched all requests that were pending at the most recent requestAnimationFrame callback.\r\n  \"in-flight\";\r\n\r\n/** Performs conversion of coordinates from one coordinate system to another.\r\n * A [[GeoConverter]] has a pair of these for converting between iModel coordinates and geographic coordinates.\r\n * Uses a cache to avoid repeatedly requesting the same points, and a batching strategy to avoid making frequent small requests.\r\n * The cache stores every point that was ever converted by [[convert]]. It is currently permitted to grow to unbounded size.\r\n * The batching works as follows:\r\n *  When a conversion is requested via [[convert]], if all the requested points are in the cache, they are returned immediately.\r\n *  Otherwise, any points not in the cache and not in the current in-flight request (if any) are placed onto the queue of pending requests.\r\n *  A pending request is scheduled if one hasn't already been scheduled, via requestAnimationFrame.\r\n *  In the animation frame callback, the pending requests are split into batches of no more than options.maxPointsPerRequest and dispatched to the backend.\r\n *  Once the response is received, the results are loaded into and returned from the cache.\r\n *  If more calls to convert occurred while the request was in flight, another request is dispatched.\r\n * @internal exported strictly for tests.\r\n */\r\nexport class CoordinateConverter {\r\n  protected readonly _cache: Dictionary<XYAndZ, PointWithStatus>;\r\n  protected _state: CoordinateConverterState = \"idle\";\r\n  // The accumulated set of points to be converted by the next request.\r\n  protected _pending: SortedArray<XYAndZ>;\r\n  // The set of points that were included in the current in-flight request, if any.\r\n  protected _inflight: SortedArray<XYAndZ>;\r\n  // An event fired when the next request completes.\r\n  protected _onCompleted = new BeEvent<() => void>();\r\n  // Used for creating cache keys (XYAndZ) from XYZProps without having to allocate temporary objects.\r\n  protected readonly _scratchXYZ = { x: 0, y: 0, z: 0 };\r\n  protected readonly _maxPointsPerRequest: number;\r\n  protected readonly _iModel: IModelConnection;\r\n  protected readonly _requestPoints: (points: XYAndZ[]) => Promise<PointWithStatus[]>;\r\n\r\n  protected toXYAndZ(input: XYZProps, output: WritableXYAndZ): XYAndZ {\r\n    if (Array.isArray(input)) {\r\n      output.x = input[0] ?? 0;\r\n      output.y = input[1] ?? 0;\r\n      output.z = input[2] ?? 0;\r\n    } else {\r\n      output.x = input.x ?? 0;\r\n      output.y = input.y ?? 0;\r\n      output.z = input.z ?? 0;\r\n    }\r\n\r\n    return output;\r\n  }\r\n\r\n  public constructor(opts: CoordinateConverterOptions) {\r\n    this._maxPointsPerRequest = Math.max(1, opts.maxPointsPerRequest ?? 300);\r\n    this._iModel = opts.iModel;\r\n    this._requestPoints = opts.requestPoints;\r\n\r\n    this._cache = new Dictionary<XYAndZ, PointWithStatus>(compareXYAndZ, cloneXYAndZ);\r\n    this._pending = new SortedArray<XYAndZ>(compareXYAndZ, false, cloneXYAndZ);\r\n    this._inflight = new SortedArray<XYAndZ>(compareXYAndZ, false, cloneXYAndZ);\r\n  }\r\n\r\n  protected async dispatch(): Promise<void> {\r\n    assert(this._state === \"scheduled\");\r\n    if (this._iModel.isClosed || this._pending.isEmpty) {\r\n      this._state = \"idle\";\r\n      this._onCompleted.raiseEvent();\r\n      return;\r\n    }\r\n\r\n    this._state = \"in-flight\";\r\n\r\n    // Ensure subsequently-enqueued requests listen for the *next* response to be received.\r\n    const onCompleted = this._onCompleted;\r\n    this._onCompleted = new BeEvent<() => void>();\r\n\r\n    // Pending requests are now in flight. Start a new list of pending requests. It's cheaper to swap than to allocate new objects.\r\n    const inflight = this._pending;\r\n    this._pending = this._inflight;\r\n    assert(this._pending.isEmpty);\r\n    this._inflight = inflight;\r\n\r\n    // Split requests if necessary to avoid requesting more than the maximum allowed number of points.\r\n    const promises: Array<Promise<void>> = [];\r\n    for (let i = 0; i < inflight.length; i += this._maxPointsPerRequest) {\r\n      const requests = inflight.slice(i, i + this._maxPointsPerRequest).extractArray();\r\n      const promise = this._requestPoints(requests).then((results) => {\r\n        if (this._iModel.isClosed)\r\n          return;\r\n\r\n        if (results.length !== requests.length)\r\n          Logger.logError(`${FrontendLoggerCategory.Package}.geoservices`, `requested conversion of ${requests.length} points, but received ${results.length} points`);\r\n\r\n        for (let j = 0; j < results.length; j++) {\r\n          if (j < requests.length)\r\n            this._cache.set(requests[j], results[j]);\r\n        }\r\n      }).catch((err) => {\r\n        Logger.logException(`${FrontendLoggerCategory.Package}.geoservices`, err);\r\n      });\r\n\r\n      promises.push(promise);\r\n    }\r\n\r\n    await Promise.all(promises);\r\n\r\n    assert(this._state === \"in-flight\");\r\n    this._state = \"idle\";\r\n    this._inflight.clear();\r\n\r\n    // If any more pending conversions arrived while awaiting this request, schedule another request.\r\n    if (!this._pending.isEmpty)\r\n      this.scheduleDispatch(); // eslint-disable-line @typescript-eslint/no-floating-promises\r\n\r\n    // Resolve promises of all callers who were awaiting this request.\r\n    onCompleted.raiseEvent();\r\n  }\r\n\r\n  // Add any points not present in cache to pending request list.\r\n  // Return the number of points present in cache.\r\n  protected enqueue(points: XYZProps[]): number {\r\n    let numInCache = 0;\r\n    for (const point of points) {\r\n      const xyz = this.toXYAndZ(point, this._scratchXYZ);\r\n      if (this._cache.get(xyz))\r\n        ++numInCache;\r\n      else if (!this._inflight.contains(xyz))\r\n        this._pending.insert(xyz);\r\n    }\r\n\r\n    return numInCache;\r\n  }\r\n\r\n  // Obtain converted points from the cache. The assumption is that every point in `inputs` is already present in the cache.\r\n  // Any point not present will be returned unconverted with an error status.\r\n  protected getFromCache(inputs: XYZProps[]): PointWithStatus[] {\r\n    const outputs: PointWithStatus[] = [];\r\n    for (const input of inputs) {\r\n      const xyz = this.toXYAndZ(input, this._scratchXYZ);\r\n      let output = this._cache.get(xyz);\r\n      if (!output)\r\n        output = { p: { ...xyz }, s: GeoCoordStatus.CSMapError };\r\n\r\n      outputs.push(output);\r\n    }\r\n\r\n    return outputs;\r\n  }\r\n\r\n  protected async scheduleDispatch(): Promise<void> {\r\n    if (\"idle\" === this._state) {\r\n      this._state = \"scheduled\";\r\n      requestAnimationFrame(() => {\r\n        this.dispatch(); // eslint-disable-line @typescript-eslint/no-floating-promises\r\n      });\r\n    }\r\n\r\n    return new Promise((resolve) => {\r\n      this._onCompleted.addOnce(() => resolve());\r\n    });\r\n  }\r\n\r\n  public async convert(inputs: XYZProps[]): Promise<{ points: PointWithStatus[], fromCache: number }> {\r\n    const fromCache = this.enqueue(inputs);\r\n    assert(fromCache >= 0);\r\n    assert(fromCache <= inputs.length);\r\n\r\n    if (fromCache === inputs.length)\r\n      return { points: this.getFromCache(inputs), fromCache };\r\n\r\n    await this.scheduleDispatch();\r\n\r\n    return { points: this.getFromCache(inputs), fromCache };\r\n  }\r\n\r\n  public findCached(inputs: XYZProps[]): CachedIModelCoordinatesResponseProps {\r\n    const result: Array<PointWithStatus | undefined> = [];\r\n    let missing: XYZProps[] | undefined;\r\n    for (const input of inputs) {\r\n      const key = this.toXYAndZ(input, this._scratchXYZ);\r\n      const output = this._cache.get(key);\r\n      result.push(output);\r\n      if (!output) {\r\n        if (!missing)\r\n          missing = [];\r\n\r\n        missing.push(input);\r\n      }\r\n    }\r\n\r\n    return { result, missing };\r\n  }\r\n}\r\n\r\n/** Response to a request to obtain imodel coordinates from cache.\r\n * @internal\r\n */\r\nexport interface CachedIModelCoordinatesResponseProps {\r\n  /** An array of the same length as the input array, with undefined entries at indices corresponding to points not found in cache. */\r\n  result: Array<PointWithStatus | undefined>;\r\n  /** An array of points in the input array which were not found in the cache, or undefined if all points were found in the cache. */\r\n  missing?: XYZProps[];\r\n}\r\n\r\n/** The GeoConverter class communicates with the backend to convert longitude/latitude coordinates to iModel coordinates and vice-versa\r\n * @internal\r\n */\r\nexport class GeoConverter {\r\n  private readonly _geoToIModel: CoordinateConverter;\r\n  private readonly _iModelToGeo: CoordinateConverter;\r\n\r\n  constructor(iModel: IModelConnection, datumOrGCRS: string | GeographicCRSProps) {\r\n    const datum = typeof datumOrGCRS === \"object\" ? JSON.stringify(datumOrGCRS) : datumOrGCRS;\r\n\r\n    this._geoToIModel = new CoordinateConverter({\r\n      iModel,\r\n      requestPoints: async (geoCoords: XYAndZ[]) => {\r\n        const request = { source: datum, geoCoords };\r\n        const rpc = IModelReadRpcInterface.getClientForRouting(iModel.routingContext.token);\r\n        const response = await rpc.getIModelCoordinatesFromGeoCoordinates(iModel.getRpcProps(), request);\r\n        return response.iModelCoords;\r\n      },\r\n    });\r\n\r\n    this._iModelToGeo = new CoordinateConverter({\r\n      iModel,\r\n      requestPoints: async (iModelCoords: XYAndZ[]) => {\r\n        const request = { target: datum, iModelCoords };\r\n        const rpc = IModelReadRpcInterface.getClientForRouting(iModel.routingContext.token);\r\n        const response = await rpc.getGeoCoordinatesFromIModelCoordinates(iModel.getRpcProps(), request);\r\n        return response.geoCoords;\r\n      },\r\n    });\r\n  }\r\n\r\n  public async getIModelCoordinatesFromGeoCoordinates(geoPoints: XYZProps[]): Promise<IModelCoordinatesResponseProps> {\r\n    const result = await this._geoToIModel.convert(geoPoints);\r\n    return {\r\n      iModelCoords: result.points,\r\n      fromCache: result.fromCache,\r\n    };\r\n  }\r\n\r\n  public async getGeoCoordinatesFromIModelCoordinates(iModelPoints: XYZProps[]): Promise<GeoCoordinatesResponseProps> {\r\n    const result = await this._iModelToGeo.convert(iModelPoints);\r\n    return {\r\n      geoCoords: result.points,\r\n      fromCache: result.fromCache,\r\n    };\r\n  }\r\n\r\n  public getCachedIModelCoordinatesFromGeoCoordinates(geoPoints: XYZProps[]): CachedIModelCoordinatesResponseProps {\r\n    return this._geoToIModel.findCached(geoPoints);\r\n  }\r\n}\r\n\r\n/** The Geographic Services available for an [[IModelConnection]].\r\n * @internal\r\n */\r\nexport class GeoServices {\r\n  private _iModel: IModelConnection;\r\n\r\n  constructor(iModel: IModelConnection) {\r\n    this._iModel = iModel;\r\n  }\r\n\r\n  public getConverter(datumOrGCRS?: string | GeographicCRSProps): GeoConverter | undefined {\r\n    return this._iModel.isOpen ? new GeoConverter(this._iModel, datumOrGCRS ? datumOrGCRS : \"\") : undefined;\r\n  }\r\n}\r\n"]}

package/lib/esm/IModelApp.d.ts

@@ -179,9 +179,7 @@ export declare class IModelApp {
      * @internal
      */
     static get mapLayerFormatRegistry(): MapLayerFormatRegistry;
-    /** The [[TerrainProviderRegistry]] for this session.
-     * @beta
-     */
+    /** The [[TerrainProviderRegistry]] for this session. */
     static get terrainProviderRegistry(): TerrainProviderRegistry;
     /** The [[RealityDataSourceProviderRegistry]] for this session.
      * @alpha

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

@@ -1 +1 @@
-{"version":3,"file":"IModelApp.d.ts","sourceRoot":"","sources":["../../src/IModelApp.ts"],"names":[],"mappings":"AAIA;;GAEG;AAEH,cAAc;AAEd,eAAO,MAAM,oBAAoB,QAAkD,CAAC;AAGpF,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,OAAO,EAA0C,UAAU,EAA2B,MAAM,qBAAqB,CAAC;AACpJ,OAAO,EACL,mBAAmB,EAAgB,YAAY,EAAE,iBAAiB,EAAoB,sBAAsB,EAC7G,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAA4B,4BAA4B,EAAE,MAAM,4BAA4B,CAAC;AACpG,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAGtC,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAG5D,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAIxD,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,yCAAyC,CAAC;AAC5E,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAIrD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,iCAAiC,EAAE,MAAM,qBAAqB,CAAC;AACxE,OAAO,EAAE,sBAAsB,EAAE,eAAe,EAAE,uBAAuB,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAM9G,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAE9C,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAQ5C;;;GAGG;AACH,MAAM,WAAW,uBAAuB;IACtC,qEAAqE;IACrE,QAAQ,CAAC,cAAc,CAAC,EAAE;QACxB,6JAA6J;QAC7J,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;QAC1B,8BAA8B;QAC9B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;QAC7B,gCAAgC;QAChC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;KAC9B,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,uEAAuE;IACvE,SAAS,CAAC,EAAE,iBAAiB,CAAC;IAC9B,uJAAuJ;IACvJ,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,2FAA2F;IAC3F,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B;;OAEG;IACH,eAAe,CAAC,EAAE,qBAAqB,CAAC;IACxC,iEAAiE;IACjE,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B;;OAEG;IACH,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,uGAAuG;IACvG,SAAS,CAAC,EAAE,SAAS,CAAC,KAAK,CAAC;IAC5B,yEAAyE;IACzE,aAAa,CAAC,EAAE,mBAAmB,CAAC;IACpC,+DAA+D;IAC/D,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB;;OAEG;IACH,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,8DAA8D;IAC9D,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,0GAA0G;IAC1G,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,uEAAuE;IACvE,mBAAmB,CAAC,EAAE,mBAAmB,CAAC;IAC1C,8DAA8D;IAC9D,QAAQ,CAAC,EAAE,uBAAuB,CAAC;IACnC,gBAAgB;IAChB,SAAS,CAAC,EAAE,UAAU,CAAC;IACvB,gBAAgB;IAChB,aAAa,CAAC,EAAE,oBAAoB,CAAC;IACrC,gBAAgB;IAChB,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,gBAAgB;IAChB,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;IACtC,0HAA0H;IAC1H,SAAS,CAAC,EAAE,YAAY,GAAG,YAAY,CAAC,OAAO,CAAC;IAChD,6DAA6D;IAC7D,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,aAAa,CAAC,EAAE,sBAAsB,EAAE,CAAC;IACzC,YAAY;IACZ,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;IACtC;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,sCAAsC;IACtC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,0GAA0G;IAC1G,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,gEAAgE;IAChE,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,+FAA+F;IAC/F,OAAO,CAAC,EAAE,WAAW,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,wCAAwC;IACxC,KAAK,EAAE,cAAc,CAAC;IACtB,8IAA8I;IAC9I,IAAI,EAAE,CAAC,GAAG,EAAE,KAAK,KAAK,IAAI,CAAC;CAC5B;AASD;;;;;;;;GAQG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,MAAM,CAAC,YAAY,CAAS;IACpC,OAAO,CAAC,MAAM,CAAC,SAAS,CAAW;IACnC,OAAO,CAAC,MAAM,CAAC,SAAS,CAAW;IACnC,OAAO,CAAC,MAAM,CAAC,cAAc,CAAS;IACtC,OAAO,CAAC,MAAM,CAAC,mBAAmB,CAAS;IAC3C,OAAO,CAAC,MAAM,CAAC,aAAa,CAAe;IAC3C,OAAO,CAAC,MAAM,CAAC,cAAc,CAAuB;IACpD,OAAO,CAAC,MAAM,CAAC,cAAc,CAAsB;IACnD,OAAO,CAAC,MAAM,CAAC,kBAAkB,CAAoB;IACrD,OAAO,CAAC,MAAM,CAAC,aAAa,CAAC,CAAe;IAC5C,OAAO,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAwB;IACxD,OAAO,CAAC,MAAM,CAAC,eAAe,CAAiB;IAC/C,OAAO,CAAC,MAAM,CAAC,UAAU,CAAY;IACrC,OAAO,CAAC,MAAM,CAAC,UAAU,CAAY;IACrC,OAAO,CAAC,MAAM,CAAC,YAAY,CAAc;IACzC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAU;IACjC,OAAO,CAAC,MAAM,CAAC,SAAS,CAAU;IAClC,OAAO,CAAC,MAAM,CAAC,cAAc,CAAS;IACtC,OAAO,CAAC,MAAM,CAAC,mBAAmB,CAAS;IAC3C,OAAO,CAAC,MAAM,CAAC,kBAAkB,CAAqD;IACtF,OAAO,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAS;IAC7C,OAAO,CAAC,MAAM,CAAC,gBAAgB,CAA0B;IACzD,OAAO,CAAC,MAAM,CAAC,uBAAuB,CAAyB;IAC/D,OAAO,CAAC,MAAM,CAAC,wBAAwB,CAA0B;IACjE,OAAO,CAAC,MAAM,CAAC,2BAA2B,CAAoC;IAC9E,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,CAAoB;IAC9C,OAAO,CAAC,MAAM,CAAC,kBAAkB,CAAC,CAAoB;IACtD,OAAO,CAAC,MAAM,CAAC,WAAW,CAAS;IAGnC,SAAS;IAET,yEAAyE;IACzE,gBAAuB,gBAAgB,gBAAqB,IAAI,EAAI;IAEpE;;OAEG;IACH,gBAAuB,cAAc,gBAAqB,IAAI,EAAI;IAElE,uEAAuE;IACvE,OAAc,mBAAmB,CAAC,EAAE,mBAAmB,CAAC;IACxD,6CAA6C;IAC7C,gBAAuB,KAAK,eAAsB;IAClD,kCAAkC;IAClC,OAAc,SAAS,EAAE,UAAU,CAAC;IACpC;;OAEG;IACH,WAAkB,sBAAsB,IAAI,sBAAsB,CAAyC;IAC3G;;OAEG;IACH,WAAkB,uBAAuB,IAAI,uBAAuB,CAA0C;IAC9G;;OAEG;IACH,WAAkB,0BAA0B,IAAI,iCAAiC,CAA6C;IAC9H,6CAA6C;IAC7C,WAAkB,YAAY,IAAI,YAAY,CAAgC;IAC9E,4CAA4C;IAC5C,WAAkB,WAAW,IAAI,WAAW,CAA8B;IAC1E,oDAAoD;IACpD,WAAkB,aAAa,IAAI,mBAAmB,CAAgC;IACtF,0CAA0C;IAC1C,WAAkB,SAAS,IAAI,SAAS,CAA4B;IACpE,kDAAkD;IAClD,WAAkB,iBAAiB,IAAI,iBAAiB,CAAoC;IAC5F,0CAA0C;IAC1C,WAAkB,SAAS,IAAI,SAAS,CAA4B;IACpE;;OAEG;IACH,WAAkB,QAAQ,IAAI,QAAQ,CAA2B;IACjE,yCAAyC;IACzC,WAAkB,QAAQ,IAAI,QAAQ,CAA2B;IACjE,WAAkB,aAAa,IAAI,oBAAoB,CAAgC;IACvF,gBAAgB;IAChB,WAAkB,cAAc,IAAI,cAAc,CAAiC;IACnF,6CAA6C;IAC7C,WAAkB,YAAY,IAAI,YAAY,CAA+B;IAC7E;;OAEG;IACH,WAAkB,eAAe,IAAI,qBAAqB,GAAG,SAAS,CAAkC;IACxG,0HAA0H;IAC1H,WAAkB,aAAa,IAAI,MAAM,CAAgC;IACzE,sEAAsE;IACtE,WAAkB,kBAAkB,IAAI,MAAM,CAAqC;IACnF,gBAAgB;IAChB,WAAkB,WAAW,YAAgC;IAE7D;;OAEG;IACH,WAAkB,SAAS,IAAI,iBAAiB,GAAG,SAAS,CAA4B;IACxF;;OAEG;IACH,WAAkB,iBAAiB,IAAI,iBAAiB,GAAG,SAAS,CAAoC;IAExG,gBAAgB;IAChB,WAAkB,eAAe,YAA6E;IAC9G,wCAAwC;IACxC,WAAkB,OAAO,YAA4B;IACrD,uDAAuD;IACvD,WAAkB,eAAe,4BAAoC;IACrE;;OAEG;IACH,WAAkB,UAAU,WAA+B;IAC3D;;OAEG;IACH,gBAAuB,SAAS,EAAE,gBAAgB,CAA0B;IAE5E,aAAa;IACb,gBAAuB,cAAc,iBAAgC;IAErE,gDAAgD;IAChD,OAAO,CAAC,MAAM,CAAC,cAAc,CAAyC;IAEtE;;OAEG;WACW,sBAAsB,CAAC,SAAS,EAAE,GAAG;IASnD;;OAEG;WACW,mBAAmB,CAAC,aAAa,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,WAAW;IAWtF,gBAAgB;WACF,iBAAiB,CAAC,aAAa,EAAE,MAAM;IAErD;;;;;OAKG;WACW,wBAAwB,IAAI,4BAA4B;IAItE;;;;;;;OAOG;WACiB,OAAO,CAAC,IAAI,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IAiFnE,iFAAiF;WAC7D,QAAQ;IAwB5B;;;;;;;OAOG;IACH,WAAkB,iBAAiB,IAAI,UAAU,GAAG,SAAS,CAAyC;IACtG,WAAkB,iBAAiB,CAAC,QAAQ,EAAE,UAAU,GAAG,SAAS,EASnE;IAED,gBAAgB;WACF,oBAAoB;IAWlC,gBAAgB;IAChB,OAAO,CAAC,MAAM,CAAC,sBAAsB;IAOrC,gBAAgB;IAChB,OAAO,CAAC,MAAM,CAAC,wBAAwB;IASvC,gBAAgB;WACF,cAAc;IAS5B,oCAAoC;WACtB,aAAa;IAI3B,8DAA8D;IAC9D,OAAO,CAAC,MAAM,CAAC,SAAS;IAkBxB;;;OAGG;WACiB,cAAc,IAAI,OAAO,CAAC,WAAW,CAAC;IAQ1D,gBAAgB;WACF,eAAe,CAAC,IAAI,CAAC,EAAE,YAAY,CAAC,OAAO,GAAG,YAAY;IAExE,OAAO,CAAC,MAAM,CAAC,uBAAuB;IA+BtC;;OAEG;WACW,eAAe,CAAC,CAAC,SAAS,MAAM,qBAAqB,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE;QAClF,yCAAyC;QACzC,MAAM,CAAC,EAAE,WAAW,CAAC;QACrB,4CAA4C;QAC5C,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,qCAAqC;QACrC,EAAE,CAAC,EAAE,MAAM,CAAC;QACZ,wCAAwC;QACxC,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,wCAAwC;QACxC,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB;IAiBD;;;;OAIG;WACW,YAAY,CAAC,OAAO,EAAE,YAAY,GAAG,WAAW;IAyC9D;;OAEG;IACH,OAAc,mBAAmB,CAAC,EAAE,MAAM,mBAAmB,CAAC;IAE9D;;;OAGG;WACW,YAAY,CACxB,IAAI,EAAE;QACJ,2FAA2F;QAC3F,OAAO,EAAE,MAAM,GAAG,WAAW,CAAC;QAC9B,kEAAkE;QAClE,OAAO,CAAC,EAAE,MAAM,GAAG,gBAAgB,CAAC;QACpC,sEAAsE;QACtE,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,yEAAyE;QACzE,MAAM,CAAC,EAAE,MAAM,GAAG,WAAW,CAAC;KAC/B,GAAG,mBAAmB;IA4BzB;;OAEG;WACW,oBAAoB;IAQlC;;OAEG;WACW,oBAAoB,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,WAAW;IAQ9D;;;;OAIG;WACW,eAAe,CAAC,MAAM,EAAE,MAAM;IAiB5C;;;;OAIG;IACH,OAAO,CAAC,MAAM,CAAC,qBAAqB;CAKrC"}
+{"version":3,"file":"IModelApp.d.ts","sourceRoot":"","sources":["../../src/IModelApp.ts"],"names":[],"mappings":"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"}

package/lib/esm/IModelApp.js

@@ -65,9 +65,7 @@ export class IModelApp {
      * @internal
      */
     static get mapLayerFormatRegistry() { return this._mapLayerFormatRegistry; }
-    /** The [[TerrainProviderRegistry]] for this session.
-     * @beta
-     */
+    /** The [[TerrainProviderRegistry]] for this session. */
     static get terrainProviderRegistry() { return this._terrainProviderRegistry; }
     /** The [[RealityDataSourceProviderRegistry]] for this session.
      * @alpha
@@ -167,24 +165,23 @@ export class IModelApp {
      * @param opts The options for configuring IModelApp
      */
     static async startup(opts) {
-        var _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r, _s;
         if (this._initialized)
             return; // we're already initialized, do nothing.
         this._initialized = true;
-        opts = opts !== null && opts !== void 0 ? opts : {};
-        this._securityOptions = (_b = opts.security) !== null && _b !== void 0 ? _b : {};
+        opts = opts ?? {};
+        this._securityOptions = opts.security ?? {};
         if (process.env.NODE_ENV === "development") {
             // Make IModelApp globally accessible for debugging purposes. We'll remove it on shutdown.
             window.iModelAppForDebugger = this;
         }
-        this.sessionId = (_c = opts.sessionId) !== null && _c !== void 0 ? _c : Guid.createValue();
-        this._applicationId = (_d = opts.applicationId) !== null && _d !== void 0 ? _d : "2686"; // Default to product id of iTwin.js
-        this._applicationVersion = (_e = opts.applicationVersion) !== null && _e !== void 0 ? _e : "1.0.0";
+        this.sessionId = opts.sessionId ?? Guid.createValue();
+        this._applicationId = opts.applicationId ?? "2686"; // Default to product id of iTwin.js
+        this._applicationVersion = opts.applicationVersion ?? "1.0.0";
         this.authorizationClient = opts.authorizationClient;
         this._hubAccess = opts.hubAccess;
-        this._noRender = (_f = opts.noRender) !== null && _f !== void 0 ? _f : false;
+        this._noRender = opts.noRender ?? false;
         this._setupRpcRequestContext();
-        this._localization = (_g = opts.localization) !== null && _g !== void 0 ? _g : new ITwinLocalization();
+        this._localization = opts.localization ?? new ITwinLocalization();
         const toolsNs = "CoreTools";
         await this.localization.initialize(["iModelJs", toolsNs]);
         [
@@ -210,21 +207,21 @@ export class IModelApp {
         this._renderSystem = (opts.renderSys instanceof RenderSystem) ? opts.renderSys : this.createRenderSys(opts.renderSys);
         if (opts.userPreferences)
             this._userPreferences = opts.userPreferences;
-        this._viewManager = (_h = opts.viewManager) !== null && _h !== void 0 ? _h : new ViewManager();
+        this._viewManager = opts.viewManager ?? new ViewManager();
         this._tileAdmin = await TileAdmin.create(opts.tileAdmin);
-        this._notifications = (_j = opts.notifications) !== null && _j !== void 0 ? _j : new NotificationManager();
-        this._toolAdmin = (_k = opts.toolAdmin) !== null && _k !== void 0 ? _k : new ToolAdmin();
-        this._accuDraw = (_l = opts.accuDraw) !== null && _l !== void 0 ? _l : new AccuDraw();
-        this._accuSnap = (_m = opts.accuSnap) !== null && _m !== void 0 ? _m : new AccuSnap();
-        this._locateManager = (_o = opts.locateManager) !== null && _o !== void 0 ? _o : new ElementLocateManager();
-        this._tentativePoint = (_p = opts.tentativePoint) !== null && _p !== void 0 ? _p : new TentativePoint();
-        this._quantityFormatter = (_q = opts.quantityFormatter) !== null && _q !== void 0 ? _q : new QuantityFormatter();
-        this._uiAdmin = (_r = opts.uiAdmin) !== null && _r !== void 0 ? _r : new UiAdmin();
+        this._notifications = opts.notifications ?? new NotificationManager();
+        this._toolAdmin = opts.toolAdmin ?? new ToolAdmin();
+        this._accuDraw = opts.accuDraw ?? new AccuDraw();
+        this._accuSnap = opts.accuSnap ?? new AccuSnap();
+        this._locateManager = opts.locateManager ?? new ElementLocateManager();
+        this._tentativePoint = opts.tentativePoint ?? new TentativePoint();
+        this._quantityFormatter = opts.quantityFormatter ?? new QuantityFormatter();
+        this._uiAdmin = opts.uiAdmin ?? new UiAdmin();
         this._mapLayerFormatRegistry = new MapLayerFormatRegistry(opts.mapLayerOptions);
         this._terrainProviderRegistry = new TerrainProviderRegistry();
         this._realityDataSourceProviders = new RealityDataSourceProviderRegistry();
         this._realityDataAccess = opts.realityDataAccess;
-        this._publicPath = (_s = opts.publicPath) !== null && _s !== void 0 ? _s : "";
+        this._publicPath = opts.publicPath ?? "";
         [
             this.renderSystem,
             this.viewManager,
@@ -337,9 +334,8 @@ export class IModelApp {
      * returned by this method may change over time throughout the course of a session.
      */
     static async getAccessToken() {
-        var _b, _c;
         try {
-            return (_c = (await ((_b = this.authorizationClient) === null || _b === void 0 ? void 0 : _b.getAccessToken()))) !== null && _c !== void 0 ? _c : "";
+            return (await this.authorizationClient?.getAccessToken()) ?? "";
         }
         catch (e) {
             return "";
@@ -479,7 +475,7 @@ export class IModelApp {
      */
     static formatElementToolTip(msg) {
         let out = "";
-        msg.forEach((line) => { var _b; return out += `${(_b = IModelApp.localization) === null || _b === void 0 ? void 0 : _b.getLocalizedKeys(line)}<br>`; });
+        msg.forEach((line) => out += `${IModelApp.localization?.getLocalizedKeys(line)}<br>`);
         const div = document.createElement("div");
         div.innerHTML = out;
         return div;