@itwin/core-backend 3.3.0-dev.6 → 3.3.0-dev.60

package/lib/cjs/IModelHost.d.ts

@@ -2,9 +2,9 @@
  * @module IModelHost
  */
 import { IModelJsNative } from "@bentley/imodeljs-native";
-import { TelemetryManager } from "@itwin/core-telemetry";
 import { AccessToken, BeEvent, GuidString, Mutable } from "@itwin/core-bentley";
 import { AuthorizationClient, LocalDirName, SessionProps } from "@itwin/core-common";
+import { TelemetryManager } from "@itwin/core-telemetry";
 import { BackendHubAccess } from "./BackendHubAccess";
 import { AzureBlobStorageCredentials, CloudStorageService, CloudStorageTileUploader } from "./CloudStorageBackend";
 import { Workspace, WorkspaceOpts } from "./workspace/Workspace";
@@ -139,6 +139,8 @@ export declare class IModelHost {
     /** @internal */
     static get platform(): typeof IModelJsNative;
     static configuration?: IModelHostConfiguration;
+    /** Event raised during startup to allow loading settings data */
+    static readonly onWorkspaceStartup: BeEvent<() => void>;
     /** Event raised just after the backend IModelHost was started */
     static readonly onAfterStartup: BeEvent<() => void>;
     /** Event raised just before the backend IModelHost is to be shut down */
@@ -186,14 +188,20 @@ export declare class IModelHost {
     static tileCacheService?: CloudStorageService;
     /** @internal */
     static tileUploader?: CloudStorageTileUploader;
-    private static _hubAccess;
+    private static _hubAccess?;
     /** @internal */
-    static setHubAccess(hubAccess: BackendHubAccess): void;
+    static setHubAccess(hubAccess: BackendHubAccess | undefined): void;
+    /** get the current hubAccess, if present.
+     * @beta
+     */
+    static getHubAccess(): BackendHubAccess | undefined;
     /** Provides access to the IModelHub for this IModelHost
      * @beta
      * @note If [[IModelHostConfiguration.hubAccess]] was undefined when initializing this class, accessing this property will throw an error.
+     * To determine whether one is present, use [[getHubAccess]].
      */
     static get hubAccess(): BackendHubAccess;
+    private static initializeWorkspace;
     private static _isValid;
     /** Returns true if IModelHost is started.  */
     static get isValid(): boolean;
@@ -253,6 +261,12 @@ export declare class IModelHost {
      */
     static get compressCachedTiles(): boolean;
     private static setupTileCache;
+    /** @internal */
+    static computeSchemaChecksum(arg: {
+        schemaXmlPath: string;
+        referencePaths: string[];
+        exactMatch?: boolean;
+    }): string;
 }
 /** Information about the platform on which the app is running. Also see [[KnownLocations]] and [[IModelJsFs]].
  * @public

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;AAKH,OAAO,EAAE,cAAc,EAAiB,MAAM,0BAA0B,CAAC;AACzE,OAAO,EAAE,WAAW,EAAU,OAAO,EAAQ,UAAU,EAAkC,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;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAItD,OAAO,EAAoB,2BAA2B,EAAE,mBAAmB,EAAE,wBAAwB,EAAE,MAAM,uBAAuB,CAAC;AAarI,OAAO,EAAkB,SAAS,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAMjF,aAAa;AACb,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,0KAA0K;IAC1K,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;;GAEG;AACH,qBAAa,uBAAuB;IAElC;;;;;;;;;;;;;OAaG;IACI,QAAQ,CAAC,EAAE,YAAY,CAAC;IAE/B;;OAEG;IACI,SAAS,CAAC,EAAE,aAAa,CAAC;IAEjC,sDAAsD;IAC/C,YAAY,CAAC,EAAE,YAAY,CAAC;IAEnC;;OAEG;IACI,SAAS,CAAC,EAAE,gBAAgB,CAAC;IAEpC;;OAEG;IACI,yBAAyB,CAAC,EAAE,2BAA2B,CAAC;IAE/D;;;;OAIG;IACI,gBAAgB,CAAC,EAAE,mBAAmB,CAAC;IAE9C;;OAEG;IACI,0BAA0B,CAAC,EAAE,OAAO,CAAC;IAE5C;;OAEG;IACI,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAErC;;OAEG;IACI,sBAAsB,SAAqD;IAClF;;OAEG;IACI,yBAAyB,SAAqD;IACrF;;OAEG;IACH,OAAc,yBAAyB,SAAa;IAEpD;;OAEG;IACH,OAAc,+BAA+B,SAAM;IACnD;;OAEG;IACI,wBAAwB,EAAE,MAAM,CAA2D;IAElG;;OAEG;IACH,OAAc,2BAA2B,SAAgB;IACzD;;OAEG;IACI,oBAAoB,EAAE,MAAM,CAAuD;IAE1F;;OAEG;IACI,oBAAoB,CAAC,EAAE,oBAAoB,CAAC;IAEnD;;OAEG;IACI,mBAAmB,CAAC,EAAE,mBAAmB,CAAC;CAClD;AAmCD;;;GAGG;AACH,qBAAa,UAAU;IACrB,OAAO;IACP,OAAc,mBAAmB,CAAC,EAAE,mBAAmB,CAAC;IAExD,aAAa;IACb,gBAAuB,SAAS,mBAA0B;IAE1D,OAAc,cAAc,SAAM;IAClC,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,uBAAuB,CAAC;IAEtD,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;IAGtB,gBAAgB;WACF,UAAU,IAAI,IAAI;IAKhC,OAAO,CAAC,MAAM,CAAC,gBAAgB;IAW/B,OAAO,CAAC,MAAM,CAAC,6BAA6B;IAa5C;;;OAGG;IACH,OAAc,gBAAgB,CAAC,EAAE,mBAAmB,CAAC;IAErD,gBAAgB;IAChB,OAAc,YAAY,CAAC,EAAE,wBAAwB,CAAC;IAEtD,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;IAWlC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAS;IAChC,8CAA8C;IAC9C,WAAkB,OAAO,YAA4B;IACrD;;;;OAIG;WACiB,OAAO,CAAC,aAAa,GAAE,uBAAuD,GAAG,OAAO,CAAC,IAAI,CAAC;IA6ElH,OAAO,CAAC,MAAM,CAAC,kBAAkB,CAAe;IAEhD,OAAO,CAAC,MAAM,CAAC,UAAU;IAuBzB,OAAO,CAAC,MAAM,CAAC,aAAa;IAU5B,iGAAiG;WAC7E,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAe7C;;;;;OAKG;WACW,sBAAsB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAKvE;;;;OAIG;WACW,yBAAyB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAK3D;;;OAGG;WACW,wBAAwB,IAAI,iCAAiC,EAAE;IAK7E,0DAA0D;IAC1D,WAAkB,YAAY,IAAI,MAAM,GAAG,SAAS,CAAuG;IAE3J;;OAEG;IACH,WAAkB,sBAAsB,IAAI,MAAM,CAEjD;IACD;;OAEG;IACH,WAAkB,yBAAyB,IAAI,MAAM,CAEpD;IAED,2FAA2F;IAC3F,WAAkB,wBAAwB,IAAI,MAAM,CAAiK;IACrN,4FAA4F;IAC5F,WAAkB,oBAAoB,IAAI,MAAM,CAAyJ;IAEzM;;OAEG;IACH,WAAkB,sBAAsB,IAAI,OAAO,CAElD;IAED;;OAEG;IACH,WAAkB,0BAA0B,IAAI,OAAO,CAA2H;IAElL;;OAEG;IACH,WAAkB,mBAAmB,IAAI,OAAO,CAAoE;IAEpH,OAAO,CAAC,MAAM,CAAC,cAAc;IAoB7B,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;IAED,gBAAgB;WACF,IAAI,IAAI,OAAO,cAAc;CAG5C;AAED;;GAEG;AACH,qBAAa,cAAc;IAEzB,iEAAiE;IACjE,WAAkB,eAAe,IAAI,MAAM,CAAqD;IAEhG,8DAA8D;IAC9D,WAAkB,gBAAgB,IAAI,MAAM,CAE3C;IAED,+BAA+B;IAC/B,WAAkB,MAAM,IAAI,MAAM,CAEjC;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

@@ -12,15 +12,16 @@ const os = require("os");
 const path = require("path");
 const semver = require("semver");
 const imodeljs_native_1 = require("@bentley/imodeljs-native");
-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 core_telemetry_1 = require("@itwin/core-telemetry");
 const BackendLoggerCategory_1 = require("./BackendLoggerCategory");
 const BisCoreSchema_1 = require("./BisCoreSchema");
 const BriefcaseManager_1 = require("./BriefcaseManager");
 const CloudStorageBackend_1 = require("./CloudStorageBackend");
 const FunctionalSchema_1 = require("./domains/FunctionalSchema");
 const GenericSchema_1 = require("./domains/GenericSchema");
+const GeoCoordConfig_1 = require("./GeoCoordConfig");
 const IModelJsFs_1 = require("./IModelJsFs");
 const DevToolsRpcImpl_1 = require("./rpc-impl/DevToolsRpcImpl");
 const IModelReadRpcImpl_1 = require("./rpc-impl/IModelReadRpcImpl");
@@ -28,9 +29,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 SettingsSchemas_1 = require("./workspace/SettingsSchemas");
+const Workspace_1 = require("./workspace/Workspace");
 const loggerCategory = BackendLoggerCategory_1.BackendLoggerCategory.IModelHost;
 /** Configuration of core-backend.
  * @public
@@ -69,13 +70,13 @@ IModelHostConfiguration.defaultLogTileLoadTimeThreshold = 40;
  */
 IModelHostConfiguration.defaultLogTileSizeThreshold = 20 * 1000000;
 /**
- * Settings for the application workspace.
+ * Settings for `IModelHost.appWorkspace`.
  * @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._remove = SettingsSchemas_1.SettingsSchemas.onSchemaChanged.addListener(() => this.updateDefaults());
         this.updateDefaults();
     }
     verifyPriority(priority) {
@@ -84,9 +85,9 @@ class ApplicationSettings extends Settings_1.BaseSettings {
     }
     updateDefaults() {
         const defaults = {};
-        for (const [specName, val] of SettingsSpecRegistry_1.SettingsSpecRegistry.allSpecs) {
+        for (const [schemaName, val] of SettingsSchemas_1.SettingsSchemas.allSchemas) {
             if (val.default)
-                defaults[specName] = val.default;
+                defaults[schemaName] = val.default;
         }
         this.addDictionary("_default_", 0, defaults);
     }
@@ -145,7 +146,7 @@ class IModelHost {
     }
     /** @internal */
     static flushLog() {
-        return this.platform.DgnDb.flushLog();
+        return this.platform.flushLog();
     }
     /** @internal */
     static loadNative() {
@@ -174,19 +175,29 @@ class IModelHost {
     }
     /** @internal */
     static setHubAccess(hubAccess) { this._hubAccess = hubAccess; }
+    /** get the current hubAccess, if present.
+     * @beta
+     */
+    static getHubAccess() { return this._hubAccess; }
     /** Provides access to the IModelHub for this IModelHost
      * @beta
      * @note If [[IModelHostConfiguration.hubAccess]] was undefined when initializing this class, accessing this property will throw an error.
+     * To determine whether one is present, use [[getHubAccess]].
      */
     static get hubAccess() {
-        // Strictly speaking, _hubAccess should be marked as possibly undefined since it's not needed for Snapshot iModels.
-        // However, a decision was made to not provide that type annotation so callers aren't forced to constantly check for
-        // something that's required in all other workflows.
-        // This check is here to provide a better error message when hubAccess is inadvertently undefined.
         if (this._hubAccess === undefined)
-            throw new core_common_1.IModelError(core_bentley_1.IModelStatus.BadRequest, "IModelHost.hubAccess is undefined. Specify an implementation in your IModelHostConfiguration");
+            throw new core_common_1.IModelError(core_bentley_1.IModelStatus.BadRequest, "No BackendHubAccess supplied in IModelHostConfiguration");
         return this._hubAccess;
     }
+    static initializeWorkspace(configuration) {
+        const settingAssets = path.join(KnownLocations.packageAssetsDir, "Settings");
+        SettingsSchemas_1.SettingsSchemas.addDirectory(path.join(settingAssets, "Schemas"));
+        this._appWorkspace = new Workspace_1.ITwinWorkspace(new ApplicationSettings(), configuration.workspace);
+        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; }
     /** This method must be called before any iTwin.js services are used.
@@ -239,7 +250,7 @@ class IModelHost {
             }
         }
         this.setupHostDirs(configuration);
-        this._appWorkspace = new Workspace_1.ITwinWorkspace(new ApplicationSettings(), configuration.workspace);
+        this.initializeWorkspace(configuration);
         BriefcaseManager_1.BriefcaseManager.initialize(this._briefcaseCacheDir);
         [
             IModelReadRpcImpl_1.IModelReadRpcImpl,
@@ -254,12 +265,12 @@ class IModelHost {
             FunctionalSchema_1.FunctionalSchema,
         ].forEach((schema) => schema.registerSchema()); // register all of the schemas
         if (undefined !== configuration.hubAccess)
-            IModelHost._hubAccess = configuration.hubAccess;
-        IModelHost.configuration = configuration;
-        IModelHost.setupTileCache();
+            this._hubAccess = configuration.hubAccess;
+        this.configuration = configuration;
+        this.setupTileCache();
         this.platform.setUseTileCache(IModelHost.tileCacheService ? false : true);
         process.once("beforeExit", IModelHost.shutdown);
-        IModelHost.onAfterStartup.raiseEvent();
+        this.onAfterStartup.raiseEvent();
     }
     static logStartup() {
         if (!core_bentley_1.Logger.isEnabled(loggerCategory, core_bentley_1.LogLevel.Trace))
@@ -301,7 +312,7 @@ class IModelHost {
         IModelHost.configuration = undefined;
         IModelHost.tileCacheService = undefined;
         IModelHost.tileUploader = undefined;
-        IModelHost.appWorkspace.close();
+        await IModelHost.appWorkspace.close();
         IModelHost._appWorkspace = undefined;
         process.removeListener("beforeExit", IModelHost.shutdown);
     }
@@ -382,12 +393,18 @@ class IModelHost {
             throw new core_common_1.IModelError(core_common_1.BentleyStatus.ERROR, "Cannot use both Azure and custom cloud storage providers for tile cache.");
         }
     }
+    /** @internal */
+    static computeSchemaChecksum(arg) {
+        return this.platform.computeSchemaChecksum(arg);
+    }
 }
 exports.IModelHost = IModelHost;
 /** @alpha */
 IModelHost.telemetry = new core_telemetry_1.TelemetryManager();
 IModelHost.backendVersion = "";
 IModelHost._cacheDir = "";
+/** Event raised during startup to allow loading settings data */
+IModelHost.onWorkspaceStartup = new core_bentley_1.BeEvent();
 /** Event raised just after the backend IModelHost was started */
 IModelHost.onAfterStartup = new core_bentley_1.BeEvent();
 /** Event raised just before the backend IModelHost is to be shut down */

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 \"@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   * @note If [[IModelHostConfiguration.hubAccess]] was undefined when initializing this class, accessing this property will throw an error.\r\n   */\r\n  public static get hubAccess(): BackendHubAccess {\r\n    // Strictly speaking, _hubAccess should be marked as possibly undefined since it's not needed for Snapshot iModels.\r\n    // However, a decision was made to not provide that type annotation so callers aren't forced to constantly check for\r\n    // something that's required in all other workflows.\r\n    // This check is here to provide a better error message when hubAccess is inadvertently undefined.\r\n    if (this._hubAccess === undefined)\r\n      throw new IModelError(IModelStatus.BadRequest, \"IModelHost.hubAccess is undefined. Specify an implementation in your IModelHostConfiguration\");\r\n    return this._hubAccess;\r\n  }\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"]}
+{"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 { 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 { TelemetryManager } from \"@itwin/core-telemetry\";\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 { GeoCoordConfig } from \"./GeoCoordConfig\";\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 { BaseSettings, SettingDictionary, SettingsPriority } from \"./workspace/Settings\";\r\nimport { SettingsSchemas } from \"./workspace/SettingsSchemas\";\r\nimport { ITwinWorkspace, Workspace, WorkspaceOpts } from \"./workspace/Workspace\";\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 `IModelHost.appWorkspace`.\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 [schemaName, val] of SettingsSchemas.allSchemas) {\r\n      if (val.default)\r\n        defaults[schemaName] = 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 = SettingsSchemas.onSchemaChanged.addListener(() => this.updateDefaults());\r\n    this.updateDefaults();\r\n  }\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\r\n  /** Event raised during startup to allow loading settings data */\r\n  public static readonly onWorkspaceStartup = new BeEvent<() => void>();\r\n\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.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 | undefined) { this._hubAccess = hubAccess; }\r\n\r\n  /** get the current hubAccess, if present.\r\n   * @beta\r\n   */\r\n  public static getHubAccess(): BackendHubAccess | undefined { return this._hubAccess; }\r\n\r\n  /** Provides access to the IModelHub for this IModelHost\r\n   * @beta\r\n   * @note If [[IModelHostConfiguration.hubAccess]] was undefined when initializing this class, accessing this property will throw an error.\r\n   * To determine whether one is present, use [[getHubAccess]].\r\n   */\r\n  public static get hubAccess(): BackendHubAccess {\r\n    if (this._hubAccess === undefined)\r\n      throw new IModelError(IModelStatus.BadRequest, \"No BackendHubAccess supplied in IModelHostConfiguration\");\r\n    return this._hubAccess;\r\n  }\r\n\r\n  private static initializeWorkspace(configuration: IModelHostConfiguration) {\r\n    const settingAssets = path.join(KnownLocations.packageAssetsDir, \"Settings\");\r\n    SettingsSchemas.addDirectory(path.join(settingAssets, \"Schemas\"));\r\n    this._appWorkspace = new ITwinWorkspace(new ApplicationSettings(), configuration.workspace);\r\n    this.appWorkspace.settings.addDirectory(settingAssets, SettingsPriority.defaults);\r\n\r\n    GeoCoordConfig.onStartup();\r\n    // allow applications to load their default settings\r\n    this.onWorkspaceStartup.raiseEvent();\r\n  }\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.initializeWorkspace(configuration);\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      this._hubAccess = configuration.hubAccess;\r\n    this.configuration = configuration;\r\n    this.setupTileCache();\r\n\r\n    this.platform.setUseTileCache(IModelHost.tileCacheService ? false : true);\r\n    process.once(\"beforeExit\", IModelHost.shutdown);\r\n    this.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    await 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  /** @internal */\r\n  public static computeSchemaChecksum(arg: { schemaXmlPath: string, referencePaths: string[], exactMatch?: boolean }): string {\r\n    return this.platform.computeSchemaChecksum(arg);\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/LocalHub.d.ts

@@ -0,0 +1,163 @@
+import { GuidString, Id64String } from "@itwin/core-bentley";
+import { BriefcaseId, ChangesetFileProps, ChangesetId, ChangesetIdWithIndex, ChangesetIndex, ChangesetIndexOrId, ChangesetProps, ChangesetRange, LocalDirName, LocalFileName } from "@itwin/core-common";
+import { LockMap, LockProps, LockState } from "./BackendHubAccess";
+/** @internal */
+interface MockBriefcaseIdProps {
+    id: BriefcaseId;
+    user: string;
+    alias: string;
+    assigned: boolean;
+}
+/** @internal */
+interface LocalHubProps {
+    readonly iTwinId: GuidString;
+    readonly iModelId: GuidString;
+    readonly iModelName: string;
+    readonly description?: string;
+    readonly version0?: string;
+    readonly noLocks?: true;
+}
+interface LocksEntry {
+    id: Id64String;
+    level: LockState;
+    lastCsIndex?: ChangesetIndex;
+    briefcaseId?: BriefcaseId;
+}
+interface LockStatusNone {
+    state: LockState.None;
+    lastCsIndex?: ChangesetIndex;
+}
+/** @internal exported for tests. */
+export interface LockStatusExclusive {
+    state: LockState.Exclusive;
+    briefcaseId: BriefcaseId;
+    lastCsIndex?: ChangesetIndex;
+}
+/** @internal exported for tests. */
+export interface LockStatusShared {
+    state: LockState.Shared;
+    sharedBy: Set<BriefcaseId>;
+    lastCsIndex?: ChangesetIndex;
+}
+interface BriefcaseIdAndChangeset {
+    changeset: ChangesetIdWithIndex;
+    briefcaseId: BriefcaseId;
+}
+declare type LockStatus = LockStatusNone | LockStatusExclusive | LockStatusShared;
+/**
+ * A "local" mock for IModelHub to provide access to a single iModel. Used by HubMock.
+ * @internal
+ */
+export declare class LocalHub {
+    readonly rootDir: LocalDirName;
+    readonly iTwinId: GuidString;
+    readonly iModelId: GuidString;
+    readonly iModelName: string;
+    readonly description?: string;
+    private _hubDb?;
+    private _nextBriefcaseId;
+    private _latestChangesetIndex;
+    get latestChangesetIndex(): number;
+    constructor(rootDir: LocalDirName, arg: LocalHubProps);
+    private get db();
+    get changesetDir(): string;
+    get checkpointDir(): string;
+    get mockDbName(): string;
+    /** Acquire the next available briefcaseId and assign it to the supplied user */
+    acquireNewBriefcaseId(user: string, alias?: string): BriefcaseId;
+    /** Release a briefcaseId */
+    releaseBriefcaseId(id: BriefcaseId): void;
+    /** Get an array of all of the currently assigned Briefcases */
+    getBriefcases(onlyAssigned?: boolean): MockBriefcaseIdProps[];
+    /** Get an array of all of the currently assigned BriefcaseIds for a user */
+    getBriefcaseIds(user: string): BriefcaseId[];
+    getBriefcase(id: BriefcaseId): MockBriefcaseIdProps;
+    private getChangesetFileName;
+    /** Add a changeset to the timeline
+     * @return the changesetIndex of the added changeset
+     */
+    addChangeset(changeset: ChangesetFileProps): ChangesetIndex;
+    getIndexFromChangeset(changeset: ChangesetIndexOrId): ChangesetIndex;
+    /** Get the index of a changeset by its Id */
+    getChangesetIndex(id: ChangesetId): ChangesetIndex;
+    /** Get the properties of a changeset by its Id */
+    getChangesetById(id: ChangesetId): ChangesetProps;
+    getPreviousIndex(index: ChangesetIndex): number;
+    getParentId(index: ChangesetIndex): ChangesetId;
+    /** Get the properties of a changeset by its index */
+    getChangesetByIndex(index: ChangesetIndex): ChangesetProps;
+    getLatestChangeset(): ChangesetProps;
+    getChangesetId(index: ChangesetIndex): ChangesetId;
+    /** Get an array of changesets starting with first to last, by index */
+    queryChangesets(range?: ChangesetRange): ChangesetProps[];
+    /** Name a version */
+    addNamedVersion(arg: {
+        versionName: string;
+        csIndex: ChangesetIndex;
+    }): void;
+    /** Delete a named version */
+    deleteNamedVersion(versionName: string): void;
+    /** find the changeset for a named version */
+    findNamedVersion(versionName: string): ChangesetProps;
+    checkpointNameFromIndex(csIndex: ChangesetIndex): string;
+    /** "upload" a checkpoint */
+    uploadCheckpoint(arg: {
+        changesetIndex: ChangesetIndex;
+        localFile: LocalFileName;
+    }): string;
+    /** Get an array of the indexes for a range of checkpoints */
+    getCheckpoints(range?: ChangesetRange): ChangesetIndex[];
+    /** Find the checkpoint that is no newer than a changesetIndex */
+    queryPreviousCheckpoint(changesetIndex: ChangesetIndex): ChangesetIndex;
+    /** "download" a checkpoint */
+    downloadCheckpoint(arg: {
+        changeset: ChangesetIndexOrId;
+        targetFile: LocalFileName;
+    }): {
+        index: number;
+        id: string;
+    };
+    private copyChangeset;
+    /** "download" a changeset */
+    downloadChangeset(arg: {
+        index: ChangesetIndex;
+        targetDir: LocalDirName;
+    }): ChangesetFileProps;
+    /** "download" all the changesets in a given range */
+    downloadChangesets(arg: {
+        range?: ChangesetRange;
+        targetDir: LocalDirName;
+    }): ChangesetFileProps[];
+    private querySharedLockHolders;
+    queryAllLocks(briefcaseId: BriefcaseId): LockProps[];
+    queryLockStatus(elementId: Id64String): LockStatus;
+    private reserveLock;
+    private clearLock;
+    private updateLockChangeset;
+    private requestLock;
+    private removeSharedLock;
+    private releaseLock;
+    /** Acquire a set of locks. If any lock cannot be acquired, no locks are acquired  */
+    acquireLocks(locks: LockMap, briefcase: BriefcaseIdAndChangeset): void;
+    acquireLock(props: LockProps, briefcase: BriefcaseIdAndChangeset): void;
+    releaseLocks(locks: LockProps[], arg: {
+        briefcaseId: BriefcaseId;
+        changesetIndex: ChangesetIndex;
+    }): void;
+    releaseAllLocks(arg: {
+        briefcaseId: BriefcaseId;
+        changesetIndex: ChangesetIndex;
+    }): void;
+    private countTable;
+    countSharedLocks(): number;
+    countLocks(): number;
+    queryAllSharedLocks(): {
+        id: Id64String;
+        briefcaseId: BriefcaseId;
+    }[];
+    queryLocks(): LocksEntry[];
+    removeDir(dirName: string): void;
+    cleanup(): void;
+}
+export {};
+//# sourceMappingURL=LocalHub.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"LocalHub.d.ts","sourceRoot":"","sources":["../../src/LocalHub.ts"],"names":[],"mappings":"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"}