@itwin/core-backend 4.0.0-dev.28 → 4.0.0-dev.32

package/lib/cjs/IModelDb.js

@@ -1,2378 +1,2378 @@
-"use strict";
-/*---------------------------------------------------------------------------------------------
-* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
-* See LICENSE.md in the project root for license terms and full copyright notice.
-*--------------------------------------------------------------------------------------------*/
-/** @packageDocumentation
- * @module iModels
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.StandaloneDb = exports.SnapshotDb = exports.BriefcaseDb = exports.IModelDb = exports.BriefcaseLocalValue = void 0;
-const path_1 = require("path");
-const core_bentley_1 = require("@itwin/core-bentley");
-const core_common_1 = require("@itwin/core-common");
-const core_geometry_1 = require("@itwin/core-geometry");
-const BackendLoggerCategory_1 = require("./BackendLoggerCategory");
-const BriefcaseManager_1 = require("./BriefcaseManager");
-const CheckpointManager_1 = require("./CheckpointManager");
-const ClassRegistry_1 = require("./ClassRegistry");
-const CodeService_1 = require("./CodeService");
-const CodeSpecs_1 = require("./CodeSpecs");
-const ConcurrentQuery_1 = require("./ConcurrentQuery");
-const ECSqlStatement_1 = require("./ECSqlStatement");
-const Element_1 = require("./Element");
-const ElementAspect_1 = require("./ElementAspect");
-const ElementGraphics_1 = require("./ElementGraphics");
-const GeoCoordConfig_1 = require("./GeoCoordConfig");
-const IModelHost_1 = require("./IModelHost");
-const IModelJsFs_1 = require("./IModelJsFs");
-const IpcHost_1 = require("./IpcHost");
-const Model_1 = require("./Model");
-const Relationship_1 = require("./Relationship");
-const ServerBasedLocks_1 = require("./ServerBasedLocks");
-const SqliteStatement_1 = require("./SqliteStatement");
-const TxnManager_1 = require("./TxnManager");
-const ViewDefinition_1 = require("./ViewDefinition");
-const Settings_1 = require("./workspace/Settings");
-const Workspace_1 = require("./workspace/Workspace");
-// spell:ignore fontid fontmap
-const loggerCategory = BackendLoggerCategory_1.BackendLoggerCategory.IModelDb;
-/** A null-implementation of LockControl that does not attempt to limit access between briefcases. This relies on change-merging to resolve conflicts. */
-class NoLocks {
-    get isServerBased() { return false; }
-    close() { }
-    clearAllLocks() { }
-    holdsExclusiveLock() { return false; }
-    holdsSharedLock() { return false; }
-    checkExclusiveLock() { }
-    checkSharedLock() { }
-    elementWasCreated() { }
-    async acquireLocks() { }
-    async releaseAllLocks() { }
-}
-/** @internal */
-var BriefcaseLocalValue;
-(function (BriefcaseLocalValue) {
-    BriefcaseLocalValue["StandaloneEdit"] = "StandaloneEdit";
-    BriefcaseLocalValue["NoLocking"] = "NoLocking";
-})(BriefcaseLocalValue = exports.BriefcaseLocalValue || (exports.BriefcaseLocalValue = {}));
-// function to open an briefcaseDb, perform an operation, and then close it.
-const withBriefcaseDb = async (briefcase, fn) => {
-    const db = await BriefcaseDb.open(briefcase);
-    try {
-        return await fn(db);
-    }
-    finally {
-        db.close();
-    }
-};
-/**
- * Settings for an individual iModel. May only include settings priority for iModel, iTwin and organization.
- * @note if there is more than one iModel for an iTwin or organization, they will *each* hold a copy of the settings for those priorities.
- */
-class IModelSettings extends Settings_1.BaseSettings {
-    verifyPriority(priority) {
-        if (priority <= Settings_1.SettingsPriority.application)
-            throw new Error("Use IModelHost.appSettings");
-    }
-    // attempt to resolve a setting from this iModel's settings, otherwise use appWorkspace's settings, otherwise defaultValue.
-    resolveSetting(name, resolver, defaultValue) {
-        return super.resolveSetting(name, resolver) ?? IModelHost_1.IModelHost.appWorkspace.settings.resolveSetting(name, resolver, defaultValue);
-    }
-}
-/** An iModel database file. The database file can either be a briefcase or a snapshot.
- * @see [Accessing iModels]($docs/learning/backend/AccessingIModels.md)
- * @see [About IModelDb]($docs/learning/backend/IModelDb.md)
- * @public
- */
-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);
-        this._statementCache = new SqliteStatement_1.StatementCache();
-        this._sqliteStatementCache = new SqliteStatement_1.StatementCache();
-        this._snaps = new Map();
-        /** @internal */
-        this._locks = new NoLocks();
-        /** 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._nativeDb = args.nativeDb;
-        this.nativeDb.setIModelDb(this);
-        this.loadSettingDictionaries();
-        GeoCoordConfig_1.GeoCoordConfig.loadForImodel(this.workspace.settings); // load gcs data specified by iModel's settings dictionaries, must be done before calling initializeIModelDb
-        this.initializeIModelDb();
-        IModelDb._openDbs.set(this._fileKey, this);
-        if (undefined === IModelDb._shutdownListener) { // the first time we create an IModelDb, add a listener to close any orphan files at shutdown.
-            IModelDb._shutdownListener = IModelHost_1.IModelHost.onBeforeShutdown.addListener(() => {
-                IModelDb._openDbs.forEach((db) => {
-                    try {
-                        db.abandonChanges();
-                        db.close();
-                    }
-                    catch { }
-                });
-            });
-        }
-    }
-    /** @alpha */
-    get codeService() { return this._codeService; }
-    /**
-     * Get the [[LockControl]] for this iModel.
-     * @beta
-     */
-    get locks() { return this._locks; } // eslint-disable-line @typescript-eslint/no-non-null-assertion
-    /**
-     * Get the [[Workspace]] for this iModel.
-     * @beta
-     */
-    get workspace() {
-        if (undefined === this._workspace)
-            this._workspace = new Workspace_1.ITwinWorkspace(new IModelSettings());
-        return this._workspace;
-    }
-    /** 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.
-     */
-    async acquireSchemaLock() {
-        return this.locks.acquireLocks({ exclusive: core_common_1.IModel.repositoryModelId });
-    }
-    /** determine whether the schema lock is currently held for this iModel. */
-    get holdsSchemaLock() {
-        return this.locks.holdsExclusiveLock(core_common_1.IModel.repositoryModelId);
-    }
-    /** @internal */
-    notifyChangesetApplied() {
-        this.changeset = this.nativeDb.getCurrentChangeset();
-        this.onChangesetApplied.raiseEvent();
-    }
-    get fontMap() {
-        return this._fontMap ?? (this._fontMap = new core_common_1.FontMap(this.nativeDb.readFontMap()));
-    }
-    /** @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.nativeDb.addNewFont({ name, type: type ?? core_common_1.FontType.TrueType });
-    }
-    /** Check if this iModel has been opened read-only or not. */
-    get isReadonly() { return this.openMode === core_bentley_1.OpenMode.Readonly; }
-    /** The Guid that identifies this iModel. */
-    get iModelId() {
-        (0, core_bentley_1.assert)(undefined !== super.iModelId);
-        return super.iModelId;
-    } // GuidString | undefined for the IModel superclass, but required for all IModelDb subclasses
-    /** @internal*/
-    get nativeDb() { return this._nativeDb; } // eslint-disable-line @typescript-eslint/no-non-null-assertion
-    /** Get the full path fileName of this iModelDb
-     * @note this member is only valid while the iModel is opened.
-     */
-    get pathName() { return this.nativeDb.getFilePath(); }
-    /** Close this IModel, if it is currently open. */
-    close() {
-        if (!this.isOpen)
-            return; // don't continue if already closed
-        this.beforeClose();
-        IModelDb._openDbs.delete(this._fileKey);
-        this._workspace?.close();
-        this.locks.close();
-        this._locks = undefined;
-        this._codeService?.close();
-        this._codeService = undefined;
-        this.nativeDb.closeIModel();
-        this._nativeDb = undefined; // the underlying nativeDb has been freed by closeIModel
-    }
-    /** @internal */
-    async refreshContainerSas(_userAccessToken) { }
-    /**
-     * Called by derived classes before closing the connection
-     * @internal
-     */
-    beforeClose() {
-        this.onBeforeClose.raiseEvent();
-        this.clearCaches();
-    }
-    /** @internal */
-    initializeIModelDb() {
-        const props = this.nativeDb.getIModelProps();
-        super.initialize(props.rootSubject.name, props);
-        if (this._initialized)
-            return;
-        this._initialized = true;
-        const db = this.isBriefcaseDb() ? this : undefined;
-        if (!db || !IpcHost_1.IpcHost.isValid)
-            return;
-        db.onNameChanged.addListener(() => IpcHost_1.IpcHost.notifyTxns(db, "notifyIModelNameChanged", db.name));
-        db.onRootSubjectChanged.addListener(() => IpcHost_1.IpcHost.notifyTxns(db, "notifyRootSubjectChanged", db.rootSubject));
-        db.onProjectExtentsChanged.addListener(() => IpcHost_1.IpcHost.notifyTxns(db, "notifyProjectExtentsChanged", db.projectExtents.toJSON()));
-        db.onGlobalOriginChanged.addListener(() => IpcHost_1.IpcHost.notifyTxns(db, "notifyGlobalOriginChanged", db.globalOrigin.toJSON()));
-        db.onEcefLocationChanged.addListener(() => IpcHost_1.IpcHost.notifyTxns(db, "notifyEcefLocationChanged", db.ecefLocation?.toJSON()));
-        db.onGeographicCoordinateSystemChanged.addListener(() => IpcHost_1.IpcHost.notifyTxns(db, "notifyGeographicCoordinateSystemChanged", db.geographicCoordinateSystem?.toJSON()));
-    }
-    /** Returns true if this is a BriefcaseDb
-     * @see [[BriefcaseDb.open]]
-     */
-    get isBriefcase() { return false; }
-    /** Type guard for instanceof [[BriefcaseDb]] */
-    isBriefcaseDb() { return this.isBriefcase; }
-    /** Returns true if this is a SnapshotDb
-     * @see [[SnapshotDb.open]]
-     */
-    get isSnapshot() { return false; }
-    /** Type guard for instanceof [[SnapshotDb]] */
-    isSnapshotDb() { return this.isSnapshot; }
-    /** Returns true if this is a *standalone* iModel
-     * @see [[StandaloneDb.open]]
-     * @internal
-     */
-    get isStandalone() { return false; }
-    /** Type guard for instanceof [[StandaloneDb]]
-     * @internal
-     */
-    isStandaloneDb() { return this.isStandalone; }
-    /** Return `true` if the underlying nativeDb is open and valid.
-     * @internal
-     */
-    get isOpen() { return undefined !== this.nativeDb; }
-    /** Get the briefcase Id of this iModel */
-    getBriefcaseId() { return this.isOpen ? this.nativeDb.getBriefcaseId() : core_common_1.BriefcaseIdValue.Illegal; }
-    /**
-     * Use a prepared ECSQL 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
-     * in the statement cache so it can be reused in the future. Use this method for ECSQL statements that will be
-     * reused often and are expensive to prepare. The statement cache holds the most recently used statements, discarding
-     * the oldest statements as it fills. For statements you don't intend to reuse, instead use [[withStatement]].
-     * @param sql The SQLite SQL statement to execute
-     * @param callback the callback to invoke on the prepared statement
-     * @param logErrors Determines if error will be logged if statement fail to prepare
-     * @returns the value returned by `callback`.
-     * @see [[withStatement]]
-     * @public
-     */
-    withPreparedStatement(ecsql, callback, logErrors = true) {
-        const stmt = this._statementCache.findAndRemove(ecsql) ?? this.prepareStatement(ecsql, logErrors);
-        const release = () => this._statementCache.addOrDispose(stmt);
-        try {
-            const val = callback(stmt);
-            if (val instanceof Promise) {
-                val.then(release, release);
-            }
-            else {
-                release();
-            }
-            return val;
-        }
-        catch (err) {
-            release();
-            throw err;
-        }
-    }
-    /**
-     * Prepared and execute a callback on an ECSQL statement. After the callback completes the statement is disposed.
-     * Use this method for ECSQL statements are either not expected to be reused, or are not expensive to prepare.
-     * For statements that will be reused often, instead use [[withPreparedStatement]].
-     * @param sql The SQLite SQL statement to execute
-     * @param callback the callback to invoke on the prepared statement
-     * @param logErrors Determines if error will be logged if statement fail to prepare
-     * @returns the value returned by `callback`.
-     * @see [[withPreparedStatement]]
-     * @public
-     */
-    withStatement(ecsql, callback, logErrors = true) {
-        const stmt = this.prepareStatement(ecsql, logErrors);
-        const release = () => stmt.dispose();
-        try {
-            const val = callback(stmt);
-            if (val instanceof Promise) {
-                val.then(release, release);
-            }
-            else {
-                release();
-            }
-            return val;
-        }
-        catch (err) {
-            release();
-            throw err;
-        }
-    }
-    /** Allow to execute query and read results along with meta data. The result are streamed.
-     * @param params The values to bind to the parameters (if the ECSQL has any).
-     * @param config Allow to specify certain flags which control how query is executed.
-     * @returns Returns *ECSqlQueryReader* which help iterate over result set and also give access to meta data.
-     * @beta
-     * */
-    createQueryReader(ecsql, params, config) {
-        if (!this._nativeDb || !this._nativeDb.isOpen()) {
-            throw new core_common_1.IModelError(core_bentley_1.DbResult.BE_SQLITE_ERROR, "db not open");
-        }
-        const executor = {
-            execute: async (request) => {
-                return ConcurrentQuery_1.ConcurrentQuery.executeQueryRequest(this.nativeDb, request);
-            },
-        };
-        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
-     */
-    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
-     */
-    async queryRowCount(ecsql, params) {
-        for await (const row of this.query(`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
-     */
-    async *restartQuery(token, ecsql, params, options) {
-        for await (const row of this.query(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
-     * in the statement cache so it can be reused in the future. Use this method for SQL statements that will be
-     * reused often and are expensive to prepare. The statement cache holds the most recently used statements, discarding
-     * the oldest statements as it fills. For statements you don't intend to reuse, instead use [[withSqliteStatement]].
-     * @param sql The SQLite SQL statement to execute
-     * @param callback the callback to invoke on the prepared statement
-     * @param logErrors Determine if errors are logged or not
-     * @returns the value returned by `callback`.
-     * @see [[withPreparedStatement]]
-     * @public
-     */
-    withPreparedSqliteStatement(sql, callback, logErrors = true) {
-        const stmt = this._sqliteStatementCache.findAndRemove(sql) ?? this.prepareSqliteStatement(sql, logErrors);
-        const release = () => this._sqliteStatementCache.addOrDispose(stmt);
-        try {
-            const val = callback(stmt);
-            if (val instanceof Promise) {
-                val.then(release, release);
-            }
-            else {
-                release();
-            }
-            return val;
-        }
-        catch (err) {
-            release();
-            throw err;
-        }
-    }
-    /**
-     * Prepared and execute a callback on a SQL statement. After the callback completes the statement is disposed.
-     * Use this method for SQL statements are either not expected to be reused, or are not expensive to prepare.
-     * For statements that will be reused often, instead use [[withPreparedSqliteStatement]].
-     * @param sql The SQLite SQL statement to execute
-     * @param callback the callback to invoke on the prepared statement
-     * @param logErrors Determine if errors are logged or not
-     * @returns the value returned by `callback`.
-     * @public
-     */
-    withSqliteStatement(sql, callback, logErrors = true) {
-        const stmt = this.prepareSqliteStatement(sql, logErrors);
-        const release = () => stmt.dispose();
-        try {
-            const val = callback(stmt);
-            if (val instanceof Promise) {
-                val.then(release, release);
-            }
-            else {
-                release();
-            }
-            return val;
-        }
-        catch (err) {
-            release();
-            throw err;
-        }
-    }
-    /** Prepare an SQL statement.
-     * @param sql The SQL statement to prepare
-     * @throws [[IModelError]] if there is a problem preparing the statement.
-     * @internal
-     */
-    prepareSqliteStatement(sql, logErrors = true) {
-        const stmt = new SqliteStatement_1.SqliteStatement(sql);
-        stmt.prepare(this.nativeDb, logErrors);
-        return stmt;
-    }
-    /**
-     * queries the BisCore.SubCategory table for the entries that are children of the passed categoryIds
-     * @param categoryIds categoryIds to query
-     * @returns array of SubCategoryResultRow
-     * @internal
-     */
-    async querySubCategories(categoryIds) {
-        const result = [];
-        const where = [...categoryIds].join(",");
-        const query = `SELECT ECInstanceId as id, Parent.Id as parentId, Properties as appearance FROM BisCore.SubCategory WHERE Parent.Id IN (${where})`;
-        try {
-            for await (const row of this.query(query, undefined, { rowFormat: core_common_1.QueryRowFormat.UseJsPropertyNames })) {
-                result.push(row);
-            }
-        }
-        catch {
-            // We can ignore the error here, and just return whatever we were able to query.
-        }
-        return result;
-    }
-    /** Query for a set of entity ids, given an EntityQueryParams
-     * @param params The query parameters. The `limit` and `offset` members should be used to page results.
-     * @returns an Id64Set with results of query
-     * @throws [[IModelError]] if the generated statement is invalid or [IModelDb.maxLimit]($backend) exceeded when collecting ids.
-     *
-     * *Example:*
-     * ``` ts
-     * [[include:ECSQL-backend-queries.select-element-by-code-value-using-queryEntityIds]]
-     * ```
-     */
-    queryEntityIds(params) {
-        let sql = "SELECT ECInstanceId FROM ";
-        if (params.only)
-            sql += "ONLY ";
-        sql += params.from;
-        if (params.where)
-            sql += ` WHERE ${params.where}`;
-        if (params.orderBy)
-            sql += ` ORDER BY ${params.orderBy}`;
-        if (typeof params.limit === "number" && params.limit > 0)
-            sql += ` LIMIT ${params.limit}`;
-        if (typeof params.offset === "number" && params.offset > 0)
-            sql += ` OFFSET ${params.offset}`;
-        const ids = new Set();
-        this.withPreparedStatement(sql, (stmt) => {
-            if (params.bindings)
-                stmt.bindValues(params.bindings);
-            for (const row of stmt) {
-                if (row.id !== undefined) {
-                    ids.add(row.id);
-                    if (ids.size > IModelDb.maxLimit) {
-                        throw new core_common_1.IModelError(core_bentley_1.IModelStatus.BadRequest, "Max LIMIT exceeded in SELECT statement");
-                    }
-                }
-            }
-        });
-        return ids;
-    }
-    /** Clear all in-memory caches held in this IModelDb. */
-    clearCaches() {
-        this._statementCache.clear();
-        this._sqliteStatementCache.clear();
-    }
-    /** Update the project extents for this iModel.
-     * <p><em>Example:</em>
-     * ``` ts
-     * [[include:IModelDb.updateProjectExtents]]
-     * ```
-     */
-    updateProjectExtents(newExtents) {
-        this.projectExtents = newExtents;
-        this.updateIModelProps();
-    }
-    /** Compute an appropriate project extents for this iModel based on the ranges of all spatial elements.
-     * Typically, the result is simply the union of the ranges of all spatial elements. However, the algorithm also detects "outlier elements",
-     * whose placements locate them so far from the rest of the spatial geometry that they are considered statistically insignificant. The
-     * range of an outlier element does not contribute to the computed extents.
-     * @param options Specifies the level of detail desired in the return value.
-     * @returns the computed extents.
-     * @note This method does not modify the IModel's stored project extents. @see [[updateProjectExtents]].
-     */
-    computeProjectExtents(options) {
-        const wantFullExtents = true === options?.reportExtentsWithOutliers;
-        const wantOutliers = true === options?.reportOutliers;
-        const result = this.nativeDb.computeProjectExtents(wantFullExtents, wantOutliers);
-        return {
-            extents: core_geometry_1.Range3d.fromJSON(result.extents),
-            extentsWithOutliers: result.fullExtents ? core_geometry_1.Range3d.fromJSON(result.fullExtents) : undefined,
-            outliers: result.outliers,
-        };
-    }
-    /** Update the [EcefLocation]($docs/learning/glossary#eceflocation) of this iModel.  */
-    updateEcefLocation(ecef) {
-        this.setEcefLocation(ecef);
-        this.updateIModelProps();
-    }
-    /** Update the IModelProps of this iModel in the database. */
-    updateIModelProps() {
-        this.nativeDb.updateIModelProps(this.toJSON());
-    }
-    /** Commit pending changes to this iModel.
-     * @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.
-     */
-    saveChanges(description) {
-        if (this.openMode === core_bentley_1.OpenMode.Readonly)
-            throw new core_common_1.IModelError(core_bentley_1.IModelStatus.ReadOnly, "IModelDb was opened read-only");
-        const stat = this.nativeDb.saveChanges(description);
-        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. */
-    abandonChanges() {
-        this.nativeDb.abandonChanges();
-    }
-    /**
-     * Save all changes and perform a [checkpoint](https://www.sqlite.org/c3ref/wal_checkpoint_v2.html) on this IModelDb.
-     * This ensures that all changes to the database since it was opened are saved to its file and the WAL file is truncated.
-     * @note Checkpoint automatically happens when IModelDbs are closed. However, the checkpoint
-     * operation itself can take some time. It may be useful to call this method prior to closing so that the checkpoint "penalty" is paid earlier.
-     * @note Another use for this function is to permit the file to be copied while it is open for write. iModel files should
-     * rarely be copied, and even less so while they're opened. But this scenario is sometimes encountered for tests.
-     */
-    performCheckpoint() {
-        if (!this.isReadonly) {
-            this.saveChanges();
-            this.nativeDb.performCheckpoint();
-        }
-    }
-    /** @internal */
-    reverseTxns(numOperations) {
-        return this.nativeDb.reverseTxns(numOperations);
-    }
-    /** @internal */
-    reinstateTxn() {
-        return this.nativeDb.reinstateTxn();
-    }
-    /** @internal */
-    restartTxnSession() {
-        return this.nativeDb.restartTxnSession();
-    }
-    /** Import an ECSchema. On success, the schema definition is stored in the iModel.
-     * This method is asynchronous (must be awaited) because, in the case where this IModelDb is a briefcase, this method first obtains the schema lock from the iModel server.
-     * You must import a schema into an iModel before you can insert instances of the classes in that schema. See [[Element]]
-     * @param schemaFileName  array of Full paths to ECSchema.xml files to be imported.
-     * @param {SchemaImportOptions} options - options during schema import.
-     * @throws [[IModelError]] if the schema lock cannot be obtained or there is a problem importing the schema.
-     * @note Changes are saved if importSchemas is successful and abandoned if not successful.
-     * @see querySchemaVersion
-     */
-    async importSchemas(schemaFileNames, options) {
-        if (this.nativeDb.getITwinId() !== core_bentley_1.Guid.empty) // if this iModel is associated with an iTwin, importing schema requires the schema lock
-            await this.acquireSchemaLock();
-        const maybeCustomNativeContext = options?.ecSchemaXmlContext?.nativeContext;
-        const nativeImportOptions = {
-            schemaLockHeld: true,
-            ecSchemaXmlContext: maybeCustomNativeContext,
-        };
-        const stat = this.nativeDb.importSchemas(schemaFileNames, nativeImportOptions);
-        if (core_bentley_1.DbResult.BE_SQLITE_OK !== stat) {
-            throw new core_common_1.IModelError(stat, "Error importing schema");
-        }
-        this.clearCaches();
-    }
-    /** Import ECSchema(s) serialized to XML. On success, the schema definition is stored in the iModel.
-     * This method is asynchronous (must be awaited) because, in the case where this IModelDb is a briefcase, this method first obtains the schema lock from the iModel server.
-     * You must import a schema into an iModel before you can insert instances of the classes in that schema. See [[Element]]
-     * @param serializedXmlSchemas  The xml string(s) created from a serialized ECSchema.
-     * @throws [[IModelError]] if the schema lock cannot be obtained or there is a problem importing the schema.
-     * @note Changes are saved if importSchemaStrings is successful and abandoned if not successful.
-     * @see querySchemaVersion
-     * @alpha
-     */
-    async importSchemaStrings(serializedXmlSchemas) {
-        if (this.iTwinId && this.iTwinId !== core_bentley_1.Guid.empty) // if this iModel is associated with an iTwin, importing schema requires the schema lock
-            await this.acquireSchemaLock();
-        const stat = this.nativeDb.importXmlSchemas(serializedXmlSchemas, { schemaLockHeld: true });
-        if (core_bentley_1.DbResult.BE_SQLITE_OK !== stat)
-            throw new core_common_1.IModelError(stat, "Error importing schema");
-        this.clearCaches();
-    }
-    /** Find an opened instance of any subclass of IModelDb, by filename
-     * @note this method returns an IModelDb if the filename is open for *any* subclass of IModelDb
-    */
-    static findByFilename(fileName) {
-        for (const entry of this._openDbs) {
-            if (entry[1].pathName === fileName)
-                return entry[1];
-        }
-        return undefined;
-    }
-    /** Find an open IModelDb by its key.
-     * @note This method is mainly for use by RPC implementations.
-     * @throws [[IModelNotFoundResponse]] if an open IModelDb matching the key is not found.
-     * @see [IModel.key]($common)
-     */
-    static findByKey(key) {
-        const iModelDb = this.tryFindByKey(key);
-        if (undefined === iModelDb)
-            throw new core_common_1.IModelNotFoundResponse(); // a very specific status for the RpcManager
-        return iModelDb;
-    }
-    /** Attempt to find an open IModelDb by key.
-     * @returns The matching IModelDb or `undefined`.
-     */
-    static tryFindByKey(key) {
-        return this._openDbs.get(key);
-    }
-    /** @internal */
-    static openDgnDb(file, openMode, upgradeOptions, props) {
-        file.key = file.key ?? core_bentley_1.Guid.createValue();
-        if (this.tryFindByKey(file.key))
-            throw new core_common_1.IModelError(core_bentley_1.IModelStatus.AlreadyOpen, `key [${file.key}] for file [${file.path}] is already in use`);
-        const isUpgradeRequested = upgradeOptions?.domain === core_common_1.DomainOptions.Upgrade || upgradeOptions?.profile === core_common_1.ProfileOptions.Upgrade;
-        if (isUpgradeRequested && openMode !== core_bentley_1.OpenMode.ReadWrite)
-            throw new core_common_1.IModelError(core_bentley_1.IModelStatus.UpgradeFailed, "Cannot upgrade a Readonly Db");
-        try {
-            const nativeDb = new IModelHost_1.IModelHost.platform.DgnDb();
-            nativeDb.openIModel(file.path, openMode, upgradeOptions, props, props?.container);
-            return nativeDb;
-        }
-        catch (err) {
-            throw new core_common_1.IModelError(err.errorNumber, `${err.message}, ${file.path}`);
-        }
-    }
-    /**
-     * Determines if the schemas in the Db must or can be upgraded by comparing them with those included in the
-     * current version of the software.
-     * @param filePath Full name of the briefcase including path
-     * @param forReadWrite Pass true if validating for read-write scenarios - note that the schema version requirements
-     * for opening the DgnDb read-write is more stringent than when opening the database read-only
-     * @throws [[IModelError]] If the Db was in an invalid state and that causes a problem with validating schemas
-     * @see [[BriefcaseDb.upgradeSchemas]] or [[StandaloneDb.upgradeSchemas]]
-     * @see ($docs/learning/backend/IModelDb.md#upgrading-schemas-in-an-imodel)
-     */
-    static validateSchemas(filePath, forReadWrite) {
-        const openMode = forReadWrite ? core_bentley_1.OpenMode.ReadWrite : core_bentley_1.OpenMode.Readonly;
-        const file = { path: filePath };
-        let result = core_bentley_1.DbResult.BE_SQLITE_OK;
-        try {
-            const upgradeOptions = {
-                domain: core_common_1.DomainOptions.CheckRecommendedUpgrades,
-            };
-            const nativeDb = this.openDgnDb(file, openMode, upgradeOptions);
-            nativeDb.closeIModel();
-        }
-        catch (err) {
-            result = err.errorNumber;
-        }
-        let schemaState = core_common_1.SchemaState.UpToDate;
-        switch (result) {
-            case core_bentley_1.DbResult.BE_SQLITE_OK:
-                schemaState = core_common_1.SchemaState.UpToDate;
-                break;
-            case core_bentley_1.DbResult.BE_SQLITE_ERROR_ProfileTooOld:
-            case core_bentley_1.DbResult.BE_SQLITE_ERROR_ProfileTooOldForReadWrite:
-            case core_bentley_1.DbResult.BE_SQLITE_ERROR_SchemaTooOld:
-                schemaState = core_common_1.SchemaState.TooOld;
-                break;
-            case core_bentley_1.DbResult.BE_SQLITE_ERROR_ProfileTooNew:
-            case core_bentley_1.DbResult.BE_SQLITE_ERROR_ProfileTooNewForReadWrite:
-            case core_bentley_1.DbResult.BE_SQLITE_ERROR_SchemaTooNew:
-                schemaState = core_common_1.SchemaState.TooNew;
-                break;
-            case core_bentley_1.DbResult.BE_SQLITE_ERROR_SchemaUpgradeRecommended:
-                schemaState = core_common_1.SchemaState.UpgradeRecommended;
-                break;
-            case core_bentley_1.DbResult.BE_SQLITE_ERROR_SchemaUpgradeRequired:
-                schemaState = core_common_1.SchemaState.UpgradeRequired;
-                break;
-            case core_bentley_1.DbResult.BE_SQLITE_ERROR_InvalidProfileVersion:
-                throw new core_common_1.IModelError(core_bentley_1.DbResult.BE_SQLITE_ERROR_InvalidProfileVersion, "The profile of the Db is invalid. Cannot upgrade or open the Db.");
-            default:
-                throw new core_common_1.IModelError(core_bentley_1.DbResult.BE_SQLITE_ERROR, "Error validating schemas. Cannot upgrade or open the Db.");
-        }
-        return schemaState;
-    }
-    /** Get the ClassMetaDataRegistry for this iModel.
-     * @internal
-     */
-    get classMetaDataRegistry() {
-        if (this._classMetaDataRegistry === undefined)
-            this._classMetaDataRegistry = new ClassRegistry_1.MetaDataRegistry();
-        return this._classMetaDataRegistry;
-    }
-    /** Get the linkTableRelationships for this IModel */
-    get relationships() {
-        return this._relationships || (this._relationships = new Relationship_1.Relationships(this));
-    }
-    /** Get the CodeSpecs in this IModel. */
-    get codeSpecs() {
-        return (this._codeSpecs !== undefined) ? this._codeSpecs : (this._codeSpecs = new CodeSpecs_1.CodeSpecs(this));
-    }
-    /** @internal */
-    insertCodeSpec(codeSpec) {
-        return this.nativeDb.insertCodeSpec(codeSpec.name, codeSpec.properties); // TODO: Remove "as any" when NativeLibrary.ts is updated so "spec" isn't marked as required
-    }
-    /** Prepare an ECSQL statement.
-     * @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.
-     */
-    prepareStatement(sql, logErrors = true) {
-        const stmt = new ECSqlStatement_1.ECSqlStatement();
-        stmt.prepare(this.nativeDb, sql, logErrors);
-        return stmt;
-    }
-    /** Prepare an ECSQL statement.
-     * @param sql The ECSQL statement to prepare
-     * @returns `undefined` if there is a problem preparing the statement.
-     */
-    tryPrepareStatement(sql) {
-        const statement = new ECSqlStatement_1.ECSqlStatement();
-        const result = statement.tryPrepare(this.nativeDb, sql);
-        return core_bentley_1.DbResult.BE_SQLITE_OK === result.status ? statement : undefined;
-    }
-    /** Construct an entity (Element or Model) from an iModel.
-     * @throws [[IModelError]] if the entity cannot be constructed.
-     */
-    constructEntity(props) {
-        const jsClass = this.getJsClass(props.classFullName);
-        return new jsClass(props, this);
-    }
-    /** Get the JavaScript class that handles a given entity class.  */
-    getJsClass(classFullName) {
-        try {
-            return ClassRegistry_1.ClassRegistry.getClass(classFullName, this);
-        }
-        catch (err) {
-            if (!ClassRegistry_1.ClassRegistry.isNotFoundError(err)) {
-                throw err;
-            }
-            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.
-     */
-    getMetaData(classFullName) {
-        let metadata = this.classMetaDataRegistry.find(classFullName);
-        if (metadata === undefined) {
-            this.loadMetaData(classFullName);
-            metadata = this.classMetaDataRegistry.find(classFullName);
-            if (metadata === undefined)
-                throw ClassRegistry_1.ClassRegistry.makeMetaDataNotFoundError(classFullName); // do not log
-        }
-        return metadata;
-    }
-    /** Invoke a callback on each property of the specified class, optionally including superclass properties.
-     * @param iModel  The IModel that contains the schema
-     * @param classFullName The full class name to load the metadata, if necessary
-     * @param wantSuper If true, superclass properties will also be processed
-     * @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.
-     */
-    static forEachMetaData(iModel, classFullName, wantSuper, func, includeCustom = true) {
-        const meta = iModel.getMetaData(classFullName); // will load if necessary
-        for (const propName in meta.properties) { // eslint-disable-line guard-for-in
-            const propMeta = meta.properties[propName];
-            if (includeCustom || !propMeta.isCustomHandled || propMeta.isCustomHandledOrphan)
-                func(propName, propMeta);
-        }
-        if (wantSuper && meta.baseClasses && meta.baseClasses.length > 0)
-            meta.baseClasses.forEach((baseClass) => this.forEachMetaData(iModel, baseClass, true, func, includeCustom));
-    }
-    /** @internal */
-    loadMetaData(classFullName) {
-        if (this.classMetaDataRegistry.find(classFullName))
-            return;
-        const className = classFullName.split(":");
-        if (className.length !== 2)
-            throw new core_common_1.IModelError(core_bentley_1.IModelStatus.BadArg, `Invalid classFullName: ${classFullName}`);
-        const val = this.nativeDb.getECClassMetaData(className[0], className[1]);
-        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);
-        const metaData = new core_common_1.EntityMetaData(JSON.parse(val.result));
-        this.classMetaDataRegistry.add(classFullName, metaData);
-        // Recursive, to make sure that base classes are cached.
-        if (metaData.baseClasses !== undefined && metaData.baseClasses.length > 0)
-            metaData.baseClasses.forEach((baseClassName) => this.loadMetaData(baseClassName));
-    }
-    /** Returns the full schema for the input name.
-     * @param name The name of the schema e.g. 'BisCore'
-     * @returns The SchemaProps for the requested schema
-     * @throws if the schema can not be found or loaded.
-     */
-    getSchemaProps(name) {
-        return this.nativeDb.getSchemaProps(name);
-    }
-    /** Query if this iModel contains the definition of the specified class.
-     * @param classFullName The full name of the class, for example, SomeSchema:SomeClass
-     * @returns true if the iModel contains the class definition or false if not.
-     * @see querySchemaVersion
-     * @see importSchema
-     */
-    containsClass(classFullName) {
-        const classNameParts = classFullName.replace(".", ":").split(":");
-        return classNameParts.length === 2 && this.nativeDb.getECClassMetaData(classNameParts[0], classNameParts[1]).error === undefined;
-    }
-    /** Query for a schema of the specified name in this iModel.
-     * @returns The schema version as a semver-compatible string or `undefined` if the schema has not been imported.
-     */
-    querySchemaVersion(schemaName) {
-        const sql = `SELECT VersionMajor,VersionWrite,VersionMinor FROM ECDbMeta.ECSchemaDef WHERE Name=:schemaName LIMIT 1`;
-        return this.withPreparedStatement(sql, (statement) => {
-            statement.bindString("schemaName", schemaName);
-            if (core_bentley_1.DbResult.BE_SQLITE_ROW === statement.step()) {
-                const versionMajor = statement.getValue(0).getInteger(); // ECSchemaDef.VersionMajor --> semver.major
-                const versionWrite = statement.getValue(1).getInteger(); // ECSchemaDef.VersionWrite --> semver.minor
-                const versionMinor = statement.getValue(2).getInteger(); // ECSchemaDef.VersionMinor --> semver.patch
-                return `${versionMajor}.${versionWrite}.${versionMinor}`;
-            }
-            return undefined;
-        });
-    }
-    /** Retrieve a named texture image from this iModel, as a TextureData.
-     * @param props the texture load properties which must include the name of the texture to load
-     * @returns the TextureData or undefined if the texture image is not present.
-     * @alpha
-     */
-    async queryTextureData(props) {
-        return this.nativeDb.queryTextureData(props);
-    }
-    /** Query a "file property" from this iModel, as a string.
-     * @returns the property string or undefined if the property is not present.
-     */
-    queryFilePropertyString(prop) {
-        return this.nativeDb.queryFileProperty(prop, true);
-    }
-    /** Query a "file property" from this iModel, as a blob.
-     * @returns the property blob or undefined if the property is not present.
-     */
-    queryFilePropertyBlob(prop) {
-        return this.nativeDb.queryFileProperty(prop, false);
-    }
-    /** Save a "file property" to this iModel
-     * @param prop the FilePropertyProps that describes the new property
-     * @param value either a string or a blob to save as the file property
-     */
-    saveFileProperty(prop, strValue, blobVal) {
-        this.nativeDb.saveFileProperty(prop, strValue, blobVal);
-    }
-    /** delete a "file property" from this iModel
-     * @param prop the FilePropertyProps that describes the property
-     */
-    deleteFileProperty(prop) {
-        this.nativeDb.saveFileProperty(prop, undefined, undefined);
-    }
-    /** Query for the next available major id for a "file property" from this iModel.
-     * @param prop the FilePropertyProps that describes the property
-     * @returns the next available (that is, an unused) id for prop. If none are present, will return 0.
-     */
-    queryNextAvailableFileProperty(prop) { return this.nativeDb.queryNextAvailableFileProperty(prop); }
-    /** @internal */
-    async requestSnap(sessionId, props) {
-        let request = this._snaps.get(sessionId);
-        if (undefined === request) {
-            request = new IModelHost_1.IModelHost.platform.SnapRequest();
-            this._snaps.set(sessionId, request);
-        }
-        else
-            request.cancelSnap();
-        try {
-            return await request.doSnap(this.nativeDb, core_bentley_1.JsonUtils.toObject(props));
-        }
-        finally {
-            this._snaps.delete(sessionId);
-        }
-    }
-    /** Cancel a previously requested snap.
-     * @internal
-     */
-    cancelSnap(sessionId) {
-        const request = this._snaps.get(sessionId);
-        if (undefined !== request) {
-            request.cancelSnap();
-            this._snaps.delete(sessionId);
-        }
-    }
-    /** Get the clip containment status for the supplied elements. */
-    async getGeometryContainment(props) {
-        return this.nativeDb.getGeometryContainment(core_bentley_1.JsonUtils.toObject(props));
-    }
-    /** Get the mass properties for the supplied elements. */
-    async getMassProperties(props) {
-        return this.nativeDb.getMassProperties(core_bentley_1.JsonUtils.toObject(props));
-    }
-    /** Get the IModel coordinate corresponding to each GeoCoordinate point in the input */
-    async getIModelCoordinatesFromGeoCoordinates(props) {
-        return this.nativeDb.getIModelCoordinatesFromGeoCoordinates(props);
-    }
-    /** Get the GeoCoordinate (longitude, latitude, elevation) corresponding to each IModel Coordinate point in the input */
-    async getGeoCoordinatesFromIModelCoordinates(props) {
-        return this.nativeDb.getGeoCoordinatesFromIModelCoordinates(props);
-    }
-    /** Export meshes suitable for graphics APIs from arbitrary geometry in elements in this IModelDb.
-     *  * Requests can be slow when processing many elements so it is expected that this function be used on a dedicated backend,
-     *    or that shared backends export a limited number of elements at a time.
-     *  * Vertices are exported in the IModelDb's world coordinate system, which is right-handed with Z pointing up.
-     *  * The results of changing [ExportGraphicsOptions]($core-backend) during the [ExportGraphicsOptions.onGraphics]($core-backend) callback are not defined.
-     *
-     * Example that prints the mesh for element 1 to stdout in [OBJ format](https://en.wikipedia.org/wiki/Wavefront_.obj_file)
-     * ```ts
-     * const onGraphics: ExportGraphicsFunction = (info: ExportGraphicsInfo) => {
-     *   const mesh: ExportGraphicsMesh = info.mesh;
-     *   for (let i = 0; i < mesh.points.length; i += 3) {
-     *     process.stdout.write(`v ${mesh.points[i]} ${mesh.points[i + 1]} ${mesh.points[i + 2]}\n`);
-     *     process.stdout.write(`vn ${mesh.normals[i]} ${mesh.normals[i + 1]} ${mesh.normals[i + 2]}\n`);
-     *   }
-     *
-     *   for (let i = 0; i < mesh.params.length; i += 2) {
-     *     process.stdout.write(`vt ${mesh.params[i]} ${mesh.params[i + 1]}\n`);
-     *   }
-     *
-     *   for (let i = 0; i < mesh.indices.length; i += 3) {
-     *     const p1 = mesh.indices[i];
-     *     const p2 = mesh.indices[i + 1];
-     *     const p3 = mesh.indices[i + 2];
-     *     process.stdout.write(`f ${p1}/${p1}/${p1} ${p2}/${p2}/${p2} ${p3}/${p3}/${p3}\n`);
-     *   }
-     * };
-     *
-     * iModel.exportGraphics(({ onGraphics, elementIdArray: ["0x1"] }));
-     * ```
-     * @returns 0 if successful, status otherwise
-     * @public
-     */
-    exportGraphics(exportProps) {
-        return this.nativeDb.exportGraphics(exportProps);
-    }
-    /**
-     * Exports meshes suitable for graphics APIs from a specified [GeometryPart]($core-backend)
-     * in this IModelDb.
-     * The expected use case is to call [IModelDb.exportGraphics]($core-backend) and supply the
-     * optional partInstanceArray argument, then call this function for each unique GeometryPart from
-     * that list.
-     *  * The results of changing [ExportPartGraphicsOptions]($core-backend) during the
-     *    [ExportPartGraphicsOptions.onPartGraphics]($core-backend) callback are not defined.
-     *  * See export-gltf under test-apps in the iTwin.js monorepo for a working reference.
-     * @returns 0 is successful, status otherwise
-     * @public
-     */
-    exportPartGraphics(exportProps) {
-        return this.nativeDb.exportPartGraphics(exportProps);
-    }
-    /** Request geometry stream information from an element in binary format instead of json.
-     * @returns IModelStatus.Success if successful
-     * @alpha
-     */
-    elementGeometryRequest(requestProps) {
-        return this.nativeDb.processGeometryStream(requestProps);
-    }
-    /** Create brep geometry for inclusion in an element's geometry stream.
-     * @returns IModelStatus.Success if successful
-     * @throws [[IModelError]] to report issues with input geometry or parameters
-     * @alpha
-     */
-    createBRepGeometry(createProps) {
-        return this.nativeDb.createBRepGeometry(createProps);
-    }
-    /** Generate graphics for an element or geometry stream.
-     * @see [readElementGraphics]($frontend) to convert the result to a [RenderGraphic]($frontend) for display.
-     */
-    async generateElementGraphics(request) {
-        return (0, ElementGraphics_1.generateElementGraphics)(request, this);
-    }
-    /** 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.
-     * @note All saved `SettingDictionary`s are loaded into [[workspace.settings]] every time an iModel is opened.
-     * @beta
-     */
-    saveSettingDictionary(name, dict) {
-        this.withSqliteStatement("REPLACE INTO be_Prop(id,SubId,TxnMode,Namespace,Name,strData) VALUES(0,0,0,?,?,?)", (stmt) => {
-            stmt.bindString(1, IModelDb._settingPropNamespace);
-            stmt.bindString(2, name);
-            stmt.bindString(3, JSON.stringify(dict));
-            const rc = stmt.step();
-            if (rc !== core_bentley_1.DbResult.BE_SQLITE_DONE)
-                throw new core_common_1.IModelError(rc, "cannot save setting");
-        });
-        this.saveChanges("add settings");
-    }
-    /** Delete a SettingDictionary, previously added with [[saveSettingDictionary]], from this iModel.
-     * @param name The name of the dictionary to delete.
-     * @beta
-     */
-    deleteSettingDictionary(name) {
-        this.withSqliteStatement("DELETE FROM be_Prop WHERE Namespace=? AND Name=?", (stmt) => {
-            stmt.bindString(1, IModelDb._settingPropNamespace);
-            stmt.bindString(2, name);
-            const rc = stmt.step();
-            if (rc !== core_bentley_1.DbResult.BE_SQLITE_DONE)
-                throw new core_common_1.IModelError(rc, "cannot delete setting");
-        });
-        this.saveChanges("delete settings");
-    }
-    /** Load all setting dictionaries in this iModel into `this.workspace.settings` */
-    loadSettingDictionaries() {
-        if (!this.nativeDb.isOpen())
-            return;
-        this.withSqliteStatement("SELECT Name,StrData FROM be_Prop WHERE Namespace=?", (stmt) => {
-            stmt.bindString(1, IModelDb._settingPropNamespace);
-            while (stmt.step() === core_bentley_1.DbResult.BE_SQLITE_ROW) {
-                try {
-                    const dict = JSON.parse(stmt.getValueString(1));
-                    this.workspace.settings.addDictionary(stmt.getValueString(0), Settings_1.SettingsPriority.iModel, dict);
-                }
-                catch (e) {
-                    core_bentley_1.UnexpectedErrors.handle(e);
-                }
-            }
-        });
-    }
-}
-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";
-/** @public */
-(function (IModelDb) {
-    /** The collection of models in an [[IModelDb]].
-     * @public
-     */
-    class Models {
-        /** @internal */
-        constructor(_iModel) {
-            this._iModel = _iModel;
-        }
-        /** Get the ModelProps with the specified identifier.
-         * @param modelId The Model identifier.
-         * @throws [[IModelError]] if the model is not found or cannot be loaded.
-         * @see tryGetModelProps
-         */
-        getModelProps(id) {
-            return this.getModelJson({ id });
-        }
-        /** Get the ModelProps with the specified identifier.
-         * @param modelId The Model identifier.
-         * @returns The ModelProps or `undefined` if the model is not found.
-         * @throws [[IModelError]] if the model cannot be loaded.
-         * @note Useful for cases when a model may or may not exist and throwing an `Error` would be overkill.
-         * @see getModelProps
-         */
-        tryGetModelProps(id) {
-            return this.tryGetModelJson({ id });
-        }
-        /** Query for the last modified time of the specified Model.
-         * @internal
-         */
-        queryLastModifiedTime(modelId) {
-            const sql = `SELECT LastMod FROM ${Model_1.Model.classFullName} WHERE ECInstanceId=:modelId`;
-            return this._iModel.withPreparedStatement(sql, (statement) => {
-                statement.bindId("modelId", modelId);
-                if (core_bentley_1.DbResult.BE_SQLITE_ROW === statement.step()) {
-                    return statement.getValue(0).getDateTime();
-                }
-                throw new core_common_1.IModelError(core_bentley_1.IModelStatus.InvalidId, `Can't get lastMod time for Model ${modelId}`);
-            });
-        }
-        /** Get the Model with the specified identifier.
-         * @param modelId The Model identifier.
-         * @param modelClass Optional class to validate instance against. This parameter can accept abstract or concrete classes, but should be the same as the template (`T`) parameter.
-         * @throws [[IModelError]] if the model is not found, cannot be loaded, or fails validation when `modelClass` is specified.
-         * @see tryGetModel
-         */
-        getModel(modelId, modelClass) {
-            const model = this.tryGetModel(modelId, modelClass);
-            if (undefined === model) {
-                throw new core_common_1.IModelError(core_bentley_1.IModelStatus.NotFound, `Model=${modelId}`);
-            }
-            return model;
-        }
-        /** Get the Model with the specified identifier.
-         * @param modelId The Model identifier.
-         * @param modelClass Optional class to validate instance against. This parameter can accept abstract or concrete classes, but should be the same as the template (`T`) parameter.
-         * @returns The Model or `undefined` if the model is not found or fails validation when `modelClass` is specified.
-         * @throws [[IModelError]] if the model cannot be loaded.
-         * @note Useful for cases when a model may or may not exist and throwing an `Error` would be overkill.
-         * @see getModel
-         */
-        tryGetModel(modelId, modelClass) {
-            const modelProps = this.tryGetModelProps(modelId);
-            if (undefined === modelProps)
-                return undefined; // no Model with that modelId found
-            const model = this._iModel.constructEntity(modelProps);
-            if (undefined === modelClass)
-                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=${modelIdArg}`);
-            }
-            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.nativeDb.getModel(modelIdArg);
-            }
-            catch (err) {
-                return undefined;
-            }
-        }
-        /** Get the sub-model of the specified Element.
-         * See [[IModelDb.Elements.queryElementIdByCode]] for more on how to find an element by Code.
-         * @param modeledElementId Identifies the modeled element.
-         * @param modelClass Optional class to validate instance against. This parameter can accept abstract or concrete classes, but should be the same as the template (`T`) parameter.
-         * @throws [[IModelError]] if the sub-model is not found, cannot be loaded, or fails validation when `modelClass` is specified.
-         * @see tryGetSubModel
-         */
-        getSubModel(modeledElementId, modelClass) {
-            const modeledElementProps = this._iModel.elements.getElementProps(modeledElementId);
-            if (undefined === modeledElementProps.id || modeledElementProps.id === core_common_1.IModel.rootSubjectId)
-                throw new core_common_1.IModelError(core_bentley_1.IModelStatus.NotFound, "Root subject does not have a sub-model");
-            return this.getModel(modeledElementProps.id, modelClass);
-        }
-        /** Get the sub-model of the specified Element.
-         * See [[IModelDb.Elements.queryElementIdByCode]] for more on how to find an element by Code.
-         * @param modeledElementId Identifies the modeled element.
-         * @param modelClass Optional class to validate instance against. This parameter can accept abstract or concrete classes, but should be the same as the template (`T`) parameter.
-         * @returns The sub-model or `undefined` if the specified element does not have a sub-model or fails validation when `modelClass` is specified.
-         * @see getSubModel
-         */
-        tryGetSubModel(modeledElementId, modelClass) {
-            const modeledElementProps = this._iModel.elements.tryGetElementProps(modeledElementId);
-            if (undefined === modeledElementProps?.id || (core_common_1.IModel.rootSubjectId === modeledElementProps.id))
-                return undefined;
-            return this.tryGetModel(modeledElementProps.id, modelClass);
-        }
-        /** Create a new model in memory.
-         * See the example in [[InformationPartitionElement]].
-         * @param modelProps The properties to use when creating the model.
-         * @throws [[IModelError]] if there is a problem creating the model.
-         */
-        createModel(modelProps) { return this._iModel.constructEntity(modelProps); }
-        /** Insert a new model.
-         * @param props The data for the new model.
-         * @returns The newly inserted model's Id.
-         * @throws [[IModelError]] if unable to insert the model.
-         */
-        insertModel(props) {
-            try {
-                return props.id = this._iModel.nativeDb.insertModel(props);
-            }
-            catch (err) {
-                throw new core_common_1.IModelError(err.errorNumber, `Error inserting model [${err.message}], class=${props.classFullName}`);
-            }
-        }
-        /** Update an existing model.
-         * @param props the properties of the model to change
-         * @throws [[IModelError]] if unable to update the model.
-         */
-        updateModel(props) {
-            try {
-                this._iModel.nativeDb.updateModel(props);
-            }
-            catch (err) {
-                throw new core_common_1.IModelError(err.errorNumber, `error updating model [${err.message}] id=${props.id}`);
-            }
-        }
-        /** Mark the geometry of [[GeometricModel]] as having changed, by recording an indirect change to its GeometryGuid property.
-         * Typically the GeometryGuid changes automatically when [[GeometricElement]]s within the model are modified, but
-         * explicitly updating it is occasionally useful after modifying definition elements like line styles or materials that indirectly affect the appearance of
-         * [[GeometricElement]]s that reference those definition elements in their geometry streams.
-         * Cached [Tile]($frontend)s are only invalidated after the geometry guid of the model changes.
-         * @note This will throw IModelError with [IModelStatus.VersionTooOld]($core-bentley) if a version of the BisCore schema older than 1.0.11 is present in the iModel.
-         * @throws IModelError if unable to update the geometry guid.
-         * @see [[TxnManager.onModelGeometryChanged]] for the event emitted in response to such a change.
-         */
-        updateGeometryGuid(modelId) {
-            const error = this._iModel.nativeDb.updateModelGeometryGuid(modelId);
-            if (error !== core_bentley_1.IModelStatus.Success)
-                throw new core_common_1.IModelError(error, `updating geometry guid for model ${modelId}`);
-        }
-        /** Delete one or more existing models.
-         * @param ids The Ids of the models to be deleted
-         * @throws [[IModelError]]
-         */
-        deleteModel(ids) {
-            core_bentley_1.Id64.toIdSet(ids).forEach((id) => {
-                try {
-                    this._iModel.nativeDb.deleteModel(id);
-                }
-                catch (err) {
-                    throw new core_common_1.IModelError(err.errorNumber, `error deleting model [${err.message}] id ${id}`);
-                }
-            });
-        }
-        /** For each specified [[GeometricModel]], attempts to obtain the union of the volumes of all geometric elements within that model.
-         * @param ids The Id or Ids of the [[GeometricModel]]s for which to obtain the extents.
-         * @returns An array of results, one per supplied Id, in the order in which the Ids were supplied. If the extents could not be obtained, the
-         * corresponding results entry's `extents` will be a "null" range (@see [Range3d.isNull]($geometry)) and its `status` will indicate
-         * why the extents could not be obtained (e.g., because the Id did not identify a [[GeometricModel]]).
-         * @see [[queryRange]] to obtain the union of all of the models' extents.
-         */
-        async queryExtents(ids) {
-            ids = typeof ids === "string" ? [ids] : ids;
-            if (ids.length === 0)
-                return [];
-            return this._iModel.nativeDb.queryModelExtentsAsync(ids);
-        }
-        /** Computes the union of the volumes of all geoemtric elements within any number of [[GeometricModel]]s, specified by model Id.
-         * @see [[queryExtents]] to obtain discrete volumes for each model.
-         */
-        async queryRange(ids) {
-            const results = await this.queryExtents(ids);
-            const range = new core_geometry_1.Range3d();
-            for (const result of results)
-                range.union(core_geometry_1.Range3d.fromJSON(result.extents), range);
-            return range;
-        }
-    }
-    IModelDb.Models = Models;
-    /** The collection of elements in an [[IModelDb]].
-     * @public
-     */
-    class Elements {
-        /** @internal */
-        constructor(_iModel) {
-            this._iModel = _iModel;
-        }
-        /** 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=${elementId}`);
-            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.nativeDb.getElement(loadProps);
-            }
-            catch (err) {
-                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) {
-            if (typeof props === "string") {
-                props = core_bentley_1.Id64.isId64(props) ? { id: props } : { federationGuid: props };
-            }
-            else if (props instanceof core_common_1.Code) {
-                props = { code: props };
-            }
-            try {
-                return this._iModel.nativeDb.getElement(props);
-            }
-            catch (err) {
-                throw new core_common_1.IModelError(err.errorNumber, err.message);
-            }
-        }
-        /** Get properties of an Element by Id, FederationGuid, or Code
-         * @returns The properties of the element or `undefined` if the element is not found.
-         * @throws [[IModelError]] if the element exists, but cannot be loaded.
-         * @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 };
-            }
-            else if (elementId instanceof core_common_1.Code) {
-                elementId = { code: elementId };
-            }
-            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
-         * @param elementClass Optional class to validate instance against. This parameter can accept abstract or concrete classes, but should be the same as the template (`T`) parameter.
-         * @throws [[IModelError]] if the element is not found, cannot be loaded, or fails validation when `elementClass` is specified.
-         * @see tryGetElement
-         */
-        getElement(elementId, elementClass) {
-            const element = this.tryGetElement(elementId, elementClass);
-            if (undefined === element)
-                throw new core_common_1.IModelError(core_bentley_1.IModelStatus.NotFound, `Element=${elementId}`);
-            return element;
-        }
-        /** Get an element by Id, FederationGuid, or Code
-         * @param elementId either the element's Id, Code, or FederationGuid, or an ElementLoadProps
-         * @param elementClass Optional class to validate instance against. This parameter can accept abstract or concrete classes, but should be the same as the template (`T`) parameter.
-         * @returns The element or `undefined` if the element is not found or fails validation when `elementClass` is specified.
-         * @throws [[IModelError]] if the element exists, but cannot be loaded.
-         * @note Useful for cases when an element may or may not exist and throwing an `Error` would be overkill.
-         * @see getElement
-         */
-        tryGetElement(elementId, elementClass) {
-            if (typeof elementId === "string")
-                elementId = core_bentley_1.Id64.isId64(elementId) ? { id: elementId } : { federationGuid: elementId };
-            else if (elementId instanceof core_common_1.Code)
-                elementId = { code: elementId };
-            else
-                elementId.onlyBaseProperties = false; // we must load all properties to construct the element.
-            const elementProps = this.tryGetElementJson(elementId);
-            if (undefined === elementProps)
-                return undefined; // no Element with that elementId found
-            const element = this._iModel.constructEntity(elementProps);
-            if (undefined === elementClass)
-                return element; // elementClass was not specified, cannot call instanceof to validate
-            return element instanceof elementClass ? element : undefined;
-        }
-        /** Query for the Id of the element that has a specified code.
-         * This method is for the case where you know the element's Code.
-         * If you only know the code *value*, then in the simplest case, you can query on that
-         * and filter the results.
-         * In the simple case, call [[IModelDb.queryEntityIds]], specifying the code value in the where clause of the query params.
-         * Or, you can execute an ECSQL select statement. See
-         * [frequently used ECSQL queries]($docs/learning/backend/ECSQL-queries.md) for an example.
-         * @param code The code to look for
-         * @returns The element that uses the code or undefined if the code is not used.
-         * @throws IModelError if the code is invalid
-         */
-        queryElementIdByCode(code) {
-            if (core_bentley_1.Id64.isInvalid(code.spec))
-                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");
-            return this._iModel.withPreparedStatement("SELECT ECInstanceId FROM BisCore:Element WHERE CodeSpec.Id=? AND CodeScope.Id=? AND CodeValue=?", (stmt) => {
-                stmt.bindId(1, code.spec);
-                stmt.bindId(2, core_bentley_1.Id64.fromString(code.scope));
-                stmt.bindString(3, code.value);
-                if (core_bentley_1.DbResult.BE_SQLITE_ROW !== stmt.step())
-                    return undefined;
-                return stmt.getValue(0).getId();
-            });
-        }
-        /** Query for the last modified time of the specified element.
-         * @internal
-         */
-        queryLastModifiedTime(elementId) {
-            const sql = "SELECT LastMod FROM BisCore:Element WHERE ECInstanceId=:elementId";
-            return this._iModel.withPreparedStatement(sql, (statement) => {
-                statement.bindId("elementId", elementId);
-                if (core_bentley_1.DbResult.BE_SQLITE_ROW === statement.step())
-                    return statement.getValue(0).getDateTime();
-                throw new core_common_1.IModelError(core_bentley_1.IModelStatus.InvalidId, `Can't get lastMod time for Element ${elementId}`);
-            });
-        }
-        /** Create a new instance of an element.
-         * @param elProps The properties of the new element.
-         * @throws [[IModelError]] if there is a problem creating the element.
-         */
-        createElement(elProps) { return this._iModel.constructEntity(elProps); }
-        /** Insert a new element into the iModel.
-         * @param elProps The properties of the new element.
-         * @returns The newly inserted element's Id.
-         * @throws [[IModelError]] if unable to insert the element.
-         * @note For convenience, the value of `elProps.id` is updated to reflect the resultant element's id.
-         * However when `elProps.federationGuid` is not present or undefined, a new Guid will be generated and stored on the resultant element. But
-         * the value of `elProps.federationGuid` is *not* updated. Generally, it is best to re-read the element after inserting (e.g. via [[getElementProps]])
-         * if you intend to continue working with it. That will ensure its values reflect the persistent state.
-         */
-        insertElement(elProps) {
-            try {
-                return elProps.id = this._iModel.nativeDb.insertElement(elProps);
-            }
-            catch (err) {
-                err.message = `error inserting element: ${err.message}`;
-                throw err;
-            }
-        }
-        /** Update some properties of an existing element.
-         * To support clearing a property value, every property name that is present in the `elProps` object will be updated even if the value is `undefined`.
-         * To keep an individual element property unchanged, it should either be excluded from the `elProps` parameter or set to its current value.
-         * @param elProps the properties of the element to update.
-         * @note As described above, this is a special case where there is a difference between a property being excluded and a property being present in `elProps` but set to `undefined`.
-         * @throws [[IModelError]] if unable to update the element.
-         */
-        updateElement(elProps) {
-            try {
-                this._iModel.nativeDb.updateElement(elProps);
-            }
-            catch (err) {
-                err.message = `error updating element: ${err.message}`;
-                throw err;
-            }
-        }
-        /** Delete one or more elements from this iModel.
-         * @param ids The set of Ids of the element(s) to be deleted
-         * @throws [[IModelError]]
-         * @see deleteDefinitionElements
-         */
-        deleteElement(ids) {
-            const iModel = this._iModel;
-            core_bentley_1.Id64.toIdSet(ids).forEach((id) => {
-                try {
-                    iModel.nativeDb.deleteElement(id);
-                }
-                catch (err) {
-                    err.message = `error deleting element: ${err.message}`;
-                    throw err;
-                }
-            });
-        }
-        /** DefinitionElements can only be deleted if it can be determined that they are not referenced by other Elements.
-         * This *usage query* can be expensive since it may involve scanning the GeometryStreams of all GeometricElements.
-         * Since [[deleteElement]] does not perform these additional checks, it fails in order to prevent potentially referenced DefinitionElements from being deleted.
-         * This method performs those expensive checks and then calls *delete* if not referenced.
-         * @param ids The Ids of the DefinitionElements to attempt to delete. To prevent multiple passes over the same GeometricElements, it is best to pass in the entire array of
-         * DefinitionElements rather than calling this method separately for each one. Ids that are not valid DefinitionElements will be ignored.
-         * @returns An IdSet of the DefinitionElements that are used and were therefore not deleted.
-         * @see deleteElement
-         * @beta
-         */
-        deleteDefinitionElements(definitionElementIds) {
-            const usageInfo = this._iModel.nativeDb.queryDefinitionElementUsage(definitionElementIds);
-            if (!usageInfo) {
-                throw new core_common_1.IModelError(core_bentley_1.IModelStatus.BadRequest, "Error querying for DefinitionElement usage");
-            }
-            const usedIdSet = usageInfo.usedIds ? core_bentley_1.Id64.toIdSet(usageInfo.usedIds) : new Set();
-            const deleteIfUnused = (ids, used) => {
-                if (ids) {
-                    ids.forEach((id) => {
-                        if (!used.has(id))
-                            this._iModel.elements.deleteElement(id);
-                    });
-                }
-            };
-            try {
-                this._iModel.nativeDb.beginPurgeOperation();
-                deleteIfUnused(usageInfo.spatialCategoryIds, usedIdSet);
-                deleteIfUnused(usageInfo.drawingCategoryIds, usedIdSet);
-                deleteIfUnused(usageInfo.viewDefinitionIds, usedIdSet);
-                deleteIfUnused(usageInfo.geometryPartIds, usedIdSet);
-                deleteIfUnused(usageInfo.lineStyleIds, usedIdSet);
-                deleteIfUnused(usageInfo.renderMaterialIds, usedIdSet);
-                deleteIfUnused(usageInfo.subCategoryIds, usedIdSet);
-                deleteIfUnused(usageInfo.textureIds, usedIdSet);
-                deleteIfUnused(usageInfo.displayStyleIds, usedIdSet);
-                deleteIfUnused(usageInfo.categorySelectorIds, usedIdSet);
-                deleteIfUnused(usageInfo.modelSelectorIds, usedIdSet);
-                if (usageInfo.otherDefinitionElementIds) {
-                    this._iModel.elements.deleteElement(usageInfo.otherDefinitionElementIds);
-                }
-            }
-            finally {
-                this._iModel.nativeDb.endPurgeOperation();
-            }
-            if (usageInfo.viewDefinitionIds) {
-                // take another pass in case a deleted ViewDefinition was the only usage of these view-related DefinitionElements
-                let viewRelatedIds = [];
-                if (usageInfo.displayStyleIds)
-                    viewRelatedIds = viewRelatedIds.concat(usageInfo.displayStyleIds.filter((id) => usedIdSet.has(id)));
-                if (usageInfo.categorySelectorIds)
-                    viewRelatedIds = viewRelatedIds.concat(usageInfo.categorySelectorIds.filter((id) => usedIdSet.has(id)));
-                if (usageInfo.modelSelectorIds)
-                    viewRelatedIds = viewRelatedIds.concat(usageInfo.modelSelectorIds.filter((id) => usedIdSet.has(id)));
-                if (viewRelatedIds.length > 0) {
-                    const viewRelatedUsageInfo = this._iModel.nativeDb.queryDefinitionElementUsage(viewRelatedIds);
-                    if (viewRelatedUsageInfo) {
-                        const usedViewRelatedIdSet = viewRelatedUsageInfo.usedIds ? core_bentley_1.Id64.toIdSet(viewRelatedUsageInfo.usedIds) : new Set();
-                        try {
-                            this._iModel.nativeDb.beginPurgeOperation();
-                            deleteIfUnused(viewRelatedUsageInfo.displayStyleIds, usedViewRelatedIdSet);
-                            deleteIfUnused(viewRelatedUsageInfo.categorySelectorIds, usedViewRelatedIdSet);
-                            deleteIfUnused(viewRelatedUsageInfo.modelSelectorIds, usedViewRelatedIdSet);
-                        }
-                        finally {
-                            this._iModel.nativeDb.endPurgeOperation();
-                        }
-                        viewRelatedIds.forEach((id) => {
-                            if (!usedViewRelatedIdSet.has(id))
-                                usedIdSet.delete(id);
-                        });
-                    }
-                }
-            }
-            return usedIdSet;
-        }
-        /** Query for the child elements of the specified element.
-         * @returns Returns an array of child element identifiers.
-         * @throws [[IModelError]]
-         */
-        queryChildren(elementId) {
-            const sql = "SELECT ECInstanceId FROM BisCore:Element WHERE Parent.Id=:elementId";
-            return this._iModel.withPreparedStatement(sql, (statement) => {
-                statement.bindId("elementId", elementId);
-                const childIds = [];
-                while (core_bentley_1.DbResult.BE_SQLITE_ROW === statement.step()) {
-                    childIds.push(statement.getValue(0).getId());
-                }
-                return childIds;
-            });
-        }
-        /** Query for the parent of the specified element.
-         * @param elementId The element to check for a parent
-         * @returns The identifier of the element's parent or undefined if the element has no parent
-         * @throws [[IModelError]] if the element does not exist
-         */
-        queryParent(elementId) {
-            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)
-                    throw new core_common_1.IModelError(core_bentley_1.IModelStatus.NotFound, `Element=${elementId}`);
-                const value = stmt.getValue(0);
-                return value.isNull ? undefined : value.getId();
-            });
-        }
-        /** Returns true if the specified Element has a sub-model.
-         * @see [[IModelDb.Models.getSubModel]]
-         */
-        hasSubModel(elementId) {
-            if (core_common_1.IModel.rootSubjectId === elementId)
-                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";
-            return this._iModel.withPreparedStatement(sql, (statement) => {
-                statement.bindId("elementId", elementId);
-                return core_bentley_1.DbResult.BE_SQLITE_ROW === statement.step();
-            });
-        }
-        /** Get the root subject element. */
-        getRootSubject() { return this.getElement(core_common_1.IModel.rootSubjectId); }
-        /** Query for aspects of a particular class (polymorphically) associated with this element.
-         * @throws [[IModelError]]
-         * @note Most cases should use the [[getAspects]] wrapper rather than calling this method directly.
-         * @internal
-         */
-        _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
-            return this._iModel.withPreparedStatement(sql, (statement) => {
-                statement.bindId("elementId", elementId);
-                const aspects = [];
-                while (core_bentley_1.DbResult.BE_SQLITE_ROW === statement.step()) {
-                    const aspectInstanceId = statement.getValue(0).getId();
-                    const aspectClassFullName = statement.getValue(1).getClassNameForClassId().replace(".", ":");
-                    if ((undefined === excludedClassFullNames) || (!excludedClassFullNames.has(aspectClassFullName))) {
-                        aspects.push(this._queryAspect(aspectInstanceId, aspectClassFullName));
-                    }
-                }
-                return aspects;
-            });
-        }
-        /** Query for aspect by ECInstanceId
-         * @throws [[IModelError]]
-         */
-        _queryAspect(aspectInstanceId, aspectClassName) {
-            const sql = `SELECT * FROM ${aspectClassName} WHERE ECInstanceId=:aspectInstanceId`;
-            const aspect = this._iModel.withPreparedStatement(sql, (statement) => {
-                statement.bindId("aspectInstanceId", aspectInstanceId);
-                if (core_bentley_1.DbResult.BE_SQLITE_ROW === statement.step()) {
-                    const aspectProps = statement.getRow(); // start with everything that SELECT * returned
-                    aspectProps.classFullName = aspectProps.className.replace(".", ":"); // add in property required by EntityProps
-                    aspectProps.className = undefined; // clear property from SELECT * that we don't want in the final instance
-                    return aspectProps;
-                }
-                return undefined;
-            });
-            if (undefined === aspect) {
-                throw new core_common_1.IModelError(core_bentley_1.IModelStatus.NotFound, `ElementAspect not found ${aspectInstanceId}, ${aspectClassName}`);
-            }
-            return this._iModel.constructEntity(aspect);
-        }
-        /** Get a single ElementAspect by its instance Id.
-         * @throws [[IModelError]]
-         */
-        getAspect(aspectInstanceId) {
-            const sql = "SELECT ECClassId FROM BisCore:ElementAspect WHERE ECInstanceId=:aspectInstanceId";
-            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;
-            });
-            if (undefined === aspectClassFullName) {
-                throw new core_common_1.IModelError(core_bentley_1.IModelStatus.NotFound, `ElementAspect not found ${aspectInstanceId}`);
-            }
-            return this._queryAspect(aspectInstanceId, aspectClassFullName);
-        }
-        /** Get the ElementAspect instances that are owned by the specified element.
-         * @param elementId Get ElementAspects associated with this Element
-         * @param aspectClassFullName Optionally filter ElementAspects polymorphically by this class name
-         * @throws [[IModelError]]
-         */
-        getAspects(elementId, aspectClassFullName) {
-            if (undefined === aspectClassFullName) {
-                const uniqueAspects = this._queryAspects(elementId, ElementAspect_1.ElementUniqueAspect.classFullName);
-                const multiAspects = this._queryAspects(elementId, ElementAspect_1.ElementMultiAspect.classFullName);
-                return uniqueAspects.concat(multiAspects);
-            }
-            const aspects = this._queryAspects(elementId, aspectClassFullName);
-            return aspects;
-        }
-        /** Insert a new ElementAspect into the iModel.
-         * @param aspectProps The properties of the new ElementAspect.
-         * @throws [[IModelError]] if unable to insert the ElementAspect.
-         * @returns the id of the newly inserted aspect.
-         * @note Aspect Ids may collide with element Ids, so don't put both in a container like Set or Map
-         *       use [EntityReference]($common) for that instead.
-         */
-        insertAspect(aspectProps) {
-            try {
-                return this._iModel.nativeDb.insertElementAspect(aspectProps);
-            }
-            catch (err) {
-                throw new core_common_1.IModelError(err.errorNumber, `Error inserting ElementAspect [${err.message}], class: ${aspectProps.classFullName}`);
-            }
-        }
-        /** Update an exist ElementAspect within the iModel.
-         * @param aspectProps The properties to use to update the ElementAspect.
-         * @throws [[IModelError]] if unable to update the ElementAspect.
-         */
-        updateAspect(aspectProps) {
-            try {
-                this._iModel.nativeDb.updateElementAspect(aspectProps);
-            }
-            catch (err) {
-                throw new core_common_1.IModelError(err.errorNumber, `Error updating ElementAspect [${err.message}], id: ${aspectProps.id}`);
-            }
-        }
-        /** Delete one or more ElementAspects from this iModel.
-         * @param aspectInstanceIds The set of instance Ids of the ElementAspect(s) to be deleted
-         * @throws [[IModelError]] if unable to delete the ElementAspect.
-         */
-        deleteAspect(aspectInstanceIds) {
-            const iModel = this._iModel;
-            core_bentley_1.Id64.toIdSet(aspectInstanceIds).forEach((aspectInstanceId) => {
-                try {
-                    iModel.nativeDb.deleteElementAspect(aspectInstanceId);
-                }
-                catch (err) {
-                    throw new core_common_1.IModelError(err.errorNumber, `Error deleting ElementAspect [${err.message}], id: ${aspectInstanceId}`);
-                }
-            });
-        }
-    }
-    IModelDb.Elements = Elements;
-    /** The collection of views in an [[IModelDb]].
-     * @public
-     */
-    class Views {
-        /** @internal */
-        constructor(_iModel) {
-            this._iModel = _iModel;
-        }
-        /** Query for the array of ViewDefinitionProps of the specified class and matching the specified IsPrivate setting.
-         * @param className Query for view definitions of this class.
-         * @param wantPrivate If true, include private view definitions.
-         */
-        queryViewDefinitionProps(className = "BisCore.ViewDefinition", limit = IModelDb.defaultLimit, offset = 0, wantPrivate = false) {
-            const where = (wantPrivate === false) ? "IsPrivate=FALSE" : "";
-            const ids = this._iModel.queryEntityIds({ from: className, limit, offset, where });
-            const props = [];
-            const imodel = this._iModel;
-            ids.forEach((id) => {
-                try {
-                    props.push(imodel.elements.getElementProps(id));
-                }
-                catch (err) { }
-            });
-            return props;
-        }
-        /** 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.
-         * @returns true if all views were iterated, false if iteration was terminated early due to callback returning false.
-         *
-         * **Example: Finding all views of a specific DrawingModel**
-         * ``` ts
-         * [[include:IModelDb.Views.iterateViews]]
-         * ```
-         */
-        iterateViews(params, callback) {
-            const ids = this._iModel.queryEntityIds(params);
-            let finished = true;
-            for (const id of ids) {
-                try {
-                    const view = this._iModel.elements.getElement(id);
-                    if (undefined !== view && view instanceof ViewDefinition_1.ViewDefinition) {
-                        finished = callback(view);
-                        if (!finished)
-                            break;
-                    }
-                }
-                catch (err) { }
-            }
-            return finished;
-        }
-        loadViewStateProps(viewDefinitionElement, options, drawingExtents) {
-            const elements = this._iModel.elements;
-            const viewDefinitionProps = viewDefinitionElement.toJSON();
-            const categorySelectorProps = elements.getElementProps(viewDefinitionProps.categorySelectorId);
-            const displayStyleProps = elements.getElementProps({
-                id: viewDefinitionProps.displayStyleId,
-                displayStyle: options?.displayStyle,
-            });
-            const viewStateData = {
-                viewDefinitionProps,
-                displayStyleProps,
-                categorySelectorProps,
-            };
-            const modelSelectorId = viewDefinitionProps.modelSelectorId;
-            if (modelSelectorId !== undefined) {
-                viewStateData.modelSelectorProps = elements.getElementProps(modelSelectorId);
-            }
-            else if (viewDefinitionElement instanceof ViewDefinition_1.SheetViewDefinition) {
-                viewStateData.sheetProps = elements.getElementProps(viewDefinitionElement.baseModelId);
-                viewStateData.sheetAttachments = Array.from(this._iModel.queryEntityIds({
-                    from: "BisCore.ViewAttachment",
-                    where: `Model.Id=${viewDefinitionElement.baseModelId}`,
-                }));
-            }
-            else if (viewDefinitionElement instanceof ViewDefinition_1.DrawingViewDefinition) {
-                // Ensure view has known extents
-                if (drawingExtents && !drawingExtents.isNull)
-                    viewStateData.modelExtents = drawingExtents.toJSON();
-                // Include information about the associated [[SectionDrawing]], if any.
-                // NB: The SectionDrawing ECClass may not exist in the iModel's version of the BisCore ECSchema.
-                try {
-                    const sectionDrawing = this._iModel.elements.tryGetElement(viewDefinitionElement.baseModelId);
-                    if (sectionDrawing && sectionDrawing.spatialView && core_bentley_1.Id64.isValidId64(sectionDrawing.spatialView.id)) {
-                        viewStateData.sectionDrawing = {
-                            spatialView: sectionDrawing.spatialView.id,
-                            displaySpatialView: true === sectionDrawing.jsonProperties.displaySpatialView,
-                            drawingToSpatialTransform: sectionDrawing.jsonProperties.drawingToSpatialTransform,
-                        };
-                    }
-                }
-                catch {
-                    //
-                }
-            }
-            return viewStateData;
-        }
-        /** @deprecated in 3.x. use [[getViewStateProps]]. */
-        getViewStateData(viewDefinitionId, options) {
-            const view = this._iModel.elements.getElement(viewDefinitionId);
-            let drawingExtents;
-            if (view instanceof ViewDefinition_1.DrawingViewDefinition) {
-                try {
-                    drawingExtents = core_geometry_1.Range3d.fromJSON(this._iModel.nativeDb.queryModelExtents({ id: view.baseModelId }).modelExtents);
-                }
-                catch {
-                    //
-                }
-            }
-            return this.loadViewStateProps(view, options, drawingExtents);
-        }
-        /** Obtain a [ViewStateProps]($common) for a [[ViewDefinition]] specified by element Id. */
-        async getViewStateProps(viewDefinitionId, options) {
-            const view = this._iModel.elements.getElement(viewDefinitionId);
-            let drawingExtents;
-            if (view instanceof ViewDefinition_1.DrawingViewDefinition)
-                drawingExtents = (await this._iModel.models.queryRange(view.baseModelId));
-            return this.loadViewStateProps(view, options, drawingExtents);
-        }
-        getViewThumbnailArg(viewDefinitionId) {
-            return { namespace: "dgn_View", name: "Thumbnail", id: viewDefinitionId };
-        }
-        /** Get the thumbnail for a view.
-         * @param viewDefinitionId The Id of the view for thumbnail
-         * @returns the ThumbnailProps, or undefined if no thumbnail exists.
-         */
-        getThumbnail(viewDefinitionId) {
-            const viewArg = this.getViewThumbnailArg(viewDefinitionId);
-            const sizeProps = this._iModel.nativeDb.queryFileProperty(viewArg, true);
-            if (undefined === sizeProps)
-                return undefined;
-            const out = JSON.parse(sizeProps);
-            out.image = this._iModel.nativeDb.queryFileProperty(viewArg, false);
-            return out;
-        }
-        /** Save a thumbnail for a view.
-         * @param viewDefinitionId The Id of the view for thumbnail
-         * @param thumbnail The thumbnail data.
-         * @returns 0 if successful
-         */
-        saveThumbnail(viewDefinitionId, thumbnail) {
-            const viewArg = this.getViewThumbnailArg(viewDefinitionId);
-            const props = { format: thumbnail.format, height: thumbnail.height, width: thumbnail.width };
-            this._iModel.nativeDb.saveFileProperty(viewArg, JSON.stringify(props), thumbnail.image);
-            return 0;
-        }
-        /** Set the default view property the iModel
-         * @param viewId The Id of the ViewDefinition to use as the default
-         */
-        setDefaultViewId(viewId) {
-            const spec = { namespace: "dgn_View", name: "DefaultView" };
-            const blob32 = new Uint32Array(2);
-            blob32[0] = core_bentley_1.Id64.getLowerUint32(viewId);
-            blob32[1] = core_bentley_1.Id64.getUpperUint32(viewId);
-            const blob8 = new Uint8Array(blob32.buffer);
-            this._iModel.saveFileProperty(spec, undefined, blob8);
-        }
-    }
-    /** 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
-     */
-    let TileContentState;
-    (function (TileContentState) {
-        TileContentState[TileContentState["New"] = 0] = "New";
-        TileContentState[TileContentState["Pending"] = 1] = "Pending";
-        TileContentState[TileContentState["Loading"] = 2] = "Loading";
-    })(TileContentState = IModelDb.TileContentState || (IModelDb.TileContentState = {}));
-    /** @internal */
-    class Tiles {
-        /** @internal */
-        constructor(_iModel) {
-            this._iModel = _iModel;
-        }
-        /** @internal */
-        async requestTileTreeProps(id) {
-            return new Promise((resolve, reject) => {
-                this._iModel.nativeDb.getTileTree(id, (ret) => {
-                    if (undefined !== ret.error)
-                        reject(new core_common_1.IModelError(ret.error.status, `TreeId=${id}`));
-                    else
-                        resolve(ret.result);
-                });
-            });
-        }
-        pollTileContent(resolve, reject, treeId, tileId) {
-            let ret;
-            try {
-                ret = this._iModel.nativeDb.pollTileContent(treeId, tileId);
-            }
-            catch (err) {
-                // Typically "imodel not open".
-                reject(err);
-                return;
-            }
-            if (ret.error) {
-                reject(new core_common_1.IModelError(ret.error.status, `TreeId=${treeId} TileId=${tileId}`));
-            }
-            else if (ret.result && typeof ret.result !== "number") { // if type is not a number, it's the TileContent interface
-                const res = ret.result;
-                const iModelId = this._iModel.iModelId;
-                const tileSizeThreshold = IModelHost_1.IModelHost.logTileSizeThreshold;
-                const tileSize = res.content.length;
-                if (tileSize > tileSizeThreshold) {
-                    core_bentley_1.Logger.logWarning(loggerCategory, "Tile size (in bytes) larger than specified threshold", () => ({ tileSize, tileSizeThreshold, treeId, tileId, iModelId }));
-                }
-                const loadTimeThreshold = IModelHost_1.IModelHost.logTileLoadTimeThreshold;
-                const loadTime = res.elapsedSeconds;
-                if (loadTime > loadTimeThreshold) {
-                    core_bentley_1.Logger.logWarning(loggerCategory, "Tile load time (in seconds) greater than specified threshold", () => ({ loadTime, loadTimeThreshold, treeId, tileId, iModelId }));
-                }
-                resolve(res);
-            }
-            else { // if the type is a number, it's the TileContentState enum
-                // ###TODO: Decide appropriate timeout interval. May want to switch on state (new vs loading vs pending)
-                setTimeout(() => this.pollTileContent(resolve, reject, treeId, tileId), 10);
-            }
-        }
-        /** @internal */
-        async requestTileContent(treeId, tileId) {
-            return new Promise((resolve, reject) => {
-                this.pollTileContent(resolve, reject, treeId, tileId);
-            });
-        }
-        /** @internal */
-        async getTileContent(treeId, tileId) {
-            const ret = await new Promise((resolve) => {
-                this._iModel.nativeDb.getTileContent(treeId, tileId, resolve);
-            });
-            if (undefined !== ret.error) {
-                throw new core_common_1.IModelError(ret.error.status, `TreeId=${treeId} TileId=${tileId}`);
-            }
-            (0, core_bentley_1.assert)(undefined !== ret.result);
-            return ret.result;
-        }
-    }
-    IModelDb.Tiles = Tiles;
-})(IModelDb = exports.IModelDb || (exports.IModelDb = {}));
-/**
- * A local copy of an iModel from iModelHub that can pull and potentially push changesets.
- * BriefcaseDb raises a set of events to allow apps and subsystems to track its object life cycle, including [[onOpen]] and [[onOpened]].
- * @public
- */
-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);
-        this._openMode = args.openMode;
-        this.briefcaseId = args.briefcaseId;
-        if (this.useLockServer) // if the iModel uses a lock server, create a ServerBasedLocks LockControl for this BriefcaseDb.
-            this._locks = new ServerBasedLocks_1.ServerBasedLocks(this);
-    }
-    /** override superclass method */
-    get isBriefcase() { return true; }
-    static findByKey(key) {
-        return super.findByKey(key);
-    }
-    static tryFindByKey(key) {
-        const db = super.tryFindByKey(key);
-        return db?.isBriefcaseDb() ? db : undefined;
-    }
-    /**
-     * The Guid that identifies the *context* that owns this iModel.
-     * GuidString | undefined for the superclass, but required for BriefcaseDb
-     * */
-    get iTwinId() { return super.iTwinId; } // eslint-disable-line @typescript-eslint/no-non-null-assertion
-    /**
-     * Determine whether this BriefcaseDb should use a lock server.
-     * All must be true:
-     * - file is open for write
-     * - has an assigned briefcaseId
-     * - the "no locking" flag is not present. This is a property of an iModel, established when the iModel is created in IModelHub.
-     */
-    get useLockServer() {
-        return !this.isReadonly && (this.briefcaseId !== core_common_1.BriefcaseIdValue.Unassigned) && (undefined === this.nativeDb.queryLocalValue(BriefcaseLocalValue.NoLocking));
-    }
-    /** Upgrades the profile or domain schemas. File must be closed before this call and is always left closed. */
-    static async doUpgrade(briefcase, upgradeOptions, description) {
-        const nativeDb = this.openDgnDb({ path: briefcase.fileName }, core_bentley_1.OpenMode.ReadWrite, upgradeOptions); // performs the upgrade
-        const wasChanges = nativeDb.hasPendingTxns();
-        nativeDb.closeIModel();
-        if (wasChanges)
-            await withBriefcaseDb(briefcase, async (db) => db.pushChanges({ ...briefcase, description, retainLocks: true }));
-    }
-    /** Upgrades the schemas in the iModel based on the current version of the software. Follows a sequence of operations -
-     * * Acquires a schema lock to prevent other users from making any other changes while upgrade is happening
-     * * Updates the local briefcase with the schema changes.
-     * * Pushes the resulting changeset(s) to iModelHub.
-     * Note that the upgrade requires that the local briefcase be closed, and may result in one or two change sets depending on whether both
-     * profile and domain schemas need to get upgraded.
-     * @see ($docs/learning/backend/IModelDb.md#upgrading-schemas-in-an-imodel)
-    */
-    static async upgradeSchemas(briefcase) {
-        // upgrading schemas involves closing and reopening the file repeatedly. That's because the process of upgrading
-        // happens on a file open. We have to open-and-close the file at *each* of these steps:
-        // - acquire schema lock
-        // - upgrade profile
-        // - push changes
-        // - upgrade domain
-        // - push changes
-        // - release schema lock
-        // good thing computers are fast. Fortunately upgrading should be rare (and the push time will dominate anyway.) Don't try to optimize any of this away.
-        await withBriefcaseDb(briefcase, async (db) => db.acquireSchemaLock()); // may not really acquire lock if iModel uses "noLocks" mode.
-        try {
-            await this.doUpgrade(briefcase, { profile: core_common_1.ProfileOptions.Upgrade, schemaLockHeld: true }, "Upgraded profile");
-            await this.doUpgrade(briefcase, { domain: core_common_1.DomainOptions.Upgrade, schemaLockHeld: true }, "Upgraded domain schemas");
-        }
-        finally {
-            await withBriefcaseDb(briefcase, async (db) => db.locks.releaseAllLocks());
-        }
-    }
-    /** Open a briefcase file and return a new BriefcaseDb to interact with it.
-     * @param args parameters that specify the file name, and options for opening the briefcase file
-     */
-    static async open(args) {
-        this.onOpen.raiseEvent(args);
-        const file = { path: args.fileName, key: args.key };
-        const openMode = args.readonly ? 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() });
-        if (openMode === core_bentley_1.OpenMode.ReadWrite && CodeService_1.CodeService.createForIModel) {
-            try {
-                const codeService = CodeService_1.CodeService.createForIModel(briefcaseDb);
-                briefcaseDb._codeService = codeService;
-                this.onCodeServiceCreated.raiseEvent(codeService);
-            }
-            catch (e) {
-                if (e.errorId !== "NoCodeIndex") // no code index means iModel isn't enforcing codes.
-                    throw e;
-            }
-        }
-        BriefcaseManager_1.BriefcaseManager.logUsage(briefcaseDb);
-        this.onOpened.raiseEvent(briefcaseDb, args);
-        return briefcaseDb;
-    }
-    closeAndReopen(openMode) {
-        const fileName = this.pathName;
-        this.nativeDb.closeIModel();
-        this.nativeDb.openIModel(fileName, openMode);
-    }
-    /** Pull and apply changesets from iModelHub */
-    async pullChanges(arg) {
-        if (this.isReadonly) // we allow pulling changes into a briefcase that is readonly - close and reopen it writeable
-            this.closeAndReopen(core_bentley_1.OpenMode.ReadWrite);
-        try {
-            await BriefcaseManager_1.BriefcaseManager.pullAndApplyChangesets(this, arg ?? {});
-            this.initializeIModelDb();
-        }
-        finally {
-            if (this.isReadonly) // if the briefcase was opened readonly - close and reopen it readonly
-                this.closeAndReopen(core_bentley_1.OpenMode.Readonly);
-        }
-        IpcHost_1.IpcHost.notifyTxns(this, "notifyPulledChanges", this.changeset);
-    }
-    /** Push changes to iModelHub. */
-    async pushChanges(arg) {
-        if (this.briefcaseId === core_common_1.BriefcaseIdValue.Unassigned)
-            return;
-        if (this.nativeDb.hasUnsavedChanges())
-            throw new core_common_1.IModelError(core_bentley_1.ChangeSetStatus.HasUncommittedChanges, "Cannot push with unsaved changes");
-        if (!this.nativeDb.hasPendingTxns())
-            return; // nothing to push
-        await BriefcaseManager_1.BriefcaseManager.pullMergePush(this, arg);
-        this.initializeIModelDb();
-        const changeset = this.changeset;
-        IpcHost_1.IpcHost.notifyTxns(this, "notifyPushedChanges", changeset);
-    }
-}
-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 {
-    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);
-    }
-    async performRefresh(accessToken, iModel) {
-        this._timestamp = 0; // everyone needs to wait until token is valid
-        // we're going to request that the checkpoint manager use this user's accessToken to obtain a new access token for this checkpoint's storage account.
-        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.nativeDb.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 });
-            if (!props)
-                throw new Error("can't reset checkpoint sas token");
-            container.accessToken = props.sasToken;
-            this.setTimestamp(props.sasToken);
-            core_bentley_1.Logger.logInfo(BackendLoggerCategory_1.BackendLoggerCategory.Authorization, "refreshed checkpoint sasToken successfully");
-        }
-        finally {
-            this._promise = undefined;
-        }
-    }
-    setTimestamp(sasToken) {
-        const exp = new URLSearchParams(sasToken).get("se");
-        const sasTokenExpiry = exp ? Date.parse(exp) : 0;
-        this._timestamp = sasTokenExpiry - (this._safetySeconds * 1000);
-        if (this._timestamp < Date.now())
-            core_bentley_1.Logger.logError(BackendLoggerCategory_1.BackendLoggerCategory.Authorization, "attached with timestamp that expires before safety interval");
-    }
-    async refreshSas(accessToken, iModel) {
-        if (this._timestamp > Date.now())
-            return; // current token is fine
-        if (undefined === this._promise) // has reattach already begun?
-            this._promise = this.performRefresh(accessToken, iModel); // no, start it
-        return this._promise;
-    }
-}
-/** A *snapshot* iModel database file that is used for archival and data transfer purposes.
- * @see [Snapshot iModels]($docs/learning/backend/AccessingIModels.md#snapshot-imodels)
- * @see [About IModelDb]($docs/learning/backend/IModelDb.md)
- * @public
- */
-class SnapshotDb extends IModelDb {
-    constructor(nativeDb, key) {
-        super({ nativeDb, key, changeset: nativeDb.getCurrentChangeset() });
-        this._openMode = nativeDb.isReadonly() ? core_bentley_1.OpenMode.Readonly : core_bentley_1.OpenMode.ReadWrite;
-    }
-    get isSnapshot() { return true; }
-    static findByKey(key) {
-        return super.findByKey(key);
-    }
-    static tryFindByKey(key) {
-        const db = super.tryFindByKey(key);
-        return db?.isSnapshotDb() ? db : undefined;
-    }
-    /** Create an *empty* local [Snapshot]($docs/learning/backend/AccessingIModels.md#snapshot-imodels) iModel file.
-     * Snapshots are not synchronized with iModelHub, so do not have a change timeline.
-     * > Note: A *snapshot* cannot be modified after [[close]] is called.
-     * @param filePath The file that will contain the new iModel *snapshot*
-     * @param options The parameters that define the new iModel *snapshot*
-     * @returns A writeable SnapshotDb
-     * @see [Snapshot iModels]($docs/learning/backend/AccessingIModels.md#snapshot-imodels)
-     */
-    static createEmpty(filePath, options) {
-        const nativeDb = new IModelHost_1.IModelHost.platform.DgnDb();
-        nativeDb.createIModel(filePath, options);
-        nativeDb.resetBriefcaseId(core_common_1.BriefcaseIdValue.Unassigned);
-        const snapshotDb = new SnapshotDb(nativeDb, core_bentley_1.Guid.createValue());
-        if (options.createClassViews)
-            snapshotDb._createClassViewsOnClose = true; // save flag that will be checked when close() is called
-        return snapshotDb;
-    }
-    /** Create a local [Snapshot]($docs/learning/backend/AccessingIModels.md#snapshot-imodels) iModel file, using this iModel as a *seed* or starting point.
-     * Snapshots are not synchronized with iModelHub, so do not have a change timeline.
-     * > Note: A *snapshot* cannot be modified after [[close]] is called.
-     * @param iModelDb The snapshot will be initialized from the current contents of this iModelDb
-     * @param snapshotFile The file that will contain the new iModel *snapshot*
-     * @param options Optional properties that determine how the snapshot iModel is created.
-     * @returns A writeable SnapshotDb
-     * @see [Snapshot iModels]($docs/learning/backend/AccessingIModels.md#snapshot-imodels)
-     */
-    static createFrom(iModelDb, snapshotFile, options) {
-        iModelDb.performCheckpoint();
-        IModelJsFs_1.IModelJsFs.copySync(iModelDb.pathName, snapshotFile);
-        const nativeDb = new IModelHost_1.IModelHost.platform.DgnDb();
-        nativeDb.openIModel(snapshotFile, core_bentley_1.OpenMode.ReadWrite, undefined, options);
-        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()))
-            nativeDb.setIModelId(core_bentley_1.Guid.createValue());
-        nativeDb.deleteLocalValue(BriefcaseLocalValue.StandaloneEdit);
-        nativeDb.saveChanges();
-        nativeDb.deleteAllTxns();
-        nativeDb.resetBriefcaseId(core_common_1.BriefcaseIdValue.Unassigned);
-        const snapshotDb = new SnapshotDb(nativeDb, core_bentley_1.Guid.createValue());
-        if (options?.createClassViews)
-            snapshotDb._createClassViewsOnClose = true; // save flag that will be checked when close() is called
-        return snapshotDb;
-    }
-    /** open this SnapshotDb read/write, strictly to apply incoming changesets. Used for creating new checkpoints.
-     * @internal
-     */
-    static openForApplyChangesets(path, props) {
-        const file = { path, key: props?.key };
-        const nativeDb = this.openDgnDb(file, core_bentley_1.OpenMode.ReadWrite, undefined, props);
-        (0, core_bentley_1.assert)(undefined !== file.key);
-        return new SnapshotDb(nativeDb, file.key);
-    }
-    /** Open a read-only iModel *snapshot*.
-     * @param path the full path of the snapshot iModel file to open.
-     * @param props options for opening snapshot
-     * @see [[close]]
-     * @throws [[IModelError]] If the file is not found or is not a valid *snapshot*.
-     */
-    static openFile(path, opts) {
-        const file = { path, key: opts?.key };
-        const nativeDb = this.openDgnDb(file, core_bentley_1.OpenMode.Readonly, undefined, opts);
-        (0, core_bentley_1.assert)(undefined !== file.key);
-        return new SnapshotDb(nativeDb, file.key);
-    }
-    /** Open a previously downloaded V1 checkpoint file.
-     * @note The key is generated by this call is predictable and is formed from the IModelId and ChangeSetId.
-     * This is so every backend working on the same checkpoint will use the same key, to permit multiple backends
-     * servicing the same checkpoint.
-     * @internal
-     */
-    static openCheckpointV1(fileName, checkpoint) {
-        const snapshot = this.openFile(fileName, { key: CheckpointManager_1.CheckpointManager.getKey(checkpoint) });
-        snapshot._iTwinId = checkpoint.iTwinId;
-        return snapshot;
-    }
-    /** Open a V2 *checkpoint*, a special form of snapshot iModel that represents a read-only snapshot of an iModel from iModelHub at a particular point in time.
-     * > Note: The checkpoint daemon must already be running and a checkpoint must already exist in iModelHub's storage *before* this function is called.
-     * @param checkpoint The checkpoint to open
-     * @note The key generated by this call is predictable and is formed from the IModelId and ChangeSetId.
-     * This is so every backend working on the same checkpoint will use the same key, to permit multiple backends
-     * servicing the same checkpoint.
-     * @throws [[IModelError]] If the checkpoint is not found in iModelHub or the checkpoint daemon is not supported in the current environment.
-     * @internal
-     */
-    static async openCheckpointV2(checkpoint) {
-        const { dbName, container } = await CheckpointManager_1.V2CheckpointManager.attach(checkpoint);
-        const key = CheckpointManager_1.CheckpointManager.getKey(checkpoint);
-        const tempFileBase = (0, path_1.join)(IModelHost_1.IModelHost.cacheDir, `${checkpoint.iModelId}\$${checkpoint.changeset.id}`); // temp files for this checkpoint should go in the cacheDir.
-        const snapshot = SnapshotDb.openFile(dbName, { key, tempFileBase, container });
-        snapshot._iTwinId = checkpoint.iTwinId;
-        try {
-            CheckpointManager_1.CheckpointManager.validateCheckpointGuids(checkpoint, snapshot);
-        }
-        catch (err) {
-            snapshot.close();
-            throw err;
-        }
-        snapshot._refreshSas = new RefreshV2CheckpointSas(container.accessToken, checkpoint.reattachSafetySeconds);
-        return snapshot;
-    }
-    /** Used to refresh the container sasToken using the current user's accessToken
-     * @internal
-     */
-    async refreshContainerSas(userAccessToken) {
-        return this._refreshSas?.refreshSas(userAccessToken, this);
-    }
-    /** @internal */
-    beforeClose() {
-        super.beforeClose();
-        if (this._createClassViewsOnClose) { // check for flag set during create
-            if (core_bentley_1.BentleyStatus.SUCCESS !== this.nativeDb.createClassViewsInDb()) {
-                throw new core_common_1.IModelError(core_bentley_1.IModelStatus.SQLiteError, "Error creating class views");
-            }
-            else {
-                this.saveChanges();
-            }
-        }
-    }
-}
-exports.SnapshotDb = SnapshotDb;
-/**
- * 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.
- * Standalone iModels are designed such that the API for Standalone iModels and Briefcase
- * iModels (those synchronized with iModelHub) are as similar and consistent as possible.
- * This leads to a straightforward process where the a user starts with StandaloneDb and can
- * optionally choose to upgrade to an iTwin.
- *
- * Some additional details. Standalone iModels:
- * - always have [Guid.empty]($bentley) for their iTwinId (they are "unassociated" files)
- * - always have BriefcaseId === [BriefcaseIdValue.Unassigned]($common)
- * - are connected to the frontend via [BriefcaseConnection.openStandalone]($frontend)
- * - may be opened without supplying any user credentials
- * - may be opened read/write
- * - cannot apply a changeset to nor generate a changesets (since there is no timeline from which to get/push changesets)
- * @public
- */
-class StandaloneDb extends BriefcaseDb {
-    get isStandalone() { return true; }
-    get useLockServer() { return false; } // standalone iModels have no lock server
-    static findByKey(key) {
-        return super.findByKey(key);
-    }
-    static tryFindByKey(key) {
-        const db = super.tryFindByKey(key);
-        return db?.isStandaloneDb() ? db : undefined;
-    }
-    /** Create an *empty* standalone iModel.
-     * @param filePath The file path for the iModel
-     * @param args The parameters that define the new iModel
-     */
-    static createEmpty(filePath, args) {
-        const nativeDb = new IModelHost_1.IModelHost.platform.DgnDb();
-        nativeDb.createIModel(filePath, args);
-        nativeDb.saveLocalValue(BriefcaseLocalValue.StandaloneEdit, args.allowEdit);
-        nativeDb.setITwinId(core_bentley_1.Guid.empty);
-        nativeDb.resetBriefcaseId(core_common_1.BriefcaseIdValue.Unassigned);
-        nativeDb.saveChanges();
-        return new StandaloneDb({ nativeDb, key: core_bentley_1.Guid.createValue(), briefcaseId: core_common_1.BriefcaseIdValue.Unassigned, openMode: core_bentley_1.OpenMode.ReadWrite });
-    }
-    /**
-     * Upgrades the schemas in the standalone iModel file.
-     * Note that the upgrade requires that the file be closed, and will leave it back in the closed state.
-     * @param filePath Full path name of the standalone iModel file.
-     * @see ($docs/learning/backend/IModelDb.md#upgrading-schemas-in-an-imodel)
-     * @see [[StandaloneDb.validateSchemas]]
-     */
-    static upgradeStandaloneSchemas(filePath) {
-        let nativeDb = this.openDgnDb({ path: filePath }, core_bentley_1.OpenMode.ReadWrite, { profile: core_common_1.ProfileOptions.Upgrade, schemaLockHeld: true });
-        nativeDb.closeIModel();
-        nativeDb = this.openDgnDb({ path: filePath }, core_bentley_1.OpenMode.ReadWrite, { domain: core_common_1.DomainOptions.Upgrade, schemaLockHeld: true });
-        nativeDb.closeIModel();
-    }
-    /** Open a standalone iModel file.
-     * @param filePath The path of the standalone iModel file.
-     * @param openMode Optional open mode for the standalone iModel. The default is read/write.
-     * @throws [[IModelError]] if the file is not a standalone iModel.
-     * @see [BriefcaseConnection.openStandalone]($frontend) to open a StandaloneDb from the frontend
-     */
-    static openFile(filePath, openMode = core_bentley_1.OpenMode.ReadWrite, options) {
-        const file = { path: filePath, key: options?.key };
-        const nativeDb = this.openDgnDb(file, openMode, undefined, options);
-        try {
-            const iTwinId = nativeDb.getITwinId();
-            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);
-            return new StandaloneDb({ nativeDb, key: file.key, openMode, briefcaseId: core_common_1.BriefcaseIdValue.Unassigned });
-        }
-        catch (error) {
-            nativeDb.closeIModel();
-            throw error;
-        }
-    }
-}
-exports.StandaloneDb = StandaloneDb;
+"use strict";
+/*---------------------------------------------------------------------------------------------
+* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+* See LICENSE.md in the project root for license terms and full copyright notice.
+*--------------------------------------------------------------------------------------------*/
+/** @packageDocumentation
+ * @module iModels
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StandaloneDb = exports.SnapshotDb = exports.BriefcaseDb = exports.IModelDb = exports.BriefcaseLocalValue = void 0;
+const path_1 = require("path");
+const core_bentley_1 = require("@itwin/core-bentley");
+const core_common_1 = require("@itwin/core-common");
+const core_geometry_1 = require("@itwin/core-geometry");
+const BackendLoggerCategory_1 = require("./BackendLoggerCategory");
+const BriefcaseManager_1 = require("./BriefcaseManager");
+const CheckpointManager_1 = require("./CheckpointManager");
+const ClassRegistry_1 = require("./ClassRegistry");
+const CodeService_1 = require("./CodeService");
+const CodeSpecs_1 = require("./CodeSpecs");
+const ConcurrentQuery_1 = require("./ConcurrentQuery");
+const ECSqlStatement_1 = require("./ECSqlStatement");
+const Element_1 = require("./Element");
+const ElementAspect_1 = require("./ElementAspect");
+const ElementGraphics_1 = require("./ElementGraphics");
+const GeoCoordConfig_1 = require("./GeoCoordConfig");
+const IModelHost_1 = require("./IModelHost");
+const IModelJsFs_1 = require("./IModelJsFs");
+const IpcHost_1 = require("./IpcHost");
+const Model_1 = require("./Model");
+const Relationship_1 = require("./Relationship");
+const ServerBasedLocks_1 = require("./ServerBasedLocks");
+const SqliteStatement_1 = require("./SqliteStatement");
+const TxnManager_1 = require("./TxnManager");
+const ViewDefinition_1 = require("./ViewDefinition");
+const Settings_1 = require("./workspace/Settings");
+const Workspace_1 = require("./workspace/Workspace");
+// spell:ignore fontid fontmap
+const loggerCategory = BackendLoggerCategory_1.BackendLoggerCategory.IModelDb;
+/** A null-implementation of LockControl that does not attempt to limit access between briefcases. This relies on change-merging to resolve conflicts. */
+class NoLocks {
+    get isServerBased() { return false; }
+    close() { }
+    clearAllLocks() { }
+    holdsExclusiveLock() { return false; }
+    holdsSharedLock() { return false; }
+    checkExclusiveLock() { }
+    checkSharedLock() { }
+    elementWasCreated() { }
+    async acquireLocks() { }
+    async releaseAllLocks() { }
+}
+/** @internal */
+var BriefcaseLocalValue;
+(function (BriefcaseLocalValue) {
+    BriefcaseLocalValue["StandaloneEdit"] = "StandaloneEdit";
+    BriefcaseLocalValue["NoLocking"] = "NoLocking";
+})(BriefcaseLocalValue = exports.BriefcaseLocalValue || (exports.BriefcaseLocalValue = {}));
+// function to open an briefcaseDb, perform an operation, and then close it.
+const withBriefcaseDb = async (briefcase, fn) => {
+    const db = await BriefcaseDb.open(briefcase);
+    try {
+        return await fn(db);
+    }
+    finally {
+        db.close();
+    }
+};
+/**
+ * Settings for an individual iModel. May only include settings priority for iModel, iTwin and organization.
+ * @note if there is more than one iModel for an iTwin or organization, they will *each* hold a copy of the settings for those priorities.
+ */
+class IModelSettings extends Settings_1.BaseSettings {
+    verifyPriority(priority) {
+        if (priority <= Settings_1.SettingsPriority.application)
+            throw new Error("Use IModelHost.appSettings");
+    }
+    // attempt to resolve a setting from this iModel's settings, otherwise use appWorkspace's settings, otherwise defaultValue.
+    resolveSetting(name, resolver, defaultValue) {
+        return super.resolveSetting(name, resolver) ?? IModelHost_1.IModelHost.appWorkspace.settings.resolveSetting(name, resolver, defaultValue);
+    }
+}
+/** An iModel database file. The database file can either be a briefcase or a snapshot.
+ * @see [Accessing iModels]($docs/learning/backend/AccessingIModels.md)
+ * @see [About IModelDb]($docs/learning/backend/IModelDb.md)
+ * @public
+ */
+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);
+        this._statementCache = new SqliteStatement_1.StatementCache();
+        this._sqliteStatementCache = new SqliteStatement_1.StatementCache();
+        this._snaps = new Map();
+        /** @internal */
+        this._locks = new NoLocks();
+        /** 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._nativeDb = args.nativeDb;
+        this.nativeDb.setIModelDb(this);
+        this.loadSettingDictionaries();
+        GeoCoordConfig_1.GeoCoordConfig.loadForImodel(this.workspace.settings); // load gcs data specified by iModel's settings dictionaries, must be done before calling initializeIModelDb
+        this.initializeIModelDb();
+        IModelDb._openDbs.set(this._fileKey, this);
+        if (undefined === IModelDb._shutdownListener) { // the first time we create an IModelDb, add a listener to close any orphan files at shutdown.
+            IModelDb._shutdownListener = IModelHost_1.IModelHost.onBeforeShutdown.addListener(() => {
+                IModelDb._openDbs.forEach((db) => {
+                    try {
+                        db.abandonChanges();
+                        db.close();
+                    }
+                    catch { }
+                });
+            });
+        }
+    }
+    /** @alpha */
+    get codeService() { return this._codeService; }
+    /**
+     * Get the [[LockControl]] for this iModel.
+     * @beta
+     */
+    get locks() { return this._locks; } // eslint-disable-line @typescript-eslint/no-non-null-assertion
+    /**
+     * Get the [[Workspace]] for this iModel.
+     * @beta
+     */
+    get workspace() {
+        if (undefined === this._workspace)
+            this._workspace = new Workspace_1.ITwinWorkspace(new IModelSettings());
+        return this._workspace;
+    }
+    /** 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.
+     */
+    async acquireSchemaLock() {
+        return this.locks.acquireLocks({ exclusive: core_common_1.IModel.repositoryModelId });
+    }
+    /** determine whether the schema lock is currently held for this iModel. */
+    get holdsSchemaLock() {
+        return this.locks.holdsExclusiveLock(core_common_1.IModel.repositoryModelId);
+    }
+    /** @internal */
+    notifyChangesetApplied() {
+        this.changeset = this.nativeDb.getCurrentChangeset();
+        this.onChangesetApplied.raiseEvent();
+    }
+    get fontMap() {
+        return this._fontMap ?? (this._fontMap = new core_common_1.FontMap(this.nativeDb.readFontMap()));
+    }
+    /** @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.nativeDb.addNewFont({ name, type: type ?? core_common_1.FontType.TrueType });
+    }
+    /** Check if this iModel has been opened read-only or not. */
+    get isReadonly() { return this.openMode === core_bentley_1.OpenMode.Readonly; }
+    /** The Guid that identifies this iModel. */
+    get iModelId() {
+        (0, core_bentley_1.assert)(undefined !== super.iModelId);
+        return super.iModelId;
+    } // GuidString | undefined for the IModel superclass, but required for all IModelDb subclasses
+    /** @internal*/
+    get nativeDb() { return this._nativeDb; } // eslint-disable-line @typescript-eslint/no-non-null-assertion
+    /** Get the full path fileName of this iModelDb
+     * @note this member is only valid while the iModel is opened.
+     */
+    get pathName() { return this.nativeDb.getFilePath(); }
+    /** Close this IModel, if it is currently open. */
+    close() {
+        if (!this.isOpen)
+            return; // don't continue if already closed
+        this.beforeClose();
+        IModelDb._openDbs.delete(this._fileKey);
+        this._workspace?.close();
+        this.locks.close();
+        this._locks = undefined;
+        this._codeService?.close();
+        this._codeService = undefined;
+        this.nativeDb.closeIModel();
+        this._nativeDb = undefined; // the underlying nativeDb has been freed by closeIModel
+    }
+    /** @internal */
+    async refreshContainerSas(_userAccessToken) { }
+    /**
+     * Called by derived classes before closing the connection
+     * @internal
+     */
+    beforeClose() {
+        this.onBeforeClose.raiseEvent();
+        this.clearCaches();
+    }
+    /** @internal */
+    initializeIModelDb() {
+        const props = this.nativeDb.getIModelProps();
+        super.initialize(props.rootSubject.name, props);
+        if (this._initialized)
+            return;
+        this._initialized = true;
+        const db = this.isBriefcaseDb() ? this : undefined;
+        if (!db || !IpcHost_1.IpcHost.isValid)
+            return;
+        db.onNameChanged.addListener(() => IpcHost_1.IpcHost.notifyTxns(db, "notifyIModelNameChanged", db.name));
+        db.onRootSubjectChanged.addListener(() => IpcHost_1.IpcHost.notifyTxns(db, "notifyRootSubjectChanged", db.rootSubject));
+        db.onProjectExtentsChanged.addListener(() => IpcHost_1.IpcHost.notifyTxns(db, "notifyProjectExtentsChanged", db.projectExtents.toJSON()));
+        db.onGlobalOriginChanged.addListener(() => IpcHost_1.IpcHost.notifyTxns(db, "notifyGlobalOriginChanged", db.globalOrigin.toJSON()));
+        db.onEcefLocationChanged.addListener(() => IpcHost_1.IpcHost.notifyTxns(db, "notifyEcefLocationChanged", db.ecefLocation?.toJSON()));
+        db.onGeographicCoordinateSystemChanged.addListener(() => IpcHost_1.IpcHost.notifyTxns(db, "notifyGeographicCoordinateSystemChanged", db.geographicCoordinateSystem?.toJSON()));
+    }
+    /** Returns true if this is a BriefcaseDb
+     * @see [[BriefcaseDb.open]]
+     */
+    get isBriefcase() { return false; }
+    /** Type guard for instanceof [[BriefcaseDb]] */
+    isBriefcaseDb() { return this.isBriefcase; }
+    /** Returns true if this is a SnapshotDb
+     * @see [[SnapshotDb.open]]
+     */
+    get isSnapshot() { return false; }
+    /** Type guard for instanceof [[SnapshotDb]] */
+    isSnapshotDb() { return this.isSnapshot; }
+    /** Returns true if this is a *standalone* iModel
+     * @see [[StandaloneDb.open]]
+     * @internal
+     */
+    get isStandalone() { return false; }
+    /** Type guard for instanceof [[StandaloneDb]]
+     * @internal
+     */
+    isStandaloneDb() { return this.isStandalone; }
+    /** Return `true` if the underlying nativeDb is open and valid.
+     * @internal
+     */
+    get isOpen() { return undefined !== this.nativeDb; }
+    /** Get the briefcase Id of this iModel */
+    getBriefcaseId() { return this.isOpen ? this.nativeDb.getBriefcaseId() : core_common_1.BriefcaseIdValue.Illegal; }
+    /**
+     * Use a prepared ECSQL 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
+     * in the statement cache so it can be reused in the future. Use this method for ECSQL statements that will be
+     * reused often and are expensive to prepare. The statement cache holds the most recently used statements, discarding
+     * the oldest statements as it fills. For statements you don't intend to reuse, instead use [[withStatement]].
+     * @param sql The SQLite SQL statement to execute
+     * @param callback the callback to invoke on the prepared statement
+     * @param logErrors Determines if error will be logged if statement fail to prepare
+     * @returns the value returned by `callback`.
+     * @see [[withStatement]]
+     * @public
+     */
+    withPreparedStatement(ecsql, callback, logErrors = true) {
+        const stmt = this._statementCache.findAndRemove(ecsql) ?? this.prepareStatement(ecsql, logErrors);
+        const release = () => this._statementCache.addOrDispose(stmt);
+        try {
+            const val = callback(stmt);
+            if (val instanceof Promise) {
+                val.then(release, release);
+            }
+            else {
+                release();
+            }
+            return val;
+        }
+        catch (err) {
+            release();
+            throw err;
+        }
+    }
+    /**
+     * Prepared and execute a callback on an ECSQL statement. After the callback completes the statement is disposed.
+     * Use this method for ECSQL statements are either not expected to be reused, or are not expensive to prepare.
+     * For statements that will be reused often, instead use [[withPreparedStatement]].
+     * @param sql The SQLite SQL statement to execute
+     * @param callback the callback to invoke on the prepared statement
+     * @param logErrors Determines if error will be logged if statement fail to prepare
+     * @returns the value returned by `callback`.
+     * @see [[withPreparedStatement]]
+     * @public
+     */
+    withStatement(ecsql, callback, logErrors = true) {
+        const stmt = this.prepareStatement(ecsql, logErrors);
+        const release = () => stmt.dispose();
+        try {
+            const val = callback(stmt);
+            if (val instanceof Promise) {
+                val.then(release, release);
+            }
+            else {
+                release();
+            }
+            return val;
+        }
+        catch (err) {
+            release();
+            throw err;
+        }
+    }
+    /** Allow to execute query and read results along with meta data. The result are streamed.
+     * @param params The values to bind to the parameters (if the ECSQL has any).
+     * @param config Allow to specify certain flags which control how query is executed.
+     * @returns Returns *ECSqlQueryReader* which help iterate over result set and also give access to meta data.
+     * @beta
+     * */
+    createQueryReader(ecsql, params, config) {
+        if (!this._nativeDb || !this._nativeDb.isOpen()) {
+            throw new core_common_1.IModelError(core_bentley_1.DbResult.BE_SQLITE_ERROR, "db not open");
+        }
+        const executor = {
+            execute: async (request) => {
+                return ConcurrentQuery_1.ConcurrentQuery.executeQueryRequest(this.nativeDb, request);
+            },
+        };
+        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
+     */
+    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
+     */
+    async queryRowCount(ecsql, params) {
+        for await (const row of this.query(`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
+     */
+    async *restartQuery(token, ecsql, params, options) {
+        for await (const row of this.query(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
+     * in the statement cache so it can be reused in the future. Use this method for SQL statements that will be
+     * reused often and are expensive to prepare. The statement cache holds the most recently used statements, discarding
+     * the oldest statements as it fills. For statements you don't intend to reuse, instead use [[withSqliteStatement]].
+     * @param sql The SQLite SQL statement to execute
+     * @param callback the callback to invoke on the prepared statement
+     * @param logErrors Determine if errors are logged or not
+     * @returns the value returned by `callback`.
+     * @see [[withPreparedStatement]]
+     * @public
+     */
+    withPreparedSqliteStatement(sql, callback, logErrors = true) {
+        const stmt = this._sqliteStatementCache.findAndRemove(sql) ?? this.prepareSqliteStatement(sql, logErrors);
+        const release = () => this._sqliteStatementCache.addOrDispose(stmt);
+        try {
+            const val = callback(stmt);
+            if (val instanceof Promise) {
+                val.then(release, release);
+            }
+            else {
+                release();
+            }
+            return val;
+        }
+        catch (err) {
+            release();
+            throw err;
+        }
+    }
+    /**
+     * Prepared and execute a callback on a SQL statement. After the callback completes the statement is disposed.
+     * Use this method for SQL statements are either not expected to be reused, or are not expensive to prepare.
+     * For statements that will be reused often, instead use [[withPreparedSqliteStatement]].
+     * @param sql The SQLite SQL statement to execute
+     * @param callback the callback to invoke on the prepared statement
+     * @param logErrors Determine if errors are logged or not
+     * @returns the value returned by `callback`.
+     * @public
+     */
+    withSqliteStatement(sql, callback, logErrors = true) {
+        const stmt = this.prepareSqliteStatement(sql, logErrors);
+        const release = () => stmt.dispose();
+        try {
+            const val = callback(stmt);
+            if (val instanceof Promise) {
+                val.then(release, release);
+            }
+            else {
+                release();
+            }
+            return val;
+        }
+        catch (err) {
+            release();
+            throw err;
+        }
+    }
+    /** Prepare an SQL statement.
+     * @param sql The SQL statement to prepare
+     * @throws [[IModelError]] if there is a problem preparing the statement.
+     * @internal
+     */
+    prepareSqliteStatement(sql, logErrors = true) {
+        const stmt = new SqliteStatement_1.SqliteStatement(sql);
+        stmt.prepare(this.nativeDb, logErrors);
+        return stmt;
+    }
+    /**
+     * queries the BisCore.SubCategory table for the entries that are children of the passed categoryIds
+     * @param categoryIds categoryIds to query
+     * @returns array of SubCategoryResultRow
+     * @internal
+     */
+    async querySubCategories(categoryIds) {
+        const result = [];
+        const where = [...categoryIds].join(",");
+        const query = `SELECT ECInstanceId as id, Parent.Id as parentId, Properties as appearance FROM BisCore.SubCategory WHERE Parent.Id IN (${where})`;
+        try {
+            for await (const row of this.query(query, undefined, { rowFormat: core_common_1.QueryRowFormat.UseJsPropertyNames })) {
+                result.push(row);
+            }
+        }
+        catch {
+            // We can ignore the error here, and just return whatever we were able to query.
+        }
+        return result;
+    }
+    /** Query for a set of entity ids, given an EntityQueryParams
+     * @param params The query parameters. The `limit` and `offset` members should be used to page results.
+     * @returns an Id64Set with results of query
+     * @throws [[IModelError]] if the generated statement is invalid or [IModelDb.maxLimit]($backend) exceeded when collecting ids.
+     *
+     * *Example:*
+     * ``` ts
+     * [[include:ECSQL-backend-queries.select-element-by-code-value-using-queryEntityIds]]
+     * ```
+     */
+    queryEntityIds(params) {
+        let sql = "SELECT ECInstanceId FROM ";
+        if (params.only)
+            sql += "ONLY ";
+        sql += params.from;
+        if (params.where)
+            sql += ` WHERE ${params.where}`;
+        if (params.orderBy)
+            sql += ` ORDER BY ${params.orderBy}`;
+        if (typeof params.limit === "number" && params.limit > 0)
+            sql += ` LIMIT ${params.limit}`;
+        if (typeof params.offset === "number" && params.offset > 0)
+            sql += ` OFFSET ${params.offset}`;
+        const ids = new Set();
+        this.withPreparedStatement(sql, (stmt) => {
+            if (params.bindings)
+                stmt.bindValues(params.bindings);
+            for (const row of stmt) {
+                if (row.id !== undefined) {
+                    ids.add(row.id);
+                    if (ids.size > IModelDb.maxLimit) {
+                        throw new core_common_1.IModelError(core_bentley_1.IModelStatus.BadRequest, "Max LIMIT exceeded in SELECT statement");
+                    }
+                }
+            }
+        });
+        return ids;
+    }
+    /** Clear all in-memory caches held in this IModelDb. */
+    clearCaches() {
+        this._statementCache.clear();
+        this._sqliteStatementCache.clear();
+    }
+    /** Update the project extents for this iModel.
+     * <p><em>Example:</em>
+     * ``` ts
+     * [[include:IModelDb.updateProjectExtents]]
+     * ```
+     */
+    updateProjectExtents(newExtents) {
+        this.projectExtents = newExtents;
+        this.updateIModelProps();
+    }
+    /** Compute an appropriate project extents for this iModel based on the ranges of all spatial elements.
+     * Typically, the result is simply the union of the ranges of all spatial elements. However, the algorithm also detects "outlier elements",
+     * whose placements locate them so far from the rest of the spatial geometry that they are considered statistically insignificant. The
+     * range of an outlier element does not contribute to the computed extents.
+     * @param options Specifies the level of detail desired in the return value.
+     * @returns the computed extents.
+     * @note This method does not modify the IModel's stored project extents. @see [[updateProjectExtents]].
+     */
+    computeProjectExtents(options) {
+        const wantFullExtents = true === options?.reportExtentsWithOutliers;
+        const wantOutliers = true === options?.reportOutliers;
+        const result = this.nativeDb.computeProjectExtents(wantFullExtents, wantOutliers);
+        return {
+            extents: core_geometry_1.Range3d.fromJSON(result.extents),
+            extentsWithOutliers: result.fullExtents ? core_geometry_1.Range3d.fromJSON(result.fullExtents) : undefined,
+            outliers: result.outliers,
+        };
+    }
+    /** Update the [EcefLocation]($docs/learning/glossary#eceflocation) of this iModel.  */
+    updateEcefLocation(ecef) {
+        this.setEcefLocation(ecef);
+        this.updateIModelProps();
+    }
+    /** Update the IModelProps of this iModel in the database. */
+    updateIModelProps() {
+        this.nativeDb.updateIModelProps(this.toJSON());
+    }
+    /** Commit pending changes to this iModel.
+     * @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.
+     */
+    saveChanges(description) {
+        if (this.openMode === core_bentley_1.OpenMode.Readonly)
+            throw new core_common_1.IModelError(core_bentley_1.IModelStatus.ReadOnly, "IModelDb was opened read-only");
+        const stat = this.nativeDb.saveChanges(description);
+        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. */
+    abandonChanges() {
+        this.nativeDb.abandonChanges();
+    }
+    /**
+     * Save all changes and perform a [checkpoint](https://www.sqlite.org/c3ref/wal_checkpoint_v2.html) on this IModelDb.
+     * This ensures that all changes to the database since it was opened are saved to its file and the WAL file is truncated.
+     * @note Checkpoint automatically happens when IModelDbs are closed. However, the checkpoint
+     * operation itself can take some time. It may be useful to call this method prior to closing so that the checkpoint "penalty" is paid earlier.
+     * @note Another use for this function is to permit the file to be copied while it is open for write. iModel files should
+     * rarely be copied, and even less so while they're opened. But this scenario is sometimes encountered for tests.
+     */
+    performCheckpoint() {
+        if (!this.isReadonly) {
+            this.saveChanges();
+            this.nativeDb.performCheckpoint();
+        }
+    }
+    /** @internal */
+    reverseTxns(numOperations) {
+        return this.nativeDb.reverseTxns(numOperations);
+    }
+    /** @internal */
+    reinstateTxn() {
+        return this.nativeDb.reinstateTxn();
+    }
+    /** @internal */
+    restartTxnSession() {
+        return this.nativeDb.restartTxnSession();
+    }
+    /** Import an ECSchema. On success, the schema definition is stored in the iModel.
+     * This method is asynchronous (must be awaited) because, in the case where this IModelDb is a briefcase, this method first obtains the schema lock from the iModel server.
+     * You must import a schema into an iModel before you can insert instances of the classes in that schema. See [[Element]]
+     * @param schemaFileName  array of Full paths to ECSchema.xml files to be imported.
+     * @param {SchemaImportOptions} options - options during schema import.
+     * @throws [[IModelError]] if the schema lock cannot be obtained or there is a problem importing the schema.
+     * @note Changes are saved if importSchemas is successful and abandoned if not successful.
+     * @see querySchemaVersion
+     */
+    async importSchemas(schemaFileNames, options) {
+        if (this.nativeDb.getITwinId() !== core_bentley_1.Guid.empty) // if this iModel is associated with an iTwin, importing schema requires the schema lock
+            await this.acquireSchemaLock();
+        const maybeCustomNativeContext = options?.ecSchemaXmlContext?.nativeContext;
+        const nativeImportOptions = {
+            schemaLockHeld: true,
+            ecSchemaXmlContext: maybeCustomNativeContext,
+        };
+        const stat = this.nativeDb.importSchemas(schemaFileNames, nativeImportOptions);
+        if (core_bentley_1.DbResult.BE_SQLITE_OK !== stat) {
+            throw new core_common_1.IModelError(stat, "Error importing schema");
+        }
+        this.clearCaches();
+    }
+    /** Import ECSchema(s) serialized to XML. On success, the schema definition is stored in the iModel.
+     * This method is asynchronous (must be awaited) because, in the case where this IModelDb is a briefcase, this method first obtains the schema lock from the iModel server.
+     * You must import a schema into an iModel before you can insert instances of the classes in that schema. See [[Element]]
+     * @param serializedXmlSchemas  The xml string(s) created from a serialized ECSchema.
+     * @throws [[IModelError]] if the schema lock cannot be obtained or there is a problem importing the schema.
+     * @note Changes are saved if importSchemaStrings is successful and abandoned if not successful.
+     * @see querySchemaVersion
+     * @alpha
+     */
+    async importSchemaStrings(serializedXmlSchemas) {
+        if (this.iTwinId && this.iTwinId !== core_bentley_1.Guid.empty) // if this iModel is associated with an iTwin, importing schema requires the schema lock
+            await this.acquireSchemaLock();
+        const stat = this.nativeDb.importXmlSchemas(serializedXmlSchemas, { schemaLockHeld: true });
+        if (core_bentley_1.DbResult.BE_SQLITE_OK !== stat)
+            throw new core_common_1.IModelError(stat, "Error importing schema");
+        this.clearCaches();
+    }
+    /** Find an opened instance of any subclass of IModelDb, by filename
+     * @note this method returns an IModelDb if the filename is open for *any* subclass of IModelDb
+    */
+    static findByFilename(fileName) {
+        for (const entry of this._openDbs) {
+            if (entry[1].pathName === fileName)
+                return entry[1];
+        }
+        return undefined;
+    }
+    /** Find an open IModelDb by its key.
+     * @note This method is mainly for use by RPC implementations.
+     * @throws [[IModelNotFoundResponse]] if an open IModelDb matching the key is not found.
+     * @see [IModel.key]($common)
+     */
+    static findByKey(key) {
+        const iModelDb = this.tryFindByKey(key);
+        if (undefined === iModelDb)
+            throw new core_common_1.IModelNotFoundResponse(); // a very specific status for the RpcManager
+        return iModelDb;
+    }
+    /** Attempt to find an open IModelDb by key.
+     * @returns The matching IModelDb or `undefined`.
+     */
+    static tryFindByKey(key) {
+        return this._openDbs.get(key);
+    }
+    /** @internal */
+    static openDgnDb(file, openMode, upgradeOptions, props) {
+        file.key = file.key ?? core_bentley_1.Guid.createValue();
+        if (this.tryFindByKey(file.key))
+            throw new core_common_1.IModelError(core_bentley_1.IModelStatus.AlreadyOpen, `key [${file.key}] for file [${file.path}] is already in use`);
+        const isUpgradeRequested = upgradeOptions?.domain === core_common_1.DomainOptions.Upgrade || upgradeOptions?.profile === core_common_1.ProfileOptions.Upgrade;
+        if (isUpgradeRequested && openMode !== core_bentley_1.OpenMode.ReadWrite)
+            throw new core_common_1.IModelError(core_bentley_1.IModelStatus.UpgradeFailed, "Cannot upgrade a Readonly Db");
+        try {
+            const nativeDb = new IModelHost_1.IModelHost.platform.DgnDb();
+            nativeDb.openIModel(file.path, openMode, upgradeOptions, props, props?.container);
+            return nativeDb;
+        }
+        catch (err) {
+            throw new core_common_1.IModelError(err.errorNumber, `${err.message}, ${file.path}`);
+        }
+    }
+    /**
+     * Determines if the schemas in the Db must or can be upgraded by comparing them with those included in the
+     * current version of the software.
+     * @param filePath Full name of the briefcase including path
+     * @param forReadWrite Pass true if validating for read-write scenarios - note that the schema version requirements
+     * for opening the DgnDb read-write is more stringent than when opening the database read-only
+     * @throws [[IModelError]] If the Db was in an invalid state and that causes a problem with validating schemas
+     * @see [[BriefcaseDb.upgradeSchemas]] or [[StandaloneDb.upgradeSchemas]]
+     * @see ($docs/learning/backend/IModelDb.md#upgrading-schemas-in-an-imodel)
+     */
+    static validateSchemas(filePath, forReadWrite) {
+        const openMode = forReadWrite ? core_bentley_1.OpenMode.ReadWrite : core_bentley_1.OpenMode.Readonly;
+        const file = { path: filePath };
+        let result = core_bentley_1.DbResult.BE_SQLITE_OK;
+        try {
+            const upgradeOptions = {
+                domain: core_common_1.DomainOptions.CheckRecommendedUpgrades,
+            };
+            const nativeDb = this.openDgnDb(file, openMode, upgradeOptions);
+            nativeDb.closeIModel();
+        }
+        catch (err) {
+            result = err.errorNumber;
+        }
+        let schemaState = core_common_1.SchemaState.UpToDate;
+        switch (result) {
+            case core_bentley_1.DbResult.BE_SQLITE_OK:
+                schemaState = core_common_1.SchemaState.UpToDate;
+                break;
+            case core_bentley_1.DbResult.BE_SQLITE_ERROR_ProfileTooOld:
+            case core_bentley_1.DbResult.BE_SQLITE_ERROR_ProfileTooOldForReadWrite:
+            case core_bentley_1.DbResult.BE_SQLITE_ERROR_SchemaTooOld:
+                schemaState = core_common_1.SchemaState.TooOld;
+                break;
+            case core_bentley_1.DbResult.BE_SQLITE_ERROR_ProfileTooNew:
+            case core_bentley_1.DbResult.BE_SQLITE_ERROR_ProfileTooNewForReadWrite:
+            case core_bentley_1.DbResult.BE_SQLITE_ERROR_SchemaTooNew:
+                schemaState = core_common_1.SchemaState.TooNew;
+                break;
+            case core_bentley_1.DbResult.BE_SQLITE_ERROR_SchemaUpgradeRecommended:
+                schemaState = core_common_1.SchemaState.UpgradeRecommended;
+                break;
+            case core_bentley_1.DbResult.BE_SQLITE_ERROR_SchemaUpgradeRequired:
+                schemaState = core_common_1.SchemaState.UpgradeRequired;
+                break;
+            case core_bentley_1.DbResult.BE_SQLITE_ERROR_InvalidProfileVersion:
+                throw new core_common_1.IModelError(core_bentley_1.DbResult.BE_SQLITE_ERROR_InvalidProfileVersion, "The profile of the Db is invalid. Cannot upgrade or open the Db.");
+            default:
+                throw new core_common_1.IModelError(core_bentley_1.DbResult.BE_SQLITE_ERROR, "Error validating schemas. Cannot upgrade or open the Db.");
+        }
+        return schemaState;
+    }
+    /** Get the ClassMetaDataRegistry for this iModel.
+     * @internal
+     */
+    get classMetaDataRegistry() {
+        if (this._classMetaDataRegistry === undefined)
+            this._classMetaDataRegistry = new ClassRegistry_1.MetaDataRegistry();
+        return this._classMetaDataRegistry;
+    }
+    /** Get the linkTableRelationships for this IModel */
+    get relationships() {
+        return this._relationships || (this._relationships = new Relationship_1.Relationships(this));
+    }
+    /** Get the CodeSpecs in this IModel. */
+    get codeSpecs() {
+        return (this._codeSpecs !== undefined) ? this._codeSpecs : (this._codeSpecs = new CodeSpecs_1.CodeSpecs(this));
+    }
+    /** @internal */
+    insertCodeSpec(codeSpec) {
+        return this.nativeDb.insertCodeSpec(codeSpec.name, codeSpec.properties); // TODO: Remove "as any" when NativeLibrary.ts is updated so "spec" isn't marked as required
+    }
+    /** Prepare an ECSQL statement.
+     * @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.
+     */
+    prepareStatement(sql, logErrors = true) {
+        const stmt = new ECSqlStatement_1.ECSqlStatement();
+        stmt.prepare(this.nativeDb, sql, logErrors);
+        return stmt;
+    }
+    /** Prepare an ECSQL statement.
+     * @param sql The ECSQL statement to prepare
+     * @returns `undefined` if there is a problem preparing the statement.
+     */
+    tryPrepareStatement(sql) {
+        const statement = new ECSqlStatement_1.ECSqlStatement();
+        const result = statement.tryPrepare(this.nativeDb, sql);
+        return core_bentley_1.DbResult.BE_SQLITE_OK === result.status ? statement : undefined;
+    }
+    /** Construct an entity (Element or Model) from an iModel.
+     * @throws [[IModelError]] if the entity cannot be constructed.
+     */
+    constructEntity(props) {
+        const jsClass = this.getJsClass(props.classFullName);
+        return new jsClass(props, this);
+    }
+    /** Get the JavaScript class that handles a given entity class.  */
+    getJsClass(classFullName) {
+        try {
+            return ClassRegistry_1.ClassRegistry.getClass(classFullName, this);
+        }
+        catch (err) {
+            if (!ClassRegistry_1.ClassRegistry.isNotFoundError(err)) {
+                throw err;
+            }
+            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.
+     */
+    getMetaData(classFullName) {
+        let metadata = this.classMetaDataRegistry.find(classFullName);
+        if (metadata === undefined) {
+            this.loadMetaData(classFullName);
+            metadata = this.classMetaDataRegistry.find(classFullName);
+            if (metadata === undefined)
+                throw ClassRegistry_1.ClassRegistry.makeMetaDataNotFoundError(classFullName); // do not log
+        }
+        return metadata;
+    }
+    /** Invoke a callback on each property of the specified class, optionally including superclass properties.
+     * @param iModel  The IModel that contains the schema
+     * @param classFullName The full class name to load the metadata, if necessary
+     * @param wantSuper If true, superclass properties will also be processed
+     * @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.
+     */
+    static forEachMetaData(iModel, classFullName, wantSuper, func, includeCustom = true) {
+        const meta = iModel.getMetaData(classFullName); // will load if necessary
+        for (const propName in meta.properties) { // eslint-disable-line guard-for-in
+            const propMeta = meta.properties[propName];
+            if (includeCustom || !propMeta.isCustomHandled || propMeta.isCustomHandledOrphan)
+                func(propName, propMeta);
+        }
+        if (wantSuper && meta.baseClasses && meta.baseClasses.length > 0)
+            meta.baseClasses.forEach((baseClass) => this.forEachMetaData(iModel, baseClass, true, func, includeCustom));
+    }
+    /** @internal */
+    loadMetaData(classFullName) {
+        if (this.classMetaDataRegistry.find(classFullName))
+            return;
+        const className = classFullName.split(":");
+        if (className.length !== 2)
+            throw new core_common_1.IModelError(core_bentley_1.IModelStatus.BadArg, `Invalid classFullName: ${classFullName}`);
+        const val = this.nativeDb.getECClassMetaData(className[0], className[1]);
+        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);
+        const metaData = new core_common_1.EntityMetaData(JSON.parse(val.result));
+        this.classMetaDataRegistry.add(classFullName, metaData);
+        // Recursive, to make sure that base classes are cached.
+        if (metaData.baseClasses !== undefined && metaData.baseClasses.length > 0)
+            metaData.baseClasses.forEach((baseClassName) => this.loadMetaData(baseClassName));
+    }
+    /** Returns the full schema for the input name.
+     * @param name The name of the schema e.g. 'BisCore'
+     * @returns The SchemaProps for the requested schema
+     * @throws if the schema can not be found or loaded.
+     */
+    getSchemaProps(name) {
+        return this.nativeDb.getSchemaProps(name);
+    }
+    /** Query if this iModel contains the definition of the specified class.
+     * @param classFullName The full name of the class, for example, SomeSchema:SomeClass
+     * @returns true if the iModel contains the class definition or false if not.
+     * @see querySchemaVersion
+     * @see importSchema
+     */
+    containsClass(classFullName) {
+        const classNameParts = classFullName.replace(".", ":").split(":");
+        return classNameParts.length === 2 && this.nativeDb.getECClassMetaData(classNameParts[0], classNameParts[1]).error === undefined;
+    }
+    /** Query for a schema of the specified name in this iModel.
+     * @returns The schema version as a semver-compatible string or `undefined` if the schema has not been imported.
+     */
+    querySchemaVersion(schemaName) {
+        const sql = `SELECT VersionMajor,VersionWrite,VersionMinor FROM ECDbMeta.ECSchemaDef WHERE Name=:schemaName LIMIT 1`;
+        return this.withPreparedStatement(sql, (statement) => {
+            statement.bindString("schemaName", schemaName);
+            if (core_bentley_1.DbResult.BE_SQLITE_ROW === statement.step()) {
+                const versionMajor = statement.getValue(0).getInteger(); // ECSchemaDef.VersionMajor --> semver.major
+                const versionWrite = statement.getValue(1).getInteger(); // ECSchemaDef.VersionWrite --> semver.minor
+                const versionMinor = statement.getValue(2).getInteger(); // ECSchemaDef.VersionMinor --> semver.patch
+                return `${versionMajor}.${versionWrite}.${versionMinor}`;
+            }
+            return undefined;
+        });
+    }
+    /** Retrieve a named texture image from this iModel, as a TextureData.
+     * @param props the texture load properties which must include the name of the texture to load
+     * @returns the TextureData or undefined if the texture image is not present.
+     * @alpha
+     */
+    async queryTextureData(props) {
+        return this.nativeDb.queryTextureData(props);
+    }
+    /** Query a "file property" from this iModel, as a string.
+     * @returns the property string or undefined if the property is not present.
+     */
+    queryFilePropertyString(prop) {
+        return this.nativeDb.queryFileProperty(prop, true);
+    }
+    /** Query a "file property" from this iModel, as a blob.
+     * @returns the property blob or undefined if the property is not present.
+     */
+    queryFilePropertyBlob(prop) {
+        return this.nativeDb.queryFileProperty(prop, false);
+    }
+    /** Save a "file property" to this iModel
+     * @param prop the FilePropertyProps that describes the new property
+     * @param value either a string or a blob to save as the file property
+     */
+    saveFileProperty(prop, strValue, blobVal) {
+        this.nativeDb.saveFileProperty(prop, strValue, blobVal);
+    }
+    /** delete a "file property" from this iModel
+     * @param prop the FilePropertyProps that describes the property
+     */
+    deleteFileProperty(prop) {
+        this.nativeDb.saveFileProperty(prop, undefined, undefined);
+    }
+    /** Query for the next available major id for a "file property" from this iModel.
+     * @param prop the FilePropertyProps that describes the property
+     * @returns the next available (that is, an unused) id for prop. If none are present, will return 0.
+     */
+    queryNextAvailableFileProperty(prop) { return this.nativeDb.queryNextAvailableFileProperty(prop); }
+    /** @internal */
+    async requestSnap(sessionId, props) {
+        let request = this._snaps.get(sessionId);
+        if (undefined === request) {
+            request = new IModelHost_1.IModelHost.platform.SnapRequest();
+            this._snaps.set(sessionId, request);
+        }
+        else
+            request.cancelSnap();
+        try {
+            return await request.doSnap(this.nativeDb, core_bentley_1.JsonUtils.toObject(props));
+        }
+        finally {
+            this._snaps.delete(sessionId);
+        }
+    }
+    /** Cancel a previously requested snap.
+     * @internal
+     */
+    cancelSnap(sessionId) {
+        const request = this._snaps.get(sessionId);
+        if (undefined !== request) {
+            request.cancelSnap();
+            this._snaps.delete(sessionId);
+        }
+    }
+    /** Get the clip containment status for the supplied elements. */
+    async getGeometryContainment(props) {
+        return this.nativeDb.getGeometryContainment(core_bentley_1.JsonUtils.toObject(props));
+    }
+    /** Get the mass properties for the supplied elements. */
+    async getMassProperties(props) {
+        return this.nativeDb.getMassProperties(core_bentley_1.JsonUtils.toObject(props));
+    }
+    /** Get the IModel coordinate corresponding to each GeoCoordinate point in the input */
+    async getIModelCoordinatesFromGeoCoordinates(props) {
+        return this.nativeDb.getIModelCoordinatesFromGeoCoordinates(props);
+    }
+    /** Get the GeoCoordinate (longitude, latitude, elevation) corresponding to each IModel Coordinate point in the input */
+    async getGeoCoordinatesFromIModelCoordinates(props) {
+        return this.nativeDb.getGeoCoordinatesFromIModelCoordinates(props);
+    }
+    /** Export meshes suitable for graphics APIs from arbitrary geometry in elements in this IModelDb.
+     *  * Requests can be slow when processing many elements so it is expected that this function be used on a dedicated backend,
+     *    or that shared backends export a limited number of elements at a time.
+     *  * Vertices are exported in the IModelDb's world coordinate system, which is right-handed with Z pointing up.
+     *  * The results of changing [ExportGraphicsOptions]($core-backend) during the [ExportGraphicsOptions.onGraphics]($core-backend) callback are not defined.
+     *
+     * Example that prints the mesh for element 1 to stdout in [OBJ format](https://en.wikipedia.org/wiki/Wavefront_.obj_file)
+     * ```ts
+     * const onGraphics: ExportGraphicsFunction = (info: ExportGraphicsInfo) => {
+     *   const mesh: ExportGraphicsMesh = info.mesh;
+     *   for (let i = 0; i < mesh.points.length; i += 3) {
+     *     process.stdout.write(`v ${mesh.points[i]} ${mesh.points[i + 1]} ${mesh.points[i + 2]}\n`);
+     *     process.stdout.write(`vn ${mesh.normals[i]} ${mesh.normals[i + 1]} ${mesh.normals[i + 2]}\n`);
+     *   }
+     *
+     *   for (let i = 0; i < mesh.params.length; i += 2) {
+     *     process.stdout.write(`vt ${mesh.params[i]} ${mesh.params[i + 1]}\n`);
+     *   }
+     *
+     *   for (let i = 0; i < mesh.indices.length; i += 3) {
+     *     const p1 = mesh.indices[i];
+     *     const p2 = mesh.indices[i + 1];
+     *     const p3 = mesh.indices[i + 2];
+     *     process.stdout.write(`f ${p1}/${p1}/${p1} ${p2}/${p2}/${p2} ${p3}/${p3}/${p3}\n`);
+     *   }
+     * };
+     *
+     * iModel.exportGraphics(({ onGraphics, elementIdArray: ["0x1"] }));
+     * ```
+     * @returns 0 if successful, status otherwise
+     * @public
+     */
+    exportGraphics(exportProps) {
+        return this.nativeDb.exportGraphics(exportProps);
+    }
+    /**
+     * Exports meshes suitable for graphics APIs from a specified [GeometryPart]($core-backend)
+     * in this IModelDb.
+     * The expected use case is to call [IModelDb.exportGraphics]($core-backend) and supply the
+     * optional partInstanceArray argument, then call this function for each unique GeometryPart from
+     * that list.
+     *  * The results of changing [ExportPartGraphicsOptions]($core-backend) during the
+     *    [ExportPartGraphicsOptions.onPartGraphics]($core-backend) callback are not defined.
+     *  * See export-gltf under test-apps in the iTwin.js monorepo for a working reference.
+     * @returns 0 is successful, status otherwise
+     * @public
+     */
+    exportPartGraphics(exportProps) {
+        return this.nativeDb.exportPartGraphics(exportProps);
+    }
+    /** Request geometry stream information from an element in binary format instead of json.
+     * @returns IModelStatus.Success if successful
+     * @alpha
+     */
+    elementGeometryRequest(requestProps) {
+        return this.nativeDb.processGeometryStream(requestProps);
+    }
+    /** Create brep geometry for inclusion in an element's geometry stream.
+     * @returns IModelStatus.Success if successful
+     * @throws [[IModelError]] to report issues with input geometry or parameters
+     * @alpha
+     */
+    createBRepGeometry(createProps) {
+        return this.nativeDb.createBRepGeometry(createProps);
+    }
+    /** Generate graphics for an element or geometry stream.
+     * @see [readElementGraphics]($frontend) to convert the result to a [RenderGraphic]($frontend) for display.
+     */
+    async generateElementGraphics(request) {
+        return (0, ElementGraphics_1.generateElementGraphics)(request, this);
+    }
+    /** 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.
+     * @note All saved `SettingDictionary`s are loaded into [[workspace.settings]] every time an iModel is opened.
+     * @beta
+     */
+    saveSettingDictionary(name, dict) {
+        this.withSqliteStatement("REPLACE INTO be_Prop(id,SubId,TxnMode,Namespace,Name,strData) VALUES(0,0,0,?,?,?)", (stmt) => {
+            stmt.bindString(1, IModelDb._settingPropNamespace);
+            stmt.bindString(2, name);
+            stmt.bindString(3, JSON.stringify(dict));
+            const rc = stmt.step();
+            if (rc !== core_bentley_1.DbResult.BE_SQLITE_DONE)
+                throw new core_common_1.IModelError(rc, "cannot save setting");
+        });
+        this.saveChanges("add settings");
+    }
+    /** Delete a SettingDictionary, previously added with [[saveSettingDictionary]], from this iModel.
+     * @param name The name of the dictionary to delete.
+     * @beta
+     */
+    deleteSettingDictionary(name) {
+        this.withSqliteStatement("DELETE FROM be_Prop WHERE Namespace=? AND Name=?", (stmt) => {
+            stmt.bindString(1, IModelDb._settingPropNamespace);
+            stmt.bindString(2, name);
+            const rc = stmt.step();
+            if (rc !== core_bentley_1.DbResult.BE_SQLITE_DONE)
+                throw new core_common_1.IModelError(rc, "cannot delete setting");
+        });
+        this.saveChanges("delete settings");
+    }
+    /** Load all setting dictionaries in this iModel into `this.workspace.settings` */
+    loadSettingDictionaries() {
+        if (!this.nativeDb.isOpen())
+            return;
+        this.withSqliteStatement("SELECT Name,StrData FROM be_Prop WHERE Namespace=?", (stmt) => {
+            stmt.bindString(1, IModelDb._settingPropNamespace);
+            while (stmt.step() === core_bentley_1.DbResult.BE_SQLITE_ROW) {
+                try {
+                    const dict = JSON.parse(stmt.getValueString(1));
+                    this.workspace.settings.addDictionary(stmt.getValueString(0), Settings_1.SettingsPriority.iModel, dict);
+                }
+                catch (e) {
+                    core_bentley_1.UnexpectedErrors.handle(e);
+                }
+            }
+        });
+    }
+}
+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";
+/** @public */
+(function (IModelDb) {
+    /** The collection of models in an [[IModelDb]].
+     * @public
+     */
+    class Models {
+        /** @internal */
+        constructor(_iModel) {
+            this._iModel = _iModel;
+        }
+        /** Get the ModelProps with the specified identifier.
+         * @param modelId The Model identifier.
+         * @throws [[IModelError]] if the model is not found or cannot be loaded.
+         * @see tryGetModelProps
+         */
+        getModelProps(id) {
+            return this.getModelJson({ id });
+        }
+        /** Get the ModelProps with the specified identifier.
+         * @param modelId The Model identifier.
+         * @returns The ModelProps or `undefined` if the model is not found.
+         * @throws [[IModelError]] if the model cannot be loaded.
+         * @note Useful for cases when a model may or may not exist and throwing an `Error` would be overkill.
+         * @see getModelProps
+         */
+        tryGetModelProps(id) {
+            return this.tryGetModelJson({ id });
+        }
+        /** Query for the last modified time of the specified Model.
+         * @internal
+         */
+        queryLastModifiedTime(modelId) {
+            const sql = `SELECT LastMod FROM ${Model_1.Model.classFullName} WHERE ECInstanceId=:modelId`;
+            return this._iModel.withPreparedStatement(sql, (statement) => {
+                statement.bindId("modelId", modelId);
+                if (core_bentley_1.DbResult.BE_SQLITE_ROW === statement.step()) {
+                    return statement.getValue(0).getDateTime();
+                }
+                throw new core_common_1.IModelError(core_bentley_1.IModelStatus.InvalidId, `Can't get lastMod time for Model ${modelId}`);
+            });
+        }
+        /** Get the Model with the specified identifier.
+         * @param modelId The Model identifier.
+         * @param modelClass Optional class to validate instance against. This parameter can accept abstract or concrete classes, but should be the same as the template (`T`) parameter.
+         * @throws [[IModelError]] if the model is not found, cannot be loaded, or fails validation when `modelClass` is specified.
+         * @see tryGetModel
+         */
+        getModel(modelId, modelClass) {
+            const model = this.tryGetModel(modelId, modelClass);
+            if (undefined === model) {
+                throw new core_common_1.IModelError(core_bentley_1.IModelStatus.NotFound, `Model=${modelId}`);
+            }
+            return model;
+        }
+        /** Get the Model with the specified identifier.
+         * @param modelId The Model identifier.
+         * @param modelClass Optional class to validate instance against. This parameter can accept abstract or concrete classes, but should be the same as the template (`T`) parameter.
+         * @returns The Model or `undefined` if the model is not found or fails validation when `modelClass` is specified.
+         * @throws [[IModelError]] if the model cannot be loaded.
+         * @note Useful for cases when a model may or may not exist and throwing an `Error` would be overkill.
+         * @see getModel
+         */
+        tryGetModel(modelId, modelClass) {
+            const modelProps = this.tryGetModelProps(modelId);
+            if (undefined === modelProps)
+                return undefined; // no Model with that modelId found
+            const model = this._iModel.constructEntity(modelProps);
+            if (undefined === modelClass)
+                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=${modelIdArg}`);
+            }
+            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.nativeDb.getModel(modelIdArg);
+            }
+            catch (err) {
+                return undefined;
+            }
+        }
+        /** Get the sub-model of the specified Element.
+         * See [[IModelDb.Elements.queryElementIdByCode]] for more on how to find an element by Code.
+         * @param modeledElementId Identifies the modeled element.
+         * @param modelClass Optional class to validate instance against. This parameter can accept abstract or concrete classes, but should be the same as the template (`T`) parameter.
+         * @throws [[IModelError]] if the sub-model is not found, cannot be loaded, or fails validation when `modelClass` is specified.
+         * @see tryGetSubModel
+         */
+        getSubModel(modeledElementId, modelClass) {
+            const modeledElementProps = this._iModel.elements.getElementProps(modeledElementId);
+            if (undefined === modeledElementProps.id || modeledElementProps.id === core_common_1.IModel.rootSubjectId)
+                throw new core_common_1.IModelError(core_bentley_1.IModelStatus.NotFound, "Root subject does not have a sub-model");
+            return this.getModel(modeledElementProps.id, modelClass);
+        }
+        /** Get the sub-model of the specified Element.
+         * See [[IModelDb.Elements.queryElementIdByCode]] for more on how to find an element by Code.
+         * @param modeledElementId Identifies the modeled element.
+         * @param modelClass Optional class to validate instance against. This parameter can accept abstract or concrete classes, but should be the same as the template (`T`) parameter.
+         * @returns The sub-model or `undefined` if the specified element does not have a sub-model or fails validation when `modelClass` is specified.
+         * @see getSubModel
+         */
+        tryGetSubModel(modeledElementId, modelClass) {
+            const modeledElementProps = this._iModel.elements.tryGetElementProps(modeledElementId);
+            if (undefined === modeledElementProps?.id || (core_common_1.IModel.rootSubjectId === modeledElementProps.id))
+                return undefined;
+            return this.tryGetModel(modeledElementProps.id, modelClass);
+        }
+        /** Create a new model in memory.
+         * See the example in [[InformationPartitionElement]].
+         * @param modelProps The properties to use when creating the model.
+         * @throws [[IModelError]] if there is a problem creating the model.
+         */
+        createModel(modelProps) { return this._iModel.constructEntity(modelProps); }
+        /** Insert a new model.
+         * @param props The data for the new model.
+         * @returns The newly inserted model's Id.
+         * @throws [[IModelError]] if unable to insert the model.
+         */
+        insertModel(props) {
+            try {
+                return props.id = this._iModel.nativeDb.insertModel(props);
+            }
+            catch (err) {
+                throw new core_common_1.IModelError(err.errorNumber, `Error inserting model [${err.message}], class=${props.classFullName}`);
+            }
+        }
+        /** Update an existing model.
+         * @param props the properties of the model to change
+         * @throws [[IModelError]] if unable to update the model.
+         */
+        updateModel(props) {
+            try {
+                this._iModel.nativeDb.updateModel(props);
+            }
+            catch (err) {
+                throw new core_common_1.IModelError(err.errorNumber, `error updating model [${err.message}] id=${props.id}`);
+            }
+        }
+        /** Mark the geometry of [[GeometricModel]] as having changed, by recording an indirect change to its GeometryGuid property.
+         * Typically the GeometryGuid changes automatically when [[GeometricElement]]s within the model are modified, but
+         * explicitly updating it is occasionally useful after modifying definition elements like line styles or materials that indirectly affect the appearance of
+         * [[GeometricElement]]s that reference those definition elements in their geometry streams.
+         * Cached [Tile]($frontend)s are only invalidated after the geometry guid of the model changes.
+         * @note This will throw IModelError with [IModelStatus.VersionTooOld]($core-bentley) if a version of the BisCore schema older than 1.0.11 is present in the iModel.
+         * @throws IModelError if unable to update the geometry guid.
+         * @see [[TxnManager.onModelGeometryChanged]] for the event emitted in response to such a change.
+         */
+        updateGeometryGuid(modelId) {
+            const error = this._iModel.nativeDb.updateModelGeometryGuid(modelId);
+            if (error !== core_bentley_1.IModelStatus.Success)
+                throw new core_common_1.IModelError(error, `updating geometry guid for model ${modelId}`);
+        }
+        /** Delete one or more existing models.
+         * @param ids The Ids of the models to be deleted
+         * @throws [[IModelError]]
+         */
+        deleteModel(ids) {
+            core_bentley_1.Id64.toIdSet(ids).forEach((id) => {
+                try {
+                    this._iModel.nativeDb.deleteModel(id);
+                }
+                catch (err) {
+                    throw new core_common_1.IModelError(err.errorNumber, `error deleting model [${err.message}] id ${id}`);
+                }
+            });
+        }
+        /** For each specified [[GeometricModel]], attempts to obtain the union of the volumes of all geometric elements within that model.
+         * @param ids The Id or Ids of the [[GeometricModel]]s for which to obtain the extents.
+         * @returns An array of results, one per supplied Id, in the order in which the Ids were supplied. If the extents could not be obtained, the
+         * corresponding results entry's `extents` will be a "null" range (@see [Range3d.isNull]($geometry)) and its `status` will indicate
+         * why the extents could not be obtained (e.g., because the Id did not identify a [[GeometricModel]]).
+         * @see [[queryRange]] to obtain the union of all of the models' extents.
+         */
+        async queryExtents(ids) {
+            ids = typeof ids === "string" ? [ids] : ids;
+            if (ids.length === 0)
+                return [];
+            return this._iModel.nativeDb.queryModelExtentsAsync(ids);
+        }
+        /** Computes the union of the volumes of all geoemtric elements within any number of [[GeometricModel]]s, specified by model Id.
+         * @see [[queryExtents]] to obtain discrete volumes for each model.
+         */
+        async queryRange(ids) {
+            const results = await this.queryExtents(ids);
+            const range = new core_geometry_1.Range3d();
+            for (const result of results)
+                range.union(core_geometry_1.Range3d.fromJSON(result.extents), range);
+            return range;
+        }
+    }
+    IModelDb.Models = Models;
+    /** The collection of elements in an [[IModelDb]].
+     * @public
+     */
+    class Elements {
+        /** @internal */
+        constructor(_iModel) {
+            this._iModel = _iModel;
+        }
+        /** 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=${elementId}`);
+            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.nativeDb.getElement(loadProps);
+            }
+            catch (err) {
+                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) {
+            if (typeof props === "string") {
+                props = core_bentley_1.Id64.isId64(props) ? { id: props } : { federationGuid: props };
+            }
+            else if (props instanceof core_common_1.Code) {
+                props = { code: props };
+            }
+            try {
+                return this._iModel.nativeDb.getElement(props);
+            }
+            catch (err) {
+                throw new core_common_1.IModelError(err.errorNumber, err.message);
+            }
+        }
+        /** Get properties of an Element by Id, FederationGuid, or Code
+         * @returns The properties of the element or `undefined` if the element is not found.
+         * @throws [[IModelError]] if the element exists, but cannot be loaded.
+         * @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 };
+            }
+            else if (elementId instanceof core_common_1.Code) {
+                elementId = { code: elementId };
+            }
+            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
+         * @param elementClass Optional class to validate instance against. This parameter can accept abstract or concrete classes, but should be the same as the template (`T`) parameter.
+         * @throws [[IModelError]] if the element is not found, cannot be loaded, or fails validation when `elementClass` is specified.
+         * @see tryGetElement
+         */
+        getElement(elementId, elementClass) {
+            const element = this.tryGetElement(elementId, elementClass);
+            if (undefined === element)
+                throw new core_common_1.IModelError(core_bentley_1.IModelStatus.NotFound, `Element=${elementId}`);
+            return element;
+        }
+        /** Get an element by Id, FederationGuid, or Code
+         * @param elementId either the element's Id, Code, or FederationGuid, or an ElementLoadProps
+         * @param elementClass Optional class to validate instance against. This parameter can accept abstract or concrete classes, but should be the same as the template (`T`) parameter.
+         * @returns The element or `undefined` if the element is not found or fails validation when `elementClass` is specified.
+         * @throws [[IModelError]] if the element exists, but cannot be loaded.
+         * @note Useful for cases when an element may or may not exist and throwing an `Error` would be overkill.
+         * @see getElement
+         */
+        tryGetElement(elementId, elementClass) {
+            if (typeof elementId === "string")
+                elementId = core_bentley_1.Id64.isId64(elementId) ? { id: elementId } : { federationGuid: elementId };
+            else if (elementId instanceof core_common_1.Code)
+                elementId = { code: elementId };
+            else
+                elementId.onlyBaseProperties = false; // we must load all properties to construct the element.
+            const elementProps = this.tryGetElementJson(elementId);
+            if (undefined === elementProps)
+                return undefined; // no Element with that elementId found
+            const element = this._iModel.constructEntity(elementProps);
+            if (undefined === elementClass)
+                return element; // elementClass was not specified, cannot call instanceof to validate
+            return element instanceof elementClass ? element : undefined;
+        }
+        /** Query for the Id of the element that has a specified code.
+         * This method is for the case where you know the element's Code.
+         * If you only know the code *value*, then in the simplest case, you can query on that
+         * and filter the results.
+         * In the simple case, call [[IModelDb.queryEntityIds]], specifying the code value in the where clause of the query params.
+         * Or, you can execute an ECSQL select statement. See
+         * [frequently used ECSQL queries]($docs/learning/backend/ECSQL-queries.md) for an example.
+         * @param code The code to look for
+         * @returns The element that uses the code or undefined if the code is not used.
+         * @throws IModelError if the code is invalid
+         */
+        queryElementIdByCode(code) {
+            if (core_bentley_1.Id64.isInvalid(code.spec))
+                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");
+            return this._iModel.withPreparedStatement("SELECT ECInstanceId FROM BisCore:Element WHERE CodeSpec.Id=? AND CodeScope.Id=? AND CodeValue=?", (stmt) => {
+                stmt.bindId(1, code.spec);
+                stmt.bindId(2, core_bentley_1.Id64.fromString(code.scope));
+                stmt.bindString(3, code.value);
+                if (core_bentley_1.DbResult.BE_SQLITE_ROW !== stmt.step())
+                    return undefined;
+                return stmt.getValue(0).getId();
+            });
+        }
+        /** Query for the last modified time of the specified element.
+         * @internal
+         */
+        queryLastModifiedTime(elementId) {
+            const sql = "SELECT LastMod FROM BisCore:Element WHERE ECInstanceId=:elementId";
+            return this._iModel.withPreparedStatement(sql, (statement) => {
+                statement.bindId("elementId", elementId);
+                if (core_bentley_1.DbResult.BE_SQLITE_ROW === statement.step())
+                    return statement.getValue(0).getDateTime();
+                throw new core_common_1.IModelError(core_bentley_1.IModelStatus.InvalidId, `Can't get lastMod time for Element ${elementId}`);
+            });
+        }
+        /** Create a new instance of an element.
+         * @param elProps The properties of the new element.
+         * @throws [[IModelError]] if there is a problem creating the element.
+         */
+        createElement(elProps) { return this._iModel.constructEntity(elProps); }
+        /** Insert a new element into the iModel.
+         * @param elProps The properties of the new element.
+         * @returns The newly inserted element's Id.
+         * @throws [[IModelError]] if unable to insert the element.
+         * @note For convenience, the value of `elProps.id` is updated to reflect the resultant element's id.
+         * However when `elProps.federationGuid` is not present or undefined, a new Guid will be generated and stored on the resultant element. But
+         * the value of `elProps.federationGuid` is *not* updated. Generally, it is best to re-read the element after inserting (e.g. via [[getElementProps]])
+         * if you intend to continue working with it. That will ensure its values reflect the persistent state.
+         */
+        insertElement(elProps) {
+            try {
+                return elProps.id = this._iModel.nativeDb.insertElement(elProps);
+            }
+            catch (err) {
+                err.message = `error inserting element: ${err.message}`;
+                throw err;
+            }
+        }
+        /** Update some properties of an existing element.
+         * To support clearing a property value, every property name that is present in the `elProps` object will be updated even if the value is `undefined`.
+         * To keep an individual element property unchanged, it should either be excluded from the `elProps` parameter or set to its current value.
+         * @param elProps the properties of the element to update.
+         * @note As described above, this is a special case where there is a difference between a property being excluded and a property being present in `elProps` but set to `undefined`.
+         * @throws [[IModelError]] if unable to update the element.
+         */
+        updateElement(elProps) {
+            try {
+                this._iModel.nativeDb.updateElement(elProps);
+            }
+            catch (err) {
+                err.message = `error updating element: ${err.message}`;
+                throw err;
+            }
+        }
+        /** Delete one or more elements from this iModel.
+         * @param ids The set of Ids of the element(s) to be deleted
+         * @throws [[IModelError]]
+         * @see deleteDefinitionElements
+         */
+        deleteElement(ids) {
+            const iModel = this._iModel;
+            core_bentley_1.Id64.toIdSet(ids).forEach((id) => {
+                try {
+                    iModel.nativeDb.deleteElement(id);
+                }
+                catch (err) {
+                    err.message = `error deleting element: ${err.message}`;
+                    throw err;
+                }
+            });
+        }
+        /** DefinitionElements can only be deleted if it can be determined that they are not referenced by other Elements.
+         * This *usage query* can be expensive since it may involve scanning the GeometryStreams of all GeometricElements.
+         * Since [[deleteElement]] does not perform these additional checks, it fails in order to prevent potentially referenced DefinitionElements from being deleted.
+         * This method performs those expensive checks and then calls *delete* if not referenced.
+         * @param ids The Ids of the DefinitionElements to attempt to delete. To prevent multiple passes over the same GeometricElements, it is best to pass in the entire array of
+         * DefinitionElements rather than calling this method separately for each one. Ids that are not valid DefinitionElements will be ignored.
+         * @returns An IdSet of the DefinitionElements that are used and were therefore not deleted.
+         * @see deleteElement
+         * @beta
+         */
+        deleteDefinitionElements(definitionElementIds) {
+            const usageInfo = this._iModel.nativeDb.queryDefinitionElementUsage(definitionElementIds);
+            if (!usageInfo) {
+                throw new core_common_1.IModelError(core_bentley_1.IModelStatus.BadRequest, "Error querying for DefinitionElement usage");
+            }
+            const usedIdSet = usageInfo.usedIds ? core_bentley_1.Id64.toIdSet(usageInfo.usedIds) : new Set();
+            const deleteIfUnused = (ids, used) => {
+                if (ids) {
+                    ids.forEach((id) => {
+                        if (!used.has(id))
+                            this._iModel.elements.deleteElement(id);
+                    });
+                }
+            };
+            try {
+                this._iModel.nativeDb.beginPurgeOperation();
+                deleteIfUnused(usageInfo.spatialCategoryIds, usedIdSet);
+                deleteIfUnused(usageInfo.drawingCategoryIds, usedIdSet);
+                deleteIfUnused(usageInfo.viewDefinitionIds, usedIdSet);
+                deleteIfUnused(usageInfo.geometryPartIds, usedIdSet);
+                deleteIfUnused(usageInfo.lineStyleIds, usedIdSet);
+                deleteIfUnused(usageInfo.renderMaterialIds, usedIdSet);
+                deleteIfUnused(usageInfo.subCategoryIds, usedIdSet);
+                deleteIfUnused(usageInfo.textureIds, usedIdSet);
+                deleteIfUnused(usageInfo.displayStyleIds, usedIdSet);
+                deleteIfUnused(usageInfo.categorySelectorIds, usedIdSet);
+                deleteIfUnused(usageInfo.modelSelectorIds, usedIdSet);
+                if (usageInfo.otherDefinitionElementIds) {
+                    this._iModel.elements.deleteElement(usageInfo.otherDefinitionElementIds);
+                }
+            }
+            finally {
+                this._iModel.nativeDb.endPurgeOperation();
+            }
+            if (usageInfo.viewDefinitionIds) {
+                // take another pass in case a deleted ViewDefinition was the only usage of these view-related DefinitionElements
+                let viewRelatedIds = [];
+                if (usageInfo.displayStyleIds)
+                    viewRelatedIds = viewRelatedIds.concat(usageInfo.displayStyleIds.filter((id) => usedIdSet.has(id)));
+                if (usageInfo.categorySelectorIds)
+                    viewRelatedIds = viewRelatedIds.concat(usageInfo.categorySelectorIds.filter((id) => usedIdSet.has(id)));
+                if (usageInfo.modelSelectorIds)
+                    viewRelatedIds = viewRelatedIds.concat(usageInfo.modelSelectorIds.filter((id) => usedIdSet.has(id)));
+                if (viewRelatedIds.length > 0) {
+                    const viewRelatedUsageInfo = this._iModel.nativeDb.queryDefinitionElementUsage(viewRelatedIds);
+                    if (viewRelatedUsageInfo) {
+                        const usedViewRelatedIdSet = viewRelatedUsageInfo.usedIds ? core_bentley_1.Id64.toIdSet(viewRelatedUsageInfo.usedIds) : new Set();
+                        try {
+                            this._iModel.nativeDb.beginPurgeOperation();
+                            deleteIfUnused(viewRelatedUsageInfo.displayStyleIds, usedViewRelatedIdSet);
+                            deleteIfUnused(viewRelatedUsageInfo.categorySelectorIds, usedViewRelatedIdSet);
+                            deleteIfUnused(viewRelatedUsageInfo.modelSelectorIds, usedViewRelatedIdSet);
+                        }
+                        finally {
+                            this._iModel.nativeDb.endPurgeOperation();
+                        }
+                        viewRelatedIds.forEach((id) => {
+                            if (!usedViewRelatedIdSet.has(id))
+                                usedIdSet.delete(id);
+                        });
+                    }
+                }
+            }
+            return usedIdSet;
+        }
+        /** Query for the child elements of the specified element.
+         * @returns Returns an array of child element identifiers.
+         * @throws [[IModelError]]
+         */
+        queryChildren(elementId) {
+            const sql = "SELECT ECInstanceId FROM BisCore:Element WHERE Parent.Id=:elementId";
+            return this._iModel.withPreparedStatement(sql, (statement) => {
+                statement.bindId("elementId", elementId);
+                const childIds = [];
+                while (core_bentley_1.DbResult.BE_SQLITE_ROW === statement.step()) {
+                    childIds.push(statement.getValue(0).getId());
+                }
+                return childIds;
+            });
+        }
+        /** Query for the parent of the specified element.
+         * @param elementId The element to check for a parent
+         * @returns The identifier of the element's parent or undefined if the element has no parent
+         * @throws [[IModelError]] if the element does not exist
+         */
+        queryParent(elementId) {
+            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)
+                    throw new core_common_1.IModelError(core_bentley_1.IModelStatus.NotFound, `Element=${elementId}`);
+                const value = stmt.getValue(0);
+                return value.isNull ? undefined : value.getId();
+            });
+        }
+        /** Returns true if the specified Element has a sub-model.
+         * @see [[IModelDb.Models.getSubModel]]
+         */
+        hasSubModel(elementId) {
+            if (core_common_1.IModel.rootSubjectId === elementId)
+                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";
+            return this._iModel.withPreparedStatement(sql, (statement) => {
+                statement.bindId("elementId", elementId);
+                return core_bentley_1.DbResult.BE_SQLITE_ROW === statement.step();
+            });
+        }
+        /** Get the root subject element. */
+        getRootSubject() { return this.getElement(core_common_1.IModel.rootSubjectId); }
+        /** Query for aspects of a particular class (polymorphically) associated with this element.
+         * @throws [[IModelError]]
+         * @note Most cases should use the [[getAspects]] wrapper rather than calling this method directly.
+         * @internal
+         */
+        _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
+            return this._iModel.withPreparedStatement(sql, (statement) => {
+                statement.bindId("elementId", elementId);
+                const aspects = [];
+                while (core_bentley_1.DbResult.BE_SQLITE_ROW === statement.step()) {
+                    const aspectInstanceId = statement.getValue(0).getId();
+                    const aspectClassFullName = statement.getValue(1).getClassNameForClassId().replace(".", ":");
+                    if ((undefined === excludedClassFullNames) || (!excludedClassFullNames.has(aspectClassFullName))) {
+                        aspects.push(this._queryAspect(aspectInstanceId, aspectClassFullName));
+                    }
+                }
+                return aspects;
+            });
+        }
+        /** Query for aspect by ECInstanceId
+         * @throws [[IModelError]]
+         */
+        _queryAspect(aspectInstanceId, aspectClassName) {
+            const sql = `SELECT * FROM ${aspectClassName} WHERE ECInstanceId=:aspectInstanceId`;
+            const aspect = this._iModel.withPreparedStatement(sql, (statement) => {
+                statement.bindId("aspectInstanceId", aspectInstanceId);
+                if (core_bentley_1.DbResult.BE_SQLITE_ROW === statement.step()) {
+                    const aspectProps = statement.getRow(); // start with everything that SELECT * returned
+                    aspectProps.classFullName = aspectProps.className.replace(".", ":"); // add in property required by EntityProps
+                    aspectProps.className = undefined; // clear property from SELECT * that we don't want in the final instance
+                    return aspectProps;
+                }
+                return undefined;
+            });
+            if (undefined === aspect) {
+                throw new core_common_1.IModelError(core_bentley_1.IModelStatus.NotFound, `ElementAspect not found ${aspectInstanceId}, ${aspectClassName}`);
+            }
+            return this._iModel.constructEntity(aspect);
+        }
+        /** Get a single ElementAspect by its instance Id.
+         * @throws [[IModelError]]
+         */
+        getAspect(aspectInstanceId) {
+            const sql = "SELECT ECClassId FROM BisCore:ElementAspect WHERE ECInstanceId=:aspectInstanceId";
+            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;
+            });
+            if (undefined === aspectClassFullName) {
+                throw new core_common_1.IModelError(core_bentley_1.IModelStatus.NotFound, `ElementAspect not found ${aspectInstanceId}`);
+            }
+            return this._queryAspect(aspectInstanceId, aspectClassFullName);
+        }
+        /** Get the ElementAspect instances that are owned by the specified element.
+         * @param elementId Get ElementAspects associated with this Element
+         * @param aspectClassFullName Optionally filter ElementAspects polymorphically by this class name
+         * @throws [[IModelError]]
+         */
+        getAspects(elementId, aspectClassFullName) {
+            if (undefined === aspectClassFullName) {
+                const uniqueAspects = this._queryAspects(elementId, ElementAspect_1.ElementUniqueAspect.classFullName);
+                const multiAspects = this._queryAspects(elementId, ElementAspect_1.ElementMultiAspect.classFullName);
+                return uniqueAspects.concat(multiAspects);
+            }
+            const aspects = this._queryAspects(elementId, aspectClassFullName);
+            return aspects;
+        }
+        /** Insert a new ElementAspect into the iModel.
+         * @param aspectProps The properties of the new ElementAspect.
+         * @throws [[IModelError]] if unable to insert the ElementAspect.
+         * @returns the id of the newly inserted aspect.
+         * @note Aspect Ids may collide with element Ids, so don't put both in a container like Set or Map
+         *       use [EntityReference]($common) for that instead.
+         */
+        insertAspect(aspectProps) {
+            try {
+                return this._iModel.nativeDb.insertElementAspect(aspectProps);
+            }
+            catch (err) {
+                throw new core_common_1.IModelError(err.errorNumber, `Error inserting ElementAspect [${err.message}], class: ${aspectProps.classFullName}`);
+            }
+        }
+        /** Update an exist ElementAspect within the iModel.
+         * @param aspectProps The properties to use to update the ElementAspect.
+         * @throws [[IModelError]] if unable to update the ElementAspect.
+         */
+        updateAspect(aspectProps) {
+            try {
+                this._iModel.nativeDb.updateElementAspect(aspectProps);
+            }
+            catch (err) {
+                throw new core_common_1.IModelError(err.errorNumber, `Error updating ElementAspect [${err.message}], id: ${aspectProps.id}`);
+            }
+        }
+        /** Delete one or more ElementAspects from this iModel.
+         * @param aspectInstanceIds The set of instance Ids of the ElementAspect(s) to be deleted
+         * @throws [[IModelError]] if unable to delete the ElementAspect.
+         */
+        deleteAspect(aspectInstanceIds) {
+            const iModel = this._iModel;
+            core_bentley_1.Id64.toIdSet(aspectInstanceIds).forEach((aspectInstanceId) => {
+                try {
+                    iModel.nativeDb.deleteElementAspect(aspectInstanceId);
+                }
+                catch (err) {
+                    throw new core_common_1.IModelError(err.errorNumber, `Error deleting ElementAspect [${err.message}], id: ${aspectInstanceId}`);
+                }
+            });
+        }
+    }
+    IModelDb.Elements = Elements;
+    /** The collection of views in an [[IModelDb]].
+     * @public
+     */
+    class Views {
+        /** @internal */
+        constructor(_iModel) {
+            this._iModel = _iModel;
+        }
+        /** Query for the array of ViewDefinitionProps of the specified class and matching the specified IsPrivate setting.
+         * @param className Query for view definitions of this class.
+         * @param wantPrivate If true, include private view definitions.
+         */
+        queryViewDefinitionProps(className = "BisCore.ViewDefinition", limit = IModelDb.defaultLimit, offset = 0, wantPrivate = false) {
+            const where = (wantPrivate === false) ? "IsPrivate=FALSE" : "";
+            const ids = this._iModel.queryEntityIds({ from: className, limit, offset, where });
+            const props = [];
+            const imodel = this._iModel;
+            ids.forEach((id) => {
+                try {
+                    props.push(imodel.elements.getElementProps(id));
+                }
+                catch (err) { }
+            });
+            return props;
+        }
+        /** 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.
+         * @returns true if all views were iterated, false if iteration was terminated early due to callback returning false.
+         *
+         * **Example: Finding all views of a specific DrawingModel**
+         * ``` ts
+         * [[include:IModelDb.Views.iterateViews]]
+         * ```
+         */
+        iterateViews(params, callback) {
+            const ids = this._iModel.queryEntityIds(params);
+            let finished = true;
+            for (const id of ids) {
+                try {
+                    const view = this._iModel.elements.getElement(id);
+                    if (undefined !== view && view instanceof ViewDefinition_1.ViewDefinition) {
+                        finished = callback(view);
+                        if (!finished)
+                            break;
+                    }
+                }
+                catch (err) { }
+            }
+            return finished;
+        }
+        loadViewStateProps(viewDefinitionElement, options, drawingExtents) {
+            const elements = this._iModel.elements;
+            const viewDefinitionProps = viewDefinitionElement.toJSON();
+            const categorySelectorProps = elements.getElementProps(viewDefinitionProps.categorySelectorId);
+            const displayStyleProps = elements.getElementProps({
+                id: viewDefinitionProps.displayStyleId,
+                displayStyle: options?.displayStyle,
+            });
+            const viewStateData = {
+                viewDefinitionProps,
+                displayStyleProps,
+                categorySelectorProps,
+            };
+            const modelSelectorId = viewDefinitionProps.modelSelectorId;
+            if (modelSelectorId !== undefined) {
+                viewStateData.modelSelectorProps = elements.getElementProps(modelSelectorId);
+            }
+            else if (viewDefinitionElement instanceof ViewDefinition_1.SheetViewDefinition) {
+                viewStateData.sheetProps = elements.getElementProps(viewDefinitionElement.baseModelId);
+                viewStateData.sheetAttachments = Array.from(this._iModel.queryEntityIds({
+                    from: "BisCore.ViewAttachment",
+                    where: `Model.Id=${viewDefinitionElement.baseModelId}`,
+                }));
+            }
+            else if (viewDefinitionElement instanceof ViewDefinition_1.DrawingViewDefinition) {
+                // Ensure view has known extents
+                if (drawingExtents && !drawingExtents.isNull)
+                    viewStateData.modelExtents = drawingExtents.toJSON();
+                // Include information about the associated [[SectionDrawing]], if any.
+                // NB: The SectionDrawing ECClass may not exist in the iModel's version of the BisCore ECSchema.
+                try {
+                    const sectionDrawing = this._iModel.elements.tryGetElement(viewDefinitionElement.baseModelId);
+                    if (sectionDrawing && sectionDrawing.spatialView && core_bentley_1.Id64.isValidId64(sectionDrawing.spatialView.id)) {
+                        viewStateData.sectionDrawing = {
+                            spatialView: sectionDrawing.spatialView.id,
+                            displaySpatialView: true === sectionDrawing.jsonProperties.displaySpatialView,
+                            drawingToSpatialTransform: sectionDrawing.jsonProperties.drawingToSpatialTransform,
+                        };
+                    }
+                }
+                catch {
+                    //
+                }
+            }
+            return viewStateData;
+        }
+        /** @deprecated in 3.x. use [[getViewStateProps]]. */
+        getViewStateData(viewDefinitionId, options) {
+            const view = this._iModel.elements.getElement(viewDefinitionId);
+            let drawingExtents;
+            if (view instanceof ViewDefinition_1.DrawingViewDefinition) {
+                try {
+                    drawingExtents = core_geometry_1.Range3d.fromJSON(this._iModel.nativeDb.queryModelExtents({ id: view.baseModelId }).modelExtents);
+                }
+                catch {
+                    //
+                }
+            }
+            return this.loadViewStateProps(view, options, drawingExtents);
+        }
+        /** Obtain a [ViewStateProps]($common) for a [[ViewDefinition]] specified by element Id. */
+        async getViewStateProps(viewDefinitionId, options) {
+            const view = this._iModel.elements.getElement(viewDefinitionId);
+            let drawingExtents;
+            if (view instanceof ViewDefinition_1.DrawingViewDefinition)
+                drawingExtents = (await this._iModel.models.queryRange(view.baseModelId));
+            return this.loadViewStateProps(view, options, drawingExtents);
+        }
+        getViewThumbnailArg(viewDefinitionId) {
+            return { namespace: "dgn_View", name: "Thumbnail", id: viewDefinitionId };
+        }
+        /** Get the thumbnail for a view.
+         * @param viewDefinitionId The Id of the view for thumbnail
+         * @returns the ThumbnailProps, or undefined if no thumbnail exists.
+         */
+        getThumbnail(viewDefinitionId) {
+            const viewArg = this.getViewThumbnailArg(viewDefinitionId);
+            const sizeProps = this._iModel.nativeDb.queryFileProperty(viewArg, true);
+            if (undefined === sizeProps)
+                return undefined;
+            const out = JSON.parse(sizeProps);
+            out.image = this._iModel.nativeDb.queryFileProperty(viewArg, false);
+            return out;
+        }
+        /** Save a thumbnail for a view.
+         * @param viewDefinitionId The Id of the view for thumbnail
+         * @param thumbnail The thumbnail data.
+         * @returns 0 if successful
+         */
+        saveThumbnail(viewDefinitionId, thumbnail) {
+            const viewArg = this.getViewThumbnailArg(viewDefinitionId);
+            const props = { format: thumbnail.format, height: thumbnail.height, width: thumbnail.width };
+            this._iModel.nativeDb.saveFileProperty(viewArg, JSON.stringify(props), thumbnail.image);
+            return 0;
+        }
+        /** Set the default view property the iModel
+         * @param viewId The Id of the ViewDefinition to use as the default
+         */
+        setDefaultViewId(viewId) {
+            const spec = { namespace: "dgn_View", name: "DefaultView" };
+            const blob32 = new Uint32Array(2);
+            blob32[0] = core_bentley_1.Id64.getLowerUint32(viewId);
+            blob32[1] = core_bentley_1.Id64.getUpperUint32(viewId);
+            const blob8 = new Uint8Array(blob32.buffer);
+            this._iModel.saveFileProperty(spec, undefined, blob8);
+        }
+    }
+    /** 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
+     */
+    let TileContentState;
+    (function (TileContentState) {
+        TileContentState[TileContentState["New"] = 0] = "New";
+        TileContentState[TileContentState["Pending"] = 1] = "Pending";
+        TileContentState[TileContentState["Loading"] = 2] = "Loading";
+    })(TileContentState = IModelDb.TileContentState || (IModelDb.TileContentState = {}));
+    /** @internal */
+    class Tiles {
+        /** @internal */
+        constructor(_iModel) {
+            this._iModel = _iModel;
+        }
+        /** @internal */
+        async requestTileTreeProps(id) {
+            return new Promise((resolve, reject) => {
+                this._iModel.nativeDb.getTileTree(id, (ret) => {
+                    if (undefined !== ret.error)
+                        reject(new core_common_1.IModelError(ret.error.status, `TreeId=${id}`));
+                    else
+                        resolve(ret.result);
+                });
+            });
+        }
+        pollTileContent(resolve, reject, treeId, tileId) {
+            let ret;
+            try {
+                ret = this._iModel.nativeDb.pollTileContent(treeId, tileId);
+            }
+            catch (err) {
+                // Typically "imodel not open".
+                reject(err);
+                return;
+            }
+            if (ret.error) {
+                reject(new core_common_1.IModelError(ret.error.status, `TreeId=${treeId} TileId=${tileId}`));
+            }
+            else if (ret.result && typeof ret.result !== "number") { // if type is not a number, it's the TileContent interface
+                const res = ret.result;
+                const iModelId = this._iModel.iModelId;
+                const tileSizeThreshold = IModelHost_1.IModelHost.logTileSizeThreshold;
+                const tileSize = res.content.length;
+                if (tileSize > tileSizeThreshold) {
+                    core_bentley_1.Logger.logWarning(loggerCategory, "Tile size (in bytes) larger than specified threshold", () => ({ tileSize, tileSizeThreshold, treeId, tileId, iModelId }));
+                }
+                const loadTimeThreshold = IModelHost_1.IModelHost.logTileLoadTimeThreshold;
+                const loadTime = res.elapsedSeconds;
+                if (loadTime > loadTimeThreshold) {
+                    core_bentley_1.Logger.logWarning(loggerCategory, "Tile load time (in seconds) greater than specified threshold", () => ({ loadTime, loadTimeThreshold, treeId, tileId, iModelId }));
+                }
+                resolve(res);
+            }
+            else { // if the type is a number, it's the TileContentState enum
+                // ###TODO: Decide appropriate timeout interval. May want to switch on state (new vs loading vs pending)
+                setTimeout(() => this.pollTileContent(resolve, reject, treeId, tileId), 10);
+            }
+        }
+        /** @internal */
+        async requestTileContent(treeId, tileId) {
+            return new Promise((resolve, reject) => {
+                this.pollTileContent(resolve, reject, treeId, tileId);
+            });
+        }
+        /** @internal */
+        async getTileContent(treeId, tileId) {
+            const ret = await new Promise((resolve) => {
+                this._iModel.nativeDb.getTileContent(treeId, tileId, resolve);
+            });
+            if (undefined !== ret.error) {
+                throw new core_common_1.IModelError(ret.error.status, `TreeId=${treeId} TileId=${tileId}`);
+            }
+            (0, core_bentley_1.assert)(undefined !== ret.result);
+            return ret.result;
+        }
+    }
+    IModelDb.Tiles = Tiles;
+})(IModelDb = exports.IModelDb || (exports.IModelDb = {}));
+/**
+ * A local copy of an iModel from iModelHub that can pull and potentially push changesets.
+ * BriefcaseDb raises a set of events to allow apps and subsystems to track its object life cycle, including [[onOpen]] and [[onOpened]].
+ * @public
+ */
+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);
+        this._openMode = args.openMode;
+        this.briefcaseId = args.briefcaseId;
+        if (this.useLockServer) // if the iModel uses a lock server, create a ServerBasedLocks LockControl for this BriefcaseDb.
+            this._locks = new ServerBasedLocks_1.ServerBasedLocks(this);
+    }
+    /** override superclass method */
+    get isBriefcase() { return true; }
+    static findByKey(key) {
+        return super.findByKey(key);
+    }
+    static tryFindByKey(key) {
+        const db = super.tryFindByKey(key);
+        return db?.isBriefcaseDb() ? db : undefined;
+    }
+    /**
+     * The Guid that identifies the *context* that owns this iModel.
+     * GuidString | undefined for the superclass, but required for BriefcaseDb
+     * */
+    get iTwinId() { return super.iTwinId; } // eslint-disable-line @typescript-eslint/no-non-null-assertion
+    /**
+     * Determine whether this BriefcaseDb should use a lock server.
+     * All must be true:
+     * - file is open for write
+     * - has an assigned briefcaseId
+     * - the "no locking" flag is not present. This is a property of an iModel, established when the iModel is created in IModelHub.
+     */
+    get useLockServer() {
+        return !this.isReadonly && (this.briefcaseId !== core_common_1.BriefcaseIdValue.Unassigned) && (undefined === this.nativeDb.queryLocalValue(BriefcaseLocalValue.NoLocking));
+    }
+    /** Upgrades the profile or domain schemas. File must be closed before this call and is always left closed. */
+    static async doUpgrade(briefcase, upgradeOptions, description) {
+        const nativeDb = this.openDgnDb({ path: briefcase.fileName }, core_bentley_1.OpenMode.ReadWrite, upgradeOptions); // performs the upgrade
+        const wasChanges = nativeDb.hasPendingTxns();
+        nativeDb.closeIModel();
+        if (wasChanges)
+            await withBriefcaseDb(briefcase, async (db) => db.pushChanges({ ...briefcase, description, retainLocks: true }));
+    }
+    /** Upgrades the schemas in the iModel based on the current version of the software. Follows a sequence of operations -
+     * * Acquires a schema lock to prevent other users from making any other changes while upgrade is happening
+     * * Updates the local briefcase with the schema changes.
+     * * Pushes the resulting changeset(s) to iModelHub.
+     * Note that the upgrade requires that the local briefcase be closed, and may result in one or two change sets depending on whether both
+     * profile and domain schemas need to get upgraded.
+     * @see ($docs/learning/backend/IModelDb.md#upgrading-schemas-in-an-imodel)
+    */
+    static async upgradeSchemas(briefcase) {
+        // upgrading schemas involves closing and reopening the file repeatedly. That's because the process of upgrading
+        // happens on a file open. We have to open-and-close the file at *each* of these steps:
+        // - acquire schema lock
+        // - upgrade profile
+        // - push changes
+        // - upgrade domain
+        // - push changes
+        // - release schema lock
+        // good thing computers are fast. Fortunately upgrading should be rare (and the push time will dominate anyway.) Don't try to optimize any of this away.
+        await withBriefcaseDb(briefcase, async (db) => db.acquireSchemaLock()); // may not really acquire lock if iModel uses "noLocks" mode.
+        try {
+            await this.doUpgrade(briefcase, { profile: core_common_1.ProfileOptions.Upgrade, schemaLockHeld: true }, "Upgraded profile");
+            await this.doUpgrade(briefcase, { domain: core_common_1.DomainOptions.Upgrade, schemaLockHeld: true }, "Upgraded domain schemas");
+        }
+        finally {
+            await withBriefcaseDb(briefcase, async (db) => db.locks.releaseAllLocks());
+        }
+    }
+    /** Open a briefcase file and return a new BriefcaseDb to interact with it.
+     * @param args parameters that specify the file name, and options for opening the briefcase file
+     */
+    static async open(args) {
+        this.onOpen.raiseEvent(args);
+        const file = { path: args.fileName, key: args.key };
+        const openMode = args.readonly ? 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() });
+        if (openMode === core_bentley_1.OpenMode.ReadWrite && CodeService_1.CodeService.createForIModel) {
+            try {
+                const codeService = CodeService_1.CodeService.createForIModel(briefcaseDb);
+                briefcaseDb._codeService = codeService;
+                this.onCodeServiceCreated.raiseEvent(codeService);
+            }
+            catch (e) {
+                if (e.errorId !== "NoCodeIndex") // no code index means iModel isn't enforcing codes.
+                    throw e;
+            }
+        }
+        BriefcaseManager_1.BriefcaseManager.logUsage(briefcaseDb);
+        this.onOpened.raiseEvent(briefcaseDb, args);
+        return briefcaseDb;
+    }
+    closeAndReopen(openMode) {
+        const fileName = this.pathName;
+        this.nativeDb.closeIModel();
+        this.nativeDb.openIModel(fileName, openMode);
+    }
+    /** Pull and apply changesets from iModelHub */
+    async pullChanges(arg) {
+        if (this.isReadonly) // we allow pulling changes into a briefcase that is readonly - close and reopen it writeable
+            this.closeAndReopen(core_bentley_1.OpenMode.ReadWrite);
+        try {
+            await BriefcaseManager_1.BriefcaseManager.pullAndApplyChangesets(this, arg ?? {});
+            this.initializeIModelDb();
+        }
+        finally {
+            if (this.isReadonly) // if the briefcase was opened readonly - close and reopen it readonly
+                this.closeAndReopen(core_bentley_1.OpenMode.Readonly);
+        }
+        IpcHost_1.IpcHost.notifyTxns(this, "notifyPulledChanges", this.changeset);
+    }
+    /** Push changes to iModelHub. */
+    async pushChanges(arg) {
+        if (this.briefcaseId === core_common_1.BriefcaseIdValue.Unassigned)
+            return;
+        if (this.nativeDb.hasUnsavedChanges())
+            throw new core_common_1.IModelError(core_bentley_1.ChangeSetStatus.HasUncommittedChanges, "Cannot push with unsaved changes");
+        if (!this.nativeDb.hasPendingTxns())
+            return; // nothing to push
+        await BriefcaseManager_1.BriefcaseManager.pullMergePush(this, arg);
+        this.initializeIModelDb();
+        const changeset = this.changeset;
+        IpcHost_1.IpcHost.notifyTxns(this, "notifyPushedChanges", changeset);
+    }
+}
+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 {
+    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);
+    }
+    async performRefresh(accessToken, iModel) {
+        this._timestamp = 0; // everyone needs to wait until token is valid
+        // we're going to request that the checkpoint manager use this user's accessToken to obtain a new access token for this checkpoint's storage account.
+        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.nativeDb.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 });
+            if (!props)
+                throw new Error("can't reset checkpoint sas token");
+            container.accessToken = props.sasToken;
+            this.setTimestamp(props.sasToken);
+            core_bentley_1.Logger.logInfo(BackendLoggerCategory_1.BackendLoggerCategory.Authorization, "refreshed checkpoint sasToken successfully");
+        }
+        finally {
+            this._promise = undefined;
+        }
+    }
+    setTimestamp(sasToken) {
+        const exp = new URLSearchParams(sasToken).get("se");
+        const sasTokenExpiry = exp ? Date.parse(exp) : 0;
+        this._timestamp = sasTokenExpiry - (this._safetySeconds * 1000);
+        if (this._timestamp < Date.now())
+            core_bentley_1.Logger.logError(BackendLoggerCategory_1.BackendLoggerCategory.Authorization, "attached with timestamp that expires before safety interval");
+    }
+    async refreshSas(accessToken, iModel) {
+        if (this._timestamp > Date.now())
+            return; // current token is fine
+        if (undefined === this._promise) // has reattach already begun?
+            this._promise = this.performRefresh(accessToken, iModel); // no, start it
+        return this._promise;
+    }
+}
+/** A *snapshot* iModel database file that is used for archival and data transfer purposes.
+ * @see [Snapshot iModels]($docs/learning/backend/AccessingIModels.md#snapshot-imodels)
+ * @see [About IModelDb]($docs/learning/backend/IModelDb.md)
+ * @public
+ */
+class SnapshotDb extends IModelDb {
+    constructor(nativeDb, key) {
+        super({ nativeDb, key, changeset: nativeDb.getCurrentChangeset() });
+        this._openMode = nativeDb.isReadonly() ? core_bentley_1.OpenMode.Readonly : core_bentley_1.OpenMode.ReadWrite;
+    }
+    get isSnapshot() { return true; }
+    static findByKey(key) {
+        return super.findByKey(key);
+    }
+    static tryFindByKey(key) {
+        const db = super.tryFindByKey(key);
+        return db?.isSnapshotDb() ? db : undefined;
+    }
+    /** Create an *empty* local [Snapshot]($docs/learning/backend/AccessingIModels.md#snapshot-imodels) iModel file.
+     * Snapshots are not synchronized with iModelHub, so do not have a change timeline.
+     * > Note: A *snapshot* cannot be modified after [[close]] is called.
+     * @param filePath The file that will contain the new iModel *snapshot*
+     * @param options The parameters that define the new iModel *snapshot*
+     * @returns A writeable SnapshotDb
+     * @see [Snapshot iModels]($docs/learning/backend/AccessingIModels.md#snapshot-imodels)
+     */
+    static createEmpty(filePath, options) {
+        const nativeDb = new IModelHost_1.IModelHost.platform.DgnDb();
+        nativeDb.createIModel(filePath, options);
+        nativeDb.resetBriefcaseId(core_common_1.BriefcaseIdValue.Unassigned);
+        const snapshotDb = new SnapshotDb(nativeDb, core_bentley_1.Guid.createValue());
+        if (options.createClassViews)
+            snapshotDb._createClassViewsOnClose = true; // save flag that will be checked when close() is called
+        return snapshotDb;
+    }
+    /** Create a local [Snapshot]($docs/learning/backend/AccessingIModels.md#snapshot-imodels) iModel file, using this iModel as a *seed* or starting point.
+     * Snapshots are not synchronized with iModelHub, so do not have a change timeline.
+     * > Note: A *snapshot* cannot be modified after [[close]] is called.
+     * @param iModelDb The snapshot will be initialized from the current contents of this iModelDb
+     * @param snapshotFile The file that will contain the new iModel *snapshot*
+     * @param options Optional properties that determine how the snapshot iModel is created.
+     * @returns A writeable SnapshotDb
+     * @see [Snapshot iModels]($docs/learning/backend/AccessingIModels.md#snapshot-imodels)
+     */
+    static createFrom(iModelDb, snapshotFile, options) {
+        iModelDb.performCheckpoint();
+        IModelJsFs_1.IModelJsFs.copySync(iModelDb.pathName, snapshotFile);
+        const nativeDb = new IModelHost_1.IModelHost.platform.DgnDb();
+        nativeDb.openIModel(snapshotFile, core_bentley_1.OpenMode.ReadWrite, undefined, options);
+        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()))
+            nativeDb.setIModelId(core_bentley_1.Guid.createValue());
+        nativeDb.deleteLocalValue(BriefcaseLocalValue.StandaloneEdit);
+        nativeDb.saveChanges();
+        nativeDb.deleteAllTxns();
+        nativeDb.resetBriefcaseId(core_common_1.BriefcaseIdValue.Unassigned);
+        const snapshotDb = new SnapshotDb(nativeDb, core_bentley_1.Guid.createValue());
+        if (options?.createClassViews)
+            snapshotDb._createClassViewsOnClose = true; // save flag that will be checked when close() is called
+        return snapshotDb;
+    }
+    /** open this SnapshotDb read/write, strictly to apply incoming changesets. Used for creating new checkpoints.
+     * @internal
+     */
+    static openForApplyChangesets(path, props) {
+        const file = { path, key: props?.key };
+        const nativeDb = this.openDgnDb(file, core_bentley_1.OpenMode.ReadWrite, undefined, props);
+        (0, core_bentley_1.assert)(undefined !== file.key);
+        return new SnapshotDb(nativeDb, file.key);
+    }
+    /** Open a read-only iModel *snapshot*.
+     * @param path the full path of the snapshot iModel file to open.
+     * @param props options for opening snapshot
+     * @see [[close]]
+     * @throws [[IModelError]] If the file is not found or is not a valid *snapshot*.
+     */
+    static openFile(path, opts) {
+        const file = { path, key: opts?.key };
+        const nativeDb = this.openDgnDb(file, core_bentley_1.OpenMode.Readonly, undefined, opts);
+        (0, core_bentley_1.assert)(undefined !== file.key);
+        return new SnapshotDb(nativeDb, file.key);
+    }
+    /** Open a previously downloaded V1 checkpoint file.
+     * @note The key is generated by this call is predictable and is formed from the IModelId and ChangeSetId.
+     * This is so every backend working on the same checkpoint will use the same key, to permit multiple backends
+     * servicing the same checkpoint.
+     * @internal
+     */
+    static openCheckpointV1(fileName, checkpoint) {
+        const snapshot = this.openFile(fileName, { key: CheckpointManager_1.CheckpointManager.getKey(checkpoint) });
+        snapshot._iTwinId = checkpoint.iTwinId;
+        return snapshot;
+    }
+    /** Open a V2 *checkpoint*, a special form of snapshot iModel that represents a read-only snapshot of an iModel from iModelHub at a particular point in time.
+     * > Note: The checkpoint daemon must already be running and a checkpoint must already exist in iModelHub's storage *before* this function is called.
+     * @param checkpoint The checkpoint to open
+     * @note The key generated by this call is predictable and is formed from the IModelId and ChangeSetId.
+     * This is so every backend working on the same checkpoint will use the same key, to permit multiple backends
+     * servicing the same checkpoint.
+     * @throws [[IModelError]] If the checkpoint is not found in iModelHub or the checkpoint daemon is not supported in the current environment.
+     * @internal
+     */
+    static async openCheckpointV2(checkpoint) {
+        const { dbName, container } = await CheckpointManager_1.V2CheckpointManager.attach(checkpoint);
+        const key = CheckpointManager_1.CheckpointManager.getKey(checkpoint);
+        const tempFileBase = (0, path_1.join)(IModelHost_1.IModelHost.cacheDir, `${checkpoint.iModelId}\$${checkpoint.changeset.id}`); // temp files for this checkpoint should go in the cacheDir.
+        const snapshot = SnapshotDb.openFile(dbName, { key, tempFileBase, container });
+        snapshot._iTwinId = checkpoint.iTwinId;
+        try {
+            CheckpointManager_1.CheckpointManager.validateCheckpointGuids(checkpoint, snapshot);
+        }
+        catch (err) {
+            snapshot.close();
+            throw err;
+        }
+        snapshot._refreshSas = new RefreshV2CheckpointSas(container.accessToken, checkpoint.reattachSafetySeconds);
+        return snapshot;
+    }
+    /** Used to refresh the container sasToken using the current user's accessToken
+     * @internal
+     */
+    async refreshContainerSas(userAccessToken) {
+        return this._refreshSas?.refreshSas(userAccessToken, this);
+    }
+    /** @internal */
+    beforeClose() {
+        super.beforeClose();
+        if (this._createClassViewsOnClose) { // check for flag set during create
+            if (core_bentley_1.BentleyStatus.SUCCESS !== this.nativeDb.createClassViewsInDb()) {
+                throw new core_common_1.IModelError(core_bentley_1.IModelStatus.SQLiteError, "Error creating class views");
+            }
+            else {
+                this.saveChanges();
+            }
+        }
+    }
+}
+exports.SnapshotDb = SnapshotDb;
+/**
+ * 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.
+ * Standalone iModels are designed such that the API for Standalone iModels and Briefcase
+ * iModels (those synchronized with iModelHub) are as similar and consistent as possible.
+ * This leads to a straightforward process where the a user starts with StandaloneDb and can
+ * optionally choose to upgrade to an iTwin.
+ *
+ * Some additional details. Standalone iModels:
+ * - always have [Guid.empty]($bentley) for their iTwinId (they are "unassociated" files)
+ * - always have BriefcaseId === [BriefcaseIdValue.Unassigned]($common)
+ * - are connected to the frontend via [BriefcaseConnection.openStandalone]($frontend)
+ * - may be opened without supplying any user credentials
+ * - may be opened read/write
+ * - cannot apply a changeset to nor generate a changesets (since there is no timeline from which to get/push changesets)
+ * @public
+ */
+class StandaloneDb extends BriefcaseDb {
+    get isStandalone() { return true; }
+    get useLockServer() { return false; } // standalone iModels have no lock server
+    static findByKey(key) {
+        return super.findByKey(key);
+    }
+    static tryFindByKey(key) {
+        const db = super.tryFindByKey(key);
+        return db?.isStandaloneDb() ? db : undefined;
+    }
+    /** Create an *empty* standalone iModel.
+     * @param filePath The file path for the iModel
+     * @param args The parameters that define the new iModel
+     */
+    static createEmpty(filePath, args) {
+        const nativeDb = new IModelHost_1.IModelHost.platform.DgnDb();
+        nativeDb.createIModel(filePath, args);
+        nativeDb.saveLocalValue(BriefcaseLocalValue.StandaloneEdit, args.allowEdit);
+        nativeDb.setITwinId(core_bentley_1.Guid.empty);
+        nativeDb.resetBriefcaseId(core_common_1.BriefcaseIdValue.Unassigned);
+        nativeDb.saveChanges();
+        return new StandaloneDb({ nativeDb, key: core_bentley_1.Guid.createValue(), briefcaseId: core_common_1.BriefcaseIdValue.Unassigned, openMode: core_bentley_1.OpenMode.ReadWrite });
+    }
+    /**
+     * Upgrades the schemas in the standalone iModel file.
+     * Note that the upgrade requires that the file be closed, and will leave it back in the closed state.
+     * @param filePath Full path name of the standalone iModel file.
+     * @see ($docs/learning/backend/IModelDb.md#upgrading-schemas-in-an-imodel)
+     * @see [[StandaloneDb.validateSchemas]]
+     */
+    static upgradeStandaloneSchemas(filePath) {
+        let nativeDb = this.openDgnDb({ path: filePath }, core_bentley_1.OpenMode.ReadWrite, { profile: core_common_1.ProfileOptions.Upgrade, schemaLockHeld: true });
+        nativeDb.closeIModel();
+        nativeDb = this.openDgnDb({ path: filePath }, core_bentley_1.OpenMode.ReadWrite, { domain: core_common_1.DomainOptions.Upgrade, schemaLockHeld: true });
+        nativeDb.closeIModel();
+    }
+    /** Open a standalone iModel file.
+     * @param filePath The path of the standalone iModel file.
+     * @param openMode Optional open mode for the standalone iModel. The default is read/write.
+     * @throws [[IModelError]] if the file is not a standalone iModel.
+     * @see [BriefcaseConnection.openStandalone]($frontend) to open a StandaloneDb from the frontend
+     */
+    static openFile(filePath, openMode = core_bentley_1.OpenMode.ReadWrite, options) {
+        const file = { path: filePath, key: options?.key };
+        const nativeDb = this.openDgnDb(file, openMode, undefined, options);
+        try {
+            const iTwinId = nativeDb.getITwinId();
+            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);
+            return new StandaloneDb({ nativeDb, key: file.key, openMode, briefcaseId: core_common_1.BriefcaseIdValue.Unassigned });
+        }
+        catch (error) {
+            nativeDb.closeIModel();
+            throw error;
+        }
+    }
+}
+exports.StandaloneDb = StandaloneDb;
 //# sourceMappingURL=IModelDb.js.map