@itwin/core-backend 5.9.0-dev.1 → 5.9.0-dev.10

package/lib/cjs/IModelHost.d.ts

@@ -7,8 +7,10 @@ import { AuthorizationClient, LocalDirName, SessionProps } from "@itwin/core-com
 import type { ServerStorage } from "@itwin/object-storage-core";
 import { BackendHubAccess, CreateNewIModelProps } from "./BackendHubAccess";
 import { TileStorage } from "./TileStorage";
+import { SettingsContainer } from "./workspace/Settings";
 import { SettingsSchemas } from "./workspace/SettingsSchemas";
-import { Workspace, WorkspaceOpts } from "./workspace/Workspace";
+import { Workspace, WorkspaceDbSettingsProps, WorkspaceOpts } from "./workspace/Workspace";
+import { OwnedWorkspace } from "./internal/workspace/WorkspaceImpl";
 import { _getHubAccess, _hubAccess, _setHubAccess } from "./internal/Symbols";
 /** @internal */
 export interface CrashReportingConfigNameValuePair {
@@ -47,6 +49,15 @@ export interface AzureBlobStorageCredentials {
     accessKey: string;
     baseUrl?: string;
 }
+/** Controls how iModel writes through the implicit transaction are enforced.
+ *
+ * Allowed values:
+ * - "allow": preserve pre-version 5.8.0 behavior for backwards compatibility.
+ * - "log": allow the operation but log each implicit write as an error case.
+ * - "throw": reject writes through the implicit transaction and require explicit EditTxns.
+ * @beta
+ */
+export type ImplicitWriteEnforcement = "allow" | "log" | "throw";
 /**
  * Options for [[IModelHost.startup]]
  * @public
@@ -160,6 +171,13 @@ export interface IModelHostOptions {
      * @beta
      */
     useSemanticRebase?: boolean;
+    /**
+      * Controls how writes through the implicit transaction are enforced.
+      * See [[ImplicitWriteEnforcement]] for the allowed values.
+      * Defaults to "allow" for backwards compatibility.
+     * @beta
+     */
+    implicitWriteEnforcement?: ImplicitWriteEnforcement;
 }
 /** Configuration of core-backend.
  * @public
@@ -214,6 +232,12 @@ export declare class IModelHostConfiguration implements IModelHostOptions {
      * @beta
      */
     useSemanticRebase?: boolean;
+    /**
+      * Controls how writes through the implicit transaction are enforced.
+      * See [[IModelHostOptions.implicitWriteEnforcement]] for the meaning of each allowed value.
+     * @beta
+     */
+    implicitWriteEnforcement: ImplicitWriteEnforcement;
 }
 /** 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)
@@ -274,6 +298,39 @@ export declare class IModelHost {
      * @beta
      */
     static get appWorkspace(): Workspace;
+    /** Obtain the [[Workspace]] for an iTwin by discovering its settings container.
+     * All named dictionary resources in the container's [[WorkspaceDb]] are loaded into the workspace at [[SettingsPriority.iTwin]].
+     * @note This method requires an internet connection to discover the container.
+     * To use an iTwin workspace offline, use the overload that accepts [[WorkspaceDbSettingsProps]].
+     * @note The returned workspace is caller-owned. Call `close` when finished.
+     * @beta
+     */
+    static getITwinWorkspace(iTwinId: GuidString): Promise<OwnedWorkspace>;
+    /** Obtain the [[Workspace]] for an iTwin.
+     * The supplied [[WorkspaceDbSettingsProps]] are passed directly to [[Workspace.loadSettingsDictionary]].
+      * @note You can derive these from the `settingsSources` property on a previously returned workspace.
+      * @note The returned workspace is caller-owned. Call `close` when finished.
+     * @beta
+     */
+    static getITwinWorkspace(props: WorkspaceDbSettingsProps | WorkspaceDbSettingsProps[]): Promise<OwnedWorkspace>;
+    /** Save a named [[SettingsDictionary]] to the iTwin's settings container.
+     * If no iTwin settings container exists for `iTwinId`, one is created.
+     * The dictionary is stored as a named resource in the container's default [[WorkspaceDb]], where `name` is used as the resource name.
+     * @param iTwinId The iTwin whose settings container should be updated.
+     * @param name The name of the dictionary, used as the resource name in the [[WorkspaceDb]].
+     * @param settings The settings key-value pairs to store.
+     * @note uses [[IModelHost.userMoniker]] as the user name for acquiring the write lock on the settings container.
+     * @beta
+     */
+    static saveSettingDictionary(iTwinId: GuidString, name: string, settings: SettingsContainer): Promise<void>;
+    /** Delete a named [[SettingsDictionary]] from the iTwin's settings container.
+     * If no iTwin settings container exists, this method does nothing.
+     * @param iTwinId The iTwin whose settings container should be updated.
+     * @param name The name of the dictionary (resource name) to delete.
+     * @note uses [[IModelHost.userMoniker]] as the user name for acquiring the write lock on the settings container.
+     * @beta
+     */
+    static deleteSettingDictionary(iTwinId: GuidString, name: string): Promise<void>;
     /** The registry of schemas describing the [[Setting]]s for the application session.
      * Applications should register their schemas via methods like [[SettingsSchemas.addGroup]].
      * @beta

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

@@ -23,6 +23,7 @@ const BriefcaseManager_1 = require("./BriefcaseManager");
 const CloudSqlite_1 = require("./CloudSqlite");
 const FunctionalSchema_1 = require("./domains/FunctionalSchema");
 const GenericSchema_1 = require("./domains/GenericSchema");
+const EditTxn_1 = require("./EditTxn");
 const GeoCoordConfig_1 = require("./GeoCoordConfig");
 const IModelJsFs_1 = require("./IModelJsFs");
 const DevToolsRpcImpl_1 = require("./rpc-impl/DevToolsRpcImpl");
@@ -32,6 +33,8 @@ const SnapshotIModelRpcImpl_1 = require("./rpc-impl/SnapshotIModelRpcImpl");
 const RpcBackend_1 = require("./RpcBackend");
 const TileStorage_1 = require("./TileStorage");
 const Settings_1 = require("./workspace/Settings");
+const SettingsDb_1 = require("./workspace/SettingsDb");
+const SettingsEditor_1 = require("./workspace/SettingsEditor");
 const path_1 = require("path");
 const WorkspaceImpl_1 = require("./internal/workspace/WorkspaceImpl");
 const SettingsImpl_1 = require("./internal/workspace/SettingsImpl");
@@ -91,6 +94,12 @@ class IModelHostConfiguration {
      * @beta
      */
     useSemanticRebase;
+    /**
+      * Controls how writes through the implicit transaction are enforced.
+      * See [[IModelHostOptions.implicitWriteEnforcement]] for the meaning of each allowed value.
+     * @beta
+     */
+    implicitWriteEnforcement = "allow";
 }
 exports.IModelHostConfiguration = IModelHostConfiguration;
 /**
@@ -123,6 +132,21 @@ class ApplicationSettings extends SettingsImpl_1.SettingsImpl {
         }
     }
 }
+/**
+ * Settings for an iTwin. May only include settings priority for iTwin and organization.
+ */
+class ITwinWorkspaceSettings extends SettingsImpl_1.SettingsImpl {
+    verifyPriority(priority) {
+        if (priority <= Settings_1.SettingsPriority.application)
+            core_common_1.ITwinSettingsError.throwError("invalid-priority", { message: `Settings with priority ${priority} cannot be added to an iTwin workspace.` });
+        if (priority > Settings_1.SettingsPriority.iTwin)
+            core_common_1.ITwinSettingsError.throwError("invalid-priority", { message: `Settings with priority ${priority} cannot be added to an iTwin workspace.` });
+    }
+    *getSettingEntries(name) {
+        yield* super.getSettingEntries(name);
+        yield* IModelHost.appWorkspace.settings.getSettingEntries(name);
+    }
+}
 const definedInStartup = (obj) => {
     if (obj === undefined)
         throw new Error("IModelHost.startup must be called first");
@@ -192,6 +216,69 @@ class IModelHost {
      * @beta
      */
     static get appWorkspace() { return definedInStartup(this._appWorkspace); }
+    /** @internal */
+    static async getITwinWorkspace(args) {
+        const isITwinId = typeof args === "string";
+        const workspace = (0, WorkspaceImpl_1.constructWorkspace)(new ITwinWorkspaceSettings());
+        try {
+            const settingsSources = isITwinId ? await SettingsEditor_1.SettingsContainers.getITwinSettingsSources(args) : args;
+            if (undefined === settingsSources)
+                return workspace;
+            workspace.settingsSources = settingsSources;
+            const problems = [];
+            await workspace.loadSettingsDictionary(settingsSources, problems);
+            if (problems.length > 0) {
+                const label = isITwinId ? `iTwin '${args}'` : "the supplied settings workspace db properties";
+                (0, WorkspaceImpl_1.throwWorkspaceDbLoadErrors)(`attempting to load workspace settings for ${label}`, problems);
+            }
+            return workspace;
+        }
+        catch (error) {
+            workspace.close();
+            throw error;
+        }
+    }
+    /** Save a named [[SettingsDictionary]] to the iTwin's settings container.
+     * If no iTwin settings container exists for `iTwinId`, one is created.
+     * The dictionary is stored as a named resource in the container's default [[WorkspaceDb]], where `name` is used as the resource name.
+     * @param iTwinId The iTwin whose settings container should be updated.
+     * @param name The name of the dictionary, used as the resource name in the [[WorkspaceDb]].
+     * @param settings The settings key-value pairs to store.
+     * @note uses [[IModelHost.userMoniker]] as the user name for acquiring the write lock on the settings container.
+     * @beta
+     */
+    static async saveSettingDictionary(iTwinId, name, settings) {
+        const { editor, container } = await SettingsEditor_1.SettingsEditor.constructForITwin(iTwinId);
+        try {
+            await container.withEditableDb(this.userMoniker, (db) => {
+                db.updateSettingsResource(settings, name);
+            }, { dbName: SettingsDb_1.settingsWorkspaceDbName });
+        }
+        finally {
+            editor.close();
+        }
+    }
+    /** Delete a named [[SettingsDictionary]] from the iTwin's settings container.
+     * If no iTwin settings container exists, this method does nothing.
+     * @param iTwinId The iTwin whose settings container should be updated.
+     * @param name The name of the dictionary (resource name) to delete.
+     * @note uses [[IModelHost.userMoniker]] as the user name for acquiring the write lock on the settings container.
+     * @beta
+     */
+    static async deleteSettingDictionary(iTwinId, name) {
+        const settingsEditor = await SettingsEditor_1.SettingsEditor.getForITwin(iTwinId);
+        if (undefined === settingsEditor)
+            return;
+        const { editor, container } = settingsEditor;
+        try {
+            await container.withEditableDb(this.userMoniker, (db) => {
+                db.removeString(name);
+            }, { dbName: SettingsDb_1.settingsWorkspaceDbName });
+        }
+        finally {
+            editor.close();
+        }
+    }
     /** The registry of schemas describing the [[Setting]]s for the application session.
      * Applications should register their schemas via methods like [[SettingsSchemas.addGroup]].
      * @beta
@@ -298,6 +385,7 @@ class IModelHost {
         this.loadNative(options);
         this.setupCacheDir(options);
         this.initializeWorkspace(options);
+        EditTxn_1.EditTxn.implicitWriteEnforcement = options.implicitWriteEnforcement ?? "allow";
         BriefcaseManager_1.BriefcaseManager.initialize((0, path_1.join)(this._cacheDir, "imodels"));
         [
             IModelReadRpcImpl_1.IModelReadRpcImpl,
@@ -345,6 +433,7 @@ class IModelHost {
         this._isValid = false;
         this.onBeforeShutdown.raiseEvent();
         this.configuration = undefined;
+        EditTxn_1.EditTxn.implicitWriteEnforcement = "allow";
         this.tileStorage = undefined;
         this._appWorkspace?.close();
         this._appWorkspace = undefined;

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":["/*---------------------------------------------------------------------------------------------\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n* See LICENSE.md in the project root for license terms and full copyright notice.\n*--------------------------------------------------------------------------------------------*/\n/** @packageDocumentation\n * @module IModelHost\n */\n\n// To avoid circular load errors, the \"Element\" classes must be loaded before IModelHost.\nimport \"./IModelDb\"; // DO NOT REMOVE OR MOVE THIS LINE!\n\nimport { IModelNative, loadNativePlatform } from \"./internal/NativePlatform\";\nimport * as os from \"node:os\";\nimport { NativeLibrary } from \"@bentley/imodeljs-native\";\nimport { AccessToken, assert, BeEvent, BentleyStatus, DbResult, Guid, GuidString, IModelStatus, Logger, Mutable, ProcessDetector } from \"@itwin/core-bentley\";\nimport { AuthorizationClient, IModelError, LocalDirName, SessionProps } from \"@itwin/core-common\";\nimport { AzureServerStorage, AzureServerStorageConfig, BlobServiceClientWrapper } from \"@itwin/object-storage-azure\";\nimport { BlobServiceClient, StorageSharedKeyCredential } from \"@azure/storage-blob\";\nimport type { ServerStorage } from \"@itwin/object-storage-core\";\nimport { BackendHubAccess, CreateNewIModelProps } from \"./BackendHubAccess\";\nimport { BackendLoggerCategory } from \"./BackendLoggerCategory\";\nimport { BisCoreSchema } from \"./BisCoreSchema\";\nimport { BriefcaseManager } from \"./BriefcaseManager\";\nimport { CloudSqlite } from \"./CloudSqlite\";\nimport { FunctionalSchema } from \"./domains/FunctionalSchema\";\nimport { GenericSchema } from \"./domains/GenericSchema\";\nimport { GeoCoordConfig } from \"./GeoCoordConfig\";\nimport { IModelJsFs } from \"./IModelJsFs\";\nimport { DevToolsRpcImpl } from \"./rpc-impl/DevToolsRpcImpl\";\nimport { IModelReadRpcImpl } from \"./rpc-impl/IModelReadRpcImpl\";\nimport { IModelTileRpcImpl } from \"./rpc-impl/IModelTileRpcImpl\";\nimport { SnapshotIModelRpcImpl } from \"./rpc-impl/SnapshotIModelRpcImpl\";\nimport { initializeRpcBackend } from \"./RpcBackend\";\nimport { TileStorage } from \"./TileStorage\";\nimport { SettingsContainer, SettingsPriority } from \"./workspace/Settings\";\nimport { SettingsSchemas } from \"./workspace/SettingsSchemas\";\nimport { Workspace, WorkspaceOpts } from \"./workspace/Workspace\";\nimport { join, normalize as normalizeDir } from \"path\";\nimport { constructWorkspace, OwnedWorkspace } from \"./internal/workspace/WorkspaceImpl\";\nimport { SettingsImpl } from \"./internal/workspace/SettingsImpl\";\nimport { constructSettingsSchemas } from \"./internal/workspace/SettingsSchemasImpl\";\nimport { _getHubAccess, _hubAccess, _setHubAccess } from \"./internal/Symbols\";\n\nconst loggerCategory = BackendLoggerCategory.IModelHost;\n\n// cspell:ignore nodereport fatalerror apicall alicloud rpcs\n\n/** @internal */\nexport interface CrashReportingConfigNameValuePair {\n  name: string;\n  value: string;\n}\n\n/** Configuration of the crash-reporting system.\n * @internal\n */\nexport interface CrashReportingConfig {\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. */\n  crashDir: string;\n  /** max # .dmp files that may exist in crashDir. The default is 50. */\n  maxDumpsInDir?: number;\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. */\n  enableCrashDumps?: boolean;\n  /** If enableCrashDumps is true, do you want a full-memory dump? Defaults to false. */\n  wantFullMemoryDumps?: boolean;\n  /** Enable Node.js crash reporting? If so, report files will be generated in the event of an unhandled exception or fatal error and written to crashDir. The default is false. */\n  enableNodeReport?: boolean;\n  /** Additional name, value pairs to write to iModelJsNativeCrash*.properties.txt file in the event of a crash. */\n  params?: CrashReportingConfigNameValuePair[];\n  /** Run this .js file to process .dmp and Node.js crash reporting .json files in the event of a crash.\n   * This script will be executed with a single command-line parameter: the name of the dump or Node.js report file.\n   * In the case of a dump file, there will be a second file with the same basename and the extension \".properties.txt\".\n   * Since it runs in a separate process, this script will have no access to the Javascript\n   * context of the exiting backend. No default.\n   */\n  dumpProcessorScriptFileName?: string;\n  /** Upload crash dump and node-reports to Bentley's crash-reporting service? Defaults to false */\n  uploadToBentley?: boolean;\n}\n\n/** @beta */\nexport interface AzureBlobStorageCredentials {\n  account: string;\n  accessKey: string;\n  baseUrl?: string;\n}\n\n/**\n * Options for [[IModelHost.startup]]\n * @public\n */\nexport interface IModelHostOptions {\n  /**\n   * The name of the *Profile* subdirectory of [[cacheDir]] for this process. If not present, \"default\" is used.\n   * @see [[IModelHost.profileName]]\n   * @beta\n   */\n  profileName?: string;\n\n  /**\n   * Root of the directory holding all the files that iTwin.js caches\n   * - If not specified at startup a platform specific default is used -\n   *   - Windows: $(HOMEDIR)/AppData/Local/iModelJs/\n   *   - Mac/iOS: $(HOMEDIR)/Library/Caches/iModelJs/\n   *   - Linux:   $(HOMEDIR)/.cache/iModelJs/\n   *   where $(HOMEDIR) is documented [here](https://nodejs.org/api/os.html#os_os_homedir)\n   * - if specified, ensure it is set to a folder with read/write access.\n   * @see [[IModelHost.cacheDir]] for the value it's set to after startup\n   */\n  cacheDir?: LocalDirName;\n\n  /** The directory where application assets are found. */\n  appAssetsDir?: LocalDirName;\n\n  /**\n   * Options for creating the [[IModelHost.appWorkspace]]\n   * @beta\n   */\n  workspace?: WorkspaceOpts;\n\n  /**\n   * The kind of iModel hub server to use.\n   */\n  hubAccess?: BackendHubAccess;\n\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.\n   * @beta\n   */\n  tileCacheAzureCredentials?: AzureBlobStorageCredentials;\n\n  /**\n   * @beta\n   * @note A reference implementation is set for AzureServerStorage from @itwin/object-storage-azure if [[tileCacheAzureCredentials]] property is set. To supply a different implementation for any service provider (such as AWS),\n   *       set this property with a custom ServerStorage.\n   */\n  tileCacheStorage?: ServerStorage;\n\n  /** The maximum size in bytes to which a local sqlite database used for caching tiles can grow before it is purged of least-recently-used tiles.\n   * The local cache is used only if an external cache has not been configured via [[tileCacheStorage]], and [[tileCacheAzureCredentials]].\n   * Defaults to 1 GB. Must be an unsigned integer. A value of zero disables the local cache entirely.\n   * @beta\n   */\n  maxTileCacheDbSize?: number;\n\n  /** Whether to restrict tile cache URLs by client IP address (if available).\n   * @beta\n   */\n  restrictTileUrlsByClientIp?: boolean;\n\n  /** Whether to enable OpenTelemetry tracing.\n   * Defaults to `false`.\n   */\n  enableOpenTelemetry?: boolean;\n\n  /** Whether to compress cached tiles.\n   * Defaults to `true`.\n   */\n  compressCachedTiles?: boolean;\n\n  /** The time, in milliseconds, for which [IModelTileRpcInterface.requestTileTreeProps]($common) should wait before returning a \"pending\" status.\n   * @internal\n   */\n  tileTreeRequestTimeout?: number;\n\n  /** The time, in milliseconds, for which [IModelTileRpcInterface.requestTileContent]($common) should wait before returning a \"pending\" status.\n   * @internal\n   */\n  tileContentRequestTimeout?: number;\n\n  /** The backend will log when a tile took longer to load than this threshold in seconds.\n   * @internal\n   */\n  logTileLoadTimeThreshold?: number;\n\n  /** The backend will log when a tile is loaded with a size in bytes above this threshold.\n   * @internal\n   */\n  logTileSizeThreshold?: number;\n\n  /** Crash-reporting configuration\n   * @internal\n   */\n  crashReportingConfig?: CrashReportingConfig;\n\n  /** The AuthorizationClient used to obtain [AccessToken]($bentley)s. */\n  authorizationClient?: AuthorizationClient;\n\n  /**\n   * Automatically enable shared channel when opening iModels for read/write (see [Working With Channels]($docs/learning/backend/Channel.md)).\n   * If not present, defaults to `true` for backwards compatibility. This means that the shared channel may be edited by default. Generally\n   * that is undesirable because it allows applications to \"accidentally\" modify data it shouldn't be allowed to modify. Unfortunately the\n   * previous versions of iTwin.js allowed it so this is necessary so they won't break.\n   * Will be changed to default to `false` in 5.0.\n   */\n  allowSharedChannel?: boolean;\n\n  /**\n   * Setting this to true will revert to the previous behavior of using the native side for all CRUD operations.\n   * While set to false, the getElement(), getModel() and getAspect() functions will use a thinned down native workflow to read the entities from the database.\n   * This workflow performs work previously done on the native side in the TS side, resulting in performance improvements, if errors are detected,\n   * this option can be set to true to revert to old workflow.\n   */\n  disableThinnedNativeInstanceWorkflow?: boolean;\n\n  /**\n   * Configuration controlling whether to disable the creation of restore points during pull/merge operations.\n   * @beta\n   */\n  disableRestorePointOnPullMerge?: true;\n  /**\n   * Configuration controlling whether incremental schema loading is enabled or disabled.\n   * @beta\n   */\n  incrementalSchemaLoading?: \"enabled\" | \"disabled\";\n  /**\n   * Configuration controlling whether to use semantic rebase or not.\n   * @beta\n   */\n  useSemanticRebase?: boolean;\n}\n\n/** Configuration of core-backend.\n * @public\n */\nexport class IModelHostConfiguration implements IModelHostOptions {\n  public static defaultTileRequestTimeout = 20 * 1000;\n  public static defaultLogTileLoadTimeThreshold = 40;\n  public static defaultLogTileSizeThreshold = 20 * 1000000;\n  /** @internal */\n  public static defaultMaxTileCacheDbSize = 1024 * 1024 * 1024;\n  public appAssetsDir?: LocalDirName;\n  public cacheDir?: LocalDirName;\n\n  /** @beta */\n  public workspace?: WorkspaceOpts;\n  public hubAccess?: BackendHubAccess;\n  /** The AuthorizationClient used to obtain [AccessToken]($bentley)s. */\n  public authorizationClient?: AuthorizationClient;\n  /** @beta */\n  public restrictTileUrlsByClientIp?: boolean;\n  public compressCachedTiles?: boolean;\n  /** @beta */\n  public tileCacheAzureCredentials?: AzureBlobStorageCredentials;\n  /** @internal */\n  public tileTreeRequestTimeout = IModelHostConfiguration.defaultTileRequestTimeout;\n  /** @internal */\n  public tileContentRequestTimeout = IModelHostConfiguration.defaultTileRequestTimeout;\n  /** @internal */\n  public logTileLoadTimeThreshold = IModelHostConfiguration.defaultLogTileLoadTimeThreshold;\n  /** @internal */\n  public logTileSizeThreshold = IModelHostConfiguration.defaultLogTileSizeThreshold;\n  /** @internal */\n  public crashReportingConfig?: CrashReportingConfig;\n  /**\n   * Configuration controlling whether to use the thinned down native instance functions for element, model, and aspect CRUD operations\n   * or use the previous behavior of using the native side for all CRUD operations. Set to true to revert to the previous behavior.\n   * @beta\n  */\n  public disableThinnedNativeInstanceWorkflow?: boolean;\n\n  /**\n   * Configuration controlling whether to disable the creation of restore points during pull/merge operations.\n   * @beta\n   */\n  public disableRestorePointOnPullMerge?: true;\n  /**\n   * Configuration controlling whether incremental schema loading is disabled.\n   * Default is \"disabled\" at the moment to preserve existing behavior.\n   * @beta\n   */\n  public incrementalSchemaLoading: \"enabled\" | \"disabled\" = \"disabled\";\n  /**\n   * Configuration controlling whether to use semantic rebase or not. By default it is undefined meaning semantic rebase is not used.\n   * @beta\n   */\n  public useSemanticRebase?: boolean;\n}\n\n/**\n * Settings for `IModelHost.appWorkspace`.\n * @note this includes the default dictionary from the SettingsSpecRegistry\n */\nclass ApplicationSettings extends SettingsImpl {\n  private _remove?: VoidFunction;\n  protected override verifyPriority(priority: SettingsPriority) {\n    if (priority > SettingsPriority.application) // only application or lower may appear in ApplicationSettings\n      throw new Error(\"Use IModelSettings\");\n  }\n  private updateDefaults() {\n    const defaults: SettingsContainer = {};\n    for (const [schemaName, val] of IModelHost.settingsSchemas.settingDefs) {\n      if (val.default)\n        defaults[schemaName] = val.default;\n    }\n    this.addDictionary({ name: \"_default_\", priority: 0 }, defaults);\n  }\n\n  public constructor() {\n    super();\n    this._remove = IModelHost.settingsSchemas.onSchemaChanged.addListener(() => this.updateDefaults());\n    this.updateDefaults();\n  }\n\n  public override close() {\n    if (this._remove) {\n      this._remove();\n      this._remove = undefined;\n    }\n  }\n}\n\nconst definedInStartup = <T>(obj: T | undefined): T => {\n  if (obj === undefined)\n    throw new Error(\"IModelHost.startup must be called first\");\n  return obj;\n};\n\n/** IModelHost initializes ($backend) and captures its configuration. A backend must call [[IModelHost.startup]] before using any backend classes.\n * See [the learning article]($docs/learning/backend/IModelHost.md)\n * @public\n */\nexport class IModelHost {\n  private constructor() { }\n\n  /** The AuthorizationClient used to obtain [AccessToken]($bentley)s. */\n  public static authorizationClient?: AuthorizationClient;\n\n  public static backendVersion = \"\";\n  private static _profileName: string;\n  private static _cacheDir = \"\";\n  private static _settingsSchemas?: SettingsSchemas;\n  private static _appWorkspace?: OwnedWorkspace;\n\n  // Omit the hubAccess field from configuration so it stays internal.\n  public static configuration?: Omit<IModelHostOptions, \"hubAccess\">;\n\n  /**\n   * The name of the *Profile* directory (a subdirectory of \"[[cacheDir]]/profiles/\") for this process.\n   *\n   * The *Profile* directory is used to cache data that is specific to a type-of-usage of the iTwin.js library.\n   * It is important that information in the profile cache be consistent but isolated across sessions (i.e.\n   * data for a profile is maintained between runs, but each profile is completely independent and\n   * unaffected by the presence or use of others.)\n   * @note **Only one process at a time may be using a given profile**, and an exception will be thrown by [[startup]]\n   * if a second process attempts to use the same profile.\n   * @beta\n   */\n  public static get profileName(): string {\n    return this._profileName;\n  }\n\n  /** The full path of the Profile directory.\n   * @see [[profileName]]\n   * @beta\n   */\n  public static get profileDir(): LocalDirName {\n    return join(this._cacheDir, \"profiles\", this._profileName);\n  }\n\n  /** Event raised during startup to allow loading settings data */\n  public static readonly onWorkspaceStartup = new BeEvent<() => void>();\n\n  /** Event raised just after the backend IModelHost was started */\n  public static readonly onAfterStartup = new BeEvent<() => void>();\n\n  /** Event raised just before the backend IModelHost is to be shut down */\n  public static readonly onBeforeShutdown = new BeEvent<() => void>();\n\n  /** @internal */\n  public static readonly session: Mutable<SessionProps> = { applicationId: \"2686\", applicationVersion: \"1.0.0\", sessionId: \"\" };\n\n  /** A uniqueId for this session */\n  public static get sessionId() { return this.session.sessionId; }\n  public static set sessionId(id: GuidString) { this.session.sessionId = id; }\n\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. */\n  public static get applicationId() { return this.session.applicationId; }\n  public static set applicationId(id: string) { this.session.applicationId = id; }\n\n  /** The version of this application - needs to be set if is an agent application. The applicationVersion will otherwise originate at the frontend. */\n  public static get applicationVersion() { return this.session.applicationVersion; }\n  public static set applicationVersion(version: string) { this.session.applicationVersion = version; }\n\n  /** A string that can identify the current user to other users when collaborating. */\n  public static userMoniker = \"unknown\";\n\n  /** Root directory holding files that iTwin.js caches */\n  public static get cacheDir(): LocalDirName { return this._cacheDir; }\n\n  /** The application [[Workspace]] for this `IModelHost`\n   * @note this `Workspace` only holds [[WorkspaceContainer]]s and [[Settings]] scoped to the currently loaded application(s).\n   * All organization, iTwin, and iModel based containers or settings must be accessed through [[IModelDb.workspace]] and\n   * attempting to add them to this Workspace will fail.\n   * @beta\n   */\n  public static get appWorkspace(): Workspace { return definedInStartup(this._appWorkspace); }\n\n  /** The registry of schemas describing the [[Setting]]s for the application session.\n   * Applications should register their schemas via methods like [[SettingsSchemas.addGroup]].\n   * @beta\n   */\n  public static get settingsSchemas(): SettingsSchemas { return definedInStartup(this._settingsSchemas); }\n\n  /** The optional [[FileNameResolver]] that resolves keys and partial file names for snapshot iModels.\n   * @deprecated in 4.10 - will not be removed until after 2026-06-13. When opening a snapshot by file name, ensure to pass already resolved path. Using a key to open a snapshot is now deprecated.\n   */\n  public static snapshotFileNameResolver?: FileNameResolver; // eslint-disable-line @typescript-eslint/no-deprecated\n\n  /** Get the current access token for this IModelHost, or a blank string if none is available.\n   * @note for web backends, this will *always* return a blank string because the backend itself has no token (but never needs one either.)\n   * For all IpcHosts, where this backend is servicing a single frontend, this will be the user's token. For ElectronHost, the backend\n   * obtains the token and forwards it to the frontend.\n   * @note accessTokens expire periodically and are automatically refreshed, if possible. Therefore tokens should not be saved, and the value\n   * returned by this method may change over time throughout the course of a session.\n   */\n  public static async getAccessToken(): Promise<AccessToken> {\n    try {\n      return (await IModelHost.authorizationClient?.getAccessToken()) ?? \"\";\n    } catch {\n      return \"\";\n    }\n  }\n\n  private static loadNative(options: IModelHostOptions) {\n    loadNativePlatform();\n\n    if (options.crashReportingConfig && options.crashReportingConfig.crashDir && !ProcessDetector.isElectronAppBackend && !ProcessDetector.isMobileAppBackend) {\n      IModelNative.platform.setCrashReporting(options.crashReportingConfig);\n\n      Logger.logTrace(loggerCategory, \"Configured crash reporting\", {\n        enableCrashDumps: options.crashReportingConfig?.enableCrashDumps,\n        wantFullMemoryDumps: options.crashReportingConfig?.wantFullMemoryDumps,\n        enableNodeReport: options.crashReportingConfig?.enableNodeReport,\n        uploadToBentley: options.crashReportingConfig?.uploadToBentley,\n      });\n\n      if (options.crashReportingConfig.enableNodeReport) {\n        if (process.report !== undefined) {\n          process.report.reportOnFatalError = true;\n          process.report.reportOnUncaughtException = true;\n          process.report.directory = options.crashReportingConfig.crashDir;\n          Logger.logTrace(loggerCategory, \"Configured Node.js crash reporting\");\n        } else {\n          Logger.logWarning(loggerCategory, \"Unable to configure Node.js crash reporting\");\n        }\n      }\n    }\n  }\n\n  /** @internal */\n  public static tileStorage?: TileStorage;\n\n  private static _hubAccess?: BackendHubAccess;\n  /** @internal */\n  public static [_setHubAccess](hubAccess: BackendHubAccess | undefined) { this._hubAccess = hubAccess; }\n\n  /** get the current hubAccess, if present.\n   * @internal\n   */\n  public static [_getHubAccess](): BackendHubAccess | undefined { return this._hubAccess; }\n\n  /** Provides access to the IModelHub for this IModelHost\n   * @internal\n   * @note If [[IModelHostOptions.hubAccess]] was undefined when initializing this class, accessing this property will throw an error.\n   * To determine whether one is present, use [[_getHubAccess]].\n   */\n  public static get [_hubAccess](): BackendHubAccess {\n    if (IModelHost._hubAccess === undefined)\n      throw new IModelError(IModelStatus.BadRequest, \"No BackendHubAccess supplied in IModelHostOptions\");\n    return IModelHost._hubAccess;\n  }\n\n  private static initializeWorkspace(configuration: IModelHostOptions) {\n    const settingAssets = join(KnownLocations.packageAssetsDir, \"Settings\");\n    this._settingsSchemas = constructSettingsSchemas();\n    this._settingsSchemas.addDirectory(join(settingAssets, \"Schemas\"));\n    this._appWorkspace = constructWorkspace(new ApplicationSettings(), configuration.workspace);\n\n    // Create the CloudCache for Workspaces. This will fail if another process is already using the same profile.\n    try {\n      this.appWorkspace.getCloudCache();\n    } catch (e: any) {\n      throw (e.errorNumber === DbResult.BE_SQLITE_BUSY) ? new IModelError(DbResult.BE_SQLITE_BUSY, `Profile [${this.profileDir}] is already in use by another process`) : e;\n    }\n\n    this.appWorkspace.settings.addDirectory(settingAssets, SettingsPriority.defaults);\n\n    GeoCoordConfig.onStartup();\n    // allow applications to load their default settings\n    this.onWorkspaceStartup.raiseEvent();\n  }\n\n  private static _isValid = false;\n\n  /** true between a successful call to [[startup]] and before [[shutdown]] */\n  public static get isValid() {\n    return IModelHost._isValid;\n  }\n\n  /** This method must be called before any iTwin.js services are used.\n   * @param options Host configuration data.\n   * Raises [[onAfterStartup]].\n   * @see [[shutdown]].\n   */\n  public static async startup(options?: IModelHostOptions): Promise<void> {\n    if (this._isValid)\n      return; // we're already initialized\n    this._isValid = true;\n\n    options = options ?? {};\n    if (this.sessionId === \"\")\n      this.sessionId = Guid.createValue();\n\n    this.authorizationClient = options.authorizationClient;\n\n    this.backendVersion = require(\"../../package.json\").version; // eslint-disable-line @typescript-eslint/no-require-imports\n    initializeRpcBackend(options.enableOpenTelemetry);\n\n    this.loadNative(options);\n    this.setupCacheDir(options);\n    this.initializeWorkspace(options);\n\n    BriefcaseManager.initialize(join(this._cacheDir, \"imodels\"));\n\n    [\n      IModelReadRpcImpl,\n      IModelTileRpcImpl,\n      SnapshotIModelRpcImpl, // eslint-disable-line @typescript-eslint/no-deprecated\n      DevToolsRpcImpl,\n    ].forEach((rpc) => rpc.register()); // register all of the RPC implementations\n\n    [\n      BisCoreSchema,\n      GenericSchema,\n      FunctionalSchema,\n    ].forEach((schema) => schema.registerSchema()); // register all of the schemas\n\n    const { hubAccess, ...otherOptions } = options;\n    if (undefined !== hubAccess)\n      this._hubAccess = hubAccess;\n\n    this.configuration = otherOptions;\n    this.setupTileCache();\n\n    process.once(\"beforeExit\", IModelHost.shutdown);\n    this.onAfterStartup.raiseEvent();\n  }\n\n  private static setupCacheDir(configuration: IModelHostOptions) {\n    this._cacheDir = normalizeDir(configuration.cacheDir ?? NativeLibrary.defaultCacheDir);\n    IModelJsFs.recursiveMkDirSync(this._cacheDir);\n\n    this._profileName = configuration.profileName ?? \"default\";\n    Logger.logInfo(loggerCategory, `cacheDir: [${this.cacheDir}], profileDir: [${this.profileDir}]`);\n  }\n\n  /** This method must be called when an iTwin.js host is shut down. Raises [[onBeforeShutdown]] */\n  public static async shutdown(this: void): Promise<void> {\n    // Note: This method is set as a node listener where `this` is unbound. Call private method to\n    // ensure `this` is correct. Don't combine these methods.\n    return IModelHost.doShutdown();\n  }\n\n  /**\n   * Create a new iModel.\n   * @returns the Guid of the newly created iModel.\n   * @throws [IModelError]($common) in case of errors.\n   * @note If [[IModelHostOptions.hubAccess]] was undefined in the call to [[startup]], this function will throw an error.\n   */\n  public static async createNewIModel(arg: CreateNewIModelProps): Promise<GuidString> {\n    return this[_hubAccess].createNewIModel(arg);\n  }\n\n  private static async doShutdown() {\n    if (!this._isValid)\n      return;\n\n    this._isValid = false;\n    this.onBeforeShutdown.raiseEvent();\n\n    this.configuration = undefined;\n    this.tileStorage = undefined;\n\n    this._appWorkspace?.close();\n    this._appWorkspace = undefined;\n    this._settingsSchemas = undefined;\n\n    CloudSqlite.CloudCaches.destroy();\n    process.removeListener(\"beforeExit\", IModelHost.shutdown);\n  }\n\n  /**\n   * Add or update a property that should be included in a crash report.\n   * @internal\n   */\n  public static setCrashReportProperty(name: string, value: string): void {\n    IModelNative.platform.setCrashReportProperty(name, value);\n  }\n\n  /**\n   * Remove a previously defined property so that will not be included in a crash report.\n   * @internal\n   */\n  public static removeCrashReportProperty(name: string): void {\n    IModelNative.platform.setCrashReportProperty(name, undefined);\n  }\n\n  /**\n   * Get all properties that will be included in a crash report.\n   * @internal\n   */\n  public static getCrashReportProperties(): CrashReportingConfigNameValuePair[] {\n    return IModelNative.platform.getCrashReportProperties();\n  }\n\n  /** The directory where application assets may be found */\n  public static get appAssetsDir(): string | undefined {\n    return undefined !== IModelHost.configuration ? IModelHost.configuration.appAssetsDir : undefined;\n  }\n\n  /** The time, in milliseconds, for which IModelTileRpcInterface.requestTileTreeProps should wait before returning a \"pending\" status.\n   * @internal\n   */\n  public static get tileTreeRequestTimeout(): number {\n    return IModelHost.configuration?.tileTreeRequestTimeout ?? IModelHostConfiguration.defaultTileRequestTimeout;\n  }\n  /** The time, in milliseconds, for which IModelTileRpcInterface.requestTileContent should wait before returning a \"pending\" status.\n   * @internal\n   */\n  public static get tileContentRequestTimeout(): number {\n    return IModelHost.configuration?.tileContentRequestTimeout ?? IModelHostConfiguration.defaultTileRequestTimeout;\n  }\n\n  /** The backend will log when a tile took longer to load than this threshold in seconds. */\n  public static get logTileLoadTimeThreshold(): number {\n    return IModelHost.configuration?.logTileLoadTimeThreshold ?? IModelHostConfiguration.defaultLogTileLoadTimeThreshold;\n  }\n  /** The backend will log when a tile is loaded with a size in bytes above this threshold. */\n  public static get logTileSizeThreshold(): number {\n    return IModelHost.configuration?.logTileSizeThreshold ?? IModelHostConfiguration.defaultLogTileSizeThreshold;\n  }\n\n  /** Whether external tile caching is active.\n   * @internal\n   */\n  public static get usingExternalTileCache(): boolean {\n    return undefined !== IModelHost.tileStorage;\n  }\n\n  /** Whether to restrict tile cache URLs by client IP address.\n   * @internal\n   */\n  public static get restrictTileUrlsByClientIp(): boolean {\n    return undefined !== IModelHost.configuration && (IModelHost.configuration.restrictTileUrlsByClientIp ? true : false);\n  }\n\n  /** Whether to compress cached tiles.\n   * @internal\n   */\n  public static get compressCachedTiles(): boolean {\n    return false !== IModelHost.configuration?.compressCachedTiles;\n  }\n\n  /**\n   * Whether to use semantic rebase or not.\n   * @internal\n   */\n  public static get useSemanticRebase(): boolean {\n    return undefined !== IModelHost.configuration && (IModelHost.configuration.useSemanticRebase ? true : false);\n  }\n\n  private static setupTileCache() {\n    assert(undefined !== IModelHost.configuration);\n    const config = IModelHost.configuration;\n    const storage = config.tileCacheStorage;\n    const credentials = config.tileCacheAzureCredentials;\n\n    if (!storage && !credentials) {\n      IModelNative.platform.setMaxTileCacheSize(config.maxTileCacheDbSize ?? IModelHostConfiguration.defaultMaxTileCacheDbSize);\n      return;\n    }\n\n    IModelNative.platform.setMaxTileCacheSize(0);\n    if (credentials) {\n      if (storage)\n        throw new IModelError(BentleyStatus.ERROR, \"Cannot use both Azure and custom cloud storage providers for tile cache.\");\n      this.setupAzureTileCache(credentials);\n    }\n    if (storage)\n      IModelHost.tileStorage = new TileStorage(storage);\n  }\n\n  private static setupAzureTileCache(credentials: AzureBlobStorageCredentials) {\n    const storageConfig: AzureServerStorageConfig = {\n      accountName: credentials.account,\n      accountKey: credentials.accessKey,\n      baseUrl: credentials.baseUrl ?? `https://${credentials.account}.blob.core.windows.net`,\n    }\n    const blobServiceClient = new BlobServiceClient(\n      storageConfig.baseUrl,\n      new StorageSharedKeyCredential(storageConfig.accountName, storageConfig.accountKey),\n    );\n    const azureStorage: ServerStorage = new AzureServerStorage(storageConfig, new BlobServiceClientWrapper(blobServiceClient))\n    IModelHost.tileStorage = new TileStorage(azureStorage);\n  }\n\n  /** @internal */\n  public static computeSchemaChecksum(arg: { schemaXmlPath: string, referencePaths: string[], exactMatch?: boolean }): string {\n    return IModelNative.platform.computeSchemaChecksum(arg);\n  }\n}\n\n/** Information about the platform on which the app is running.\n * @public\n */\nexport class Platform {\n  /** Get the name of the platform. */\n  public static get platformName(): \"win32\" | \"linux\" | \"darwin\" | \"ios\" | \"android\" | \"uwp\" {\n    return process.platform as any;\n  }\n}\n\n/** Well known directories that may be used by the application.\n * @public\n */\nexport class KnownLocations {\n\n  /** The directory where the imodeljs-native assets are stored. */\n  public static get nativeAssetsDir(): LocalDirName {\n    return IModelNative.platform.DgnDb.getAssetsDir();\n  }\n\n  /** The directory where the core-backend assets are stored. */\n  public static get packageAssetsDir(): LocalDirName {\n    return join(__dirname, \"assets\");\n  }\n\n  /** The temporary directory. */\n  public static get tmpdir(): LocalDirName {\n    return os.tmpdir();\n  }\n}\n\n/** Extend this class to provide custom file name resolution behavior.\n * @note Only `tryResolveKey` and/or `tryResolveFileName` need to be overridden as the implementations of `resolveKey` and `resolveFileName` work for most purposes.\n * @see [[IModelHost.snapshotFileNameResolver]]\n * @public\n * @deprecated in 4.10 - will not be removed until after 2026-06-13. When opening a snapshot by file name, ensure to pass already resolved path. Using a key to open a snapshot is now deprecated.\n */\nexport abstract class FileNameResolver {\n  /** Resolve a file name from the specified key.\n   * @param _fileKey The key that identifies the file name in a `Map` or other similar data structure.\n   * @returns The resolved file name or `undefined` if not found.\n   */\n  public tryResolveKey(_fileKey: string): string | undefined { return undefined; }\n  /** Resolve a file name from the specified key.\n   * @param fileKey The key that identifies the file name in a `Map` or other similar data structure.\n   * @returns The resolved file name.\n   * @throws [[IModelError]] if not found.\n   */\n  public resolveKey(fileKey: string): string {\n    const resolvedFileName: string | undefined = this.tryResolveKey(fileKey);\n    if (undefined === resolvedFileName) {\n      throw new IModelError(IModelStatus.NotFound, `${fileKey} not resolved`);\n    }\n    return resolvedFileName;\n  }\n  /** Resolve the input file name, which may be a partial name, into a full path file name.\n   * @param inFileName The partial file name.\n   * @returns The resolved full path file name or `undefined` if not found.\n   */\n  public tryResolveFileName(inFileName: string): string | undefined { return inFileName; }\n  /** Resolve the input file name, which may be a partial name, into a full path file name.\n   * @param inFileName The partial file name.\n   * @returns The resolved full path file name.\n   * @throws [[IModelError]] if not found.\n   */\n  public resolveFileName(inFileName: string): string {\n    const resolvedFileName: string | undefined = this.tryResolveFileName(inFileName);\n    if (undefined === resolvedFileName) {\n      throw new IModelError(IModelStatus.NotFound, `${inFileName} not resolved`);\n    }\n    return resolvedFileName;\n  }\n}\n"]}
+{"version":3,"file":"IModelHost.js","sourceRoot":"","sources":["../../src/IModelHost.ts"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n* See LICENSE.md in the project root for license terms and full copyright notice.\n*--------------------------------------------------------------------------------------------*/\n/** @packageDocumentation\n * @module IModelHost\n */\n\n// To avoid circular load errors, the \"Element\" classes must be loaded before IModelHost.\nimport \"./IModelDb\"; // DO NOT REMOVE OR MOVE THIS LINE!\n\nimport { IModelNative, loadNativePlatform } from \"./internal/NativePlatform\";\nimport * as os from \"node:os\";\nimport { NativeLibrary } from \"@bentley/imodeljs-native\";\nimport { AccessToken, assert, BeEvent, BentleyStatus, DbResult, Guid, GuidString, IModelStatus, Logger, Mutable, ProcessDetector } from \"@itwin/core-bentley\";\nimport { AuthorizationClient, IModelError, ITwinSettingsError, LocalDirName, SessionProps } from \"@itwin/core-common\";\nimport { AzureServerStorage, AzureServerStorageConfig, BlobServiceClientWrapper } from \"@itwin/object-storage-azure\";\nimport { BlobServiceClient, StorageSharedKeyCredential } from \"@azure/storage-blob\";\nimport type { ServerStorage } from \"@itwin/object-storage-core\";\nimport { BackendHubAccess, CreateNewIModelProps } from \"./BackendHubAccess\";\nimport { BackendLoggerCategory } from \"./BackendLoggerCategory\";\nimport { BisCoreSchema } from \"./BisCoreSchema\";\nimport { BriefcaseManager } from \"./BriefcaseManager\";\nimport { CloudSqlite } from \"./CloudSqlite\";\nimport { FunctionalSchema } from \"./domains/FunctionalSchema\";\nimport { GenericSchema } from \"./domains/GenericSchema\";\nimport { EditTxn } from \"./EditTxn\";\nimport { GeoCoordConfig } from \"./GeoCoordConfig\";\nimport { IModelJsFs } from \"./IModelJsFs\";\nimport { DevToolsRpcImpl } from \"./rpc-impl/DevToolsRpcImpl\";\nimport { IModelReadRpcImpl } from \"./rpc-impl/IModelReadRpcImpl\";\nimport { IModelTileRpcImpl } from \"./rpc-impl/IModelTileRpcImpl\";\nimport { SnapshotIModelRpcImpl } from \"./rpc-impl/SnapshotIModelRpcImpl\";\nimport { initializeRpcBackend } from \"./RpcBackend\";\nimport { TileStorage } from \"./TileStorage\";\nimport { type Setting, SettingsContainer, SettingsDictionary, SettingsPriority } from \"./workspace/Settings\";\nimport { settingsWorkspaceDbName } from \"./workspace/SettingsDb\";\nimport { SettingsContainers, SettingsEditor } from \"./workspace/SettingsEditor\";\nimport { SettingsSchemas } from \"./workspace/SettingsSchemas\";\nimport { Workspace, WorkspaceDbLoadError, WorkspaceDbSettingsProps, WorkspaceOpts } from \"./workspace/Workspace\";\nimport { join, normalize as normalizeDir } from \"path\";\nimport { constructWorkspace, OwnedWorkspace, throwWorkspaceDbLoadErrors } from \"./internal/workspace/WorkspaceImpl\";\nimport { SettingsImpl } from \"./internal/workspace/SettingsImpl\";\nimport { constructSettingsSchemas } from \"./internal/workspace/SettingsSchemasImpl\";\nimport { _getHubAccess, _hubAccess, _setHubAccess } from \"./internal/Symbols\";\n\nconst loggerCategory = BackendLoggerCategory.IModelHost;\n\n// cspell:ignore nodereport fatalerror apicall alicloud rpcs\n\n/** @internal */\nexport interface CrashReportingConfigNameValuePair {\n  name: string;\n  value: string;\n}\n\n/** Configuration of the crash-reporting system.\n * @internal\n */\nexport interface CrashReportingConfig {\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. */\n  crashDir: string;\n  /** max # .dmp files that may exist in crashDir. The default is 50. */\n  maxDumpsInDir?: number;\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. */\n  enableCrashDumps?: boolean;\n  /** If enableCrashDumps is true, do you want a full-memory dump? Defaults to false. */\n  wantFullMemoryDumps?: boolean;\n  /** Enable Node.js crash reporting? If so, report files will be generated in the event of an unhandled exception or fatal error and written to crashDir. The default is false. */\n  enableNodeReport?: boolean;\n  /** Additional name, value pairs to write to iModelJsNativeCrash*.properties.txt file in the event of a crash. */\n  params?: CrashReportingConfigNameValuePair[];\n  /** Run this .js file to process .dmp and Node.js crash reporting .json files in the event of a crash.\n   * This script will be executed with a single command-line parameter: the name of the dump or Node.js report file.\n   * In the case of a dump file, there will be a second file with the same basename and the extension \".properties.txt\".\n   * Since it runs in a separate process, this script will have no access to the Javascript\n   * context of the exiting backend. No default.\n   */\n  dumpProcessorScriptFileName?: string;\n  /** Upload crash dump and node-reports to Bentley's crash-reporting service? Defaults to false */\n  uploadToBentley?: boolean;\n}\n\n/** @beta */\nexport interface AzureBlobStorageCredentials {\n  account: string;\n  accessKey: string;\n  baseUrl?: string;\n}\n\n/** Controls how iModel writes through the implicit transaction are enforced.\n *\n * Allowed values:\n * - \"allow\": preserve pre-version 5.8.0 behavior for backwards compatibility.\n * - \"log\": allow the operation but log each implicit write as an error case.\n * - \"throw\": reject writes through the implicit transaction and require explicit EditTxns.\n * @beta\n */\nexport type ImplicitWriteEnforcement = \"allow\" | \"log\" | \"throw\";\n\n/**\n * Options for [[IModelHost.startup]]\n * @public\n */\nexport interface IModelHostOptions {\n  /**\n   * The name of the *Profile* subdirectory of [[cacheDir]] for this process. If not present, \"default\" is used.\n   * @see [[IModelHost.profileName]]\n   * @beta\n   */\n  profileName?: string;\n\n  /**\n   * Root of the directory holding all the files that iTwin.js caches\n   * - If not specified at startup a platform specific default is used -\n   *   - Windows: $(HOMEDIR)/AppData/Local/iModelJs/\n   *   - Mac/iOS: $(HOMEDIR)/Library/Caches/iModelJs/\n   *   - Linux:   $(HOMEDIR)/.cache/iModelJs/\n   *   where $(HOMEDIR) is documented [here](https://nodejs.org/api/os.html#os_os_homedir)\n   * - if specified, ensure it is set to a folder with read/write access.\n   * @see [[IModelHost.cacheDir]] for the value it's set to after startup\n   */\n  cacheDir?: LocalDirName;\n\n  /** The directory where application assets are found. */\n  appAssetsDir?: LocalDirName;\n\n  /**\n   * Options for creating the [[IModelHost.appWorkspace]]\n   * @beta\n   */\n  workspace?: WorkspaceOpts;\n\n  /**\n   * The kind of iModel hub server to use.\n   */\n  hubAccess?: BackendHubAccess;\n\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.\n   * @beta\n   */\n  tileCacheAzureCredentials?: AzureBlobStorageCredentials;\n\n  /**\n   * @beta\n   * @note A reference implementation is set for AzureServerStorage from @itwin/object-storage-azure if [[tileCacheAzureCredentials]] property is set. To supply a different implementation for any service provider (such as AWS),\n   *       set this property with a custom ServerStorage.\n   */\n  tileCacheStorage?: ServerStorage;\n\n  /** The maximum size in bytes to which a local sqlite database used for caching tiles can grow before it is purged of least-recently-used tiles.\n   * The local cache is used only if an external cache has not been configured via [[tileCacheStorage]], and [[tileCacheAzureCredentials]].\n   * Defaults to 1 GB. Must be an unsigned integer. A value of zero disables the local cache entirely.\n   * @beta\n   */\n  maxTileCacheDbSize?: number;\n\n  /** Whether to restrict tile cache URLs by client IP address (if available).\n   * @beta\n   */\n  restrictTileUrlsByClientIp?: boolean;\n\n  /** Whether to enable OpenTelemetry tracing.\n   * Defaults to `false`.\n   */\n  enableOpenTelemetry?: boolean;\n\n  /** Whether to compress cached tiles.\n   * Defaults to `true`.\n   */\n  compressCachedTiles?: boolean;\n\n  /** The time, in milliseconds, for which [IModelTileRpcInterface.requestTileTreeProps]($common) should wait before returning a \"pending\" status.\n   * @internal\n   */\n  tileTreeRequestTimeout?: number;\n\n  /** The time, in milliseconds, for which [IModelTileRpcInterface.requestTileContent]($common) should wait before returning a \"pending\" status.\n   * @internal\n   */\n  tileContentRequestTimeout?: number;\n\n  /** The backend will log when a tile took longer to load than this threshold in seconds.\n   * @internal\n   */\n  logTileLoadTimeThreshold?: number;\n\n  /** The backend will log when a tile is loaded with a size in bytes above this threshold.\n   * @internal\n   */\n  logTileSizeThreshold?: number;\n\n  /** Crash-reporting configuration\n   * @internal\n   */\n  crashReportingConfig?: CrashReportingConfig;\n\n  /** The AuthorizationClient used to obtain [AccessToken]($bentley)s. */\n  authorizationClient?: AuthorizationClient;\n\n  /**\n   * Automatically enable shared channel when opening iModels for read/write (see [Working With Channels]($docs/learning/backend/Channel.md)).\n   * If not present, defaults to `true` for backwards compatibility. This means that the shared channel may be edited by default. Generally\n   * that is undesirable because it allows applications to \"accidentally\" modify data it shouldn't be allowed to modify. Unfortunately the\n   * previous versions of iTwin.js allowed it so this is necessary so they won't break.\n   * Will be changed to default to `false` in 5.0.\n   */\n  allowSharedChannel?: boolean;\n\n  /**\n   * Setting this to true will revert to the previous behavior of using the native side for all CRUD operations.\n   * While set to false, the getElement(), getModel() and getAspect() functions will use a thinned down native workflow to read the entities from the database.\n   * This workflow performs work previously done on the native side in the TS side, resulting in performance improvements, if errors are detected,\n   * this option can be set to true to revert to old workflow.\n   */\n  disableThinnedNativeInstanceWorkflow?: boolean;\n\n  /**\n   * Configuration controlling whether to disable the creation of restore points during pull/merge operations.\n   * @beta\n   */\n  disableRestorePointOnPullMerge?: true;\n  /**\n   * Configuration controlling whether incremental schema loading is enabled or disabled.\n   * @beta\n   */\n  incrementalSchemaLoading?: \"enabled\" | \"disabled\";\n  /**\n   * Configuration controlling whether to use semantic rebase or not.\n   * @beta\n   */\n  useSemanticRebase?: boolean;\n\n  /**\n    * Controls how writes through the implicit transaction are enforced.\n    * See [[ImplicitWriteEnforcement]] for the allowed values.\n    * Defaults to \"allow\" for backwards compatibility.\n   * @beta\n   */\n  implicitWriteEnforcement?: ImplicitWriteEnforcement;\n}\n\n/** Configuration of core-backend.\n * @public\n */\nexport class IModelHostConfiguration implements IModelHostOptions {\n  public static defaultTileRequestTimeout = 20 * 1000;\n  public static defaultLogTileLoadTimeThreshold = 40;\n  public static defaultLogTileSizeThreshold = 20 * 1000000;\n  /** @internal */\n  public static defaultMaxTileCacheDbSize = 1024 * 1024 * 1024;\n  public appAssetsDir?: LocalDirName;\n  public cacheDir?: LocalDirName;\n\n  /** @beta */\n  public workspace?: WorkspaceOpts;\n  public hubAccess?: BackendHubAccess;\n  /** The AuthorizationClient used to obtain [AccessToken]($bentley)s. */\n  public authorizationClient?: AuthorizationClient;\n  /** @beta */\n  public restrictTileUrlsByClientIp?: boolean;\n  public compressCachedTiles?: boolean;\n  /** @beta */\n  public tileCacheAzureCredentials?: AzureBlobStorageCredentials;\n  /** @internal */\n  public tileTreeRequestTimeout = IModelHostConfiguration.defaultTileRequestTimeout;\n  /** @internal */\n  public tileContentRequestTimeout = IModelHostConfiguration.defaultTileRequestTimeout;\n  /** @internal */\n  public logTileLoadTimeThreshold = IModelHostConfiguration.defaultLogTileLoadTimeThreshold;\n  /** @internal */\n  public logTileSizeThreshold = IModelHostConfiguration.defaultLogTileSizeThreshold;\n  /** @internal */\n  public crashReportingConfig?: CrashReportingConfig;\n  /**\n   * Configuration controlling whether to use the thinned down native instance functions for element, model, and aspect CRUD operations\n   * or use the previous behavior of using the native side for all CRUD operations. Set to true to revert to the previous behavior.\n   * @beta\n  */\n  public disableThinnedNativeInstanceWorkflow?: boolean;\n\n  /**\n   * Configuration controlling whether to disable the creation of restore points during pull/merge operations.\n   * @beta\n   */\n  public disableRestorePointOnPullMerge?: true;\n  /**\n   * Configuration controlling whether incremental schema loading is disabled.\n   * Default is \"disabled\" at the moment to preserve existing behavior.\n   * @beta\n   */\n  public incrementalSchemaLoading: \"enabled\" | \"disabled\" = \"disabled\";\n  /**\n   * Configuration controlling whether to use semantic rebase or not. By default it is undefined meaning semantic rebase is not used.\n   * @beta\n   */\n  public useSemanticRebase?: boolean;\n  /**\n    * Controls how writes through the implicit transaction are enforced.\n    * See [[IModelHostOptions.implicitWriteEnforcement]] for the meaning of each allowed value.\n   * @beta\n   */\n  public implicitWriteEnforcement: ImplicitWriteEnforcement = \"allow\";\n}\n\n/**\n * Settings for `IModelHost.appWorkspace`.\n * @note this includes the default dictionary from the SettingsSpecRegistry\n */\nclass ApplicationSettings extends SettingsImpl {\n  private _remove?: VoidFunction;\n  protected override verifyPriority(priority: SettingsPriority) {\n    if (priority > SettingsPriority.application) // only application or lower may appear in ApplicationSettings\n      throw new Error(\"Use IModelSettings\");\n  }\n  private updateDefaults() {\n    const defaults: SettingsContainer = {};\n    for (const [schemaName, val] of IModelHost.settingsSchemas.settingDefs) {\n      if (val.default)\n        defaults[schemaName] = val.default;\n    }\n    this.addDictionary({ name: \"_default_\", priority: 0 }, defaults);\n  }\n\n  public constructor() {\n    super();\n    this._remove = IModelHost.settingsSchemas.onSchemaChanged.addListener(() => this.updateDefaults());\n    this.updateDefaults();\n  }\n\n  public override close() {\n    if (this._remove) {\n      this._remove();\n      this._remove = undefined;\n    }\n  }\n}\n\n/**\n * Settings for an iTwin. May only include settings priority for iTwin and organization.\n */\nclass ITwinWorkspaceSettings extends SettingsImpl {\n  protected override verifyPriority(priority: SettingsPriority) {\n    if (priority <= SettingsPriority.application)\n      ITwinSettingsError.throwError(\"invalid-priority\", { message: `Settings with priority ${priority} cannot be added to an iTwin workspace.` });\n    if (priority > SettingsPriority.iTwin)\n      ITwinSettingsError.throwError(\"invalid-priority\", { message: `Settings with priority ${priority} cannot be added to an iTwin workspace.` });\n  }\n\n  public override * getSettingEntries<T extends Setting>(name: string): Iterable<{ value: T, dictionary: SettingsDictionary }> {\n    yield* super.getSettingEntries(name);\n    yield* IModelHost.appWorkspace.settings.getSettingEntries(name);\n  }\n}\n\nconst definedInStartup = <T>(obj: T | undefined): T => {\n  if (obj === undefined)\n    throw new Error(\"IModelHost.startup must be called first\");\n  return obj;\n};\n\n/** IModelHost initializes ($backend) and captures its configuration. A backend must call [[IModelHost.startup]] before using any backend classes.\n * See [the learning article]($docs/learning/backend/IModelHost.md)\n * @public\n */\nexport class IModelHost {\n  private constructor() { }\n\n  /** The AuthorizationClient used to obtain [AccessToken]($bentley)s. */\n  public static authorizationClient?: AuthorizationClient;\n\n  public static backendVersion = \"\";\n  private static _profileName: string;\n  private static _cacheDir = \"\";\n  private static _settingsSchemas?: SettingsSchemas;\n  private static _appWorkspace?: OwnedWorkspace;\n\n  // Omit the hubAccess field from configuration so it stays internal.\n  public static configuration?: Omit<IModelHostOptions, \"hubAccess\">;\n\n  /**\n   * The name of the *Profile* directory (a subdirectory of \"[[cacheDir]]/profiles/\") for this process.\n   *\n   * The *Profile* directory is used to cache data that is specific to a type-of-usage of the iTwin.js library.\n   * It is important that information in the profile cache be consistent but isolated across sessions (i.e.\n   * data for a profile is maintained between runs, but each profile is completely independent and\n   * unaffected by the presence or use of others.)\n   * @note **Only one process at a time may be using a given profile**, and an exception will be thrown by [[startup]]\n   * if a second process attempts to use the same profile.\n   * @beta\n   */\n  public static get profileName(): string {\n    return this._profileName;\n  }\n\n  /** The full path of the Profile directory.\n   * @see [[profileName]]\n   * @beta\n   */\n  public static get profileDir(): LocalDirName {\n    return join(this._cacheDir, \"profiles\", this._profileName);\n  }\n\n  /** Event raised during startup to allow loading settings data */\n  public static readonly onWorkspaceStartup = new BeEvent<() => void>();\n\n  /** Event raised just after the backend IModelHost was started */\n  public static readonly onAfterStartup = new BeEvent<() => void>();\n\n  /** Event raised just before the backend IModelHost is to be shut down */\n  public static readonly onBeforeShutdown = new BeEvent<() => void>();\n\n  /** @internal */\n  public static readonly session: Mutable<SessionProps> = { applicationId: \"2686\", applicationVersion: \"1.0.0\", sessionId: \"\" };\n\n  /** A uniqueId for this session */\n  public static get sessionId() { return this.session.sessionId; }\n  public static set sessionId(id: GuidString) { this.session.sessionId = id; }\n\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. */\n  public static get applicationId() { return this.session.applicationId; }\n  public static set applicationId(id: string) { this.session.applicationId = id; }\n\n  /** The version of this application - needs to be set if is an agent application. The applicationVersion will otherwise originate at the frontend. */\n  public static get applicationVersion() { return this.session.applicationVersion; }\n  public static set applicationVersion(version: string) { this.session.applicationVersion = version; }\n\n  /** A string that can identify the current user to other users when collaborating. */\n  public static userMoniker = \"unknown\";\n\n  /** Root directory holding files that iTwin.js caches */\n  public static get cacheDir(): LocalDirName { return this._cacheDir; }\n\n  /** The application [[Workspace]] for this `IModelHost`\n   * @note this `Workspace` only holds [[WorkspaceContainer]]s and [[Settings]] scoped to the currently loaded application(s).\n   * All organization, iTwin, and iModel based containers or settings must be accessed through [[IModelDb.workspace]] and\n   * attempting to add them to this Workspace will fail.\n   * @beta\n   */\n  public static get appWorkspace(): Workspace { return definedInStartup(this._appWorkspace); }\n\n  /** Obtain the [[Workspace]] for an iTwin by discovering its settings container.\n   * All named dictionary resources in the container's [[WorkspaceDb]] are loaded into the workspace at [[SettingsPriority.iTwin]].\n   * @note This method requires an internet connection to discover the container.\n   * To use an iTwin workspace offline, use the overload that accepts [[WorkspaceDbSettingsProps]].\n   * @note The returned workspace is caller-owned. Call `close` when finished.\n   * @beta\n   */\n  public static async getITwinWorkspace(iTwinId: GuidString): Promise<OwnedWorkspace>;\n  /** Obtain the [[Workspace]] for an iTwin.\n   * The supplied [[WorkspaceDbSettingsProps]] are passed directly to [[Workspace.loadSettingsDictionary]].\n    * @note You can derive these from the `settingsSources` property on a previously returned workspace.\n    * @note The returned workspace is caller-owned. Call `close` when finished.\n   * @beta\n   */\n  public static async getITwinWorkspace(props: WorkspaceDbSettingsProps | WorkspaceDbSettingsProps[]): Promise<OwnedWorkspace>;\n  /** @internal */\n  public static async getITwinWorkspace(args: GuidString | WorkspaceDbSettingsProps | WorkspaceDbSettingsProps[]): Promise<OwnedWorkspace> {\n    const isITwinId = typeof args === \"string\";\n    const workspace = constructWorkspace(new ITwinWorkspaceSettings());\n\n    try {\n      const settingsSources = isITwinId ? await SettingsContainers.getITwinSettingsSources(args) : args;\n      if (undefined === settingsSources)\n        return workspace;\n\n      workspace.settingsSources = settingsSources;\n\n      const problems: WorkspaceDbLoadError[] = [];\n      await workspace.loadSettingsDictionary(settingsSources, problems);\n\n      if (problems.length > 0) {\n        const label = isITwinId ? `iTwin '${args}'` : \"the supplied settings workspace db properties\";\n        throwWorkspaceDbLoadErrors(`attempting to load workspace settings for ${label}`, problems);\n      }\n\n      return workspace;\n    } catch (error) {\n      workspace.close();\n      throw error;\n    }\n  }\n\n  /** Save a named [[SettingsDictionary]] to the iTwin's settings container.\n   * If no iTwin settings container exists for `iTwinId`, one is created.\n   * The dictionary is stored as a named resource in the container's default [[WorkspaceDb]], where `name` is used as the resource name.\n   * @param iTwinId The iTwin whose settings container should be updated.\n   * @param name The name of the dictionary, used as the resource name in the [[WorkspaceDb]].\n   * @param settings The settings key-value pairs to store.\n   * @note uses [[IModelHost.userMoniker]] as the user name for acquiring the write lock on the settings container.\n   * @beta\n   */\n  public static async saveSettingDictionary(iTwinId: GuidString, name: string, settings: SettingsContainer): Promise<void> {\n    const { editor, container } = await SettingsEditor.constructForITwin(iTwinId);\n    try {\n      await container.withEditableDb(this.userMoniker, (db) => {\n        db.updateSettingsResource(settings, name);\n      }, { dbName: settingsWorkspaceDbName });\n    } finally {\n      editor.close();\n    }\n  }\n\n  /** Delete a named [[SettingsDictionary]] from the iTwin's settings container.\n   * If no iTwin settings container exists, this method does nothing.\n   * @param iTwinId The iTwin whose settings container should be updated.\n   * @param name The name of the dictionary (resource name) to delete.\n   * @note uses [[IModelHost.userMoniker]] as the user name for acquiring the write lock on the settings container.\n   * @beta\n   */\n  public static async deleteSettingDictionary(iTwinId: GuidString, name: string): Promise<void> {\n    const settingsEditor = await SettingsEditor.getForITwin(iTwinId);\n    if (undefined === settingsEditor)\n      return;\n\n    const { editor, container } = settingsEditor;\n    try {\n      await container.withEditableDb(this.userMoniker, (db) => {\n        db.removeString(name);\n      }, { dbName: settingsWorkspaceDbName });\n    } finally {\n      editor.close();\n    }\n  }\n\n  /** The registry of schemas describing the [[Setting]]s for the application session.\n   * Applications should register their schemas via methods like [[SettingsSchemas.addGroup]].\n   * @beta\n   */\n  public static get settingsSchemas(): SettingsSchemas { return definedInStartup(this._settingsSchemas); }\n\n  /** The optional [[FileNameResolver]] that resolves keys and partial file names for snapshot iModels.\n   * @deprecated in 4.10 - will not be removed until after 2026-06-13. When opening a snapshot by file name, ensure to pass already resolved path. Using a key to open a snapshot is now deprecated.\n   */\n  public static snapshotFileNameResolver?: FileNameResolver; // eslint-disable-line @typescript-eslint/no-deprecated\n\n  /** Get the current access token for this IModelHost, or a blank string if none is available.\n   * @note for web backends, this will *always* return a blank string because the backend itself has no token (but never needs one either.)\n   * For all IpcHosts, where this backend is servicing a single frontend, this will be the user's token. For ElectronHost, the backend\n   * obtains the token and forwards it to the frontend.\n   * @note accessTokens expire periodically and are automatically refreshed, if possible. Therefore tokens should not be saved, and the value\n   * returned by this method may change over time throughout the course of a session.\n   */\n  public static async getAccessToken(): Promise<AccessToken> {\n    try {\n      return (await IModelHost.authorizationClient?.getAccessToken()) ?? \"\";\n    } catch {\n      return \"\";\n    }\n  }\n\n  private static loadNative(options: IModelHostOptions) {\n    loadNativePlatform();\n\n    if (options.crashReportingConfig && options.crashReportingConfig.crashDir && !ProcessDetector.isElectronAppBackend && !ProcessDetector.isMobileAppBackend) {\n      IModelNative.platform.setCrashReporting(options.crashReportingConfig);\n\n      Logger.logTrace(loggerCategory, \"Configured crash reporting\", {\n        enableCrashDumps: options.crashReportingConfig?.enableCrashDumps,\n        wantFullMemoryDumps: options.crashReportingConfig?.wantFullMemoryDumps,\n        enableNodeReport: options.crashReportingConfig?.enableNodeReport,\n        uploadToBentley: options.crashReportingConfig?.uploadToBentley,\n      });\n\n      if (options.crashReportingConfig.enableNodeReport) {\n        if (process.report !== undefined) {\n          process.report.reportOnFatalError = true;\n          process.report.reportOnUncaughtException = true;\n          process.report.directory = options.crashReportingConfig.crashDir;\n          Logger.logTrace(loggerCategory, \"Configured Node.js crash reporting\");\n        } else {\n          Logger.logWarning(loggerCategory, \"Unable to configure Node.js crash reporting\");\n        }\n      }\n    }\n  }\n\n  /** @internal */\n  public static tileStorage?: TileStorage;\n\n  private static _hubAccess?: BackendHubAccess;\n  /** @internal */\n  public static [_setHubAccess](hubAccess: BackendHubAccess | undefined) { this._hubAccess = hubAccess; }\n\n  /** get the current hubAccess, if present.\n   * @internal\n   */\n  public static [_getHubAccess](): BackendHubAccess | undefined { return this._hubAccess; }\n\n  /** Provides access to the IModelHub for this IModelHost\n   * @internal\n   * @note If [[IModelHostOptions.hubAccess]] was undefined when initializing this class, accessing this property will throw an error.\n   * To determine whether one is present, use [[_getHubAccess]].\n   */\n  public static get [_hubAccess](): BackendHubAccess {\n    if (IModelHost._hubAccess === undefined)\n      throw new IModelError(IModelStatus.BadRequest, \"No BackendHubAccess supplied in IModelHostOptions\");\n    return IModelHost._hubAccess;\n  }\n\n  private static initializeWorkspace(configuration: IModelHostOptions) {\n    const settingAssets = join(KnownLocations.packageAssetsDir, \"Settings\");\n    this._settingsSchemas = constructSettingsSchemas();\n    this._settingsSchemas.addDirectory(join(settingAssets, \"Schemas\"));\n    this._appWorkspace = constructWorkspace(new ApplicationSettings(), configuration.workspace);\n\n    // Create the CloudCache for Workspaces. This will fail if another process is already using the same profile.\n    try {\n      this.appWorkspace.getCloudCache();\n    } catch (e: any) {\n      throw (e.errorNumber === DbResult.BE_SQLITE_BUSY) ? new IModelError(DbResult.BE_SQLITE_BUSY, `Profile [${this.profileDir}] is already in use by another process`) : e;\n    }\n\n    this.appWorkspace.settings.addDirectory(settingAssets, SettingsPriority.defaults);\n\n    GeoCoordConfig.onStartup();\n    // allow applications to load their default settings\n    this.onWorkspaceStartup.raiseEvent();\n  }\n\n  private static _isValid = false;\n\n  /** true between a successful call to [[startup]] and before [[shutdown]] */\n  public static get isValid() {\n    return IModelHost._isValid;\n  }\n\n  /** This method must be called before any iTwin.js services are used.\n   * @param options Host configuration data.\n   * Raises [[onAfterStartup]].\n   * @see [[shutdown]].\n   */\n  public static async startup(options?: IModelHostOptions): Promise<void> {\n    if (this._isValid)\n      return; // we're already initialized\n    this._isValid = true;\n\n    options = options ?? {};\n    if (this.sessionId === \"\")\n      this.sessionId = Guid.createValue();\n\n    this.authorizationClient = options.authorizationClient;\n\n    this.backendVersion = require(\"../../package.json\").version; // eslint-disable-line @typescript-eslint/no-require-imports\n    initializeRpcBackend(options.enableOpenTelemetry);\n\n    this.loadNative(options);\n    this.setupCacheDir(options);\n    this.initializeWorkspace(options);\n    EditTxn.implicitWriteEnforcement = options.implicitWriteEnforcement ?? \"allow\";\n    BriefcaseManager.initialize(join(this._cacheDir, \"imodels\"));\n\n    [\n      IModelReadRpcImpl,\n      IModelTileRpcImpl,\n      SnapshotIModelRpcImpl, // eslint-disable-line @typescript-eslint/no-deprecated\n      DevToolsRpcImpl,\n    ].forEach((rpc) => rpc.register()); // register all of the RPC implementations\n\n    [\n      BisCoreSchema,\n      GenericSchema,\n      FunctionalSchema,\n    ].forEach((schema) => schema.registerSchema()); // register all of the schemas\n\n    const { hubAccess, ...otherOptions } = options;\n    if (undefined !== hubAccess)\n      this._hubAccess = hubAccess;\n\n    this.configuration = otherOptions;\n    this.setupTileCache();\n\n    process.once(\"beforeExit\", IModelHost.shutdown);\n    this.onAfterStartup.raiseEvent();\n  }\n\n  private static setupCacheDir(configuration: IModelHostOptions) {\n    this._cacheDir = normalizeDir(configuration.cacheDir ?? NativeLibrary.defaultCacheDir);\n    IModelJsFs.recursiveMkDirSync(this._cacheDir);\n\n    this._profileName = configuration.profileName ?? \"default\";\n    Logger.logInfo(loggerCategory, `cacheDir: [${this.cacheDir}], profileDir: [${this.profileDir}]`);\n  }\n\n  /** This method must be called when an iTwin.js host is shut down. Raises [[onBeforeShutdown]] */\n  public static async shutdown(this: void): Promise<void> {\n    // Note: This method is set as a node listener where `this` is unbound. Call private method to\n    // ensure `this` is correct. Don't combine these methods.\n    return IModelHost.doShutdown();\n  }\n\n  /**\n   * Create a new iModel.\n   * @returns the Guid of the newly created iModel.\n   * @throws [IModelError]($common) in case of errors.\n   * @note If [[IModelHostOptions.hubAccess]] was undefined in the call to [[startup]], this function will throw an error.\n   */\n  public static async createNewIModel(arg: CreateNewIModelProps): Promise<GuidString> {\n    return this[_hubAccess].createNewIModel(arg);\n  }\n\n  private static async doShutdown() {\n    if (!this._isValid)\n      return;\n\n    this._isValid = false;\n    this.onBeforeShutdown.raiseEvent();\n\n    this.configuration = undefined;\n    EditTxn.implicitWriteEnforcement = \"allow\";\n    this.tileStorage = undefined;\n\n    this._appWorkspace?.close();\n    this._appWorkspace = undefined;\n    this._settingsSchemas = undefined;\n\n    CloudSqlite.CloudCaches.destroy();\n    process.removeListener(\"beforeExit\", IModelHost.shutdown);\n  }\n\n  /**\n   * Add or update a property that should be included in a crash report.\n   * @internal\n   */\n  public static setCrashReportProperty(name: string, value: string): void {\n    IModelNative.platform.setCrashReportProperty(name, value);\n  }\n\n  /**\n   * Remove a previously defined property so that will not be included in a crash report.\n   * @internal\n   */\n  public static removeCrashReportProperty(name: string): void {\n    IModelNative.platform.setCrashReportProperty(name, undefined);\n  }\n\n  /**\n   * Get all properties that will be included in a crash report.\n   * @internal\n   */\n  public static getCrashReportProperties(): CrashReportingConfigNameValuePair[] {\n    return IModelNative.platform.getCrashReportProperties();\n  }\n\n  /** The directory where application assets may be found */\n  public static get appAssetsDir(): string | undefined {\n    return undefined !== IModelHost.configuration ? IModelHost.configuration.appAssetsDir : undefined;\n  }\n\n  /** The time, in milliseconds, for which IModelTileRpcInterface.requestTileTreeProps should wait before returning a \"pending\" status.\n   * @internal\n   */\n  public static get tileTreeRequestTimeout(): number {\n    return IModelHost.configuration?.tileTreeRequestTimeout ?? IModelHostConfiguration.defaultTileRequestTimeout;\n  }\n  /** The time, in milliseconds, for which IModelTileRpcInterface.requestTileContent should wait before returning a \"pending\" status.\n   * @internal\n   */\n  public static get tileContentRequestTimeout(): number {\n    return IModelHost.configuration?.tileContentRequestTimeout ?? IModelHostConfiguration.defaultTileRequestTimeout;\n  }\n\n  /** The backend will log when a tile took longer to load than this threshold in seconds. */\n  public static get logTileLoadTimeThreshold(): number {\n    return IModelHost.configuration?.logTileLoadTimeThreshold ?? IModelHostConfiguration.defaultLogTileLoadTimeThreshold;\n  }\n  /** The backend will log when a tile is loaded with a size in bytes above this threshold. */\n  public static get logTileSizeThreshold(): number {\n    return IModelHost.configuration?.logTileSizeThreshold ?? IModelHostConfiguration.defaultLogTileSizeThreshold;\n  }\n\n  /** Whether external tile caching is active.\n   * @internal\n   */\n  public static get usingExternalTileCache(): boolean {\n    return undefined !== IModelHost.tileStorage;\n  }\n\n  /** Whether to restrict tile cache URLs by client IP address.\n   * @internal\n   */\n  public static get restrictTileUrlsByClientIp(): boolean {\n    return undefined !== IModelHost.configuration && (IModelHost.configuration.restrictTileUrlsByClientIp ? true : false);\n  }\n\n  /** Whether to compress cached tiles.\n   * @internal\n   */\n  public static get compressCachedTiles(): boolean {\n    return false !== IModelHost.configuration?.compressCachedTiles;\n  }\n\n  /**\n   * Whether to use semantic rebase or not.\n   * @internal\n   */\n  public static get useSemanticRebase(): boolean {\n    return undefined !== IModelHost.configuration && (IModelHost.configuration.useSemanticRebase ? true : false);\n  }\n\n  private static setupTileCache() {\n    assert(undefined !== IModelHost.configuration);\n    const config = IModelHost.configuration;\n    const storage = config.tileCacheStorage;\n    const credentials = config.tileCacheAzureCredentials;\n\n    if (!storage && !credentials) {\n      IModelNative.platform.setMaxTileCacheSize(config.maxTileCacheDbSize ?? IModelHostConfiguration.defaultMaxTileCacheDbSize);\n      return;\n    }\n\n    IModelNative.platform.setMaxTileCacheSize(0);\n    if (credentials) {\n      if (storage)\n        throw new IModelError(BentleyStatus.ERROR, \"Cannot use both Azure and custom cloud storage providers for tile cache.\");\n      this.setupAzureTileCache(credentials);\n    }\n    if (storage)\n      IModelHost.tileStorage = new TileStorage(storage);\n  }\n\n  private static setupAzureTileCache(credentials: AzureBlobStorageCredentials) {\n    const storageConfig: AzureServerStorageConfig = {\n      accountName: credentials.account,\n      accountKey: credentials.accessKey,\n      baseUrl: credentials.baseUrl ?? `https://${credentials.account}.blob.core.windows.net`,\n    }\n    const blobServiceClient = new BlobServiceClient(\n      storageConfig.baseUrl,\n      new StorageSharedKeyCredential(storageConfig.accountName, storageConfig.accountKey),\n    );\n    const azureStorage: ServerStorage = new AzureServerStorage(storageConfig, new BlobServiceClientWrapper(blobServiceClient))\n    IModelHost.tileStorage = new TileStorage(azureStorage);\n  }\n\n  /** @internal */\n  public static computeSchemaChecksum(arg: { schemaXmlPath: string, referencePaths: string[], exactMatch?: boolean }): string {\n    return IModelNative.platform.computeSchemaChecksum(arg);\n  }\n}\n\n/** Information about the platform on which the app is running.\n * @public\n */\nexport class Platform {\n  /** Get the name of the platform. */\n  public static get platformName(): \"win32\" | \"linux\" | \"darwin\" | \"ios\" | \"android\" | \"uwp\" {\n    return process.platform as any;\n  }\n}\n\n/** Well known directories that may be used by the application.\n * @public\n */\nexport class KnownLocations {\n\n  /** The directory where the imodeljs-native assets are stored. */\n  public static get nativeAssetsDir(): LocalDirName {\n    return IModelNative.platform.DgnDb.getAssetsDir();\n  }\n\n  /** The directory where the core-backend assets are stored. */\n  public static get packageAssetsDir(): LocalDirName {\n    return join(__dirname, \"assets\");\n  }\n\n  /** The temporary directory. */\n  public static get tmpdir(): LocalDirName {\n    return os.tmpdir();\n  }\n}\n\n/** Extend this class to provide custom file name resolution behavior.\n * @note Only `tryResolveKey` and/or `tryResolveFileName` need to be overridden as the implementations of `resolveKey` and `resolveFileName` work for most purposes.\n * @see [[IModelHost.snapshotFileNameResolver]]\n * @public\n * @deprecated in 4.10 - will not be removed until after 2026-06-13. When opening a snapshot by file name, ensure to pass already resolved path. Using a key to open a snapshot is now deprecated.\n */\nexport abstract class FileNameResolver {\n  /** Resolve a file name from the specified key.\n   * @param _fileKey The key that identifies the file name in a `Map` or other similar data structure.\n   * @returns The resolved file name or `undefined` if not found.\n   */\n  public tryResolveKey(_fileKey: string): string | undefined { return undefined; }\n  /** Resolve a file name from the specified key.\n   * @param fileKey The key that identifies the file name in a `Map` or other similar data structure.\n   * @returns The resolved file name.\n   * @throws [[IModelError]] if not found.\n   */\n  public resolveKey(fileKey: string): string {\n    const resolvedFileName: string | undefined = this.tryResolveKey(fileKey);\n    if (undefined === resolvedFileName) {\n      throw new IModelError(IModelStatus.NotFound, `${fileKey} not resolved`);\n    }\n    return resolvedFileName;\n  }\n  /** Resolve the input file name, which may be a partial name, into a full path file name.\n   * @param inFileName The partial file name.\n   * @returns The resolved full path file name or `undefined` if not found.\n   */\n  public tryResolveFileName(inFileName: string): string | undefined { return inFileName; }\n  /** Resolve the input file name, which may be a partial name, into a full path file name.\n   * @param inFileName The partial file name.\n   * @returns The resolved full path file name.\n   * @throws [[IModelError]] if not found.\n   */\n  public resolveFileName(inFileName: string): string {\n    const resolvedFileName: string | undefined = this.tryResolveFileName(inFileName);\n    if (undefined === resolvedFileName) {\n      throw new IModelError(IModelStatus.NotFound, `${inFileName} not resolved`);\n    }\n    return resolvedFileName;\n  }\n}\n"]}

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

@@ -1 +1 @@
-{"version":3,"file":"IpcHost.d.ts","sourceRoot":"","sources":["../../src/IpcHost.ts"],"names":[],"mappings":"AAIA;;GAEG;AAIH,OAAO,EAEgC,yBAAyB,EAC7B,mBAAmB,EAAmB,WAAW,EAAE,gBAAgB,EACxC,cAAc,EAAkE,gBAAgB,EAC7J,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACvE,OAAO,EAAE,WAAW,EAAwB,YAAY,EAAE,MAAM,YAAY,CAAC;AAC7E,OAAO,EAAc,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAK7D;;;IAGI;AACJ,MAAM,WAAW,WAAW;IAC1B,UAAU,CAAC,EAAE,iBAAiB,CAAC;IAC/B,OAAO,CAAC,EAAE;QACR,wGAAwG;QACxG,MAAM,CAAC,EAAE,gBAAgB,CAAC;QAE1B,iDAAiD;QACjD,UAAU,CAAC,EAAE;YACX,OAAO,CAAC,EAAE,OAAO,CAAC;SACnB,CAAC;KACH,CAAC;CACH;AAED;;;;GAIG;AACH,qBAAa,OAAO;IAClB,OAAc,OAAO,UAAS;IAC9B,OAAO,CAAC,MAAM,CAAC,IAAI,CAA+B;IAClD,2EAA2E;IAC3E,OAAO,CAAC,MAAM,KAAK,GAAG,GAA2C;IACjE,gIAAgI;IAChI,WAAkB,OAAO,IAAI,OAAO,CAAoC;IAExE;;;;OAIG;WACW,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI;IAIzD;;;;;OAKG;WACW,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,OAAO,CAAC,GAAG,CAAC,GAAG,cAAc;IAGhG;;;;;OAKG;WACW,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,GAAG,cAAc;IAGjF;;;;OAIG;WACW,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,GAAG,IAAI;IAI1E,OAAO,CAAC,MAAM,CAAC,MAAM;IAKrB,gBAAgB;WACF,iBAAiB,CAAC,CAAC,SAAS,MAAM,mBAAmB,EAAE,UAAU,EAAE,CAAC,EAAE,GAAG,IAAI,EAAE,UAAU,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC;IAI/H,gBAAgB;WACF,UAAU,CAAC,CAAC,SAAS,MAAM,gBAAgB,EAAE,SAAS,EAAE,WAAW,GAAG,YAAY,EAAE,UAAU,EAAE,CAAC,EAAE,GAAG,IAAI,EAAE,UAAU,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC;IAIzJ,gBAAgB;WACF,kBAAkB,CAAC,CAAC,SAAS,MAAM,yBAAyB,EAAE,SAAS,EAAE,WAAW,GAAG,YAAY,EAAE,UAAU,EAAE,CAAC,EAAE,GAAG,IAAI,EAAE,UAAU,CAAC,yBAAyB,CAAC,CAAC,CAAC,CAAC;IAInL;;;;OAIG;WACiB,OAAO,CAAC,GAAG,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAY7D,mEAAmE;WAC/C,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAI9C;AAED;;;;;;;;;;;GAWG;AACH,8BAAsB,UAAU;IAC9B;;;;;;OAMG;IACH,aAAoB,WAAW,IAAI,MAAM,CAAC;IAE1C;;;;;OAKG;WACW,QAAQ,IAAI,cAAc;CA0DzC;AA8ID;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,cAAc,EAAE,gBAAgB,CAAC,EAAE,MAAM,GAAG,gBAAgB,CAa9I"}
+{"version":3,"file":"IpcHost.d.ts","sourceRoot":"","sources":["../../src/IpcHost.ts"],"names":[],"mappings":"AAIA;;GAEG;AAIH,OAAO,EAEgC,yBAAyB,EAC7B,mBAAmB,EAAmB,WAAW,EAAE,gBAAgB,EACtB,cAAc,EACjD,gBAAgB,EAC5D,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACvE,OAAO,EAAE,WAAW,EAAwB,YAAY,EAAE,MAAM,YAAY,CAAC;AAC7E,OAAO,EAAc,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAK7D;;;IAGI;AACJ,MAAM,WAAW,WAAW;IAC1B,UAAU,CAAC,EAAE,iBAAiB,CAAC;IAC/B,OAAO,CAAC,EAAE;QACR,wGAAwG;QACxG,MAAM,CAAC,EAAE,gBAAgB,CAAC;QAE1B,iDAAiD;QACjD,UAAU,CAAC,EAAE;YACX,OAAO,CAAC,EAAE,OAAO,CAAC;SACnB,CAAC;KACH,CAAC;CACH;AAED;;;;GAIG;AACH,qBAAa,OAAO;IAClB,OAAc,OAAO,UAAS;IAC9B,OAAO,CAAC,MAAM,CAAC,IAAI,CAA+B;IAClD,2EAA2E;IAC3E,OAAO,CAAC,MAAM,KAAK,GAAG,GAA2C;IACjE,gIAAgI;IAChI,WAAkB,OAAO,IAAI,OAAO,CAAoC;IAExE;;;;OAIG;WACW,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI;IAIzD;;;;;OAKG;WACW,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,OAAO,CAAC,GAAG,CAAC,GAAG,cAAc;IAGhG;;;;;OAKG;WACW,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,GAAG,cAAc;IAGjF;;;;OAIG;WACW,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,GAAG,IAAI;IAI1E,OAAO,CAAC,MAAM,CAAC,MAAM;IAKrB,gBAAgB;WACF,iBAAiB,CAAC,CAAC,SAAS,MAAM,mBAAmB,EAAE,UAAU,EAAE,CAAC,EAAE,GAAG,IAAI,EAAE,UAAU,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC;IAI/H,gBAAgB;WACF,UAAU,CAAC,CAAC,SAAS,MAAM,gBAAgB,EAAE,SAAS,EAAE,WAAW,GAAG,YAAY,EAAE,UAAU,EAAE,CAAC,EAAE,GAAG,IAAI,EAAE,UAAU,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC;IAIzJ,gBAAgB;WACF,kBAAkB,CAAC,CAAC,SAAS,MAAM,yBAAyB,EAAE,SAAS,EAAE,WAAW,GAAG,YAAY,EAAE,UAAU,EAAE,CAAC,EAAE,GAAG,IAAI,EAAE,UAAU,CAAC,yBAAyB,CAAC,CAAC,CAAC,CAAC;IAInL;;;;OAIG;WACiB,OAAO,CAAC,GAAG,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAY7D,mEAAmE;WAC/C,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAI9C;AAED;;;;;;;;;;;GAWG;AACH,8BAAsB,UAAU;IAC9B;;;;;;OAMG;IACH,aAAoB,WAAW,IAAI,MAAM,CAAC;IAE1C;;;;;OAKG;WACW,QAAQ,IAAI,cAAc;CA0EzC;AA6JD;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,cAAc,EAAE,gBAAgB,CAAC,EAAE,MAAM,GAAG,gBAAgB,CAa9I"}

package/lib/cjs/IpcHost.js

@@ -140,19 +140,37 @@ class IpcHandler {
                     visited.add(e);
                     try {
                         const serialized = { ...e };
+                        for (const sym of Object.getOwnPropertySymbols(serialized))
+                            delete serialized[sym]; // symbol-keyed properties cannot be structured-cloned
                         if (e instanceof Error) {
                             serialized.message = e.message; // NB: .message and .stack are non-enumerable on Error instances
                             if (includeStack)
                                 serialized.stack = e.stack;
+                            // Error.cause is typically non-enumerable and must be copied explicitly.
+                            if (Object.prototype.hasOwnProperty.call(e, "cause"))
+                                serialized.cause = e.cause;
+                        }
+                        if (e instanceof core_bentley_1.BentleyError) {
+                            serialized.iTwinErrorId = e.iTwinErrorId;
+                            if (e.hasMetaData)
+                                serialized.loggingMetadata = e.loggingMetadata;
+                            delete serialized._metaData;
                         }
                         // Only recurse into Error instances and plain objects — not class instances like Date or Buffer.
                         const shouldRecurse = (val) => val instanceof Error || (core_bentley_1.JsonUtils.isObject(val) && Object.getPrototypeOf(val) === Object.prototype);
+                        const isSerializableLeaf = (val) => {
+                            const t = typeof val;
+                            return val === null || val === undefined || val instanceof Date
+                                || t === "string" || t === "number" || t === "boolean";
+                        };
                         for (const key of Object.keys(serialized)) {
                             const val = serialized[key];
                             if (Array.isArray(val))
-                                serialized[key] = val.map((item) => shouldRecurse(item) ? serializeError(item, includeStack, visited) : item);
+                                serialized[key] = val.map((item) => shouldRecurse(item) ? serializeError(item, includeStack, visited) : isSerializableLeaf(item) ? item : undefined);
                             else if (shouldRecurse(val))
                                 serialized[key] = serializeError(val, includeStack, visited);
+                            else if (!isSerializableLeaf(val))
+                                delete serialized[key]; // strip non-cloneable values (functions, class instances, etc.)
                         }
                         return serialized;
                     }
@@ -161,14 +179,7 @@ class IpcHandler {
                         visited.delete(e);
                     }
                 };
-                const ret = { error: serializeError(err, !IpcHost.noStack) };
-                if (err instanceof core_bentley_1.BentleyError) {
-                    ret.error.iTwinErrorId = err.iTwinErrorId;
-                    if (err.hasMetaData)
-                        ret.error.loggingMetadata = err.loggingMetadata;
-                    delete ret.error._metaData;
-                }
-                return ret;
+                return { error: serializeError(err, !IpcHost.noStack) };
             }
         });
     }
@@ -225,10 +236,10 @@ class IpcAppHandler extends IpcHandler {
         IModelDb_1.IModelDb.findByKey(key).close();
     }
     async saveChanges(key, description) {
-        IModelDb_1.IModelDb.findByKey(key).saveChanges(description);
+        IModelDb_1.IModelDb.findByKey(key)[Symbols_1._implicitTxn].saveChanges(description);
     }
     async abandonChanges(key) {
-        IModelDb_1.IModelDb.findByKey(key).abandonChanges();
+        IModelDb_1.IModelDb.findByKey(key)[Symbols_1._implicitTxn].abandonChanges();
     }
     async hasPendingTxns(key) {
         return IModelDb_1.IModelDb.findByKey(key)[Symbols_1._nativeDb].hasPendingTxns();
@@ -287,16 +298,25 @@ class IpcAppHandler extends IpcHandler {
         return IModelDb_1.IModelDb.findByKey(key)[Symbols_1._nativeDb].isGeometricModelTrackingSupported();
     }
     async reverseTxns(key, numOperations) {
-        return IModelDb_1.IModelDb.findByKey(key)[Symbols_1._nativeDb].reverseTxns(numOperations);
+        return IModelDb_1.BriefcaseDb.findByKey(key).txns.reverseTxns(numOperations);
+    }
+    async reverseTxnsAsync(key, numOperations, args) {
+        return IModelDb_1.BriefcaseDb.findByKey(key).txns.reverseTxnsAsync(numOperations, args);
     }
     async reverseAllTxn(key) {
-        return IModelDb_1.IModelDb.findByKey(key)[Symbols_1._nativeDb].reverseAll();
+        return IModelDb_1.BriefcaseDb.findByKey(key).txns.reverseAll();
+    }
+    async reverseAllTxnsAsync(key, args) {
+        return IModelDb_1.BriefcaseDb.findByKey(key).txns.reverseAllTxnsAsync(args);
     }
     async reinstateTxn(key) {
-        return IModelDb_1.IModelDb.findByKey(key)[Symbols_1._nativeDb].reinstateTxn();
+        return IModelDb_1.BriefcaseDb.findByKey(key).txns.reinstateTxn();
+    }
+    async reinstateTxnAsync(key, args) {
+        return IModelDb_1.BriefcaseDb.findByKey(key).txns.reinstateTxnAsync(args);
     }
     async restartTxnSession(key) {
-        return IModelDb_1.IModelDb.findByKey(key)[Symbols_1._nativeDb].restartTxnSession();
+        return IModelDb_1.IModelDb.findByKey(key).restartTxnSession();
     }
     async queryConcurrency(pool) {
         return NativePlatform_1.IModelNative.platform.queryConcurrency(pool);