@itwin/core-backend 4.0.0-dev.80 → 4.0.0-dev.81

package/lib/cjs/IModelHost.d.ts

@@ -1,21 +1,22 @@
 /** @packageDocumentation
  * @module IModelHost
  */
+import "./IModelDb";
 import { IModelJsNative } from "@bentley/imodeljs-native";
-import { ServerStorage } from "@itwin/object-storage-core";
 import { AccessToken, BeEvent, GuidString, Mutable } from "@itwin/core-bentley";
 import { AuthorizationClient, LocalDirName, SessionProps } from "@itwin/core-common";
 import { TelemetryManager } from "@itwin/core-telemetry";
+import { ServerStorage } from "@itwin/object-storage-core";
 import { BackendHubAccess } from "./BackendHubAccess";
 import { TileStorage } from "./TileStorage";
 import { Workspace, WorkspaceOpts } from "./workspace/Workspace";
-/** @alpha */
+/** @internal */
 export interface CrashReportingConfigNameValuePair {
     name: string;
     value: string;
 }
 /** Configuration of the crash-reporting system.
- * @alpha
+ * @internal
  */
 export interface CrashReportingConfig {
     /** The directory to which *.dmp and/or iModelJsNativeCrash*.properties.txt files are written. This directory will be created if it does not already exist. */
@@ -51,6 +52,12 @@ export interface AzureBlobStorageCredentials {
  * @public
  */
 export interface IModelHostOptions {
+    /**
+     * The name of the *Profile* subdirectory of [[cacheDir]] for this process. If not present, "default" is used.
+     * @see [[IModelHost.profileName]]
+     * @beta
+     */
+    profileName?: string;
     /**
      * Root of the directory holding all the files that iTwin.js caches
      * - If not specified at startup a platform specific default is used -
@@ -59,10 +66,6 @@ export interface IModelHostOptions {
      *   - Linux:   $(HOMEDIR)/.cache/iModelJs/
      *   where $(HOMEDIR) is documented [here](https://nodejs.org/api/os.html#os_os_homedir)
      * - if specified, ensure it is set to a folder with read/write access.
-     * - Sub-folders within this folder organize various caches -
-     *   - bc/ -> Briefcases
-     *   - appSettings/ -> Offline application settings (only relevant in native applications)
-     *   - etc.
      * @see [[IModelHost.cacheDir]] for the value it's set to after startup
      */
     cacheDir?: LocalDirName;
@@ -123,7 +126,7 @@ export interface IModelHostOptions {
      */
     logTileSizeThreshold?: number;
     /** Crash-reporting configuration
-     * @alpha
+     * @internal
      */
     crashReportingConfig?: CrashReportingConfig;
     /** The AuthorizationClient used to obtain [AccessToken]($bentley)s. */
@@ -159,7 +162,7 @@ export declare class IModelHostConfiguration implements IModelHostOptions {
     logTileLoadTimeThreshold: number;
     /** @internal */
     logTileSizeThreshold: number;
-    /** @alpha */
+    /** @internal */
     crashReportingConfig?: CrashReportingConfig;
 }
 /** IModelHost initializes ($backend) and captures its configuration. A backend must call [[IModelHost.startup]] before using any backend classes.
@@ -173,12 +176,30 @@ export declare class IModelHost {
     /** @alpha */
     static readonly telemetry: TelemetryManager;
     static backendVersion: string;
+    private static _profileName;
     private static _cacheDir;
     private static _appWorkspace?;
     private static _platform?;
     /** @internal */
     static get platform(): typeof IModelJsNative;
     static configuration?: IModelHostOptions;
+    /**
+     * The name of the *Profile* directory (a subdirectory of "[[cacheDir]]/profiles/") for this process.
+     *
+     * The *Profile* directory is used to cache data that is specific to a type-of-usage of the iTwin.js library.
+     * It is important that information in the profile cache be consistent but isolated across sessions (i.e.
+     * data for a profile is maintained between runs, but each profile is completely independent and
+     * unaffected by the presence ot use of others.)
+     * @note **Only one process at a time may be using a given profile**, and an exception will be thrown by [[startup]]
+     * if a second process attempts to use the same profile.
+     * @beta
+     */
+    static get profileName(): string;
+    /** The full path of the Profile directory.
+     * @see [[profileName]]
+     * @beta
+     */
+    static get profileDir(): LocalDirName;
     /** Event raised during startup to allow loading settings data */
     static readonly onWorkspaceStartup: BeEvent<() => void>;
     /** Event raised just after the backend IModelHost was started */
@@ -217,10 +238,8 @@ export declare class IModelHost {
     static getAccessToken(): Promise<AccessToken>;
     /** @internal */
     static flushLog(): void;
-    /** @internal */
-    static loadNative(): void;
     private static syncNativeLogLevels;
-    private static registerPlatform;
+    private static loadNative;
     /** @internal */
     static tileStorage?: TileStorage;
     private static _hubAccess?;
@@ -238,7 +257,7 @@ export declare class IModelHost {
     static get hubAccess(): BackendHubAccess;
     private static initializeWorkspace;
     private static _isValid;
-    /** Returns true if IModelHost is started.  */
+    /** true between a successful call to [[startup]] and before [[shutdown]] */
     static get isValid(): boolean;
     /** This method must be called before any iTwin.js services are used.
      * @param options Host configuration data.
@@ -246,27 +265,23 @@ export declare class IModelHost {
      * @see [[shutdown]].
      */
     static startup(options?: IModelHostOptions): Promise<void>;
-    private static _briefcaseCacheDir;
-    private static logStartup;
-    private static setupHostDirs;
+    private static setupCacheDir;
     /** This method must be called when an iTwin.js host is shut down. Raises [[onBeforeShutdown]] */
     static shutdown(): Promise<void>;
+    private static doShutdown;
     /**
      * Add or update a property that should be included in a crash report.
-     * @param name The name of the property
-     * @param value The value of the property
-     * @alpha
+     * @internal
      */
     static setCrashReportProperty(name: string, value: string): void;
     /**
      * Remove a previously defined property so that will not be included in a crash report.
-     * @param name The name of the property
-     * @alpha
+     * @internal
      */
     static removeCrashReportProperty(name: string): void;
     /**
      * Get all properties that will be included in a crash report.
-     * @alpha
+     * @internal
      */
     static getCrashReportProperties(): CrashReportingConfigNameValuePair[];
     /** The directory where application assets may be found */
@@ -304,25 +319,23 @@ export declare class IModelHost {
         exactMatch?: boolean;
     }): string;
 }
-/** Information about the platform on which the app is running. Also see [[KnownLocations]] and [[IModelJsFs]].
+/** Information about the platform on which the app is running.
  * @public
  */
 export declare class Platform {
     /** Get the name of the platform. */
     static get platformName(): "win32" | "linux" | "darwin" | "ios" | "android" | "uwp";
-    /** @internal */
-    static load(): typeof IModelJsNative;
 }
-/** Well known directories that may be used by the application. Also see [[Platform]]
+/** Well known directories that may be used by the application.
  * @public
  */
 export declare class KnownLocations {
     /** The directory where the imodeljs-native assets are stored. */
-    static get nativeAssetsDir(): string;
+    static get nativeAssetsDir(): LocalDirName;
     /** The directory where the core-backend assets are stored. */
-    static get packageAssetsDir(): string;
+    static get packageAssetsDir(): LocalDirName;
     /** The temporary directory. */
-    static get tmpdir(): string;
+    static get tmpdir(): LocalDirName;
 }
 /** Extend this class to provide custom file name resolution behavior.
  * @note Only `tryResolveKey` and/or `tryResolveFileName` need to be overridden as the implementations of `resolveKey` and `resolveFileName` work for most purposes.

package/lib/cjs/IModelHost.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"IModelHost.d.ts","sourceRoot":"","sources":["../../src/IModelHost.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"IModelHost.d.ts","sourceRoot":"","sources":["../../src/IModelHost.ts"],"names":[],"mappings":"AAIA;;GAEG;AAGH,OAAO,YAAY,CAAC;AAGpB,OAAO,EAAE,cAAc,EAAiB,MAAM,0BAA0B,CAAC;AAEzE,OAAO,EAAE,WAAW,EAAU,OAAO,EAAkB,UAAU,EAAwB,OAAO,EAAmB,MAAM,qBAAqB,CAAC;AAC/I,OAAO,EAAE,mBAAmB,EAA8B,YAAY,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACjH,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEzD,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAetD,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAG5C,OAAO,EAAkB,SAAS,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAQjF,gBAAgB;AAChB,MAAM,WAAW,iCAAiC;IAChD,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,8JAA8J;IAC9J,QAAQ,EAAE,MAAM,CAAC;IACjB,sEAAsE;IACtE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,wOAAwO;IACxO,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,sFAAsF;IACtF,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,iLAAiL;IACjL,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,iHAAiH;IACjH,MAAM,CAAC,EAAE,iCAAiC,EAAE,CAAC;IAC7C;;;;;OAKG;IACH,2BAA2B,CAAC,EAAE,MAAM,CAAC;IACrC,iGAAiG;IACjG,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,YAAY;AACZ,MAAM,WAAW,2BAA2B;IAC1C,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;;;;;;;OASG;IACH,QAAQ,CAAC,EAAE,YAAY,CAAC;IAExB,wDAAwD;IACxD,YAAY,CAAC,EAAE,YAAY,CAAC;IAE5B;;;OAGG;IACH,SAAS,CAAC,EAAE,aAAa,CAAC;IAE1B;;;OAGG;IACH,SAAS,CAAC,EAAE,gBAAgB,CAAC;IAE7B;;OAEG;IACH,yBAAyB,CAAC,EAAE,2BAA2B,CAAC;IAExD;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,aAAa,CAAC;IAEjC;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAE5B;;OAEG;IACH,0BAA0B,CAAC,EAAE,OAAO,CAAC;IAErC;;OAEG;IACH,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAE9B;;OAEG;IACH,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAE9B;;OAEG;IACH,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAEhC;;OAEG;IACH,yBAAyB,CAAC,EAAE,MAAM,CAAC;IAEnC;;OAEG;IACH,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAElC;;OAEG;IACH,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAE9B;;OAEG;IACH,oBAAoB,CAAC,EAAE,oBAAoB,CAAC;IAE5C,uEAAuE;IACvE,mBAAmB,CAAC,EAAE,mBAAmB,CAAC;CAC3C;AAED;;GAEG;AACH,qBAAa,uBAAwB,YAAW,iBAAiB;IAC/D,OAAc,yBAAyB,SAAa;IACpD,OAAc,+BAA+B,SAAM;IACnD,OAAc,2BAA2B,SAAgB;IACzD,gBAAgB;IAChB,OAAc,yBAAyB,SAAsB;IAEtD,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,QAAQ,CAAC,EAAE,YAAY,CAAC;IAE/B,YAAY;IACL,SAAS,CAAC,EAAE,aAAa,CAAC;IACjC,YAAY;IACL,SAAS,CAAC,EAAE,gBAAgB,CAAC;IACpC,uEAAuE;IAChE,mBAAmB,CAAC,EAAE,mBAAmB,CAAC;IACjD,YAAY;IACL,0BAA0B,CAAC,EAAE,OAAO,CAAC;IACrC,mBAAmB,CAAC,EAAE,OAAO,CAAC;IACrC,YAAY;IACL,yBAAyB,CAAC,EAAE,2BAA2B,CAAC;IAC/D,gBAAgB;IACT,sBAAsB,SAAqD;IAClF,gBAAgB;IACT,yBAAyB,SAAqD;IACrF,gBAAgB;IACT,wBAAwB,SAA2D;IAC1F,gBAAgB;IACT,oBAAoB,SAAuD;IAClF,gBAAgB;IACT,oBAAoB,CAAC,EAAE,oBAAoB,CAAC;CACpD;AAmCD;;;GAGG;AACH,qBAAa,UAAU;IACrB,OAAO;IAEP,uEAAuE;IACvE,OAAc,mBAAmB,CAAC,EAAE,mBAAmB,CAAC;IAExD,aAAa;IACb,gBAAuB,SAAS,mBAA0B;IAE1D,OAAc,cAAc,SAAM;IAClC,OAAO,CAAC,MAAM,CAAC,YAAY,CAAS;IACpC,OAAO,CAAC,MAAM,CAAC,SAAS,CAAM;IAC9B,OAAO,CAAC,MAAM,CAAC,aAAa,CAAC,CAAY;IAEzC,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,CAAwB;IACjD,gBAAgB;IAChB,WAAkB,QAAQ,IAAI,OAAO,cAAc,CAIlD;IAED,OAAc,aAAa,CAAC,EAAE,iBAAiB,CAAC;IAEhD;;;;;;;;;;OAUG;IACH,WAAkB,WAAW,IAAI,MAAM,CAEtC;IAED;;;OAGG;IACH,WAAkB,UAAU,IAAI,YAAY,CAE3C;IAED,iEAAiE;IACjE,gBAAuB,kBAAkB,gBAAqB,IAAI,EAAI;IAEtE,iEAAiE;IACjE,gBAAuB,cAAc,gBAAqB,IAAI,EAAI;IAElE,yEAAyE;IACzE,gBAAuB,gBAAgB,gBAAqB,IAAI,EAAI;IAEpE,gBAAgB;IAChB,gBAAuB,OAAO,EAAE,OAAO,CAAC,YAAY,CAAC,CAAyE;IAE9H,kCAAkC;IAClC,WAAkB,SAAS,IACK,UAAU,CADsB;IAChE,WAAkB,SAAS,CAAC,EAAE,EAAE,UAAU,EAAkC;IAE5E,mJAAmJ;IACnJ,WAAkB,aAAa,IACK,MAAM,CAD8B;IACxE,WAAkB,aAAa,CAAC,EAAE,EAAE,MAAM,EAAsC;IAEhF,qJAAqJ;IACrJ,WAAkB,kBAAkB,IACU,MAAM,CAD8B;IAClF,WAAkB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAgD;IAEpG,wDAAwD;IACxD,WAAkB,QAAQ,IAAI,YAAY,CAA2B;IAErE;;;;;OAKG;IACH,WAAkB,YAAY,IAAI,SAAS,CAAgC;IAE3E,wGAAwG;IACxG,OAAc,wBAAwB,CAAC,EAAE,gBAAgB,CAAC;IAE1D;;;;;;OAMG;WACiB,cAAc,IAAI,OAAO,CAAC,WAAW,CAAC;IAQ1D,gBAAgB;WACF,QAAQ;IAItB,OAAO,CAAC,MAAM,CAAC,mBAAmB;IAGlC,OAAO,CAAC,MAAM,CAAC,UAAU;IA+BzB,gBAAgB;IAChB,OAAc,WAAW,CAAC,EAAE,WAAW,CAAC;IAExC,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,CAAmB;IAC7C,gBAAgB;WACF,YAAY,CAAC,SAAS,EAAE,gBAAgB,GAAG,SAAS;IAElE;;OAEG;WACW,YAAY,IAAI,gBAAgB,GAAG,SAAS;IAE1D;;;;OAIG;IACH,WAAkB,SAAS,IAAI,gBAAgB,CAI9C;IAED,OAAO,CAAC,MAAM,CAAC,mBAAmB;IAmBlC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAS;IAEhC,4EAA4E;IAC5E,WAAkB,OAAO,YAExB;IAED;;;;OAIG;WACiB,OAAO,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IA4CvE,OAAO,CAAC,MAAM,CAAC,aAAa;IAQ5B,iGAAiG;WAC7E,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;mBAMxB,UAAU;IAe/B;;;OAGG;WACW,sBAAsB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAIvE;;;OAGG;WACW,yBAAyB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAI3D;;;OAGG;WACW,wBAAwB,IAAI,iCAAiC,EAAE;IAI7E,0DAA0D;IAC1D,WAAkB,YAAY,IAAI,MAAM,GAAG,SAAS,CAEnD;IAED;;OAEG;IACH,WAAkB,sBAAsB,IAAI,MAAM,CAEjD;IACD;;OAEG;IACH,WAAkB,yBAAyB,IAAI,MAAM,CAEpD;IAED,2FAA2F;IAC3F,WAAkB,wBAAwB,IAAI,MAAM,CAEnD;IACD,4FAA4F;IAC5F,WAAkB,oBAAoB,IAAI,MAAM,CAE/C;IAED;;OAEG;IACH,WAAkB,sBAAsB,IAAI,OAAO,CAElD;IAED;;OAEG;IACH,WAAkB,0BAA0B,IAAI,OAAO,CAEtD;IAED;;OAEG;IACH,WAAkB,mBAAmB,IAAI,OAAO,CAE/C;IAED,OAAO,CAAC,MAAM,CAAC,cAAc;IAqB7B,OAAO,CAAC,MAAM,CAAC,mBAAmB;IAgBlC,gBAAgB;WACF,qBAAqB,CAAC,GAAG,EAAE;QAAE,aAAa,EAAE,MAAM,CAAC;QAAC,cAAc,EAAE,MAAM,EAAE,CAAC;QAAC,UAAU,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,MAAM;CAG5H;AAED;;GAEG;AACH,qBAAa,QAAQ;IACnB,oCAAoC;IACpC,WAAkB,YAAY,IAAI,OAAO,GAAG,OAAO,GAAG,QAAQ,GAAG,KAAK,GAAG,SAAS,GAAG,KAAK,CAEzF;CACF;AAED;;GAEG;AACH,qBAAa,cAAc;IAEzB,iEAAiE;IACjE,WAAkB,eAAe,IAAI,YAAY,CAEhD;IAED,8DAA8D;IAC9D,WAAkB,gBAAgB,IAAI,YAAY,CAEjD;IAED,+BAA+B;IAC/B,WAAkB,MAAM,IAAI,YAAY,CAEvC;CACF;AAED;;;;GAIG;AACH,8BAAsB,gBAAgB;IACpC;;;OAGG;IACI,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAC1D;;;;OAIG;IACI,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IAO1C;;;OAGG;IACI,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IACjE;;;;OAIG;IACI,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM;CAOnD"}

package/lib/cjs/IModelHost.js

@@ -8,19 +8,20 @@
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.FileNameResolver = exports.KnownLocations = exports.Platform = exports.IModelHost = exports.IModelHostConfiguration = void 0;
+// To avoid circular load errors, the "Element" classes must be loaded before IModelHost.
+require("./IModelDb"); // DO NOT REMOVE OR MOVE THIS LINE!
+const os = require("os");
 const imodeljs_native_1 = require("@bentley/imodeljs-native");
-const object_storage_azure_1 = require("@itwin/object-storage-azure");
 const cloud_agnostic_core_1 = require("@itwin/cloud-agnostic-core");
-const object_storage_core_1 = require("@itwin/object-storage-core");
 const core_bentley_1 = require("@itwin/core-bentley");
 const core_common_1 = require("@itwin/core-common");
 const core_telemetry_1 = require("@itwin/core-telemetry");
-const inversify_1 = require("inversify");
-const os = require("os");
-const path = require("path");
+const object_storage_azure_1 = require("@itwin/object-storage-azure");
+const object_storage_core_1 = require("@itwin/object-storage-core");
 const BackendLoggerCategory_1 = require("./BackendLoggerCategory");
 const BisCoreSchema_1 = require("./BisCoreSchema");
 const BriefcaseManager_1 = require("./BriefcaseManager");
+const CloudSqlite_1 = require("./CloudSqlite");
 const FunctionalSchema_1 = require("./domains/FunctionalSchema");
 const GenericSchema_1 = require("./domains/GenericSchema");
 const GeoCoordConfig_1 = require("./GeoCoordConfig");
@@ -35,6 +36,8 @@ const TileStorage_1 = require("./TileStorage");
 const Settings_1 = require("./workspace/Settings");
 const SettingsSchemas_1 = require("./workspace/SettingsSchemas");
 const Workspace_1 = require("./workspace/Workspace");
+const inversify_1 = require("inversify");
+const path_1 = require("path");
 const loggerCategory = BackendLoggerCategory_1.BackendLoggerCategory.IModelHost;
 /** Configuration of core-backend.
  * @public
@@ -98,6 +101,27 @@ class IModelHost {
             throw new Error("IModelHost.startup must be called first");
         return this._platform;
     }
+    /**
+     * The name of the *Profile* directory (a subdirectory of "[[cacheDir]]/profiles/") for this process.
+     *
+     * The *Profile* directory is used to cache data that is specific to a type-of-usage of the iTwin.js library.
+     * It is important that information in the profile cache be consistent but isolated across sessions (i.e.
+     * data for a profile is maintained between runs, but each profile is completely independent and
+     * unaffected by the presence ot use of others.)
+     * @note **Only one process at a time may be using a given profile**, and an exception will be thrown by [[startup]]
+     * if a second process attempts to use the same profile.
+     * @beta
+     */
+    static get profileName() {
+        return this._profileName;
+    }
+    /** The full path of the Profile directory.
+     * @see [[profileName]]
+     * @beta
+     */
+    static get profileDir() {
+        return (0, path_1.join)(this._cacheDir, "profiles", this._profileName);
+    }
     /** A uniqueId for this session */
     static get sessionId() { return this.session.sessionId; }
     static set sessionId(id) { this.session.sessionId = id; }
@@ -125,7 +149,7 @@ class IModelHost {
      */
     static async getAccessToken() {
         try {
-            return (await this.authorizationClient?.getAccessToken()) ?? "";
+            return (await IModelHost.authorizationClient?.getAccessToken()) ?? "";
         }
         catch (e) {
             return "";
@@ -133,22 +157,37 @@ class IModelHost {
     }
     /** @internal */
     static flushLog() {
-        return this.platform.flushLog();
-    }
-    /** @internal */
-    static loadNative() {
-        const platform = Platform.load();
-        this.registerPlatform(platform);
+        return IModelHost.platform.flushLog();
     }
     static syncNativeLogLevels() {
         this.platform.clearLogLevelCache();
     }
-    static registerPlatform(platform) {
-        this._platform = platform;
-        if (undefined === platform)
+    static loadNative(options) {
+        if (undefined !== this._platform)
             return;
-        platform.logger = core_bentley_1.Logger;
-        core_bentley_1.Logger.logLevelChangedFn = () => IModelHost.syncNativeLogLevels();
+        this._platform = core_bentley_1.ProcessDetector.isMobileAppBackend ? process._linkedBinding("iModelJsNative") : imodeljs_native_1.NativeLibrary.load();
+        this._platform.logger = core_bentley_1.Logger;
+        core_bentley_1.Logger.logLevelChangedFn = () => IModelHost.syncNativeLogLevels(); // the arrow function exists only so that it can be spied in tests
+        if (options.crashReportingConfig && options.crashReportingConfig.crashDir && !core_bentley_1.ProcessDetector.isElectronAppBackend && !core_bentley_1.ProcessDetector.isMobileAppBackend) {
+            this.platform.setCrashReporting(options.crashReportingConfig);
+            core_bentley_1.Logger.logTrace(loggerCategory, "Configured crash reporting", {
+                enableCrashDumps: options.crashReportingConfig?.enableCrashDumps,
+                wantFullMemoryDumps: options.crashReportingConfig?.wantFullMemoryDumps,
+                enableNodeReport: options.crashReportingConfig?.enableNodeReport,
+                uploadToBentley: options.crashReportingConfig?.uploadToBentley,
+            });
+            if (options.crashReportingConfig.enableNodeReport) {
+                if (process.report !== undefined) {
+                    process.report.reportOnFatalError = true;
+                    process.report.reportOnUncaughtException = true;
+                    process.report.directory = options.crashReportingConfig.crashDir;
+                    core_bentley_1.Logger.logTrace(loggerCategory, "Configured Node.js crash reporting");
+                }
+                else {
+                    core_bentley_1.Logger.logWarning(loggerCategory, "Unable to configure Node.js crash reporting");
+                }
+            }
+        }
     }
     /** @internal */
     static setHubAccess(hubAccess) { this._hubAccess = hubAccess; }
@@ -162,21 +201,30 @@ class IModelHost {
      * To determine whether one is present, use [[getHubAccess]].
      */
     static get hubAccess() {
-        if (this._hubAccess === undefined)
+        if (IModelHost._hubAccess === undefined)
             throw new core_common_1.IModelError(core_bentley_1.IModelStatus.BadRequest, "No BackendHubAccess supplied in IModelHostOptions");
-        return this._hubAccess;
+        return IModelHost._hubAccess;
     }
     static initializeWorkspace(configuration) {
-        const settingAssets = path.join(KnownLocations.packageAssetsDir, "Settings");
-        SettingsSchemas_1.SettingsSchemas.addDirectory(path.join(settingAssets, "Schemas"));
+        const settingAssets = (0, path_1.join)(KnownLocations.packageAssetsDir, "Settings");
+        SettingsSchemas_1.SettingsSchemas.addDirectory((0, path_1.join)(settingAssets, "Schemas"));
         this._appWorkspace = new Workspace_1.ITwinWorkspace(new ApplicationSettings(), configuration.workspace);
+        // Create the CloudCache for Workspaces. This will fail if another process is already using the same profile.
+        try {
+            this.appWorkspace.getCloudCache();
+        }
+        catch (e) {
+            throw (e.errorNumber === core_bentley_1.DbResult.BE_SQLITE_BUSY) ? new core_common_1.IModelError(core_bentley_1.DbResult.BE_SQLITE_BUSY, `Profile [${this.profileDir}] is already in use by another process`) : e;
+        }
         this.appWorkspace.settings.addDirectory(settingAssets, Settings_1.SettingsPriority.defaults);
         GeoCoordConfig_1.GeoCoordConfig.onStartup();
         // allow applications to load their default settings
         this.onWorkspaceStartup.raiseEvent();
     }
-    /** Returns true if IModelHost is started.  */
-    static get isValid() { return this._isValid; }
+    /** true between a successful call to [[startup]] and before [[shutdown]] */
+    static get isValid() {
+        return IModelHost._isValid;
+    }
     /** This method must be called before any iTwin.js services are used.
      * @param options Host configuration data.
      * Raises [[onAfterStartup]].
@@ -187,44 +235,15 @@ class IModelHost {
             return; // we're already initialized
         this._isValid = true;
         options = options ?? {};
-        if (IModelHost.sessionId === "")
-            IModelHost.sessionId = core_bentley_1.Guid.createValue();
+        if (this.sessionId === "")
+            this.sessionId = core_bentley_1.Guid.createValue();
         this.authorizationClient = options.authorizationClient;
-        this.logStartup();
         this.backendVersion = require("../../package.json").version; // eslint-disable-line @typescript-eslint/no-var-requires
         (0, RpcBackend_1.initializeRpcBackend)(options.enableOpenTelemetry);
-        if (this._platform === undefined) {
-            try {
-                this.loadNative();
-            }
-            catch (error) {
-                core_bentley_1.Logger.logError(loggerCategory, "Error registering/loading the native platform API", () => (options));
-                throw error;
-            }
-        }
-        if (options.crashReportingConfig && options.crashReportingConfig.crashDir && !core_bentley_1.ProcessDetector.isElectronAppBackend && !core_bentley_1.ProcessDetector.isMobileAppBackend) {
-            this.platform.setCrashReporting(options.crashReportingConfig);
-            core_bentley_1.Logger.logTrace(loggerCategory, "Configured crash reporting", {
-                enableCrashDumps: options.crashReportingConfig?.enableCrashDumps,
-                wantFullMemoryDumps: options.crashReportingConfig?.wantFullMemoryDumps,
-                enableNodeReport: options.crashReportingConfig?.enableNodeReport,
-                uploadToBentley: options.crashReportingConfig?.uploadToBentley,
-            });
-            if (options.crashReportingConfig.enableNodeReport) {
-                if (process.report !== undefined) {
-                    process.report.reportOnFatalError = true;
-                    process.report.reportOnUncaughtException = true;
-                    process.report.directory = options.crashReportingConfig.crashDir;
-                    core_bentley_1.Logger.logTrace(loggerCategory, "Configured Node.js crash reporting");
-                }
-                else {
-                    core_bentley_1.Logger.logWarning(loggerCategory, "Unable to configure Node.js crash reporting");
-                }
-            }
-        }
-        this.setupHostDirs(options);
+        this.loadNative(options);
+        this.setupCacheDir(options);
         this.initializeWorkspace(options);
-        BriefcaseManager_1.BriefcaseManager.initialize(this._briefcaseCacheDir);
+        BriefcaseManager_1.BriefcaseManager.initialize((0, path_1.join)(this._cacheDir, "imodels"));
         [
             IModelReadRpcImpl_1.IModelReadRpcImpl,
             IModelTileRpcImpl_1.IModelTileRpcImpl,
@@ -244,78 +263,55 @@ class IModelHost {
         process.once("beforeExit", IModelHost.shutdown);
         this.onAfterStartup.raiseEvent();
     }
-    static logStartup() {
-        if (!core_bentley_1.Logger.isEnabled(loggerCategory, core_bentley_1.LogLevel.Trace))
-            return;
-        // Extract the iModel details from environment - note this is very specific to Bentley hosted backends, but is quite useful for tracing
-        let startupInfo = {};
-        const serviceName = process.env.FABRIC_SERVICE_NAME;
-        if (serviceName) {
-            // e.g., fabric:/iModelWebViewer3.0/iModelJSGuest/1/08daaeb3-b56f-480b-9051-7efc834d18ae/512d971d-b641-4735-bb1c-c07ab3e44ce7/c1315fcce125ca40b2d405bb7809214daf8b4c85
-            const serviceNameComponents = serviceName.split("/");
-            if (serviceNameComponents.length === 7) {
-                startupInfo = {
-                    ...startupInfo,
-                    iTwinId: serviceNameComponents[4],
-                    iModelId: serviceNameComponents[5],
-                    changesetId: serviceNameComponents[6],
-                };
-            }
-        }
-        core_bentley_1.Logger.logTrace(loggerCategory, "IModelHost.startup", () => startupInfo);
-    }
-    static setupHostDirs(configuration) {
-        const setupDir = (dir) => {
-            dir = path.normalize(dir);
-            IModelJsFs_1.IModelJsFs.recursiveMkDirSync(dir);
-            return dir;
-        };
-        this._cacheDir = setupDir(configuration.cacheDir ?? imodeljs_native_1.NativeLibrary.defaultCacheDir);
-        this._briefcaseCacheDir = path.join(this._cacheDir, "imodels");
+    static setupCacheDir(configuration) {
+        this._cacheDir = (0, path_1.normalize)(configuration.cacheDir ?? imodeljs_native_1.NativeLibrary.defaultCacheDir);
+        IModelJsFs_1.IModelJsFs.recursiveMkDirSync(this._cacheDir);
+        this._profileName = configuration.profileName ?? "default";
+        core_bentley_1.Logger.logInfo(loggerCategory, `cacheDir: [${this.cacheDir}], profileDir: [${this.profileDir}]`);
     }
     /** This method must be called when an iTwin.js host is shut down. Raises [[onBeforeShutdown]] */
     static async shutdown() {
-        // NB: This method is set as a node listener where `this` is unbound
-        if (!IModelHost._isValid)
+        // Note: This method is set as a node listener where `this` is unbound. Call private method to
+        // ensure `this` is correct. Don't combine these methods.
+        return IModelHost.doShutdown();
+    }
+    static async doShutdown() {
+        if (!this._isValid)
             return;
-        IModelHost._isValid = false;
-        IModelHost.onBeforeShutdown.raiseEvent();
-        IModelHost.configuration = undefined;
-        IModelHost.tileStorage = undefined;
-        IModelHost._appWorkspace?.close();
-        IModelHost._appWorkspace = undefined;
-        Workspace_1.ITwinWorkspace.finalize();
+        this._isValid = false;
+        this.onBeforeShutdown.raiseEvent();
+        this.configuration = undefined;
+        this.tileStorage = undefined;
+        this._appWorkspace?.close();
+        this._appWorkspace = undefined;
+        CloudSqlite_1.CloudSqlite.CloudCaches.destroy();
         process.removeListener("beforeExit", IModelHost.shutdown);
     }
     /**
      * Add or update a property that should be included in a crash report.
-     * @param name The name of the property
-     * @param value The value of the property
-     * @alpha
+     * @internal
      */
     static setCrashReportProperty(name, value) {
-        (0, core_bentley_1.assert)(undefined !== this._platform);
-        this._platform.setCrashReportProperty(name, value);
+        this.platform.setCrashReportProperty(name, value);
     }
     /**
      * Remove a previously defined property so that will not be included in a crash report.
-     * @param name The name of the property
-     * @alpha
+     * @internal
      */
     static removeCrashReportProperty(name) {
-        (0, core_bentley_1.assert)(undefined !== this._platform);
-        this._platform.setCrashReportProperty(name, undefined);
+        this.platform.setCrashReportProperty(name, undefined);
     }
     /**
      * Get all properties that will be included in a crash report.
-     * @alpha
+     * @internal
      */
     static getCrashReportProperties() {
-        (0, core_bentley_1.assert)(undefined !== this._platform);
-        return this._platform.getCrashReportProperties();
+        return this.platform.getCrashReportProperties();
     }
     /** The directory where application assets may be found */
-    static get appAssetsDir() { return undefined !== IModelHost.configuration ? IModelHost.configuration.appAssetsDir : undefined; }
+    static get appAssetsDir() {
+        return undefined !== IModelHost.configuration ? IModelHost.configuration.appAssetsDir : undefined;
+    }
     /** The time, in milliseconds, for which IModelTileRpcInterface.requestTileTreeProps should wait before returning a "pending" status.
      * @internal
      */
@@ -329,9 +325,13 @@ class IModelHost {
         return IModelHost.configuration?.tileContentRequestTimeout ?? IModelHostConfiguration.defaultTileRequestTimeout;
     }
     /** The backend will log when a tile took longer to load than this threshold in seconds. */
-    static get logTileLoadTimeThreshold() { return IModelHost.configuration?.logTileLoadTimeThreshold ?? IModelHostConfiguration.defaultLogTileLoadTimeThreshold; }
+    static get logTileLoadTimeThreshold() {
+        return IModelHost.configuration?.logTileLoadTimeThreshold ?? IModelHostConfiguration.defaultLogTileLoadTimeThreshold;
+    }
     /** The backend will log when a tile is loaded with a size in bytes above this threshold. */
-    static get logTileSizeThreshold() { return IModelHost.configuration?.logTileSizeThreshold ?? IModelHostConfiguration.defaultLogTileSizeThreshold; }
+    static get logTileSizeThreshold() {
+        return IModelHost.configuration?.logTileSizeThreshold ?? IModelHostConfiguration.defaultLogTileSizeThreshold;
+    }
     /** Whether external tile caching is active.
      * @internal
      */
@@ -341,11 +341,15 @@ class IModelHost {
     /** Whether to restrict tile cache URLs by client IP address.
      * @internal
      */
-    static get restrictTileUrlsByClientIp() { return undefined !== IModelHost.configuration && (IModelHost.configuration.restrictTileUrlsByClientIp ? true : false); }
+    static get restrictTileUrlsByClientIp() {
+        return undefined !== IModelHost.configuration && (IModelHost.configuration.restrictTileUrlsByClientIp ? true : false);
+    }
     /** Whether to compress cached tiles.
      * @internal
      */
-    static get compressCachedTiles() { return false !== IModelHost.configuration?.compressCachedTiles; }
+    static get compressCachedTiles() {
+        return false !== IModelHost.configuration?.compressCachedTiles;
+    }
     static setupTileCache() {
         (0, core_bentley_1.assert)(undefined !== IModelHost.configuration);
         const config = IModelHost.configuration;
@@ -398,7 +402,7 @@ IModelHost.onBeforeShutdown = new core_bentley_1.BeEvent();
 IModelHost.session = { applicationId: "2686", applicationVersion: "1.0.0", sessionId: "" };
 IModelHost._isValid = false;
 exports.IModelHost = IModelHost;
-/** Information about the platform on which the app is running. Also see [[KnownLocations]] and [[IModelJsFs]].
+/** Information about the platform on which the app is running.
  * @public
  */
 class Platform {
@@ -406,21 +410,19 @@ class Platform {
     static get platformName() {
         return process.platform;
     }
-    /** @internal */
-    static load() {
-        return core_bentley_1.ProcessDetector.isMobileAppBackend ? process._linkedBinding("iModelJsNative") : imodeljs_native_1.NativeLibrary.load();
-    }
 }
 exports.Platform = Platform;
-/** Well known directories that may be used by the application. Also see [[Platform]]
+/** Well known directories that may be used by the application.
  * @public
  */
 class KnownLocations {
     /** The directory where the imodeljs-native assets are stored. */
-    static get nativeAssetsDir() { return IModelHost.platform.DgnDb.getAssetsDir(); }
+    static get nativeAssetsDir() {
+        return IModelHost.platform.DgnDb.getAssetsDir();
+    }
     /** The directory where the core-backend assets are stored. */
     static get packageAssetsDir() {
-        return path.join(__dirname, "assets");
+        return (0, path_1.join)(__dirname, "assets");
     }
     /** The temporary directory. */
     static get tmpdir() {