@itwin/core-backend 3.7.4 → 3.7.6

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 (246) hide show
  1. package/CHANGELOG.md +14 -1
  2. package/lib/cjs/AliCloudStorageService.d.ts +23 -23
  3. package/lib/cjs/AliCloudStorageService.js +71 -71
  4. package/lib/cjs/AliCloudStorageService.js.map +1 -1
  5. package/lib/cjs/BackendHubAccess.d.ts +224 -224
  6. package/lib/cjs/BackendHubAccess.js +41 -41
  7. package/lib/cjs/BackendHubAccess.js.map +1 -1
  8. package/lib/cjs/BackendLoggerCategory.d.ts +91 -91
  9. package/lib/cjs/BackendLoggerCategory.js +99 -99
  10. package/lib/cjs/BackendLoggerCategory.js.map +1 -1
  11. package/lib/cjs/BisCoreSchema.d.ts +21 -21
  12. package/lib/cjs/BisCoreSchema.js +60 -60
  13. package/lib/cjs/BisCoreSchema.js.map +1 -1
  14. package/lib/cjs/BriefcaseManager.d.ts +170 -170
  15. package/lib/cjs/BriefcaseManager.js +414 -414
  16. package/lib/cjs/BriefcaseManager.js.map +1 -1
  17. package/lib/cjs/Category.d.ts +153 -153
  18. package/lib/cjs/Category.js +243 -243
  19. package/lib/cjs/Category.js.map +1 -1
  20. package/lib/cjs/ChangeSummaryManager.d.ts +187 -187
  21. package/lib/cjs/ChangeSummaryManager.js +447 -447
  22. package/lib/cjs/ChangeSummaryManager.js.map +1 -1
  23. package/lib/cjs/ChangedElementsDb.d.ts +99 -99
  24. package/lib/cjs/ChangedElementsDb.js +165 -165
  25. package/lib/cjs/ChangedElementsDb.js.map +1 -1
  26. package/lib/cjs/ChangedElementsManager.d.ts +39 -39
  27. package/lib/cjs/ChangedElementsManager.js +88 -88
  28. package/lib/cjs/ChangedElementsManager.js.map +1 -1
  29. package/lib/cjs/CheckpointManager.d.ts +121 -121
  30. package/lib/cjs/CheckpointManager.d.ts.map +1 -1
  31. package/lib/cjs/CheckpointManager.js +352 -349
  32. package/lib/cjs/CheckpointManager.js.map +1 -1
  33. package/lib/cjs/ClassRegistry.d.ts +79 -79
  34. package/lib/cjs/ClassRegistry.js +250 -250
  35. package/lib/cjs/ClassRegistry.js.map +1 -1
  36. package/lib/cjs/CloudSqlite.d.ts +350 -350
  37. package/lib/cjs/CloudSqlite.js +153 -153
  38. package/lib/cjs/CloudSqlite.js.map +1 -1
  39. package/lib/cjs/CloudStorageBackend.d.ts +58 -58
  40. package/lib/cjs/CloudStorageBackend.js +173 -173
  41. package/lib/cjs/CloudStorageBackend.js.map +1 -1
  42. package/lib/cjs/CodeService.d.ts +396 -396
  43. package/lib/cjs/CodeService.js +63 -63
  44. package/lib/cjs/CodeService.js.map +1 -1
  45. package/lib/cjs/CodeSpecs.d.ts +55 -55
  46. package/lib/cjs/CodeSpecs.js +124 -124
  47. package/lib/cjs/CodeSpecs.js.map +1 -1
  48. package/lib/cjs/ConcurrentQuery.d.ts +13 -13
  49. package/lib/cjs/ConcurrentQuery.js +36 -36
  50. package/lib/cjs/ConcurrentQuery.js.map +1 -1
  51. package/lib/cjs/CustomViewState3dCreator.d.ts +21 -21
  52. package/lib/cjs/CustomViewState3dCreator.js +82 -82
  53. package/lib/cjs/CustomViewState3dCreator.js.map +1 -1
  54. package/lib/cjs/DevTools.d.ts +71 -71
  55. package/lib/cjs/DevTools.js +154 -154
  56. package/lib/cjs/DevTools.js.map +1 -1
  57. package/lib/cjs/DisplayStyle.d.ts +106 -106
  58. package/lib/cjs/DisplayStyle.js +256 -256
  59. package/lib/cjs/DisplayStyle.js.map +1 -1
  60. package/lib/cjs/ECDb.d.ts +194 -194
  61. package/lib/cjs/ECDb.js +355 -355
  62. package/lib/cjs/ECDb.js.map +1 -1
  63. package/lib/cjs/ECSchemaXmlContext.d.ts +18 -18
  64. package/lib/cjs/ECSchemaXmlContext.js +41 -41
  65. package/lib/cjs/ECSchemaXmlContext.js.map +1 -1
  66. package/lib/cjs/ECSqlStatement.d.ts +473 -473
  67. package/lib/cjs/ECSqlStatement.js +791 -791
  68. package/lib/cjs/ECSqlStatement.js.map +1 -1
  69. package/lib/cjs/Element.d.ts +1109 -1109
  70. package/lib/cjs/Element.js +1427 -1427
  71. package/lib/cjs/Element.js.map +1 -1
  72. package/lib/cjs/ElementAspect.d.ts +179 -179
  73. package/lib/cjs/ElementAspect.js +211 -211
  74. package/lib/cjs/ElementAspect.js.map +1 -1
  75. package/lib/cjs/ElementGraphics.d.ts +9 -9
  76. package/lib/cjs/ElementGraphics.js +41 -41
  77. package/lib/cjs/ElementGraphics.js.map +1 -1
  78. package/lib/cjs/ElementTreeWalker.d.ts +162 -162
  79. package/lib/cjs/ElementTreeWalker.js +409 -409
  80. package/lib/cjs/ElementTreeWalker.js.map +1 -1
  81. package/lib/cjs/Entity.d.ts +106 -106
  82. package/lib/cjs/Entity.js +134 -134
  83. package/lib/cjs/Entity.js.map +1 -1
  84. package/lib/cjs/EntityReferences.d.ts +49 -49
  85. package/lib/cjs/EntityReferences.js +95 -95
  86. package/lib/cjs/EntityReferences.js.map +1 -1
  87. package/lib/cjs/ExportGraphics.d.ts +317 -317
  88. package/lib/cjs/ExportGraphics.js +208 -208
  89. package/lib/cjs/ExportGraphics.js.map +1 -1
  90. package/lib/cjs/ExternalSource.d.ts +96 -96
  91. package/lib/cjs/ExternalSource.js +131 -131
  92. package/lib/cjs/ExternalSource.js.map +1 -1
  93. package/lib/cjs/GeoCoordConfig.d.ts +19 -19
  94. package/lib/cjs/GeoCoordConfig.js +85 -85
  95. package/lib/cjs/GeoCoordConfig.js.map +1 -1
  96. package/lib/cjs/GeometrySummary.d.ts +4 -4
  97. package/lib/cjs/GeometrySummary.js +380 -380
  98. package/lib/cjs/GeometrySummary.js.map +1 -1
  99. package/lib/cjs/HubMock.d.ts +94 -94
  100. package/lib/cjs/HubMock.js +222 -222
  101. package/lib/cjs/HubMock.js.map +1 -1
  102. package/lib/cjs/IModelCloneContext.d.ts +8 -8
  103. package/lib/cjs/IModelCloneContext.js +15 -15
  104. package/lib/cjs/IModelCloneContext.js.map +1 -1
  105. package/lib/cjs/IModelDb.d.ts +1213 -1213
  106. package/lib/cjs/IModelDb.js +2392 -2392
  107. package/lib/cjs/IModelDb.js.map +1 -1
  108. package/lib/cjs/IModelElementCloneContext.d.ts +89 -89
  109. package/lib/cjs/IModelElementCloneContext.js +159 -159
  110. package/lib/cjs/IModelElementCloneContext.js.map +1 -1
  111. package/lib/cjs/IModelHost.d.ts +369 -369
  112. package/lib/cjs/IModelHost.js +496 -496
  113. package/lib/cjs/IModelHost.js.map +1 -1
  114. package/lib/cjs/IModelJsFs.d.ts +62 -62
  115. package/lib/cjs/IModelJsFs.js +140 -140
  116. package/lib/cjs/IModelJsFs.js.map +1 -1
  117. package/lib/cjs/IpcHost.d.ts +104 -104
  118. package/lib/cjs/IpcHost.js +278 -278
  119. package/lib/cjs/IpcHost.js.map +1 -1
  120. package/lib/cjs/LineStyle.d.ts +311 -311
  121. package/lib/cjs/LineStyle.js +295 -295
  122. package/lib/cjs/LineStyle.js.map +1 -1
  123. package/lib/cjs/LocalHub.d.ts +162 -162
  124. package/lib/cjs/LocalHub.js +585 -585
  125. package/lib/cjs/LocalHub.js.map +1 -1
  126. package/lib/cjs/LocalhostIpcHost.d.ts +21 -21
  127. package/lib/cjs/LocalhostIpcHost.js +81 -81
  128. package/lib/cjs/LocalhostIpcHost.js.map +1 -1
  129. package/lib/cjs/Material.d.ts +131 -131
  130. package/lib/cjs/Material.js +181 -181
  131. package/lib/cjs/Material.js.map +1 -1
  132. package/lib/cjs/Model.d.ts +392 -392
  133. package/lib/cjs/Model.js +485 -485
  134. package/lib/cjs/Model.js.map +1 -1
  135. package/lib/cjs/NativeAppStorage.d.ts +51 -51
  136. package/lib/cjs/NativeAppStorage.js +202 -202
  137. package/lib/cjs/NativeAppStorage.js.map +1 -1
  138. package/lib/cjs/NativeHost.d.ts +52 -52
  139. package/lib/cjs/NativeHost.js +163 -163
  140. package/lib/cjs/NativeHost.js.map +1 -1
  141. package/lib/cjs/NavigationRelationship.d.ts +156 -156
  142. package/lib/cjs/NavigationRelationship.js +225 -225
  143. package/lib/cjs/NavigationRelationship.js.map +1 -1
  144. package/lib/cjs/PromiseMemoizer.d.ts +51 -51
  145. package/lib/cjs/PromiseMemoizer.js +101 -101
  146. package/lib/cjs/PromiseMemoizer.js.map +1 -1
  147. package/lib/cjs/PropertyStore.d.ts +132 -132
  148. package/lib/cjs/PropertyStore.js +11 -11
  149. package/lib/cjs/PropertyStore.js.map +1 -1
  150. package/lib/cjs/Relationship.d.ts +416 -416
  151. package/lib/cjs/Relationship.js +494 -494
  152. package/lib/cjs/Relationship.js.map +1 -1
  153. package/lib/cjs/RpcBackend.d.ts +5 -5
  154. package/lib/cjs/RpcBackend.js +32 -32
  155. package/lib/cjs/RpcBackend.js.map +1 -1
  156. package/lib/cjs/SQLiteDb.d.ts +219 -219
  157. package/lib/cjs/SQLiteDb.js +214 -214
  158. package/lib/cjs/SQLiteDb.js.map +1 -1
  159. package/lib/cjs/Schema.d.ts +55 -55
  160. package/lib/cjs/Schema.js +83 -83
  161. package/lib/cjs/Schema.js.map +1 -1
  162. package/lib/cjs/ServerBasedLocks.d.ts +57 -57
  163. package/lib/cjs/ServerBasedLocks.js +168 -168
  164. package/lib/cjs/ServerBasedLocks.js.map +1 -1
  165. package/lib/cjs/SqliteStatement.d.ts +360 -360
  166. package/lib/cjs/SqliteStatement.js +586 -586
  167. package/lib/cjs/SqliteStatement.js.map +1 -1
  168. package/lib/cjs/Texture.d.ts +58 -58
  169. package/lib/cjs/Texture.js +82 -82
  170. package/lib/cjs/Texture.js.map +1 -1
  171. package/lib/cjs/TileStorage.d.ts +18 -18
  172. package/lib/cjs/TileStorage.js +90 -90
  173. package/lib/cjs/TileStorage.js.map +1 -1
  174. package/lib/cjs/TxnManager.d.ts +202 -202
  175. package/lib/cjs/TxnManager.js +356 -356
  176. package/lib/cjs/TxnManager.js.map +1 -1
  177. package/lib/cjs/ViewDefinition.d.ts +439 -439
  178. package/lib/cjs/ViewDefinition.js +646 -646
  179. package/lib/cjs/ViewDefinition.js.map +1 -1
  180. package/lib/cjs/ViewStateHydrator.d.ts +13 -13
  181. package/lib/cjs/ViewStateHydrator.js +103 -103
  182. package/lib/cjs/ViewStateHydrator.js.map +1 -1
  183. package/lib/cjs/assets/IModelChange.02.00.00.ecschema.xml +90 -90
  184. package/lib/cjs/assets/Settings/Schemas/Cloud.Schema.json +67 -67
  185. package/lib/cjs/assets/Settings/Schemas/Gcs.schema.json +31 -31
  186. package/lib/cjs/assets/Settings/Schemas/Workspace.Schema.json +52 -52
  187. package/lib/cjs/assets/Settings/backend.setting.json5 +138 -138
  188. package/lib/cjs/core-backend.d.ts +184 -184
  189. package/lib/cjs/core-backend.js +204 -204
  190. package/lib/cjs/core-backend.js.map +1 -1
  191. package/lib/cjs/domains/FunctionalElements.d.ts +101 -101
  192. package/lib/cjs/domains/FunctionalElements.js +145 -145
  193. package/lib/cjs/domains/FunctionalElements.js.map +1 -1
  194. package/lib/cjs/domains/FunctionalSchema.d.ts +13 -13
  195. package/lib/cjs/domains/FunctionalSchema.js +40 -40
  196. package/lib/cjs/domains/FunctionalSchema.js.map +1 -1
  197. package/lib/cjs/domains/GenericElements.d.ts +177 -177
  198. package/lib/cjs/domains/GenericElements.js +263 -263
  199. package/lib/cjs/domains/GenericElements.js.map +1 -1
  200. package/lib/cjs/domains/GenericSchema.d.ts +10 -10
  201. package/lib/cjs/domains/GenericSchema.js +28 -28
  202. package/lib/cjs/domains/GenericSchema.js.map +1 -1
  203. package/lib/cjs/rpc/multipart.d.ts +11 -11
  204. package/lib/cjs/rpc/multipart.js +71 -71
  205. package/lib/cjs/rpc/multipart.js.map +1 -1
  206. package/lib/cjs/rpc/tracing.d.ts +28 -28
  207. package/lib/cjs/rpc/tracing.js +74 -74
  208. package/lib/cjs/rpc/tracing.js.map +1 -1
  209. package/lib/cjs/rpc/web/logging.d.ts +9 -9
  210. package/lib/cjs/rpc/web/logging.js +43 -43
  211. package/lib/cjs/rpc/web/logging.js.map +1 -1
  212. package/lib/cjs/rpc/web/request.d.ts +6 -6
  213. package/lib/cjs/rpc/web/request.js +74 -74
  214. package/lib/cjs/rpc/web/request.js.map +1 -1
  215. package/lib/cjs/rpc/web/response.d.ts +6 -6
  216. package/lib/cjs/rpc/web/response.js +106 -106
  217. package/lib/cjs/rpc/web/response.js.map +1 -1
  218. package/lib/cjs/rpc-impl/DevToolsRpcImpl.d.ts +15 -15
  219. package/lib/cjs/rpc-impl/DevToolsRpcImpl.js +32 -32
  220. package/lib/cjs/rpc-impl/DevToolsRpcImpl.js.map +1 -1
  221. package/lib/cjs/rpc-impl/IModelReadRpcImpl.d.ts +47 -47
  222. package/lib/cjs/rpc-impl/IModelReadRpcImpl.js +294 -294
  223. package/lib/cjs/rpc-impl/IModelReadRpcImpl.js.map +1 -1
  224. package/lib/cjs/rpc-impl/IModelTileRpcImpl.d.ts +22 -22
  225. package/lib/cjs/rpc-impl/IModelTileRpcImpl.d.ts.map +1 -1
  226. package/lib/cjs/rpc-impl/IModelTileRpcImpl.js +211 -208
  227. package/lib/cjs/rpc-impl/IModelTileRpcImpl.js.map +1 -1
  228. package/lib/cjs/rpc-impl/RpcBriefcaseUtility.d.ts +36 -36
  229. package/lib/cjs/rpc-impl/RpcBriefcaseUtility.js +168 -168
  230. package/lib/cjs/rpc-impl/RpcBriefcaseUtility.js.map +1 -1
  231. package/lib/cjs/rpc-impl/SnapshotIModelRpcImpl.d.ts +16 -16
  232. package/lib/cjs/rpc-impl/SnapshotIModelRpcImpl.js +43 -43
  233. package/lib/cjs/rpc-impl/SnapshotIModelRpcImpl.js.map +1 -1
  234. package/lib/cjs/rpc-impl/WipRpcImpl.d.ts +15 -15
  235. package/lib/cjs/rpc-impl/WipRpcImpl.js +37 -37
  236. package/lib/cjs/rpc-impl/WipRpcImpl.js.map +1 -1
  237. package/lib/cjs/workspace/Settings.d.ts +186 -186
  238. package/lib/cjs/workspace/Settings.js +155 -155
  239. package/lib/cjs/workspace/Settings.js.map +1 -1
  240. package/lib/cjs/workspace/SettingsSchemas.d.ts +75 -75
  241. package/lib/cjs/workspace/SettingsSchemas.js +191 -191
  242. package/lib/cjs/workspace/SettingsSchemas.js.map +1 -1
  243. package/lib/cjs/workspace/Workspace.d.ts +414 -414
  244. package/lib/cjs/workspace/Workspace.js +543 -543
  245. package/lib/cjs/workspace/Workspace.js.map +1 -1
  246. 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