@azure/msal-common 14.6.0-alpha.0 → 14.6.1

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