@itwin/core-frontend 4.1.0-dev.8 → 4.1.0-dev.81

package/lib/cjs/IModelConnection.js

@@ -11,7 +11,7 @@ exports.SnapshotConnection = exports.BlankConnection = exports.IModelConnection
 const core_bentley_1 = require("@itwin/core-bentley");
 const core_common_1 = require("@itwin/core-common");
 const core_geometry_1 = require("@itwin/core-geometry");
-const FrontendLoggerCategory_1 = require("./FrontendLoggerCategory");
+const FrontendLoggerCategory_1 = require("./common/FrontendLoggerCategory");
 const GeoServices_1 = require("./GeoServices");
 const IModelApp_1 = require("./IModelApp");
 const IModelRoutingContext_1 = require("./IModelRoutingContext");
@@ -136,7 +136,7 @@ class IModelConnection extends core_common_1.IModel {
         this.selectionSet = new SelectionSet_1.SelectionSet(this);
         this.hilited = new SelectionSet_1.HiliteSet(this);
         this.tiles = new Tiles_1.Tiles(this);
-        this.geoServices = new GeoServices_1.GeoServices(this);
+        this.geoServices = GeoServices_1.GeoServices.createForIModel(this);
         /* eslint-disable-next-line deprecation/deprecation */
         this.displayedExtents = core_geometry_1.Range3d.fromJSON(this.projectExtents);
         this.onProjectExtentsChanged.addListener(() => {
@@ -158,6 +158,12 @@ class IModelConnection extends core_common_1.IModel {
         this.subcategories.onIModelConnectionClose();
     }
     /** Allow to execute query and read results along with meta data. The result are streamed.
+     *
+     * See also:
+     * - [ECSQL Overview]($docs/learning/frontend/ExecutingECSQL)
+     * - [Code Examples]($docs/learning/frontend/ECSQLCodeExamples)
+     * - [ECSQL Row Format]($docs/learning/ECSQLRowFormat)
+     *
      * @param params The values to bind to the parameters (if the ECSQL has any).
      * @param config Allow to specify certain flags which control how query is executed.
      * @returns Returns an [ECSqlReader]($common) which helps iterate over the result set and also give access to metadata.
@@ -185,8 +191,8 @@ class IModelConnection extends core_common_1.IModel {
      * [ECSQL row]($docs/learning/ECSQLRowFormat).
      *
      * See also:
-     * - [ECSQL Overview]($docs/learning/backend/ExecutingECSQL)
-     * - [Code Examples]($docs/learning/backend/ECSQLCodeExamples)
+     * - [ECSQL Overview]($docs/learning/frontend/ExecutingECSQL)
+     * - [Code Examples]($docs/learning/frontend/ECSQLCodeExamples)
      *
      * @param ecsql The ECSQL statement to execute
      * @param params The values to bind to the parameters (if the ECSQL has any).
@@ -205,8 +211,8 @@ class IModelConnection extends core_common_1.IModel {
     /** Compute number of rows that would be returned by the ECSQL.
      *
      * See also:
-     * - [ECSQL Overview]($docs/learning/backend/ExecutingECSQL)
-     * - [Code Examples]($docs/learning/backend/ECSQLCodeExamples)
+     * - [ECSQL Overview]($docs/learning/frontend/ExecutingECSQL)
+     * - [Code Examples]($docs/learning/frontend/ECSQLCodeExamples)
      *
      * @param ecsql The ECSQL statement to execute
      * @param params The values to bind to the parameters (if the ECSQL has any).
@@ -226,8 +232,8 @@ class IModelConnection extends core_common_1.IModel {
      * [ECSQL row]($docs/learning/ECSQLRowFormat).
      *
      * See also:
-     * - [ECSQL Overview]($docs/learning/backend/ExecutingECSQL)
-     * - [Code Examples]($docs/learning/backend/ECSQLCodeExamples)
+     * - [ECSQL Overview]($docs/learning/frontend/ExecutingECSQL)
+     * - [Code Examples]($docs/learning/frontend/ECSQLCodeExamples)
      *
      * @param ecsql The ECSQL statement to execute
      * @param token None empty restart token. The previous query with same token would be cancelled. This would cause
@@ -315,8 +321,9 @@ class IModelConnection extends core_common_1.IModel {
     /** Convert a point in this iModel's Spatial coordinates to a [[Cartographic]] using the Geographic location services for this IModelConnection.
      * @param spatial A point in the iModel's spatial coordinates
      * @param result If defined, use this for output
-     * @returns A Cartographic location
+     * @returns A Cartographic location (Horizontal datum depends on iModel's GCS)
      * @throws IModelError if [[isGeoLocated]] is false or point could not be converted.
+     * @see [[cartographicFromSpatial]] if you have more than one point to convert, or you don't know whether the iModel has a GCS.
      */
     async spatialToCartographicFromGcs(spatial, result) {
         if (!this.isGeoLocated && this.noGcsDefined)
@@ -335,19 +342,67 @@ class IModelConnection extends core_common_1.IModel {
     /** Convert a point in this iModel's Spatial coordinates to a [[Cartographic]] using the Geographic location services for this IModelConnection or [[IModel.ecefLocation]].
      * @param spatial A point in the iModel's spatial coordinates
      * @param result If defined, use this for output
-     * @returns A Cartographic location
+     * @returns A Cartographic location (Horizontal datum depends on iModel's GCS)
      * @throws IModelError if [[isGeoLocated]] is false or point could not be converted.
-     * @see [[spatialToCartographicFromGcs]]
-     * @see [[spatialToCartographicFromEcef]]
+     * @see [[cartographicFromSpatial]] to convert multiple points at once.
+     * @see [[spatialToCartographicFromEcef]] to synchronously convert points using the iModel's ECEF transform.
      */
     async spatialToCartographic(spatial, result) {
         return (this.noGcsDefined ? this.spatialToCartographicFromEcef(spatial, result) : this.spatialToCartographicFromGcs(spatial, result));
     }
-    /** Convert a [[Cartographic]] to a point in this iModel's Spatial coordinates using the Geographic location services for this IModelConnection.
+    /** Convert points in this iModel's spatial coordinate system to [Cartographic]($common) coordinates using either a [[GeoConverter]] or the iModel's [EcefLocation]($common).
+     * @param spatial Coordinates to be converted from the iModel's spatial coordinate system
+     * @returns The `spatial` coordinates converted to cartographic coordinates, of the same length and order as the `spatial`.
+     * @throws IModelError if [[isGeoLocated]] is false or any point could not be converted.
+     * @see [[spatialFromCartographic]] to perform the inverse conversion.
+     * @see [[spatialToCartographicFromEcef]] to synchronously convert points using the iModel's ECEF transform.
+     */
+    async cartographicFromSpatial(spatial) {
+        return this.cartographicFromSpatialWithGcs(spatial);
+    }
+    /** Convert points in this iModel's spatial coordinate system to [Cartographic]($common) coordinates using either a [[GeoConverter]] or the iModel's [EcefLocation]($common).
+     * @param spatial Coordinates to be converted from the iModel's spatial coordinate system
+     * @returns The `spatial` coordinates converted to cartographic coordinates (WGS84 horizontal datum), of the same length and order as the `spatial`.
+     * @throws IModelError if [[isGeoLocated]] is false or any point could not be converted.
+     * @see [[cartographicFromSpatial]] to perform conversion using iModel's GCS horizontal datum
+     * @beta
+     */
+    async wgs84CartographicFromSpatial(spatial) {
+        return this.cartographicFromSpatialWithGcs(spatial, "WGS84");
+    }
+    /** @internal */
+    async cartographicFromSpatialWithGcs(spatial, datumOrGCRS) {
+        if (this.noGcsDefined)
+            return spatial.map((p) => this.spatialToCartographicFromEcef(p));
+        if (!this.isGeoLocated)
+            throw new core_common_1.IModelError(core_bentley_1.GeoServiceStatus.NoGeoLocation, "iModel is not GeoLocated");
+        if (!this.isOpen)
+            throw new core_common_1.IModelError(core_bentley_1.GeoServiceStatus.NoGeoLocation, "iModel is not open");
+        if (spatial.length === 0)
+            return [];
+        const geoConverter = this.geoServices.getConverter(datumOrGCRS);
+        (0, core_bentley_1.assert)(undefined !== geoConverter);
+        const coordResponse = await geoConverter.getGeoCoordinatesFromIModelCoordinates(spatial);
+        if (coordResponse.geoCoords.length !== spatial.length)
+            throw new core_common_1.IModelError(core_bentley_1.GeoServiceStatus.NoGeoLocation, "iModel is not GeoLocated");
+        return coordResponse.geoCoords.map((coord) => {
+            switch (coord.s) {
+                case core_common_1.GeoCoordStatus.NoGCSDefined:
+                    throw new core_common_1.IModelError(core_bentley_1.GeoServiceStatus.NoGeoLocation, "iModel is not GeoLocated");
+                case core_common_1.GeoCoordStatus.Success:
+                    const llh = core_geometry_1.Point3d.fromJSON(coord.p);
+                    return core_common_1.Cartographic.fromDegrees({ longitude: llh.x, latitude: llh.y, height: llh.z });
+                default:
+                    throw new core_common_1.IModelError((0, core_common_1.mapToGeoServiceStatus)(coord.s), "Error converting spatial to cartographic");
+            }
+        });
+    }
+    /** Convert a [Cartographic]($common) to a point in this iModel's spatial coordinate system using a [[GeoConverter]].
      * @param cartographic A cartographic location
      * @param result If defined, use this for output
      * @returns A point in this iModel's spatial coordinates
      * @throws IModelError if [[isGeoLocated]] is false or cartographic location could not be converted.
+     * @see [[spatialFromCartographic]] to convert multiple points at once, or you don't know whether the iModel has a GCS.
      */
     async cartographicToSpatialFromGcs(cartographic, result) {
         if (!this.isGeoLocated && this.noGcsDefined)
@@ -365,17 +420,59 @@ class IModelConnection extends core_common_1.IModel {
         result.setFromJSON(coordResponse.iModelCoords[0].p);
         return result;
     }
-    /** Convert a [[Cartographic]] to a point in this iModel's Spatial coordinates using the Geographic location services for this IModelConnection or [[IModel.ecefLocation]].
+    /** Convert a [Cartographic]($common) to a point in this iModel's Spatial coordinates using a [[GeoConverter]] or[[IModel.ecefLocation]($common).
      * @param cartographic A cartographic location
      * @param result If defined, use this for output
      * @returns A point in this iModel's spatial coordinates
      * @throws IModelError if [[isGeoLocated]] is false or cartographic location could not be converted.
-     * @see [[cartographicToSpatialFromGcs]]
-     * @see [[cartographicToSpatialFromEcef]]
+     * @see [[spatialFromCartographic]] to convert multiple points at once.
+     * @see [[cartographicToSpatialFromEcef]] to synchronously convert points using the iModel's ECEF transform.
      */
     async cartographicToSpatial(cartographic, result) {
         return (this.noGcsDefined ? this.cartographicToSpatialFromEcef(cartographic, result) : this.cartographicToSpatialFromGcs(cartographic, result));
     }
+    /** Convert [Cartographic]($common) coordinates into points in this iModel's spatial coordinate system using a [[GeoConverter]] or the iModel's [EcefLocation]($common).
+     * @param cartographic Coordinates to be converted to the iModel's spatial coordinate system.
+     * @returns The `cartographic` coordinates converted to spatial coordinates, of the same length and order as `cartographic`.
+     * @throws IModelError if [[isGeoLocated]] is false or any point could not be converted.
+     * @see [[cartographicFromSpatial]] to perform the inverse conversion.
+     */
+    async spatialFromCartographic(cartographic) {
+        if (this.noGcsDefined)
+            return cartographic.map((p) => this.cartographicToSpatialFromEcef(p));
+        const geoCoords = cartographic.map((p) => core_geometry_1.Point3d.create(p.longitudeDegrees, p.latitudeDegrees, p.height));
+        return this.toSpatialFromGcs(geoCoords);
+    }
+    /** Convert geographic coordinates into points in this iModel's spatial coordinate system using a [[GeoConverter]] or the iModel's [EcefLocation]($common).
+     * @param geoCoords Coordinates to be converted are in the coordinate system described by the `datumOrGCRS` parameter.  Defaults iModel's spatial coordinate system otherwise.
+     * @param datumOrGCRS Datum name or Geographic CRS object definition to use for the conversion.
+     * @returns The `geographics` coordinates converted to spatial coordinates, of the same length and order as `geographics`.
+     * @throws IModelError if [[isGeoLocated]] is false or any point could not be converted.
+     * @beta
+     */
+    async toSpatialFromGcs(geoCoords, datumOrGCRS) {
+        if (!this.isGeoLocated)
+            throw new core_common_1.IModelError(core_bentley_1.GeoServiceStatus.NoGeoLocation, "iModel is not GeoLocated");
+        if (!this.isOpen)
+            throw new core_common_1.IModelError(core_bentley_1.GeoServiceStatus.NoGeoLocation, "iModel is not open");
+        if (geoCoords.length === 0)
+            return [];
+        const geoConverter = this.geoServices.getConverter(datumOrGCRS);
+        (0, core_bentley_1.assert)(undefined !== geoConverter);
+        const coordResponse = await geoConverter.getIModelCoordinatesFromGeoCoordinates(geoCoords);
+        if (coordResponse.iModelCoords.length !== geoCoords.length)
+            throw new core_common_1.IModelError(core_bentley_1.GeoServiceStatus.NoGeoLocation, "iModel is not GeoLocated");
+        return coordResponse.iModelCoords.map((coord) => {
+            switch (coord.s) {
+                case core_common_1.GeoCoordStatus.NoGCSDefined:
+                    throw new core_common_1.IModelError(core_bentley_1.GeoServiceStatus.NoGeoLocation, "iModel is not GeoLocated");
+                case core_common_1.GeoCoordStatus.Success:
+                    return core_geometry_1.Point3d.fromJSON(coord.p);
+                default:
+                    throw new core_common_1.IModelError((0, core_common_1.mapToGeoServiceStatus)(coord.s), "Error converting cartographic to spatial");
+            }
+        });
+    }
     /** Expand this iModel's [[displayedExtents]] to include the specified range.
      * This is done automatically when reality models are added to a spatial view. In some cases a [[TiledGraphicsProvider]] may wish to expand
      * the extents explicitly to include its geometry.
@@ -855,6 +952,22 @@ exports.SnapshotConnection = SnapshotConnection;
         constructor(_iModel) {
             this._iModel = _iModel;
         }
+        get viewStoreWriter() {
+            return this._writeViewStoreProxy ??= new Proxy(this, {
+                get(views, methodName) {
+                    const iModel = views._iModel;
+                    return async (...args) => core_common_1.IModelReadRpcInterface.getClientForRouting(iModel.routingContext.token).callViewStore(iModel.getRpcProps(), core_common_1.ViewStoreRpc.version, true, methodName, ...args);
+                },
+            });
+        }
+        get viewsStoreReader() {
+            return this._readViewStoreProxy ??= new Proxy(this, {
+                get(views, methodName) {
+                    const iModel = views._iModel;
+                    return async (...args) => core_common_1.IModelReadRpcInterface.getClientForRouting(iModel.routingContext.token).callViewStore(iModel.getRpcProps(), core_common_1.ViewStoreRpc.version, false, methodName, ...args);
+                },
+            });
+        }
         /** Query for an array of ViewDefinitionProps
          * @param queryParams Query parameters specifying the views to return. The `limit` and `offset` members should be used to page results.
          * @throws [IModelError]($common) If the generated statement is invalid or would return too many props.
@@ -896,7 +1009,7 @@ exports.SnapshotConnection = SnapshotConnection;
         }
         /** Query the Id of the default view associated with this iModel. Applications can choose to use this as the default view to which to open a viewport upon startup, or the initial selection
          * within a view selection dialog, or similar purposes.
-         * @returns the ID of the default view, or an invalid ID if no default view is defined.
+         * @returns the Id of the default view, or an invalid ID if no default view is defined.
          */
         async queryDefaultViewId() {
             const iModel = this._iModel;
@@ -904,8 +1017,6 @@ exports.SnapshotConnection = SnapshotConnection;
         }
         /** Load a [[ViewState]] object from the specified [[ViewDefinition]] id. */
         async load(viewDefinitionId) {
-            if (!core_bentley_1.Id64.isValidId64(viewDefinitionId))
-                throw new core_common_1.IModelError(core_common_1.IModelStatus.InvalidId, `Invalid view definition Id ${viewDefinitionId}`);
             const options = {
                 displayStyle: {
                     omitScheduleScriptElementIds: !IModelApp_1.IModelApp.tileAdmin.enableFrontendScheduleScripts,
@@ -930,7 +1041,7 @@ exports.SnapshotConnection = SnapshotConnection;
          * @param viewId The id of the view of the thumbnail.
          * @returns A Promise of the ThumbnailProps.
          * @throws "No content" error if invalid thumbnail.
-         * @deprecated in 3.x with no replacement; thumbnails are rarely added to the iModel.
+         * @deprecated in 3.x use ViewStore apis
          */
         async getThumbnail(_viewId) {
             // eslint-disable-next-line deprecation/deprecation