@itwin/core-backend 4.8.0-dev.3 → 4.8.0-dev.31

package/lib/cjs/IModelDb.js

@@ -17,6 +17,7 @@ const core_geometry_1 = require("@itwin/core-geometry");
 const BackendLoggerCategory_1 = require("./BackendLoggerCategory");
 const BriefcaseManager_1 = require("./BriefcaseManager");
 const ChannelControl_1 = require("./ChannelControl");
+const ChannelAdmin_1 = require("./internal/ChannelAdmin");
 const CheckpointManager_1 = require("./CheckpointManager");
 const ClassRegistry_1 = require("./ClassRegistry");
 const CloudSqlite_1 = require("./CloudSqlite");
@@ -34,28 +35,20 @@ const IpcHost_1 = require("./IpcHost");
 const Model_1 = require("./Model");
 const Relationship_1 = require("./Relationship");
 const SchemaSync_1 = require("./SchemaSync");
-const ServerBasedLocks_1 = require("./ServerBasedLocks");
+const ServerBasedLocks_1 = require("./internal/ServerBasedLocks");
 const SqliteStatement_1 = require("./SqliteStatement");
 const TxnManager_1 = require("./TxnManager");
 const ViewDefinition_1 = require("./ViewDefinition");
 const ViewStore_1 = require("./ViewStore");
 const Settings_1 = require("./workspace/Settings");
 const Workspace_1 = require("./workspace/Workspace");
+const WorkspaceImpl_1 = require("./internal/workspace/WorkspaceImpl");
+const SettingsImpl_1 = require("./internal/workspace/SettingsImpl");
+const NativePlatform_1 = require("./internal/NativePlatform");
+const NoLocks_1 = require("./internal/NoLocks");
+const Symbols_1 = require("./internal/Symbols");
 // 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) {
@@ -74,16 +67,16 @@ const withBriefcaseDb = async (briefcase, fn) => {
 };
 /**
  * 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.
+ * @note if there is more than one iModel for an iTwin or organization, they will *each* hold an independent copy of the settings for those priorities.
  */
-class IModelSettings extends Settings_1.BaseSettings {
+class IModelSettings extends SettingsImpl_1.SettingsImpl {
     verifyPriority(priority) {
         if (priority <= Settings_1.SettingsPriority.application)
-            throw new Error("Use IModelHost.appSettings");
+            throw new Error("Use IModelHost.appSettings to access settings of priority 'application' or lower");
     }
-    // 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);
+    *getSettingEntries(name) {
+        yield* super.getSettingEntries(name);
+        yield* IModelHost_1.IModelHost.appWorkspace.settings.getSettingEntries(name);
     }
 }
 /** An iModel database file. The database file can either be a briefcase or a snapshot.
@@ -94,10 +87,7 @@ class IModelSettings extends Settings_1.BaseSettings {
 class IModelDb extends core_common_1.IModel {
     /** @alpha */
     get codeService() { return this._codeService; }
-    /**
-     * Get the [[LockControl]] for this iModel.
-     * @beta
-     */
+    /** The [[LockControl]] that orchestrates [concurrent editing]($docs/learning/backend/ConcurrencyControl.md) of this iModel. */
     get locks() { return this._locks; } // eslint-disable-line @typescript-eslint/no-non-null-assertion
     /**
      * Get the [[Workspace]] for this iModel.
@@ -105,11 +95,11 @@ class IModelDb extends core_common_1.IModel {
      */
     get workspace() {
         if (undefined === this._workspace)
-            this._workspace = Workspace_1.Workspace.construct(new IModelSettings());
+            this._workspace = (0, WorkspaceImpl_1.constructWorkspace)(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
+     * @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() {
@@ -121,15 +111,15 @@ class IModelDb extends core_common_1.IModel {
     }
     /** @internal */
     notifyChangesetApplied() {
-        this.changeset = this.nativeDb.getCurrentChangeset();
+        this.changeset = this[Symbols_1._nativeDb].getCurrentChangeset();
         this.onChangesetApplied.raiseEvent();
     }
     /** @internal */
     restartDefaultTxn() {
-        this.nativeDb.restartDefaultTxn();
+        this[Symbols_1._nativeDb].restartDefaultTxn();
     }
     get fontMap() {
-        return this._fontMap ?? (this._fontMap = new core_common_1.FontMap(this.nativeDb.readFontMap()));
+        return this._fontMap ?? (this._fontMap = new core_common_1.FontMap(this[Symbols_1._nativeDb].readFontMap()));
     }
     /** @internal */
     clearFontMap() {
@@ -146,7 +136,7 @@ class IModelDb extends core_common_1.IModel {
     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 });
+        return this[Symbols_1._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; }
@@ -155,10 +145,14 @@ class IModelDb extends core_common_1.IModel {
         (0, core_bentley_1.assert)(undefined !== super.iModelId);
         return super.iModelId;
     } // GuidString | undefined for the IModel superclass, but required for all IModelDb subclasses
+    /** @internal
+     * @deprecated in 4.8. This internal API will be removed in 5.0. Use IModelDb's public API instead.
+     */
+    get nativeDb() { return this[Symbols_1._nativeDb]; }
     /** 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(); }
+    get pathName() { return this[Symbols_1._nativeDb].getFilePath(); }
     /** Get the full path to this iModel's "watch file".
      * A read-only briefcase opened with `watchForChanges: true` creates this file next to the briefcase file on open, if it doesn't already exist.
      * A writable briefcase "touches" this file if it exists whenever it commits changes to the briefcase.
@@ -176,30 +170,30 @@ class IModelDb extends core_common_1.IModel {
         this.views = new IModelDb.Views(this);
         this.tiles = new IModelDb.Tiles(this);
         /** @beta */
-        this.channels = new ChannelControl_1.ChannelAdmin(this);
+        this.channels = (0, ChannelAdmin_1.createChannelControl)(this);
         this._statementCache = new SqliteStatement_1.StatementCache();
         this._sqliteStatementCache = new SqliteStatement_1.StatementCache();
         this._snaps = new Map();
         /** @internal */
-        this._locks = new NoLocks();
+        this._locks = (0, NoLocks_1.createNoOpLockControl)();
         /** Event called after a changeset is applied to this IModelDb. */
         this.onChangesetApplied = new core_bentley_1.BeEvent();
         /** Event called when the iModel is about to be closed. */
         this.onBeforeClose = new core_bentley_1.BeEvent();
-        this.nativeDb = args.nativeDb;
+        this[Symbols_1._nativeDb] = args.nativeDb;
         // it is illegal to create an IModelDb unless the nativeDb has been opened. Throw otherwise.
         if (!this.isOpen)
             throw new Error("cannot create an IModelDb unless it has already been opened");
         // PR https://github.com/iTwin/imodel-native/pull/558 renamed closeIModel to closeFile because it changed its behavior.
         // Ideally, nobody outside of core-backend would be calling it, but somebody important is.
         // Make closeIModel available so their code doesn't break.
-        this.nativeDb.closeIModel = () => {
+        this[Symbols_1._nativeDb].closeIModel = () => {
             if (!this.isReadonly)
                 this.saveChanges(); // preserve old behavior of closeIModel that was removed when renamed to closeFile
-            this.nativeDb.closeFile();
+            this[Symbols_1._nativeDb].closeFile();
         };
-        this.nativeDb.setIModelDb(this);
-        this.loadSettingDictionaries();
+        this[Symbols_1._nativeDb].setIModelDb(this);
+        this.loadIModelSettings();
         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);
@@ -222,13 +216,13 @@ class IModelDb extends core_common_1.IModel {
         this.beforeClose();
         IModelDb._openDbs.delete(this._fileKey);
         this._workspace?.close();
-        this.locks.close();
+        this.locks[Symbols_1._close]();
         this._locks = undefined;
         this._codeService?.close();
         this._codeService = undefined;
         if (!this.isReadonly)
             this.saveChanges();
-        this.nativeDb.closeFile();
+        this[Symbols_1._nativeDb].closeFile();
     }
     /** @internal */
     async refreshContainerForRpc(_userAccessToken) { }
@@ -242,7 +236,7 @@ class IModelDb extends core_common_1.IModel {
     }
     /** @internal */
     initializeIModelDb() {
-        const props = this.nativeDb.getIModelProps();
+        const props = this[Symbols_1._nativeDb].getIModelProps();
         super.initialize(props.rootSubject.name, props);
         if (this._initialized)
             return;
@@ -279,9 +273,9 @@ class IModelDb extends core_common_1.IModel {
     /** Return `true` if the underlying nativeDb is open and valid.
      * @internal
      */
-    get isOpen() { return this.nativeDb.isOpen(); }
+    get isOpen() { return this[Symbols_1._nativeDb].isOpen(); }
     /** Get the briefcase Id of this iModel */
-    getBriefcaseId() { return this.isOpen ? this.nativeDb.getBriefcaseId() : core_common_1.BriefcaseIdValue.Illegal; }
+    getBriefcaseId() { return this.isOpen ? this[Symbols_1._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
@@ -355,11 +349,11 @@ class IModelDb extends core_common_1.IModel {
      * @public
      * */
     createQueryReader(ecsql, params, config) {
-        if (!this.nativeDb.isOpen())
+        if (!this[Symbols_1._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 ConcurrentQuery_1.ConcurrentQuery.executeQueryRequest(this[Symbols_1._nativeDb], request);
             },
         };
         return new core_common_1.ECSqlReader(executor, ecsql, params, config);
@@ -494,11 +488,36 @@ class IModelDb extends core_common_1.IModel {
      */
     prepareSqliteStatement(sql, logErrors = true) {
         const stmt = new SqliteStatement_1.SqliteStatement(sql);
-        stmt.prepare(this.nativeDb, logErrors);
+        stmt.prepare(this[Symbols_1._nativeDb], logErrors);
         return stmt;
     }
     /**
-     * queries the BisCore.SubCategory table for the entries that are children of the passed categoryIds
+     * queries the BisCore.SubCategory table for entries that are children of used spatial categories and 3D elements.
+     * @returns array of SubCategoryResultRow
+     * @internal
+     */
+    async queryAllUsedSpatialSubCategories() {
+        const result = [];
+        const parentCategoriesQuery = `SELECT DISTINCT Category.Id AS id FROM BisCore.GeometricElement3d WHERE Category.Id IN (SELECT ECInstanceId FROM BisCore.SpatialCategory)`;
+        const parentCategories = [];
+        for await (const row of this.createQueryReader(parentCategoriesQuery)) {
+            parentCategories.push(row.id);
+        }
+        ;
+        const where = [...parentCategories].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.createQueryReader(query, undefined, { rowFormat: core_common_1.QueryRowFormat.UseJsPropertyNames })) {
+                result.push(row.toRow());
+            }
+        }
+        catch {
+            // We can ignore the error here, and just return whatever we were able to query.
+        }
+        return result;
+    }
+    /**
+     * 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
@@ -582,7 +601,7 @@ class IModelDb extends core_common_1.IModel {
     computeProjectExtents(options) {
         const wantFullExtents = true === options?.reportExtentsWithOutliers;
         const wantOutliers = true === options?.reportOutliers;
-        const result = this.nativeDb.computeProjectExtents(wantFullExtents, wantOutliers);
+        const result = this[Symbols_1._nativeDb].computeProjectExtents(wantFullExtents, wantOutliers);
         return {
             extents: core_geometry_1.Range3d.fromJSON(result.extents),
             extentsWithOutliers: result.fullExtents ? core_geometry_1.Range3d.fromJSON(result.fullExtents) : undefined,
@@ -596,7 +615,7 @@ class IModelDb extends core_common_1.IModel {
     }
     /** Update the IModelProps of this iModel in the database. */
     updateIModelProps() {
-        this.nativeDb.updateIModelProps(this.toJSON());
+        this[Symbols_1._nativeDb].updateIModelProps(this.toJSON());
     }
     /** Commit pending changes to this iModel.
      * @param description Optional description of the changes
@@ -605,13 +624,13 @@ class IModelDb extends core_common_1.IModel {
     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);
+        const stat = this[Symbols_1._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();
+        this[Symbols_1._nativeDb].abandonChanges();
     }
     /**
      * Save all changes and perform a [checkpoint](https://www.sqlite.org/c3ref/wal_checkpoint_v2.html) on this IModelDb.
@@ -624,20 +643,22 @@ class IModelDb extends core_common_1.IModel {
     performCheckpoint() {
         if (!this.isReadonly) {
             this.saveChanges();
-            this.nativeDb.performCheckpoint();
+            this[Symbols_1._nativeDb].performCheckpoint();
         }
     }
-    /** @internal */
+    /** @internal
+     * @deprecated in 4.8. Use `txns.reverseTxns`.
+     */
     reverseTxns(numOperations) {
-        return this.nativeDb.reverseTxns(numOperations);
+        return this[Symbols_1._nativeDb].reverseTxns(numOperations);
     }
     /** @internal */
     reinstateTxn() {
-        return this.nativeDb.reinstateTxn();
+        return this[Symbols_1._nativeDb].reinstateTxn();
     }
     /** @internal */
     restartTxnSession() {
-        return this.nativeDb.restartTxnSession();
+        return this[Symbols_1._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.
@@ -653,20 +674,20 @@ class IModelDb extends core_common_1.IModel {
         if (schemaFileNames.length === 0)
             return;
         const maybeCustomNativeContext = options?.ecSchemaXmlContext?.nativeContext;
-        if (this.nativeDb.schemaSyncEnabled()) {
+        if (this[Symbols_1._nativeDb].schemaSyncEnabled()) {
             await SchemaSync_1.SchemaSync.withLockedAccess(this, { openMode: core_bentley_1.OpenMode.Readonly, operationName: "schema sync" }, async (syncAccess) => {
                 const schemaSyncDbUri = syncAccess.getUri();
                 this.saveChanges();
                 try {
-                    this.nativeDb.importSchemas(schemaFileNames, { schemaLockHeld: false, ecSchemaXmlContext: maybeCustomNativeContext, schemaSyncDbUri });
+                    this[Symbols_1._nativeDb].importSchemas(schemaFileNames, { schemaLockHeld: false, ecSchemaXmlContext: maybeCustomNativeContext, schemaSyncDbUri });
                 }
                 catch (outerErr) {
                     if (core_bentley_1.DbResult.BE_SQLITE_ERROR_DataTransformRequired === outerErr.errorNumber) {
                         this.abandonChanges();
-                        if (this.nativeDb.getITwinId() !== core_bentley_1.Guid.empty)
+                        if (this[Symbols_1._nativeDb].getITwinId() !== core_bentley_1.Guid.empty)
                             await this.acquireSchemaLock();
                         try {
-                            this.nativeDb.importSchemas(schemaFileNames, { schemaLockHeld: true, ecSchemaXmlContext: maybeCustomNativeContext, schemaSyncDbUri });
+                            this[Symbols_1._nativeDb].importSchemas(schemaFileNames, { schemaLockHeld: true, ecSchemaXmlContext: maybeCustomNativeContext, schemaSyncDbUri });
                         }
                         catch (innerErr) {
                             throw new core_common_1.IModelError(innerErr.errorNumber, innerErr.message);
@@ -683,10 +704,10 @@ class IModelDb extends core_common_1.IModel {
                 schemaLockHeld: true,
                 ecSchemaXmlContext: maybeCustomNativeContext,
             };
-            if (this.nativeDb.getITwinId() !== core_bentley_1.Guid.empty) // if this iModel is associated with an iTwin, importing schema requires the schema lock
+            if (this[Symbols_1._nativeDb].getITwinId() !== core_bentley_1.Guid.empty) // if this iModel is associated with an iTwin, importing schema requires the schema lock
                 await this.acquireSchemaLock();
             try {
-                this.nativeDb.importSchemas(schemaFileNames, nativeImportOptions);
+                this[Symbols_1._nativeDb].importSchemas(schemaFileNames, nativeImportOptions);
             }
             catch (err) {
                 throw new core_common_1.IModelError(err.errorNumber, err.message);
@@ -706,20 +727,20 @@ class IModelDb extends core_common_1.IModel {
     async importSchemaStrings(serializedXmlSchemas) {
         if (serializedXmlSchemas.length === 0)
             return;
-        if (this.nativeDb.schemaSyncEnabled()) {
+        if (this[Symbols_1._nativeDb].schemaSyncEnabled()) {
             await SchemaSync_1.SchemaSync.withLockedAccess(this, { openMode: core_bentley_1.OpenMode.Readonly, operationName: "schemaSync" }, async (syncAccess) => {
                 const schemaSyncDbUri = syncAccess.getUri();
                 this.saveChanges();
                 try {
-                    this.nativeDb.importXmlSchemas(serializedXmlSchemas, { schemaLockHeld: false, schemaSyncDbUri });
+                    this[Symbols_1._nativeDb].importXmlSchemas(serializedXmlSchemas, { schemaLockHeld: false, schemaSyncDbUri });
                 }
                 catch (outerErr) {
                     if (core_bentley_1.DbResult.BE_SQLITE_ERROR_DataTransformRequired === outerErr.errorNumber) {
                         this.abandonChanges();
-                        if (this.nativeDb.getITwinId() !== core_bentley_1.Guid.empty)
+                        if (this[Symbols_1._nativeDb].getITwinId() !== core_bentley_1.Guid.empty)
                             await this.acquireSchemaLock();
                         try {
-                            this.nativeDb.importXmlSchemas(serializedXmlSchemas, { schemaLockHeld: true, schemaSyncDbUri });
+                            this[Symbols_1._nativeDb].importXmlSchemas(serializedXmlSchemas, { schemaLockHeld: true, schemaSyncDbUri });
                         }
                         catch (innerErr) {
                             throw new core_common_1.IModelError(innerErr.errorNumber, innerErr.message);
@@ -735,7 +756,7 @@ class IModelDb extends core_common_1.IModel {
             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();
             try {
-                this.nativeDb.importXmlSchemas(serializedXmlSchemas, { schemaLockHeld: true });
+                this[Symbols_1._nativeDb].importXmlSchemas(serializedXmlSchemas, { schemaLockHeld: true });
             }
             catch (err) {
                 throw new core_common_1.IModelError(err.errorNumber, err.message);
@@ -780,7 +801,7 @@ class IModelDb extends core_common_1.IModel {
         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();
+            const nativeDb = new NativePlatform_1.IModelNative.platform.DgnDb();
             const container = props?.container;
             if (container) {
                 // temp files for cloud-based Dbs should be in the profileDir in a subdirectory named for their container
@@ -870,7 +891,7 @@ class IModelDb extends core_common_1.IModel {
      */
     prepareStatement(sql, logErrors = true) {
         const stmt = new ECSqlStatement_1.ECSqlStatement();
-        stmt.prepare(this.nativeDb, sql, logErrors);
+        stmt.prepare(this[Symbols_1._nativeDb], sql, logErrors);
         return stmt;
     }
     /** Prepare an ECSQL statement.
@@ -879,7 +900,7 @@ class IModelDb extends core_common_1.IModel {
      */
     tryPrepareStatement(sql) {
         const statement = new ECSqlStatement_1.ECSqlStatement();
-        const result = statement.tryPrepare(this.nativeDb, sql);
+        const result = statement.tryPrepare(this[Symbols_1._nativeDb], sql);
         return core_bentley_1.DbResult.BE_SQLITE_OK === result.status ? statement : undefined;
     }
     /** Construct an entity (Element or Model) from an iModel.
@@ -959,7 +980,7 @@ class IModelDb extends core_common_1.IModel {
         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]);
+        const val = this[Symbols_1._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);
@@ -975,7 +996,7 @@ class IModelDb extends core_common_1.IModel {
      * @throws if the schema can not be found or loaded.
      */
     getSchemaProps(name) {
-        return this.nativeDb.getSchemaProps(name);
+        return this[Symbols_1._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
@@ -985,7 +1006,7 @@ class IModelDb extends core_common_1.IModel {
      */
     containsClass(classFullName) {
         const classNameParts = classFullName.replace(".", ":").split(":");
-        return classNameParts.length === 2 && this.nativeDb.getECClassMetaData(classNameParts[0], classNameParts[1]).error === undefined;
+        return classNameParts.length === 2 && this[Symbols_1._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.
@@ -1009,49 +1030,49 @@ class IModelDb extends core_common_1.IModel {
      * @alpha
      */
     async queryTextureData(props) {
-        return this.nativeDb.queryTextureData(props);
+        return this[Symbols_1._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);
+        return this[Symbols_1._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);
+        return this[Symbols_1._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);
+        this[Symbols_1._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);
+        this[Symbols_1._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); }
+    queryNextAvailableFileProperty(prop) { return this[Symbols_1._nativeDb].queryNextAvailableFileProperty(prop); }
     /** @internal */
     async requestSnap(sessionId, props) {
         let request = this._snaps.get(sessionId);
         if (undefined === request) {
-            request = new IModelHost_1.IModelHost.platform.SnapRequest();
+            request = new NativePlatform_1.IModelNative.platform.SnapRequest();
             this._snaps.set(sessionId, request);
         }
         else
             request.cancelSnap();
         try {
-            return await request.doSnap(this.nativeDb, core_bentley_1.JsonUtils.toObject(props));
+            return await request.doSnap(this[Symbols_1._nativeDb], core_bentley_1.JsonUtils.toObject(props));
         }
         finally {
             this._snaps.delete(sessionId);
@@ -1069,19 +1090,19 @@ class IModelDb extends core_common_1.IModel {
     }
     /** Get the clip containment status for the supplied elements. */
     async getGeometryContainment(props) {
-        return this.nativeDb.getGeometryContainment(core_bentley_1.JsonUtils.toObject(props));
+        return this[Symbols_1._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));
+        return this[Symbols_1._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);
+        return this[Symbols_1._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);
+        return this[Symbols_1._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,
@@ -1116,7 +1137,7 @@ class IModelDb extends core_common_1.IModel {
      * @public
      */
     exportGraphics(exportProps) {
-        return this.nativeDb.exportGraphics(exportProps);
+        return this[Symbols_1._nativeDb].exportGraphics(exportProps);
     }
     /**
      * Exports meshes suitable for graphics APIs from a specified [GeometryPart]($core-backend)
@@ -1131,14 +1152,14 @@ class IModelDb extends core_common_1.IModel {
      * @public
      */
     exportPartGraphics(exportProps) {
-        return this.nativeDb.exportPartGraphics(exportProps);
+        return this[Symbols_1._nativeDb].exportPartGraphics(exportProps);
     }
     /** Request geometry stream information from an element in binary format instead of json.
      * @returns IModelStatus.Success if successful
      * @beta
      */
     elementGeometryRequest(requestProps) {
-        return this.nativeDb.processGeometryStream(requestProps);
+        return this[Symbols_1._nativeDb].processGeometryStream(requestProps);
     }
     /** Create brep geometry for inclusion in an element's geometry stream.
      * @returns IModelStatus.Success if successful
@@ -1146,7 +1167,7 @@ class IModelDb extends core_common_1.IModel {
      * @alpha
      */
     createBRepGeometry(createProps) {
-        return this.nativeDb.createBRepGeometry(createProps);
+        return this[Symbols_1._nativeDb].createBRepGeometry(createProps);
     }
     /** Generate graphics for an element or geometry stream.
      * @see [readElementGraphics]($frontend) to convert the result to a [RenderGraphic]($frontend) for display.
@@ -1182,35 +1203,65 @@ class IModelDb extends core_common_1.IModel {
         this.saveChanges("delete settings");
     }
     /** Load all setting dictionaries in this iModel into `this.workspace.settings` */
-    loadSettingDictionaries() {
-        if (!this.nativeDb.isOpen())
+    loadIModelSettings() {
+        if (!this[Symbols_1._nativeDb].isOpen())
             return;
         this.withSqliteStatement("SELECT Name,StrData FROM be_Prop WHERE Namespace=?", (stmt) => {
             stmt.bindString(1, IModelDb._settingPropNamespace);
             while (stmt.nextRow()) {
                 try {
-                    const dict = JSON.parse(stmt.getValueString(1));
-                    this.workspace.settings.addDictionary(stmt.getValueString(0), Settings_1.SettingsPriority.iModel, dict);
+                    const settings = JSON.parse(stmt.getValueString(1));
+                    this.workspace.settings.addDictionary({ name: stmt.getValueString(0), priority: Settings_1.SettingsPriority.iModel }, settings);
                 }
                 catch (e) {
-                    core_bentley_1.UnexpectedErrors.handle(e);
+                    Workspace_1.Workspace.exceptionDiagnosticFn(e);
                 }
             }
         });
     }
+    /** @internal */
+    async loadWorkspaceSettings() {
+        try {
+            const problems = [];
+            const settingProps = [];
+            // Note: we can't use `getArray` here because we only look at dictionaries in the iModel's workspace, not appWorkspace.
+            // Also, we must concatenate all entries in all of the dictionaries stored in the iModel into a single array *before*
+            // calling `loadSettingsDictionary` since that function will add new dictionaries to the workspace.
+            for (const dict of this.workspace.settings.dictionaries) {
+                try {
+                    const props = dict.getSetting(Workspace_1.WorkspaceSettingNames.settingsWorkspaces);
+                    if (props)
+                        settingProps.push(...IModelHost_1.IModelHost.settingsSchemas.validateSetting(props, Workspace_1.WorkspaceSettingNames.settingsWorkspaces));
+                }
+                catch (e) {
+                    problems.push(e); // something wrong with the setting stored in the iModel
+                }
+            }
+            if (settingProps.length > 0)
+                await this.workspace.loadSettingsDictionary(settingProps, problems);
+            if (problems.length > 0)
+                (0, WorkspaceImpl_1.throwWorkspaceDbLoadErrors)(`attempting to load workspace settings for iModel '${this.name}':`, problems);
+        }
+        catch (e) {
+            // we don't want to throw exceptions when attempting to load Dictionaries. Call the diagnostics function instead.
+            Workspace_1.Workspace.exceptionDiagnosticFn(e);
+        }
+    }
     /**
-     * Controls how [Code]($common)s are copied from this iModel into another iModel, to work around problems with iModels created by older connectors. The [imodel-transformer](https://github.com/iTwin/imodel-transformer) sets this appropriately on your behalf - you should never need to set or interrogate this property yourself.
+     * Controls how [Code]($common)s are copied from this iModel into another iModel, to work around problems with iModels
+     * created by older connectors. The [imodel-transformer](https://github.com/iTwin/imodel-transformer) sets this appropriately
+     * on your behalf - you should never need to set or interrogate this property yourself.
      * @public
      */
     get codeValueBehavior() {
-        return this.nativeDb.getCodeValueBehavior();
+        return this[Symbols_1._nativeDb].getCodeValueBehavior();
     }
     set codeValueBehavior(newBehavior) {
-        this.nativeDb.setCodeValueBehavior(newBehavior);
+        this[Symbols_1._nativeDb].setCodeValueBehavior(newBehavior);
     }
     /** @internal */
     computeRangesForText(args) {
-        const props = this.nativeDb.computeRangesForText(args.chars, args.fontId, args.bold, args.italic, args.widthFactor, args.lineHeight);
+        const props = this[Symbols_1._nativeDb].computeRangesForText(args.chars, args.fontId, args.bold, args.italic, args.widthFactor, args.lineHeight);
         return {
             layout: core_geometry_1.Range2d.fromJSON(props.layout),
             justification: core_geometry_1.Range2d.fromJSON(props.justification),
@@ -1316,7 +1367,7 @@ IModelDb._settingPropNamespace = "settings";
          */
         tryGetModelJson(modelIdArg) {
             try {
-                return this._iModel.nativeDb.getModel(modelIdArg);
+                return this._iModel[Symbols_1._nativeDb].getModel(modelIdArg);
             }
             catch (err) {
                 return undefined;
@@ -1361,7 +1412,7 @@ IModelDb._settingPropNamespace = "settings";
          */
         insertModel(props) {
             try {
-                return props.id = this._iModel.nativeDb.insertModel(props);
+                return props.id = this._iModel[Symbols_1._nativeDb].insertModel(props);
             }
             catch (err) {
                 throw new core_common_1.IModelError(err.errorNumber, `Error inserting model [${err.message}], class=${props.classFullName}`);
@@ -1373,7 +1424,7 @@ IModelDb._settingPropNamespace = "settings";
          */
         updateModel(props) {
             try {
-                this._iModel.nativeDb.updateModel(props);
+                this._iModel[Symbols_1._nativeDb].updateModel(props);
             }
             catch (err) {
                 throw new core_common_1.IModelError(err.errorNumber, `error updating model [${err.message}] id=${props.id}`);
@@ -1389,7 +1440,7 @@ IModelDb._settingPropNamespace = "settings";
          * @see [[TxnManager.onModelGeometryChanged]] for the event emitted in response to such a change.
          */
         updateGeometryGuid(modelId) {
-            const error = this._iModel.nativeDb.updateModelGeometryGuid(modelId);
+            const error = this._iModel[Symbols_1._nativeDb].updateModelGeometryGuid(modelId);
             if (error !== core_bentley_1.IModelStatus.Success)
                 throw new core_common_1.IModelError(error, `updating geometry guid for model ${modelId}`);
         }
@@ -1400,7 +1451,7 @@ IModelDb._settingPropNamespace = "settings";
         deleteModel(ids) {
             core_bentley_1.Id64.toIdSet(ids).forEach((id) => {
                 try {
-                    this._iModel.nativeDb.deleteModel(id);
+                    this._iModel[Symbols_1._nativeDb].deleteModel(id);
                 }
                 catch (err) {
                     throw new core_common_1.IModelError(err.errorNumber, `error deleting model [${err.message}] id ${id}`);
@@ -1418,7 +1469,7 @@ IModelDb._settingPropNamespace = "settings";
             ids = typeof ids === "string" ? [ids] : ids;
             if (ids.length === 0)
                 return [];
-            return this._iModel.nativeDb.queryModelExtentsAsync(ids);
+            return this._iModel[Symbols_1._nativeDb].queryModelExtentsAsync(ids);
         }
         /** Computes the union of the volumes of all geometric elements within one or more [[GeometricModel]]s, specified by model Id.
          * @see [[queryExtents]] to obtain discrete volumes for each model.
@@ -1473,7 +1524,7 @@ IModelDb._settingPropNamespace = "settings";
          */
         tryGetElementJson(loadProps) {
             try {
-                return this._iModel.nativeDb.getElement(loadProps);
+                return this._iModel[Symbols_1._nativeDb].getElement(loadProps);
             }
             catch (err) {
                 return undefined;
@@ -1491,7 +1542,7 @@ IModelDb._settingPropNamespace = "settings";
                 props = { code: props };
             }
             try {
-                return this._iModel.nativeDb.getElement(props);
+                return this._iModel[Symbols_1._nativeDb].getElement(props);
             }
             catch (err) {
                 throw new core_common_1.IModelError(err.errorNumber, err.message);
@@ -1605,7 +1656,7 @@ IModelDb._settingPropNamespace = "settings";
          */
         insertElement(elProps) {
             try {
-                return elProps.id = this._iModel.nativeDb.insertElement(elProps);
+                return elProps.id = this._iModel[Symbols_1._nativeDb].insertElement(elProps);
             }
             catch (err) {
                 err.message = `Error inserting element [${err.message}]`;
@@ -1626,7 +1677,7 @@ IModelDb._settingPropNamespace = "settings";
          */
         updateElement(elProps) {
             try {
-                this._iModel.nativeDb.updateElement(elProps);
+                this._iModel[Symbols_1._nativeDb].updateElement(elProps);
             }
             catch (err) {
                 err.message = `Error updating element [${err.message}], id: ${elProps.id}`;
@@ -1643,7 +1694,7 @@ IModelDb._settingPropNamespace = "settings";
             const iModel = this._iModel;
             core_bentley_1.Id64.toIdSet(ids).forEach((id) => {
                 try {
-                    iModel.nativeDb.deleteElement(id);
+                    iModel[Symbols_1._nativeDb].deleteElement(id);
                 }
                 catch (err) {
                     err.message = `Error deleting element [${err.message}], id: ${id}`;
@@ -1663,7 +1714,7 @@ IModelDb._settingPropNamespace = "settings";
          * @beta
          */
         deleteDefinitionElements(definitionElementIds) {
-            const usageInfo = this._iModel.nativeDb.queryDefinitionElementUsage(definitionElementIds);
+            const usageInfo = this._iModel[Symbols_1._nativeDb].queryDefinitionElementUsage(definitionElementIds);
             if (!usageInfo) {
                 throw new core_common_1.IModelError(core_bentley_1.IModelStatus.BadRequest, "Error querying for DefinitionElement usage");
             }
@@ -1677,7 +1728,7 @@ IModelDb._settingPropNamespace = "settings";
                 }
             };
             try {
-                this._iModel.nativeDb.beginPurgeOperation();
+                this._iModel[Symbols_1._nativeDb].beginPurgeOperation();
                 deleteIfUnused(usageInfo.spatialCategoryIds, usedIdSet);
                 deleteIfUnused(usageInfo.drawingCategoryIds, usedIdSet);
                 deleteIfUnused(usageInfo.viewDefinitionIds, usedIdSet);
@@ -1694,7 +1745,7 @@ IModelDb._settingPropNamespace = "settings";
                 }
             }
             finally {
-                this._iModel.nativeDb.endPurgeOperation();
+                this._iModel[Symbols_1._nativeDb].endPurgeOperation();
             }
             if (usageInfo.viewDefinitionIds) {
                 // take another pass in case a deleted ViewDefinition was the only usage of these view-related DefinitionElements
@@ -1706,17 +1757,17 @@ IModelDb._settingPropNamespace = "settings";
                 if (usageInfo.modelSelectorIds)
                     viewRelatedIds = viewRelatedIds.concat(usageInfo.modelSelectorIds.filter((id) => usedIdSet.has(id)));
                 if (viewRelatedIds.length > 0) {
-                    const viewRelatedUsageInfo = this._iModel.nativeDb.queryDefinitionElementUsage(viewRelatedIds);
+                    const viewRelatedUsageInfo = this._iModel[Symbols_1._nativeDb].queryDefinitionElementUsage(viewRelatedIds);
                     if (viewRelatedUsageInfo) {
                         const usedViewRelatedIdSet = viewRelatedUsageInfo.usedIds ? core_bentley_1.Id64.toIdSet(viewRelatedUsageInfo.usedIds) : new Set();
                         try {
-                            this._iModel.nativeDb.beginPurgeOperation();
+                            this._iModel[Symbols_1._nativeDb].beginPurgeOperation();
                             deleteIfUnused(viewRelatedUsageInfo.displayStyleIds, usedViewRelatedIdSet);
                             deleteIfUnused(viewRelatedUsageInfo.categorySelectorIds, usedViewRelatedIdSet);
                             deleteIfUnused(viewRelatedUsageInfo.modelSelectorIds, usedViewRelatedIdSet);
                         }
                         finally {
-                            this._iModel.nativeDb.endPurgeOperation();
+                            this._iModel[Symbols_1._nativeDb].endPurgeOperation();
                         }
                         viewRelatedIds.forEach((id) => {
                             if (!usedViewRelatedIdSet.has(id))
@@ -1854,9 +1905,9 @@ IModelDb._settingPropNamespace = "settings";
          */
         getAspects(elementId, aspectClassFullName, excludedClassFullNames) {
             if (aspectClassFullName === undefined) {
-                const allAspects = this.runInstanceQuery(`SELECT $ FROM (
-          SELECT ECInstanceId, ECClassId FROM Bis.ElementMultiAspect WHERE Element.Id = :elementId
-            UNION ALL
+                const allAspects = this.runInstanceQuery(`SELECT $ FROM (
+          SELECT ECInstanceId, ECClassId FROM Bis.ElementMultiAspect WHERE Element.Id = :elementId
+            UNION ALL
           SELECT ECInstanceId, ECClassId FROM Bis.ElementUniqueAspect WHERE Element.Id = :elementId) OPTIONS USE_JS_PROP_NAMES DO_NOT_TRUNCATE_BLOB`, elementId, excludedClassFullNames);
                 if (allAspects.length === 0)
                     core_bentley_1.Logger.logInfo(BackendLoggerCategory_1.BackendLoggerCategory.ECDb, `No aspects found for class ${aspectClassFullName} and element ${elementId}`);
@@ -1864,7 +1915,7 @@ IModelDb._settingPropNamespace = "settings";
             }
             // Check if class is abstract
             const fullClassName = aspectClassFullName.replace(".", ":").split(":");
-            const val = this._iModel.nativeDb.getECClassMetaData(fullClassName[0], fullClassName[1]);
+            const val = this._iModel[Symbols_1._nativeDb].getECClassMetaData(fullClassName[0], fullClassName[1]);
             if (val.result !== undefined) {
                 const metaData = new core_common_1.EntityMetaData(JSON.parse(val.result));
                 if (metaData.modifier !== "Abstract") // Class is not abstract, use normal query to retrieve aspects
@@ -1874,7 +1925,7 @@ IModelDb._settingPropNamespace = "settings";
             let classIdList = IModelDb.Elements.classMap.get(aspectClassFullName);
             if (classIdList === undefined) {
                 const classIds = [];
-                this._iModel.withPreparedStatement(`select SourceECInstanceId from meta.ClassHasAllBaseClasses where TargetECInstanceId = (select ECInstanceId from meta.ECClassDef where Name='${fullClassName[1]}'
+                this._iModel.withPreparedStatement(`select SourceECInstanceId from meta.ClassHasAllBaseClasses where TargetECInstanceId = (select ECInstanceId from meta.ECClassDef where Name='${fullClassName[1]}'
         and Schema.Id = (select ECInstanceId from meta.ECSchemaDef where Name='${fullClassName[0]}')) and SourceECInstanceId != TargetECInstanceId`, (statement) => {
                     while (statement.step() === core_bentley_1.DbResult.BE_SQLITE_ROW)
                         classIds.push(statement.getValue(0).getId());
@@ -1889,10 +1940,10 @@ IModelDb._settingPropNamespace = "settings";
                 return [];
             }
             // Execute an instance query to retrieve all aspects from all the derived classes
-            const aspects = this.runInstanceQuery(`SELECT $ FROM (
-        SELECT ECInstanceId, ECClassId FROM Bis.ElementMultiAspect WHERE Element.Id = :elementId AND ECClassId IN (${classIdList})
-          UNION ALL
-        SELECT ECInstanceId, ECClassId FROM Bis.ElementUniqueAspect WHERE Element.Id = :elementId AND ECClassId IN (${classIdList})
+            const aspects = this.runInstanceQuery(`SELECT $ FROM (
+        SELECT ECInstanceId, ECClassId FROM Bis.ElementMultiAspect WHERE Element.Id = :elementId AND ECClassId IN (${classIdList})
+          UNION ALL
+        SELECT ECInstanceId, ECClassId FROM Bis.ElementUniqueAspect WHERE Element.Id = :elementId AND ECClassId IN (${classIdList})
         ) OPTIONS USE_JS_PROP_NAMES DO_NOT_TRUNCATE_BLOB`, elementId, excludedClassFullNames);
             if (aspects.length === 0)
                 core_bentley_1.Logger.logInfo(BackendLoggerCategory_1.BackendLoggerCategory.ECDb, `No aspects found for class ${aspectClassFullName} and element ${elementId}`);
@@ -1907,7 +1958,7 @@ IModelDb._settingPropNamespace = "settings";
          */
         insertAspect(aspectProps) {
             try {
-                return this._iModel.nativeDb.insertElementAspect(aspectProps);
+                return this._iModel[Symbols_1._nativeDb].insertElementAspect(aspectProps);
             }
             catch (err) {
                 throw new core_common_1.IModelError(err.errorNumber, `Error inserting ElementAspect [${err.message}], class: ${aspectProps.classFullName}`);
@@ -1919,7 +1970,7 @@ IModelDb._settingPropNamespace = "settings";
          */
         updateAspect(aspectProps) {
             try {
-                this._iModel.nativeDb.updateElementAspect(aspectProps);
+                this._iModel[Symbols_1._nativeDb].updateElementAspect(aspectProps);
             }
             catch (err) {
                 throw new core_common_1.IModelError(err.errorNumber, `Error updating ElementAspect [${err.message}], id: ${aspectProps.id}`);
@@ -1933,7 +1984,7 @@ IModelDb._settingPropNamespace = "settings";
             const iModel = this._iModel;
             core_bentley_1.Id64.toIdSet(aspectInstanceIds).forEach((aspectInstanceId) => {
                 try {
-                    iModel.nativeDb.deleteElementAspect(aspectInstanceId);
+                    iModel[Symbols_1._nativeDb].deleteElementAspect(aspectInstanceId);
                 }
                 catch (err) {
                     throw new core_common_1.IModelError(err.errorNumber, `Error deleting ElementAspect [${err.message}], id: ${aspectInstanceId}`);
@@ -1972,7 +2023,6 @@ IModelDb._settingPropNamespace = "settings";
             }
             const accessToken = await CloudSqlite_1.CloudSqlite.requestToken({
                 ...props,
-                userToken: args.userToken,
                 accessLevel: args.accessLevel,
             });
             if (!this._viewStore)
@@ -2079,7 +2129,7 @@ IModelDb._settingPropNamespace = "settings";
             const viewStateData = this.loadViewData(viewDefinitionId, options);
             const baseModelId = viewStateData.viewDefinitionProps.baseModelId;
             if (baseModelId) {
-                const drawingExtents = core_geometry_1.Range3d.fromJSON(this._iModel.nativeDb.queryModelExtents({ id: baseModelId }).modelExtents);
+                const drawingExtents = core_geometry_1.Range3d.fromJSON(this._iModel[Symbols_1._nativeDb].queryModelExtents({ id: baseModelId }).modelExtents);
                 if (!drawingExtents.isNull)
                     viewStateData.modelExtents = drawingExtents.toJSON();
             }
@@ -2107,11 +2157,11 @@ IModelDb._settingPropNamespace = "settings";
          */
         getThumbnail(viewDefinitionId) {
             const viewArg = this.getViewThumbnailArg(viewDefinitionId);
-            const sizeProps = this._iModel.nativeDb.queryFileProperty(viewArg, true);
+            const sizeProps = this._iModel[Symbols_1._nativeDb].queryFileProperty(viewArg, true);
             if (undefined === sizeProps)
                 return undefined;
             const out = JSON.parse(sizeProps);
-            out.image = this._iModel.nativeDb.queryFileProperty(viewArg, false);
+            out.image = this._iModel[Symbols_1._nativeDb].queryFileProperty(viewArg, false);
             return out;
         }
         /** Save a thumbnail for a view.
@@ -2122,7 +2172,7 @@ IModelDb._settingPropNamespace = "settings";
         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);
+            this._iModel[Symbols_1._nativeDb].saveFileProperty(viewArg, JSON.stringify(props), thumbnail.image);
             return 0;
         }
         /** Set the default view property the iModel.
@@ -2162,7 +2212,7 @@ IModelDb._settingPropNamespace = "settings";
         /** @internal */
         async requestTileTreeProps(id) {
             return new Promise((resolve, reject) => {
-                this._iModel.nativeDb.getTileTree(id, (ret) => {
+                this._iModel[Symbols_1._nativeDb].getTileTree(id, (ret) => {
                     if (undefined !== ret.error)
                         reject(new core_common_1.IModelError(ret.error.status, `TreeId=${id}`));
                     else
@@ -2173,7 +2223,7 @@ IModelDb._settingPropNamespace = "settings";
         pollTileContent(resolve, reject, treeId, tileId) {
             let ret;
             try {
-                ret = this._iModel.nativeDb.pollTileContent(treeId, tileId);
+                ret = this._iModel[Symbols_1._nativeDb].pollTileContent(treeId, tileId);
             }
             catch (err) {
                 // Typically "imodel not open".
@@ -2212,7 +2262,7 @@ IModelDb._settingPropNamespace = "settings";
         /** @internal */
         async getTileContent(treeId, tileId) {
             const ret = await new Promise((resolve) => {
-                this._iModel.nativeDb.getTileContent(treeId, tileId, resolve);
+                this._iModel[Symbols_1._nativeDb].getTileContent(treeId, tileId, resolve);
             });
             if (undefined !== ret.error) {
                 throw new core_common_1.IModelError(ret.error.status, `TreeId=${treeId} TileId=${tileId}`);
@@ -2251,12 +2301,12 @@ class BriefcaseDb extends IModelDb {
      * - 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.nativeDb.isReadonly() && (this.briefcaseId !== core_common_1.BriefcaseIdValue.Unassigned) && (undefined === this.nativeDb.queryLocalValue(BriefcaseLocalValue.NoLocking));
+        return !this[Symbols_1._nativeDb].isReadonly() && (this.briefcaseId !== core_common_1.BriefcaseIdValue.Unassigned) && (undefined === this[Symbols_1._nativeDb].queryLocalValue(BriefcaseLocalValue.NoLocking));
     }
     // if the iModel uses a lock server, create a ServerBasedLocks LockControl for this BriefcaseDb.
     makeLockControl() {
         if (this.useLockServer)
-            this._locks = new ServerBasedLocks_1.ServerBasedLocks(this);
+            this._locks = (0, ServerBasedLocks_1.createServerBasedLocks)(this);
     }
     constructor(args) {
         super({ ...args, changeset: args.nativeDb.getCurrentChangeset() });
@@ -2278,14 +2328,14 @@ class BriefcaseDb extends IModelDb {
         };
         const isSchemaSyncEnabled = await withBriefcaseDb(briefcase, async (db) => {
             await SchemaSync_1.SchemaSync.pull(db);
-            return db.nativeDb.schemaSyncEnabled();
+            return db[Symbols_1._nativeDb].schemaSyncEnabled();
         });
         if (isSchemaSyncEnabled) {
             await SchemaSync_1.SchemaSync.withLockedAccess(briefcase, { openMode: core_bentley_1.OpenMode.Readonly, operationName: "schema sync" }, async (syncAccess) => {
                 const schemaSyncDbUri = syncAccess.getUri();
                 executeUpgrade();
                 await withBriefcaseDb(briefcase, async (db) => {
-                    db.nativeDb.schemaSyncPush(schemaSyncDbUri);
+                    db[Symbols_1._nativeDb].schemaSyncPush(schemaSyncDbUri);
                     db.saveChanges();
                 });
                 syncAccess.synchronizeWithCloud();
@@ -2327,7 +2377,7 @@ class BriefcaseDb extends IModelDb {
                     await this.doUpgrade(briefcase, { domain: core_common_1.DomainOptions.Upgrade, schemaLockHeld: true }, "Upgraded domain schemas");
                 }
                 finally {
-                    await withBriefcaseDb(briefcase, async (db) => db.locks.releaseAllLocks());
+                    await withBriefcaseDb(briefcase, async (db) => db.locks[Symbols_1._releaseAllLocks]());
                 }
                 return;
             }
@@ -2344,7 +2394,7 @@ class BriefcaseDb extends IModelDb {
                     await this.doUpgrade(briefcase, { domain: core_common_1.DomainOptions.Upgrade, schemaLockHeld: true }, "Upgraded domain schemas");
                 }
                 finally {
-                    await withBriefcaseDb(briefcase, async (db) => db.locks.releaseAllLocks());
+                    await withBriefcaseDb(briefcase, async (db) => db.locks[Symbols_1._releaseAllLocks]());
                 }
             }
             throw error;
@@ -2368,26 +2418,44 @@ class BriefcaseDb extends IModelDb {
             // Restart default txn to trigger events when watch file is changed by some other process.
             const watcher = fs.watch(briefcaseDb.watchFilePathName, { persistent: false }, () => {
                 nativeDb.restartDefaultTxn();
+                briefcaseDb.changeset = briefcaseDb[Symbols_1._nativeDb].getCurrentChangeset();
             });
             // Stop the watcher when we close this connection.
             briefcaseDb.onBeforeClose.addOnce(() => {
                 watcher.close();
             });
         }
+        // load all of the settings from workspaces
+        await briefcaseDb.loadWorkspaceSettings();
         if (openMode === core_bentley_1.OpenMode.ReadWrite && CodeService_1.CodeService.createForIModel) {
             try {
                 briefcaseDb._codeService = await CodeService_1.CodeService.createForIModel(briefcaseDb);
                 this.onCodeServiceCreated.raiseEvent(briefcaseDb);
             }
             catch (e) {
-                if (e.errorId !== "NoCodeIndex") // no code index means iModel isn't enforcing codes.
-                    throw e;
+                if (e.errorId !== "NoCodeIndex") { // no code index means iModel isn't enforcing codes.
+                    core_bentley_1.Logger.logWarning(loggerCategory, `The CodeService is not available for this briefcase: errorId: ${e.errorId}, errorMessage; ${e.message}. Proceeding with BriefcaseDb.open(), but all operations involving codes will fail.`);
+                    briefcaseDb._codeService = {
+                        verifyCode: (props) => {
+                            if (!core_common_1.Code.isEmpty(props.props.code)) {
+                                e.message = `The CodeService is not available for this briefcase: errorId: ${e.errorId}, errorMessage; ${e.message}.`;
+                                throw e;
+                            }
+                        },
+                        appParams: {
+                            author: { name: "unknown" },
+                            origin: { name: "unknown" },
+                        },
+                        close: () => { },
+                        initialize: async () => { },
+                    };
+                }
             }
         }
         this.onOpened.raiseEvent(briefcaseDb, args);
         return briefcaseDb;
     }
-    /* This is called by native code when applying a changeset */
+    /**  This is called by native code when applying a changeset */
     onChangesetConflict(args) {
         // returning undefined will result in native handler to resolve conflict
         const category = "DgnCore";
@@ -2470,7 +2538,7 @@ class BriefcaseDb extends IModelDb {
             const nConflicts = args.getForeignKeyConflicts();
             // Note: There is no performance implication of follow code as it happen toward end of
             // apply_changeset only once so we be querying value for 'DebugAllowFkViolations' only once.
-            if (this.nativeDb.queryLocalValue("DebugAllowFkViolations")) {
+            if (this[Symbols_1._nativeDb].queryLocalValue("DebugAllowFkViolations")) {
                 core_bentley_1.Logger.logError(category, `Detected ${nConflicts} foreign key conflicts in changeset. Continuing merge as 'DebugAllowFkViolations' flag is set. Run 'PRAGMA foreign_key_check' to get list of violations.`);
                 return core_bentley_1.DbConflictResolution.Skip;
             }
@@ -2518,7 +2586,6 @@ class BriefcaseDb extends IModelDb {
          * + Also see comments in TxnManager::MergeDataChanges()
          */
         if (core_bentley_1.Logger.isEnabled(category, core_bentley_1.LogLevel.Info)) {
-            core_bentley_1.Logger.logInfo(category, "------------------------------------------------------------------");
             core_bentley_1.Logger.logInfo(category, `Conflict detected - Cause: ${interpretConflictCause(args.cause)}`);
             args.dump();
             core_bentley_1.Logger.logInfo(category, "Conflicting resolved by replacing the existing entry with the change");
@@ -2529,7 +2596,7 @@ class BriefcaseDb extends IModelDb {
      * Execute the supplied function.
      * If the briefcase was read-only, reopen the native briefcase as read-only.
      * @note this._openMode is not changed from its initial value.
-     * @internal Exported strictly for tests.
+     * @internal Exported strictly for tests
      */
     async executeWritable(func) {
         const fileName = this.pathName;
@@ -2546,7 +2613,7 @@ class BriefcaseDb extends IModelDb {
         finally {
             if (isReadonly) {
                 if (locks !== this._locks) { // did we have to create a ServerBasedLocks?
-                    this.locks.close(); // yes, close it and reset back to previous
+                    this.locks[Symbols_1._close](); // yes, close it and reset back to previous
                     this._locks = locks;
                 }
                 this.closeAndReopen(core_bentley_1.OpenMode.Readonly, fileName);
@@ -2557,10 +2624,15 @@ class BriefcaseDb extends IModelDb {
         // Unclosed statements will produce BUSY error when attempting to close.
         this.clearCaches();
         // The following resets the native db's pointer to this JavaScript object.
-        this.nativeDb.closeFile();
-        this.nativeDb.openIModel(fileName, openMode);
+        this[Symbols_1._nativeDb].closeFile();
+        this[Symbols_1._nativeDb].openIModel(fileName, openMode);
         // Restore the native db's pointer to this JavaScript object.
-        this.nativeDb.setIModelDb(this);
+        this[Symbols_1._nativeDb].setIModelDb(this);
+        // refresh cached properties that could have been changed by another process writing to the same briefcase
+        this.changeset = this[Symbols_1._nativeDb].getCurrentChangeset();
+        // assert what should never change
+        if (this.iModelId !== this[Symbols_1._nativeDb].getIModelId() || this.iTwinId !== this[Symbols_1._nativeDb].getITwinId())
+            throw new Error("closeAndReopen detected change in iModelId and/or iTwinId");
     }
     /** Pull and apply changesets from iModelHub */
     async pullChanges(arg) {
@@ -2570,15 +2642,22 @@ class BriefcaseDb extends IModelDb {
             this.initializeIModelDb();
         });
         IpcHost_1.IpcHost.notifyTxns(this, "notifyPulledChanges", this.changeset);
+        this.txns.touchWatchFile();
     }
     /** Push changes to iModelHub. */
     async pushChanges(arg) {
         if (this.briefcaseId === core_common_1.BriefcaseIdValue.Unassigned)
             return;
-        if (this.nativeDb.hasUnsavedChanges())
+        if (this[Symbols_1._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
+        }
+        else if (!this[Symbols_1._nativeDb].hasPendingTxns()) {
+            // Nothing to push.
+            if (!arg.retainLocks) {
+                await this.locks.releaseAllLocks();
+            }
+            return;
+        }
         // pushing changes requires a writeable briefcase
         await this.executeWritable(async () => {
             await BriefcaseManager_1.BriefcaseManager.pullMergePush(this, arg);
@@ -2586,6 +2665,7 @@ class BriefcaseDb extends IModelDb {
         });
         const changeset = this.changeset;
         IpcHost_1.IpcHost.notifyTxns(this, "notifyPushedChanges", changeset);
+        this.txns.touchWatchFile();
     }
     close() {
         super.close();
@@ -2630,7 +2710,7 @@ class RefreshV2CheckpointSas {
         core_bentley_1.Logger.logInfo(BackendLoggerCategory_1.BackendLoggerCategory.Authorization, "attempting to refresh sasToken for checkpoint");
         try {
             // this exchanges the supplied user accessToken for an expiring blob-store token to read the checkpoint.
-            const container = iModel.nativeDb.cloudContainer;
+            const container = iModel[Symbols_1._nativeDb].cloudContainer;
             if (!container)
                 throw new Error("checkpoint is not from a cloud container");
             (0, core_bentley_1.assert)(undefined !== iModel.iTwinId);
@@ -2680,14 +2760,14 @@ class SnapshotDb extends IModelDb {
     }
     /** 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.
+     * @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();
+        const nativeDb = new NativePlatform_1.IModelNative.platform.DgnDb();
         nativeDb.createIModel(filePath, options);
         nativeDb.resetBriefcaseId(core_common_1.BriefcaseIdValue.Unassigned);
         const snapshotDb = new SnapshotDb(nativeDb, core_bentley_1.Guid.createValue());
@@ -2698,7 +2778,7 @@ class SnapshotDb extends IModelDb {
     }
     /** 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.
+     * @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.
@@ -2708,7 +2788,7 @@ class SnapshotDb extends IModelDb {
     static createFrom(iModelDb, snapshotFile, options) {
         iModelDb.performCheckpoint();
         IModelJsFs_1.IModelJsFs.copySync(iModelDb.pathName, snapshotFile);
-        const nativeDb = new IModelHost_1.IModelHost.platform.DgnDb();
+        const nativeDb = new NativePlatform_1.IModelNative.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
@@ -2741,7 +2821,11 @@ class SnapshotDb extends IModelDb {
     static openFile(path, opts) {
         this.onOpen.raiseEvent(path, opts);
         const file = { path, key: opts?.key };
+        const wasKeyUndefined = opts?.key === undefined;
         const nativeDb = this.openDgnDb(file, core_bentley_1.OpenMode.Readonly, undefined, opts);
+        if (wasKeyUndefined) {
+            file.key = `${nativeDb.getIModelId()}:${nativeDb.getCurrentChangeset().id}`;
+        }
         (0, core_bentley_1.assert)(undefined !== file.key);
         const db = new SnapshotDb(nativeDb, file.key);
         this.onOpened.raiseEvent(db);
@@ -2750,7 +2834,9 @@ class SnapshotDb extends IModelDb {
     static async attachAndOpenCheckpoint(checkpoint) {
         const { dbName, container } = await CheckpointManager_1.V2CheckpointManager.attach(checkpoint);
         const key = CheckpointManager_1.CheckpointManager.getKey(checkpoint);
-        return SnapshotDb.openFile(dbName, { key, container });
+        const db = SnapshotDb.openFile(dbName, { key, container });
+        await db.loadWorkspaceSettings();
+        return db;
     }
     /** @internal */
     static async openCheckpointFromRpc(checkpoint) {
@@ -2768,7 +2854,7 @@ class SnapshotDb extends IModelDb {
             snapshot.restartDefaultTxn();
         }, (10 * 60) * 1000).unref(); // 10 minutes
         // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
-        snapshot._refreshSas = new RefreshV2CheckpointSas(snapshot.nativeDb.cloudContainer.accessToken, checkpoint.reattachSafetySeconds);
+        snapshot._refreshSas = new RefreshV2CheckpointSas(snapshot[Symbols_1._nativeDb].cloudContainer.accessToken, checkpoint.reattachSafetySeconds);
         return snapshot;
     }
     /**
@@ -2792,7 +2878,7 @@ class SnapshotDb extends IModelDb {
         if (this._restartDefaultTxnTimer)
             clearTimeout(this._restartDefaultTxnTimer);
         if (this._createClassViewsOnClose) { // check for flag set during create
-            if (core_bentley_1.BentleyStatus.SUCCESS !== this.nativeDb.createClassViewsInDb()) {
+            if (core_bentley_1.BentleyStatus.SUCCESS !== this[Symbols_1._nativeDb].createClassViewsInDb()) {
                 throw new core_common_1.IModelError(core_bentley_1.IModelStatus.SQLiteError, "Error creating class views");
             }
             else {
@@ -2836,7 +2922,7 @@ class StandaloneDb extends BriefcaseDb {
      * @param args The parameters that define the new iModel
      */
     static createEmpty(filePath, args) {
-        const nativeDb = new IModelHost_1.IModelHost.platform.DgnDb();
+        const nativeDb = new NativePlatform_1.IModelNative.platform.DgnDb();
         nativeDb.createIModel(filePath, args);
         nativeDb.saveLocalValue(BriefcaseLocalValue.StandaloneEdit, args.allowEdit);
         nativeDb.setITwinId(core_bentley_1.Guid.empty);
@@ -2868,7 +2954,7 @@ class StandaloneDb extends BriefcaseDb {
      * @beta
      */
     createClassViews() {
-        const result = this.nativeDb.createClassViewsInDb();
+        const result = this[Symbols_1._nativeDb].createClassViewsInDb();
         if (core_bentley_1.BentleyStatus.SUCCESS !== result)
             throw new core_common_1.IModelError(result, "Error creating class views");
         else