@itwin/core-backend 5.1.0-dev.9 → 5.2.0-dev.1

package/lib/cjs/IModelDb.js

@@ -110,7 +110,7 @@ class IModelDb extends core_common_1.IModel {
     _jsClassMap;
     _schemaMap;
     _schemaContext;
-    /** @deprecated in 5.0.0. Use [[fonts]]. */
+    /** @deprecated in 5.0.0 - will not be removed until after 2026-06-13. Use [[fonts]]. */
     _fontMap; // eslint-disable-line @typescript-eslint/no-deprecated
     _fonts = (0, IModelDbFontsImpl_1.createIModelDbFonts)(this);
     _workspace;
@@ -166,7 +166,7 @@ class IModelDb extends core_common_1.IModel {
     restartDefaultTxn() {
         this[Symbols_1._nativeDb].restartDefaultTxn();
     }
-    /** @deprecated in 5.0.0. Use [[fonts]]. */
+    /** @deprecated in 5.0.0 - will not be removed until after 2026-06-13. Use [[fonts]]. */
     get fontMap() {
         return this._fontMap ?? (this._fontMap = new core_common_1.FontMap(this[Symbols_1._nativeDb].readFontMap())); // eslint-disable-line @typescript-eslint/no-deprecated
     }
@@ -343,7 +343,7 @@ class IModelDb extends core_common_1.IModel {
      * @returns the value returned by `callback`.
      * @see [[withStatement]]
      * @public
-     * @deprecated in 4.11.  Use [[createQueryReader]] instead.
+     * @deprecated in 4.11 - will not be removed until after 2026-06-13.  Use [[createQueryReader]] instead.
      */
     // eslint-disable-next-line @typescript-eslint/no-deprecated
     withPreparedStatement(ecsql, callback, logErrors = true) {
@@ -375,7 +375,7 @@ class IModelDb extends core_common_1.IModel {
      * @returns the value returned by `callback`.
      * @see [[withPreparedStatement]]
      * @public
-     * @deprecated in 4.11.  Use [[createQueryReader]] instead.
+     * @deprecated in 4.11 - will not be removed until after 2026-06-13.  Use [[createQueryReader]] instead.
      */
     // eslint-disable-next-line @typescript-eslint/no-deprecated
     withStatement(ecsql, callback, logErrors = true) {
@@ -582,6 +582,8 @@ class IModelDb extends core_common_1.IModel {
         this._schemaContext = undefined;
         this.elements[Symbols_1._cache].clear();
         this.models[Symbols_1._cache].clear();
+        this.elements[Symbols_1._instanceKeyCache].clear();
+        this.models[Symbols_1._instanceKeyCache].clear();
     }
     /** Update the project extents for this iModel.
      * <p><em>Example:</em>
@@ -637,6 +639,7 @@ class IModelDb extends core_common_1.IModel {
      * @note This will not delete Txns that have already been saved, even if they have not yet been pushed.
     */
     abandonChanges() {
+        this.clearCaches();
         this[Symbols_1._nativeDb].abandonChanges();
     }
     /**
@@ -650,11 +653,14 @@ class IModelDb extends core_common_1.IModel {
     performCheckpoint() {
         if (!this.isReadonly) {
             this.saveChanges();
+            this.clearCaches();
+            this[Symbols_1._nativeDb].concurrentQueryShutdown();
+            this[Symbols_1._nativeDb].clearECDbCache();
             this[Symbols_1._nativeDb].performCheckpoint();
         }
     }
     /** @internal
-     * @deprecated in 4.8. Use `txns.reverseTxns`.
+     * @deprecated in 4.8 - will not be removed until after 2026-06-13. Use `txns.reverseTxns`.
      */
     reverseTxns(numOperations) {
         return this[Symbols_1._nativeDb].reverseTxns(numOperations);
@@ -880,7 +886,7 @@ class IModelDb extends core_common_1.IModel {
     }
     /** The registry of entity metadata for this iModel.
      * @internal
-     * @deprecated in 5.0. Please use `schemaContext` from the `iModel` instead.
+     * @deprecated in 5.0 - will not be removed until after 2026-06-13. Please use `schemaContext` from the `iModel` instead.
      *
      * @example
      * ```typescript
@@ -940,7 +946,7 @@ class IModelDb extends core_common_1.IModel {
      * @param sql The ECSQL statement to prepare
      * @param logErrors Determines if error will be logged if statement fail to prepare
      * @throws [[IModelError]] if there is a problem preparing the statement.
-     * @deprecated in 4.11.  Use [IModelDb.createQueryReader]($backend) or [ECDb.createQueryReader]($backend) to query.
+     * @deprecated in 4.11 - will not be removed until after 2026-06-13.  Use [IModelDb.createQueryReader]($backend) or [ECDb.createQueryReader]($backend) to query.
      */
     // eslint-disable-next-line @typescript-eslint/no-deprecated
     prepareStatement(sql, logErrors = true) {
@@ -952,7 +958,7 @@ class IModelDb extends core_common_1.IModel {
     /** Prepare an ECSQL statement.
      * @param sql The ECSQL statement to prepare
      * @returns `undefined` if there is a problem preparing the statement.
-     * @deprecated in 4.11.  Use [IModelDb.createQueryReader]($backend) or [ECDb.createQueryReader]($backend) to query.
+     * @deprecated in 4.11 - will not be removed until after 2026-06-13.  Use [IModelDb.createQueryReader]($backend) or [ECDb.createQueryReader]($backend) to query.
      */
     // eslint-disable-next-line @typescript-eslint/no-deprecated
     tryPrepareStatement(sql) {
@@ -1002,7 +1008,7 @@ class IModelDb extends core_common_1.IModel {
     }
     /** Get metadata for a class. This method will load the metadata from the iModel into the cache as a side-effect, if necessary.
      * @throws [[IModelError]] if the metadata cannot be found nor loaded.
-     * @deprecated in 5.0. Please use `getSchemaItem` from `SchemaContext` class instead.
+     * @deprecated in 5.0 - will not be removed until after 2026-06-13. Please use `getSchemaItem` from `SchemaContext` class instead.
      *
      * @example
      *  * ```typescript
@@ -1028,7 +1034,7 @@ class IModelDb extends core_common_1.IModel {
         return metadata;
     }
     /** Identical to [[getMetaData]], except it returns `undefined` instead of throwing an error if the metadata cannot be found nor loaded.
-     * @deprecated in 5.0. Please use `getSchemaItem` from `SchemaContext` class instead.
+     * @deprecated in 5.0 - will not be removed until after 2026-06-13. Please use `getSchemaItem` from `SchemaContext` class instead.
      *
      * @example
      *  * ```typescript
@@ -1056,7 +1062,7 @@ class IModelDb extends core_common_1.IModel {
      * @param func The callback to be invoked on each property
      * @param includeCustom If true (default), include custom-handled properties in the iteration. Otherwise, skip custom-handled properties.
      * @note Custom-handled properties are core properties that have behavior enforced by C++ handlers.
-     * @deprecated in 5.0. Please use `forEachProperty` instead.
+     * @deprecated in 5.0 - will not be removed until after 2026-06-13. Please use `forEachProperty` instead.
      *
      * @example
      * ```typescript
@@ -1082,7 +1088,7 @@ class IModelDb extends core_common_1.IModel {
      * @param func The callback to be invoked on each property
      * @param includeCustom If true (default), include custom-handled properties in the iteration. Otherwise, skip custom-handled properties.
      * @note Custom-handled properties are core properties that have behavior enforced by C++ handlers.
-     * @deprecated in 5.0. Use `forEachProperty` from `SchemaContext` class instead.
+     * @deprecated in 5.0 - will not be removed until after 2026-06-13. Use `forEachProperty` from `SchemaContext` class instead.
      *
      * @example
      * ```typescript
@@ -1112,7 +1118,7 @@ class IModelDb extends core_common_1.IModel {
     }
     /**
      * @internal
-     * @deprecated in 5.0. Please use `schemaContext` from `iModel` instead to get metadata.
+     * @deprecated in 5.0 - will not be removed until after 2026-06-13. Please use `schemaContext` from `iModel` instead to get metadata.
      */
     loadMetaData(classFullName) {
         // eslint-disable-next-line @typescript-eslint/no-deprecated
@@ -1152,19 +1158,26 @@ class IModelDb extends core_common_1.IModel {
         const classNameParts = classFullName.replace(".", ":").split(":");
         return classNameParts.length === 2 && this[Symbols_1._nativeDb].getECClassMetaData(classNameParts[0], classNameParts[1]).error === undefined;
     }
-    /** Query for a schema of the specified name in this iModel.
+    /** Query the version of a schema of the specified name in this iModel.
      * @returns The schema version as a semver-compatible string or `undefined` if the schema has not been imported.
      */
     querySchemaVersion(schemaName) {
+        const version = this.querySchemaVersionNumbers(schemaName);
+        return version?.toString(false);
+    }
+    /** Query the version of a schema of the specified name in this iModel.
+     * @returns the version numbers, or `undefined` if the schema has not been imported.
+     */
+    querySchemaVersionNumbers(schemaName) {
         const sql = `SELECT VersionMajor,VersionWrite,VersionMinor FROM ECDbMeta.ECSchemaDef WHERE Name=:schemaName LIMIT 1`;
         // eslint-disable-next-line @typescript-eslint/no-deprecated
         return this.withPreparedStatement(sql, (statement) => {
             statement.bindString("schemaName", schemaName);
             if (core_bentley_1.DbResult.BE_SQLITE_ROW === statement.step()) {
-                const versionMajor = statement.getValue(0).getInteger(); // ECSchemaDef.VersionMajor --> semver.major
-                const versionWrite = statement.getValue(1).getInteger(); // ECSchemaDef.VersionWrite --> semver.minor
-                const versionMinor = statement.getValue(2).getInteger(); // ECSchemaDef.VersionMinor --> semver.patch
-                return `${versionMajor}.${versionWrite}.${versionMinor}`;
+                const read = statement.getValue(0).getInteger(); // ECSchemaDef.VersionMajor --> semver.major
+                const write = statement.getValue(1).getInteger(); // ECSchemaDef.VersionWrite --> semver.minor
+                const minor = statement.getValue(2).getInteger(); // ECSchemaDef.VersionMinor --> semver.patch
+                return new ecschema_metadata_1.ECVersion(read, write, minor);
             }
             return undefined;
         });
@@ -1243,11 +1256,21 @@ class IModelDb extends core_common_1.IModel {
     }
     /** Get the IModel coordinate corresponding to each GeoCoordinate point in the input */
     async getIModelCoordinatesFromGeoCoordinates(props) {
-        return this[Symbols_1._nativeDb].getIModelCoordinatesFromGeoCoordinates(props);
+        const response = this[Symbols_1._nativeDb].getIModelCoordinatesFromGeoCoordinates(props);
+        // fromCache is only meaningful on the front-end; provide it for compatibility with return type.
+        response.fromCache = 0;
+        // Native omits the array if the input was empty.
+        response.iModelCoords = response.iModelCoords ?? [];
+        return response;
     }
     /** Get the GeoCoordinate (longitude, latitude, elevation) corresponding to each IModel Coordinate point in the input */
     async getGeoCoordinatesFromIModelCoordinates(props) {
-        return this[Symbols_1._nativeDb].getGeoCoordinatesFromIModelCoordinates(props);
+        const response = this[Symbols_1._nativeDb].getGeoCoordinatesFromIModelCoordinates(props);
+        // fromCache is only meaningful on the front-end; provide it for compatibility with return type.
+        response.fromCache = 0;
+        // Native omits the array if the input was empty.
+        response.geoCoords = response.geoCoords ?? [];
+        return response;
     }
     /** Export meshes suitable for graphics APIs from arbitrary geometry in elements in this IModelDb.
      *  * Requests can be slow when processing many elements so it is expected that this function be used on a dedicated backend,
@@ -1478,7 +1501,7 @@ function processSchemaWriteStatus(status) {
 /** @public */
 (function (IModelDb) {
     /** The collection of models in an [[IModelDb]].
-     * @public
+     * @public @preview
      */
     class Models {
         _iModel;
@@ -1486,6 +1509,8 @@ function processSchemaWriteStatus(status) {
         /** @internal */
         [Symbols_1._cache] = new core_bentley_1.LRUMap(this._modelCacheSize);
         /** @internal */
+        [Symbols_1._instanceKeyCache] = new ElementLRUCache_1.InstanceKeyLRUCache(this._modelCacheSize);
+        /** @internal */
         constructor(_iModel) {
             this._iModel = _iModel;
         }
@@ -1588,7 +1613,16 @@ function processSchemaWriteStatus(status) {
             else {
                 throw new core_common_1.IModelError(core_bentley_1.IModelStatus.InvalidId, `Invalid model identifier: ${JSON.stringify(modelIdArg)}`);
             }
-            return this._iModel[Symbols_1._nativeDb].resolveInstanceKey(args);
+            // Check the cache to avoid unnecessary native calls
+            const cachedResult = this[Symbols_1._instanceKeyCache].get(args);
+            if (cachedResult) {
+                return cachedResult;
+            }
+            else {
+                const instanceKey = this._iModel[Symbols_1._nativeDb].resolveInstanceKey(args);
+                this[Symbols_1._instanceKeyCache].set(args, instanceKey);
+                return instanceKey;
+            }
         }
         /** Get the sub-model of the specified Element.
          * See [[IModelDb.Elements.queryElementIdByCode]] for more on how to find an element by Code.
@@ -1632,7 +1666,9 @@ function processSchemaWriteStatus(status) {
                 return props.id = this._iModel[Symbols_1._nativeDb].insertModel(props);
             }
             catch (err) {
-                throw new core_common_1.IModelError(err.errorNumber, `Error inserting model [${err.message}], class=${props.classFullName}`);
+                const error = new core_common_1.IModelError(err.errorNumber, `Error inserting model [${err.message}], class=${props.classFullName}`);
+                error.cause = err;
+                throw error;
             }
         }
         /** Update an existing model.
@@ -1646,7 +1682,9 @@ function processSchemaWriteStatus(status) {
                 this._iModel[Symbols_1._nativeDb].updateModel(props);
             }
             catch (err) {
-                throw new core_common_1.IModelError(err.errorNumber, `error updating model [${err.message}] id=${props.id}`);
+                const error = new core_common_1.IModelError(err.errorNumber, `Error updating model [${err.message}], id: ${props.id}`);
+                error.cause = err;
+                throw error;
             }
         }
         /** Mark the geometry of [[GeometricModel]] as having changed, by recording an indirect change to its GeometryGuid property.
@@ -1662,7 +1700,7 @@ function processSchemaWriteStatus(status) {
             this._iModel.models[Symbols_1._cache].delete(modelId);
             const error = this._iModel[Symbols_1._nativeDb].updateModelGeometryGuid(modelId);
             if (error !== core_bentley_1.IModelStatus.Success)
-                throw new core_common_1.IModelError(error, `updating geometry guid for model ${modelId}`);
+                throw new core_common_1.IModelError(error, `Error updating geometry guid for model ${modelId}`);
         }
         /** Delete one or more existing models.
          * @param ids The Ids of the models to be deleted
@@ -1672,10 +1710,13 @@ function processSchemaWriteStatus(status) {
             core_bentley_1.Id64.toIdSet(ids).forEach((id) => {
                 try {
                     this[Symbols_1._cache].delete(id);
+                    this[Symbols_1._instanceKeyCache].deleteById(id);
                     this._iModel[Symbols_1._nativeDb].deleteModel(id);
                 }
                 catch (err) {
-                    throw new core_common_1.IModelError(err.errorNumber, `error deleting model [${err.message}] id ${id}`);
+                    const error = new core_common_1.IModelError(err.errorNumber, `Error deleting model [${err.message}], id: ${id}`);
+                    error.cause = err;
+                    throw error;
                 }
             });
         }
@@ -1705,7 +1746,7 @@ function processSchemaWriteStatus(status) {
     }
     IModelDb.Models = Models;
     /** The collection of elements in an [[IModelDb]].
-     * @public
+     * @public @preview
      */
     class Elements {
         _iModel;
@@ -1713,6 +1754,8 @@ function processSchemaWriteStatus(status) {
         /** @internal */
         [Symbols_1._cache] = new ElementLRUCache_1.ElementLRUCache(this._elementCacheSize);
         /** @internal */
+        [Symbols_1._instanceKeyCache] = new ElementLRUCache_1.InstanceKeyLRUCache(this._elementCacheSize);
+        /** @internal */
         constructor(_iModel) {
             this._iModel = _iModel;
         }
@@ -1761,7 +1804,16 @@ function processSchemaWriteStatus(status) {
                     throw new core_common_1.IModelError(core_bentley_1.IModelStatus.InvalidId, "Element Id or FederationGuid or Code is required");
                 }
             }
-            return this._iModel[Symbols_1._nativeDb].resolveInstanceKey(args);
+            // Check the cache to avoid unnecessary native calls
+            const cachedResult = this[Symbols_1._instanceKeyCache].get(args);
+            if (cachedResult) {
+                return cachedResult;
+            }
+            else {
+                const instanceKey = this._iModel[Symbols_1._nativeDb].resolveInstanceKey(args);
+                this[Symbols_1._instanceKeyCache].set(args, instanceKey);
+                return instanceKey;
+            }
         }
         /** Get properties of an Element by Id, FederationGuid, or Code
          * @returns The properties of the element or `undefined` if the element is not found.
@@ -1808,7 +1860,7 @@ function processSchemaWriteStatus(status) {
                 if (typeof elementId === "string" || elementId instanceof core_common_1.Code)
                     throw new core_common_1.IModelError(core_bentley_1.IModelStatus.NotFound, `Element=${elementId}`);
                 else
-                    throw new core_common_1.IModelError(core_bentley_1.IModelStatus.NotFound, `Element={id: ${elementId.id} federationGuid: ${elementId.federationGuid}, code: ${elementId.code}}`);
+                    throw new core_common_1.IModelError(core_bentley_1.IModelStatus.NotFound, `Element={id: ${elementId.id} federationGuid: ${elementId.federationGuid}, code={spec: ${elementId.code?.spec}, scope: ${elementId.code?.scope}, value: ${elementId.code?.value}}}`);
             }
             return element;
         }
@@ -1851,15 +1903,16 @@ function processSchemaWriteStatus(status) {
                 throw new core_common_1.IModelError(core_bentley_1.IModelStatus.InvalidCodeSpec, "Invalid CodeSpec");
             if (code.value === undefined)
                 throw new core_common_1.IModelError(core_bentley_1.IModelStatus.InvalidCode, "Invalid Code");
-            // eslint-disable-next-line @typescript-eslint/no-deprecated
-            return this._iModel.withPreparedStatement("SELECT ECInstanceId FROM BisCore:Element WHERE CodeSpec.Id=? AND CodeScope.Id=? AND CodeValue=?", (stmt) => {
-                stmt.bindId(1, code.spec);
-                stmt.bindId(2, core_bentley_1.Id64.fromString(code.scope));
-                stmt.bindString(3, code.value);
-                if (core_bentley_1.DbResult.BE_SQLITE_ROW !== stmt.step())
+            const codeToQuery = new core_common_1.Code(code);
+            try {
+                const elementKey = this.resolveElementKey(codeToQuery);
+                return core_bentley_1.Id64.fromString(elementKey.id);
+            }
+            catch (err) {
+                if (err.errorNumber === core_bentley_1.IModelStatus.NotFound)
                     return undefined;
-                return stmt.getValue(0).getId();
-            });
+                throw err;
+            }
         }
         /** Query for an [[Element]]'s last modified time.
          * @param elementId The Id of the element.
@@ -1883,7 +1936,7 @@ function processSchemaWriteStatus(status) {
         /** Insert a new element into the iModel.
          * @param elProps The properties of the new element.
          * @returns The newly inserted element's Id.
-         * @throws [[IModelError]] if unable to insert the element.
+         * @throws [[ITwinError]] if unable to insert the element.
          * @note For convenience, the value of `elProps.id` is updated to reflect the resultant element's id.
          * However when `elProps.federationGuid` is not present or undefined, a new Guid will be generated and stored on the resultant element. But
          * the value of `elProps.federationGuid` is *not* updated. Generally, it is best to re-read the element after inserting (e.g. via [[getElementProps]])
@@ -1913,7 +1966,7 @@ function processSchemaWriteStatus(status) {
          * @param elProps the properties of the element to update.
          * @note The values of `classFullName` and `model` *may not be changed* by this method. Further, it will permute the `elProps` object by adding or
          * overwriting their values to the correct values.
-         * @throws [[IModelError]] if unable to update the element.
+         * @throws [[ITwinError]] if unable to update the element.
          */
         updateElement(elProps) {
             try {
@@ -1932,7 +1985,7 @@ function processSchemaWriteStatus(status) {
         }
         /** Delete one or more elements from this iModel.
          * @param ids The set of Ids of the element(s) to be deleted
-         * @throws [[IModelError]]
+         * @throws [[ITwinError]]
          * @see deleteDefinitionElements
          */
         deleteElement(ids) {
@@ -1940,6 +1993,7 @@ function processSchemaWriteStatus(status) {
             core_bentley_1.Id64.toIdSet(ids).forEach((id) => {
                 try {
                     this[Symbols_1._cache].delete({ id });
+                    this[Symbols_1._instanceKeyCache].deleteById(id);
                     iModel[Symbols_1._nativeDb].deleteElement(id);
                 }
                 catch (err) {
@@ -2219,7 +2273,9 @@ function processSchemaWriteStatus(status) {
                 return this._iModel[Symbols_1._nativeDb].insertElementAspect(aspectProps);
             }
             catch (err) {
-                throw new core_common_1.IModelError(err.errorNumber, `Error inserting ElementAspect [${err.message}], class: ${aspectProps.classFullName}`);
+                const error = new core_common_1.IModelError(err.errorNumber, `Error inserting ElementAspect [${err.message}], class: ${aspectProps.classFullName}`, aspectProps);
+                error.cause = err;
+                throw error;
             }
         }
         /** Update an exist ElementAspect within the iModel.
@@ -2231,7 +2287,9 @@ function processSchemaWriteStatus(status) {
                 this._iModel[Symbols_1._nativeDb].updateElementAspect(aspectProps);
             }
             catch (err) {
-                throw new core_common_1.IModelError(err.errorNumber, `Error updating ElementAspect [${err.message}], id: ${aspectProps.id}`);
+                const error = new core_common_1.IModelError(err.errorNumber, `Error updating ElementAspect [${err.message}], id: ${aspectProps.id}`, aspectProps);
+                error.cause = err;
+                throw error;
             }
         }
         /** Delete one or more ElementAspects from this iModel.
@@ -2245,14 +2303,16 @@ function processSchemaWriteStatus(status) {
                     iModel[Symbols_1._nativeDb].deleteElementAspect(aspectInstanceId);
                 }
                 catch (err) {
-                    throw new core_common_1.IModelError(err.errorNumber, `Error deleting ElementAspect [${err.message}], id: ${aspectInstanceId}`);
+                    const error = new core_common_1.IModelError(err.errorNumber, `Error deleting ElementAspect [${err.message}], id: ${aspectInstanceId}`);
+                    error.cause = err;
+                    throw error;
                 }
             });
         }
     }
     IModelDb.Elements = Elements;
     /** The collection of views in an [[IModelDb]].
-     * @public
+     * @public @preview
      */
     class Views {
         _iModel;
@@ -2278,7 +2338,7 @@ function processSchemaWriteStatus(status) {
             if (undefined === props) {
                 const propsString = this._iModel.queryFilePropertyString(Views.viewStoreProperty);
                 if (!propsString)
-                    throw new Error("iModel does not have a default ViewStore");
+                    core_common_1.ViewStoreError.throwError("no-viewstore", { message: "iModel does not have a default ViewStore" });
                 props = JSON.parse(propsString);
             }
             const accessToken = await CloudSqlite_1.CloudSqlite.requestToken({
@@ -2399,7 +2459,7 @@ function processSchemaWriteStatus(status) {
         }
         getViewThumbnailArg(viewDefinitionId) {
             if (!core_bentley_1.Id64.isValid(viewDefinitionId))
-                throw new Error("illegal thumbnail id");
+                throw new core_common_1.IModelError(core_bentley_1.IModelStatus.BadArg, "illegal thumbnail id");
             return { namespace: "dgn_View", name: "Thumbnail", id: viewDefinitionId };
         }
         /** Get the thumbnail for a view.
@@ -2428,7 +2488,7 @@ function processSchemaWriteStatus(status) {
         }
         /** Set the default view property the iModel.
          * @param viewId The Id of the ViewDefinition to use as the default
-         * @deprecated in 4.2.x. Avoid setting this property - it is not practical for one single view to serve the needs of the many applications
+         * @deprecated in 4.2.0 - will not be removed until after 2026-06-13. Avoid setting this property - it is not practical for one single view to serve the needs of the many applications
          * that might wish to view the contents of the iModel.
          */
         setDefaultViewId(viewId) {
@@ -2922,6 +2982,15 @@ class BriefcaseDb extends IModelDb {
         IpcHost_1.IpcHost.notifyTxns(this, "notifyPulledChanges", this.changeset);
         this.txns.touchWatchFile();
     }
+    async enableChangesetStatTracking() {
+        this[Symbols_1._nativeDb].enableChangesetStatsTracking();
+    }
+    async disableChangesetStatTracking() {
+        this[Symbols_1._nativeDb].disableChangesetStatsTracking();
+    }
+    async getAllChangesetHealthData() {
+        return this[Symbols_1._nativeDb].getAllChangesetHealthData();
+    }
     /** Revert timeline changes and then push resulting changeset */
     async revertAndPushChanges(arg) {
         const nativeDb = this[Symbols_1._nativeDb];
@@ -3107,6 +3176,10 @@ class SnapshotDb extends IModelDb {
         snapshotDb.channels.addAllowedChannel(ChannelControl_1.ChannelControl.sharedChannelName);
         if (options.createClassViews)
             snapshotDb._createClassViewsOnClose = true; // save flag that will be checked when close() is called
+        if (options.geographicCoordinateSystem)
+            snapshotDb.setGeographicCoordinateSystem(options.geographicCoordinateSystem);
+        if (options.ecefLocation)
+            snapshotDb.setEcefLocation(options.ecefLocation);
         return snapshotDb;
     }
     /** Create a local [Snapshot]($docs/learning/backend/AccessingIModels.md#snapshot-imodels) iModel file, using this iModel as a *seed* or starting point.
@@ -3262,6 +3335,10 @@ class StandaloneDb extends BriefcaseDb {
         nativeDb.resetBriefcaseId(core_common_1.BriefcaseIdValue.Unassigned);
         nativeDb.saveChanges();
         const db = new this({ nativeDb, key: core_bentley_1.Guid.createValue(), briefcaseId: core_common_1.BriefcaseIdValue.Unassigned, openMode: core_bentley_1.OpenMode.ReadWrite });
+        if (args.geographicCoordinateSystem)
+            db.setGeographicCoordinateSystem(args.geographicCoordinateSystem);
+        if (args.ecefLocation)
+            db.setEcefLocation(args.ecefLocation);
         db.channels.addAllowedChannel(ChannelControl_1.ChannelControl.sharedChannelName);
         return db;
     }