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

package/lib/cjs/IModelDb.js

@@ -46,7 +46,10 @@ 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");
 // spell:ignore fontid fontmap
 const loggerCategory = BackendLoggerCategory_1.BackendLoggerCategory.IModelDb;
 /** @internal */
@@ -85,10 +88,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 +136,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 +154,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 +165,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 +181,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 +198,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 +227,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 +278,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 +289,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 +342,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 +374,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 +418,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 +461,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 +556,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 +576,9 @@ 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;
     }
     /** Update the project extents for this iModel.
      * <p><em>Example:</em>
@@ -617,9 +617,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 +630,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 +877,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 +937,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 +949,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 +974,54 @@ 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);
         }
     }
     /** 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 +1035,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 +1061,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 +1086,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 +1104,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 +1136,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 +1313,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 +1406,61 @@ 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 */
         constructor(_iModel) {
             this._iModel = _iModel;
@@ -1325,6 +1489,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()) {
@@ -1504,6 +1669,7 @@ IModelDb._settingPropNamespace = "settings";
      * @public
      */
     class Elements {
+        _iModel;
         /** @internal */
         constructor(_iModel) {
             this._iModel = _iModel;
@@ -1635,6 +1801,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 +1817,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 +1839,9 @@ 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);
+                return elProps.id = this._iModel[Symbols_1._nativeDb].insertElement(elProps, options);
             }
             catch (err) {
                 err.message = `Error inserting element [${err.message}]`;
@@ -1801,6 +1969,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 +1985,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 +2002,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 +2017,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 +2036,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 +2057,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 +2067,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 = [];
@@ -1934,6 +2110,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 +2119,11 @@ IModelDb._settingPropNamespace = "settings";
             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());
                 });
@@ -2009,16 +2189,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 +2252,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 +2325,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,9 +2379,6 @@ 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.
@@ -2222,6 +2392,7 @@ IModelDb._settingPropNamespace = "settings";
     })(TileContentState = IModelDb.TileContentState || (IModelDb.TileContentState = {}));
     /** @internal */
     class Tiles {
+        _iModel;
         /** @internal */
         constructor(_iModel) {
             this._iModel = _iModel;
@@ -2296,10 +2467,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 +2528,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 +2610,7 @@ class BriefcaseDb extends IModelDb {
                 finally {
                     await withBriefcaseDb(briefcase, async (db) => db.locks[Symbols_1._releaseAllLocks]());
                 }
+                return;
             }
             throw error;
         }
@@ -2427,7 +2623,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.
@@ -2659,7 +2855,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 +2937,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 +2972,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 +3009,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 +3060,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 +3098,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 +3124,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 +3161,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 +3199,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 +3245,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 +3253,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