@itwin/core-bentley 4.0.0-dev.24 → 4.0.0-dev.28

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 (222) hide show
  1. package/CHANGELOG.md +18 -11
  2. package/lib/cjs/AccessToken.d.ts +10 -10
  3. package/lib/cjs/AccessToken.js +9 -9
  4. package/lib/cjs/AccessToken.js.map +1 -1
  5. package/lib/cjs/Assert.d.ts +25 -25
  6. package/lib/cjs/Assert.js +45 -45
  7. package/lib/cjs/Assert.js.map +1 -1
  8. package/lib/cjs/BeEvent.d.ts +81 -81
  9. package/lib/cjs/BeEvent.js +156 -156
  10. package/lib/cjs/BeEvent.js.map +1 -1
  11. package/lib/cjs/BeSQLite.d.ts +172 -170
  12. package/lib/cjs/BeSQLite.d.ts.map +1 -1
  13. package/lib/cjs/BeSQLite.js +185 -183
  14. package/lib/cjs/BeSQLite.js.map +1 -1
  15. package/lib/cjs/BentleyError.d.ts +378 -378
  16. package/lib/cjs/BentleyError.d.ts.map +1 -1
  17. package/lib/cjs/BentleyError.js +703 -702
  18. package/lib/cjs/BentleyError.js.map +1 -1
  19. package/lib/cjs/BentleyLoggerCategory.d.ts +11 -11
  20. package/lib/cjs/BentleyLoggerCategory.js +19 -19
  21. package/lib/cjs/BentleyLoggerCategory.js.map +1 -1
  22. package/lib/cjs/ByteStream.d.ts +110 -110
  23. package/lib/cjs/ByteStream.js +159 -159
  24. package/lib/cjs/ByteStream.js.map +1 -1
  25. package/lib/cjs/ClassUtils.d.ts +14 -14
  26. package/lib/cjs/ClassUtils.js +27 -27
  27. package/lib/cjs/ClassUtils.js.map +1 -1
  28. package/lib/cjs/Compare.d.ts +47 -47
  29. package/lib/cjs/Compare.js +75 -75
  30. package/lib/cjs/Compare.js.map +1 -1
  31. package/lib/cjs/CompressedId64Set.d.ts +134 -134
  32. package/lib/cjs/CompressedId64Set.js +428 -428
  33. package/lib/cjs/CompressedId64Set.js.map +1 -1
  34. package/lib/cjs/Dictionary.d.ts +125 -125
  35. package/lib/cjs/Dictionary.js +203 -203
  36. package/lib/cjs/Dictionary.js.map +1 -1
  37. package/lib/cjs/Disposable.d.ts +80 -80
  38. package/lib/cjs/Disposable.js +120 -120
  39. package/lib/cjs/Disposable.js.map +1 -1
  40. package/lib/cjs/Id.d.ts +285 -285
  41. package/lib/cjs/Id.js +643 -643
  42. package/lib/cjs/Id.js.map +1 -1
  43. package/lib/cjs/IndexMap.d.ts +65 -65
  44. package/lib/cjs/IndexMap.js +91 -91
  45. package/lib/cjs/IndexMap.js.map +1 -1
  46. package/lib/cjs/JsonSchema.d.ts +77 -77
  47. package/lib/cjs/JsonSchema.js +9 -9
  48. package/lib/cjs/JsonSchema.js.map +1 -1
  49. package/lib/cjs/JsonUtils.d.ts +78 -78
  50. package/lib/cjs/JsonUtils.js +151 -151
  51. package/lib/cjs/JsonUtils.js.map +1 -1
  52. package/lib/cjs/LRUMap.d.ts +129 -129
  53. package/lib/cjs/LRUMap.js +333 -333
  54. package/lib/cjs/LRUMap.js.map +1 -1
  55. package/lib/cjs/Logger.d.ts +143 -143
  56. package/lib/cjs/Logger.js +256 -258
  57. package/lib/cjs/Logger.js.map +1 -1
  58. package/lib/cjs/ObservableSet.d.ts +23 -23
  59. package/lib/cjs/ObservableSet.js +51 -51
  60. package/lib/cjs/ObservableSet.js.map +1 -1
  61. package/lib/cjs/OneAtATimeAction.d.ts +31 -31
  62. package/lib/cjs/OneAtATimeAction.js +94 -94
  63. package/lib/cjs/OneAtATimeAction.js.map +1 -1
  64. package/lib/cjs/OrderedId64Iterable.d.ts +74 -74
  65. package/lib/cjs/OrderedId64Iterable.js +235 -235
  66. package/lib/cjs/OrderedId64Iterable.js.map +1 -1
  67. package/lib/cjs/OrderedSet.d.ts +40 -40
  68. package/lib/cjs/OrderedSet.js +64 -64
  69. package/lib/cjs/OrderedSet.js.map +1 -1
  70. package/lib/cjs/PriorityQueue.d.ts +70 -70
  71. package/lib/cjs/PriorityQueue.js +140 -140
  72. package/lib/cjs/PriorityQueue.js.map +1 -1
  73. package/lib/cjs/ProcessDetector.d.ts +59 -59
  74. package/lib/cjs/ProcessDetector.js +71 -71
  75. package/lib/cjs/ProcessDetector.js.map +1 -1
  76. package/lib/cjs/SortedArray.d.ts +236 -236
  77. package/lib/cjs/SortedArray.js +315 -315
  78. package/lib/cjs/SortedArray.js.map +1 -1
  79. package/lib/cjs/StatusCategory.d.ts +30 -30
  80. package/lib/cjs/StatusCategory.js +460 -460
  81. package/lib/cjs/StatusCategory.js.map +1 -1
  82. package/lib/cjs/StringUtils.d.ts +22 -22
  83. package/lib/cjs/StringUtils.js +148 -148
  84. package/lib/cjs/StringUtils.js.map +1 -1
  85. package/lib/cjs/Time.d.ts +122 -122
  86. package/lib/cjs/Time.js +152 -152
  87. package/lib/cjs/Time.js.map +1 -1
  88. package/lib/cjs/Tracing.d.ts +40 -40
  89. package/lib/cjs/Tracing.js +127 -130
  90. package/lib/cjs/Tracing.js.map +1 -1
  91. package/lib/cjs/TupleKeyedMap.d.ts +36 -36
  92. package/lib/cjs/TupleKeyedMap.js +102 -102
  93. package/lib/cjs/TupleKeyedMap.js.map +1 -1
  94. package/lib/cjs/TypedArrayBuilder.d.ts +155 -155
  95. package/lib/cjs/TypedArrayBuilder.js +206 -208
  96. package/lib/cjs/TypedArrayBuilder.js.map +1 -1
  97. package/lib/cjs/UnexpectedErrors.d.ts +43 -43
  98. package/lib/cjs/UnexpectedErrors.js +68 -68
  99. package/lib/cjs/UnexpectedErrors.js.map +1 -1
  100. package/lib/cjs/UtilityTypes.d.ts +96 -96
  101. package/lib/cjs/UtilityTypes.js +40 -40
  102. package/lib/cjs/UtilityTypes.js.map +1 -1
  103. package/lib/cjs/YieldManager.d.ts +18 -18
  104. package/lib/cjs/YieldManager.js +34 -34
  105. package/lib/cjs/YieldManager.js.map +1 -1
  106. package/lib/cjs/core-bentley.d.ts +74 -74
  107. package/lib/cjs/core-bentley.js +90 -90
  108. package/lib/cjs/core-bentley.js.map +1 -1
  109. package/lib/cjs/partitionArray.d.ts +21 -21
  110. package/lib/cjs/partitionArray.js +43 -43
  111. package/lib/cjs/partitionArray.js.map +1 -1
  112. package/lib/esm/AccessToken.d.ts +10 -10
  113. package/lib/esm/AccessToken.js +8 -8
  114. package/lib/esm/AccessToken.js.map +1 -1
  115. package/lib/esm/Assert.d.ts +25 -25
  116. package/lib/esm/Assert.js +41 -41
  117. package/lib/esm/Assert.js.map +1 -1
  118. package/lib/esm/BeEvent.d.ts +81 -81
  119. package/lib/esm/BeEvent.js +150 -150
  120. package/lib/esm/BeEvent.js.map +1 -1
  121. package/lib/esm/BeSQLite.d.ts +172 -170
  122. package/lib/esm/BeSQLite.d.ts.map +1 -1
  123. package/lib/esm/BeSQLite.js +182 -180
  124. package/lib/esm/BeSQLite.js.map +1 -1
  125. package/lib/esm/BentleyError.d.ts +378 -378
  126. package/lib/esm/BentleyError.d.ts.map +1 -1
  127. package/lib/esm/BentleyError.js +699 -698
  128. package/lib/esm/BentleyError.js.map +1 -1
  129. package/lib/esm/BentleyLoggerCategory.d.ts +11 -11
  130. package/lib/esm/BentleyLoggerCategory.js +16 -16
  131. package/lib/esm/BentleyLoggerCategory.js.map +1 -1
  132. package/lib/esm/ByteStream.d.ts +110 -110
  133. package/lib/esm/ByteStream.js +155 -155
  134. package/lib/esm/ByteStream.js.map +1 -1
  135. package/lib/esm/ClassUtils.d.ts +14 -14
  136. package/lib/esm/ClassUtils.js +22 -22
  137. package/lib/esm/ClassUtils.js.map +1 -1
  138. package/lib/esm/Compare.d.ts +47 -47
  139. package/lib/esm/Compare.js +63 -63
  140. package/lib/esm/Compare.js.map +1 -1
  141. package/lib/esm/CompressedId64Set.d.ts +134 -134
  142. package/lib/esm/CompressedId64Set.js +423 -423
  143. package/lib/esm/CompressedId64Set.js.map +1 -1
  144. package/lib/esm/Dictionary.d.ts +125 -125
  145. package/lib/esm/Dictionary.js +199 -199
  146. package/lib/esm/Dictionary.js.map +1 -1
  147. package/lib/esm/Disposable.d.ts +80 -80
  148. package/lib/esm/Disposable.js +112 -112
  149. package/lib/esm/Disposable.js.map +1 -1
  150. package/lib/esm/Id.d.ts +285 -285
  151. package/lib/esm/Id.js +639 -639
  152. package/lib/esm/Id.js.map +1 -1
  153. package/lib/esm/IndexMap.d.ts +65 -65
  154. package/lib/esm/IndexMap.js +86 -86
  155. package/lib/esm/IndexMap.js.map +1 -1
  156. package/lib/esm/JsonSchema.d.ts +77 -77
  157. package/lib/esm/JsonSchema.js +8 -8
  158. package/lib/esm/JsonSchema.js.map +1 -1
  159. package/lib/esm/JsonUtils.d.ts +78 -78
  160. package/lib/esm/JsonUtils.js +148 -148
  161. package/lib/esm/JsonUtils.js.map +1 -1
  162. package/lib/esm/LRUMap.d.ts +129 -129
  163. package/lib/esm/LRUMap.js +326 -326
  164. package/lib/esm/LRUMap.js.map +1 -1
  165. package/lib/esm/Logger.d.ts +143 -143
  166. package/lib/esm/Logger.js +251 -253
  167. package/lib/esm/Logger.js.map +1 -1
  168. package/lib/esm/ObservableSet.d.ts +23 -23
  169. package/lib/esm/ObservableSet.js +47 -47
  170. package/lib/esm/ObservableSet.js.map +1 -1
  171. package/lib/esm/OneAtATimeAction.d.ts +31 -31
  172. package/lib/esm/OneAtATimeAction.js +89 -89
  173. package/lib/esm/OneAtATimeAction.js.map +1 -1
  174. package/lib/esm/OrderedId64Iterable.d.ts +74 -74
  175. package/lib/esm/OrderedId64Iterable.js +232 -232
  176. package/lib/esm/OrderedId64Iterable.js.map +1 -1
  177. package/lib/esm/OrderedSet.d.ts +40 -40
  178. package/lib/esm/OrderedSet.js +59 -59
  179. package/lib/esm/OrderedSet.js.map +1 -1
  180. package/lib/esm/PriorityQueue.d.ts +70 -70
  181. package/lib/esm/PriorityQueue.js +136 -136
  182. package/lib/esm/PriorityQueue.js.map +1 -1
  183. package/lib/esm/ProcessDetector.d.ts +59 -59
  184. package/lib/esm/ProcessDetector.js +67 -67
  185. package/lib/esm/ProcessDetector.js.map +1 -1
  186. package/lib/esm/SortedArray.d.ts +236 -236
  187. package/lib/esm/SortedArray.js +308 -308
  188. package/lib/esm/SortedArray.js.map +1 -1
  189. package/lib/esm/StatusCategory.d.ts +30 -30
  190. package/lib/esm/StatusCategory.js +454 -454
  191. package/lib/esm/StatusCategory.js.map +1 -1
  192. package/lib/esm/StringUtils.d.ts +22 -22
  193. package/lib/esm/StringUtils.js +142 -142
  194. package/lib/esm/StringUtils.js.map +1 -1
  195. package/lib/esm/Time.d.ts +122 -122
  196. package/lib/esm/Time.js +146 -146
  197. package/lib/esm/Time.js.map +1 -1
  198. package/lib/esm/Tracing.d.ts +40 -40
  199. package/lib/esm/Tracing.js +123 -126
  200. package/lib/esm/Tracing.js.map +1 -1
  201. package/lib/esm/TupleKeyedMap.d.ts +36 -36
  202. package/lib/esm/TupleKeyedMap.js +98 -98
  203. package/lib/esm/TupleKeyedMap.js.map +1 -1
  204. package/lib/esm/TypedArrayBuilder.d.ts +155 -155
  205. package/lib/esm/TypedArrayBuilder.js +198 -200
  206. package/lib/esm/TypedArrayBuilder.js.map +1 -1
  207. package/lib/esm/UnexpectedErrors.d.ts +43 -43
  208. package/lib/esm/UnexpectedErrors.js +64 -64
  209. package/lib/esm/UnexpectedErrors.js.map +1 -1
  210. package/lib/esm/UtilityTypes.d.ts +96 -96
  211. package/lib/esm/UtilityTypes.js +34 -34
  212. package/lib/esm/UtilityTypes.js.map +1 -1
  213. package/lib/esm/YieldManager.d.ts +18 -18
  214. package/lib/esm/YieldManager.js +30 -30
  215. package/lib/esm/YieldManager.js.map +1 -1
  216. package/lib/esm/core-bentley.d.ts +74 -74
  217. package/lib/esm/core-bentley.js +78 -78
  218. package/lib/esm/core-bentley.js.map +1 -1
  219. package/lib/esm/partitionArray.d.ts +21 -21
  220. package/lib/esm/partitionArray.js +39 -39
  221. package/lib/esm/partitionArray.js.map +1 -1
  222. package/package.json +3 -3
package/CHANGELOG.md CHANGED
@@ -12,6 +12,13 @@ Wed, 08 Feb 2023 14:58:39 GMT
12
12
  - Added TransientIdSequence.peekNext to preview the next Id in the sequence.
13
13
  - Deprecate TransientIdSequence.next property in favor of getNext method.
14
14
 
15
+ ## 3.5.6
16
+ Fri, 24 Feb 2023 16:02:47 GMT
17
+
18
+ ### Updates
19
+
20
+ - Add SortedArray.slice.
21
+
15
22
  ## 3.5.5
16
23
  Thu, 26 Jan 2023 22:53:27 GMT
17
24
 
@@ -874,7 +881,7 @@ Thu, 28 May 2020 22:48:59 GMT
874
881
  ### Updates
875
882
 
876
883
  - Added FailedToGetProductSettings error
877
- - Setup Guid.normalize() for internal use.
884
+ - Setup Guid.normalize() for internal use.
878
885
  - channel rules
879
886
 
880
887
  ## 2.0.0
@@ -882,12 +889,12 @@ Wed, 06 May 2020 13:17:49 GMT
882
889
 
883
890
  ### Updates
884
891
 
885
- - Monitor progress of downloading briefcases, ability to cancel download of briefcases.
892
+ - Monitor progress of downloading briefcases, ability to cancel download of briefcases.
886
893
  - Update Config.App documentation to reflect the removal of the config.json file
887
894
  - Added ContextDoesNotExist error
888
895
  - BUG273249
889
- - Updated docs.
890
- - Updated error text.
896
+ - Updated docs.
897
+ - Updated error text.
891
898
  - added raw log method that bypass catogory check
892
899
  - order imports.
893
900
  - Add a type guard for `IDisposable`
@@ -921,7 +928,7 @@ Wed, 22 Jan 2020 19:24:11 GMT
921
928
 
922
929
  ### Updates
923
930
 
924
- - VSS$257397: Temporary fix for checking electron renderer.
931
+ - VSS$257397: Temporary fix for checking electron renderer.
925
932
  - Upgrade to TypeScript 3.7.2.
926
933
 
927
934
  ## 1.10.0
@@ -936,7 +943,7 @@ Tue, 10 Dec 2019 18:08:56 GMT
936
943
 
937
944
  ### Updates
938
945
 
939
- - Setup OidcDesktopClient for Electron use cases.
946
+ - Setup OidcDesktopClient for Electron use cases.
940
947
  - Added non-static wait and executeAfter to BeDuration
941
948
  - Fix warnings from static analysis
942
949
  - Added `BeDuration.race` for common timeout operations.
@@ -989,7 +996,7 @@ Mon, 01 Jul 2019 19:04:29 GMT
989
996
  ### Updates
990
997
 
991
998
  - Added OneAtATimeActivity class
992
- - Introduced AsyncMutex - a utility to run async blocks of code in sequence.
999
+ - Introduced AsyncMutex - a utility to run async blocks of code in sequence.
993
1000
  - Update to TypeScript 3.5
994
1001
 
995
1002
  ## 1.0.0
@@ -1016,10 +1023,10 @@ Mon, 13 May 2019 15:52:05 GMT
1016
1023
  - Logged the fields in ClientRequestContext
1017
1024
  - Logging fixes.
1018
1025
  - Put sourcemap in npm package.
1019
- - Fixed logger to not mutate incoming objects.
1026
+ - Fixed logger to not mutate incoming objects.
1020
1027
  - Improved performance logging
1021
1028
  - Added functions for iterating and obtaining the number of elements of a collection of Id64s represented as an Id64Arg.
1022
- - Setup a generic context for tracking client requests, and made various related enhancements to logging, usage tracking and authorization.
1029
+ - Setup a generic context for tracking client requests, and made various related enhancements to logging, usage tracking and authorization.
1023
1030
  - Use TextDecoder to decode binary utf-8 strings if supported.
1024
1031
  - Upgrade TypeDoc dependency to 0.14.2
1025
1032
 
@@ -1055,7 +1062,7 @@ Mon, 14 Jan 2019 23:09:10 GMT
1055
1062
 
1056
1063
  ### Updates
1057
1064
 
1058
- - Removed IModelDb's cache of accessToken. For long running operations like AutoPush, the user must explicitly supply an IAccessTokenManager to keep the token current.
1065
+ - Removed IModelDb's cache of accessToken. For long running operations like AutoPush, the user must explicitly supply an IAccessTokenManager to keep the token current.
1059
1066
 
1060
1067
  ## 0.185.0
1061
1068
  Fri, 11 Jan 2019 18:29:00 GMT
@@ -1162,7 +1169,7 @@ Fri, 16 Nov 2018 21:45:44 GMT
1162
1169
 
1163
1170
  ### Updates
1164
1171
 
1165
- - Changes to debug utilities.
1172
+ - Changes to debug utilities.
1166
1173
  - Fluentd Bunnyan Logger added
1167
1174
 
1168
1175
  ## 0.166.0
@@ -1,11 +1,11 @@
1
- /** @packageDocumentation
2
- * @module Utils
3
- */
4
- /** A string representing a token used to access resources. An empty string represents an invalid/unavailable token.
5
- * @see [IModelHost.getAccessToken]($backend) and [IModelApp.getAccessToken]($frontend) to obtain an access token.
6
- * @see [IModelHostOptions.authorizationClient]($backend) and [IModelAppOptions.authorizationClient]($frontend) to configure how access tokens are obtained.
7
- * @note Access tokens expire periodically and are automatically refreshed when possible; therefore, tokens should always be requested via an [AuthorizationClient]($common), not cached for later reuse.
8
- * @public
9
- */
10
- export declare type AccessToken = string;
1
+ /** @packageDocumentation
2
+ * @module Utils
3
+ */
4
+ /** A string representing a token used to access resources. An empty string represents an invalid/unavailable token.
5
+ * @see [IModelHost.getAccessToken]($backend) and [IModelApp.getAccessToken]($frontend) to obtain an access token.
6
+ * @see [IModelHostOptions.authorizationClient]($backend) and [IModelAppOptions.authorizationClient]($frontend) to configure how access tokens are obtained.
7
+ * @note Access tokens expire periodically and are automatically refreshed when possible; therefore, tokens should always be requested via an [AuthorizationClient]($common), not cached for later reuse.
8
+ * @public
9
+ */
10
+ export declare type AccessToken = string;
11
11
  //# sourceMappingURL=AccessToken.d.ts.map
@@ -1,10 +1,10 @@
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 Utils
8
- */
9
- Object.defineProperty(exports, "__esModule", { value: true });
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 Utils
8
+ */
9
+ Object.defineProperty(exports, "__esModule", { value: true });
10
10
  //# sourceMappingURL=AccessToken.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"AccessToken.js","sourceRoot":"","sources":["../../src/AccessToken.ts"],"names":[],"mappings":";AACA;;;+FAG+F;AAC/F;;GAEG","sourcesContent":["\r\n/*---------------------------------------------------------------------------------------------\r\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\r\n* See LICENSE.md in the project root for license terms and full copyright notice.\r\n*--------------------------------------------------------------------------------------------*/\r\n/** @packageDocumentation\r\n * @module Utils\r\n */\r\n\r\n/** A string representing a token used to access resources. An empty string represents an invalid/unavailable token.\r\n * @see [IModelHost.getAccessToken]($backend) and [IModelApp.getAccessToken]($frontend) to obtain an access token.\r\n * @see [IModelHostOptions.authorizationClient]($backend) and [IModelAppOptions.authorizationClient]($frontend) to configure how access tokens are obtained.\r\n * @note Access tokens expire periodically and are automatically refreshed when possible; therefore, tokens should always be requested via an [AuthorizationClient]($common), not cached for later reuse.\r\n * @public\r\n */\r\nexport type AccessToken = string;\r\n"]}
1
+ {"version":3,"file":"AccessToken.js","sourceRoot":"","sources":["../../src/AccessToken.ts"],"names":[],"mappings":";AACA;;;+FAG+F;AAC/F;;GAEG","sourcesContent":["\n/*---------------------------------------------------------------------------------------------\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n* See LICENSE.md in the project root for license terms and full copyright notice.\n*--------------------------------------------------------------------------------------------*/\n/** @packageDocumentation\n * @module Utils\n */\n\n/** A string representing a token used to access resources. An empty string represents an invalid/unavailable token.\n * @see [IModelHost.getAccessToken]($backend) and [IModelApp.getAccessToken]($frontend) to obtain an access token.\n * @see [IModelHostOptions.authorizationClient]($backend) and [IModelAppOptions.authorizationClient]($frontend) to configure how access tokens are obtained.\n * @note Access tokens expire periodically and are automatically refreshed when possible; therefore, tokens should always be requested via an [AuthorizationClient]($common), not cached for later reuse.\n * @public\n */\nexport type AccessToken = string;\n"]}
@@ -1,26 +1,26 @@
1
- /** @packageDocumentation
2
- * @module Utils
3
- */
4
- /** Asserts that a condition is `true` and - when enabled - throws an error if it is not.
5
- * Assertions are enabled only if the build configuration defines `process.env.NODE_ENV` as `development` at build time.
6
- *
7
- * Assertions exist solely to assist programmers during development, in the following ways:
8
- * 1 They allow the programmer to declare conditions that they believe cannot possibly occur. If such conditions occur, they indicate
9
- * a serious flaw in the programmer's logic.
10
- * 2 They allow the programmer to assure the TypeScript compiler of the truth of some condition that the compiler cannot itself infer.
11
- * 3 They allow the author of an API to indicate to consumers of the API a serious misuse that should be corrected during development.
12
- *
13
- * Assertions should **never** be used to test for conditions - however unlikely - that could be expected to occur at run-time,
14
- * such as failing to write to a file or load a resource over the network. If the condition asserted ever fails in a production environment,
15
- * the programmer has made a serious mistake.
16
- *
17
- * Note that even when assertions are disabled, calls to `assert` remain in the code and their arguments will be evaluated at run-time.
18
- * Therefore, if your condition or message requires computation, prefer to pass it as a function to prevent it from being evaluated when assertions are disabled.
19
- *
20
- * @param condition The condition that is asserted to be `true`. If the condition is more complex than a simple `boolean` variable, pass it as a function to prevent it from being evaluated when assertions are disabled.
21
- * @param message An optional description of the condition being asserted, to be included in the exception if `condition` is `false`. If the message must be computed, pass it as a function to prevent it from being evaluated when assertions are disabled. Defaults to "Programmer Error".
22
- * @throws Error containing the specified `message` if `condition` is `false`.
23
- * @public
24
- */
25
- export declare function assert(condition: boolean | (() => boolean), message?: string | (() => string)): asserts condition;
1
+ /** @packageDocumentation
2
+ * @module Utils
3
+ */
4
+ /** Asserts that a condition is `true` and - when enabled - throws an error if it is not.
5
+ * Assertions are enabled only if the build configuration defines `process.env.NODE_ENV` as `development` at build time.
6
+ *
7
+ * Assertions exist solely to assist programmers during development, in the following ways:
8
+ * 1 They allow the programmer to declare conditions that they believe cannot possibly occur. If such conditions occur, they indicate
9
+ * a serious flaw in the programmer's logic.
10
+ * 2 They allow the programmer to assure the TypeScript compiler of the truth of some condition that the compiler cannot itself infer.
11
+ * 3 They allow the author of an API to indicate to consumers of the API a serious misuse that should be corrected during development.
12
+ *
13
+ * Assertions should **never** be used to test for conditions - however unlikely - that could be expected to occur at run-time,
14
+ * such as failing to write to a file or load a resource over the network. If the condition asserted ever fails in a production environment,
15
+ * the programmer has made a serious mistake.
16
+ *
17
+ * Note that even when assertions are disabled, calls to `assert` remain in the code and their arguments will be evaluated at run-time.
18
+ * Therefore, if your condition or message requires computation, prefer to pass it as a function to prevent it from being evaluated when assertions are disabled.
19
+ *
20
+ * @param condition The condition that is asserted to be `true`. If the condition is more complex than a simple `boolean` variable, pass it as a function to prevent it from being evaluated when assertions are disabled.
21
+ * @param message An optional description of the condition being asserted, to be included in the exception if `condition` is `false`. If the message must be computed, pass it as a function to prevent it from being evaluated when assertions are disabled. Defaults to "Programmer Error".
22
+ * @throws Error containing the specified `message` if `condition` is `false`.
23
+ * @public
24
+ */
25
+ export declare function assert(condition: boolean | (() => boolean), message?: string | (() => string)): asserts condition;
26
26
  //# sourceMappingURL=Assert.d.ts.map
package/lib/cjs/Assert.js CHANGED
@@ -1,46 +1,46 @@
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 Utils
8
- */
9
- Object.defineProperty(exports, "__esModule", { value: true });
10
- exports.assert = void 0;
11
- const assertionsEnabled = process.env.NODE_ENV === "development";
12
- /** Asserts that a condition is `true` and - when enabled - throws an error if it is not.
13
- * Assertions are enabled only if the build configuration defines `process.env.NODE_ENV` as `development` at build time.
14
- *
15
- * Assertions exist solely to assist programmers during development, in the following ways:
16
- * 1 They allow the programmer to declare conditions that they believe cannot possibly occur. If such conditions occur, they indicate
17
- * a serious flaw in the programmer's logic.
18
- * 2 They allow the programmer to assure the TypeScript compiler of the truth of some condition that the compiler cannot itself infer.
19
- * 3 They allow the author of an API to indicate to consumers of the API a serious misuse that should be corrected during development.
20
- *
21
- * Assertions should **never** be used to test for conditions - however unlikely - that could be expected to occur at run-time,
22
- * such as failing to write to a file or load a resource over the network. If the condition asserted ever fails in a production environment,
23
- * the programmer has made a serious mistake.
24
- *
25
- * Note that even when assertions are disabled, calls to `assert` remain in the code and their arguments will be evaluated at run-time.
26
- * Therefore, if your condition or message requires computation, prefer to pass it as a function to prevent it from being evaluated when assertions are disabled.
27
- *
28
- * @param condition The condition that is asserted to be `true`. If the condition is more complex than a simple `boolean` variable, pass it as a function to prevent it from being evaluated when assertions are disabled.
29
- * @param message An optional description of the condition being asserted, to be included in the exception if `condition` is `false`. If the message must be computed, pass it as a function to prevent it from being evaluated when assertions are disabled. Defaults to "Programmer Error".
30
- * @throws Error containing the specified `message` if `condition` is `false`.
31
- * @public
32
- */
33
- function assert(condition, message) {
34
- if (!assertionsEnabled)
35
- return;
36
- if ("boolean" !== typeof condition)
37
- condition = condition();
38
- if (condition)
39
- return;
40
- message = message !== null && message !== void 0 ? message : "Programmer Error";
41
- if ("string" !== typeof message)
42
- message = message();
43
- throw new Error(`Assert: ${message}`);
44
- }
45
- exports.assert = assert;
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 Utils
8
+ */
9
+ Object.defineProperty(exports, "__esModule", { value: true });
10
+ exports.assert = void 0;
11
+ const assertionsEnabled = process.env.NODE_ENV === "development";
12
+ /** Asserts that a condition is `true` and - when enabled - throws an error if it is not.
13
+ * Assertions are enabled only if the build configuration defines `process.env.NODE_ENV` as `development` at build time.
14
+ *
15
+ * Assertions exist solely to assist programmers during development, in the following ways:
16
+ * 1 They allow the programmer to declare conditions that they believe cannot possibly occur. If such conditions occur, they indicate
17
+ * a serious flaw in the programmer's logic.
18
+ * 2 They allow the programmer to assure the TypeScript compiler of the truth of some condition that the compiler cannot itself infer.
19
+ * 3 They allow the author of an API to indicate to consumers of the API a serious misuse that should be corrected during development.
20
+ *
21
+ * Assertions should **never** be used to test for conditions - however unlikely - that could be expected to occur at run-time,
22
+ * such as failing to write to a file or load a resource over the network. If the condition asserted ever fails in a production environment,
23
+ * the programmer has made a serious mistake.
24
+ *
25
+ * Note that even when assertions are disabled, calls to `assert` remain in the code and their arguments will be evaluated at run-time.
26
+ * Therefore, if your condition or message requires computation, prefer to pass it as a function to prevent it from being evaluated when assertions are disabled.
27
+ *
28
+ * @param condition The condition that is asserted to be `true`. If the condition is more complex than a simple `boolean` variable, pass it as a function to prevent it from being evaluated when assertions are disabled.
29
+ * @param message An optional description of the condition being asserted, to be included in the exception if `condition` is `false`. If the message must be computed, pass it as a function to prevent it from being evaluated when assertions are disabled. Defaults to "Programmer Error".
30
+ * @throws Error containing the specified `message` if `condition` is `false`.
31
+ * @public
32
+ */
33
+ function assert(condition, message) {
34
+ if (!assertionsEnabled)
35
+ return;
36
+ if ("boolean" !== typeof condition)
37
+ condition = condition();
38
+ if (condition)
39
+ return;
40
+ message = message ?? "Programmer Error";
41
+ if ("string" !== typeof message)
42
+ message = message();
43
+ throw new Error(`Assert: ${message}`);
44
+ }
45
+ exports.assert = assert;
46
46
  //# sourceMappingURL=Assert.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"Assert.js","sourceRoot":"","sources":["../../src/Assert.ts"],"names":[],"mappings":";AAAA;;;+FAG+F;AAC/F;;GAEG;;;AAEH,MAAM,iBAAiB,GAAG,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,aAAa,CAAC;AAEjE;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,SAAgB,MAAM,CAAC,SAAoC,EAAE,OAAiC;IAC5F,IAAI,CAAC,iBAAiB;QACpB,OAAO;IAET,IAAI,SAAS,KAAK,OAAO,SAAS;QAChC,SAAS,GAAG,SAAS,EAAE,CAAC;IAE1B,IAAI,SAAS;QACX,OAAO;IAET,OAAO,GAAG,OAAO,aAAP,OAAO,cAAP,OAAO,GAAI,kBAAkB,CAAC;IACxC,IAAI,QAAQ,KAAK,OAAO,OAAO;QAC7B,OAAO,GAAG,OAAO,EAAE,CAAC;IAEtB,MAAM,IAAI,KAAK,CAAC,WAAW,OAAO,EAAE,CAAC,CAAC;AACxC,CAAC;AAfD,wBAeC","sourcesContent":["/*---------------------------------------------------------------------------------------------\r\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\r\n* See LICENSE.md in the project root for license terms and full copyright notice.\r\n*--------------------------------------------------------------------------------------------*/\r\n/** @packageDocumentation\r\n * @module Utils\r\n */\r\n\r\nconst assertionsEnabled = process.env.NODE_ENV === \"development\";\r\n\r\n/** Asserts that a condition is `true` and - when enabled - throws an error if it is not.\r\n * Assertions are enabled only if the build configuration defines `process.env.NODE_ENV` as `development` at build time.\r\n *\r\n * Assertions exist solely to assist programmers during development, in the following ways:\r\n * 1 They allow the programmer to declare conditions that they believe cannot possibly occur. If such conditions occur, they indicate\r\n * a serious flaw in the programmer's logic.\r\n * 2 They allow the programmer to assure the TypeScript compiler of the truth of some condition that the compiler cannot itself infer.\r\n * 3 They allow the author of an API to indicate to consumers of the API a serious misuse that should be corrected during development.\r\n *\r\n * Assertions should **never** be used to test for conditions - however unlikely - that could be expected to occur at run-time,\r\n * such as failing to write to a file or load a resource over the network. If the condition asserted ever fails in a production environment,\r\n * the programmer has made a serious mistake.\r\n *\r\n * Note that even when assertions are disabled, calls to `assert` remain in the code and their arguments will be evaluated at run-time.\r\n * Therefore, if your condition or message requires computation, prefer to pass it as a function to prevent it from being evaluated when assertions are disabled.\r\n *\r\n * @param condition The condition that is asserted to be `true`. If the condition is more complex than a simple `boolean` variable, pass it as a function to prevent it from being evaluated when assertions are disabled.\r\n * @param message An optional description of the condition being asserted, to be included in the exception if `condition` is `false`. If the message must be computed, pass it as a function to prevent it from being evaluated when assertions are disabled. Defaults to \"Programmer Error\".\r\n * @throws Error containing the specified `message` if `condition` is `false`.\r\n * @public\r\n */\r\nexport function assert(condition: boolean | (() => boolean), message?: string | (() => string)): asserts condition {\r\n if (!assertionsEnabled)\r\n return;\r\n\r\n if (\"boolean\" !== typeof condition)\r\n condition = condition();\r\n\r\n if (condition)\r\n return;\r\n\r\n message = message ?? \"Programmer Error\";\r\n if (\"string\" !== typeof message)\r\n message = message();\r\n\r\n throw new Error(`Assert: ${message}`);\r\n}\r\n"]}
1
+ {"version":3,"file":"Assert.js","sourceRoot":"","sources":["../../src/Assert.ts"],"names":[],"mappings":";AAAA;;;+FAG+F;AAC/F;;GAEG;;;AAEH,MAAM,iBAAiB,GAAG,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,aAAa,CAAC;AAEjE;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,SAAgB,MAAM,CAAC,SAAoC,EAAE,OAAiC;IAC5F,IAAI,CAAC,iBAAiB;QACpB,OAAO;IAET,IAAI,SAAS,KAAK,OAAO,SAAS;QAChC,SAAS,GAAG,SAAS,EAAE,CAAC;IAE1B,IAAI,SAAS;QACX,OAAO;IAET,OAAO,GAAG,OAAO,IAAI,kBAAkB,CAAC;IACxC,IAAI,QAAQ,KAAK,OAAO,OAAO;QAC7B,OAAO,GAAG,OAAO,EAAE,CAAC;IAEtB,MAAM,IAAI,KAAK,CAAC,WAAW,OAAO,EAAE,CAAC,CAAC;AACxC,CAAC;AAfD,wBAeC","sourcesContent":["/*---------------------------------------------------------------------------------------------\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n* See LICENSE.md in the project root for license terms and full copyright notice.\n*--------------------------------------------------------------------------------------------*/\n/** @packageDocumentation\n * @module Utils\n */\n\nconst assertionsEnabled = process.env.NODE_ENV === \"development\";\n\n/** Asserts that a condition is `true` and - when enabled - throws an error if it is not.\n * Assertions are enabled only if the build configuration defines `process.env.NODE_ENV` as `development` at build time.\n *\n * Assertions exist solely to assist programmers during development, in the following ways:\n * 1 They allow the programmer to declare conditions that they believe cannot possibly occur. If such conditions occur, they indicate\n * a serious flaw in the programmer's logic.\n * 2 They allow the programmer to assure the TypeScript compiler of the truth of some condition that the compiler cannot itself infer.\n * 3 They allow the author of an API to indicate to consumers of the API a serious misuse that should be corrected during development.\n *\n * Assertions should **never** be used to test for conditions - however unlikely - that could be expected to occur at run-time,\n * such as failing to write to a file or load a resource over the network. If the condition asserted ever fails in a production environment,\n * the programmer has made a serious mistake.\n *\n * Note that even when assertions are disabled, calls to `assert` remain in the code and their arguments will be evaluated at run-time.\n * Therefore, if your condition or message requires computation, prefer to pass it as a function to prevent it from being evaluated when assertions are disabled.\n *\n * @param condition The condition that is asserted to be `true`. If the condition is more complex than a simple `boolean` variable, pass it as a function to prevent it from being evaluated when assertions are disabled.\n * @param message An optional description of the condition being asserted, to be included in the exception if `condition` is `false`. If the message must be computed, pass it as a function to prevent it from being evaluated when assertions are disabled. Defaults to \"Programmer Error\".\n * @throws Error containing the specified `message` if `condition` is `false`.\n * @public\n */\nexport function assert(condition: boolean | (() => boolean), message?: string | (() => string)): asserts condition {\n if (!assertionsEnabled)\n return;\n\n if (\"boolean\" !== typeof condition)\n condition = condition();\n\n if (condition)\n return;\n\n message = message ?? \"Programmer Error\";\n if (\"string\" !== typeof message)\n message = message();\n\n throw new Error(`Assert: ${message}`);\n}\n"]}
@@ -1,82 +1,82 @@
1
- /** @packageDocumentation
2
- * @module Events
3
- */
4
- /** A function invoked when a BeEvent is raised.
5
- * @public
6
- */
7
- export declare type Listener = (...arg: any[]) => void;
8
- /**
9
- * Manages a set of *listeners* for a particular event and notifies them when the event is raised.
10
- * This class is usually instantiated inside of a container class and
11
- * exposed as a property for others to *subscribe* via [[BeEvent.addListener]].
12
- * @public
13
- */
14
- export declare class BeEvent<T extends Listener> {
15
- private _listeners;
16
- private _insideRaiseEvent;
17
- /** The number of listeners currently subscribed to the event. */
18
- get numberOfListeners(): number;
19
- /**
20
- * Registers a Listener to be executed whenever this event is raised.
21
- * @param listener The function to be executed when the event is raised.
22
- * @param scope An optional object scope to serve as the 'this' pointer when listener is invoked.
23
- * @returns A function that will remove this event listener.
24
- * @see [[BeEvent.raiseEvent]], [[BeEvent.removeListener]]
25
- */
26
- addListener(listener: T, scope?: any): () => void;
27
- /**
28
- * Registers a callback function to be executed *only once* when the event is raised.
29
- * @param listener The function to be executed once when the event is raised.
30
- * @param scope An optional object scope to serve as the `this` pointer in which the listener function will execute.
31
- * @returns A function that will remove this event listener.
32
- * @see [[BeEvent.raiseEvent]], [[BeEvent.removeListener]]
33
- */
34
- addOnce(listener: T, scope?: any): () => void;
35
- /**
36
- * Un-register a previously registered listener.
37
- * @param listener The listener to be unregistered.
38
- * @param scope The scope that was originally passed to addListener.
39
- * @returns 'true' if the listener was removed; 'false' if the listener and scope are not registered with the event.
40
- * @see [[BeEvent.raiseEvent]], [[BeEvent.addListener]]
41
- */
42
- removeListener(listener: T, scope?: any): boolean;
43
- /**
44
- * Raises the event by calling each registered listener with the supplied arguments.
45
- * @param args This method takes any number of parameters and passes them through to the listeners.
46
- * @see [[BeEvent.removeListener]], [[BeEvent.addListener]]
47
- */
48
- raiseEvent(...args: Parameters<T>): void;
49
- /** Determine whether this BeEvent has a specified listener registered.
50
- * @param listener The listener to check.
51
- * @param scope optional scope argument to match call to addListener
52
- */
53
- has(listener: T, scope?: any): boolean;
54
- /** Clear all Listeners from this BeEvent. */
55
- clear(): void;
56
- }
57
- /** Specialization of BeEvent for events that take a single strongly typed argument, primarily used for UI events.
58
- * @public
59
- */
60
- export declare class BeUiEvent<TEventArgs> extends BeEvent<(args: TEventArgs) => void> {
61
- /** Raises event with single strongly typed argument. */
62
- emit(args: TEventArgs): void;
63
- }
64
- /**
65
- * A list of BeEvent objects, accessible by an event name.
66
- * This class may be used instead of explicitly declaring each BeEvent as a member of a containing class.
67
- * @public
68
- */
69
- export declare class BeEventList<T extends Listener> {
70
- private _events;
71
- /**
72
- * Gets the event associated with the specified name, creating the event if it does not already exist.
73
- * @param name The name of the event.
74
- */
75
- get(name: string): BeEvent<T>;
76
- /**
77
- * Removes the event associated with a name.
78
- * @param name The name of the event.
79
- */
80
- remove(name: string): void;
81
- }
1
+ /** @packageDocumentation
2
+ * @module Events
3
+ */
4
+ /** A function invoked when a BeEvent is raised.
5
+ * @public
6
+ */
7
+ export declare type Listener = (...arg: any[]) => void;
8
+ /**
9
+ * Manages a set of *listeners* for a particular event and notifies them when the event is raised.
10
+ * This class is usually instantiated inside of a container class and
11
+ * exposed as a property for others to *subscribe* via [[BeEvent.addListener]].
12
+ * @public
13
+ */
14
+ export declare class BeEvent<T extends Listener> {
15
+ private _listeners;
16
+ private _insideRaiseEvent;
17
+ /** The number of listeners currently subscribed to the event. */
18
+ get numberOfListeners(): number;
19
+ /**
20
+ * Registers a Listener to be executed whenever this event is raised.
21
+ * @param listener The function to be executed when the event is raised.
22
+ * @param scope An optional object scope to serve as the 'this' pointer when listener is invoked.
23
+ * @returns A function that will remove this event listener.
24
+ * @see [[BeEvent.raiseEvent]], [[BeEvent.removeListener]]
25
+ */
26
+ addListener(listener: T, scope?: any): () => void;
27
+ /**
28
+ * Registers a callback function to be executed *only once* when the event is raised.
29
+ * @param listener The function to be executed once when the event is raised.
30
+ * @param scope An optional object scope to serve as the `this` pointer in which the listener function will execute.
31
+ * @returns A function that will remove this event listener.
32
+ * @see [[BeEvent.raiseEvent]], [[BeEvent.removeListener]]
33
+ */
34
+ addOnce(listener: T, scope?: any): () => void;
35
+ /**
36
+ * Un-register a previously registered listener.
37
+ * @param listener The listener to be unregistered.
38
+ * @param scope The scope that was originally passed to addListener.
39
+ * @returns 'true' if the listener was removed; 'false' if the listener and scope are not registered with the event.
40
+ * @see [[BeEvent.raiseEvent]], [[BeEvent.addListener]]
41
+ */
42
+ removeListener(listener: T, scope?: any): boolean;
43
+ /**
44
+ * Raises the event by calling each registered listener with the supplied arguments.
45
+ * @param args This method takes any number of parameters and passes them through to the listeners.
46
+ * @see [[BeEvent.removeListener]], [[BeEvent.addListener]]
47
+ */
48
+ raiseEvent(...args: Parameters<T>): void;
49
+ /** Determine whether this BeEvent has a specified listener registered.
50
+ * @param listener The listener to check.
51
+ * @param scope optional scope argument to match call to addListener
52
+ */
53
+ has(listener: T, scope?: any): boolean;
54
+ /** Clear all Listeners from this BeEvent. */
55
+ clear(): void;
56
+ }
57
+ /** Specialization of BeEvent for events that take a single strongly typed argument, primarily used for UI events.
58
+ * @public
59
+ */
60
+ export declare class BeUiEvent<TEventArgs> extends BeEvent<(args: TEventArgs) => void> {
61
+ /** Raises event with single strongly typed argument. */
62
+ emit(args: TEventArgs): void;
63
+ }
64
+ /**
65
+ * A list of BeEvent objects, accessible by an event name.
66
+ * This class may be used instead of explicitly declaring each BeEvent as a member of a containing class.
67
+ * @public
68
+ */
69
+ export declare class BeEventList<T extends Listener> {
70
+ private _events;
71
+ /**
72
+ * Gets the event associated with the specified name, creating the event if it does not already exist.
73
+ * @param name The name of the event.
74
+ */
75
+ get(name: string): BeEvent<T>;
76
+ /**
77
+ * Removes the event associated with a name.
78
+ * @param name The name of the event.
79
+ */
80
+ remove(name: string): void;
81
+ }
82
82
  //# sourceMappingURL=BeEvent.d.ts.map