@itwin/core-backend 5.0.0-dev.11 → 5.0.0-dev.111

package/lib/cjs/IModelDb.js

@@ -46,7 +46,11 @@ const WorkspaceImpl_1 = require("./internal/workspace/WorkspaceImpl");
 const SettingsImpl_1 = require("./internal/workspace/SettingsImpl");
 const NativePlatform_1 = require("./internal/NativePlatform");
 const NoLocks_1 = require("./internal/NoLocks");
+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 */
@@ -85,10 +89,45 @@ class IModelSettings extends SettingsImpl_1.SettingsImpl {
  * @public
  */
 class IModelDb extends core_common_1.IModel {
+    _initialized = false;
+    /** Keep track of open imodels to support `tryFind` for RPC purposes */
+    static _openDbs = new Map();
+    static defaultLimit = 1000; // default limit for batching queries
+    static maxLimit = 10000; // maximum limit for batching queries
+    models = new IModelDb.Models(this);
+    elements = new IModelDb.Elements(this);
+    views = new IModelDb.Views(this);
+    tiles = new IModelDb.Tiles(this);
+    /** @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;
+    // eslint-disable-next-line @typescript-eslint/no-deprecated
+    _classMetaDataRegistry;
+    _jsClassMap;
+    _schemaMap;
+    _schemaContext;
+    /** @deprecated in 5.0.0. Use [[fonts]]. */
+    _fontMap; // eslint-disable-line @typescript-eslint/no-deprecated
+    _fonts = (0, IModelDbFontsImpl_1.createIModelDbFonts)(this);
+    _workspace;
+    _snaps = new Map();
+    static _shutdownListener; // so we only register listener once
+    /** @internal */
+    _locks = (0, NoLocks_1.createNoOpLockControl)();
+    /** @internal */
+    _codeService;
     /** @alpha */
     get codeService() { return this._codeService; }
     /** The [[LockControl]] that orchestrates [concurrent editing]($docs/learning/backend/ConcurrencyControl.md) of this iModel. */
     get locks() { return this._locks; } // eslint-disable-line @typescript-eslint/no-non-null-assertion
+    /** Provides methods for interacting with [font-related information]($docs/learning/backend/Fonts.md) stored in this iModel.
+     * @beta
+     */
+    get fonts() { return this._fonts; }
     /**
      * Get the [[Workspace]] for this iModel.
      * @beta
@@ -98,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.
@@ -109,6 +155,8 @@ class IModelDb extends core_common_1.IModel {
     get holdsSchemaLock() {
         return this.locks.holdsExclusiveLock(core_common_1.IModel.repositoryModelId);
     }
+    /** Event called after a changeset is applied to this IModelDb. */
+    onChangesetApplied = new core_bentley_1.BeEvent();
     /** @internal */
     notifyChangesetApplied() {
         this.changeset = this[Symbols_1._nativeDb].getCurrentChangeset();
@@ -118,25 +166,14 @@ class IModelDb extends core_common_1.IModel {
     restartDefaultTxn() {
         this[Symbols_1._nativeDb].restartDefaultTxn();
     }
+    /** @deprecated in 5.0.0. Use [[fonts]]. */
     get fontMap() {
-        return this._fontMap ?? (this._fontMap = new core_common_1.FontMap(this[Symbols_1._nativeDb].readFontMap()));
+        return this._fontMap ?? (this._fontMap = new core_common_1.FontMap(this[Symbols_1._nativeDb].readFontMap())); // eslint-disable-line @typescript-eslint/no-deprecated
     }
     /** @internal */
     clearFontMap() {
-        this._fontMap = undefined;
-    }
-    /**
-     * Add a new font name/type to the FontMap for this iModel and return its FontId.
-     * @param name The name of the font to add
-     * @param type The type of the font. Default is TrueType.
-     * @returns The FontId for the newly added font. If a font by that name/type already exists, this method does not fail, it returns the existing Id.
-     * @see [FontId and FontMap]($docs/learning/backend/Fonts.md#fontid-and-fontmap)
-     * @beta
-     */
-    addNewFont(name, type) {
-        this.locks.checkExclusiveLock(core_common_1.IModel.repositoryModelId, "schema", "addNewFont");
-        this.clearFontMap();
-        return this[Symbols_1._nativeDb].addNewFont({ name, type: type ?? core_common_1.FontType.TrueType });
+        this._fontMap = undefined; // eslint-disable-line @typescript-eslint/no-deprecated
+        this[Symbols_1._nativeDb].invalidateFontMap();
     }
     /** Check if this iModel has been opened read-only or not. */
     get isReadonly() { return this.openMode === core_bentley_1.OpenMode.Readonly; }
@@ -145,10 +182,8 @@ class IModelDb extends core_common_1.IModel {
         (0, core_bentley_1.assert)(undefined !== super.iModelId);
         return super.iModelId;
     } // GuidString | undefined for the IModel superclass, but required for all IModelDb subclasses
-    /** @internal
-     * @deprecated in 4.8. This internal API will be removed in 5.0. Use IModelDb's public API instead.
-     */
-    get nativeDb() { return this[Symbols_1._nativeDb]; }
+    /** @internal*/
+    [Symbols_1._nativeDb];
     /** Get the full path fileName of this iModelDb
      * @note this member is only valid while the iModel is opened.
      */
@@ -164,22 +199,6 @@ class IModelDb extends core_common_1.IModel {
     /** @internal */
     constructor(args) {
         super({ ...args, iTwinId: args.nativeDb.getITwinId(), iModelId: args.nativeDb.getIModelId() });
-        this._initialized = false;
-        this.models = new IModelDb.Models(this);
-        this.elements = new IModelDb.Elements(this);
-        this.views = new IModelDb.Views(this);
-        this.tiles = new IModelDb.Tiles(this);
-        /** @beta */
-        this.channels = (0, ChannelAdmin_1.createChannelControl)(this);
-        this._statementCache = new SqliteStatement_1.StatementCache();
-        this._sqliteStatementCache = new SqliteStatement_1.StatementCache();
-        this._snaps = new Map();
-        /** @internal */
-        this._locks = (0, NoLocks_1.createNoOpLockControl)();
-        /** Event called after a changeset is applied to this IModelDb. */
-        this.onChangesetApplied = new core_bentley_1.BeEvent();
-        /** Event called when the iModel is about to be closed. */
-        this.onBeforeClose = new core_bentley_1.BeEvent();
         this[Symbols_1._nativeDb] = args.nativeDb;
         // it is illegal to create an IModelDb unless the nativeDb has been opened. Throw otherwise.
         if (!this.isOpen)
@@ -209,6 +228,40 @@ class IModelDb extends core_common_1.IModel {
             });
         }
     }
+    /**
+     * Attach an iModel file to this connection and load and register its schemas.
+     * @note There are some reserve tablespace names that cannot be used. They are 'main', 'schema_sync_db', 'ecchange' & 'temp'
+     * @param fileName IModel file name
+     * @param alias identifier for the attached file. This identifer is used to access schema from the attached file. e.g. if alias is 'abc' then schema can be accessed using 'abc.MySchema.MyClass'
+     *
+     * *Example:*
+     * ``` ts
+     *  [[include:IModelDb_attachDb.code]]
+     * ```
+     */
+    attachDb(fileName, alias) {
+        if (alias.toLowerCase() === "main" || alias.toLowerCase() === "schema_sync_db" || alias.toLowerCase() === "ecchange" || alias.toLowerCase() === "temp") {
+            throw new core_common_1.IModelError(core_bentley_1.DbResult.BE_SQLITE_ERROR, "Reserved tablespace name cannot be used");
+        }
+        this[Symbols_1._nativeDb].attachDb(fileName, alias);
+    }
+    /**
+     * Detach the attached file from this connection. The attached file is closed and its schemas are unregistered.
+     * @note There are some reserve tablespace names that cannot be used. They are 'main', 'schema_sync_db', 'ecchange' & 'temp'
+     * @param alias identifer that was used in the call to [[attachDb]]
+     *
+     * *Example:*
+     * ``` ts
+     *  [[include:IModelDb_attachDb.code]]
+     * ```
+     */
+    detachDb(alias) {
+        if (alias.toLowerCase() === "main" || alias.toLowerCase() === "schema_sync_db" || alias.toLowerCase() === "ecchange" || alias.toLowerCase() === "temp") {
+            throw new core_common_1.IModelError(core_bentley_1.DbResult.BE_SQLITE_ERROR, "Reserved tablespace name cannot be used");
+        }
+        this.clearCaches();
+        this[Symbols_1._nativeDb].detachDb(alias);
+    }
     /** Close this IModel, if it is currently open, and save changes if it was opened in ReadWrite mode. */
     close() {
         if (!this.isOpen)
@@ -226,6 +279,8 @@ class IModelDb extends core_common_1.IModel {
     }
     /** @internal */
     async refreshContainerForRpc(_userAccessToken) { }
+    /** Event called when the iModel is about to be closed. */
+    onBeforeClose = new core_bentley_1.BeEvent();
     /**
      * Called by derived classes before closing the connection
      * @internal
@@ -235,8 +290,8 @@ class IModelDb extends core_common_1.IModel {
         this.clearCaches();
     }
     /** @internal */
-    initializeIModelDb() {
-        const props = this[Symbols_1._nativeDb].getIModelProps();
+    initializeIModelDb(when) {
+        const props = this[Symbols_1._nativeDb].getIModelProps(when);
         super.initialize(props.rootSubject.name, props);
         if (this._initialized)
             return;
@@ -288,8 +343,11 @@ class IModelDb extends core_common_1.IModel {
      * @returns the value returned by `callback`.
      * @see [[withStatement]]
      * @public
+     * @deprecated in 4.11.  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 {
@@ -317,10 +375,13 @@ class IModelDb extends core_common_1.IModel {
      * @returns the value returned by `callback`.
      * @see [[withPreparedStatement]]
      * @public
+     * @deprecated in 4.11.  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.dispose();
+        const release = () => stmt[Symbol.dispose]();
         try {
             const val = callback(stmt);
             if (val instanceof Promise) {
@@ -358,70 +419,6 @@ class IModelDb extends core_common_1.IModel {
         };
         return new core_common_1.ECSqlReader(executor, ecsql, params, config);
     }
-    /** Execute a query and stream its results
-     * The result of the query is async iterator over the rows. The iterator will get next page automatically once rows in current page has been read.
-     * [ECSQL row]($docs/learning/ECSQLRowFormat).
-     *
-     * See also:
-     * - [ECSQL Overview]($docs/learning/backend/ExecutingECSQL)
-     * - [Code Examples]($docs/learning/backend/ECSQLCodeExamples)
-     *
-     * @param ecsql The ECSQL statement to execute
-     * @param params The values to bind to the parameters (if the ECSQL has any).
-     * @param options Allow to specify certain flags which control how query is executed.
-     * @returns Returns the query result as an *AsyncIterableIterator<any>*  which lazy load result as needed. The row format is determined by *rowFormat* parameter.
-     * See [ECSQL row format]($docs/learning/ECSQLRowFormat) for details about the format of the returned rows.
-     * @throws [IModelError]($common) If there was any error while submitting, preparing or stepping into query
-     * @deprecated in 3.7. Use [[createQueryReader]] instead; it accepts the same parameters.
-     */
-    async *query(ecsql, params, options) {
-        const builder = new core_common_1.QueryOptionsBuilder(options);
-        const reader = this.createQueryReader(ecsql, params, builder.getOptions());
-        while (await reader.step())
-            yield reader.formatCurrentRow();
-    }
-    /** Compute number of rows that would be returned by the ECSQL.
-     *
-     * See also:
-     * - [ECSQL Overview]($docs/learning/backend/ExecutingECSQL)
-     * - [Code Examples]($docs/learning/backend/ECSQLCodeExamples)
-     *
-     * @param ecsql The ECSQL statement to execute
-     * @param params The values to bind to the parameters (if the ECSQL has any).
-     * See "[iTwin.js Types used in ECSQL Parameter Bindings]($docs/learning/ECSQLParameterTypes)" for details.
-     * @returns Return row count.
-     * @throws [IModelError]($common) If the statement is invalid
-     * @deprecated in 3.7. Count the number of results using `count(*)` where the original query is a subquery instead. E.g., `SELECT count(*) FROM (<query-whose-rows-to-count>)`.
-     */
-    async queryRowCount(ecsql, params) {
-        for await (const row of this.createQueryReader(`SELECT count(*) FROM (${ecsql})`, params)) {
-            return row[0];
-        }
-        throw new core_common_1.IModelError(core_bentley_1.DbResult.BE_SQLITE_ERROR, "Failed to get row count");
-    }
-    /** Cancel any previous query with same token and run execute the current specified query.
-     * The result of the query is async iterator over the rows. The iterator will get next page automatically once rows in current page has been read.
-     * [ECSQL row]($docs/learning/ECSQLRowFormat).
-     *
-     * See also:
-     * - [ECSQL Overview]($docs/learning/backend/ExecutingECSQL)
-     * - [Code Examples]($docs/learning/backend/ECSQLCodeExamples)
-     *
-     * @param ecsql The ECSQL statement to execute
-     * @param token None empty restart token. The previous query with same token would be cancelled. This would cause
-     * exception which user code must handle.
-     * @param params The values to bind to the parameters (if the ECSQL has any).
-     * @param options Allow to specify certain flags which control how query is executed.
-     * @returns Returns the query result as an *AsyncIterableIterator<any>*  which lazy load result as needed. The row format is determined by *rowFormat* parameter.
-     * See [ECSQL row format]($docs/learning/ECSQLRowFormat) for details about the format of the returned rows.
-     * @throws [IModelError]($common) If there was any error while submitting, preparing or stepping into query
-     * @deprecated in 3.7. Use [[createQueryReader]] instead. Pass in the restart token as part of the `config` argument; e.g., `{ restartToken: myToken }` or `new QueryOptionsBuilder().setRestartToken(myToken).getOptions()`.
-     */
-    async *restartQuery(token, ecsql, params, options) {
-        for await (const row of this.createQueryReader(ecsql, params, new core_common_1.QueryOptionsBuilder(options).setRestartToken(token).getOptions())) {
-            yield row;
-        }
-    }
     /**
      * Use a prepared SQL statement, potentially from the statement cache. If the requested statement doesn't exist
      * in the statement cache, a new statement is prepared. After the callback completes, the statement is reset and saved
@@ -465,7 +462,7 @@ class IModelDb extends core_common_1.IModel {
      */
     withSqliteStatement(sql, callback, logErrors = true) {
         const stmt = this.prepareSqliteStatement(sql, logErrors);
-        const release = () => stmt.dispose();
+        const release = () => stmt[Symbol.dispose]();
         try {
             const val = callback(stmt);
             if (val instanceof Promise) {
@@ -560,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);
@@ -579,6 +577,11 @@ class IModelDb extends core_common_1.IModel {
         this._statementCache.clear();
         this._sqliteStatementCache.clear();
         this._classMetaDataRegistry = undefined;
+        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>
@@ -617,9 +620,11 @@ class IModelDb extends core_common_1.IModel {
     updateIModelProps() {
         this[Symbols_1._nativeDb].updateIModelProps(this.toJSON());
     }
-    /** Commit pending changes to this iModel.
+    /** Commit unsaved changes in memory as a Txn to this iModelDb.
      * @param description Optional description of the changes
      * @throws [[IModelError]] if there is a problem saving changes or if there are pending, un-processed lock or code requests.
+     * @note This will not push changes to the iModelHub.
+     * @see [[IModelDb.pushChanges]] to push changes to the iModelHub.
      */
     saveChanges(description) {
         if (this.openMode === core_bentley_1.OpenMode.Readonly)
@@ -628,7 +633,9 @@ class IModelDb extends core_common_1.IModel {
         if (core_bentley_1.DbResult.BE_SQLITE_OK !== stat)
             throw new core_common_1.IModelError(stat, `Could not save changes (${description})`);
     }
-    /** Abandon pending changes in this iModel. */
+    /** Abandon changes in memory that have not been saved as a Txn to this iModelDb.
+     * @note This will not delete Txns that have already been saved, even if they have not yet been pushed.
+    */
     abandonChanges() {
         this[Symbols_1._nativeDb].abandonChanges();
     }
@@ -873,12 +880,54 @@ 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.
+     *
+     * @example
+     * ```typescript
+     * // Current usage:
+     * const classMetaData: EntityMetaData | undefined = iModel.classMetaDataRegistry.find("SchemaName:ClassName");
+     *
+     * // Replacement:
+     * const metaData: EntityClass | undefined = imodel.schemaContext.getSchemaItemSync("SchemaName.ClassName", EntityClass);
+     * ```
      */
+    // eslint-disable-next-line @typescript-eslint/no-deprecated
     get classMetaDataRegistry() {
         if (this._classMetaDataRegistry === undefined)
+            // eslint-disable-next-line @typescript-eslint/no-deprecated
             this._classMetaDataRegistry = new ClassRegistry_1.MetaDataRegistry();
         return this._classMetaDataRegistry;
     }
+    /**
+     * Allows registering js classes mapped to ECClasses
+     */
+    get jsClassMap() {
+        if (this._jsClassMap === undefined)
+            this._jsClassMap = new ClassRegistry_1.EntityJsClassMap();
+        return this._jsClassMap;
+    }
+    /**
+     * Allows locally registering a schema for this imodel, in constrast to [Schemas.registerSchema] which is a global operation
+     */
+    get schemaMap() {
+        if (this._schemaMap === undefined)
+            this._schemaMap = new Schema_1.SchemaMap();
+        return this._schemaMap;
+    }
+    /**
+     * Gets the context that allows accessing the metadata (ecschema-metadata package) of this iModel
+     * @public @preview
+     */
+    get schemaContext() {
+        if (this._schemaContext === undefined) {
+            const context = new ecschema_metadata_1.SchemaContext();
+            // TODO: We probably need a more optimized locater for here
+            const locater = new ecschema_metadata_1.SchemaJsonLocater((name) => this.getSchemaProps(name));
+            context.addLocater(locater);
+            this._schemaContext = context;
+        }
+        return this._schemaContext;
+    }
     /** Get the linkTableRelationships for this IModel */
     get relationships() {
         return this._relationships || (this._relationships = new Relationship_1.Relationships(this));
@@ -891,8 +940,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.  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;
@@ -900,8 +952,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.  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;
@@ -922,26 +977,72 @@ class IModelDb extends core_common_1.IModel {
             if (!ClassRegistry_1.ClassRegistry.isNotFoundError(err)) {
                 throw err;
             }
+            // eslint-disable-next-line @typescript-eslint/no-deprecated
             this.loadMetaData(classFullName);
             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.
+     *
+     * @example
+     *  * ```typescript
+     * // Current usage:
+     * const metaData: EntityMetaData = imodel.getMetaData("SchemaName:ClassName");
+     *
+     * // Replacement:
+     * const metaData: EntityClass | undefined = imodel.schemaContext.getSchemaItemSync("SchemaName", "ClassName", EntityClass);
+     * ```
      */
+    // eslint-disable-next-line @typescript-eslint/no-deprecated
     getMetaData(classFullName) {
+        // eslint-disable-next-line @typescript-eslint/no-deprecated
         let metadata = this.classMetaDataRegistry.find(classFullName);
         if (metadata === undefined) {
+            // eslint-disable-next-line @typescript-eslint/no-deprecated
             this.loadMetaData(classFullName);
+            // eslint-disable-next-line @typescript-eslint/no-deprecated
             metadata = this.classMetaDataRegistry.find(classFullName);
             if (metadata === undefined)
                 throw ClassRegistry_1.ClassRegistry.makeMetaDataNotFoundError(classFullName); // do not log
         }
         return metadata;
     }
-    /** Identical to [[getMetaData]], except it returns `undefined` instead of throwing an error if the metadata cannot be found nor loaded. */
+    /** 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.
+     *
+     * @example
+     *  * ```typescript
+     * // Current usage:
+     * const metaData: EntityMetaData | undefined = imodel.tryGetMetaData("SchemaName:ClassName");
+     *
+     * // Replacement:
+     * const metaData: EntityClass | undefined = imodel.schemaContext.getSchemaItemSync("SchemaName.ClassName", EntityClass);
+     * ```
+     */
+    // eslint-disable-next-line @typescript-eslint/no-deprecated
     tryGetMetaData(classFullName) {
         try {
+            // eslint-disable-next-line @typescript-eslint/no-deprecated
             return this.getMetaData(classFullName);
         }
         catch {
@@ -955,8 +1056,24 @@ 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.
+     *
+     * @example
+     * ```typescript
+     * // Current usage:
+     * IModelDb.forEachMetaData(imodel, "BisCore:Element", true, (name: string, propMetaData: PropertyMetaData) => {
+     *   console.log(`Property name: ${name}, Property type: ${propMetaData.primitiveType}`);
+     * }, false);
+     *
+     * // Replacement:
+     * await IModelDb.forEachProperty(imodel, "TestDomain.TestDomainClass", true, (propName: string, property: Property) => {
+     *   console.log(`Property name: ${propName}, Property type: ${property.propertyType}`);
+     * }, false);
+     * ```
      */
+    // eslint-disable-next-line @typescript-eslint/no-deprecated
     static forEachMetaData(iModel, classFullName, wantSuper, func, includeCustom = true) {
+        // eslint-disable-next-line @typescript-eslint/no-deprecated
         iModel.forEachMetaData(classFullName, wantSuper, func, includeCustom);
     }
     /** Invoke a callback on each property of the specified class, optionally including superclass properties.
@@ -965,8 +1082,24 @@ 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.
+     *
+     * @example
+     * ```typescript
+     * // Current usage:
+     * iModel.forEachMetaData("BisCore:Element", true, (name: string, propMetaData: PropertyMetaData) => {
+     *   console.log(`Property name: ${name}, Property type: ${propMetaData.primitiveType}`);
+     * });
+     *
+     * // Replacement:
+     * imodel.schemaContext.forEachProperty("BisCore:Element", true, (propName: string, property: Property) => {
+     *   console.log(`Property name: ${propName}, Property type: ${property.propertyType}`);
+     * });
+     * ```
      */
+    // eslint-disable-next-line @typescript-eslint/no-deprecated
     forEachMetaData(classFullName, wantSuper, func, includeCustom = true) {
+        // eslint-disable-next-line @typescript-eslint/no-deprecated
         const meta = this.getMetaData(classFullName); // will load if necessary
         for (const propName in meta.properties) { // eslint-disable-line guard-for-in
             const propMeta = meta.properties[propName];
@@ -974,10 +1107,15 @@ class IModelDb extends core_common_1.IModel {
                 func(propName, propMeta);
         }
         if (wantSuper && meta.baseClasses && meta.baseClasses.length > 0)
+            // eslint-disable-next-line @typescript-eslint/no-deprecated
             meta.baseClasses.forEach((baseClass) => this.forEachMetaData(baseClass, true, func, includeCustom));
     }
-    /** @internal */
+    /**
+     * @internal
+     * @deprecated in 5.0. Please use `schemaContext` from `iModel` instead to get metadata.
+     */
     loadMetaData(classFullName) {
+        // eslint-disable-next-line @typescript-eslint/no-deprecated
         if (this.classMetaDataRegistry.find(classFullName))
             return;
         const className = classFullName.split(":");
@@ -987,10 +1125,13 @@ class IModelDb extends core_common_1.IModel {
         if (val.error)
             throw new core_common_1.IModelError(val.error.status, `Error getting class meta data for: ${classFullName}`);
         (0, core_bentley_1.assert)(undefined !== val.result);
+        // eslint-disable-next-line @typescript-eslint/no-deprecated
         const metaData = new core_common_1.EntityMetaData(JSON.parse(val.result));
+        // eslint-disable-next-line @typescript-eslint/no-deprecated
         this.classMetaDataRegistry.add(classFullName, metaData);
         // Recursive, to make sure that base classes are cached.
         if (metaData.baseClasses !== undefined && metaData.baseClasses.length > 0)
+            // eslint-disable-next-line @typescript-eslint/no-deprecated
             metaData.baseClasses.forEach((baseClassName) => this.loadMetaData(baseClassName));
     }
     /** Returns the full schema for the input name.
@@ -1016,6 +1157,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()) {
@@ -1192,6 +1334,7 @@ class IModelDb extends core_common_1.IModel {
     async generateElementGraphics(request) {
         return (0, ElementGraphics_1.generateElementGraphics)(request, this);
     }
+    static _settingPropNamespace = "settings";
     /** Save a `SettingDictionary` in this iModel that will be loaded into [[workspace.settings]] every time this iModel is opened in future sessions.
      * @param name The name for the SettingDictionary. If a dictionary by that name already exists in the iModel, its value is replaced.
      * @param dict The SettingDictionary object to stringify and save.
@@ -1284,19 +1427,63 @@ class IModelDb extends core_common_1.IModel {
             justification: core_geometry_1.Range2d.fromJSON(props.justification),
         };
     }
+    /** Writes the contents of a single ECSchema to a file on the local file system.
+     * @beta
+     */
+    exportSchema(args) {
+        processSchemaWriteStatus(this[Symbols_1._nativeDb].exportSchema(args.schemaName, args.outputDirectory, args.outputFileName));
+    }
+    /** Writes the contents of all ECSchemas in this iModel to files in a directory on the local file system.
+     * @beta
+     */
+    exportSchemas(outputDirectory) {
+        processSchemaWriteStatus(this[Symbols_1._nativeDb].exportSchemas(outputDirectory));
+    }
+    /** Attempt to simplify the geometry stream of a single [[GeometricElement]] or [[GeometryPart]] as specified by `args`.
+     * @beta
+     */
+    simplifyElementGeometry(args) {
+        return this[Symbols_1._nativeDb].simplifyElementGeometry(args);
+    }
+    /** Attempts to optimize all of the geometry in this iModel by identifying [[GeometryPart]]s that are referenced by exactly one
+     * element's geometry stream. Each such reference is replaced by inserting the part's geometry directly into the element's geometry stream.
+     * Then, the no-longer-used geometry part is deleted.
+     * This can improve performance when a connector inadvertently creates large numbers of parts that are each only used once.
+     * @beta
+     */
+    inlineGeometryParts() {
+        return this[Symbols_1._nativeDb].inlineGeometryPartReferences();
+    }
+    /** Returns a string representation of the error that most recently arose during an operation on the underlying SQLite database.
+     * If no errors have occurred, an empty string is returned.
+     * Otherwise, a string of the format `message (code)` is returned, where `message` is a human-readable diagnostic string and `code` is an integer status code.
+     * See [SQLite error codes and messages](https://www.sqlite.org/c3ref/errcode.html)
+     * @note Do not rely upon this value or its specific contents in error handling logic. It is only intended for use in debugging.
+     */
+    getLastError() {
+        return this[Symbols_1._nativeDb].getLastError();
+    }
 }
 exports.IModelDb = IModelDb;
-/** Keep track of open imodels to support `tryFind` for RPC purposes */
-IModelDb._openDbs = new Map();
-IModelDb.defaultLimit = 1000; // default limit for batching queries
-IModelDb.maxLimit = 10000; // maximum limit for batching queries
-IModelDb._settingPropNamespace = "settings";
+function processSchemaWriteStatus(status) {
+    switch (status) {
+        case 0 /* SchemaWriteStatus.Success */: return;
+        case 1 /* SchemaWriteStatus.FailedToSaveXml */: throw new Error("Failed to save schema XML");
+        case 2 /* SchemaWriteStatus.FailedToCreateXml */: throw new Error("Failed to create schema XML");
+        case 3 /* SchemaWriteStatus.FailedToCreateJson */: throw new Error("Failed to create schema JSON");
+        case 4 /* SchemaWriteStatus.FailedToWriteFile */: throw new Error("Failed to write schema file");
+        default: throw new Error("Unknown error while exporting schema");
+    }
+}
 /** @public */
 (function (IModelDb) {
     /** The collection of models in an [[IModelDb]].
      * @public
      */
     class Models {
+        _iModel;
+        /** @internal */
+        [Symbols_1._cache] = new core_bentley_1.LRUMap(500);
         /** @internal */
         constructor(_iModel) {
             this._iModel = _iModel;
@@ -1307,7 +1494,10 @@ IModelDb._settingPropNamespace = "settings";
          * @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.
@@ -1317,7 +1507,25 @@ IModelDb._settingPropNamespace = "settings";
          * @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.
@@ -1325,6 +1533,7 @@ IModelDb._settingPropNamespace = "settings";
          */
         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()) {
@@ -1363,32 +1572,22 @@ IModelDb._settingPropNamespace = "settings";
                 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.
@@ -1441,6 +1640,8 @@ IModelDb._settingPropNamespace = "settings";
          */
         updateModel(props) {
             try {
+                if (props.id)
+                    this[Symbols_1._cache].delete(props.id);
                 this._iModel[Symbols_1._nativeDb].updateModel(props);
             }
             catch (err) {
@@ -1457,6 +1658,7 @@ IModelDb._settingPropNamespace = "settings";
          * @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}`);
@@ -1468,6 +1670,7 @@ IModelDb._settingPropNamespace = "settings";
         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) {
@@ -1504,6 +1707,9 @@ IModelDb._settingPropNamespace = "settings";
      * @public
      */
     class Elements {
+        _iModel;
+        /** @internal */
+        [Symbols_1._cache] = new ElementLRUCache_1.ElementLRUCache();
         /** @internal */
         constructor(_iModel) {
             this._iModel = _iModel;
@@ -1520,50 +1726,40 @@ IModelDb._settingPropNamespace = "settings";
                 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.
@@ -1571,14 +1767,32 @@ IModelDb._settingPropNamespace = "settings";
          * @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
@@ -1611,7 +1825,7 @@ IModelDb._settingPropNamespace = "settings";
                 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);
@@ -1635,6 +1849,7 @@ IModelDb._settingPropNamespace = "settings";
                 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));
@@ -1650,6 +1865,7 @@ IModelDb._settingPropNamespace = "settings";
          */
         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())
@@ -1671,9 +1887,14 @@ IModelDb._settingPropNamespace = "settings";
          * the value of `elProps.federationGuid` is *not* updated. Generally, it is best to re-read the element after inserting (e.g. via [[getElementProps]])
          * if you intend to continue working with it. That will ensure its values reflect the persistent state.
          */
-        insertElement(elProps) {
+        insertElement(elProps, options) {
             try {
-                return elProps.id = this._iModel[Symbols_1._nativeDb].insertElement(elProps);
+                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) {
                 err.message = `Error inserting element [${err.message}]`;
@@ -1694,6 +1915,11 @@ IModelDb._settingPropNamespace = "settings";
          */
         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) {
@@ -1711,6 +1937,7 @@ IModelDb._settingPropNamespace = "settings";
             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) {
@@ -1801,6 +2028,7 @@ IModelDb._settingPropNamespace = "settings";
          */
         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 = [];
@@ -1816,6 +2044,7 @@ IModelDb._settingPropNamespace = "settings";
          * @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)
@@ -1832,6 +2061,7 @@ IModelDb._settingPropNamespace = "settings";
                 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();
@@ -1846,6 +2076,7 @@ IModelDb._settingPropNamespace = "settings";
          */
         _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 = [];
@@ -1864,6 +2095,7 @@ IModelDb._settingPropNamespace = "settings";
          */
         _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()) {
@@ -1884,6 +2116,7 @@ IModelDb._settingPropNamespace = "settings";
          */
         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;
@@ -1893,7 +2126,9 @@ IModelDb._settingPropNamespace = "settings";
             }
             return this._queryAspect(aspectInstanceId, aspectClassFullName);
         }
+        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 = [];
@@ -1922,9 +2157,9 @@ IModelDb._settingPropNamespace = "settings";
          */
         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}`);
@@ -1934,6 +2169,7 @@ IModelDb._settingPropNamespace = "settings";
             const fullClassName = aspectClassFullName.replace(".", ":").split(":");
             const val = this._iModel[Symbols_1._nativeDb].getECClassMetaData(fullClassName[0], fullClassName[1]);
             if (val.result !== undefined) {
+                // eslint-disable-next-line @typescript-eslint/no-deprecated
                 const metaData = new core_common_1.EntityMetaData(JSON.parse(val.result));
                 if (metaData.modifier !== "Abstract") // Class is not abstract, use normal query to retrieve aspects
                     return this._queryAspects(elementId, aspectClassFullName, excludedClassFullNames);
@@ -1942,8 +2178,11 @@ IModelDb._settingPropNamespace = "settings";
             let classIdList = IModelDb.Elements.classMap.get(aspectClassFullName);
             if (classIdList === undefined) {
                 const classIds = [];
-                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) => {
+                // 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`, 
+                // 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());
                 });
@@ -1957,10 +2196,10 @@ IModelDb._settingPropNamespace = "settings";
                 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}`);
@@ -2009,16 +2248,18 @@ IModelDb._settingPropNamespace = "settings";
             });
         }
     }
-    Elements.classMap = new Map();
     IModelDb.Elements = Elements;
     /** The collection of views in an [[IModelDb]].
      * @public
      */
     class Views {
+        _iModel;
         /** @internal */
         constructor(_iModel) {
             this._iModel = _iModel;
         }
+        static viewStoreProperty = { namespace: "itwinjs", name: "DefaultViewStore" };
+        _viewStore;
         get hasViewStore() { return undefined !== this._viewStore; }
         /** @beta */
         get viewStore() {
@@ -2070,6 +2311,8 @@ IModelDb._settingPropNamespace = "settings";
             });
             return props;
         }
+        /** Default parameters for iterating/querying ViewDefinitions. Includes all subclasses of ViewDefinition, excluding only those marked 'private'. */
+        static defaultQueryParams = { from: "BisCore.ViewDefinition", where: "IsPrivate=FALSE" };
         /** Iterate all ViewDefinitions matching the supplied query.
          * @param params Specifies the query by which views are selected.
          * @param callback Function invoked for each ViewDefinition matching the query. Return false to terminate iteration, true to continue.
@@ -2141,17 +2384,6 @@ IModelDb._settingPropNamespace = "settings";
             }
             return props;
         }
-        /** @deprecated in 3.x. use [[getViewStateProps]]. */
-        getViewStateData(viewDefinitionId, options) {
-            const viewStateData = this.loadViewData(viewDefinitionId, options);
-            const baseModelId = viewStateData.viewDefinitionProps.baseModelId;
-            if (baseModelId) {
-                const drawingExtents = core_geometry_1.Range3d.fromJSON(this._iModel[Symbols_1._nativeDb].queryModelExtents({ id: baseModelId }).modelExtents);
-                if (!drawingExtents.isNull)
-                    viewStateData.modelExtents = drawingExtents.toJSON();
-            }
-            return viewStateData;
-        }
         /** Obtain a [ViewStateProps]($common) for a [[ViewDefinition]] specified by ViewIdString. */
         async getViewStateProps(viewDefinitionId, options) {
             const viewStateData = this.loadViewData(viewDefinitionId, options);
@@ -2206,14 +2438,11 @@ IModelDb._settingPropNamespace = "settings";
             this._iModel.saveFileProperty(spec, undefined, blob8);
         }
     }
-    Views.viewStoreProperty = { namespace: "itwinjs", name: "DefaultViewStore" };
-    /** Default parameters for iterating/querying ViewDefinitions. Includes all subclasses of ViewDefinition, excluding only those marked 'private'. */
-    Views.defaultQueryParams = { from: "BisCore.ViewDefinition", where: "IsPrivate=FALSE" };
     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";
@@ -2222,6 +2451,7 @@ IModelDb._settingPropNamespace = "settings";
     })(TileContentState = IModelDb.TileContentState || (IModelDb.TileContentState = {}));
     /** @internal */
     class Tiles {
+        _iModel;
         /** @internal */
         constructor(_iModel) {
             this._iModel = _iModel;
@@ -2296,10 +2526,38 @@ IModelDb._settingPropNamespace = "settings";
  * @public
  */
 class BriefcaseDb extends IModelDb {
+    /** Manages local changes to this briefcase. */
+    txns = new TxnManager_1.TxnManager(this);
     /** override superclass method */
     get isBriefcase() { return true; }
+    /* the BriefcaseId of the briefcase opened with this BriefcaseDb */
+    briefcaseId;
+    _skipSyncSchemasOnPullAndPush;
     /** @internal */
     get skipSyncSchemasOnPullAndPush() { return this._skipSyncSchemasOnPullAndPush ?? false; }
+    /**
+     * Event raised just before a BriefcaseDb is opened. Supplies the arguments that will be used to open the BriefcaseDb.
+     * Throw an exception to stop the open.
+     *
+     * **Example:**
+     * ``` ts
+     * [[include:BriefcaseDb.onOpen]]
+     * ```
+     */
+    static onOpen = new core_bentley_1.BeEvent();
+    /**
+     * Event raised just after a BriefcaseDb is opened. Supplies the newly opened BriefcaseDb and the arguments that were used to open it.
+     *
+     * **Example:**
+     * ``` ts
+     * [[include:BriefcaseDb.onOpened]]
+     * ```
+     */
+    static onOpened = new core_bentley_1.BeEvent();
+    /** Event raised after a BriefcaseDb has been closed. */
+    onClosed = new core_bentley_1.BeEvent();
+    /** @alpha */
+    static onCodeServiceCreated = new core_bentley_1.BeEvent();
     static findByKey(key) {
         return super.findByKey(key);
     }
@@ -2329,10 +2587,6 @@ class BriefcaseDb extends IModelDb {
     }
     constructor(args) {
         super({ ...args, changeset: args.nativeDb.getCurrentChangeset() });
-        /** Manages local changes to this briefcase. */
-        this.txns = new TxnManager_1.TxnManager(this);
-        /** Event raised after a BriefcaseDb has been closed. */
-        this.onClosed = new core_bentley_1.BeEvent();
         this._openMode = args.openMode;
         this.briefcaseId = args.briefcaseId;
         this.makeLockControl();
@@ -2415,6 +2669,7 @@ class BriefcaseDb extends IModelDb {
                 finally {
                     await withBriefcaseDb(briefcase, async (db) => db.locks[Symbols_1._releaseAllLocks]());
                 }
+                return;
             }
             throw error;
         }
@@ -2427,7 +2682,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.
@@ -2436,6 +2691,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();
             });
@@ -2659,7 +2915,7 @@ class BriefcaseDb extends IModelDb {
             await BriefcaseManager_1.BriefcaseManager.pullAndApplyChangesets(this, arg ?? {});
             if (!this.skipSyncSchemasOnPullAndPush)
                 await SchemaSync_1.SchemaSync.pull(this);
-            this.initializeIModelDb();
+            this.initializeIModelDb("pullMerge");
         });
         IpcHost_1.IpcHost.notifyTxns(this, "notifyPulledChanges", this.changeset);
         this.txns.touchWatchFile();
@@ -2741,46 +2997,32 @@ class BriefcaseDb extends IModelDb {
         // pushing changes requires a writeable briefcase
         await this.executeWritable(async () => {
             await BriefcaseManager_1.BriefcaseManager.pullMergePush(this, arg);
-            this.initializeIModelDb();
+            this.initializeIModelDb("pullMerge");
         });
         const changeset = this.changeset;
         IpcHost_1.IpcHost.notifyTxns(this, "notifyPushedChanges", changeset);
         this.txns.touchWatchFile();
     }
     close() {
+        if (this.isBriefcase && this.isOpen && !this.isReadonly && this.txns.changeMergeManager.inProgress()) {
+            this.abandonChanges();
+        }
         super.close();
         this.onClosed.raiseEvent();
     }
 }
 exports.BriefcaseDb = BriefcaseDb;
-/**
- * Event raised just before a BriefcaseDb is opened. Supplies the arguments that will be used to open the BriefcaseDb.
- * Throw an exception to stop the open.
- *
- * **Example:**
- * ``` ts
- * [[include:BriefcaseDb.onOpen]]
- * ```
- */
-BriefcaseDb.onOpen = new core_bentley_1.BeEvent();
-/**
- * Event raised just after a BriefcaseDb is opened. Supplies the newly opened BriefcaseDb and the arguments that were used to open it.
- *
- * **Example:**
- * ``` ts
- * [[include:BriefcaseDb.onOpened]]
- * ```
- */
-BriefcaseDb.onOpened = new core_bentley_1.BeEvent();
-/** @alpha */
-BriefcaseDb.onCodeServiceCreated = new core_bentley_1.BeEvent();
 /** Used to reattach Daemon from a user's accessToken for V2 checkpoints.
  * @note Reattach only happens if the previous access token either has expired or is about to expire within an application-supplied safety duration.
  */
 class RefreshV2CheckpointSas {
+    /** the time at which the current token should be refreshed (its expiry minus safetySeconds) */
+    _timestamp = 0;
+    /** while a refresh is happening, all callers get this promise. */
+    _promise;
+    /** Time, in seconds, before the current token expires to obtain a new token. Default is 1 hour. */
+    _safetySeconds;
     constructor(sasToken, safetySeconds) {
-        /** the time at which the current token should be refreshed (its expiry minus safetySeconds) */
-        this._timestamp = 0;
         this._safetySeconds = safetySeconds ?? 60 * 60; // default to 1 hour
         this.setTimestamp(sasToken);
     }
@@ -2790,11 +3032,11 @@ 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);
-            const props = await IModelHost_1.IModelHost.hubAccess.queryV2Checkpoint({ accessToken, iTwinId: iModel.iTwinId, iModelId: iModel.iModelId, changeset: iModel.changeset });
+            const props = await IModelHost_1.IModelHost[Symbols_1._hubAccess].queryV2Checkpoint({ accessToken, iTwinId: iModel.iTwinId, iModelId: iModel.iModelId, changeset: iModel.changeset });
             if (!props)
                 throw new Error("can't reset checkpoint sas token");
             container.accessToken = props.sasToken;
@@ -2827,9 +3069,18 @@ class RefreshV2CheckpointSas {
  */
 class SnapshotDb extends IModelDb {
     get isSnapshot() { return true; }
+    _refreshSas;
+    /** Timer used to restart the default txn on the SnapshotDb after some inactivity. This is only used for checkpoints.
+     *  Restarting the default txn lets CloudSqlite know that any blocks that may have been read may now be ejected.
+     *  Without restarting the default txn, CloudSQLite can get into a state where it can not evict any blocks to make space for more blocks.
+     */
+    _restartDefaultTxnTimer;
+    _createClassViewsOnClose;
+    static onOpen = new core_bentley_1.BeEvent();
+    static onOpened = new core_bentley_1.BeEvent();
     constructor(nativeDb, key) {
-        super({ nativeDb, key, changeset: nativeDb.getCurrentChangeset() }); // eslint-disable-line @typescript-eslint/no-deprecated
-        this._openMode = nativeDb.isReadonly() ? core_bentley_1.OpenMode.Readonly : core_bentley_1.OpenMode.ReadWrite; // eslint-disable-line @typescript-eslint/no-deprecated
+        super({ nativeDb, key, changeset: nativeDb.getCurrentChangeset() });
+        this._openMode = nativeDb.isReadonly() ? core_bentley_1.OpenMode.Readonly : core_bentley_1.OpenMode.ReadWrite;
     }
     static findByKey(key) {
         return super.findByKey(key);
@@ -2869,7 +3120,7 @@ class SnapshotDb extends IModelDb {
         iModelDb.performCheckpoint();
         IModelJsFs_1.IModelJsFs.copySync(iModelDb.pathName, snapshotFile);
         const nativeDb = new NativePlatform_1.IModelNative.platform.DgnDb();
-        nativeDb.openIModel(snapshotFile, core_bentley_1.OpenMode.ReadWrite, undefined, options);
+        nativeDb.openIModel(snapshotFile, core_bentley_1.OpenMode.ReadWrite, undefined);
         nativeDb.vacuum();
         // Replace iModelId if seedFile is a snapshot, preserve iModelId if seedFile is an iModelHub-managed briefcase
         if (!BriefcaseManager_1.BriefcaseManager.isValidBriefcaseId(nativeDb.getBriefcaseId()))
@@ -2907,7 +3158,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;
     }
@@ -2933,8 +3184,10 @@ class SnapshotDb extends IModelDb {
         snapshot._restartDefaultTxnTimer = setTimeout(() => {
             snapshot.restartDefaultTxn();
         }, (10 * 60) * 1000).unref(); // 10 minutes
-        // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
-        snapshot._refreshSas = new RefreshV2CheckpointSas(snapshot[Symbols_1._nativeDb].cloudContainer.accessToken, checkpoint.reattachSafetySeconds);
+        const cloudContainer = snapshot.cloudContainer;
+        if (cloudContainer !== undefined) {
+            snapshot._refreshSas = new RefreshV2CheckpointSas(cloudContainer.accessToken, checkpoint.reattachSafetySeconds);
+        }
         return snapshot;
     }
     /**
@@ -2968,8 +3221,6 @@ class SnapshotDb extends IModelDb {
     }
 }
 exports.SnapshotDb = SnapshotDb;
-SnapshotDb.onOpen = new core_bentley_1.BeEvent();
-SnapshotDb.onOpened = new core_bentley_1.BeEvent();
 /**
  * Standalone iModels are read/write files that are not associated with an iTwin or managed by iModelHub.
  * They are relevant only for testing, or for small-scale single-user scenarios.
@@ -3008,7 +3259,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;
     }
@@ -3054,7 +3305,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) {
@@ -3062,6 +3313,22 @@ class StandaloneDb extends BriefcaseDb {
             throw error;
         }
     }
+    /** Convert an iModel stored on the local file system into a StandaloneDb, chiefly for testing purposes.
+     * The file must not be open in any application.
+     * @param iModelFileName the path to the iModel on the local file system.
+     * @beta
+     */
+    static convertToStandalone(iModelFileName) {
+        const nativeDb = new NativePlatform_1.IModelNative.platform.DgnDb();
+        nativeDb.openIModel(iModelFileName, core_bentley_1.OpenMode.ReadWrite);
+        nativeDb.setITwinId(core_bentley_1.Guid.empty); // empty iTwinId means "standalone"
+        nativeDb.saveChanges(); // save change to iTwinId
+        nativeDb.deleteAllTxns(); // necessary before resetting briefcaseId
+        nativeDb.resetBriefcaseId(core_common_1.BriefcaseIdValue.Unassigned); // standalone iModels should always have BriefcaseId unassigned
+        nativeDb.saveLocalValue("StandaloneEdit", JSON.stringify({ txns: true }));
+        nativeDb.saveChanges(); // save change to briefcaseId
+        nativeDb.closeFile();
+    }
 }
 exports.StandaloneDb = StandaloneDb;
 //# sourceMappingURL=IModelDb.js.map