@itwin/core-backend 5.0.0-dev.98 → 5.0.0

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 */
@@ -100,6 +101,7 @@ class IModelDb extends core_common_1.IModel {
     /** @beta */
     channels = (0, ChannelAdmin_1.createChannelControl)(this);
     _relationships;
+    // eslint-disable-next-line @typescript-eslint/no-deprecated
     _statementCache = new SqliteStatement_1.StatementCache();
     _sqliteStatementCache = new SqliteStatement_1.StatementCache();
     _codeSpecs;
@@ -108,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;
@@ -135,6 +137,13 @@ class IModelDb extends core_common_1.IModel {
             this._workspace = (0, WorkspaceImpl_1.constructWorkspace)(new IModelSettings());
         return this._workspace;
     }
+    /**
+     * get the cloud container for this iModel, if it was opened from one
+     * @beta
+     */
+    get cloudContainer() {
+        return this[Symbols_1._nativeDb].cloudContainer;
+    }
     /** Acquire the exclusive schema lock on this iModel.
      * @note: To acquire the schema lock, all other briefcases must first release *all* their locks. No other briefcases
      * will be able to acquire *any* locks while the schema lock is held.
@@ -157,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
     }
@@ -334,8 +343,11 @@ class IModelDb extends core_common_1.IModel {
      * @returns the value returned by `callback`.
      * @see [[withStatement]]
      * @public
+     * @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) {
+        // eslint-disable-next-line @typescript-eslint/no-deprecated
         const stmt = this._statementCache.findAndRemove(ecsql) ?? this.prepareStatement(ecsql, logErrors);
         const release = () => this._statementCache.addOrDispose(stmt);
         try {
@@ -363,8 +375,11 @@ class IModelDb extends core_common_1.IModel {
      * @returns the value returned by `callback`.
      * @see [[withPreparedStatement]]
      * @public
+     * @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) {
+        // eslint-disable-next-line @typescript-eslint/no-deprecated
         const stmt = this.prepareStatement(ecsql, logErrors);
         const release = () => stmt[Symbol.dispose]();
         try {
@@ -542,6 +557,7 @@ class IModelDb extends core_common_1.IModel {
         if (typeof params.offset === "number" && params.offset > 0)
             sql += ` OFFSET ${params.offset}`;
         const ids = new Set();
+        // eslint-disable-next-line @typescript-eslint/no-deprecated
         this.withPreparedStatement(sql, (stmt) => {
             if (params.bindings)
                 stmt.bindValues(params.bindings);
@@ -564,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>
@@ -619,6 +637,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();
     }
     /**
@@ -632,11 +651,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);
@@ -862,7 +884,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
@@ -898,7 +920,7 @@ class IModelDb extends core_common_1.IModel {
     }
     /**
      * Gets the context that allows accessing the metadata (ecschema-metadata package) of this iModel
-     * @beta
+     * @public @preview
      */
     get schemaContext() {
         if (this._schemaContext === undefined) {
@@ -922,8 +944,11 @@ 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 - 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) {
+        // eslint-disable-next-line @typescript-eslint/no-deprecated
         const stmt = new ECSqlStatement_1.ECSqlStatement();
         stmt.prepare(this[Symbols_1._nativeDb], sql, logErrors);
         return stmt;
@@ -931,8 +956,11 @@ 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 - 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) {
+        // eslint-disable-next-line @typescript-eslint/no-deprecated
         const statement = new ECSqlStatement_1.ECSqlStatement();
         const result = statement.tryPrepare(this[Symbols_1._nativeDb], sql);
         return core_bentley_1.DbResult.BE_SQLITE_OK === result.status ? statement : undefined;
@@ -958,9 +986,27 @@ 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.
+     * @deprecated in 5.0 - will not be removed until after 2026-06-13. Please use `getSchemaItem` from `SchemaContext` class instead.
      *
      * @example
      *  * ```typescript
@@ -986,7 +1032,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
@@ -1014,7 +1060,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
@@ -1040,7 +1086,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
@@ -1070,7 +1116,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
@@ -1115,6 +1161,7 @@ class IModelDb extends core_common_1.IModel {
      */
     querySchemaVersion(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()) {
@@ -1435,11 +1482,13 @@ function processSchemaWriteStatus(status) {
 /** @public */
 (function (IModelDb) {
     /** The collection of models in an [[IModelDb]].
-     * @public
+     * @public @preview
      */
     class Models {
         _iModel;
         /** @internal */
+        [Symbols_1._cache] = new core_bentley_1.LRUMap(500);
+        /** @internal */
         constructor(_iModel) {
             this._iModel = _iModel;
         }
@@ -1449,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.
@@ -1459,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.
@@ -1467,6 +1537,7 @@ function processSchemaWriteStatus(status) {
          */
         queryLastModifiedTime(modelId) {
             const sql = `SELECT LastMod FROM ${Model_1.Model.classFullName} WHERE ECInstanceId=:modelId`;
+            // eslint-disable-next-line @typescript-eslint/no-deprecated
             return this._iModel.withPreparedStatement(sql, (statement) => {
                 statement.bindId("modelId", modelId);
                 if (core_bentley_1.DbResult.BE_SQLITE_ROW === statement.step()) {
@@ -1505,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.
@@ -1583,6 +1644,8 @@ 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) {
@@ -1599,6 +1662,7 @@ 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}`);
@@ -1610,6 +1674,7 @@ 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) {
@@ -1643,11 +1708,13 @@ function processSchemaWriteStatus(status) {
     }
     IModelDb.Models = Models;
     /** The collection of elements in an [[IModelDb]].
-     * @public
+     * @public @preview
      */
     class Elements {
         _iModel;
         /** @internal */
+        [Symbols_1._cache] = new ElementLRUCache_1.ElementLRUCache();
+        /** @internal */
         constructor(_iModel) {
             this._iModel = _iModel;
         }
@@ -1663,50 +1730,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.
@@ -1714,14 +1771,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
@@ -1754,7 +1829,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);
@@ -1778,6 +1853,7 @@ 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));
@@ -1793,6 +1869,7 @@ function processSchemaWriteStatus(status) {
          */
         queryLastModifiedTime(elementId) {
             const sql = "SELECT LastMod FROM BisCore:Element WHERE ECInstanceId=:elementId";
+            // eslint-disable-next-line @typescript-eslint/no-deprecated
             return this._iModel.withPreparedStatement(sql, (statement) => {
                 statement.bindId("elementId", elementId);
                 if (core_bentley_1.DbResult.BE_SQLITE_ROW === statement.step())
@@ -1816,6 +1893,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) {
@@ -1837,6 +1919,11 @@ function processSchemaWriteStatus(status) {
          */
         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) {
@@ -1854,6 +1941,7 @@ function processSchemaWriteStatus(status) {
             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) {
@@ -1944,6 +2032,7 @@ function processSchemaWriteStatus(status) {
          */
         queryChildren(elementId) {
             const sql = "SELECT ECInstanceId FROM BisCore:Element WHERE Parent.Id=:elementId";
+            // eslint-disable-next-line @typescript-eslint/no-deprecated
             return this._iModel.withPreparedStatement(sql, (statement) => {
                 statement.bindId("elementId", elementId);
                 const childIds = [];
@@ -1959,6 +2048,7 @@ function processSchemaWriteStatus(status) {
          * @throws [[IModelError]] if the element does not exist
          */
         queryParent(elementId) {
+            // eslint-disable-next-line @typescript-eslint/no-deprecated
             return this._iModel.withPreparedStatement(`select parent.id from ${Element_1.Element.classFullName} where ecinstanceid=?`, (stmt) => {
                 stmt.bindId(1, elementId);
                 if (stmt.step() !== core_bentley_1.DbResult.BE_SQLITE_ROW)
@@ -1975,6 +2065,7 @@ function processSchemaWriteStatus(status) {
                 return false; // Special case since the RepositoryModel does not sub-model the root Subject
             // A sub-model will have the same Id value as the element it is describing
             const sql = "SELECT ECInstanceId FROM BisCore:Model WHERE ECInstanceId=:elementId";
+            // eslint-disable-next-line @typescript-eslint/no-deprecated
             return this._iModel.withPreparedStatement(sql, (statement) => {
                 statement.bindId("elementId", elementId);
                 return core_bentley_1.DbResult.BE_SQLITE_ROW === statement.step();
@@ -1989,6 +2080,7 @@ function processSchemaWriteStatus(status) {
          */
         _queryAspects(elementId, fromClassFullName, excludedClassFullNames) {
             const sql = `SELECT ECInstanceId,ECClassId FROM ${fromClassFullName} WHERE Element.Id=:elementId ORDER BY ECClassId,ECInstanceId`; // ORDER BY to maximize statement reuse
+            // eslint-disable-next-line @typescript-eslint/no-deprecated
             return this._iModel.withPreparedStatement(sql, (statement) => {
                 statement.bindId("elementId", elementId);
                 const aspects = [];
@@ -2007,6 +2099,7 @@ function processSchemaWriteStatus(status) {
          */
         _queryAspect(aspectInstanceId, aspectClassName) {
             const sql = `SELECT * FROM ${aspectClassName} WHERE ECInstanceId=:aspectInstanceId`;
+            // eslint-disable-next-line @typescript-eslint/no-deprecated
             const aspect = this._iModel.withPreparedStatement(sql, (statement) => {
                 statement.bindId("aspectInstanceId", aspectInstanceId);
                 if (core_bentley_1.DbResult.BE_SQLITE_ROW === statement.step()) {
@@ -2027,6 +2120,7 @@ function processSchemaWriteStatus(status) {
          */
         getAspect(aspectInstanceId) {
             const sql = "SELECT ECClassId FROM BisCore:ElementAspect WHERE ECInstanceId=:aspectInstanceId";
+            // eslint-disable-next-line @typescript-eslint/no-deprecated
             const aspectClassFullName = this._iModel.withPreparedStatement(sql, (statement) => {
                 statement.bindId("aspectInstanceId", aspectInstanceId);
                 return (core_bentley_1.DbResult.BE_SQLITE_ROW === statement.step()) ? statement.getValue(0).getClassNameForClassId().replace(".", ":") : undefined;
@@ -2038,6 +2132,7 @@ function processSchemaWriteStatus(status) {
         }
         static classMap = new Map();
         runInstanceQuery(sql, elementId, excludedClassFullNames) {
+            // eslint-disable-next-line @typescript-eslint/no-deprecated
             return this._iModel.withPreparedStatement(sql, (statement) => {
                 statement.bindId("elementId", elementId);
                 const aspects = [];
@@ -2087,8 +2182,11 @@ function processSchemaWriteStatus(status) {
             let classIdList = IModelDb.Elements.classMap.get(aspectClassFullName);
             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]}'
-        and Schema.Id = (select ECInstanceId from meta.ECSchemaDef where Name='${fullClassName[0]}')) and SourceECInstanceId != TargetECInstanceId`, (statement) => {
+        and Schema.Id = (select ECInstanceId from meta.ECSchemaDef where Name='${fullClassName[0]}')) and SourceECInstanceId != TargetECInstanceId`, 
+                // eslint-disable-next-line @typescript-eslint/no-deprecated
+                (statement) => {
                     while (statement.step() === core_bentley_1.DbResult.BE_SQLITE_ROW)
                         classIds.push(statement.getValue(0).getId());
                 });
@@ -2156,7 +2254,7 @@ function processSchemaWriteStatus(status) {
     }
     IModelDb.Elements = Elements;
     /** The collection of views in an [[IModelDb]].
-     * @public
+     * @public @preview
      */
     class Views {
         _iModel;
@@ -2332,7 +2430,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.x - 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) {
@@ -2346,9 +2444,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";
@@ -2588,7 +2686,7 @@ class BriefcaseDb extends IModelDb {
         const file = { path: args.fileName, key: args.key };
         const openMode = (args.readonly || args.watchForChanges) ? core_bentley_1.OpenMode.Readonly : core_bentley_1.OpenMode.ReadWrite;
         const nativeDb = this.openDgnDb(file, openMode, undefined, args);
-        const briefcaseDb = new BriefcaseDb({ nativeDb, key: file.key ?? core_bentley_1.Guid.createValue(), openMode, briefcaseId: nativeDb.getBriefcaseId() });
+        const briefcaseDb = new this({ nativeDb, key: file.key ?? core_bentley_1.Guid.createValue(), openMode, briefcaseId: nativeDb.getBriefcaseId() });
         // If they asked to watch for changes, set an fs.watch on the "-watch" file (only it is modified while we hold this connection.)
         // Whenever there are changes, restart our defaultTxn. That loads the changes from the other connection and sends
         // notifications as if they happened on this connection. Note: the watcher is called only when the backend event loop cycles.
@@ -2597,6 +2695,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();
             });
@@ -2937,7 +3036,7 @@ class RefreshV2CheckpointSas {
         core_bentley_1.Logger.logInfo(BackendLoggerCategory_1.BackendLoggerCategory.Authorization, "attempting to refresh sasToken for checkpoint");
         try {
             // this exchanges the supplied user accessToken for an expiring blob-store token to read the checkpoint.
-            const container = iModel[Symbols_1._nativeDb].cloudContainer;
+            const container = iModel.cloudContainer;
             if (!container)
                 throw new Error("checkpoint is not from a cloud container");
             (0, core_bentley_1.assert)(undefined !== iModel.iTwinId);
@@ -3063,7 +3162,7 @@ class SnapshotDb extends IModelDb {
             file.key = `${nativeDb.getIModelId()}:${nativeDb.getCurrentChangeset().id}`;
         }
         (0, core_bentley_1.assert)(undefined !== file.key);
-        const db = new SnapshotDb(nativeDb, file.key);
+        const db = new this(nativeDb, file.key);
         this.onOpened.raiseEvent(db);
         return db;
     }
@@ -3089,7 +3188,7 @@ class SnapshotDb extends IModelDb {
         snapshot._restartDefaultTxnTimer = setTimeout(() => {
             snapshot.restartDefaultTxn();
         }, (10 * 60) * 1000).unref(); // 10 minutes
-        const cloudContainer = snapshot[Symbols_1._nativeDb].cloudContainer;
+        const cloudContainer = snapshot.cloudContainer;
         if (cloudContainer !== undefined) {
             snapshot._refreshSas = new RefreshV2CheckpointSas(cloudContainer.accessToken, checkpoint.reattachSafetySeconds);
         }
@@ -3164,7 +3263,7 @@ class StandaloneDb extends BriefcaseDb {
         nativeDb.setITwinId(core_bentley_1.Guid.empty);
         nativeDb.resetBriefcaseId(core_common_1.BriefcaseIdValue.Unassigned);
         nativeDb.saveChanges();
-        const db = new StandaloneDb({ nativeDb, key: core_bentley_1.Guid.createValue(), briefcaseId: core_common_1.BriefcaseIdValue.Unassigned, openMode: core_bentley_1.OpenMode.ReadWrite });
+        const db = new this({ nativeDb, key: core_bentley_1.Guid.createValue(), briefcaseId: core_common_1.BriefcaseIdValue.Unassigned, openMode: core_bentley_1.OpenMode.ReadWrite });
         db.channels.addAllowedChannel(ChannelControl_1.ChannelControl.sharedChannelName);
         return db;
     }
@@ -3210,7 +3309,7 @@ class StandaloneDb extends BriefcaseDb {
             if (iTwinId !== core_bentley_1.Guid.empty) // a "standalone" iModel means it is not associated with an iTwin
                 throw new core_common_1.IModelError(core_bentley_1.IModelStatus.WrongIModel, `${filePath} is not a Standalone iModel. iTwinId=${iTwinId}`);
             (0, core_bentley_1.assert)(undefined !== file.key);
-            const db = new StandaloneDb({ nativeDb, key: file.key, openMode, briefcaseId: core_common_1.BriefcaseIdValue.Unassigned });
+            const db = new this({ nativeDb, key: file.key, openMode, briefcaseId: core_common_1.BriefcaseIdValue.Unassigned });
             return db;
         }
         catch (error) {