@azure/msal-common 14.1.0-alpha.0 → 14.2.0

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 (234) hide show
  1. package/dist/account/AccountInfo.d.ts +31 -32
  2. package/dist/account/AccountInfo.d.ts.map +1 -1
  3. package/dist/account/AuthToken.d.ts +17 -17
  4. package/dist/account/AuthToken.mjs +58 -58
  5. package/dist/account/CcsCredential.d.ts +9 -9
  6. package/dist/account/CcsCredential.mjs +8 -8
  7. package/dist/account/ClientCredentials.d.ts +14 -14
  8. package/dist/account/ClientInfo.d.ts +19 -19
  9. package/dist/account/ClientInfo.mjs +37 -37
  10. package/dist/account/TokenClaims.d.ts +65 -65
  11. package/dist/authority/Authority.d.ts +249 -235
  12. package/dist/authority/Authority.d.ts.map +1 -1
  13. package/dist/authority/Authority.mjs +791 -740
  14. package/dist/authority/Authority.mjs.map +1 -1
  15. package/dist/authority/AuthorityFactory.d.ts +31 -31
  16. package/dist/authority/AuthorityFactory.d.ts.map +1 -1
  17. package/dist/authority/AuthorityFactory.mjs +48 -48
  18. package/dist/authority/AuthorityMetadata.d.ts +646 -623
  19. package/dist/authority/AuthorityMetadata.d.ts.map +1 -1
  20. package/dist/authority/AuthorityMetadata.mjs +941 -885
  21. package/dist/authority/AuthorityMetadata.mjs.map +1 -1
  22. package/dist/authority/AuthorityOptions.d.ts +27 -21
  23. package/dist/authority/AuthorityOptions.d.ts.map +1 -1
  24. package/dist/authority/AuthorityOptions.mjs +18 -18
  25. package/dist/authority/AuthorityOptions.mjs.map +1 -1
  26. package/dist/authority/AuthorityType.d.ts +10 -10
  27. package/dist/authority/AuthorityType.mjs +13 -13
  28. package/dist/authority/AzureRegion.d.ts +1 -1
  29. package/dist/authority/AzureRegionConfiguration.d.ts +5 -5
  30. package/dist/authority/CloudDiscoveryMetadata.d.ts +5 -5
  31. package/dist/authority/CloudInstanceDiscoveryErrorResponse.d.ts +13 -13
  32. package/dist/authority/CloudInstanceDiscoveryErrorResponse.mjs +8 -8
  33. package/dist/authority/CloudInstanceDiscoveryResponse.d.ts +9 -9
  34. package/dist/authority/CloudInstanceDiscoveryResponse.mjs +8 -8
  35. package/dist/authority/ImdsOptions.d.ts +5 -5
  36. package/dist/authority/OIDCOptions.d.ts +8 -8
  37. package/dist/authority/OpenIdConfigResponse.d.ts +11 -11
  38. package/dist/authority/OpenIdConfigResponse.mjs +10 -10
  39. package/dist/authority/ProtocolMode.d.ts +8 -8
  40. package/dist/authority/ProtocolMode.mjs +11 -11
  41. package/dist/authority/RegionDiscovery.d.ts +32 -32
  42. package/dist/authority/RegionDiscovery.mjs +106 -106
  43. package/dist/authority/RegionDiscoveryMetadata.d.ts +6 -6
  44. package/dist/broker/nativeBroker/INativeBrokerPlugin.d.ts +15 -15
  45. package/dist/cache/CacheManager.d.ts +480 -446
  46. package/dist/cache/CacheManager.d.ts.map +1 -1
  47. package/dist/cache/CacheManager.mjs +1086 -998
  48. package/dist/cache/CacheManager.mjs.map +1 -1
  49. package/dist/cache/entities/AccessTokenEntity.d.ts +56 -56
  50. package/dist/cache/entities/AccessTokenEntity.mjs +109 -109
  51. package/dist/cache/entities/AccountEntity.d.ts +101 -101
  52. package/dist/cache/entities/AccountEntity.d.ts.map +1 -1
  53. package/dist/cache/entities/AccountEntity.mjs +218 -220
  54. package/dist/cache/entities/AccountEntity.mjs.map +1 -1
  55. package/dist/cache/entities/AppMetadataEntity.d.ts +39 -39
  56. package/dist/cache/entities/AppMetadataEntity.mjs +66 -66
  57. package/dist/cache/entities/AuthorityMetadataEntity.d.ts +48 -48
  58. package/dist/cache/entities/AuthorityMetadataEntity.mjs +78 -78
  59. package/dist/cache/entities/CacheRecord.d.ts +14 -14
  60. package/dist/cache/entities/CacheRecord.mjs +14 -14
  61. package/dist/cache/entities/CredentialEntity.d.ts +88 -88
  62. package/dist/cache/entities/CredentialEntity.mjs +136 -136
  63. package/dist/cache/entities/IdTokenEntity.d.ts +34 -34
  64. package/dist/cache/entities/IdTokenEntity.mjs +56 -56
  65. package/dist/cache/entities/RefreshTokenEntity.d.ts +36 -36
  66. package/dist/cache/entities/RefreshTokenEntity.mjs +59 -59
  67. package/dist/cache/entities/ServerTelemetryEntity.d.ts +12 -12
  68. package/dist/cache/entities/ServerTelemetryEntity.mjs +27 -27
  69. package/dist/cache/entities/ThrottlingEntity.d.ts +13 -13
  70. package/dist/cache/entities/ThrottlingEntity.mjs +23 -23
  71. package/dist/cache/interface/ICacheManager.d.ts +166 -166
  72. package/dist/cache/interface/ICachePlugin.d.ts +5 -5
  73. package/dist/cache/interface/ISerializableTokenCache.d.ts +4 -4
  74. package/dist/cache/persistence/TokenCacheContext.d.ts +23 -23
  75. package/dist/cache/persistence/TokenCacheContext.mjs +25 -25
  76. package/dist/cache/utils/CacheTypes.d.ts +67 -69
  77. package/dist/cache/utils/CacheTypes.d.ts.map +1 -1
  78. package/dist/client/AuthorizationCodeClient.d.ts +73 -73
  79. package/dist/client/AuthorizationCodeClient.d.ts.map +1 -1
  80. package/dist/client/AuthorizationCodeClient.mjs +408 -407
  81. package/dist/client/AuthorizationCodeClient.mjs.map +1 -1
  82. package/dist/client/BaseClient.d.ts +51 -51
  83. package/dist/client/BaseClient.d.ts.map +1 -1
  84. package/dist/client/BaseClient.mjs +100 -99
  85. package/dist/client/BaseClient.mjs.map +1 -1
  86. package/dist/client/RefreshTokenClient.d.ts +35 -35
  87. package/dist/client/RefreshTokenClient.d.ts.map +1 -1
  88. package/dist/client/RefreshTokenClient.mjs +188 -180
  89. package/dist/client/RefreshTokenClient.mjs.map +1 -1
  90. package/dist/client/SilentFlowClient.d.ts +27 -26
  91. package/dist/client/SilentFlowClient.d.ts.map +1 -1
  92. package/dist/client/SilentFlowClient.mjs +118 -125
  93. package/dist/client/SilentFlowClient.mjs.map +1 -1
  94. package/dist/config/AppTokenProvider.d.ts +38 -38
  95. package/dist/config/ClientConfiguration.d.ts +150 -150
  96. package/dist/config/ClientConfiguration.mjs +97 -97
  97. package/dist/crypto/ICrypto.d.ts +58 -62
  98. package/dist/crypto/ICrypto.d.ts.map +1 -1
  99. package/dist/crypto/ICrypto.mjs +30 -33
  100. package/dist/crypto/ICrypto.mjs.map +1 -1
  101. package/dist/crypto/IGuidGenerator.d.ts +4 -4
  102. package/dist/crypto/JoseHeader.d.ts +22 -22
  103. package/dist/crypto/JoseHeader.mjs +37 -37
  104. package/dist/crypto/PopTokenGenerator.d.ts +60 -60
  105. package/dist/crypto/PopTokenGenerator.mjs +82 -82
  106. package/dist/crypto/SignedHttpRequest.d.ts +11 -11
  107. package/dist/error/AuthError.d.ts +44 -44
  108. package/dist/error/AuthError.mjs +46 -46
  109. package/dist/error/AuthErrorCodes.d.ts +5 -5
  110. package/dist/error/AuthErrorCodes.mjs +9 -9
  111. package/dist/error/ClientAuthError.d.ts +237 -232
  112. package/dist/error/ClientAuthError.d.ts.map +1 -1
  113. package/dist/error/ClientAuthError.mjs +250 -245
  114. package/dist/error/ClientAuthError.mjs.map +1 -1
  115. package/dist/error/ClientAuthErrorCodes.d.ts +44 -43
  116. package/dist/error/ClientAuthErrorCodes.d.ts.map +1 -1
  117. package/dist/error/ClientAuthErrorCodes.mjs +49 -48
  118. package/dist/error/ClientAuthErrorCodes.mjs.map +1 -1
  119. package/dist/error/ClientConfigurationError.d.ts +128 -128
  120. package/dist/error/ClientConfigurationError.mjs +135 -135
  121. package/dist/error/ClientConfigurationErrorCodes.d.ts +22 -22
  122. package/dist/error/ClientConfigurationErrorCodes.mjs +26 -26
  123. package/dist/error/InteractionRequiredAuthError.d.ts +57 -57
  124. package/dist/error/InteractionRequiredAuthError.mjs +76 -76
  125. package/dist/error/InteractionRequiredAuthErrorCodes.d.ts +5 -5
  126. package/dist/error/InteractionRequiredAuthErrorCodes.mjs +11 -11
  127. package/dist/error/JoseHeaderError.d.ts +15 -15
  128. package/dist/error/JoseHeaderError.mjs +22 -22
  129. package/dist/error/JoseHeaderErrorCodes.d.ts +2 -2
  130. package/dist/error/JoseHeaderErrorCodes.mjs +6 -6
  131. package/dist/error/ServerError.d.ts +7 -7
  132. package/dist/error/ServerError.mjs +14 -14
  133. package/dist/index.cjs +8830 -8612
  134. package/dist/index.cjs.map +1 -1
  135. package/dist/index.d.ts +96 -96
  136. package/dist/index.d.ts.map +1 -1
  137. package/dist/index.mjs +2 -2
  138. package/dist/logger/Logger.d.ts +95 -95
  139. package/dist/logger/Logger.mjs +188 -188
  140. package/dist/network/INetworkModule.d.ts +29 -29
  141. package/dist/network/INetworkModule.mjs +12 -12
  142. package/dist/network/NetworkManager.d.ts +33 -33
  143. package/dist/network/NetworkManager.mjs +34 -34
  144. package/dist/network/RequestThumbprint.d.ts +16 -16
  145. package/dist/network/ThrottlingUtils.d.ts +42 -42
  146. package/dist/network/ThrottlingUtils.mjs +95 -95
  147. package/dist/packageMetadata.d.ts +2 -2
  148. package/dist/packageMetadata.mjs +4 -4
  149. package/dist/request/AuthenticationHeaderParser.d.ts +19 -19
  150. package/dist/request/AuthenticationHeaderParser.mjs +55 -55
  151. package/dist/request/BaseAuthRequest.d.ts +40 -40
  152. package/dist/request/CommonAuthorizationCodeRequest.d.ts +27 -27
  153. package/dist/request/CommonAuthorizationUrlRequest.d.ts +50 -50
  154. package/dist/request/CommonClientCredentialRequest.d.ts +17 -17
  155. package/dist/request/CommonDeviceCodeRequest.d.ts +21 -21
  156. package/dist/request/CommonEndSessionRequest.d.ts +21 -21
  157. package/dist/request/CommonOnBehalfOfRequest.d.ts +13 -13
  158. package/dist/request/CommonRefreshTokenRequest.d.ts +22 -19
  159. package/dist/request/CommonRefreshTokenRequest.d.ts.map +1 -1
  160. package/dist/request/CommonSilentFlowRequest.d.ts +20 -18
  161. package/dist/request/CommonSilentFlowRequest.d.ts.map +1 -1
  162. package/dist/request/CommonUsernamePasswordRequest.d.ts +17 -17
  163. package/dist/request/NativeRequest.d.ts +19 -19
  164. package/dist/request/NativeSignOutRequest.d.ts +5 -5
  165. package/dist/request/RequestParameterBuilder.d.ts +217 -217
  166. package/dist/request/RequestParameterBuilder.mjs +381 -381
  167. package/dist/request/RequestValidator.d.ts +33 -33
  168. package/dist/request/RequestValidator.mjs +81 -81
  169. package/dist/request/ScopeSet.d.ts +88 -88
  170. package/dist/request/ScopeSet.mjs +197 -197
  171. package/dist/request/StoreInCache.d.ts +8 -8
  172. package/dist/response/AuthenticationResult.d.ts +41 -41
  173. package/dist/response/AuthorizationCodePayload.d.ts +13 -13
  174. package/dist/response/DeviceCodeResponse.d.ts +25 -25
  175. package/dist/response/ExternalTokenResponse.d.ts +15 -15
  176. package/dist/response/IMDSBadResponse.d.ts +4 -4
  177. package/dist/response/ResponseHandler.d.ts +67 -67
  178. package/dist/response/ResponseHandler.d.ts.map +1 -1
  179. package/dist/response/ResponseHandler.mjs +315 -311
  180. package/dist/response/ResponseHandler.mjs.map +1 -1
  181. package/dist/response/ServerAuthorizationCodeResponse.d.ts +25 -25
  182. package/dist/response/ServerAuthorizationTokenResponse.d.ts +46 -46
  183. package/dist/telemetry/performance/IPerformanceClient.d.ts +51 -51
  184. package/dist/telemetry/performance/IPerformanceMeasurement.d.ts +5 -5
  185. package/dist/telemetry/performance/PerformanceClient.d.ts +191 -191
  186. package/dist/telemetry/performance/PerformanceClient.mjs +409 -409
  187. package/dist/telemetry/performance/PerformanceEvent.d.ts +457 -433
  188. package/dist/telemetry/performance/PerformanceEvent.d.ts.map +1 -1
  189. package/dist/telemetry/performance/PerformanceEvent.mjs +249 -234
  190. package/dist/telemetry/performance/PerformanceEvent.mjs.map +1 -1
  191. package/dist/telemetry/performance/StubPerformanceClient.d.ts +24 -24
  192. package/dist/telemetry/performance/StubPerformanceClient.mjs +76 -76
  193. package/dist/telemetry/server/ServerTelemetryManager.d.ts +66 -66
  194. package/dist/telemetry/server/ServerTelemetryManager.mjs +197 -197
  195. package/dist/telemetry/server/ServerTelemetryRequest.d.ts +8 -8
  196. package/dist/url/IUri.d.ts +12 -12
  197. package/dist/url/UrlString.d.ts +83 -83
  198. package/dist/url/UrlString.mjs +279 -279
  199. package/dist/utils/Constants.d.ts +366 -366
  200. package/dist/utils/Constants.mjs +376 -376
  201. package/dist/utils/FunctionWrappers.d.ts +27 -27
  202. package/dist/utils/FunctionWrappers.d.ts.map +1 -1
  203. package/dist/utils/FunctionWrappers.mjs +84 -85
  204. package/dist/utils/FunctionWrappers.mjs.map +1 -1
  205. package/dist/utils/MsalTypes.d.ts +6 -6
  206. package/dist/utils/ProtocolUtils.d.ts +42 -42
  207. package/dist/utils/ProtocolUtils.mjs +69 -69
  208. package/dist/utils/StringUtils.d.ts +40 -40
  209. package/dist/utils/StringUtils.mjs +95 -95
  210. package/dist/utils/TimeUtils.d.ts +27 -27
  211. package/dist/utils/TimeUtils.mjs +45 -45
  212. package/package.json +1 -1
  213. package/src/account/AccountInfo.ts +0 -1
  214. package/src/authority/Authority.ts +207 -127
  215. package/src/authority/AuthorityFactory.ts +4 -4
  216. package/src/authority/AuthorityMetadata.ts +87 -0
  217. package/src/authority/AuthorityOptions.ts +9 -0
  218. package/src/cache/CacheManager.ts +187 -46
  219. package/src/cache/entities/AccountEntity.ts +0 -3
  220. package/src/cache/utils/CacheTypes.ts +7 -6
  221. package/src/client/AuthorizationCodeClient.ts +12 -3
  222. package/src/client/BaseClient.ts +9 -6
  223. package/src/client/RefreshTokenClient.ts +36 -9
  224. package/src/client/SilentFlowClient.ts +49 -49
  225. package/src/crypto/ICrypto.ts +0 -7
  226. package/src/error/ClientAuthError.ts +8 -0
  227. package/src/error/ClientAuthErrorCodes.ts +1 -0
  228. package/src/index.ts +7 -1
  229. package/src/packageMetadata.ts +1 -1
  230. package/src/request/CommonRefreshTokenRequest.ts +3 -0
  231. package/src/request/CommonSilentFlowRequest.ts +2 -0
  232. package/src/response/ResponseHandler.ts +9 -3
  233. package/src/telemetry/performance/PerformanceEvent.ts +33 -2
  234. package/src/utils/FunctionWrappers.ts +0 -1
@@ -1,205 +1,205 @@
1
- /*! @azure/msal-common v14.1.0-alpha.0 2023-09-20 */
1
+ /*! @azure/msal-common v14.2.0 2023-10-20 */
2
2
  'use strict';
3
3
  import { CacheOutcome, Constants, SERVER_TELEM_CONSTANTS, Separators } from '../../utils/Constants.mjs';
4
4
  import { AuthError } from '../../error/AuthError.mjs';
5
5
  import { ServerTelemetryEntity } from '../../cache/entities/ServerTelemetryEntity.mjs';
6
6
 
7
- /*
8
- * Copyright (c) Microsoft Corporation. All rights reserved.
9
- * Licensed under the MIT License.
10
- */
11
- /** @internal */
12
- class ServerTelemetryManager {
13
- constructor(telemetryRequest, cacheManager) {
14
- this.cacheOutcome = CacheOutcome.NOT_APPLICABLE;
15
- this.cacheManager = cacheManager;
16
- this.apiId = telemetryRequest.apiId;
17
- this.correlationId = telemetryRequest.correlationId;
18
- this.wrapperSKU = telemetryRequest.wrapperSKU || Constants.EMPTY_STRING;
19
- this.wrapperVer = telemetryRequest.wrapperVer || Constants.EMPTY_STRING;
20
- this.telemetryCacheKey =
21
- SERVER_TELEM_CONSTANTS.CACHE_KEY +
22
- Separators.CACHE_KEY_SEPARATOR +
23
- telemetryRequest.clientId;
24
- }
25
- /**
26
- * API to add MSER Telemetry to request
27
- */
28
- generateCurrentRequestHeaderValue() {
29
- const request = `${this.apiId}${SERVER_TELEM_CONSTANTS.VALUE_SEPARATOR}${this.cacheOutcome}`;
30
- const platformFields = [this.wrapperSKU, this.wrapperVer].join(SERVER_TELEM_CONSTANTS.VALUE_SEPARATOR);
31
- const regionDiscoveryFields = this.getRegionDiscoveryFields();
32
- const requestWithRegionDiscoveryFields = [
33
- request,
34
- regionDiscoveryFields,
35
- ].join(SERVER_TELEM_CONSTANTS.VALUE_SEPARATOR);
36
- return [
37
- SERVER_TELEM_CONSTANTS.SCHEMA_VERSION,
38
- requestWithRegionDiscoveryFields,
39
- platformFields,
40
- ].join(SERVER_TELEM_CONSTANTS.CATEGORY_SEPARATOR);
41
- }
42
- /**
43
- * API to add MSER Telemetry for the last failed request
44
- */
45
- generateLastRequestHeaderValue() {
46
- const lastRequests = this.getLastRequests();
47
- const maxErrors = ServerTelemetryManager.maxErrorsToSend(lastRequests);
48
- const failedRequests = lastRequests.failedRequests
49
- .slice(0, 2 * maxErrors)
50
- .join(SERVER_TELEM_CONSTANTS.VALUE_SEPARATOR);
51
- const errors = lastRequests.errors
52
- .slice(0, maxErrors)
53
- .join(SERVER_TELEM_CONSTANTS.VALUE_SEPARATOR);
54
- const errorCount = lastRequests.errors.length;
55
- // Indicate whether this header contains all data or partial data
56
- const overflow = maxErrors < errorCount
57
- ? SERVER_TELEM_CONSTANTS.OVERFLOW_TRUE
58
- : SERVER_TELEM_CONSTANTS.OVERFLOW_FALSE;
59
- const platformFields = [errorCount, overflow].join(SERVER_TELEM_CONSTANTS.VALUE_SEPARATOR);
60
- return [
61
- SERVER_TELEM_CONSTANTS.SCHEMA_VERSION,
62
- lastRequests.cacheHits,
63
- failedRequests,
64
- errors,
65
- platformFields,
66
- ].join(SERVER_TELEM_CONSTANTS.CATEGORY_SEPARATOR);
67
- }
68
- /**
69
- * API to cache token failures for MSER data capture
70
- * @param error
71
- */
72
- cacheFailedRequest(error) {
73
- const lastRequests = this.getLastRequests();
74
- if (lastRequests.errors.length >=
75
- SERVER_TELEM_CONSTANTS.MAX_CACHED_ERRORS) {
76
- // Remove a cached error to make room, first in first out
77
- lastRequests.failedRequests.shift(); // apiId
78
- lastRequests.failedRequests.shift(); // correlationId
79
- lastRequests.errors.shift();
80
- }
81
- lastRequests.failedRequests.push(this.apiId, this.correlationId);
82
- if (error instanceof Error && !!error && error.toString()) {
83
- if (error instanceof AuthError) {
84
- if (error.subError) {
85
- lastRequests.errors.push(error.subError);
86
- }
87
- else if (error.errorCode) {
88
- lastRequests.errors.push(error.errorCode);
89
- }
90
- else {
91
- lastRequests.errors.push(error.toString());
92
- }
93
- }
94
- else {
95
- lastRequests.errors.push(error.toString());
96
- }
97
- }
98
- else {
99
- lastRequests.errors.push(SERVER_TELEM_CONSTANTS.UNKNOWN_ERROR);
100
- }
101
- this.cacheManager.setServerTelemetry(this.telemetryCacheKey, lastRequests);
102
- return;
103
- }
104
- /**
105
- * Update server telemetry cache entry by incrementing cache hit counter
106
- */
107
- incrementCacheHits() {
108
- const lastRequests = this.getLastRequests();
109
- lastRequests.cacheHits += 1;
110
- this.cacheManager.setServerTelemetry(this.telemetryCacheKey, lastRequests);
111
- return lastRequests.cacheHits;
112
- }
113
- /**
114
- * Get the server telemetry entity from cache or initialize a new one
115
- */
116
- getLastRequests() {
117
- const initialValue = new ServerTelemetryEntity();
118
- const lastRequests = this.cacheManager.getServerTelemetry(this.telemetryCacheKey);
119
- return lastRequests || initialValue;
120
- }
121
- /**
122
- * Remove server telemetry cache entry
123
- */
124
- clearTelemetryCache() {
125
- const lastRequests = this.getLastRequests();
126
- const numErrorsFlushed = ServerTelemetryManager.maxErrorsToSend(lastRequests);
127
- const errorCount = lastRequests.errors.length;
128
- if (numErrorsFlushed === errorCount) {
129
- // All errors were sent on last request, clear Telemetry cache
130
- this.cacheManager.removeItem(this.telemetryCacheKey);
131
- }
132
- else {
133
- // Partial data was flushed to server, construct a new telemetry cache item with errors that were not flushed
134
- const serverTelemEntity = new ServerTelemetryEntity();
135
- serverTelemEntity.failedRequests =
136
- lastRequests.failedRequests.slice(numErrorsFlushed * 2); // failedRequests contains 2 items for each error
137
- serverTelemEntity.errors =
138
- lastRequests.errors.slice(numErrorsFlushed);
139
- this.cacheManager.setServerTelemetry(this.telemetryCacheKey, serverTelemEntity);
140
- }
141
- }
142
- /**
143
- * Returns the maximum number of errors that can be flushed to the server in the next network request
144
- * @param serverTelemetryEntity
145
- */
146
- static maxErrorsToSend(serverTelemetryEntity) {
147
- let i;
148
- let maxErrors = 0;
149
- let dataSize = 0;
150
- const errorCount = serverTelemetryEntity.errors.length;
151
- for (i = 0; i < errorCount; i++) {
152
- // failedRequests parameter contains pairs of apiId and correlationId, multiply index by 2 to preserve pairs
153
- const apiId = serverTelemetryEntity.failedRequests[2 * i] ||
154
- Constants.EMPTY_STRING;
155
- const correlationId = serverTelemetryEntity.failedRequests[2 * i + 1] ||
156
- Constants.EMPTY_STRING;
157
- const errorCode = serverTelemetryEntity.errors[i] || Constants.EMPTY_STRING;
158
- // Count number of characters that would be added to header, each character is 1 byte. Add 3 at the end to account for separators
159
- dataSize +=
160
- apiId.toString().length +
161
- correlationId.toString().length +
162
- errorCode.length +
163
- 3;
164
- if (dataSize < SERVER_TELEM_CONSTANTS.MAX_LAST_HEADER_BYTES) {
165
- // Adding this entry to the header would still keep header size below the limit
166
- maxErrors += 1;
167
- }
168
- else {
169
- break;
170
- }
171
- }
172
- return maxErrors;
173
- }
174
- /**
175
- * Get the region discovery fields
176
- *
177
- * @returns string
178
- */
179
- getRegionDiscoveryFields() {
180
- const regionDiscoveryFields = [];
181
- regionDiscoveryFields.push(this.regionUsed || Constants.EMPTY_STRING);
182
- regionDiscoveryFields.push(this.regionSource || Constants.EMPTY_STRING);
183
- regionDiscoveryFields.push(this.regionOutcome || Constants.EMPTY_STRING);
184
- return regionDiscoveryFields.join(",");
185
- }
186
- /**
187
- * Update the region discovery metadata
188
- *
189
- * @param regionDiscoveryMetadata
190
- * @returns void
191
- */
192
- updateRegionDiscoveryMetadata(regionDiscoveryMetadata) {
193
- this.regionUsed = regionDiscoveryMetadata.region_used;
194
- this.regionSource = regionDiscoveryMetadata.region_source;
195
- this.regionOutcome = regionDiscoveryMetadata.region_outcome;
196
- }
197
- /**
198
- * Set cache outcome
199
- */
200
- setCacheOutcome(cacheOutcome) {
201
- this.cacheOutcome = cacheOutcome;
202
- }
7
+ /*
8
+ * Copyright (c) Microsoft Corporation. All rights reserved.
9
+ * Licensed under the MIT License.
10
+ */
11
+ /** @internal */
12
+ class ServerTelemetryManager {
13
+ constructor(telemetryRequest, cacheManager) {
14
+ this.cacheOutcome = CacheOutcome.NOT_APPLICABLE;
15
+ this.cacheManager = cacheManager;
16
+ this.apiId = telemetryRequest.apiId;
17
+ this.correlationId = telemetryRequest.correlationId;
18
+ this.wrapperSKU = telemetryRequest.wrapperSKU || Constants.EMPTY_STRING;
19
+ this.wrapperVer = telemetryRequest.wrapperVer || Constants.EMPTY_STRING;
20
+ this.telemetryCacheKey =
21
+ SERVER_TELEM_CONSTANTS.CACHE_KEY +
22
+ Separators.CACHE_KEY_SEPARATOR +
23
+ telemetryRequest.clientId;
24
+ }
25
+ /**
26
+ * API to add MSER Telemetry to request
27
+ */
28
+ generateCurrentRequestHeaderValue() {
29
+ const request = `${this.apiId}${SERVER_TELEM_CONSTANTS.VALUE_SEPARATOR}${this.cacheOutcome}`;
30
+ const platformFields = [this.wrapperSKU, this.wrapperVer].join(SERVER_TELEM_CONSTANTS.VALUE_SEPARATOR);
31
+ const regionDiscoveryFields = this.getRegionDiscoveryFields();
32
+ const requestWithRegionDiscoveryFields = [
33
+ request,
34
+ regionDiscoveryFields,
35
+ ].join(SERVER_TELEM_CONSTANTS.VALUE_SEPARATOR);
36
+ return [
37
+ SERVER_TELEM_CONSTANTS.SCHEMA_VERSION,
38
+ requestWithRegionDiscoveryFields,
39
+ platformFields,
40
+ ].join(SERVER_TELEM_CONSTANTS.CATEGORY_SEPARATOR);
41
+ }
42
+ /**
43
+ * API to add MSER Telemetry for the last failed request
44
+ */
45
+ generateLastRequestHeaderValue() {
46
+ const lastRequests = this.getLastRequests();
47
+ const maxErrors = ServerTelemetryManager.maxErrorsToSend(lastRequests);
48
+ const failedRequests = lastRequests.failedRequests
49
+ .slice(0, 2 * maxErrors)
50
+ .join(SERVER_TELEM_CONSTANTS.VALUE_SEPARATOR);
51
+ const errors = lastRequests.errors
52
+ .slice(0, maxErrors)
53
+ .join(SERVER_TELEM_CONSTANTS.VALUE_SEPARATOR);
54
+ const errorCount = lastRequests.errors.length;
55
+ // Indicate whether this header contains all data or partial data
56
+ const overflow = maxErrors < errorCount
57
+ ? SERVER_TELEM_CONSTANTS.OVERFLOW_TRUE
58
+ : SERVER_TELEM_CONSTANTS.OVERFLOW_FALSE;
59
+ const platformFields = [errorCount, overflow].join(SERVER_TELEM_CONSTANTS.VALUE_SEPARATOR);
60
+ return [
61
+ SERVER_TELEM_CONSTANTS.SCHEMA_VERSION,
62
+ lastRequests.cacheHits,
63
+ failedRequests,
64
+ errors,
65
+ platformFields,
66
+ ].join(SERVER_TELEM_CONSTANTS.CATEGORY_SEPARATOR);
67
+ }
68
+ /**
69
+ * API to cache token failures for MSER data capture
70
+ * @param error
71
+ */
72
+ cacheFailedRequest(error) {
73
+ const lastRequests = this.getLastRequests();
74
+ if (lastRequests.errors.length >=
75
+ SERVER_TELEM_CONSTANTS.MAX_CACHED_ERRORS) {
76
+ // Remove a cached error to make room, first in first out
77
+ lastRequests.failedRequests.shift(); // apiId
78
+ lastRequests.failedRequests.shift(); // correlationId
79
+ lastRequests.errors.shift();
80
+ }
81
+ lastRequests.failedRequests.push(this.apiId, this.correlationId);
82
+ if (error instanceof Error && !!error && error.toString()) {
83
+ if (error instanceof AuthError) {
84
+ if (error.subError) {
85
+ lastRequests.errors.push(error.subError);
86
+ }
87
+ else if (error.errorCode) {
88
+ lastRequests.errors.push(error.errorCode);
89
+ }
90
+ else {
91
+ lastRequests.errors.push(error.toString());
92
+ }
93
+ }
94
+ else {
95
+ lastRequests.errors.push(error.toString());
96
+ }
97
+ }
98
+ else {
99
+ lastRequests.errors.push(SERVER_TELEM_CONSTANTS.UNKNOWN_ERROR);
100
+ }
101
+ this.cacheManager.setServerTelemetry(this.telemetryCacheKey, lastRequests);
102
+ return;
103
+ }
104
+ /**
105
+ * Update server telemetry cache entry by incrementing cache hit counter
106
+ */
107
+ incrementCacheHits() {
108
+ const lastRequests = this.getLastRequests();
109
+ lastRequests.cacheHits += 1;
110
+ this.cacheManager.setServerTelemetry(this.telemetryCacheKey, lastRequests);
111
+ return lastRequests.cacheHits;
112
+ }
113
+ /**
114
+ * Get the server telemetry entity from cache or initialize a new one
115
+ */
116
+ getLastRequests() {
117
+ const initialValue = new ServerTelemetryEntity();
118
+ const lastRequests = this.cacheManager.getServerTelemetry(this.telemetryCacheKey);
119
+ return lastRequests || initialValue;
120
+ }
121
+ /**
122
+ * Remove server telemetry cache entry
123
+ */
124
+ clearTelemetryCache() {
125
+ const lastRequests = this.getLastRequests();
126
+ const numErrorsFlushed = ServerTelemetryManager.maxErrorsToSend(lastRequests);
127
+ const errorCount = lastRequests.errors.length;
128
+ if (numErrorsFlushed === errorCount) {
129
+ // All errors were sent on last request, clear Telemetry cache
130
+ this.cacheManager.removeItem(this.telemetryCacheKey);
131
+ }
132
+ else {
133
+ // Partial data was flushed to server, construct a new telemetry cache item with errors that were not flushed
134
+ const serverTelemEntity = new ServerTelemetryEntity();
135
+ serverTelemEntity.failedRequests =
136
+ lastRequests.failedRequests.slice(numErrorsFlushed * 2); // failedRequests contains 2 items for each error
137
+ serverTelemEntity.errors =
138
+ lastRequests.errors.slice(numErrorsFlushed);
139
+ this.cacheManager.setServerTelemetry(this.telemetryCacheKey, serverTelemEntity);
140
+ }
141
+ }
142
+ /**
143
+ * Returns the maximum number of errors that can be flushed to the server in the next network request
144
+ * @param serverTelemetryEntity
145
+ */
146
+ static maxErrorsToSend(serverTelemetryEntity) {
147
+ let i;
148
+ let maxErrors = 0;
149
+ let dataSize = 0;
150
+ const errorCount = serverTelemetryEntity.errors.length;
151
+ for (i = 0; i < errorCount; i++) {
152
+ // failedRequests parameter contains pairs of apiId and correlationId, multiply index by 2 to preserve pairs
153
+ const apiId = serverTelemetryEntity.failedRequests[2 * i] ||
154
+ Constants.EMPTY_STRING;
155
+ const correlationId = serverTelemetryEntity.failedRequests[2 * i + 1] ||
156
+ Constants.EMPTY_STRING;
157
+ const errorCode = serverTelemetryEntity.errors[i] || Constants.EMPTY_STRING;
158
+ // Count number of characters that would be added to header, each character is 1 byte. Add 3 at the end to account for separators
159
+ dataSize +=
160
+ apiId.toString().length +
161
+ correlationId.toString().length +
162
+ errorCode.length +
163
+ 3;
164
+ if (dataSize < SERVER_TELEM_CONSTANTS.MAX_LAST_HEADER_BYTES) {
165
+ // Adding this entry to the header would still keep header size below the limit
166
+ maxErrors += 1;
167
+ }
168
+ else {
169
+ break;
170
+ }
171
+ }
172
+ return maxErrors;
173
+ }
174
+ /**
175
+ * Get the region discovery fields
176
+ *
177
+ * @returns string
178
+ */
179
+ getRegionDiscoveryFields() {
180
+ const regionDiscoveryFields = [];
181
+ regionDiscoveryFields.push(this.regionUsed || Constants.EMPTY_STRING);
182
+ regionDiscoveryFields.push(this.regionSource || Constants.EMPTY_STRING);
183
+ regionDiscoveryFields.push(this.regionOutcome || Constants.EMPTY_STRING);
184
+ return regionDiscoveryFields.join(",");
185
+ }
186
+ /**
187
+ * Update the region discovery metadata
188
+ *
189
+ * @param regionDiscoveryMetadata
190
+ * @returns void
191
+ */
192
+ updateRegionDiscoveryMetadata(regionDiscoveryMetadata) {
193
+ this.regionUsed = regionDiscoveryMetadata.region_used;
194
+ this.regionSource = regionDiscoveryMetadata.region_source;
195
+ this.regionOutcome = regionDiscoveryMetadata.region_outcome;
196
+ }
197
+ /**
198
+ * Set cache outcome
199
+ */
200
+ setCacheOutcome(cacheOutcome) {
201
+ this.cacheOutcome = cacheOutcome;
202
+ }
203
203
  }
204
204
 
205
205
  export { ServerTelemetryManager };
@@ -1,9 +1,9 @@
1
- export type ServerTelemetryRequest = {
2
- clientId: string;
3
- apiId: number;
4
- correlationId: string;
5
- forceRefresh?: boolean;
6
- wrapperSKU?: string;
7
- wrapperVer?: string;
8
- };
1
+ export type ServerTelemetryRequest = {
2
+ clientId: string;
3
+ apiId: number;
4
+ correlationId: string;
5
+ forceRefresh?: boolean;
6
+ wrapperSKU?: string;
7
+ wrapperVer?: string;
8
+ };
9
9
  //# sourceMappingURL=ServerTelemetryRequest.d.ts.map
@@ -1,13 +1,13 @@
1
- /**
2
- * Interface which describes URI components.
3
- */
4
- export interface IUri {
5
- Protocol: string;
6
- HostNameAndPort: string;
7
- AbsolutePath: string;
8
- Search: string;
9
- Hash: string;
10
- PathSegments: string[];
11
- QueryString: string;
12
- }
1
+ /**
2
+ * Interface which describes URI components.
3
+ */
4
+ export interface IUri {
5
+ Protocol: string;
6
+ HostNameAndPort: string;
7
+ AbsolutePath: string;
8
+ Search: string;
9
+ Hash: string;
10
+ PathSegments: string[];
11
+ QueryString: string;
12
+ }
13
13
  //# sourceMappingURL=IUri.d.ts.map
@@ -1,84 +1,84 @@
1
- import { ServerAuthorizationCodeResponse } from "../response/ServerAuthorizationCodeResponse";
2
- import { IUri } from "./IUri";
3
- import { ServerResponseType } from "../utils/Constants";
4
- /**
5
- * Url object class which can perform various transformations on url strings.
6
- */
7
- export declare class UrlString {
8
- private _urlString;
9
- get urlString(): string;
10
- constructor(url: string);
11
- /**
12
- * Ensure urls are lower case and end with a / character.
13
- * @param url
14
- */
15
- static canonicalizeUri(url: string): string;
16
- /**
17
- * Throws if urlString passed is not a valid authority URI string.
18
- */
19
- validateAsUri(): void;
20
- /**
21
- * Given a url and a query string return the url with provided query string appended
22
- * @param url
23
- * @param queryString
24
- */
25
- static appendQueryString(url: string, queryString: string): string;
26
- /**
27
- * Returns a url with the hash removed
28
- * @param url
29
- */
30
- static removeHashFromUrl(url: string): string;
31
- /**
32
- * Given a url like https://a:b/common/d?e=f#g, and a tenantId, returns https://a:b/tenantId/d
33
- * @param href The url
34
- * @param tenantId The tenant id to replace
35
- */
36
- replaceTenantPath(tenantId: string): UrlString;
37
- /**
38
- * Returns the anchor part(#) of the URL
39
- */
40
- getHash(): string;
41
- /**
42
- * Parses out the components from a url string.
43
- * @returns An object with the various components. Please cache this value insted of calling this multiple times on the same url.
44
- */
45
- getUrlComponents(): IUri;
46
- static getDomainFromUrl(url: string): string;
47
- static getAbsoluteUrl(relativeUrl: string, baseUrl: string): string;
48
- /**
49
- * Parses hash string from given string. Returns empty string if no hash symbol is found.
50
- * @param hashString
51
- */
52
- static parseHash(hashString: string): string;
53
- /**
54
- * Parses query string from given string. Returns empty string if no query symbol is found.
55
- * @param queryString
56
- */
57
- static parseQueryString(queryString: string): string;
58
- /**
59
- * Parses query server response string from given string.
60
- * Extract hash between '?code=' and '#' if trailing '# is present.
61
- * Returns empty string if no query symbol is found.
62
- * @param queryString
63
- */
64
- static parseQueryServerResponse(queryString: string): string;
65
- static constructAuthorityUriFromObject(urlObject: IUri): UrlString;
66
- /**
67
- * Returns URL hash as server auth code response object.
68
- */
69
- static getDeserializedHash(hash: string): ServerAuthorizationCodeResponse;
70
- /**
71
- * Returns URL query string as server auth code response object.
72
- */
73
- static getDeserializedQueryString(query: string): ServerAuthorizationCodeResponse;
74
- /**
75
- * Returns either deserialized query string or deserialized hash, depending on the serverResponseType
76
- * as a server auth code response object.
77
- */
78
- static getDeserializedCodeResponse(serverResponseType: ServerResponseType | undefined, hashFragment: string): ServerAuthorizationCodeResponse;
79
- /**
80
- * Check if the hash of the URL string contains known properties
81
- */
82
- static hashContainsKnownProperties(hash: string): boolean;
83
- }
1
+ import { ServerAuthorizationCodeResponse } from "../response/ServerAuthorizationCodeResponse";
2
+ import { IUri } from "./IUri";
3
+ import { ServerResponseType } from "../utils/Constants";
4
+ /**
5
+ * Url object class which can perform various transformations on url strings.
6
+ */
7
+ export declare class UrlString {
8
+ private _urlString;
9
+ get urlString(): string;
10
+ constructor(url: string);
11
+ /**
12
+ * Ensure urls are lower case and end with a / character.
13
+ * @param url
14
+ */
15
+ static canonicalizeUri(url: string): string;
16
+ /**
17
+ * Throws if urlString passed is not a valid authority URI string.
18
+ */
19
+ validateAsUri(): void;
20
+ /**
21
+ * Given a url and a query string return the url with provided query string appended
22
+ * @param url
23
+ * @param queryString
24
+ */
25
+ static appendQueryString(url: string, queryString: string): string;
26
+ /**
27
+ * Returns a url with the hash removed
28
+ * @param url
29
+ */
30
+ static removeHashFromUrl(url: string): string;
31
+ /**
32
+ * Given a url like https://a:b/common/d?e=f#g, and a tenantId, returns https://a:b/tenantId/d
33
+ * @param href The url
34
+ * @param tenantId The tenant id to replace
35
+ */
36
+ replaceTenantPath(tenantId: string): UrlString;
37
+ /**
38
+ * Returns the anchor part(#) of the URL
39
+ */
40
+ getHash(): string;
41
+ /**
42
+ * Parses out the components from a url string.
43
+ * @returns An object with the various components. Please cache this value insted of calling this multiple times on the same url.
44
+ */
45
+ getUrlComponents(): IUri;
46
+ static getDomainFromUrl(url: string): string;
47
+ static getAbsoluteUrl(relativeUrl: string, baseUrl: string): string;
48
+ /**
49
+ * Parses hash string from given string. Returns empty string if no hash symbol is found.
50
+ * @param hashString
51
+ */
52
+ static parseHash(hashString: string): string;
53
+ /**
54
+ * Parses query string from given string. Returns empty string if no query symbol is found.
55
+ * @param queryString
56
+ */
57
+ static parseQueryString(queryString: string): string;
58
+ /**
59
+ * Parses query server response string from given string.
60
+ * Extract hash between '?code=' and '#' if trailing '# is present.
61
+ * Returns empty string if no query symbol is found.
62
+ * @param queryString
63
+ */
64
+ static parseQueryServerResponse(queryString: string): string;
65
+ static constructAuthorityUriFromObject(urlObject: IUri): UrlString;
66
+ /**
67
+ * Returns URL hash as server auth code response object.
68
+ */
69
+ static getDeserializedHash(hash: string): ServerAuthorizationCodeResponse;
70
+ /**
71
+ * Returns URL query string as server auth code response object.
72
+ */
73
+ static getDeserializedQueryString(query: string): ServerAuthorizationCodeResponse;
74
+ /**
75
+ * Returns either deserialized query string or deserialized hash, depending on the serverResponseType
76
+ * as a server auth code response object.
77
+ */
78
+ static getDeserializedCodeResponse(serverResponseType: ServerResponseType | undefined, hashFragment: string): ServerAuthorizationCodeResponse;
79
+ /**
80
+ * Check if the hash of the URL string contains known properties
81
+ */
82
+ static hashContainsKnownProperties(hash: string): boolean;
83
+ }
84
84
  //# sourceMappingURL=UrlString.d.ts.map