@itwin/core-backend 4.8.0-dev.2 → 4.8.0-dev.21

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() {
@@ -176,12 +166,12 @@ 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. */
@@ -199,7 +189,7 @@ class IModelDb extends core_common_1.IModel {
             this.nativeDb.closeFile();
         };
         this.nativeDb.setIModelDb(this);
-        this.loadSettingDictionaries();
+        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,7 +212,7 @@ 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;
@@ -498,7 +488,32 @@ class IModelDb extends core_common_1.IModel {
         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
@@ -627,7 +642,9 @@ class IModelDb extends core_common_1.IModel {
             this.nativeDb.performCheckpoint();
         }
     }
-    /** @internal */
+    /** @internal
+     * @deprecated in 4.8. Use `txns.reverseTxns`.
+     */
     reverseTxns(numOperations) {
         return this.nativeDb.reverseTxns(numOperations);
     }
@@ -780,7 +797,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
@@ -1045,7 +1062,7 @@ class IModelDb extends core_common_1.IModel {
     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
@@ -1182,24 +1199,54 @@ class IModelDb extends core_common_1.IModel {
         this.saveChanges("delete settings");
     }
     /** Load all setting dictionaries in this iModel into `this.workspace.settings` */
-    loadSettingDictionaries() {
+    loadIModelSettings() {
         if (!this.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() {
@@ -1854,9 +1901,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}`);
@@ -1874,7 +1921,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 +1936,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}`);
@@ -1972,7 +2019,6 @@ IModelDb._settingPropNamespace = "settings";
             }
             const accessToken = await CloudSqlite_1.CloudSqlite.requestToken({
                 ...props,
-                userToken: args.userToken,
                 accessLevel: args.accessLevel,
             });
             if (!this._viewStore)
@@ -2256,7 +2302,7 @@ class BriefcaseDb extends IModelDb {
     // 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() });
@@ -2327,7 +2373,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 +2390,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 +2414,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.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";
@@ -2518,7 +2582,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 +2592,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 +2609,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);
@@ -2561,6 +2624,11 @@ class BriefcaseDb extends IModelDb {
         this.nativeDb.openIModel(fileName, openMode);
         // Restore the native db's pointer to this JavaScript object.
         this.nativeDb.setIModelDb(this);
+        // refresh cached properties that could have been changed by another process writing to the same briefcase
+        this.changeset = this.nativeDb.getCurrentChangeset();
+        // assert what should never change
+        if (this.iModelId !== this.nativeDb.getIModelId() || this.iTwinId !== this.nativeDb.getITwinId())
+            throw new Error("closeAndReopen detected change in iModelId and/or iTwinId");
     }
     /** Pull and apply changesets from iModelHub */
     async pullChanges(arg) {
@@ -2570,6 +2638,7 @@ class BriefcaseDb extends IModelDb {
             this.initializeIModelDb();
         });
         IpcHost_1.IpcHost.notifyTxns(this, "notifyPulledChanges", this.changeset);
+        this.txns.touchWatchFile();
     }
     /** Push changes to iModelHub. */
     async pushChanges(arg) {
@@ -2586,6 +2655,7 @@ class BriefcaseDb extends IModelDb {
         });
         const changeset = this.changeset;
         IpcHost_1.IpcHost.notifyTxns(this, "notifyPushedChanges", changeset);
+        this.txns.touchWatchFile();
     }
     close() {
         super.close();
@@ -2680,14 +2750,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 +2768,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 +2778,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 +2811,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 +2824,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) {
@@ -2836,7 +2912,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);