@itwin/core-backend 5.1.0-dev.3 → 5.1.0-dev.32

package/lib/cjs/IModelDb.js

@@ -50,6 +50,7 @@ const IModelDbFontsImpl_1 = require("./internal/IModelDbFontsImpl");
 const Symbols_1 = require("./internal/Symbols");
 const ecschema_metadata_1 = require("@itwin/ecschema-metadata");
 const Schema_1 = require("./Schema");
+const ElementLRUCache_1 = require("./internal/ElementLRUCache");
 // spell:ignore fontid fontmap
 const loggerCategory = BackendLoggerCategory_1.BackendLoggerCategory.IModelDb;
 /** @internal */
@@ -579,6 +580,8 @@ class IModelDb extends core_common_1.IModel {
         this._jsClassMap = undefined;
         this._schemaMap = undefined;
         this._schemaContext = undefined;
+        this.elements[Symbols_1._cache].clear();
+        this.models[Symbols_1._cache].clear();
     }
     /** Update the project extents for this iModel.
      * <p><em>Example:</em>
@@ -647,6 +650,9 @@ 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();
         }
     }
@@ -979,6 +985,24 @@ class IModelDb extends core_common_1.IModel {
             return ClassRegistry_1.ClassRegistry.getClass(classFullName, this);
         }
     }
+    /** Constructs a ResolveInstanceKeyArgs from given parameters
+     * @throws [[IModelError]] if the combination of supplied parameters is invalid.
+     * @internal
+     */
+    getInstanceArgs(instanceId, baseClassName, federationGuid, code) {
+        if (instanceId && baseClassName) {
+            return { partialKey: { id: instanceId, baseClassName } };
+        }
+        else if (federationGuid) {
+            return { federationGuid };
+        }
+        else if (code) {
+            return { code };
+        }
+        else {
+            throw new core_common_1.IModelError(core_bentley_1.IModelStatus.InvalidId, "Either instanceId and baseClassName or federationGuid or code must be specified");
+        }
+    }
     /** 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.
@@ -1457,10 +1481,13 @@ function processSchemaWriteStatus(status) {
 /** @public */
 (function (IModelDb) {
     /** The collection of models in an [[IModelDb]].
-     * @public
+     * @public @preview
      */
     class Models {
         _iModel;
+        _modelCacheSize = 10;
+        /** @internal */
+        [Symbols_1._cache] = new core_bentley_1.LRUMap(this._modelCacheSize);
         /** @internal */
         constructor(_iModel) {
             this._iModel = _iModel;
@@ -1471,7 +1498,10 @@ function processSchemaWriteStatus(status) {
          * @see tryGetModelProps
          */
         getModelProps(id) {
-            return this.getModelJson({ id });
+            const model = this.tryGetModelProps(id);
+            if (undefined === model)
+                throw new core_common_1.IModelError(core_bentley_1.IModelStatus.NotFound, `Model=${id}`);
+            return model;
         }
         /** Get the ModelProps with the specified identifier.
          * @param modelId The Model identifier.
@@ -1481,7 +1511,25 @@ function processSchemaWriteStatus(status) {
          * @see getModelProps
          */
         tryGetModelProps(id) {
-            return this.tryGetModelJson({ id });
+            try {
+                if (IModelHost_1.IModelHost.configuration?.disableThinnedNativeInstanceWorkflow) {
+                    return this._iModel[Symbols_1._nativeDb].getModel({ id });
+                }
+                const cachedMdl = this[Symbols_1._cache].get(id);
+                if (cachedMdl) {
+                    return cachedMdl;
+                }
+                const options = { useJsNames: true };
+                const instanceKey = this.resolveModelKey({ id });
+                const rawInstance = this._iModel[Symbols_1._nativeDb].readInstance(instanceKey, options);
+                const classDef = this._iModel.getJsClass(rawInstance.classFullName);
+                const modelProps = classDef.deserialize({ row: rawInstance, iModel: this._iModel });
+                this[Symbols_1._cache].set(id, modelProps);
+                return modelProps;
+            }
+            catch {
+                return undefined;
+            }
         }
         /** Query for the last modified time for a [[Model]].
          * @param modelId The Id of the model.
@@ -1528,32 +1576,22 @@ function processSchemaWriteStatus(status) {
                 return model; // modelClass was not specified, cannot call instanceof to validate
             return model instanceof modelClass ? model : undefined;
         }
-        /** Read the properties for a Model as a json string.
-         * @param modelIdArg a json string with the identity of the model to load. Must have either "id" or "code".
-         * @returns a json string with the properties of the model.
-         * @throws [[IModelError]] if the model is not found or cannot be loaded.
-         * @see tryGetModelJson
-         * @internal
-         */
-        getModelJson(modelIdArg) {
-            const modelJson = this.tryGetModelJson(modelIdArg);
-            if (undefined === modelJson) {
-                throw new core_common_1.IModelError(core_bentley_1.IModelStatus.NotFound, `Model=(id: ${modelIdArg.id}, code: ${modelIdArg.code})`);
+        resolveModelKey(modelIdArg) {
+            const baseClassName = "BisCore:Model";
+            let args;
+            if (modelIdArg.id) {
+                args = { partialKey: { id: modelIdArg.id, baseClassName } };
             }
-            return modelJson;
-        }
-        /** Read the properties for a Model as a json string.
-         * @param modelIdArg a json string with the identity of the model to load. Must have either "id" or "code".
-         * @returns a json string with the properties of the model or `undefined` if the model is not found.
-         * @see getModelJson
-         */
-        tryGetModelJson(modelIdArg) {
-            try {
-                return this._iModel[Symbols_1._nativeDb].getModel(modelIdArg);
+            else if (modelIdArg.code) {
+                const modelId = this._iModel.elements.getElementProps({ code: modelIdArg.code }).id;
+                if (!modelId)
+                    throw new core_common_1.IModelError(core_bentley_1.IModelStatus.NotFound, `Model not found with code: [spec:${modelIdArg.code.spec}, scope:${modelIdArg.code.scope}, value:${modelIdArg.code.value}])`);
+                args = { partialKey: { id: modelId, baseClassName } };
             }
-            catch {
-                return undefined;
+            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);
         }
         /** Get the sub-model of the specified Element.
          * See [[IModelDb.Elements.queryElementIdByCode]] for more on how to find an element by Code.
@@ -1597,7 +1635,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.
@@ -1606,10 +1646,14 @@ function processSchemaWriteStatus(status) {
          */
         updateModel(props) {
             try {
+                if (props.id)
+                    this[Symbols_1._cache].delete(props.id);
                 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.
@@ -1622,9 +1666,10 @@ function processSchemaWriteStatus(status) {
          * @see [[TxnManager.onModelGeometryChanged]] for the event emitted in response to such a change.
          */
         updateGeometryGuid(modelId) {
+            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
@@ -1633,10 +1678,13 @@ function processSchemaWriteStatus(status) {
         deleteModel(ids) {
             core_bentley_1.Id64.toIdSet(ids).forEach((id) => {
                 try {
+                    this[Symbols_1._cache].delete(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;
                 }
             });
         }
@@ -1666,10 +1714,13 @@ function processSchemaWriteStatus(status) {
     }
     IModelDb.Models = Models;
     /** The collection of elements in an [[IModelDb]].
-     * @public
+     * @public @preview
      */
     class Elements {
         _iModel;
+        _elementCacheSize = 50;
+        /** @internal */
+        [Symbols_1._cache] = new ElementLRUCache_1.ElementLRUCache(this._elementCacheSize);
         /** @internal */
         constructor(_iModel) {
             this._iModel = _iModel;
@@ -1686,50 +1737,40 @@ function processSchemaWriteStatus(status) {
                 return !stmt.nextRow() ? undefined : stmt.getValueId(0);
             }) : undefined;
         }
-        /** Read element data from the iModel as JSON
-         * @param elementIdArg a json string with the identity of the element to load. Must have one of "id", "federationGuid", or "code".
-         * @returns The JSON properties of the element.
-         * @throws [[IModelError]] if the element is not found or cannot be loaded.
-         * @see tryGetElementJson
-         * @internal
-         */
-        getElementJson(elementId) {
-            const elementProps = this.tryGetElementJson(elementId);
-            if (undefined === elementProps)
-                throw new core_common_1.IModelError(core_bentley_1.IModelStatus.NotFound, `reading element={id: ${elementId.id} federationGuid: ${elementId.federationGuid}, code: ${elementId.code}}`);
-            return elementProps;
-        }
-        /** Read element data from the iModel as JSON
-         * @param loadProps - a json string with the identity of the element to load. Must have one of "id", "federationGuid", or "code".
-         * @returns The JSON properties of the element or `undefined` if the element is not found.
-         * @throws [[IModelError]] if the element exists, but cannot be loaded.
-         * @see getElementJson
-         */
-        tryGetElementJson(loadProps) {
-            try {
-                return this._iModel[Symbols_1._nativeDb].getElement(loadProps);
-            }
-            catch {
-                return undefined;
-            }
-        }
         /** Get properties of an Element by Id, FederationGuid, or Code
          * @throws [[IModelError]] if the element is not found or cannot be loaded.
          * @see tryGetElementProps
          */
         getElementProps(props) {
+            const elProp = this.tryGetElementProps(props);
+            if (undefined === elProp)
+                throw new core_common_1.IModelError(core_bentley_1.IModelStatus.NotFound, `element not found`);
+            return elProp;
+        }
+        resolveElementKey(props) {
+            const baseClassName = "BisCore:Element";
+            let args;
             if (typeof props === "string") {
-                props = core_bentley_1.Id64.isId64(props) ? { id: props } : { federationGuid: props };
+                args = core_bentley_1.Id64.isId64(props) ? { partialKey: { id: props, baseClassName } } : { federationGuid: props };
             }
             else if (props instanceof core_common_1.Code) {
-                props = { code: props };
+                args = { code: props };
             }
-            try {
-                return this._iModel[Symbols_1._nativeDb].getElement(props);
-            }
-            catch (err) {
-                throw new core_common_1.IModelError(err.errorNumber, err.message);
+            else {
+                if (props.id) {
+                    args = { partialKey: { id: props.id, baseClassName } };
+                }
+                else if (props.federationGuid) {
+                    args = { federationGuid: props.federationGuid };
+                }
+                else if (props.code) {
+                    args = { code: props.code };
+                }
+                else {
+                    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);
         }
         /** Get properties of an Element by Id, FederationGuid, or Code
          * @returns The properties of the element or `undefined` if the element is not found.
@@ -1737,14 +1778,32 @@ function processSchemaWriteStatus(status) {
          * @note Useful for cases when an element may or may not exist and throwing an `Error` would be overkill.
          * @see getElementProps
          */
-        tryGetElementProps(elementId) {
-            if (typeof elementId === "string") {
-                elementId = core_bentley_1.Id64.isId64(elementId) ? { id: elementId } : { federationGuid: elementId };
+        tryGetElementProps(props) {
+            if (typeof props === "string") {
+                props = core_bentley_1.Id64.isId64(props) ? { id: props } : { federationGuid: props };
             }
-            else if (elementId instanceof core_common_1.Code) {
-                elementId = { code: elementId };
+            else if (props instanceof core_common_1.Code) {
+                props = { code: props };
+            }
+            try {
+                if (IModelHost_1.IModelHost.configuration?.disableThinnedNativeInstanceWorkflow) {
+                    return this._iModel[Symbols_1._nativeDb].getElement(props);
+                }
+                const cachedElm = this[Symbols_1._cache].get(props);
+                if (cachedElm) {
+                    return cachedElm.elProps;
+                }
+                const options = { ...props, useJsNames: true };
+                const instanceKey = this.resolveElementKey(props);
+                const rawInstance = this._iModel[Symbols_1._nativeDb].readInstance(instanceKey, options);
+                const classDef = this._iModel.getJsClass(rawInstance.classFullName);
+                const elementProps = classDef.deserialize({ row: rawInstance, iModel: this._iModel, options: { element: props } });
+                this[Symbols_1._cache].set({ elProps: elementProps, loadOptions: props });
+                return elementProps;
+            }
+            catch {
+                return undefined;
             }
-            return this.tryGetElementJson(elementId);
         }
         /** Get an element by Id, FederationGuid, or Code
          * @param elementId either the element's Id, Code, or FederationGuid, or an ElementLoadProps
@@ -1777,7 +1836,7 @@ function processSchemaWriteStatus(status) {
                 elementId = { code: elementId };
             else
                 elementId.onlyBaseProperties = false; // we must load all properties to construct the element.
-            const elementProps = this.tryGetElementJson(elementId);
+            const elementProps = this.tryGetElementProps(elementId);
             if (undefined === elementProps)
                 return undefined; // no Element with that elementId found
             const element = this._iModel.constructEntity(elementProps);
@@ -1833,7 +1892,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]])
@@ -1841,6 +1900,11 @@ function processSchemaWriteStatus(status) {
          */
         insertElement(elProps, options) {
             try {
+                this[Symbols_1._cache].delete({
+                    id: elProps.id,
+                    federationGuid: elProps.federationGuid,
+                    code: elProps.code,
+                });
                 return elProps.id = this._iModel[Symbols_1._nativeDb].insertElement(elProps, options);
             }
             catch (err) {
@@ -1858,10 +1922,15 @@ 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 {
+                this[Symbols_1._cache].delete({
+                    id: elProps.id,
+                    federationGuid: elProps.federationGuid,
+                    code: elProps.code,
+                });
                 this._iModel[Symbols_1._nativeDb].updateElement(elProps);
             }
             catch (err) {
@@ -1872,13 +1941,14 @@ 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) {
             const iModel = this._iModel;
             core_bentley_1.Id64.toIdSet(ids).forEach((id) => {
                 try {
+                    this[Symbols_1._cache].delete({ id });
                     iModel[Symbols_1._nativeDb].deleteElement(id);
                 }
                 catch (err) {
@@ -2098,9 +2168,9 @@ function processSchemaWriteStatus(status) {
          */
         getAspects(elementId, aspectClassFullName, excludedClassFullNames) {
             if (aspectClassFullName === undefined) {
-                const allAspects = this.runInstanceQuery(`SELECT $ FROM (
-          SELECT ECInstanceId, ECClassId FROM Bis.ElementMultiAspect WHERE Element.Id = :elementId
-            UNION ALL
+                const allAspects = this.runInstanceQuery(`SELECT $ FROM (
+          SELECT ECInstanceId, ECClassId FROM Bis.ElementMultiAspect WHERE Element.Id = :elementId
+            UNION ALL
           SELECT ECInstanceId, ECClassId FROM Bis.ElementUniqueAspect WHERE Element.Id = :elementId) OPTIONS USE_JS_PROP_NAMES DO_NOT_TRUNCATE_BLOB`, elementId, excludedClassFullNames);
                 if (allAspects.length === 0)
                     core_bentley_1.Logger.logInfo(BackendLoggerCategory_1.BackendLoggerCategory.ECDb, `No aspects found for class ${aspectClassFullName} and element ${elementId}`);
@@ -2120,7 +2190,7 @@ function processSchemaWriteStatus(status) {
             if (classIdList === undefined) {
                 const classIds = [];
                 // eslint-disable-next-line @typescript-eslint/no-deprecated
-                this._iModel.withPreparedStatement(`select SourceECInstanceId from meta.ClassHasAllBaseClasses where TargetECInstanceId = (select ECInstanceId from meta.ECClassDef where Name='${fullClassName[1]}'
+                this._iModel.withPreparedStatement(`select SourceECInstanceId from meta.ClassHasAllBaseClasses where TargetECInstanceId = (select ECInstanceId from meta.ECClassDef where Name='${fullClassName[1]}'
         and Schema.Id = (select ECInstanceId from meta.ECSchemaDef where Name='${fullClassName[0]}')) and SourceECInstanceId != TargetECInstanceId`, 
                 // eslint-disable-next-line @typescript-eslint/no-deprecated
                 (statement) => {
@@ -2137,10 +2207,10 @@ function processSchemaWriteStatus(status) {
                 return [];
             }
             // Execute an instance query to retrieve all aspects from all the derived classes
-            const aspects = this.runInstanceQuery(`SELECT $ FROM (
-        SELECT ECInstanceId, ECClassId FROM Bis.ElementMultiAspect WHERE Element.Id = :elementId AND ECClassId IN (${classIdList})
-          UNION ALL
-        SELECT ECInstanceId, ECClassId FROM Bis.ElementUniqueAspect WHERE Element.Id = :elementId AND ECClassId IN (${classIdList})
+            const aspects = this.runInstanceQuery(`SELECT $ FROM (
+        SELECT ECInstanceId, ECClassId FROM Bis.ElementMultiAspect WHERE Element.Id = :elementId AND ECClassId IN (${classIdList})
+          UNION ALL
+        SELECT ECInstanceId, ECClassId FROM Bis.ElementUniqueAspect WHERE Element.Id = :elementId AND ECClassId IN (${classIdList})
         ) OPTIONS USE_JS_PROP_NAMES DO_NOT_TRUNCATE_BLOB`, elementId, excludedClassFullNames);
             if (aspects.length === 0)
                 core_bentley_1.Logger.logInfo(BackendLoggerCategory_1.BackendLoggerCategory.ECDb, `No aspects found for class ${aspectClassFullName} and element ${elementId}`);
@@ -2158,7 +2228,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.
@@ -2170,7 +2242,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.
@@ -2184,14 +2258,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;
@@ -2217,7 +2293,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({
@@ -2338,7 +2414,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.
@@ -2381,9 +2457,9 @@ function processSchemaWriteStatus(status) {
     }
     IModelDb.Views = Views;
     /** Represents the current state of a pollable tile content request.
-   * Note: lack of a "completed" state because polling a completed request returns the content as a Uint8Array.
-   * @internal
-   */
+    * Note: lack of a "completed" state because polling a completed request returns the content as a Uint8Array.
+    * @internal
+    */
     let TileContentState;
     (function (TileContentState) {
         TileContentState[TileContentState["New"] = 0] = "New";
@@ -2632,6 +2708,7 @@ class BriefcaseDb extends IModelDb {
             touch.sync(briefcaseDb.watchFilePathName);
             // Restart default txn to trigger events when watch file is changed by some other process.
             const watcher = fs.watch(briefcaseDb.watchFilePathName, { persistent: false }, () => {
+                nativeDb.clearECDbCache();
                 nativeDb.restartDefaultTxn();
                 briefcaseDb.changeset = briefcaseDb[Symbols_1._nativeDb].getCurrentChangeset();
             });
@@ -3045,6 +3122,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.
@@ -3200,6 +3281,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;
     }