@itwin/core-backend 3.6.0-dev.36 → 3.6.0-dev.40

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (243) hide show
  1. package/lib/cjs/AliCloudStorageService.d.ts +23 -23
  2. package/lib/cjs/AliCloudStorageService.js +71 -71
  3. package/lib/cjs/AliCloudStorageService.js.map +1 -1
  4. package/lib/cjs/BackendHubAccess.d.ts +224 -224
  5. package/lib/cjs/BackendHubAccess.js +41 -41
  6. package/lib/cjs/BackendHubAccess.js.map +1 -1
  7. package/lib/cjs/BackendLoggerCategory.d.ts +91 -91
  8. package/lib/cjs/BackendLoggerCategory.js +99 -99
  9. package/lib/cjs/BackendLoggerCategory.js.map +1 -1
  10. package/lib/cjs/BisCoreSchema.d.ts +21 -21
  11. package/lib/cjs/BisCoreSchema.js +60 -60
  12. package/lib/cjs/BisCoreSchema.js.map +1 -1
  13. package/lib/cjs/BriefcaseManager.d.ts +170 -170
  14. package/lib/cjs/BriefcaseManager.js +413 -413
  15. package/lib/cjs/BriefcaseManager.js.map +1 -1
  16. package/lib/cjs/Category.d.ts +153 -153
  17. package/lib/cjs/Category.js +243 -243
  18. package/lib/cjs/Category.js.map +1 -1
  19. package/lib/cjs/ChangeSummaryManager.d.ts +187 -187
  20. package/lib/cjs/ChangeSummaryManager.js +447 -447
  21. package/lib/cjs/ChangeSummaryManager.js.map +1 -1
  22. package/lib/cjs/ChangedElementsDb.d.ts +99 -99
  23. package/lib/cjs/ChangedElementsDb.js +165 -165
  24. package/lib/cjs/ChangedElementsDb.js.map +1 -1
  25. package/lib/cjs/ChangedElementsManager.d.ts +39 -39
  26. package/lib/cjs/ChangedElementsManager.js +88 -88
  27. package/lib/cjs/ChangedElementsManager.js.map +1 -1
  28. package/lib/cjs/CheckpointManager.d.ts +122 -122
  29. package/lib/cjs/CheckpointManager.js +343 -343
  30. package/lib/cjs/CheckpointManager.js.map +1 -1
  31. package/lib/cjs/ClassRegistry.d.ts +79 -79
  32. package/lib/cjs/ClassRegistry.js +249 -249
  33. package/lib/cjs/ClassRegistry.js.map +1 -1
  34. package/lib/cjs/CloudSqlite.d.ts +350 -350
  35. package/lib/cjs/CloudSqlite.js +153 -153
  36. package/lib/cjs/CloudSqlite.js.map +1 -1
  37. package/lib/cjs/CloudStorageBackend.d.ts +58 -58
  38. package/lib/cjs/CloudStorageBackend.js +173 -173
  39. package/lib/cjs/CloudStorageBackend.js.map +1 -1
  40. package/lib/cjs/CodeService.d.ts +396 -396
  41. package/lib/cjs/CodeService.js +63 -63
  42. package/lib/cjs/CodeService.js.map +1 -1
  43. package/lib/cjs/CodeSpecs.d.ts +50 -50
  44. package/lib/cjs/CodeSpecs.js +112 -112
  45. package/lib/cjs/CodeSpecs.js.map +1 -1
  46. package/lib/cjs/ConcurrentQuery.d.ts +13 -13
  47. package/lib/cjs/ConcurrentQuery.js +36 -36
  48. package/lib/cjs/ConcurrentQuery.js.map +1 -1
  49. package/lib/cjs/CustomViewState3dCreator.d.ts +21 -21
  50. package/lib/cjs/CustomViewState3dCreator.js +81 -81
  51. package/lib/cjs/CustomViewState3dCreator.js.map +1 -1
  52. package/lib/cjs/DevTools.d.ts +71 -71
  53. package/lib/cjs/DevTools.js +154 -154
  54. package/lib/cjs/DevTools.js.map +1 -1
  55. package/lib/cjs/DisplayStyle.d.ts +106 -106
  56. package/lib/cjs/DisplayStyle.js +256 -256
  57. package/lib/cjs/DisplayStyle.js.map +1 -1
  58. package/lib/cjs/ECDb.d.ts +191 -191
  59. package/lib/cjs/ECDb.js +350 -350
  60. package/lib/cjs/ECDb.js.map +1 -1
  61. package/lib/cjs/ECSchemaXmlContext.d.ts +18 -18
  62. package/lib/cjs/ECSchemaXmlContext.js +41 -41
  63. package/lib/cjs/ECSchemaXmlContext.js.map +1 -1
  64. package/lib/cjs/ECSqlStatement.d.ts +473 -473
  65. package/lib/cjs/ECSqlStatement.js +791 -791
  66. package/lib/cjs/ECSqlStatement.js.map +1 -1
  67. package/lib/cjs/Element.d.ts +1102 -1102
  68. package/lib/cjs/Element.js +1416 -1416
  69. package/lib/cjs/Element.js.map +1 -1
  70. package/lib/cjs/ElementAspect.d.ts +176 -176
  71. package/lib/cjs/ElementAspect.js +211 -211
  72. package/lib/cjs/ElementAspect.js.map +1 -1
  73. package/lib/cjs/ElementGraphics.d.ts +9 -9
  74. package/lib/cjs/ElementGraphics.js +41 -41
  75. package/lib/cjs/ElementGraphics.js.map +1 -1
  76. package/lib/cjs/ElementTreeWalker.d.ts +162 -162
  77. package/lib/cjs/ElementTreeWalker.js +409 -409
  78. package/lib/cjs/ElementTreeWalker.js.map +1 -1
  79. package/lib/cjs/Entity.d.ts +106 -106
  80. package/lib/cjs/Entity.js +134 -134
  81. package/lib/cjs/Entity.js.map +1 -1
  82. package/lib/cjs/EntityReferences.d.ts +49 -49
  83. package/lib/cjs/EntityReferences.js +95 -95
  84. package/lib/cjs/EntityReferences.js.map +1 -1
  85. package/lib/cjs/ExportGraphics.d.ts +317 -317
  86. package/lib/cjs/ExportGraphics.js +208 -208
  87. package/lib/cjs/ExportGraphics.js.map +1 -1
  88. package/lib/cjs/ExternalSource.d.ts +96 -96
  89. package/lib/cjs/ExternalSource.js +131 -131
  90. package/lib/cjs/ExternalSource.js.map +1 -1
  91. package/lib/cjs/GeoCoordConfig.d.ts +19 -19
  92. package/lib/cjs/GeoCoordConfig.js +85 -85
  93. package/lib/cjs/GeoCoordConfig.js.map +1 -1
  94. package/lib/cjs/GeometrySummary.d.ts +4 -4
  95. package/lib/cjs/GeometrySummary.js +380 -380
  96. package/lib/cjs/GeometrySummary.js.map +1 -1
  97. package/lib/cjs/HubMock.d.ts +94 -94
  98. package/lib/cjs/HubMock.js +222 -222
  99. package/lib/cjs/HubMock.js.map +1 -1
  100. package/lib/cjs/IModelCloneContext.d.ts +8 -8
  101. package/lib/cjs/IModelCloneContext.js +15 -15
  102. package/lib/cjs/IModelCloneContext.js.map +1 -1
  103. package/lib/cjs/IModelDb.d.ts +1183 -1183
  104. package/lib/cjs/IModelDb.js +2374 -2374
  105. package/lib/cjs/IModelDb.js.map +1 -1
  106. package/lib/cjs/IModelElementCloneContext.d.ts +89 -89
  107. package/lib/cjs/IModelElementCloneContext.js +159 -159
  108. package/lib/cjs/IModelElementCloneContext.js.map +1 -1
  109. package/lib/cjs/IModelHost.d.ts +370 -370
  110. package/lib/cjs/IModelHost.js +496 -496
  111. package/lib/cjs/IModelHost.js.map +1 -1
  112. package/lib/cjs/IModelJsFs.d.ts +62 -62
  113. package/lib/cjs/IModelJsFs.js +140 -140
  114. package/lib/cjs/IModelJsFs.js.map +1 -1
  115. package/lib/cjs/IpcHost.d.ts +104 -104
  116. package/lib/cjs/IpcHost.js +278 -278
  117. package/lib/cjs/IpcHost.js.map +1 -1
  118. package/lib/cjs/LineStyle.d.ts +311 -311
  119. package/lib/cjs/LineStyle.js +295 -295
  120. package/lib/cjs/LineStyle.js.map +1 -1
  121. package/lib/cjs/LocalHub.d.ts +162 -162
  122. package/lib/cjs/LocalHub.js +587 -587
  123. package/lib/cjs/LocalHub.js.map +1 -1
  124. package/lib/cjs/LocalhostIpcHost.d.ts +20 -20
  125. package/lib/cjs/LocalhostIpcHost.js +81 -81
  126. package/lib/cjs/LocalhostIpcHost.js.map +1 -1
  127. package/lib/cjs/Material.d.ts +103 -103
  128. package/lib/cjs/Material.js +147 -147
  129. package/lib/cjs/Material.js.map +1 -1
  130. package/lib/cjs/Model.d.ts +392 -392
  131. package/lib/cjs/Model.js +485 -485
  132. package/lib/cjs/Model.js.map +1 -1
  133. package/lib/cjs/NativeAppStorage.d.ts +51 -51
  134. package/lib/cjs/NativeAppStorage.js +202 -202
  135. package/lib/cjs/NativeAppStorage.js.map +1 -1
  136. package/lib/cjs/NativeHost.d.ts +52 -52
  137. package/lib/cjs/NativeHost.js +163 -163
  138. package/lib/cjs/NativeHost.js.map +1 -1
  139. package/lib/cjs/NavigationRelationship.d.ts +156 -156
  140. package/lib/cjs/NavigationRelationship.js +225 -225
  141. package/lib/cjs/NavigationRelationship.js.map +1 -1
  142. package/lib/cjs/PromiseMemoizer.d.ts +51 -51
  143. package/lib/cjs/PromiseMemoizer.js +101 -101
  144. package/lib/cjs/PromiseMemoizer.js.map +1 -1
  145. package/lib/cjs/PropertyStore.d.ts +132 -132
  146. package/lib/cjs/PropertyStore.js +11 -11
  147. package/lib/cjs/PropertyStore.js.map +1 -1
  148. package/lib/cjs/Relationship.d.ts +416 -416
  149. package/lib/cjs/Relationship.js +494 -494
  150. package/lib/cjs/Relationship.js.map +1 -1
  151. package/lib/cjs/RpcBackend.d.ts +5 -5
  152. package/lib/cjs/RpcBackend.js +31 -31
  153. package/lib/cjs/RpcBackend.js.map +1 -1
  154. package/lib/cjs/SQLiteDb.d.ts +219 -219
  155. package/lib/cjs/SQLiteDb.js +214 -214
  156. package/lib/cjs/SQLiteDb.js.map +1 -1
  157. package/lib/cjs/Schema.d.ts +55 -55
  158. package/lib/cjs/Schema.js +83 -83
  159. package/lib/cjs/Schema.js.map +1 -1
  160. package/lib/cjs/ServerBasedLocks.d.ts +57 -57
  161. package/lib/cjs/ServerBasedLocks.js +168 -168
  162. package/lib/cjs/ServerBasedLocks.js.map +1 -1
  163. package/lib/cjs/SqliteStatement.d.ts +360 -360
  164. package/lib/cjs/SqliteStatement.js +586 -586
  165. package/lib/cjs/SqliteStatement.js.map +1 -1
  166. package/lib/cjs/Texture.d.ts +58 -58
  167. package/lib/cjs/Texture.js +82 -82
  168. package/lib/cjs/Texture.js.map +1 -1
  169. package/lib/cjs/TileStorage.d.ts +18 -18
  170. package/lib/cjs/TileStorage.js +90 -90
  171. package/lib/cjs/TileStorage.js.map +1 -1
  172. package/lib/cjs/TxnManager.d.ts +202 -202
  173. package/lib/cjs/TxnManager.js +356 -356
  174. package/lib/cjs/TxnManager.js.map +1 -1
  175. package/lib/cjs/ViewDefinition.d.ts +439 -439
  176. package/lib/cjs/ViewDefinition.js +646 -646
  177. package/lib/cjs/ViewDefinition.js.map +1 -1
  178. package/lib/cjs/ViewStateHydrator.d.ts +13 -13
  179. package/lib/cjs/ViewStateHydrator.js +103 -103
  180. package/lib/cjs/ViewStateHydrator.js.map +1 -1
  181. package/lib/cjs/assets/IModelChange.02.00.00.ecschema.xml +90 -90
  182. package/lib/cjs/assets/Settings/Schemas/Cloud.Schema.json +67 -67
  183. package/lib/cjs/assets/Settings/Schemas/Gcs.schema.json +31 -31
  184. package/lib/cjs/assets/Settings/Schemas/Workspace.Schema.json +52 -52
  185. package/lib/cjs/assets/Settings/backend.setting.json5 +138 -138
  186. package/lib/cjs/core-backend.d.ts +184 -184
  187. package/lib/cjs/core-backend.js +204 -204
  188. package/lib/cjs/core-backend.js.map +1 -1
  189. package/lib/cjs/domains/FunctionalElements.d.ts +101 -101
  190. package/lib/cjs/domains/FunctionalElements.js +145 -145
  191. package/lib/cjs/domains/FunctionalElements.js.map +1 -1
  192. package/lib/cjs/domains/FunctionalSchema.d.ts +13 -13
  193. package/lib/cjs/domains/FunctionalSchema.js +40 -40
  194. package/lib/cjs/domains/FunctionalSchema.js.map +1 -1
  195. package/lib/cjs/domains/GenericElements.d.ts +177 -177
  196. package/lib/cjs/domains/GenericElements.js +263 -263
  197. package/lib/cjs/domains/GenericElements.js.map +1 -1
  198. package/lib/cjs/domains/GenericSchema.d.ts +10 -10
  199. package/lib/cjs/domains/GenericSchema.js +28 -28
  200. package/lib/cjs/domains/GenericSchema.js.map +1 -1
  201. package/lib/cjs/rpc/multipart.d.ts +11 -11
  202. package/lib/cjs/rpc/multipart.js +70 -70
  203. package/lib/cjs/rpc/multipart.js.map +1 -1
  204. package/lib/cjs/rpc/tracing.d.ts +28 -28
  205. package/lib/cjs/rpc/tracing.js +73 -73
  206. package/lib/cjs/rpc/tracing.js.map +1 -1
  207. package/lib/cjs/rpc/web/logging.d.ts +9 -9
  208. package/lib/cjs/rpc/web/logging.js +42 -42
  209. package/lib/cjs/rpc/web/logging.js.map +1 -1
  210. package/lib/cjs/rpc/web/request.d.ts +6 -6
  211. package/lib/cjs/rpc/web/request.js +73 -73
  212. package/lib/cjs/rpc/web/request.js.map +1 -1
  213. package/lib/cjs/rpc/web/response.d.ts +6 -6
  214. package/lib/cjs/rpc/web/response.js +105 -105
  215. package/lib/cjs/rpc/web/response.js.map +1 -1
  216. package/lib/cjs/rpc-impl/DevToolsRpcImpl.d.ts +15 -15
  217. package/lib/cjs/rpc-impl/DevToolsRpcImpl.js +32 -32
  218. package/lib/cjs/rpc-impl/DevToolsRpcImpl.js.map +1 -1
  219. package/lib/cjs/rpc-impl/IModelReadRpcImpl.d.ts +47 -47
  220. package/lib/cjs/rpc-impl/IModelReadRpcImpl.js +291 -291
  221. package/lib/cjs/rpc-impl/IModelReadRpcImpl.js.map +1 -1
  222. package/lib/cjs/rpc-impl/IModelTileRpcImpl.d.ts +22 -22
  223. package/lib/cjs/rpc-impl/IModelTileRpcImpl.js +202 -202
  224. package/lib/cjs/rpc-impl/IModelTileRpcImpl.js.map +1 -1
  225. package/lib/cjs/rpc-impl/RpcBriefcaseUtility.d.ts +36 -36
  226. package/lib/cjs/rpc-impl/RpcBriefcaseUtility.js +168 -168
  227. package/lib/cjs/rpc-impl/RpcBriefcaseUtility.js.map +1 -1
  228. package/lib/cjs/rpc-impl/SnapshotIModelRpcImpl.d.ts +16 -16
  229. package/lib/cjs/rpc-impl/SnapshotIModelRpcImpl.js +43 -43
  230. package/lib/cjs/rpc-impl/SnapshotIModelRpcImpl.js.map +1 -1
  231. package/lib/cjs/rpc-impl/WipRpcImpl.d.ts +15 -15
  232. package/lib/cjs/rpc-impl/WipRpcImpl.js +37 -37
  233. package/lib/cjs/rpc-impl/WipRpcImpl.js.map +1 -1
  234. package/lib/cjs/workspace/Settings.d.ts +186 -186
  235. package/lib/cjs/workspace/Settings.js +155 -155
  236. package/lib/cjs/workspace/Settings.js.map +1 -1
  237. package/lib/cjs/workspace/SettingsSchemas.d.ts +75 -75
  238. package/lib/cjs/workspace/SettingsSchemas.js +191 -191
  239. package/lib/cjs/workspace/SettingsSchemas.js.map +1 -1
  240. package/lib/cjs/workspace/Workspace.d.ts +414 -414
  241. package/lib/cjs/workspace/Workspace.js +543 -543
  242. package/lib/cjs/workspace/Workspace.js.map +1 -1
  243. package/package.json +12 -12
@@ -1,497 +1,497 @@
1
- "use strict";
2
- /*---------------------------------------------------------------------------------------------
3
- * Copyright (c) Bentley Systems, Incorporated. All rights reserved.
4
- * See LICENSE.md in the project root for license terms and full copyright notice.
5
- *--------------------------------------------------------------------------------------------*/
6
- /** @packageDocumentation
7
- * @module IModelHost
8
- */
9
- Object.defineProperty(exports, "__esModule", { value: true });
10
- exports.FileNameResolver = exports.KnownLocations = exports.Platform = exports.IModelHost = exports.IModelHostConfiguration = void 0;
11
- const imodeljs_native_1 = require("@bentley/imodeljs-native");
12
- const object_storage_azure_1 = require("@itwin/object-storage-azure");
13
- const cloud_agnostic_core_1 = require("@itwin/cloud-agnostic-core");
14
- const object_storage_core_1 = require("@itwin/object-storage-core");
15
- const core_bentley_1 = require("@itwin/core-bentley");
16
- const core_common_1 = require("@itwin/core-common");
17
- const core_telemetry_1 = require("@itwin/core-telemetry");
18
- const inversify_1 = require("inversify");
19
- const os = require("os");
20
- const path = require("path");
21
- const BackendLoggerCategory_1 = require("./BackendLoggerCategory");
22
- const BisCoreSchema_1 = require("./BisCoreSchema");
23
- const BriefcaseManager_1 = require("./BriefcaseManager");
24
- const CloudStorageBackend_1 = require("./CloudStorageBackend");
25
- const FunctionalSchema_1 = require("./domains/FunctionalSchema");
26
- const GenericSchema_1 = require("./domains/GenericSchema");
27
- const GeoCoordConfig_1 = require("./GeoCoordConfig");
28
- const IModelJsFs_1 = require("./IModelJsFs");
29
- const DevToolsRpcImpl_1 = require("./rpc-impl/DevToolsRpcImpl");
30
- const IModelReadRpcImpl_1 = require("./rpc-impl/IModelReadRpcImpl");
31
- const IModelTileRpcImpl_1 = require("./rpc-impl/IModelTileRpcImpl");
32
- const SnapshotIModelRpcImpl_1 = require("./rpc-impl/SnapshotIModelRpcImpl");
33
- const WipRpcImpl_1 = require("./rpc-impl/WipRpcImpl");
34
- const RpcBackend_1 = require("./RpcBackend");
35
- const TileStorage_1 = require("./TileStorage");
36
- const Settings_1 = require("./workspace/Settings");
37
- const SettingsSchemas_1 = require("./workspace/SettingsSchemas");
38
- const Workspace_1 = require("./workspace/Workspace");
39
- const loggerCategory = BackendLoggerCategory_1.BackendLoggerCategory.IModelHost;
40
- /** Configuration of core-backend.
41
- * @public
42
- */
43
- class IModelHostConfiguration {
44
- constructor() {
45
- /** @internal */
46
- this.tileTreeRequestTimeout = IModelHostConfiguration.defaultTileRequestTimeout;
47
- /** @internal */
48
- this.tileContentRequestTimeout = IModelHostConfiguration.defaultTileRequestTimeout;
49
- /** @internal */
50
- this.logTileLoadTimeThreshold = IModelHostConfiguration.defaultLogTileLoadTimeThreshold;
51
- /** @internal */
52
- this.logTileSizeThreshold = IModelHostConfiguration.defaultLogTileSizeThreshold;
53
- }
54
- }
55
- exports.IModelHostConfiguration = IModelHostConfiguration;
56
- IModelHostConfiguration.defaultTileRequestTimeout = 20 * 1000;
57
- IModelHostConfiguration.defaultLogTileLoadTimeThreshold = 40;
58
- IModelHostConfiguration.defaultLogTileSizeThreshold = 20 * 1000000;
59
- /** @internal */
60
- IModelHostConfiguration.defaultMaxTileCacheDbSize = 1024 * 1024 * 1024;
61
- /**
62
- * Settings for `IModelHost.appWorkspace`.
63
- * @note this includes the default dictionary from the SettingsSpecRegistry
64
- */
65
- class ApplicationSettings extends Settings_1.BaseSettings {
66
- constructor() {
67
- super();
68
- this._remove = SettingsSchemas_1.SettingsSchemas.onSchemaChanged.addListener(() => this.updateDefaults());
69
- this.updateDefaults();
70
- }
71
- verifyPriority(priority) {
72
- if (priority >= Settings_1.SettingsPriority.iModel) // iModel settings may not appear in ApplicationSettings
73
- throw new Error("Use IModelSettings");
74
- }
75
- updateDefaults() {
76
- const defaults = {};
77
- for (const [schemaName, val] of SettingsSchemas_1.SettingsSchemas.allSchemas) {
78
- if (val.default)
79
- defaults[schemaName] = val.default;
80
- }
81
- this.addDictionary("_default_", 0, defaults);
82
- }
83
- close() {
84
- if (this._remove) {
85
- this._remove();
86
- this._remove = undefined;
87
- }
88
- }
89
- }
90
- /** IModelHost initializes ($backend) and captures its configuration. A backend must call [[IModelHost.startup]] before using any backend classes.
91
- * See [the learning article]($docs/learning/backend/IModelHost.md)
92
- * @public
93
- */
94
- class IModelHost {
95
- constructor() { }
96
- /** @internal */
97
- static get platform() {
98
- if (this._platform === undefined)
99
- throw new Error("IModelHost.startup must be called first");
100
- return this._platform;
101
- }
102
- /** A uniqueId for this session */
103
- static get sessionId() { return this.session.sessionId; }
104
- static set sessionId(id) { this.session.sessionId = id; }
105
- /** The Id of this application - needs to be set only if it is an agent application. The applicationId will otherwise originate at the frontend. */
106
- static get applicationId() { return this.session.applicationId; }
107
- static set applicationId(id) { this.session.applicationId = id; }
108
- /** The version of this application - needs to be set if is an agent application. The applicationVersion will otherwise originate at the frontend. */
109
- static get applicationVersion() { return this.session.applicationVersion; }
110
- static set applicationVersion(version) { this.session.applicationVersion = version; }
111
- /** Root directory holding files that iTwin.js caches */
112
- static get cacheDir() { return this._cacheDir; }
113
- /** The application [[Workspace]] for this `IModelHost`
114
- * @note this `Workspace` only holds [[WorkspaceContainer]]s and [[Settings]] scoped to the currently loaded application(s).
115
- * All organization, iTwin, and iModel based containers or settings must be accessed through [[IModelDb.workspace]] and
116
- * attempting to add them to this Workspace will fail.
117
- * @beta
118
- */
119
- static get appWorkspace() { return this._appWorkspace; } // eslint-disable-line @typescript-eslint/no-non-null-assertion
120
- /** Get the current access token for this IModelHost, or a blank string if none is available.
121
- * @note for web backends, this will *always* return a blank string because the backend itself has no token (but never needs one either.)
122
- * For all IpcHosts, where this backend is servicing a single frontend, this will be the user's token. For ElectronHost, the backend
123
- * obtains the token and forwards it to the frontend.
124
- * @note accessTokens expire periodically and are automatically refreshed, if possible. Therefore tokens should not be saved, and the value
125
- * returned by this method may change over time throughout the course of a session.
126
- */
127
- static async getAccessToken() {
128
- var _a, _b;
129
- try {
130
- return (_b = (await ((_a = this.authorizationClient) === null || _a === void 0 ? void 0 : _a.getAccessToken()))) !== null && _b !== void 0 ? _b : "";
131
- }
132
- catch (e) {
133
- return "";
134
- }
135
- }
136
- /** @internal */
137
- static flushLog() {
138
- return this.platform.flushLog();
139
- }
140
- /** @internal */
141
- static loadNative() {
142
- const platform = Platform.load();
143
- this.registerPlatform(platform);
144
- }
145
- static syncNativeLogLevels() {
146
- this.platform.clearLogLevelCache();
147
- }
148
- static registerPlatform(platform) {
149
- this._platform = platform;
150
- if (undefined === platform)
151
- return;
152
- platform.logger = core_bentley_1.Logger;
153
- core_bentley_1.Logger.logLevelChangedFn = () => IModelHost.syncNativeLogLevels();
154
- }
155
- /** @internal */
156
- static setHubAccess(hubAccess) { this._hubAccess = hubAccess; }
157
- /** get the current hubAccess, if present.
158
- * @beta
159
- */
160
- static getHubAccess() { return this._hubAccess; }
161
- /** Provides access to the IModelHub for this IModelHost
162
- * @beta
163
- * @note If [[IModelHostOptions.hubAccess]] was undefined when initializing this class, accessing this property will throw an error.
164
- * To determine whether one is present, use [[getHubAccess]].
165
- */
166
- static get hubAccess() {
167
- if (this._hubAccess === undefined)
168
- throw new core_common_1.IModelError(core_bentley_1.IModelStatus.BadRequest, "No BackendHubAccess supplied in IModelHostOptions");
169
- return this._hubAccess;
170
- }
171
- static initializeWorkspace(configuration) {
172
- const settingAssets = path.join(KnownLocations.packageAssetsDir, "Settings");
173
- SettingsSchemas_1.SettingsSchemas.addDirectory(path.join(settingAssets, "Schemas"));
174
- this._appWorkspace = new Workspace_1.ITwinWorkspace(new ApplicationSettings(), configuration.workspace);
175
- this.appWorkspace.settings.addDirectory(settingAssets, Settings_1.SettingsPriority.defaults);
176
- GeoCoordConfig_1.GeoCoordConfig.onStartup();
177
- // allow applications to load their default settings
178
- this.onWorkspaceStartup.raiseEvent();
179
- }
180
- /** Returns true if IModelHost is started. */
181
- static get isValid() { return this._isValid; }
182
- /** This method must be called before any iTwin.js services are used.
183
- * @param options Host configuration data.
184
- * Raises [[onAfterStartup]].
185
- * @see [[shutdown]].
186
- */
187
- static async startup(options) {
188
- var _a, _b, _c, _d;
189
- if (this._isValid)
190
- return; // we're already initialized
191
- this._isValid = true;
192
- options = options !== null && options !== void 0 ? options : {};
193
- if (IModelHost.sessionId === "")
194
- IModelHost.sessionId = core_bentley_1.Guid.createValue();
195
- this.authorizationClient = options.authorizationClient;
196
- this.logStartup();
197
- this.backendVersion = require("../../package.json").version; // eslint-disable-line @typescript-eslint/no-var-requires
198
- (0, RpcBackend_1.initializeRpcBackend)(options.enableOpenTelemetry);
199
- if (this._platform === undefined) {
200
- try {
201
- this.loadNative();
202
- }
203
- catch (error) {
204
- core_bentley_1.Logger.logError(loggerCategory, "Error registering/loading the native platform API", () => (options));
205
- throw error;
206
- }
207
- }
208
- if (options.crashReportingConfig && options.crashReportingConfig.crashDir && !core_bentley_1.ProcessDetector.isElectronAppBackend && !core_bentley_1.ProcessDetector.isMobileAppBackend) {
209
- this.platform.setCrashReporting(options.crashReportingConfig);
210
- core_bentley_1.Logger.logTrace(loggerCategory, "Configured crash reporting", {
211
- enableCrashDumps: (_a = options.crashReportingConfig) === null || _a === void 0 ? void 0 : _a.enableCrashDumps,
212
- wantFullMemoryDumps: (_b = options.crashReportingConfig) === null || _b === void 0 ? void 0 : _b.wantFullMemoryDumps,
213
- enableNodeReport: (_c = options.crashReportingConfig) === null || _c === void 0 ? void 0 : _c.enableNodeReport,
214
- uploadToBentley: (_d = options.crashReportingConfig) === null || _d === void 0 ? void 0 : _d.uploadToBentley,
215
- });
216
- if (options.crashReportingConfig.enableNodeReport) {
217
- if (process.report !== undefined) {
218
- process.report.reportOnFatalError = true;
219
- process.report.reportOnUncaughtException = true;
220
- process.report.directory = options.crashReportingConfig.crashDir;
221
- core_bentley_1.Logger.logTrace(loggerCategory, "Configured Node.js crash reporting");
222
- }
223
- else {
224
- core_bentley_1.Logger.logWarning(loggerCategory, "Unable to configure Node.js crash reporting");
225
- }
226
- }
227
- }
228
- this.setupHostDirs(options);
229
- this.initializeWorkspace(options);
230
- BriefcaseManager_1.BriefcaseManager.initialize(this._briefcaseCacheDir);
231
- [
232
- IModelReadRpcImpl_1.IModelReadRpcImpl,
233
- IModelTileRpcImpl_1.IModelTileRpcImpl,
234
- SnapshotIModelRpcImpl_1.SnapshotIModelRpcImpl,
235
- WipRpcImpl_1.WipRpcImpl,
236
- DevToolsRpcImpl_1.DevToolsRpcImpl,
237
- ].forEach((rpc) => rpc.register()); // register all of the RPC implementations
238
- [
239
- BisCoreSchema_1.BisCoreSchema,
240
- GenericSchema_1.GenericSchema,
241
- FunctionalSchema_1.FunctionalSchema,
242
- ].forEach((schema) => schema.registerSchema()); // register all of the schemas
243
- if (undefined !== options.hubAccess)
244
- this._hubAccess = options.hubAccess;
245
- this.configuration = options;
246
- this.setupTileCache();
247
- process.once("beforeExit", IModelHost.shutdown);
248
- this.onAfterStartup.raiseEvent();
249
- }
250
- static logStartup() {
251
- if (!core_bentley_1.Logger.isEnabled(loggerCategory, core_bentley_1.LogLevel.Trace))
252
- return;
253
- // Extract the iModel details from environment - note this is very specific to Bentley hosted backends, but is quite useful for tracing
254
- let startupInfo = {};
255
- const serviceName = process.env.FABRIC_SERVICE_NAME;
256
- if (serviceName) {
257
- // e.g., fabric:/iModelWebViewer3.0/iModelJSGuest/1/08daaeb3-b56f-480b-9051-7efc834d18ae/512d971d-b641-4735-bb1c-c07ab3e44ce7/c1315fcce125ca40b2d405bb7809214daf8b4c85
258
- const serviceNameComponents = serviceName.split("/");
259
- if (serviceNameComponents.length === 7) {
260
- startupInfo = {
261
- ...startupInfo,
262
- iTwinId: serviceNameComponents[4],
263
- iModelId: serviceNameComponents[5],
264
- changesetId: serviceNameComponents[6],
265
- };
266
- }
267
- }
268
- core_bentley_1.Logger.logTrace(loggerCategory, "IModelHost.startup", () => startupInfo);
269
- }
270
- static setupHostDirs(configuration) {
271
- var _a;
272
- const setupDir = (dir) => {
273
- dir = path.normalize(dir);
274
- IModelJsFs_1.IModelJsFs.recursiveMkDirSync(dir);
275
- return dir;
276
- };
277
- this._cacheDir = setupDir((_a = configuration.cacheDir) !== null && _a !== void 0 ? _a : imodeljs_native_1.NativeLibrary.defaultCacheDir);
278
- this._briefcaseCacheDir = path.join(this._cacheDir, "imodels");
279
- }
280
- /** This method must be called when an iTwin.js host is shut down. Raises [[onBeforeShutdown]] */
281
- static async shutdown() {
282
- var _a;
283
- // NB: This method is set as a node listener where `this` is unbound
284
- if (!IModelHost._isValid)
285
- return;
286
- IModelHost._isValid = false;
287
- IModelHost.onBeforeShutdown.raiseEvent();
288
- IModelHost.configuration = undefined;
289
- // eslint-disable-next-line deprecation/deprecation
290
- IModelHost.tileCacheService = undefined;
291
- // eslint-disable-next-line deprecation/deprecation
292
- IModelHost.tileUploader = undefined;
293
- IModelHost.tileStorage = undefined;
294
- (_a = IModelHost._appWorkspace) === null || _a === void 0 ? void 0 : _a.close();
295
- IModelHost._appWorkspace = undefined;
296
- Workspace_1.ITwinWorkspace.finalize();
297
- process.removeListener("beforeExit", IModelHost.shutdown);
298
- }
299
- /**
300
- * Add or update a property that should be included in a crash report.
301
- * @param name The name of the property
302
- * @param value The value of the property
303
- * @alpha
304
- */
305
- static setCrashReportProperty(name, value) {
306
- (0, core_bentley_1.assert)(undefined !== this._platform);
307
- this._platform.setCrashReportProperty(name, value);
308
- }
309
- /**
310
- * Remove a previously defined property so that will not be included in a crash report.
311
- * @param name The name of the property
312
- * @alpha
313
- */
314
- static removeCrashReportProperty(name) {
315
- (0, core_bentley_1.assert)(undefined !== this._platform);
316
- this._platform.setCrashReportProperty(name, undefined);
317
- }
318
- /**
319
- * Get all properties that will be included in a crash report.
320
- * @alpha
321
- */
322
- static getCrashReportProperties() {
323
- (0, core_bentley_1.assert)(undefined !== this._platform);
324
- return this._platform.getCrashReportProperties();
325
- }
326
- /** The directory where application assets may be found */
327
- static get appAssetsDir() { return undefined !== IModelHost.configuration ? IModelHost.configuration.appAssetsDir : undefined; }
328
- /** The time, in milliseconds, for which IModelTileRpcInterface.requestTileTreeProps should wait before returning a "pending" status.
329
- * @internal
330
- */
331
- static get tileTreeRequestTimeout() {
332
- var _a, _b;
333
- return (_b = (_a = IModelHost.configuration) === null || _a === void 0 ? void 0 : _a.tileTreeRequestTimeout) !== null && _b !== void 0 ? _b : IModelHostConfiguration.defaultTileRequestTimeout;
334
- }
335
- /** The time, in milliseconds, for which IModelTileRpcInterface.requestTileContent should wait before returning a "pending" status.
336
- * @internal
337
- */
338
- static get tileContentRequestTimeout() {
339
- var _a, _b;
340
- return (_b = (_a = IModelHost.configuration) === null || _a === void 0 ? void 0 : _a.tileContentRequestTimeout) !== null && _b !== void 0 ? _b : IModelHostConfiguration.defaultTileRequestTimeout;
341
- }
342
- /** The backend will log when a tile took longer to load than this threshold in seconds. */
343
- static get logTileLoadTimeThreshold() { var _a, _b; return (_b = (_a = IModelHost.configuration) === null || _a === void 0 ? void 0 : _a.logTileLoadTimeThreshold) !== null && _b !== void 0 ? _b : IModelHostConfiguration.defaultLogTileLoadTimeThreshold; }
344
- /** The backend will log when a tile is loaded with a size in bytes above this threshold. */
345
- static get logTileSizeThreshold() { var _a, _b; return (_b = (_a = IModelHost.configuration) === null || _a === void 0 ? void 0 : _a.logTileSizeThreshold) !== null && _b !== void 0 ? _b : IModelHostConfiguration.defaultLogTileSizeThreshold; }
346
- /** Whether external tile caching is active.
347
- * @internal
348
- */
349
- static get usingExternalTileCache() {
350
- return undefined !== IModelHost.tileStorage;
351
- }
352
- /** Whether to restrict tile cache URLs by client IP address.
353
- * @internal
354
- */
355
- static get restrictTileUrlsByClientIp() { return undefined !== IModelHost.configuration && (IModelHost.configuration.restrictTileUrlsByClientIp ? true : false); }
356
- /** Whether to compress cached tiles.
357
- * @internal
358
- */
359
- static get compressCachedTiles() { var _a; return false !== ((_a = IModelHost.configuration) === null || _a === void 0 ? void 0 : _a.compressCachedTiles); }
360
- static setupTileCache() {
361
- var _a;
362
- (0, core_bentley_1.assert)(undefined !== IModelHost.configuration);
363
- const config = IModelHost.configuration;
364
- // eslint-disable-next-line deprecation/deprecation
365
- const service = config.tileCacheService;
366
- const storage = config.tileCacheStorage;
367
- const credentials = config.tileCacheAzureCredentials;
368
- if (!service && !storage && !credentials) {
369
- this.platform.setMaxTileCacheSize((_a = config.maxTileCacheDbSize) !== null && _a !== void 0 ? _a : IModelHostConfiguration.defaultMaxTileCacheDbSize);
370
- return;
371
- }
372
- this.platform.setMaxTileCacheSize(0);
373
- // eslint-disable-next-line deprecation/deprecation
374
- IModelHost.tileUploader = new CloudStorageBackend_1.CloudStorageTileUploader();
375
- if (credentials) {
376
- if (storage || service)
377
- throw new core_common_1.IModelError(core_common_1.BentleyStatus.ERROR, "Cannot use both Azure and custom cloud storage providers for tile cache.");
378
- this.setupAzureTileCache(credentials);
379
- }
380
- if (service) {
381
- if (!storage)
382
- core_bentley_1.Logger.logWarning(loggerCategory, "Using tileCacheService without tileCacheStorage is unsupported");
383
- IModelHost.tileCacheService = service; // eslint-disable-line deprecation/deprecation
384
- }
385
- if (storage)
386
- IModelHost.tileStorage = new TileStorage_1.TileStorage(storage);
387
- }
388
- static setupAzureTileCache(credentials) {
389
- var _a;
390
- const config = {
391
- // eslint-disable-next-line @typescript-eslint/naming-convention
392
- ServerSideStorage: {
393
- dependencyName: "azure",
394
- accountName: credentials.account,
395
- accountKey: credentials.accessKey,
396
- baseUrl: (_a = credentials.baseUrl) !== null && _a !== void 0 ? _a : `https://${credentials.account}.blob.core.windows.net`,
397
- },
398
- };
399
- const ioc = new inversify_1.Container();
400
- ioc.bind(cloud_agnostic_core_1.Types.dependenciesConfig).toConstantValue(config);
401
- new object_storage_azure_1.AzureServerStorageBindings().register(ioc, config.ServerSideStorage);
402
- IModelHost.tileStorage = new TileStorage_1.TileStorage(ioc.get(object_storage_core_1.ServerStorage));
403
- // eslint-disable-next-line deprecation/deprecation
404
- IModelHost.tileCacheService = new CloudStorageBackend_1.AzureBlobStorage(credentials); // needed for backwards compatibility with old frontends
405
- }
406
- /** @internal */
407
- static computeSchemaChecksum(arg) {
408
- return this.platform.computeSchemaChecksum(arg);
409
- }
410
- }
411
- exports.IModelHost = IModelHost;
412
- /** @alpha */
413
- IModelHost.telemetry = new core_telemetry_1.TelemetryManager();
414
- IModelHost.backendVersion = "";
415
- IModelHost._cacheDir = "";
416
- /** Event raised during startup to allow loading settings data */
417
- IModelHost.onWorkspaceStartup = new core_bentley_1.BeEvent();
418
- /** Event raised just after the backend IModelHost was started */
419
- IModelHost.onAfterStartup = new core_bentley_1.BeEvent();
420
- /** Event raised just before the backend IModelHost is to be shut down */
421
- IModelHost.onBeforeShutdown = new core_bentley_1.BeEvent();
422
- /** @internal */
423
- IModelHost.session = { applicationId: "2686", applicationVersion: "1.0.0", sessionId: "" };
424
- IModelHost._isValid = false;
425
- /** Information about the platform on which the app is running. Also see [[KnownLocations]] and [[IModelJsFs]].
426
- * @public
427
- */
428
- class Platform {
429
- /** Get the name of the platform. */
430
- static get platformName() {
431
- return process.platform;
432
- }
433
- /** @internal */
434
- static load() {
435
- return core_bentley_1.ProcessDetector.isMobileAppBackend ? process._linkedBinding("iModelJsNative") : imodeljs_native_1.NativeLibrary.load();
436
- }
437
- }
438
- exports.Platform = Platform;
439
- /** Well known directories that may be used by the application. Also see [[Platform]]
440
- * @public
441
- */
442
- class KnownLocations {
443
- /** The directory where the imodeljs-native assets are stored. */
444
- static get nativeAssetsDir() { return IModelHost.platform.DgnDb.getAssetsDir(); }
445
- /** The directory where the core-backend assets are stored. */
446
- static get packageAssetsDir() {
447
- return path.join(__dirname, "assets");
448
- }
449
- /** The temporary directory. */
450
- static get tmpdir() {
451
- return os.tmpdir();
452
- }
453
- }
454
- exports.KnownLocations = KnownLocations;
455
- /** Extend this class to provide custom file name resolution behavior.
456
- * @note Only `tryResolveKey` and/or `tryResolveFileName` need to be overridden as the implementations of `resolveKey` and `resolveFileName` work for most purposes.
457
- * @see [[IModelHost.snapshotFileNameResolver]]
458
- * @public
459
- */
460
- class FileNameResolver {
461
- /** Resolve a file name from the specified key.
462
- * @param _fileKey The key that identifies the file name in a `Map` or other similar data structure.
463
- * @returns The resolved file name or `undefined` if not found.
464
- */
465
- tryResolveKey(_fileKey) { return undefined; }
466
- /** Resolve a file name from the specified key.
467
- * @param fileKey The key that identifies the file name in a `Map` or other similar data structure.
468
- * @returns The resolved file name.
469
- * @throws [[IModelError]] if not found.
470
- */
471
- resolveKey(fileKey) {
472
- const resolvedFileName = this.tryResolveKey(fileKey);
473
- if (undefined === resolvedFileName) {
474
- throw new core_common_1.IModelError(core_bentley_1.IModelStatus.NotFound, `${fileKey} not resolved`);
475
- }
476
- return resolvedFileName;
477
- }
478
- /** Resolve the input file name, which may be a partial name, into a full path file name.
479
- * @param inFileName The partial file name.
480
- * @returns The resolved full path file name or `undefined` if not found.
481
- */
482
- tryResolveFileName(inFileName) { return inFileName; }
483
- /** Resolve the input file name, which may be a partial name, into a full path file name.
484
- * @param inFileName The partial file name.
485
- * @returns The resolved full path file name.
486
- * @throws [[IModelError]] if not found.
487
- */
488
- resolveFileName(inFileName) {
489
- const resolvedFileName = this.tryResolveFileName(inFileName);
490
- if (undefined === resolvedFileName) {
491
- throw new core_common_1.IModelError(core_bentley_1.IModelStatus.NotFound, `${inFileName} not resolved`);
492
- }
493
- return resolvedFileName;
494
- }
495
- }
496
- exports.FileNameResolver = FileNameResolver;
1
+ "use strict";
2
+ /*---------------------------------------------------------------------------------------------
3
+ * Copyright (c) Bentley Systems, Incorporated. All rights reserved.
4
+ * See LICENSE.md in the project root for license terms and full copyright notice.
5
+ *--------------------------------------------------------------------------------------------*/
6
+ /** @packageDocumentation
7
+ * @module IModelHost
8
+ */
9
+ Object.defineProperty(exports, "__esModule", { value: true });
10
+ exports.FileNameResolver = exports.KnownLocations = exports.Platform = exports.IModelHost = exports.IModelHostConfiguration = void 0;
11
+ const imodeljs_native_1 = require("@bentley/imodeljs-native");
12
+ const object_storage_azure_1 = require("@itwin/object-storage-azure");
13
+ const cloud_agnostic_core_1 = require("@itwin/cloud-agnostic-core");
14
+ const object_storage_core_1 = require("@itwin/object-storage-core");
15
+ const core_bentley_1 = require("@itwin/core-bentley");
16
+ const core_common_1 = require("@itwin/core-common");
17
+ const core_telemetry_1 = require("@itwin/core-telemetry");
18
+ const inversify_1 = require("inversify");
19
+ const os = require("os");
20
+ const path = require("path");
21
+ const BackendLoggerCategory_1 = require("./BackendLoggerCategory");
22
+ const BisCoreSchema_1 = require("./BisCoreSchema");
23
+ const BriefcaseManager_1 = require("./BriefcaseManager");
24
+ const CloudStorageBackend_1 = require("./CloudStorageBackend");
25
+ const FunctionalSchema_1 = require("./domains/FunctionalSchema");
26
+ const GenericSchema_1 = require("./domains/GenericSchema");
27
+ const GeoCoordConfig_1 = require("./GeoCoordConfig");
28
+ const IModelJsFs_1 = require("./IModelJsFs");
29
+ const DevToolsRpcImpl_1 = require("./rpc-impl/DevToolsRpcImpl");
30
+ const IModelReadRpcImpl_1 = require("./rpc-impl/IModelReadRpcImpl");
31
+ const IModelTileRpcImpl_1 = require("./rpc-impl/IModelTileRpcImpl");
32
+ const SnapshotIModelRpcImpl_1 = require("./rpc-impl/SnapshotIModelRpcImpl");
33
+ const WipRpcImpl_1 = require("./rpc-impl/WipRpcImpl");
34
+ const RpcBackend_1 = require("./RpcBackend");
35
+ const TileStorage_1 = require("./TileStorage");
36
+ const Settings_1 = require("./workspace/Settings");
37
+ const SettingsSchemas_1 = require("./workspace/SettingsSchemas");
38
+ const Workspace_1 = require("./workspace/Workspace");
39
+ const loggerCategory = BackendLoggerCategory_1.BackendLoggerCategory.IModelHost;
40
+ /** Configuration of core-backend.
41
+ * @public
42
+ */
43
+ class IModelHostConfiguration {
44
+ constructor() {
45
+ /** @internal */
46
+ this.tileTreeRequestTimeout = IModelHostConfiguration.defaultTileRequestTimeout;
47
+ /** @internal */
48
+ this.tileContentRequestTimeout = IModelHostConfiguration.defaultTileRequestTimeout;
49
+ /** @internal */
50
+ this.logTileLoadTimeThreshold = IModelHostConfiguration.defaultLogTileLoadTimeThreshold;
51
+ /** @internal */
52
+ this.logTileSizeThreshold = IModelHostConfiguration.defaultLogTileSizeThreshold;
53
+ }
54
+ }
55
+ exports.IModelHostConfiguration = IModelHostConfiguration;
56
+ IModelHostConfiguration.defaultTileRequestTimeout = 20 * 1000;
57
+ IModelHostConfiguration.defaultLogTileLoadTimeThreshold = 40;
58
+ IModelHostConfiguration.defaultLogTileSizeThreshold = 20 * 1000000;
59
+ /** @internal */
60
+ IModelHostConfiguration.defaultMaxTileCacheDbSize = 1024 * 1024 * 1024;
61
+ /**
62
+ * Settings for `IModelHost.appWorkspace`.
63
+ * @note this includes the default dictionary from the SettingsSpecRegistry
64
+ */
65
+ class ApplicationSettings extends Settings_1.BaseSettings {
66
+ constructor() {
67
+ super();
68
+ this._remove = SettingsSchemas_1.SettingsSchemas.onSchemaChanged.addListener(() => this.updateDefaults());
69
+ this.updateDefaults();
70
+ }
71
+ verifyPriority(priority) {
72
+ if (priority >= Settings_1.SettingsPriority.iModel) // iModel settings may not appear in ApplicationSettings
73
+ throw new Error("Use IModelSettings");
74
+ }
75
+ updateDefaults() {
76
+ const defaults = {};
77
+ for (const [schemaName, val] of SettingsSchemas_1.SettingsSchemas.allSchemas) {
78
+ if (val.default)
79
+ defaults[schemaName] = val.default;
80
+ }
81
+ this.addDictionary("_default_", 0, defaults);
82
+ }
83
+ close() {
84
+ if (this._remove) {
85
+ this._remove();
86
+ this._remove = undefined;
87
+ }
88
+ }
89
+ }
90
+ /** IModelHost initializes ($backend) and captures its configuration. A backend must call [[IModelHost.startup]] before using any backend classes.
91
+ * See [the learning article]($docs/learning/backend/IModelHost.md)
92
+ * @public
93
+ */
94
+ class IModelHost {
95
+ constructor() { }
96
+ /** @internal */
97
+ static get platform() {
98
+ if (this._platform === undefined)
99
+ throw new Error("IModelHost.startup must be called first");
100
+ return this._platform;
101
+ }
102
+ /** A uniqueId for this session */
103
+ static get sessionId() { return this.session.sessionId; }
104
+ static set sessionId(id) { this.session.sessionId = id; }
105
+ /** The Id of this application - needs to be set only if it is an agent application. The applicationId will otherwise originate at the frontend. */
106
+ static get applicationId() { return this.session.applicationId; }
107
+ static set applicationId(id) { this.session.applicationId = id; }
108
+ /** The version of this application - needs to be set if is an agent application. The applicationVersion will otherwise originate at the frontend. */
109
+ static get applicationVersion() { return this.session.applicationVersion; }
110
+ static set applicationVersion(version) { this.session.applicationVersion = version; }
111
+ /** Root directory holding files that iTwin.js caches */
112
+ static get cacheDir() { return this._cacheDir; }
113
+ /** The application [[Workspace]] for this `IModelHost`
114
+ * @note this `Workspace` only holds [[WorkspaceContainer]]s and [[Settings]] scoped to the currently loaded application(s).
115
+ * All organization, iTwin, and iModel based containers or settings must be accessed through [[IModelDb.workspace]] and
116
+ * attempting to add them to this Workspace will fail.
117
+ * @beta
118
+ */
119
+ static get appWorkspace() { return this._appWorkspace; } // eslint-disable-line @typescript-eslint/no-non-null-assertion
120
+ /** Get the current access token for this IModelHost, or a blank string if none is available.
121
+ * @note for web backends, this will *always* return a blank string because the backend itself has no token (but never needs one either.)
122
+ * For all IpcHosts, where this backend is servicing a single frontend, this will be the user's token. For ElectronHost, the backend
123
+ * obtains the token and forwards it to the frontend.
124
+ * @note accessTokens expire periodically and are automatically refreshed, if possible. Therefore tokens should not be saved, and the value
125
+ * returned by this method may change over time throughout the course of a session.
126
+ */
127
+ static async getAccessToken() {
128
+ var _a, _b;
129
+ try {
130
+ return (_b = (await ((_a = this.authorizationClient) === null || _a === void 0 ? void 0 : _a.getAccessToken()))) !== null && _b !== void 0 ? _b : "";
131
+ }
132
+ catch (e) {
133
+ return "";
134
+ }
135
+ }
136
+ /** @internal */
137
+ static flushLog() {
138
+ return this.platform.flushLog();
139
+ }
140
+ /** @internal */
141
+ static loadNative() {
142
+ const platform = Platform.load();
143
+ this.registerPlatform(platform);
144
+ }
145
+ static syncNativeLogLevels() {
146
+ this.platform.clearLogLevelCache();
147
+ }
148
+ static registerPlatform(platform) {
149
+ this._platform = platform;
150
+ if (undefined === platform)
151
+ return;
152
+ platform.logger = core_bentley_1.Logger;
153
+ core_bentley_1.Logger.logLevelChangedFn = () => IModelHost.syncNativeLogLevels();
154
+ }
155
+ /** @internal */
156
+ static setHubAccess(hubAccess) { this._hubAccess = hubAccess; }
157
+ /** get the current hubAccess, if present.
158
+ * @beta
159
+ */
160
+ static getHubAccess() { return this._hubAccess; }
161
+ /** Provides access to the IModelHub for this IModelHost
162
+ * @beta
163
+ * @note If [[IModelHostOptions.hubAccess]] was undefined when initializing this class, accessing this property will throw an error.
164
+ * To determine whether one is present, use [[getHubAccess]].
165
+ */
166
+ static get hubAccess() {
167
+ if (this._hubAccess === undefined)
168
+ throw new core_common_1.IModelError(core_bentley_1.IModelStatus.BadRequest, "No BackendHubAccess supplied in IModelHostOptions");
169
+ return this._hubAccess;
170
+ }
171
+ static initializeWorkspace(configuration) {
172
+ const settingAssets = path.join(KnownLocations.packageAssetsDir, "Settings");
173
+ SettingsSchemas_1.SettingsSchemas.addDirectory(path.join(settingAssets, "Schemas"));
174
+ this._appWorkspace = new Workspace_1.ITwinWorkspace(new ApplicationSettings(), configuration.workspace);
175
+ this.appWorkspace.settings.addDirectory(settingAssets, Settings_1.SettingsPriority.defaults);
176
+ GeoCoordConfig_1.GeoCoordConfig.onStartup();
177
+ // allow applications to load their default settings
178
+ this.onWorkspaceStartup.raiseEvent();
179
+ }
180
+ /** Returns true if IModelHost is started. */
181
+ static get isValid() { return this._isValid; }
182
+ /** This method must be called before any iTwin.js services are used.
183
+ * @param options Host configuration data.
184
+ * Raises [[onAfterStartup]].
185
+ * @see [[shutdown]].
186
+ */
187
+ static async startup(options) {
188
+ var _a, _b, _c, _d;
189
+ if (this._isValid)
190
+ return; // we're already initialized
191
+ this._isValid = true;
192
+ options = options !== null && options !== void 0 ? options : {};
193
+ if (IModelHost.sessionId === "")
194
+ IModelHost.sessionId = core_bentley_1.Guid.createValue();
195
+ this.authorizationClient = options.authorizationClient;
196
+ this.logStartup();
197
+ this.backendVersion = require("../../package.json").version; // eslint-disable-line @typescript-eslint/no-var-requires
198
+ (0, RpcBackend_1.initializeRpcBackend)(options.enableOpenTelemetry);
199
+ if (this._platform === undefined) {
200
+ try {
201
+ this.loadNative();
202
+ }
203
+ catch (error) {
204
+ core_bentley_1.Logger.logError(loggerCategory, "Error registering/loading the native platform API", () => (options));
205
+ throw error;
206
+ }
207
+ }
208
+ if (options.crashReportingConfig && options.crashReportingConfig.crashDir && !core_bentley_1.ProcessDetector.isElectronAppBackend && !core_bentley_1.ProcessDetector.isMobileAppBackend) {
209
+ this.platform.setCrashReporting(options.crashReportingConfig);
210
+ core_bentley_1.Logger.logTrace(loggerCategory, "Configured crash reporting", {
211
+ enableCrashDumps: (_a = options.crashReportingConfig) === null || _a === void 0 ? void 0 : _a.enableCrashDumps,
212
+ wantFullMemoryDumps: (_b = options.crashReportingConfig) === null || _b === void 0 ? void 0 : _b.wantFullMemoryDumps,
213
+ enableNodeReport: (_c = options.crashReportingConfig) === null || _c === void 0 ? void 0 : _c.enableNodeReport,
214
+ uploadToBentley: (_d = options.crashReportingConfig) === null || _d === void 0 ? void 0 : _d.uploadToBentley,
215
+ });
216
+ if (options.crashReportingConfig.enableNodeReport) {
217
+ if (process.report !== undefined) {
218
+ process.report.reportOnFatalError = true;
219
+ process.report.reportOnUncaughtException = true;
220
+ process.report.directory = options.crashReportingConfig.crashDir;
221
+ core_bentley_1.Logger.logTrace(loggerCategory, "Configured Node.js crash reporting");
222
+ }
223
+ else {
224
+ core_bentley_1.Logger.logWarning(loggerCategory, "Unable to configure Node.js crash reporting");
225
+ }
226
+ }
227
+ }
228
+ this.setupHostDirs(options);
229
+ this.initializeWorkspace(options);
230
+ BriefcaseManager_1.BriefcaseManager.initialize(this._briefcaseCacheDir);
231
+ [
232
+ IModelReadRpcImpl_1.IModelReadRpcImpl,
233
+ IModelTileRpcImpl_1.IModelTileRpcImpl,
234
+ SnapshotIModelRpcImpl_1.SnapshotIModelRpcImpl,
235
+ WipRpcImpl_1.WipRpcImpl,
236
+ DevToolsRpcImpl_1.DevToolsRpcImpl,
237
+ ].forEach((rpc) => rpc.register()); // register all of the RPC implementations
238
+ [
239
+ BisCoreSchema_1.BisCoreSchema,
240
+ GenericSchema_1.GenericSchema,
241
+ FunctionalSchema_1.FunctionalSchema,
242
+ ].forEach((schema) => schema.registerSchema()); // register all of the schemas
243
+ if (undefined !== options.hubAccess)
244
+ this._hubAccess = options.hubAccess;
245
+ this.configuration = options;
246
+ this.setupTileCache();
247
+ process.once("beforeExit", IModelHost.shutdown);
248
+ this.onAfterStartup.raiseEvent();
249
+ }
250
+ static logStartup() {
251
+ if (!core_bentley_1.Logger.isEnabled(loggerCategory, core_bentley_1.LogLevel.Trace))
252
+ return;
253
+ // Extract the iModel details from environment - note this is very specific to Bentley hosted backends, but is quite useful for tracing
254
+ let startupInfo = {};
255
+ const serviceName = process.env.FABRIC_SERVICE_NAME;
256
+ if (serviceName) {
257
+ // e.g., fabric:/iModelWebViewer3.0/iModelJSGuest/1/08daaeb3-b56f-480b-9051-7efc834d18ae/512d971d-b641-4735-bb1c-c07ab3e44ce7/c1315fcce125ca40b2d405bb7809214daf8b4c85
258
+ const serviceNameComponents = serviceName.split("/");
259
+ if (serviceNameComponents.length === 7) {
260
+ startupInfo = {
261
+ ...startupInfo,
262
+ iTwinId: serviceNameComponents[4],
263
+ iModelId: serviceNameComponents[5],
264
+ changesetId: serviceNameComponents[6],
265
+ };
266
+ }
267
+ }
268
+ core_bentley_1.Logger.logTrace(loggerCategory, "IModelHost.startup", () => startupInfo);
269
+ }
270
+ static setupHostDirs(configuration) {
271
+ var _a;
272
+ const setupDir = (dir) => {
273
+ dir = path.normalize(dir);
274
+ IModelJsFs_1.IModelJsFs.recursiveMkDirSync(dir);
275
+ return dir;
276
+ };
277
+ this._cacheDir = setupDir((_a = configuration.cacheDir) !== null && _a !== void 0 ? _a : imodeljs_native_1.NativeLibrary.defaultCacheDir);
278
+ this._briefcaseCacheDir = path.join(this._cacheDir, "imodels");
279
+ }
280
+ /** This method must be called when an iTwin.js host is shut down. Raises [[onBeforeShutdown]] */
281
+ static async shutdown() {
282
+ var _a;
283
+ // NB: This method is set as a node listener where `this` is unbound
284
+ if (!IModelHost._isValid)
285
+ return;
286
+ IModelHost._isValid = false;
287
+ IModelHost.onBeforeShutdown.raiseEvent();
288
+ IModelHost.configuration = undefined;
289
+ // eslint-disable-next-line deprecation/deprecation
290
+ IModelHost.tileCacheService = undefined;
291
+ // eslint-disable-next-line deprecation/deprecation
292
+ IModelHost.tileUploader = undefined;
293
+ IModelHost.tileStorage = undefined;
294
+ (_a = IModelHost._appWorkspace) === null || _a === void 0 ? void 0 : _a.close();
295
+ IModelHost._appWorkspace = undefined;
296
+ Workspace_1.ITwinWorkspace.finalize();
297
+ process.removeListener("beforeExit", IModelHost.shutdown);
298
+ }
299
+ /**
300
+ * Add or update a property that should be included in a crash report.
301
+ * @param name The name of the property
302
+ * @param value The value of the property
303
+ * @alpha
304
+ */
305
+ static setCrashReportProperty(name, value) {
306
+ (0, core_bentley_1.assert)(undefined !== this._platform);
307
+ this._platform.setCrashReportProperty(name, value);
308
+ }
309
+ /**
310
+ * Remove a previously defined property so that will not be included in a crash report.
311
+ * @param name The name of the property
312
+ * @alpha
313
+ */
314
+ static removeCrashReportProperty(name) {
315
+ (0, core_bentley_1.assert)(undefined !== this._platform);
316
+ this._platform.setCrashReportProperty(name, undefined);
317
+ }
318
+ /**
319
+ * Get all properties that will be included in a crash report.
320
+ * @alpha
321
+ */
322
+ static getCrashReportProperties() {
323
+ (0, core_bentley_1.assert)(undefined !== this._platform);
324
+ return this._platform.getCrashReportProperties();
325
+ }
326
+ /** The directory where application assets may be found */
327
+ static get appAssetsDir() { return undefined !== IModelHost.configuration ? IModelHost.configuration.appAssetsDir : undefined; }
328
+ /** The time, in milliseconds, for which IModelTileRpcInterface.requestTileTreeProps should wait before returning a "pending" status.
329
+ * @internal
330
+ */
331
+ static get tileTreeRequestTimeout() {
332
+ var _a, _b;
333
+ return (_b = (_a = IModelHost.configuration) === null || _a === void 0 ? void 0 : _a.tileTreeRequestTimeout) !== null && _b !== void 0 ? _b : IModelHostConfiguration.defaultTileRequestTimeout;
334
+ }
335
+ /** The time, in milliseconds, for which IModelTileRpcInterface.requestTileContent should wait before returning a "pending" status.
336
+ * @internal
337
+ */
338
+ static get tileContentRequestTimeout() {
339
+ var _a, _b;
340
+ return (_b = (_a = IModelHost.configuration) === null || _a === void 0 ? void 0 : _a.tileContentRequestTimeout) !== null && _b !== void 0 ? _b : IModelHostConfiguration.defaultTileRequestTimeout;
341
+ }
342
+ /** The backend will log when a tile took longer to load than this threshold in seconds. */
343
+ static get logTileLoadTimeThreshold() { var _a, _b; return (_b = (_a = IModelHost.configuration) === null || _a === void 0 ? void 0 : _a.logTileLoadTimeThreshold) !== null && _b !== void 0 ? _b : IModelHostConfiguration.defaultLogTileLoadTimeThreshold; }
344
+ /** The backend will log when a tile is loaded with a size in bytes above this threshold. */
345
+ static get logTileSizeThreshold() { var _a, _b; return (_b = (_a = IModelHost.configuration) === null || _a === void 0 ? void 0 : _a.logTileSizeThreshold) !== null && _b !== void 0 ? _b : IModelHostConfiguration.defaultLogTileSizeThreshold; }
346
+ /** Whether external tile caching is active.
347
+ * @internal
348
+ */
349
+ static get usingExternalTileCache() {
350
+ return undefined !== IModelHost.tileStorage;
351
+ }
352
+ /** Whether to restrict tile cache URLs by client IP address.
353
+ * @internal
354
+ */
355
+ static get restrictTileUrlsByClientIp() { return undefined !== IModelHost.configuration && (IModelHost.configuration.restrictTileUrlsByClientIp ? true : false); }
356
+ /** Whether to compress cached tiles.
357
+ * @internal
358
+ */
359
+ static get compressCachedTiles() { var _a; return false !== ((_a = IModelHost.configuration) === null || _a === void 0 ? void 0 : _a.compressCachedTiles); }
360
+ static setupTileCache() {
361
+ var _a;
362
+ (0, core_bentley_1.assert)(undefined !== IModelHost.configuration);
363
+ const config = IModelHost.configuration;
364
+ // eslint-disable-next-line deprecation/deprecation
365
+ const service = config.tileCacheService;
366
+ const storage = config.tileCacheStorage;
367
+ const credentials = config.tileCacheAzureCredentials;
368
+ if (!service && !storage && !credentials) {
369
+ this.platform.setMaxTileCacheSize((_a = config.maxTileCacheDbSize) !== null && _a !== void 0 ? _a : IModelHostConfiguration.defaultMaxTileCacheDbSize);
370
+ return;
371
+ }
372
+ this.platform.setMaxTileCacheSize(0);
373
+ // eslint-disable-next-line deprecation/deprecation
374
+ IModelHost.tileUploader = new CloudStorageBackend_1.CloudStorageTileUploader();
375
+ if (credentials) {
376
+ if (storage || service)
377
+ throw new core_common_1.IModelError(core_common_1.BentleyStatus.ERROR, "Cannot use both Azure and custom cloud storage providers for tile cache.");
378
+ this.setupAzureTileCache(credentials);
379
+ }
380
+ if (service) {
381
+ if (!storage)
382
+ core_bentley_1.Logger.logWarning(loggerCategory, "Using tileCacheService without tileCacheStorage is unsupported");
383
+ IModelHost.tileCacheService = service; // eslint-disable-line deprecation/deprecation
384
+ }
385
+ if (storage)
386
+ IModelHost.tileStorage = new TileStorage_1.TileStorage(storage);
387
+ }
388
+ static setupAzureTileCache(credentials) {
389
+ var _a;
390
+ const config = {
391
+ // eslint-disable-next-line @typescript-eslint/naming-convention
392
+ ServerSideStorage: {
393
+ dependencyName: "azure",
394
+ accountName: credentials.account,
395
+ accountKey: credentials.accessKey,
396
+ baseUrl: (_a = credentials.baseUrl) !== null && _a !== void 0 ? _a : `https://${credentials.account}.blob.core.windows.net`,
397
+ },
398
+ };
399
+ const ioc = new inversify_1.Container();
400
+ ioc.bind(cloud_agnostic_core_1.Types.dependenciesConfig).toConstantValue(config);
401
+ new object_storage_azure_1.AzureServerStorageBindings().register(ioc, config.ServerSideStorage);
402
+ IModelHost.tileStorage = new TileStorage_1.TileStorage(ioc.get(object_storage_core_1.ServerStorage));
403
+ // eslint-disable-next-line deprecation/deprecation
404
+ IModelHost.tileCacheService = new CloudStorageBackend_1.AzureBlobStorage(credentials); // needed for backwards compatibility with old frontends
405
+ }
406
+ /** @internal */
407
+ static computeSchemaChecksum(arg) {
408
+ return this.platform.computeSchemaChecksum(arg);
409
+ }
410
+ }
411
+ exports.IModelHost = IModelHost;
412
+ /** @alpha */
413
+ IModelHost.telemetry = new core_telemetry_1.TelemetryManager();
414
+ IModelHost.backendVersion = "";
415
+ IModelHost._cacheDir = "";
416
+ /** Event raised during startup to allow loading settings data */
417
+ IModelHost.onWorkspaceStartup = new core_bentley_1.BeEvent();
418
+ /** Event raised just after the backend IModelHost was started */
419
+ IModelHost.onAfterStartup = new core_bentley_1.BeEvent();
420
+ /** Event raised just before the backend IModelHost is to be shut down */
421
+ IModelHost.onBeforeShutdown = new core_bentley_1.BeEvent();
422
+ /** @internal */
423
+ IModelHost.session = { applicationId: "2686", applicationVersion: "1.0.0", sessionId: "" };
424
+ IModelHost._isValid = false;
425
+ /** Information about the platform on which the app is running. Also see [[KnownLocations]] and [[IModelJsFs]].
426
+ * @public
427
+ */
428
+ class Platform {
429
+ /** Get the name of the platform. */
430
+ static get platformName() {
431
+ return process.platform;
432
+ }
433
+ /** @internal */
434
+ static load() {
435
+ return core_bentley_1.ProcessDetector.isMobileAppBackend ? process._linkedBinding("iModelJsNative") : imodeljs_native_1.NativeLibrary.load();
436
+ }
437
+ }
438
+ exports.Platform = Platform;
439
+ /** Well known directories that may be used by the application. Also see [[Platform]]
440
+ * @public
441
+ */
442
+ class KnownLocations {
443
+ /** The directory where the imodeljs-native assets are stored. */
444
+ static get nativeAssetsDir() { return IModelHost.platform.DgnDb.getAssetsDir(); }
445
+ /** The directory where the core-backend assets are stored. */
446
+ static get packageAssetsDir() {
447
+ return path.join(__dirname, "assets");
448
+ }
449
+ /** The temporary directory. */
450
+ static get tmpdir() {
451
+ return os.tmpdir();
452
+ }
453
+ }
454
+ exports.KnownLocations = KnownLocations;
455
+ /** Extend this class to provide custom file name resolution behavior.
456
+ * @note Only `tryResolveKey` and/or `tryResolveFileName` need to be overridden as the implementations of `resolveKey` and `resolveFileName` work for most purposes.
457
+ * @see [[IModelHost.snapshotFileNameResolver]]
458
+ * @public
459
+ */
460
+ class FileNameResolver {
461
+ /** Resolve a file name from the specified key.
462
+ * @param _fileKey The key that identifies the file name in a `Map` or other similar data structure.
463
+ * @returns The resolved file name or `undefined` if not found.
464
+ */
465
+ tryResolveKey(_fileKey) { return undefined; }
466
+ /** Resolve a file name from the specified key.
467
+ * @param fileKey The key that identifies the file name in a `Map` or other similar data structure.
468
+ * @returns The resolved file name.
469
+ * @throws [[IModelError]] if not found.
470
+ */
471
+ resolveKey(fileKey) {
472
+ const resolvedFileName = this.tryResolveKey(fileKey);
473
+ if (undefined === resolvedFileName) {
474
+ throw new core_common_1.IModelError(core_bentley_1.IModelStatus.NotFound, `${fileKey} not resolved`);
475
+ }
476
+ return resolvedFileName;
477
+ }
478
+ /** Resolve the input file name, which may be a partial name, into a full path file name.
479
+ * @param inFileName The partial file name.
480
+ * @returns The resolved full path file name or `undefined` if not found.
481
+ */
482
+ tryResolveFileName(inFileName) { return inFileName; }
483
+ /** Resolve the input file name, which may be a partial name, into a full path file name.
484
+ * @param inFileName The partial file name.
485
+ * @returns The resolved full path file name.
486
+ * @throws [[IModelError]] if not found.
487
+ */
488
+ resolveFileName(inFileName) {
489
+ const resolvedFileName = this.tryResolveFileName(inFileName);
490
+ if (undefined === resolvedFileName) {
491
+ throw new core_common_1.IModelError(core_bentley_1.IModelStatus.NotFound, `${inFileName} not resolved`);
492
+ }
493
+ return resolvedFileName;
494
+ }
495
+ }
496
+ exports.FileNameResolver = FileNameResolver;
497
497
  //# sourceMappingURL=IModelHost.js.map