@itwin/core-backend 3.0.0-dev.99 → 3.1.0-dev.1

package/lib/cjs/IModelHost.d.ts

@@ -2,11 +2,12 @@
  * @module IModelHost
  */
 import { IModelJsNative } from "@bentley/imodeljs-native";
-import { TelemetryManager } from "@bentley/telemetry-client";
+import { TelemetryManager } from "@itwin/core-telemetry";
 import { AccessToken, BeEvent, GuidString, Mutable } from "@itwin/core-bentley";
-import { AuthorizationClient, SessionProps } from "@itwin/core-common";
+import { AuthorizationClient, LocalDirName, SessionProps } from "@itwin/core-common";
 import { BackendHubAccess } from "./BackendHubAccess";
-import { CloudStorageService, CloudStorageServiceCredentials, CloudStorageTileUploader } from "./CloudStorageBackend";
+import { AzureBlobStorageCredentials, CloudStorageService, CloudStorageTileUploader } from "./CloudStorageBackend";
+import { Workspace, WorkspaceOpts } from "./workspace/Workspace";
 /** @alpha */
 export interface CrashReportingConfigNameValuePair {
     name: string;
@@ -43,7 +44,7 @@ export interface CrashReportingConfig {
  */
 export declare class IModelHostConfiguration {
     /**
-     * Root of the directory holding all the files that iModel.js caches
+     * Root of the directory holding all the files that iTwin.js caches
      * - If not specified at startup a platform specific default is used -
      *   - Windows: $(HOMEDIR)/AppData/Local/iModelJs/
      *   - Mac/iOS: $(HOMEDIR)/Library/Caches/iModelJs/
@@ -56,17 +57,27 @@ export declare class IModelHostConfiguration {
      *   - etc.
      * @see [[IModelHost.cacheDir]] for the value it's set to after startup
      */
-    cacheDir?: string;
+    cacheDir?: LocalDirName;
+    /** Options for creating the [[Workspace]]
+     * @beta
+     */
+    workspace?: WorkspaceOpts;
     /** The directory where the app's assets are found. */
-    appAssetsDir?: string;
+    appAssetsDir?: LocalDirName;
     /** The kind of iModel hub server to use.
      * @beta
      */
     hubAccess?: BackendHubAccess;
-    /** The credentials to use for the tile cache service. If omitted, a local cache will be used.
+    /** The Azure blob storage credentials to use for the tile cache service. If omitted and no external service implementation is provided, a local cache will be used.
+     * @beta
+     */
+    tileCacheAzureCredentials?: AzureBlobStorageCredentials;
+    /**
      * @beta
+     * @note A reference implementation is set for [[AzureBlobStorage]] if [[tileCacheAzureCredentials]] property is set. To supply a different implementation for any service provider (such as AWS),
+     *       set this property with a custom [[CloudStorageService]].
      */
-    tileCacheCredentials?: CloudStorageServiceCredentials;
+    tileCacheService?: CloudStorageService;
     /** Whether to restrict tile cache URLs by client IP address (if available).
      * @beta
      */
@@ -107,6 +118,10 @@ export declare class IModelHostConfiguration {
      * @alpha
      */
     crashReportingConfig?: CrashReportingConfig;
+    /** The AuthorizationClient used to get accessTokens
+     * @beta
+     */
+    authorizationClient?: AuthorizationClient;
 }
 /** IModelHost initializes ($backend) and captures its configuration. A backend must call [[IModelHost.startup]] before using any backend classes.
  * See [the learning article]($docs/learning/backend/IModelHost.md)
@@ -119,6 +134,7 @@ export declare class IModelHost {
     static readonly telemetry: TelemetryManager;
     static backendVersion: string;
     private static _cacheDir;
+    private static _appWorkspace?;
     private static _platform?;
     /** @internal */
     static get platform(): typeof IModelJsNative;
@@ -138,8 +154,15 @@ export declare class IModelHost {
     /** The version of this application - needs to be set if is an agent application. The applicationVersion will otherwise originate at the frontend. */
     static get applicationVersion(): string;
     static set applicationVersion(version: string);
-    /** Root of the directory holding all the files that iModel.js caches */
-    static get cacheDir(): string;
+    /** Root directory holding files that iTwin.js caches */
+    static get cacheDir(): LocalDirName;
+    /** The application [[Workspace]] for this `IModelHost`
+     * @note this `Workspace` only holds [[WorkspaceContainer]]s and [[Settings]] scoped to the currently loaded application(s).
+     * All organization, iTwin, and iModel based containers or settings must be accessed through [[IModelDb.workspace]] and
+     * attempting to add them to this Workspace will fail.
+     * @beta
+     */
+    static get appWorkspace(): Workspace;
     /** The optional [[FileNameResolver]] that resolves keys and partial file names for snapshot iModels. */
     static snapshotFileNameResolver?: FileNameResolver;
     /** Get the current access token for this IModelHost, or a blank string if none is available.
@@ -157,14 +180,12 @@ export declare class IModelHost {
     private static registerPlatform;
     private static validateNativePlatformVersion;
     /**
-     * @beta
-     * @note A reference implementation is set by default for [AzureBlobStorage]. To supply a different implementation for any service provider (such as AWS),
-     *       set this property with a custom [CloudStorageService] and also set [IModelHostConfiguration.tileCacheCredentials] using "external" for the service name.
-     *       Note that the account and access key members of [CloudStorageServiceCredentials] may have blank values unless the custom service implementation uses them.
+     * @internal
+     * @note Use [[IModelHostConfiguration.tileCacheService]] to set the service provider.
      */
-    static tileCacheService: CloudStorageService;
+    static tileCacheService?: CloudStorageService;
     /** @internal */
-    static tileUploader: CloudStorageTileUploader;
+    static tileUploader?: CloudStorageTileUploader;
     private static _hubAccess;
     /** @internal */
     static setHubAccess(hubAccess: BackendHubAccess): void;
@@ -175,7 +196,7 @@ export declare class IModelHost {
     private static _isValid;
     /** Returns true if IModelHost is started.  */
     static get isValid(): boolean;
-    /** This method must be called before any iModel.js services are used.
+    /** This method must be called before any iTwin.js services are used.
      * @param configuration Host configuration data.
      * Raises [[onAfterStartup]].
      * @see [[shutdown]].
@@ -183,8 +204,8 @@ export declare class IModelHost {
     static startup(configuration?: IModelHostConfiguration): Promise<void>;
     private static _briefcaseCacheDir;
     private static logStartup;
-    private static setupCacheDirs;
-    /** This method must be called when an iModel.js services is shut down. Raises [[onBeforeShutdown]] */
+    private static setupHostDirs;
+    /** This method must be called when an iTwin.js host is shut down. Raises [[onBeforeShutdown]] */
     static shutdown(): Promise<void>;
     /**
      * Add or update a property that should be included in a crash report.

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":"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"}

package/lib/cjs/IModelHost.js

@@ -12,10 +12,9 @@ const os = require("os");
 const path = require("path");
 const semver = require("semver");
 const imodeljs_native_1 = require("@bentley/imodeljs-native");
-const telemetry_client_1 = require("@bentley/telemetry-client");
+const core_telemetry_1 = require("@itwin/core-telemetry");
 const core_bentley_1 = require("@itwin/core-bentley");
 const core_common_1 = require("@itwin/core-common");
-const AliCloudStorageService_1 = require("./AliCloudStorageService");
 const BackendLoggerCategory_1 = require("./BackendLoggerCategory");
 const BisCoreSchema_1 = require("./BisCoreSchema");
 const BriefcaseManager_1 = require("./BriefcaseManager");
@@ -29,6 +28,9 @@ const IModelTileRpcImpl_1 = require("./rpc-impl/IModelTileRpcImpl");
 const SnapshotIModelRpcImpl_1 = require("./rpc-impl/SnapshotIModelRpcImpl");
 const WipRpcImpl_1 = require("./rpc-impl/WipRpcImpl");
 const RpcBackend_1 = require("./RpcBackend");
+const Workspace_1 = require("./workspace/Workspace");
+const Settings_1 = require("./workspace/Settings");
+const SettingsSpecRegistry_1 = require("./workspace/SettingsSpecRegistry");
 const loggerCategory = BackendLoggerCategory_1.BackendLoggerCategory.IModelHost;
 /** Configuration of core-backend.
  * @public
@@ -66,6 +68,35 @@ IModelHostConfiguration.defaultLogTileLoadTimeThreshold = 40;
  * @internal
  */
 IModelHostConfiguration.defaultLogTileSizeThreshold = 20 * 1000000;
+/**
+ * Settings for the application workspace.
+ * @note this includes the default dictionary from the SettingsSpecRegistry
+ */
+class ApplicationSettings extends Settings_1.BaseSettings {
+    constructor() {
+        super();
+        this._remove = SettingsSpecRegistry_1.SettingsSpecRegistry.onSpecsChanged.addListener(() => this.updateDefaults());
+        this.updateDefaults();
+    }
+    verifyPriority(priority) {
+        if (priority >= Settings_1.SettingsPriority.iModel) // iModel settings may not appear in ApplicationSettings
+            throw new Error("Use IModelSettings");
+    }
+    updateDefaults() {
+        const defaults = {};
+        for (const [specName, val] of SettingsSpecRegistry_1.SettingsSpecRegistry.allSpecs) {
+            if (val.default)
+                defaults[specName] = val.default;
+        }
+        this.addDictionary("_default_", 0, defaults);
+    }
+    close() {
+        if (this._remove) {
+            this._remove();
+            this._remove = undefined;
+        }
+    }
+}
 /** IModelHost initializes ($backend) and captures its configuration. A backend must call [[IModelHost.startup]] before using any backend classes.
  * See [the learning article]($docs/learning/backend/IModelHost.md)
  * @public
@@ -87,8 +118,15 @@ class IModelHost {
     /** The version of this application - needs to be set if is an agent application. The applicationVersion will otherwise originate at the frontend. */
     static get applicationVersion() { return this.session.applicationVersion; }
     static set applicationVersion(version) { this.session.applicationVersion = version; }
-    /** Root of the directory holding all the files that iModel.js caches */
+    /** Root directory holding files that iTwin.js caches */
     static get cacheDir() { return this._cacheDir; }
+    /** The application [[Workspace]] for this `IModelHost`
+     * @note this `Workspace` only holds [[WorkspaceContainer]]s and [[Settings]] scoped to the currently loaded application(s).
+     * All organization, iTwin, and iModel based containers or settings must be accessed through [[IModelDb.workspace]] and
+     * attempting to add them to this Workspace will fail.
+     * @beta
+     */
+    static get appWorkspace() { return this._appWorkspace; } // eslint-disable-line @typescript-eslint/no-non-null-assertion
     /** Get the current access token for this IModelHost, or a blank string if none is available.
      * @note for web backends, this will *always* return a blank string because the backend itself has no token (but never needs one either.)
      * For all IpcHosts, where this backend is servicing a single frontend, this will be the user's token. For ElectronHost, the backend
@@ -142,7 +180,7 @@ class IModelHost {
     static get hubAccess() { return this._hubAccess; }
     /** Returns true if IModelHost is started.  */
     static get isValid() { return this._isValid; }
-    /** This method must be called before any iModel.js services are used.
+    /** This method must be called before any iTwin.js services are used.
      * @param configuration Host configuration data.
      * Raises [[onAfterStartup]].
      * @see [[shutdown]].
@@ -153,6 +191,7 @@ class IModelHost {
         this._isValid = true;
         if (IModelHost.sessionId === "")
             IModelHost.sessionId = core_bentley_1.Guid.createValue();
+        this.authorizationClient = configuration.authorizationClient;
         this.logStartup();
         this.backendVersion = require("../../package.json").version; // eslint-disable-line @typescript-eslint/no-var-requires
         (0, RpcBackend_1.initializeRpcBackend)();
@@ -190,7 +229,8 @@ class IModelHost {
                 }
             }
         }
-        this.setupCacheDirs(configuration);
+        this.setupHostDirs(configuration);
+        this._appWorkspace = new Workspace_1.ITwinWorkspace(new ApplicationSettings(), configuration.workspace);
         BriefcaseManager_1.BriefcaseManager.initialize(this._briefcaseCacheDir);
         [
             IModelReadRpcImpl_1.IModelReadRpcImpl,
@@ -208,7 +248,7 @@ class IModelHost {
             IModelHost._hubAccess = configuration.hubAccess;
         IModelHost.configuration = configuration;
         IModelHost.setupTileCache();
-        this.platform.setUseTileCache(configuration.tileCacheCredentials ? false : true);
+        this.platform.setUseTileCache(IModelHost.tileCacheService ? false : true);
         process.once("beforeExit", IModelHost.shutdown);
         IModelHost.onAfterStartup.raiseEvent();
     }
@@ -232,12 +272,17 @@ class IModelHost {
         }
         core_bentley_1.Logger.logTrace(loggerCategory, "IModelHost.startup", () => startupInfo);
     }
-    static setupCacheDirs(configuration) {
-        this._cacheDir = configuration.cacheDir ? path.normalize(configuration.cacheDir) : imodeljs_native_1.NativeLibrary.defaultCacheDir;
-        IModelJsFs_1.IModelJsFs.recursiveMkDirSync(this._cacheDir); // make sure the directory for cacheDir exists.
+    static setupHostDirs(configuration) {
+        var _a;
+        const setupDir = (dir) => {
+            dir = path.normalize(dir);
+            IModelJsFs_1.IModelJsFs.recursiveMkDirSync(dir);
+            return dir;
+        };
+        this._cacheDir = setupDir((_a = configuration.cacheDir) !== null && _a !== void 0 ? _a : imodeljs_native_1.NativeLibrary.defaultCacheDir);
         this._briefcaseCacheDir = path.join(this._cacheDir, "imodels");
     }
-    /** This method must be called when an iModel.js services is shut down. Raises [[onBeforeShutdown]] */
+    /** 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)
@@ -245,6 +290,10 @@ class IModelHost {
         IModelHost._isValid = false;
         IModelHost.onBeforeShutdown.raiseEvent();
         IModelHost.configuration = undefined;
+        IModelHost.tileCacheService = undefined;
+        IModelHost.tileUploader = undefined;
+        IModelHost.appWorkspace.close();
+        IModelHost._appWorkspace = undefined;
         process.removeListener("beforeExit", IModelHost.shutdown);
     }
     /**
@@ -296,8 +345,7 @@ class IModelHost {
      * @internal
      */
     static get usingExternalTileCache() {
-        var _a;
-        return undefined !== ((_a = IModelHost.configuration) === null || _a === void 0 ? void 0 : _a.tileCacheCredentials);
+        return undefined !== IModelHost.tileCacheService;
     }
     /** Whether to restrict tile cache URLs by client IP address.
      * @internal
@@ -308,25 +356,27 @@ class IModelHost {
      */
     static get compressCachedTiles() { var _a; return false !== ((_a = IModelHost.configuration) === null || _a === void 0 ? void 0 : _a.compressCachedTiles); }
     static setupTileCache() {
+        (0, core_bentley_1.assert)(undefined !== IModelHost.configuration);
         const config = IModelHost.configuration;
-        const credentials = config.tileCacheCredentials;
-        if (undefined === credentials)
+        const service = config.tileCacheService;
+        const credentials = config.tileCacheAzureCredentials;
+        if (!service && !credentials)
             return;
         IModelHost.tileUploader = new CloudStorageBackend_1.CloudStorageTileUploader();
-        if (credentials.service === "azure" && !IModelHost.tileCacheService) {
+        if (credentials && !service) {
             IModelHost.tileCacheService = new CloudStorageBackend_1.AzureBlobStorage(credentials);
         }
-        else if (credentials.service === "alicloud") {
-            IModelHost.tileCacheService = new AliCloudStorageService_1.AliCloudStorageService(credentials);
+        else if (!credentials && service) {
+            IModelHost.tileCacheService = service;
         }
-        else if (credentials.service !== "external") {
-            throw new core_common_1.IModelError(core_common_1.BentleyStatus.ERROR, "Unsupported cloud service credentials for tile cache.");
+        else {
+            throw new core_common_1.IModelError(core_common_1.BentleyStatus.ERROR, "Cannot use both Azure and custom cloud storage providers for tile cache.");
         }
     }
 }
 exports.IModelHost = IModelHost;
 /** @alpha */
-IModelHost.telemetry = new telemetry_client_1.TelemetryManager();
+IModelHost.telemetry = new core_telemetry_1.TelemetryManager();
 IModelHost.backendVersion = "";
 IModelHost._cacheDir = "";
 /** Event raised just after the backend IModelHost was started */

package/lib/cjs/IModelHost.js.map

@@ -1 +1 @@
-{"version":3,"file":"IModelHost.js","sourceRoot":"","sources":["../../src/IModelHost.ts"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\r\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\r\n* See LICENSE.md in the project root for license terms and full copyright notice.\r\n*--------------------------------------------------------------------------------------------*/\r\n/** @packageDocumentation\r\n * @module IModelHost\r\n */\r\n\r\nimport * as os from \"os\";\r\nimport * as path from \"path\";\r\nimport * as semver from \"semver\";\r\nimport { IModelJsNative, NativeLibrary } from \"@bentley/imodeljs-native\";\r\nimport { TelemetryManager } from \"@bentley/telemetry-client\";\r\nimport { AccessToken, assert, BeEvent, Guid, GuidString, IModelStatus, Logger, LogLevel, Mutable, ProcessDetector } from \"@itwin/core-bentley\";\r\nimport { AuthorizationClient, BentleyStatus, IModelError, SessionProps } from \"@itwin/core-common\";\r\nimport { AliCloudStorageService } from \"./AliCloudStorageService\";\r\nimport { BackendHubAccess } from \"./BackendHubAccess\";\r\nimport { BackendLoggerCategory } from \"./BackendLoggerCategory\";\r\nimport { BisCoreSchema } from \"./BisCoreSchema\";\r\nimport { BriefcaseManager } from \"./BriefcaseManager\";\r\nimport { AzureBlobStorage, CloudStorageService, CloudStorageServiceCredentials, CloudStorageTileUploader } from \"./CloudStorageBackend\";\r\nimport { FunctionalSchema } from \"./domains/FunctionalSchema\";\r\nimport { GenericSchema } from \"./domains/GenericSchema\";\r\nimport { IModelJsFs } from \"./IModelJsFs\";\r\nimport { DevToolsRpcImpl } from \"./rpc-impl/DevToolsRpcImpl\";\r\nimport { IModelReadRpcImpl } from \"./rpc-impl/IModelReadRpcImpl\";\r\nimport { IModelTileRpcImpl } from \"./rpc-impl/IModelTileRpcImpl\";\r\nimport { SnapshotIModelRpcImpl } from \"./rpc-impl/SnapshotIModelRpcImpl\";\r\nimport { WipRpcImpl } from \"./rpc-impl/WipRpcImpl\";\r\nimport { initializeRpcBackend } from \"./RpcBackend\";\r\n\r\nconst loggerCategory = BackendLoggerCategory.IModelHost;\r\n\r\n// cspell:ignore nodereport fatalerror apicall alicloud rpcs\r\n\r\n/** @alpha */\r\nexport interface CrashReportingConfigNameValuePair {\r\n  name: string;\r\n  value: string;\r\n}\r\n\r\n/** Configuration of the crash-reporting system.\r\n * @alpha\r\n */\r\nexport interface CrashReportingConfig {\r\n  /** The directory to which *.dmp and/or iModelJsNativeCrash*.properties.txt files are written. This directory will be created if it does not already exist. */\r\n  crashDir: string;\r\n  /** max # .dmp files that may exist in crashDir. The default is 50. */\r\n  maxDumpsInDir?: number;\r\n  /** Enable crash-dumps? If so, .dmp and .properties.txt files will be generated and written to crashDir in the event of an unhandled native-code exception. If not, only .properties.txt files will be written. The default is false. */\r\n  enableCrashDumps?: boolean;\r\n  /** If enableCrashDumps is true, do you want a full-memory dump? Defaults to false. */\r\n  wantFullMemoryDumps?: boolean;\r\n  /** Enable node-report? If so, node-report files will be generated in the event of an unhandled exception or fatal error and written to crashDir. The default is false. */\r\n  enableNodeReport?: boolean;\r\n  /** Additional name, value pairs to write to iModelJsNativeCrash*.properties.txt file in the event of a crash. */\r\n  params?: CrashReportingConfigNameValuePair[];\r\n  /** Run this .js file to process .dmp and node-report files in the event of a crash.\r\n   * This script will be executed with a single command-line parameter: the name of the dump or node-report file.\r\n   * In the case of a dump file, there will be a second file with the same basename and the extension \".properties.txt\".\r\n   * Since it runs in a separate process, this script will have no access to the Javascript\r\n   * context of the exiting backend. No default.\r\n   */\r\n  dumpProcessorScriptFileName?: string;\r\n  /** Upload crash dump and node-reports to Bentley's crash-reporting service? Defaults to false */\r\n  uploadToBentley?: boolean;\r\n}\r\n\r\n/** Configuration of core-backend.\r\n * @public\r\n */\r\nexport class IModelHostConfiguration {\r\n\r\n  /**\r\n   * Root of the directory holding all the files that iModel.js caches\r\n   * - If not specified at startup a platform specific default is used -\r\n   *   - Windows: $(HOMEDIR)/AppData/Local/iModelJs/\r\n   *   - Mac/iOS: $(HOMEDIR)/Library/Caches/iModelJs/\r\n   *   - Linux:   $(HOMEDIR)/.cache/iModelJs/\r\n   *   where $(HOMEDIR) is documented [here](https://nodejs.org/api/os.html#os_os_homedir)\r\n   * - if specified, ensure it is set to a folder with read/write access.\r\n   * - Sub-folders within this folder organize various caches -\r\n   *   - bc/ -> Briefcases\r\n   *   - appSettings/ -> Offline application settings (only relevant in native applications)\r\n   *   - etc.\r\n   * @see [[IModelHost.cacheDir]] for the value it's set to after startup\r\n   */\r\n  public cacheDir?: string;\r\n\r\n  /** The directory where the app's assets are found. */\r\n  public appAssetsDir?: string;\r\n\r\n  /** The kind of iModel hub server to use.\r\n   * @beta\r\n   */\r\n  public hubAccess?: BackendHubAccess;\r\n\r\n  /** The credentials to use for the tile cache service. If omitted, a local cache will be used.\r\n   * @beta\r\n   */\r\n  public tileCacheCredentials?: CloudStorageServiceCredentials;\r\n\r\n  /** Whether to restrict tile cache URLs by client IP address (if available).\r\n   * @beta\r\n   */\r\n  public restrictTileUrlsByClientIp?: boolean;\r\n\r\n  /** Whether to compress cached tiles.\r\n   * Defaults to `true`.\r\n   */\r\n  public compressCachedTiles?: boolean;\r\n\r\n  /** The time, in milliseconds, for which [IModelTileRpcInterface.requestTileTreeProps]($common) should wait before returning a \"pending\" status.\r\n   * @internal\r\n   */\r\n  public tileTreeRequestTimeout = IModelHostConfiguration.defaultTileRequestTimeout;\r\n  /** The time, in milliseconds, for which [IModelTileRpcInterface.requestTileContent]($common) should wait before returning a \"pending\" status.\r\n   * @internal\r\n   */\r\n  public tileContentRequestTimeout = IModelHostConfiguration.defaultTileRequestTimeout;\r\n  /** The default time, in milliseconds, used for [[tileTreeRequestTimeout]] and [[tileContentRequestTimeout]]. To change this, override one or both of those properties.\r\n   * @internal\r\n   */\r\n  public static defaultTileRequestTimeout = 20 * 1000;\r\n\r\n  /** The default time, in seconds, used for [[logTileLoadTimeThreshold]]. To change this, override that property.\r\n   * @internal\r\n   */\r\n  public static defaultLogTileLoadTimeThreshold = 40;\r\n  /** The backend will log when a tile took longer to load than this threshold in seconds.\r\n   * @internal\r\n   */\r\n  public logTileLoadTimeThreshold: number = IModelHostConfiguration.defaultLogTileLoadTimeThreshold;\r\n\r\n  /** The default size, in bytes, used for [[logTileSizeThreshold]]. To change this, override that property.\r\n   * @internal\r\n   */\r\n  public static defaultLogTileSizeThreshold = 20 * 1000000;\r\n  /** The backend will log when a tile is loaded with a size in bytes above this threshold.\r\n   * @internal\r\n   */\r\n  public logTileSizeThreshold: number = IModelHostConfiguration.defaultLogTileSizeThreshold;\r\n\r\n  /** Crash-reporting configuration\r\n   * @alpha\r\n   */\r\n  public crashReportingConfig?: CrashReportingConfig;\r\n\r\n}\r\n\r\n/** IModelHost initializes ($backend) and captures its configuration. A backend must call [[IModelHost.startup]] before using any backend classes.\r\n * See [the learning article]($docs/learning/backend/IModelHost.md)\r\n * @public\r\n */\r\nexport class IModelHost {\r\n  private constructor() { }\r\n  public static authorizationClient?: AuthorizationClient;\r\n\r\n  /** @alpha */\r\n  public static readonly telemetry = new TelemetryManager();\r\n\r\n  public static backendVersion = \"\";\r\n  private static _cacheDir = \"\";\r\n\r\n  private static _platform?: typeof IModelJsNative;\r\n  /** @internal */\r\n  public static get platform(): typeof IModelJsNative {\r\n    if (this._platform === undefined)\r\n      throw new Error(\"IModelHost.startup must be called first\");\r\n    return this._platform;\r\n  }\r\n\r\n  public static configuration?: IModelHostConfiguration;\r\n  /** Event raised just after the backend IModelHost was started */\r\n  public static readonly onAfterStartup = new BeEvent<() => void>();\r\n\r\n  /** Event raised just before the backend IModelHost is to be shut down */\r\n  public static readonly onBeforeShutdown = new BeEvent<() => void>();\r\n\r\n  /** @internal */\r\n  public static readonly session: Mutable<SessionProps> = { applicationId: \"2686\", applicationVersion: \"1.0.0\", sessionId: \"\" };\r\n\r\n  /** A uniqueId for this session */\r\n  public static get sessionId() { return this.session.sessionId; }\r\n  public static set sessionId(id: GuidString) { this.session.sessionId = id; }\r\n\r\n  /** The Id of this application - needs to be set only if it is an agent application. The applicationId will otherwise originate at the frontend. */\r\n  public static get applicationId() { return this.session.applicationId; }\r\n  public static set applicationId(id: string) { this.session.applicationId = id; }\r\n\r\n  /** The version of this application - needs to be set if is an agent application. The applicationVersion will otherwise originate at the frontend. */\r\n  public static get applicationVersion() { return this.session.applicationVersion; }\r\n  public static set applicationVersion(version: string) { this.session.applicationVersion = version; }\r\n\r\n  /** Root of the directory holding all the files that iModel.js caches */\r\n  public static get cacheDir(): string { return this._cacheDir; }\r\n\r\n  /** The optional [[FileNameResolver]] that resolves keys and partial file names for snapshot iModels. */\r\n  public static snapshotFileNameResolver?: FileNameResolver;\r\n\r\n  /** Get the current access token for this IModelHost, or a blank string if none is available.\r\n   * @note for web backends, this will *always* return a blank string because the backend itself has no token (but never needs one either.)\r\n   * For all IpcHosts, where this backend is servicing a single frontend, this will be the user's token. For ElectronHost, the backend\r\n   * obtains the token and forwards it to the frontend.\r\n   * @note accessTokens expire periodically and are automatically refreshed, if possible. Therefore tokens should not be saved, and the value\r\n   * returned by this method may change over time throughout the course of a session.\r\n   */\r\n  public static async getAccessToken(): Promise<AccessToken> {\r\n    try {\r\n      return (await this.authorizationClient?.getAccessToken()) ?? \"\";\r\n    } catch (e) {\r\n      return \"\";\r\n    }\r\n  }\r\n\r\n  /** @internal */\r\n  public static flushLog() {\r\n    return this.platform.DgnDb.flushLog();\r\n  }\r\n  /** @internal */\r\n  public static loadNative(): void {\r\n    const platform = Platform.load();\r\n    this.registerPlatform(platform);\r\n  }\r\n\r\n  private static registerPlatform(platform: typeof IModelJsNative): void {\r\n    this._platform = platform;\r\n    if (undefined === platform)\r\n      return;\r\n\r\n    if (!ProcessDetector.isMobileAppBackend)\r\n      this.validateNativePlatformVersion();\r\n\r\n    platform.logger = Logger;\r\n  }\r\n\r\n  private static validateNativePlatformVersion(): void {\r\n    const requiredVersion = require(\"../../package.json\").dependencies[\"@bentley/imodeljs-native\"]; // eslint-disable-line @typescript-eslint/no-var-requires\r\n    const thisVersion = this.platform.version;\r\n    if (semver.satisfies(thisVersion, requiredVersion))\r\n      return;\r\n    if (IModelJsFs.existsSync(path.join(__dirname, \"DevBuild.txt\"))) {\r\n      console.log(\"Bypassing version checks for development build\"); // eslint-disable-line no-console\r\n      return;\r\n    }\r\n    this._platform = undefined;\r\n    throw new IModelError(IModelStatus.BadRequest, `imodeljs-native version is (${thisVersion}). core-backend requires version (${requiredVersion})`);\r\n  }\r\n\r\n  /**\r\n   * @beta\r\n   * @note A reference implementation is set by default for [AzureBlobStorage]. To supply a different implementation for any service provider (such as AWS),\r\n   *       set this property with a custom [CloudStorageService] and also set [IModelHostConfiguration.tileCacheCredentials] using \"external\" for the service name.\r\n   *       Note that the account and access key members of [CloudStorageServiceCredentials] may have blank values unless the custom service implementation uses them.\r\n   */\r\n  public static tileCacheService: CloudStorageService;\r\n\r\n  /** @internal */\r\n  public static tileUploader: CloudStorageTileUploader;\r\n\r\n  private static _hubAccess: BackendHubAccess;\r\n  /** @internal */\r\n  public static setHubAccess(hubAccess: BackendHubAccess) { this._hubAccess = hubAccess; }\r\n\r\n  /** Provides access to the IModelHub for this IModelHost\r\n   * @beta\r\n   */\r\n  public static get hubAccess(): BackendHubAccess { return this._hubAccess; }\r\n\r\n  private static _isValid = false;\r\n  /** Returns true if IModelHost is started.  */\r\n  public static get isValid() { return this._isValid; }\r\n  /** This method must be called before any iModel.js services are used.\r\n   * @param configuration Host configuration data.\r\n   * Raises [[onAfterStartup]].\r\n   * @see [[shutdown]].\r\n   */\r\n  public static async startup(configuration: IModelHostConfiguration = new IModelHostConfiguration()): Promise<void> {\r\n    if (this._isValid)\r\n      return; // we're already initialized\r\n    this._isValid = true;\r\n\r\n    if (IModelHost.sessionId === \"\")\r\n      IModelHost.sessionId = Guid.createValue();\r\n\r\n    this.logStartup();\r\n\r\n    this.backendVersion = require(\"../../package.json\").version; // eslint-disable-line @typescript-eslint/no-var-requires\r\n    initializeRpcBackend();\r\n\r\n    if (this._platform === undefined) {\r\n      try {\r\n        this.loadNative();\r\n      } catch (error) {\r\n        Logger.logError(loggerCategory, \"Error registering/loading the native platform API\", () => (configuration));\r\n        throw error;\r\n      }\r\n    }\r\n\r\n    if (configuration.crashReportingConfig && configuration.crashReportingConfig.crashDir && !ProcessDetector.isElectronAppBackend && !ProcessDetector.isMobileAppBackend) {\r\n      this.platform.setCrashReporting(configuration.crashReportingConfig);\r\n\r\n      Logger.logTrace(loggerCategory, \"Configured crash reporting\", () => ({\r\n        enableCrashDumps: configuration.crashReportingConfig?.enableCrashDumps,\r\n        wantFullMemoryDumps: configuration.crashReportingConfig?.wantFullMemoryDumps,\r\n        enableNodeReport: configuration.crashReportingConfig?.enableNodeReport,\r\n        uploadToBentley: configuration.crashReportingConfig?.uploadToBentley,\r\n      }));\r\n\r\n      if (configuration.crashReportingConfig.enableNodeReport) {\r\n        try {\r\n          // node-report reports on V8 fatal errors and unhandled exceptions/Promise rejections.\r\n          const nodereport = require(\"node-report/api\"); // eslint-disable-line @typescript-eslint/no-var-requires\r\n          nodereport.setEvents(\"exception+fatalerror+apicall\");\r\n          nodereport.setDirectory(configuration.crashReportingConfig.crashDir);\r\n          nodereport.setVerbose(\"yes\");\r\n          Logger.logTrace(loggerCategory, \"Configured native crash reporting (node-report)\");\r\n        } catch (err) {\r\n          Logger.logWarning(loggerCategory, \"node-report is not installed.\");\r\n        }\r\n      }\r\n    }\r\n\r\n    this.setupCacheDirs(configuration);\r\n    BriefcaseManager.initialize(this._briefcaseCacheDir);\r\n\r\n    [\r\n      IModelReadRpcImpl,\r\n      IModelTileRpcImpl,\r\n      SnapshotIModelRpcImpl,\r\n      WipRpcImpl,\r\n      DevToolsRpcImpl,\r\n    ].forEach((rpc) => rpc.register()); // register all of the RPC implementations\r\n\r\n    [\r\n      BisCoreSchema,\r\n      GenericSchema,\r\n      FunctionalSchema,\r\n    ].forEach((schema) => schema.registerSchema()); // register all of the schemas\r\n\r\n    if (undefined !== configuration.hubAccess)\r\n      IModelHost._hubAccess = configuration.hubAccess;\r\n    IModelHost.configuration = configuration;\r\n    IModelHost.setupTileCache();\r\n\r\n    this.platform.setUseTileCache(configuration.tileCacheCredentials ? false : true);\r\n\r\n    process.once(\"beforeExit\", IModelHost.shutdown);\r\n    IModelHost.onAfterStartup.raiseEvent();\r\n  }\r\n\r\n  private static _briefcaseCacheDir: string;\r\n\r\n  private static logStartup() {\r\n    if (!Logger.isEnabled(loggerCategory, LogLevel.Trace))\r\n      return;\r\n\r\n    // Extract the iModel details from environment - note this is very specific to Bentley hosted backends, but is quite useful for tracing\r\n    let startupInfo: any = {};\r\n    const serviceName = process.env.FABRIC_SERVICE_NAME;\r\n    if (serviceName) {\r\n      // e.g., fabric:/iModelWebViewer3.0/iModelJSGuest/1/08daaeb3-b56f-480b-9051-7efc834d18ae/512d971d-b641-4735-bb1c-c07ab3e44ce7/c1315fcce125ca40b2d405bb7809214daf8b4c85\r\n      const serviceNameComponents = serviceName.split(\"/\");\r\n      if (serviceNameComponents.length === 7) {\r\n        startupInfo = {\r\n          ...startupInfo,\r\n          iTwinId: serviceNameComponents[4],\r\n          iModelId: serviceNameComponents[5],\r\n          changesetId: serviceNameComponents[6],\r\n        };\r\n      }\r\n    }\r\n\r\n    Logger.logTrace(loggerCategory, \"IModelHost.startup\", () => startupInfo);\r\n  }\r\n\r\n  private static setupCacheDirs(configuration: IModelHostConfiguration) {\r\n    this._cacheDir = configuration.cacheDir ? path.normalize(configuration.cacheDir) : NativeLibrary.defaultCacheDir;\r\n    IModelJsFs.recursiveMkDirSync(this._cacheDir); // make sure the directory for cacheDir exists.\r\n    this._briefcaseCacheDir = path.join(this._cacheDir, \"imodels\");\r\n  }\r\n\r\n  /** This method must be called when an iModel.js services is shut down. Raises [[onBeforeShutdown]] */\r\n  public static async shutdown(): Promise<void> {\r\n    // NB: This method is set as a node listener where `this` is unbound\r\n    if (!IModelHost._isValid)\r\n      return;\r\n\r\n    IModelHost._isValid = false;\r\n    IModelHost.onBeforeShutdown.raiseEvent();\r\n    IModelHost.configuration = undefined;\r\n    process.removeListener(\"beforeExit\", IModelHost.shutdown);\r\n  }\r\n\r\n  /**\r\n   * Add or update a property that should be included in a crash report.\r\n   * @param name The name of the property\r\n   * @param value The value of the property\r\n   * @alpha\r\n   */\r\n  public static setCrashReportProperty(name: string, value: string): void {\r\n    assert(undefined !== this._platform);\r\n    this._platform.setCrashReportProperty(name, value);\r\n  }\r\n\r\n  /**\r\n   * Remove a previously defined property so that will not be included in a crash report.\r\n   * @param name The name of the property\r\n   * @alpha\r\n   */\r\n  public static removeCrashReportProperty(name: string): void {\r\n    assert(undefined !== this._platform);\r\n    this._platform.setCrashReportProperty(name, undefined);\r\n  }\r\n\r\n  /**\r\n   * Get all properties that will be included in a crash report.\r\n   * @alpha\r\n   */\r\n  public static getCrashReportProperties(): CrashReportingConfigNameValuePair[] {\r\n    assert(undefined !== this._platform);\r\n    return this._platform.getCrashReportProperties();\r\n  }\r\n\r\n  /** The directory where application assets may be found */\r\n  public static get appAssetsDir(): string | undefined { return undefined !== IModelHost.configuration ? IModelHost.configuration.appAssetsDir : undefined; }\r\n\r\n  /** The time, in milliseconds, for which [IModelTileRpcInterface.requestTileTreeProps]($common) should wait before returning a \"pending\" status.\r\n   * @internal\r\n   */\r\n  public static get tileTreeRequestTimeout(): number {\r\n    return undefined !== IModelHost.configuration ? IModelHost.configuration.tileTreeRequestTimeout : IModelHostConfiguration.defaultTileRequestTimeout;\r\n  }\r\n  /** The time, in milliseconds, for which [IModelTileRpcInterface.requestTileContent]($common) should wait before returning a \"pending\" status.\r\n   * @internal\r\n   */\r\n  public static get tileContentRequestTimeout(): number {\r\n    return undefined !== IModelHost.configuration ? IModelHost.configuration.tileContentRequestTimeout : IModelHostConfiguration.defaultTileRequestTimeout;\r\n  }\r\n\r\n  /** The backend will log when a tile took longer to load than this threshold in seconds. */\r\n  public static get logTileLoadTimeThreshold(): number { return undefined !== IModelHost.configuration ? IModelHost.configuration.logTileLoadTimeThreshold : IModelHostConfiguration.defaultLogTileLoadTimeThreshold; }\r\n  /** The backend will log when a tile is loaded with a size in bytes above this threshold. */\r\n  public static get logTileSizeThreshold(): number { return undefined !== IModelHost.configuration ? IModelHost.configuration.logTileSizeThreshold : IModelHostConfiguration.defaultLogTileSizeThreshold; }\r\n\r\n  /** Whether external tile caching is active.\r\n   * @internal\r\n   */\r\n  public static get usingExternalTileCache(): boolean {\r\n    return undefined !== IModelHost.configuration?.tileCacheCredentials;\r\n  }\r\n\r\n  /** Whether to restrict tile cache URLs by client IP address.\r\n   * @internal\r\n   */\r\n  public static get restrictTileUrlsByClientIp(): boolean { return undefined !== IModelHost.configuration && (IModelHost.configuration.restrictTileUrlsByClientIp ? true : false); }\r\n\r\n  /** Whether to compress cached tiles.\r\n   * @internal\r\n   */\r\n  public static get compressCachedTiles(): boolean { return false !== IModelHost.configuration?.compressCachedTiles; }\r\n\r\n  private static setupTileCache() {\r\n    const config = IModelHost.configuration!;\r\n    const credentials = config.tileCacheCredentials;\r\n    if (undefined === credentials)\r\n      return;\r\n\r\n    IModelHost.tileUploader = new CloudStorageTileUploader();\r\n\r\n    if (credentials.service === \"azure\" && !IModelHost.tileCacheService) {\r\n      IModelHost.tileCacheService = new AzureBlobStorage(credentials);\r\n    } else if (credentials.service === \"alicloud\") {\r\n      IModelHost.tileCacheService = new AliCloudStorageService(credentials);\r\n    } else if (credentials.service !== \"external\") {\r\n      throw new IModelError(BentleyStatus.ERROR, \"Unsupported cloud service credentials for tile cache.\");\r\n    }\r\n  }\r\n}\r\n\r\n/** Information about the platform on which the app is running. Also see [[KnownLocations]] and [[IModelJsFs]].\r\n * @public\r\n */\r\nexport class Platform {\r\n  /** Get the name of the platform. */\r\n  public static get platformName(): \"win32\" | \"linux\" | \"darwin\" | \"ios\" | \"android\" | \"uwp\" {\r\n    return process.platform as any;\r\n  }\r\n\r\n  /** @internal */\r\n  public static load(): typeof IModelJsNative {\r\n    return ProcessDetector.isMobileAppBackend ? (process as any)._linkedBinding(\"iModelJsNative\") : NativeLibrary.load();\r\n  }\r\n}\r\n\r\n/** Well known directories that may be used by the application. Also see [[Platform]]\r\n * @public\r\n */\r\nexport class KnownLocations {\r\n\r\n  /** The directory where the imodeljs-native assets are stored. */\r\n  public static get nativeAssetsDir(): string { return IModelHost.platform.DgnDb.getAssetsDir(); }\r\n\r\n  /** The directory where the core-backend assets are stored. */\r\n  public static get packageAssetsDir(): string {\r\n    return path.join(__dirname, \"assets\");\r\n  }\r\n\r\n  /** The temporary directory. */\r\n  public static get tmpdir(): string {\r\n    return os.tmpdir();\r\n  }\r\n}\r\n\r\n/** Extend this class to provide custom file name resolution behavior.\r\n * @note Only `tryResolveKey` and/or `tryResolveFileName` need to be overridden as the implementations of `resolveKey` and `resolveFileName` work for most purposes.\r\n * @see [[IModelHost.snapshotFileNameResolver]]\r\n * @public\r\n */\r\nexport abstract class FileNameResolver {\r\n  /** Resolve a file name from the specified key.\r\n   * @param _fileKey The key that identifies the file name in a `Map` or other similar data structure.\r\n   * @returns The resolved file name or `undefined` if not found.\r\n   */\r\n  public tryResolveKey(_fileKey: string): string | undefined { return undefined; }\r\n  /** Resolve a file name from the specified key.\r\n   * @param fileKey The key that identifies the file name in a `Map` or other similar data structure.\r\n   * @returns The resolved file name.\r\n   * @throws [[IModelError]] if not found.\r\n   */\r\n  public resolveKey(fileKey: string): string {\r\n    const resolvedFileName: string | undefined = this.tryResolveKey(fileKey);\r\n    if (undefined === resolvedFileName) {\r\n      throw new IModelError(IModelStatus.NotFound, `${fileKey} not resolved`);\r\n    }\r\n    return resolvedFileName;\r\n  }\r\n  /** Resolve the input file name, which may be a partial name, into a full path file name.\r\n   * @param inFileName The partial file name.\r\n   * @returns The resolved full path file name or `undefined` if not found.\r\n   */\r\n  public tryResolveFileName(inFileName: string): string | undefined { return inFileName; }\r\n  /** Resolve the input file name, which may be a partial name, into a full path file name.\r\n   * @param inFileName The partial file name.\r\n   * @returns The resolved full path file name.\r\n   * @throws [[IModelError]] if not found.\r\n   */\r\n  public resolveFileName(inFileName: string): string {\r\n    const resolvedFileName: string | undefined = this.tryResolveFileName(inFileName);\r\n    if (undefined === resolvedFileName) {\r\n      throw new IModelError(IModelStatus.NotFound, `${inFileName} not resolved`);\r\n    }\r\n    return resolvedFileName;\r\n  }\r\n}\r\n"]}
+{"version":3,"file":"IModelHost.js","sourceRoot":"","sources":["../../src/IModelHost.ts"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\r\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\r\n* See LICENSE.md in the project root for license terms and full copyright notice.\r\n*--------------------------------------------------------------------------------------------*/\r\n/** @packageDocumentation\r\n * @module IModelHost\r\n */\r\n\r\nimport * as os from \"os\";\r\nimport * as path from \"path\";\r\nimport * as semver from \"semver\";\r\nimport { IModelJsNative, NativeLibrary } from \"@bentley/imodeljs-native\";\r\nimport { TelemetryManager } from \"@itwin/core-telemetry\";\r\nimport { AccessToken, assert, BeEvent, Guid, GuidString, IModelStatus, Logger, LogLevel, Mutable, ProcessDetector } from \"@itwin/core-bentley\";\r\nimport { AuthorizationClient, BentleyStatus, IModelError, LocalDirName, SessionProps } from \"@itwin/core-common\";\r\nimport { BackendHubAccess } from \"./BackendHubAccess\";\r\nimport { BackendLoggerCategory } from \"./BackendLoggerCategory\";\r\nimport { BisCoreSchema } from \"./BisCoreSchema\";\r\nimport { BriefcaseManager } from \"./BriefcaseManager\";\r\nimport { AzureBlobStorage, AzureBlobStorageCredentials, CloudStorageService, CloudStorageTileUploader } from \"./CloudStorageBackend\";\r\nimport { FunctionalSchema } from \"./domains/FunctionalSchema\";\r\nimport { GenericSchema } from \"./domains/GenericSchema\";\r\nimport { IModelJsFs } from \"./IModelJsFs\";\r\nimport { DevToolsRpcImpl } from \"./rpc-impl/DevToolsRpcImpl\";\r\nimport { IModelReadRpcImpl } from \"./rpc-impl/IModelReadRpcImpl\";\r\nimport { IModelTileRpcImpl } from \"./rpc-impl/IModelTileRpcImpl\";\r\nimport { SnapshotIModelRpcImpl } from \"./rpc-impl/SnapshotIModelRpcImpl\";\r\nimport { WipRpcImpl } from \"./rpc-impl/WipRpcImpl\";\r\nimport { initializeRpcBackend } from \"./RpcBackend\";\r\nimport { ITwinWorkspace, Workspace, WorkspaceOpts } from \"./workspace/Workspace\";\r\nimport { BaseSettings, SettingDictionary, SettingsPriority } from \"./workspace/Settings\";\r\nimport { SettingsSpecRegistry } from \"./workspace/SettingsSpecRegistry\";\r\n\r\nconst loggerCategory = BackendLoggerCategory.IModelHost;\r\n\r\n// cspell:ignore nodereport fatalerror apicall alicloud rpcs\r\n\r\n/** @alpha */\r\nexport interface CrashReportingConfigNameValuePair {\r\n  name: string;\r\n  value: string;\r\n}\r\n\r\n/** Configuration of the crash-reporting system.\r\n * @alpha\r\n */\r\nexport interface CrashReportingConfig {\r\n  /** The directory to which *.dmp and/or iModelJsNativeCrash*.properties.txt files are written. This directory will be created if it does not already exist. */\r\n  crashDir: string;\r\n  /** max # .dmp files that may exist in crashDir. The default is 50. */\r\n  maxDumpsInDir?: number;\r\n  /** Enable crash-dumps? If so, .dmp and .properties.txt files will be generated and written to crashDir in the event of an unhandled native-code exception. If not, only .properties.txt files will be written. The default is false. */\r\n  enableCrashDumps?: boolean;\r\n  /** If enableCrashDumps is true, do you want a full-memory dump? Defaults to false. */\r\n  wantFullMemoryDumps?: boolean;\r\n  /** Enable node-report? If so, node-report files will be generated in the event of an unhandled exception or fatal error and written to crashDir. The default is false. */\r\n  enableNodeReport?: boolean;\r\n  /** Additional name, value pairs to write to iModelJsNativeCrash*.properties.txt file in the event of a crash. */\r\n  params?: CrashReportingConfigNameValuePair[];\r\n  /** Run this .js file to process .dmp and node-report files in the event of a crash.\r\n   * This script will be executed with a single command-line parameter: the name of the dump or node-report file.\r\n   * In the case of a dump file, there will be a second file with the same basename and the extension \".properties.txt\".\r\n   * Since it runs in a separate process, this script will have no access to the Javascript\r\n   * context of the exiting backend. No default.\r\n   */\r\n  dumpProcessorScriptFileName?: string;\r\n  /** Upload crash dump and node-reports to Bentley's crash-reporting service? Defaults to false */\r\n  uploadToBentley?: boolean;\r\n}\r\n\r\n/** Configuration of core-backend.\r\n * @public\r\n */\r\nexport class IModelHostConfiguration {\r\n\r\n  /**\r\n   * Root of the directory holding all the files that iTwin.js caches\r\n   * - If not specified at startup a platform specific default is used -\r\n   *   - Windows: $(HOMEDIR)/AppData/Local/iModelJs/\r\n   *   - Mac/iOS: $(HOMEDIR)/Library/Caches/iModelJs/\r\n   *   - Linux:   $(HOMEDIR)/.cache/iModelJs/\r\n   *   where $(HOMEDIR) is documented [here](https://nodejs.org/api/os.html#os_os_homedir)\r\n   * - if specified, ensure it is set to a folder with read/write access.\r\n   * - Sub-folders within this folder organize various caches -\r\n   *   - bc/ -> Briefcases\r\n   *   - appSettings/ -> Offline application settings (only relevant in native applications)\r\n   *   - etc.\r\n   * @see [[IModelHost.cacheDir]] for the value it's set to after startup\r\n   */\r\n  public cacheDir?: LocalDirName;\r\n\r\n  /** Options for creating the [[Workspace]]\r\n   * @beta\r\n   */\r\n  public workspace?: WorkspaceOpts;\r\n\r\n  /** The directory where the app's assets are found. */\r\n  public appAssetsDir?: LocalDirName;\r\n\r\n  /** The kind of iModel hub server to use.\r\n   * @beta\r\n   */\r\n  public hubAccess?: BackendHubAccess;\r\n\r\n  /** The Azure blob storage credentials to use for the tile cache service. If omitted and no external service implementation is provided, a local cache will be used.\r\n   * @beta\r\n   */\r\n  public tileCacheAzureCredentials?: AzureBlobStorageCredentials;\r\n\r\n  /**\r\n   * @beta\r\n   * @note A reference implementation is set for [[AzureBlobStorage]] if [[tileCacheAzureCredentials]] property is set. To supply a different implementation for any service provider (such as AWS),\r\n   *       set this property with a custom [[CloudStorageService]].\r\n   */\r\n  public tileCacheService?: CloudStorageService;\r\n\r\n  /** Whether to restrict tile cache URLs by client IP address (if available).\r\n   * @beta\r\n   */\r\n  public restrictTileUrlsByClientIp?: boolean;\r\n\r\n  /** Whether to compress cached tiles.\r\n   * Defaults to `true`.\r\n   */\r\n  public compressCachedTiles?: boolean;\r\n\r\n  /** The time, in milliseconds, for which [IModelTileRpcInterface.requestTileTreeProps]($common) should wait before returning a \"pending\" status.\r\n   * @internal\r\n   */\r\n  public tileTreeRequestTimeout = IModelHostConfiguration.defaultTileRequestTimeout;\r\n  /** The time, in milliseconds, for which [IModelTileRpcInterface.requestTileContent]($common) should wait before returning a \"pending\" status.\r\n   * @internal\r\n   */\r\n  public tileContentRequestTimeout = IModelHostConfiguration.defaultTileRequestTimeout;\r\n  /** The default time, in milliseconds, used for [[tileTreeRequestTimeout]] and [[tileContentRequestTimeout]]. To change this, override one or both of those properties.\r\n   * @internal\r\n   */\r\n  public static defaultTileRequestTimeout = 20 * 1000;\r\n\r\n  /** The default time, in seconds, used for [[logTileLoadTimeThreshold]]. To change this, override that property.\r\n   * @internal\r\n   */\r\n  public static defaultLogTileLoadTimeThreshold = 40;\r\n  /** The backend will log when a tile took longer to load than this threshold in seconds.\r\n   * @internal\r\n   */\r\n  public logTileLoadTimeThreshold: number = IModelHostConfiguration.defaultLogTileLoadTimeThreshold;\r\n\r\n  /** The default size, in bytes, used for [[logTileSizeThreshold]]. To change this, override that property.\r\n   * @internal\r\n   */\r\n  public static defaultLogTileSizeThreshold = 20 * 1000000;\r\n  /** The backend will log when a tile is loaded with a size in bytes above this threshold.\r\n   * @internal\r\n   */\r\n  public logTileSizeThreshold: number = IModelHostConfiguration.defaultLogTileSizeThreshold;\r\n\r\n  /** Crash-reporting configuration\r\n   * @alpha\r\n   */\r\n  public crashReportingConfig?: CrashReportingConfig;\r\n\r\n  /** The AuthorizationClient used to get accessTokens\r\n   * @beta\r\n   */\r\n  public authorizationClient?: AuthorizationClient;\r\n}\r\n\r\n/**\r\n * Settings for the application workspace.\r\n * @note this includes the default dictionary from the SettingsSpecRegistry\r\n */\r\nclass ApplicationSettings extends BaseSettings {\r\n  private _remove?: VoidFunction;\r\n  protected override verifyPriority(priority: SettingsPriority) {\r\n    if (priority >= SettingsPriority.iModel) // iModel settings may not appear in ApplicationSettings\r\n      throw new Error(\"Use IModelSettings\");\r\n  }\r\n  private updateDefaults() {\r\n    const defaults: SettingDictionary = {};\r\n    for (const [specName, val] of SettingsSpecRegistry.allSpecs) {\r\n      if (val.default)\r\n        defaults[specName] = val.default;\r\n    }\r\n    this.addDictionary(\"_default_\", 0, defaults);\r\n  }\r\n\r\n  public constructor() {\r\n    super();\r\n    this._remove = SettingsSpecRegistry.onSpecsChanged.addListener(() => this.updateDefaults());\r\n    this.updateDefaults();\r\n  }\r\n  public override close() {\r\n    if (this._remove) {\r\n      this._remove();\r\n      this._remove = undefined;\r\n    }\r\n  }\r\n}\r\n\r\n/** IModelHost initializes ($backend) and captures its configuration. A backend must call [[IModelHost.startup]] before using any backend classes.\r\n * See [the learning article]($docs/learning/backend/IModelHost.md)\r\n * @public\r\n */\r\nexport class IModelHost {\r\n  private constructor() { }\r\n  public static authorizationClient?: AuthorizationClient;\r\n\r\n  /** @alpha */\r\n  public static readonly telemetry = new TelemetryManager();\r\n\r\n  public static backendVersion = \"\";\r\n  private static _cacheDir = \"\";\r\n  private static _appWorkspace?: Workspace;\r\n\r\n  private static _platform?: typeof IModelJsNative;\r\n  /** @internal */\r\n  public static get platform(): typeof IModelJsNative {\r\n    if (this._platform === undefined)\r\n      throw new Error(\"IModelHost.startup must be called first\");\r\n    return this._platform;\r\n  }\r\n\r\n  public static configuration?: IModelHostConfiguration;\r\n  /** Event raised just after the backend IModelHost was started */\r\n  public static readonly onAfterStartup = new BeEvent<() => void>();\r\n\r\n  /** Event raised just before the backend IModelHost is to be shut down */\r\n  public static readonly onBeforeShutdown = new BeEvent<() => void>();\r\n\r\n  /** @internal */\r\n  public static readonly session: Mutable<SessionProps> = { applicationId: \"2686\", applicationVersion: \"1.0.0\", sessionId: \"\" };\r\n\r\n  /** A uniqueId for this session */\r\n  public static get sessionId() { return this.session.sessionId; }\r\n  public static set sessionId(id: GuidString) { this.session.sessionId = id; }\r\n\r\n  /** The Id of this application - needs to be set only if it is an agent application. The applicationId will otherwise originate at the frontend. */\r\n  public static get applicationId() { return this.session.applicationId; }\r\n  public static set applicationId(id: string) { this.session.applicationId = id; }\r\n\r\n  /** The version of this application - needs to be set if is an agent application. The applicationVersion will otherwise originate at the frontend. */\r\n  public static get applicationVersion() { return this.session.applicationVersion; }\r\n  public static set applicationVersion(version: string) { this.session.applicationVersion = version; }\r\n\r\n  /** Root directory holding files that iTwin.js caches */\r\n  public static get cacheDir(): LocalDirName { return this._cacheDir; }\r\n\r\n  /** The application [[Workspace]] for this `IModelHost`\r\n   * @note this `Workspace` only holds [[WorkspaceContainer]]s and [[Settings]] scoped to the currently loaded application(s).\r\n   * All organization, iTwin, and iModel based containers or settings must be accessed through [[IModelDb.workspace]] and\r\n   * attempting to add them to this Workspace will fail.\r\n   * @beta\r\n   */\r\n  public static get appWorkspace(): Workspace { return this._appWorkspace!; } // eslint-disable-line @typescript-eslint/no-non-null-assertion\r\n\r\n  /** The optional [[FileNameResolver]] that resolves keys and partial file names for snapshot iModels. */\r\n  public static snapshotFileNameResolver?: FileNameResolver;\r\n\r\n  /** Get the current access token for this IModelHost, or a blank string if none is available.\r\n   * @note for web backends, this will *always* return a blank string because the backend itself has no token (but never needs one either.)\r\n   * For all IpcHosts, where this backend is servicing a single frontend, this will be the user's token. For ElectronHost, the backend\r\n   * obtains the token and forwards it to the frontend.\r\n   * @note accessTokens expire periodically and are automatically refreshed, if possible. Therefore tokens should not be saved, and the value\r\n   * returned by this method may change over time throughout the course of a session.\r\n   */\r\n  public static async getAccessToken(): Promise<AccessToken> {\r\n    try {\r\n      return (await this.authorizationClient?.getAccessToken()) ?? \"\";\r\n    } catch (e) {\r\n      return \"\";\r\n    }\r\n  }\r\n\r\n  /** @internal */\r\n  public static flushLog() {\r\n    return this.platform.DgnDb.flushLog();\r\n  }\r\n  /** @internal */\r\n  public static loadNative(): void {\r\n    const platform = Platform.load();\r\n    this.registerPlatform(platform);\r\n  }\r\n\r\n  private static registerPlatform(platform: typeof IModelJsNative): void {\r\n    this._platform = platform;\r\n    if (undefined === platform)\r\n      return;\r\n\r\n    if (!ProcessDetector.isMobileAppBackend)\r\n      this.validateNativePlatformVersion();\r\n\r\n    platform.logger = Logger;\r\n  }\r\n\r\n  private static validateNativePlatformVersion(): void {\r\n    const requiredVersion = require(\"../../package.json\").dependencies[\"@bentley/imodeljs-native\"]; // eslint-disable-line @typescript-eslint/no-var-requires\r\n    const thisVersion = this.platform.version;\r\n    if (semver.satisfies(thisVersion, requiredVersion))\r\n      return;\r\n    if (IModelJsFs.existsSync(path.join(__dirname, \"DevBuild.txt\"))) {\r\n      console.log(\"Bypassing version checks for development build\"); // eslint-disable-line no-console\r\n      return;\r\n    }\r\n    this._platform = undefined;\r\n    throw new IModelError(IModelStatus.BadRequest, `imodeljs-native version is (${thisVersion}). core-backend requires version (${requiredVersion})`);\r\n  }\r\n\r\n  /**\r\n   * @internal\r\n   * @note Use [[IModelHostConfiguration.tileCacheService]] to set the service provider.\r\n   */\r\n  public static tileCacheService?: CloudStorageService;\r\n\r\n  /** @internal */\r\n  public static tileUploader?: CloudStorageTileUploader;\r\n\r\n  private static _hubAccess: BackendHubAccess;\r\n  /** @internal */\r\n  public static setHubAccess(hubAccess: BackendHubAccess) { this._hubAccess = hubAccess; }\r\n\r\n  /** Provides access to the IModelHub for this IModelHost\r\n   * @beta\r\n   */\r\n  public static get hubAccess(): BackendHubAccess { return this._hubAccess; }\r\n\r\n  private static _isValid = false;\r\n  /** Returns true if IModelHost is started.  */\r\n  public static get isValid() { return this._isValid; }\r\n  /** This method must be called before any iTwin.js services are used.\r\n   * @param configuration Host configuration data.\r\n   * Raises [[onAfterStartup]].\r\n   * @see [[shutdown]].\r\n   */\r\n  public static async startup(configuration: IModelHostConfiguration = new IModelHostConfiguration()): Promise<void> {\r\n    if (this._isValid)\r\n      return; // we're already initialized\r\n    this._isValid = true;\r\n\r\n    if (IModelHost.sessionId === \"\")\r\n      IModelHost.sessionId = Guid.createValue();\r\n\r\n    this.authorizationClient = configuration.authorizationClient;\r\n\r\n    this.logStartup();\r\n\r\n    this.backendVersion = require(\"../../package.json\").version; // eslint-disable-line @typescript-eslint/no-var-requires\r\n    initializeRpcBackend();\r\n\r\n    if (this._platform === undefined) {\r\n      try {\r\n        this.loadNative();\r\n      } catch (error) {\r\n        Logger.logError(loggerCategory, \"Error registering/loading the native platform API\", () => (configuration));\r\n        throw error;\r\n      }\r\n    }\r\n\r\n    if (configuration.crashReportingConfig && configuration.crashReportingConfig.crashDir && !ProcessDetector.isElectronAppBackend && !ProcessDetector.isMobileAppBackend) {\r\n      this.platform.setCrashReporting(configuration.crashReportingConfig);\r\n\r\n      Logger.logTrace(loggerCategory, \"Configured crash reporting\", () => ({\r\n        enableCrashDumps: configuration.crashReportingConfig?.enableCrashDumps,\r\n        wantFullMemoryDumps: configuration.crashReportingConfig?.wantFullMemoryDumps,\r\n        enableNodeReport: configuration.crashReportingConfig?.enableNodeReport,\r\n        uploadToBentley: configuration.crashReportingConfig?.uploadToBentley,\r\n      }));\r\n\r\n      if (configuration.crashReportingConfig.enableNodeReport) {\r\n        try {\r\n          // node-report reports on V8 fatal errors and unhandled exceptions/Promise rejections.\r\n          const nodereport = require(\"node-report/api\"); // eslint-disable-line @typescript-eslint/no-var-requires\r\n          nodereport.setEvents(\"exception+fatalerror+apicall\");\r\n          nodereport.setDirectory(configuration.crashReportingConfig.crashDir);\r\n          nodereport.setVerbose(\"yes\");\r\n          Logger.logTrace(loggerCategory, \"Configured native crash reporting (node-report)\");\r\n        } catch (err) {\r\n          Logger.logWarning(loggerCategory, \"node-report is not installed.\");\r\n        }\r\n      }\r\n    }\r\n\r\n    this.setupHostDirs(configuration);\r\n    this._appWorkspace = new ITwinWorkspace(new ApplicationSettings(), configuration.workspace);\r\n\r\n    BriefcaseManager.initialize(this._briefcaseCacheDir);\r\n\r\n    [\r\n      IModelReadRpcImpl,\r\n      IModelTileRpcImpl,\r\n      SnapshotIModelRpcImpl,\r\n      WipRpcImpl,\r\n      DevToolsRpcImpl,\r\n    ].forEach((rpc) => rpc.register()); // register all of the RPC implementations\r\n\r\n    [\r\n      BisCoreSchema,\r\n      GenericSchema,\r\n      FunctionalSchema,\r\n    ].forEach((schema) => schema.registerSchema()); // register all of the schemas\r\n\r\n    if (undefined !== configuration.hubAccess)\r\n      IModelHost._hubAccess = configuration.hubAccess;\r\n    IModelHost.configuration = configuration;\r\n    IModelHost.setupTileCache();\r\n\r\n    this.platform.setUseTileCache(IModelHost.tileCacheService ? false : true);\r\n\r\n    process.once(\"beforeExit\", IModelHost.shutdown);\r\n    IModelHost.onAfterStartup.raiseEvent();\r\n  }\r\n\r\n  private static _briefcaseCacheDir: LocalDirName;\r\n\r\n  private static logStartup() {\r\n    if (!Logger.isEnabled(loggerCategory, LogLevel.Trace))\r\n      return;\r\n\r\n    // Extract the iModel details from environment - note this is very specific to Bentley hosted backends, but is quite useful for tracing\r\n    let startupInfo: any = {};\r\n    const serviceName = process.env.FABRIC_SERVICE_NAME;\r\n    if (serviceName) {\r\n      // e.g., fabric:/iModelWebViewer3.0/iModelJSGuest/1/08daaeb3-b56f-480b-9051-7efc834d18ae/512d971d-b641-4735-bb1c-c07ab3e44ce7/c1315fcce125ca40b2d405bb7809214daf8b4c85\r\n      const serviceNameComponents = serviceName.split(\"/\");\r\n      if (serviceNameComponents.length === 7) {\r\n        startupInfo = {\r\n          ...startupInfo,\r\n          iTwinId: serviceNameComponents[4],\r\n          iModelId: serviceNameComponents[5],\r\n          changesetId: serviceNameComponents[6],\r\n        };\r\n      }\r\n    }\r\n\r\n    Logger.logTrace(loggerCategory, \"IModelHost.startup\", () => startupInfo);\r\n  }\r\n\r\n  private static setupHostDirs(configuration: IModelHostConfiguration) {\r\n    const setupDir = (dir: LocalDirName) => {\r\n      dir = path.normalize(dir);\r\n      IModelJsFs.recursiveMkDirSync(dir);\r\n      return dir;\r\n    };\r\n    this._cacheDir = setupDir(configuration.cacheDir ?? NativeLibrary.defaultCacheDir);\r\n    this._briefcaseCacheDir = path.join(this._cacheDir, \"imodels\");\r\n  }\r\n\r\n  /** This method must be called when an iTwin.js host is shut down. Raises [[onBeforeShutdown]] */\r\n  public static async shutdown(): Promise<void> {\r\n    // NB: This method is set as a node listener where `this` is unbound\r\n    if (!IModelHost._isValid)\r\n      return;\r\n\r\n    IModelHost._isValid = false;\r\n    IModelHost.onBeforeShutdown.raiseEvent();\r\n    IModelHost.configuration = undefined;\r\n    IModelHost.tileCacheService = undefined;\r\n    IModelHost.tileUploader = undefined;\r\n    IModelHost.appWorkspace.close();\r\n    IModelHost._appWorkspace = undefined;\r\n    process.removeListener(\"beforeExit\", IModelHost.shutdown);\r\n  }\r\n\r\n  /**\r\n   * Add or update a property that should be included in a crash report.\r\n   * @param name The name of the property\r\n   * @param value The value of the property\r\n   * @alpha\r\n   */\r\n  public static setCrashReportProperty(name: string, value: string): void {\r\n    assert(undefined !== this._platform);\r\n    this._platform.setCrashReportProperty(name, value);\r\n  }\r\n\r\n  /**\r\n   * Remove a previously defined property so that will not be included in a crash report.\r\n   * @param name The name of the property\r\n   * @alpha\r\n   */\r\n  public static removeCrashReportProperty(name: string): void {\r\n    assert(undefined !== this._platform);\r\n    this._platform.setCrashReportProperty(name, undefined);\r\n  }\r\n\r\n  /**\r\n   * Get all properties that will be included in a crash report.\r\n   * @alpha\r\n   */\r\n  public static getCrashReportProperties(): CrashReportingConfigNameValuePair[] {\r\n    assert(undefined !== this._platform);\r\n    return this._platform.getCrashReportProperties();\r\n  }\r\n\r\n  /** The directory where application assets may be found */\r\n  public static get appAssetsDir(): string | undefined { return undefined !== IModelHost.configuration ? IModelHost.configuration.appAssetsDir : undefined; }\r\n\r\n  /** The time, in milliseconds, for which [IModelTileRpcInterface.requestTileTreeProps]($common) should wait before returning a \"pending\" status.\r\n   * @internal\r\n   */\r\n  public static get tileTreeRequestTimeout(): number {\r\n    return undefined !== IModelHost.configuration ? IModelHost.configuration.tileTreeRequestTimeout : IModelHostConfiguration.defaultTileRequestTimeout;\r\n  }\r\n  /** The time, in milliseconds, for which [IModelTileRpcInterface.requestTileContent]($common) should wait before returning a \"pending\" status.\r\n   * @internal\r\n   */\r\n  public static get tileContentRequestTimeout(): number {\r\n    return undefined !== IModelHost.configuration ? IModelHost.configuration.tileContentRequestTimeout : IModelHostConfiguration.defaultTileRequestTimeout;\r\n  }\r\n\r\n  /** The backend will log when a tile took longer to load than this threshold in seconds. */\r\n  public static get logTileLoadTimeThreshold(): number { return undefined !== IModelHost.configuration ? IModelHost.configuration.logTileLoadTimeThreshold : IModelHostConfiguration.defaultLogTileLoadTimeThreshold; }\r\n  /** The backend will log when a tile is loaded with a size in bytes above this threshold. */\r\n  public static get logTileSizeThreshold(): number { return undefined !== IModelHost.configuration ? IModelHost.configuration.logTileSizeThreshold : IModelHostConfiguration.defaultLogTileSizeThreshold; }\r\n\r\n  /** Whether external tile caching is active.\r\n   * @internal\r\n   */\r\n  public static get usingExternalTileCache(): boolean {\r\n    return undefined !== IModelHost.tileCacheService;\r\n  }\r\n\r\n  /** Whether to restrict tile cache URLs by client IP address.\r\n   * @internal\r\n   */\r\n  public static get restrictTileUrlsByClientIp(): boolean { return undefined !== IModelHost.configuration && (IModelHost.configuration.restrictTileUrlsByClientIp ? true : false); }\r\n\r\n  /** Whether to compress cached tiles.\r\n   * @internal\r\n   */\r\n  public static get compressCachedTiles(): boolean { return false !== IModelHost.configuration?.compressCachedTiles; }\r\n\r\n  private static setupTileCache() {\r\n    assert(undefined !== IModelHost.configuration);\r\n    const config = IModelHost.configuration;\r\n    const service = config.tileCacheService;\r\n    const credentials = config.tileCacheAzureCredentials;\r\n\r\n    if (!service && !credentials)\r\n      return;\r\n\r\n    IModelHost.tileUploader = new CloudStorageTileUploader();\r\n\r\n    if (credentials && !service) {\r\n      IModelHost.tileCacheService = new AzureBlobStorage(credentials);\r\n    } else if (!credentials && service) {\r\n      IModelHost.tileCacheService = service;\r\n    } else {\r\n      throw new IModelError(BentleyStatus.ERROR, \"Cannot use both Azure and custom cloud storage providers for tile cache.\");\r\n    }\r\n  }\r\n}\r\n\r\n/** Information about the platform on which the app is running. Also see [[KnownLocations]] and [[IModelJsFs]].\r\n * @public\r\n */\r\nexport class Platform {\r\n  /** Get the name of the platform. */\r\n  public static get platformName(): \"win32\" | \"linux\" | \"darwin\" | \"ios\" | \"android\" | \"uwp\" {\r\n    return process.platform as any;\r\n  }\r\n\r\n  /** @internal */\r\n  public static load(): typeof IModelJsNative {\r\n    return ProcessDetector.isMobileAppBackend ? (process as any)._linkedBinding(\"iModelJsNative\") : NativeLibrary.load();\r\n  }\r\n}\r\n\r\n/** Well known directories that may be used by the application. Also see [[Platform]]\r\n * @public\r\n */\r\nexport class KnownLocations {\r\n\r\n  /** The directory where the imodeljs-native assets are stored. */\r\n  public static get nativeAssetsDir(): string { return IModelHost.platform.DgnDb.getAssetsDir(); }\r\n\r\n  /** The directory where the core-backend assets are stored. */\r\n  public static get packageAssetsDir(): string {\r\n    return path.join(__dirname, \"assets\");\r\n  }\r\n\r\n  /** The temporary directory. */\r\n  public static get tmpdir(): string {\r\n    return os.tmpdir();\r\n  }\r\n}\r\n\r\n/** Extend this class to provide custom file name resolution behavior.\r\n * @note Only `tryResolveKey` and/or `tryResolveFileName` need to be overridden as the implementations of `resolveKey` and `resolveFileName` work for most purposes.\r\n * @see [[IModelHost.snapshotFileNameResolver]]\r\n * @public\r\n */\r\nexport abstract class FileNameResolver {\r\n  /** Resolve a file name from the specified key.\r\n   * @param _fileKey The key that identifies the file name in a `Map` or other similar data structure.\r\n   * @returns The resolved file name or `undefined` if not found.\r\n   */\r\n  public tryResolveKey(_fileKey: string): string | undefined { return undefined; }\r\n  /** Resolve a file name from the specified key.\r\n   * @param fileKey The key that identifies the file name in a `Map` or other similar data structure.\r\n   * @returns The resolved file name.\r\n   * @throws [[IModelError]] if not found.\r\n   */\r\n  public resolveKey(fileKey: string): string {\r\n    const resolvedFileName: string | undefined = this.tryResolveKey(fileKey);\r\n    if (undefined === resolvedFileName) {\r\n      throw new IModelError(IModelStatus.NotFound, `${fileKey} not resolved`);\r\n    }\r\n    return resolvedFileName;\r\n  }\r\n  /** Resolve the input file name, which may be a partial name, into a full path file name.\r\n   * @param inFileName The partial file name.\r\n   * @returns The resolved full path file name or `undefined` if not found.\r\n   */\r\n  public tryResolveFileName(inFileName: string): string | undefined { return inFileName; }\r\n  /** Resolve the input file name, which may be a partial name, into a full path file name.\r\n   * @param inFileName The partial file name.\r\n   * @returns The resolved full path file name.\r\n   * @throws [[IModelError]] if not found.\r\n   */\r\n  public resolveFileName(inFileName: string): string {\r\n    const resolvedFileName: string | undefined = this.tryResolveFileName(inFileName);\r\n    if (undefined === resolvedFileName) {\r\n      throw new IModelError(IModelStatus.NotFound, `${inFileName} not resolved`);\r\n    }\r\n    return resolvedFileName;\r\n  }\r\n}\r\n"]}

package/lib/cjs/IModelJsFs.js

@@ -100,7 +100,7 @@ class IModelJsFs {
         for (const childPath of IModelJsFs.readdirSync(rootDir)) {
             const fullPath = path.join(rootDir, childPath);
             const isDir = (_a = IModelJsFs.lstatSync(fullPath)) === null || _a === void 0 ? void 0 : _a.isDirectory;
-            if (!cb(fullPath, isDir)) {
+            if (!cb(fullPath, isDir !== null && isDir !== void 0 ? isDir : false)) {
                 return;
             }
             // Need to check if the directory still exists in case the callback has deleted it.

package/lib/cjs/IModelJsFs.js.map

@@ -1 +1 @@
-{"version":3,"file":"IModelJsFs.js","sourceRoot":"","sources":["../../src/IModelJsFs.ts"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\r\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\r\n* See LICENSE.md in the project root for license terms and full copyright notice.\r\n*--------------------------------------------------------------------------------------------*/\r\n\r\n/** @packageDocumentation\r\n * @module Portability\r\n */\r\n\r\n// cspell: ignore wflag\r\n\r\nimport * as fs from \"fs-extra\";\r\nimport * as path from \"path\";\r\n\r\n/* TODO: define File Mode Constants: S_IWUSR, et al. */\r\n/** Information about a file. See [[IModelJsFs.lstatSync]]\r\n * @public\r\n */\r\nexport class IModelJsFsStats {\r\n  constructor(\r\n    public size: number,\r\n    public atimeMs: number,\r\n    public mtimeMs: number,\r\n    public birthtimeMs: number,\r\n    public isDirectory: boolean,\r\n    public isFile: boolean,\r\n    public isSocket: boolean,\r\n    public isSymbolicLink: boolean,\r\n    public isReadOnly: boolean,\r\n  ) { }\r\n}\r\n\r\n/** File system operations that are defined on all platforms. See also [[Platform]] and [[KnownLocations]]\r\n * @public\r\n */\r\nexport class IModelJsFs {\r\n\r\n  /** Does file or directory exist? */\r\n  public static existsSync(pathname: string): boolean { return fs.existsSync(pathname); }\r\n\r\n  /** Delete a file. */\r\n  public static unlinkSync(pathname: string): void { fs.unlinkSync(pathname); }\r\n\r\n  /** Delete a file or remove a directory (rm -r). */\r\n  public static removeSync(pathname: string): void { fs.removeSync(pathname); }\r\n\r\n  /** Create a directory. */\r\n  public static mkdirSync(pathname: string): void { fs.mkdirSync(pathname); }\r\n\r\n  /** Remove a directory. */\r\n  public static rmdirSync(pathname: string): void { fs.rmdirSync(pathname); }\r\n\r\n  /** Write to a file. */\r\n  public static writeFileSync(pathname: string, data: string | Uint8Array, wflag: string = \"w\"): void { fs.writeFileSync(pathname, data, { flag: wflag }); }\r\n\r\n  /** Append to a file. */\r\n  public static appendFileSync(pathname: string, str: string): void { fs.appendFileSync(pathname, str); }\r\n\r\n  /** Make a copy of a file */\r\n  public static copySync(src: string, dest: string, opts?: any): void { fs.copySync(src, dest, opts); }\r\n\r\n  /** Get the file and directory names in the specified directory. Excludes \".\" and \"..\". */\r\n  public static readdirSync(pathname: string): string[] { return fs.readdirSync(pathname); }\r\n\r\n  /** Read file */\r\n  public static readFileSync(pathname: string): string | Buffer { return fs.readFileSync(pathname); }\r\n\r\n  /** Test if the current user has permission to write to a file. */\r\n  private static isFileWritable(pathname: string): boolean {\r\n    try {\r\n      fs.accessSync(pathname, fs.constants.W_OK);\r\n      return true;\r\n    } catch (_err) {\r\n      return false;\r\n    }\r\n  }\r\n\r\n  /** Get information about a file. */\r\n  public static lstatSync(pathname: string): IModelJsFsStats | undefined {\r\n    const stats = fs.lstatSync(pathname);\r\n    if (stats === undefined)\r\n      return undefined;\r\n\r\n    return new IModelJsFsStats(\r\n      stats.size,\r\n      stats.atime.getTime(),\r\n      stats.mtime.getTime(),\r\n      stats.birthtime.getTime(),\r\n      stats.isDirectory(),\r\n      stats.isFile(),\r\n      stats.isSocket(),\r\n      stats.isSymbolicLink(),\r\n      !IModelJsFs.isFileWritable(pathname));\r\n  }\r\n\r\n  /**\r\n   * Finds files recursively based on a pattern\r\n   * @param rootDir Directory from where to start searching for files.\r\n   * @param pattern A Regex that would be match to basename of files including extension\r\n   * @returns list of file that match the pattern.\r\n   */\r\n  public static recursiveFindSync(rootDir: string, pattern: RegExp): string[] {\r\n    const files: string[] = [];\r\n    IModelJsFs.walkDirSync(rootDir, (pathname: string, isDir: boolean) => {\r\n      if (!isDir) {\r\n        const fileName = path.basename(pathname);\r\n        if (pattern.test(fileName)) {\r\n          files.push(pathname);\r\n        }\r\n      }\r\n      return true;\r\n    });\r\n    return files;\r\n  }\r\n\r\n  /**\r\n   * Walks a directory in breadth first fashion\r\n   * @param rootDir  directory from where the traversal starts\r\n   * @param cb callback that would be called with full path of file or directory\r\n   */\r\n  public static walkDirSync(rootDir: string, cb: (pathname: string, isDir: boolean) => boolean): void {\r\n    const subDir = [];\r\n    for (const childPath of IModelJsFs.readdirSync(rootDir)) {\r\n      const fullPath = path.join(rootDir, childPath);\r\n      const isDir = IModelJsFs.lstatSync(fullPath)?.isDirectory;\r\n      if (!cb(fullPath, isDir!)) {\r\n        return;\r\n      }\r\n      // Need to check if the directory still exists in case the callback has deleted it.\r\n      if (isDir && IModelJsFs.existsSync(fullPath)) {\r\n        subDir.push(fullPath);\r\n      }\r\n    }\r\n    subDir.forEach((v) => {\r\n      IModelJsFs.walkDirSync(v, cb);\r\n    });\r\n  }\r\n\r\n  /** Create a directory, recursively setting up the path as necessary */\r\n  public static recursiveMkDirSync(dirPath: string) {\r\n    if (IModelJsFs.existsSync(dirPath))\r\n      return;\r\n    const parentPath = path.dirname(dirPath);\r\n    if (parentPath !== dirPath)\r\n      IModelJsFs.recursiveMkDirSync(parentPath);\r\n    IModelJsFs.mkdirSync(dirPath);\r\n  }\r\n\r\n  /** Remove a directory, recursively */\r\n  public static purgeDirSync(dirPath: string) {\r\n    if (!IModelJsFs.existsSync(dirPath))\r\n      return;\r\n\r\n    IModelJsFs.walkDirSync(dirPath, (pathName: string, isDir: boolean) => {\r\n      if (isDir) {\r\n        IModelJsFs.purgeDirSync(pathName);\r\n        IModelJsFs.removeSync(pathName);\r\n      } else {\r\n        IModelJsFs.unlinkSync(pathName);\r\n      }\r\n      return true;\r\n    });\r\n  }\r\n}\r\n"]}
+{"version":3,"file":"IModelJsFs.js","sourceRoot":"","sources":["../../src/IModelJsFs.ts"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\r\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\r\n* See LICENSE.md in the project root for license terms and full copyright notice.\r\n*--------------------------------------------------------------------------------------------*/\r\n\r\n/** @packageDocumentation\r\n * @module Portability\r\n */\r\n\r\n// cspell: ignore wflag\r\n\r\nimport * as fs from \"fs-extra\";\r\nimport * as path from \"path\";\r\n\r\n/* TODO: define File Mode Constants: S_IWUSR, et al. */\r\n/** Information about a file. See [[IModelJsFs.lstatSync]]\r\n * @public\r\n */\r\nexport class IModelJsFsStats {\r\n  constructor(\r\n    public size: number,\r\n    public atimeMs: number,\r\n    public mtimeMs: number,\r\n    public birthtimeMs: number,\r\n    public isDirectory: boolean,\r\n    public isFile: boolean,\r\n    public isSocket: boolean,\r\n    public isSymbolicLink: boolean,\r\n    public isReadOnly: boolean,\r\n  ) { }\r\n}\r\n\r\n/** File system operations that are defined on all platforms. See also [[Platform]] and [[KnownLocations]]\r\n * @public\r\n */\r\nexport class IModelJsFs {\r\n\r\n  /** Does file or directory exist? */\r\n  public static existsSync(pathname: string): boolean { return fs.existsSync(pathname); }\r\n\r\n  /** Delete a file. */\r\n  public static unlinkSync(pathname: string): void { fs.unlinkSync(pathname); }\r\n\r\n  /** Delete a file or remove a directory (rm -r). */\r\n  public static removeSync(pathname: string): void { fs.removeSync(pathname); }\r\n\r\n  /** Create a directory. */\r\n  public static mkdirSync(pathname: string): void { fs.mkdirSync(pathname); }\r\n\r\n  /** Remove a directory. */\r\n  public static rmdirSync(pathname: string): void { fs.rmdirSync(pathname); }\r\n\r\n  /** Write to a file. */\r\n  public static writeFileSync(pathname: string, data: string | Uint8Array, wflag: string = \"w\"): void { fs.writeFileSync(pathname, data, { flag: wflag }); }\r\n\r\n  /** Append to a file. */\r\n  public static appendFileSync(pathname: string, str: string): void { fs.appendFileSync(pathname, str); }\r\n\r\n  /** Make a copy of a file */\r\n  public static copySync(src: string, dest: string, opts?: any): void { fs.copySync(src, dest, opts); }\r\n\r\n  /** Get the file and directory names in the specified directory. Excludes \".\" and \"..\". */\r\n  public static readdirSync(pathname: string): string[] { return fs.readdirSync(pathname); }\r\n\r\n  /** Read file */\r\n  public static readFileSync(pathname: string): string | Buffer { return fs.readFileSync(pathname); }\r\n\r\n  /** Test if the current user has permission to write to a file. */\r\n  private static isFileWritable(pathname: string): boolean {\r\n    try {\r\n      fs.accessSync(pathname, fs.constants.W_OK);\r\n      return true;\r\n    } catch (_err) {\r\n      return false;\r\n    }\r\n  }\r\n\r\n  /** Get information about a file. */\r\n  public static lstatSync(pathname: string): IModelJsFsStats | undefined {\r\n    const stats = fs.lstatSync(pathname);\r\n    if (stats === undefined)\r\n      return undefined;\r\n\r\n    return new IModelJsFsStats(\r\n      stats.size,\r\n      stats.atime.getTime(),\r\n      stats.mtime.getTime(),\r\n      stats.birthtime.getTime(),\r\n      stats.isDirectory(),\r\n      stats.isFile(),\r\n      stats.isSocket(),\r\n      stats.isSymbolicLink(),\r\n      !IModelJsFs.isFileWritable(pathname));\r\n  }\r\n\r\n  /**\r\n   * Finds files recursively based on a pattern\r\n   * @param rootDir Directory from where to start searching for files.\r\n   * @param pattern A Regex that would be match to basename of files including extension\r\n   * @returns list of file that match the pattern.\r\n   */\r\n  public static recursiveFindSync(rootDir: string, pattern: RegExp): string[] {\r\n    const files: string[] = [];\r\n    IModelJsFs.walkDirSync(rootDir, (pathname: string, isDir: boolean) => {\r\n      if (!isDir) {\r\n        const fileName = path.basename(pathname);\r\n        if (pattern.test(fileName)) {\r\n          files.push(pathname);\r\n        }\r\n      }\r\n      return true;\r\n    });\r\n    return files;\r\n  }\r\n\r\n  /**\r\n   * Walks a directory in breadth first fashion\r\n   * @param rootDir  directory from where the traversal starts\r\n   * @param cb callback that would be called with full path of file or directory\r\n   */\r\n  public static walkDirSync(rootDir: string, cb: (pathname: string, isDir: boolean) => boolean): void {\r\n    const subDir = [];\r\n    for (const childPath of IModelJsFs.readdirSync(rootDir)) {\r\n      const fullPath = path.join(rootDir, childPath);\r\n      const isDir = IModelJsFs.lstatSync(fullPath)?.isDirectory;\r\n      if (!cb(fullPath, isDir ?? false)) {\r\n        return;\r\n      }\r\n      // Need to check if the directory still exists in case the callback has deleted it.\r\n      if (isDir && IModelJsFs.existsSync(fullPath)) {\r\n        subDir.push(fullPath);\r\n      }\r\n    }\r\n    subDir.forEach((v) => {\r\n      IModelJsFs.walkDirSync(v, cb);\r\n    });\r\n  }\r\n\r\n  /** Create a directory, recursively setting up the path as necessary */\r\n  public static recursiveMkDirSync(dirPath: string) {\r\n    if (IModelJsFs.existsSync(dirPath))\r\n      return;\r\n    const parentPath = path.dirname(dirPath);\r\n    if (parentPath !== dirPath)\r\n      IModelJsFs.recursiveMkDirSync(parentPath);\r\n    IModelJsFs.mkdirSync(dirPath);\r\n  }\r\n\r\n  /** Remove a directory, recursively */\r\n  public static purgeDirSync(dirPath: string) {\r\n    if (!IModelJsFs.existsSync(dirPath))\r\n      return;\r\n\r\n    IModelJsFs.walkDirSync(dirPath, (pathName: string, isDir: boolean) => {\r\n      if (isDir) {\r\n        IModelJsFs.purgeDirSync(pathName);\r\n        IModelJsFs.removeSync(pathName);\r\n      } else {\r\n        IModelJsFs.unlinkSync(pathName);\r\n      }\r\n      return true;\r\n    });\r\n  }\r\n}\r\n"]}

package/lib/cjs/IpcHost.js

@@ -20,7 +20,7 @@ const IModelTileRpcImpl_1 = require("./rpc-impl/IModelTileRpcImpl");
  */
 class IpcHost {
     /** Get the implementation of the [IpcSocketBackend]($common) interface. */
-    static get ipc() { return this._ipc; }
+    static get ipc() { return this._ipc; } // eslint-disable-line @typescript-eslint/no-non-null-assertion
     /** Determine whether Ipc is available for this backend. This will only be true if [[startup]] has been called on this class. */
     static get isValid() { return undefined !== this._ipc; }
     /**
@@ -210,6 +210,7 @@ class IpcAppHandler extends IpcHandler {
         const val = IModelDb_1.IModelDb.findByKey(key).nativeDb.setGeometricModelTrackingEnabled(startSession);
         if (val.error)
             throw new core_common_1.IModelError(val.error.status, "Failed to toggle graphical editing scope");
+        (0, core_bentley_1.assert)(undefined !== val.result);
         return val.result;
     }
     async isGraphicalEditingSupported(key) {