@azure/msal-common 14.5.0 → 14.6.0-alpha.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 +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 +254 -253
  13. package/dist/authority/Authority.d.ts.map +1 -1
  14. package/dist/authority/Authority.mjs +815 -811
  15. package/dist/authority/Authority.mjs.map +1 -1
  16. package/dist/authority/AuthorityFactory.d.ts +31 -31
  17. package/dist/authority/AuthorityFactory.mjs +47 -47
  18. package/dist/authority/AuthorityMetadata.d.ts +503 -503
  19. package/dist/authority/AuthorityMetadata.mjs +603 -603
  20. package/dist/authority/AuthorityOptions.d.ts +27 -27
  21. package/dist/authority/AuthorityOptions.mjs +18 -18
  22. package/dist/authority/AuthorityType.d.ts +10 -10
  23. package/dist/authority/AuthorityType.mjs +13 -13
  24. package/dist/authority/AzureRegion.d.ts +1 -1
  25. package/dist/authority/AzureRegionConfiguration.d.ts +5 -5
  26. package/dist/authority/CloudDiscoveryMetadata.d.ts +5 -5
  27. package/dist/authority/CloudInstanceDiscoveryErrorResponse.d.ts +13 -13
  28. package/dist/authority/CloudInstanceDiscoveryErrorResponse.mjs +8 -8
  29. package/dist/authority/CloudInstanceDiscoveryResponse.d.ts +9 -9
  30. package/dist/authority/CloudInstanceDiscoveryResponse.mjs +8 -8
  31. package/dist/authority/ImdsOptions.d.ts +5 -5
  32. package/dist/authority/OIDCOptions.d.ts +8 -8
  33. package/dist/authority/OpenIdConfigResponse.d.ts +11 -11
  34. package/dist/authority/OpenIdConfigResponse.mjs +10 -10
  35. package/dist/authority/ProtocolMode.d.ts +8 -8
  36. package/dist/authority/ProtocolMode.mjs +11 -11
  37. package/dist/authority/RegionDiscovery.d.ts +32 -32
  38. package/dist/authority/RegionDiscovery.mjs +106 -106
  39. package/dist/authority/RegionDiscoveryMetadata.d.ts +6 -6
  40. package/dist/broker/nativeBroker/INativeBrokerPlugin.d.ts +15 -15
  41. package/dist/cache/CacheManager.d.ts +508 -517
  42. package/dist/cache/CacheManager.d.ts.map +1 -1
  43. package/dist/cache/CacheManager.mjs +1237 -1263
  44. package/dist/cache/CacheManager.mjs.map +1 -1
  45. package/dist/cache/entities/AccessTokenEntity.d.ts +25 -25
  46. package/dist/cache/entities/AccountEntity.d.ts +106 -106
  47. package/dist/cache/entities/AccountEntity.mjs +244 -244
  48. package/dist/cache/entities/AppMetadataEntity.d.ts +39 -39
  49. package/dist/cache/entities/AppMetadataEntity.mjs +66 -66
  50. package/dist/cache/entities/AuthorityMetadataEntity.d.ts +48 -48
  51. package/dist/cache/entities/AuthorityMetadataEntity.mjs +78 -78
  52. package/dist/cache/entities/CacheRecord.d.ts +14 -14
  53. package/dist/cache/entities/CacheRecord.mjs +14 -14
  54. package/dist/cache/entities/CredentialEntity.d.ts +30 -30
  55. package/dist/cache/entities/IdTokenEntity.d.ts +8 -8
  56. package/dist/cache/entities/RefreshTokenEntity.d.ts +7 -5
  57. package/dist/cache/entities/RefreshTokenEntity.d.ts.map +1 -1
  58. package/dist/cache/entities/ServerTelemetryEntity.d.ts +5 -5
  59. package/dist/cache/entities/ThrottlingEntity.d.ts +7 -13
  60. package/dist/cache/entities/ThrottlingEntity.d.ts.map +1 -1
  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 +70 -64
  67. package/dist/cache/utils/CacheHelpers.d.ts.map +1 -1
  68. package/dist/cache/utils/CacheHelpers.mjs +252 -233
  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.mjs +100 -100
  75. package/dist/client/RefreshTokenClient.d.ts +35 -35
  76. package/dist/client/RefreshTokenClient.d.ts.map +1 -1
  77. package/dist/client/RefreshTokenClient.mjs +206 -187
  78. package/dist/client/RefreshTokenClient.mjs.map +1 -1
  79. package/dist/client/SilentFlowClient.d.ts +27 -27
  80. package/dist/client/SilentFlowClient.d.ts.map +1 -1
  81. package/dist/client/SilentFlowClient.mjs +129 -118
  82. package/dist/client/SilentFlowClient.mjs.map +1 -1
  83. package/dist/config/AppTokenProvider.d.ts +38 -38
  84. package/dist/config/ClientConfiguration.d.ts +150 -150
  85. package/dist/config/ClientConfiguration.d.ts.map +1 -1
  86. package/dist/config/ClientConfiguration.mjs +96 -98
  87. package/dist/config/ClientConfiguration.mjs.map +1 -1
  88. package/dist/constants/AADServerParamKeys.d.ts +52 -51
  89. package/dist/constants/AADServerParamKeys.d.ts.map +1 -1
  90. package/dist/constants/AADServerParamKeys.mjs +57 -56
  91. package/dist/constants/AADServerParamKeys.mjs.map +1 -1
  92. package/dist/crypto/ICrypto.d.ts +58 -58
  93. package/dist/crypto/ICrypto.mjs +30 -30
  94. package/dist/crypto/IGuidGenerator.d.ts +4 -4
  95. package/dist/crypto/JoseHeader.d.ts +22 -22
  96. package/dist/crypto/JoseHeader.mjs +37 -37
  97. package/dist/crypto/PopTokenGenerator.d.ts +60 -60
  98. package/dist/crypto/PopTokenGenerator.mjs +82 -82
  99. package/dist/crypto/SignedHttpRequest.d.ts +15 -15
  100. package/dist/error/AuthError.d.ts +44 -44
  101. package/dist/error/AuthError.mjs +46 -46
  102. package/dist/error/AuthErrorCodes.d.ts +5 -5
  103. package/dist/error/AuthErrorCodes.mjs +9 -9
  104. package/dist/error/ClientAuthError.d.ts +237 -237
  105. package/dist/error/ClientAuthError.mjs +249 -249
  106. package/dist/error/ClientAuthErrorCodes.d.ts +44 -44
  107. package/dist/error/ClientAuthErrorCodes.mjs +48 -48
  108. package/dist/error/ClientConfigurationError.d.ts +128 -128
  109. package/dist/error/ClientConfigurationError.mjs +135 -135
  110. package/dist/error/ClientConfigurationErrorCodes.d.ts +22 -22
  111. package/dist/error/ClientConfigurationErrorCodes.mjs +26 -26
  112. package/dist/error/InteractionRequiredAuthError.d.ts +61 -57
  113. package/dist/error/InteractionRequiredAuthError.d.ts.map +1 -1
  114. package/dist/error/InteractionRequiredAuthError.mjs +85 -77
  115. package/dist/error/InteractionRequiredAuthError.mjs.map +1 -1
  116. package/dist/error/InteractionRequiredAuthErrorCodes.d.ts +7 -5
  117. package/dist/error/InteractionRequiredAuthErrorCodes.d.ts.map +1 -1
  118. package/dist/error/InteractionRequiredAuthErrorCodes.mjs +15 -13
  119. package/dist/error/InteractionRequiredAuthErrorCodes.mjs.map +1 -1
  120. package/dist/error/JoseHeaderError.d.ts +15 -15
  121. package/dist/error/JoseHeaderError.mjs +22 -22
  122. package/dist/error/JoseHeaderErrorCodes.d.ts +2 -2
  123. package/dist/error/JoseHeaderErrorCodes.mjs +6 -6
  124. package/dist/error/ServerError.d.ts +7 -7
  125. package/dist/error/ServerError.mjs +14 -14
  126. package/dist/index.cjs +8628 -8597
  127. package/dist/index.cjs.map +1 -1
  128. package/dist/index.d.ts +99 -99
  129. package/dist/index.d.ts.map +1 -1
  130. package/dist/index.mjs +2 -3
  131. package/dist/index.mjs.map +1 -1
  132. package/dist/logger/Logger.d.ts +95 -95
  133. package/dist/logger/Logger.mjs +188 -188
  134. package/dist/network/INetworkModule.d.ts +29 -29
  135. package/dist/network/INetworkModule.mjs +12 -12
  136. package/dist/network/NetworkManager.d.ts +33 -33
  137. package/dist/network/NetworkManager.mjs +34 -34
  138. package/dist/network/RequestThumbprint.d.ts +18 -18
  139. package/dist/network/ThrottlingUtils.d.ts +42 -42
  140. package/dist/network/ThrottlingUtils.mjs +95 -95
  141. package/dist/packageMetadata.d.ts +2 -2
  142. package/dist/packageMetadata.d.ts.map +1 -1
  143. package/dist/packageMetadata.mjs +4 -4
  144. package/dist/request/AuthenticationHeaderParser.d.ts +19 -19
  145. package/dist/request/AuthenticationHeaderParser.mjs +55 -55
  146. package/dist/request/BaseAuthRequest.d.ts +43 -43
  147. package/dist/request/CommonAuthorizationCodeRequest.d.ts +27 -27
  148. package/dist/request/CommonAuthorizationUrlRequest.d.ts +50 -50
  149. package/dist/request/CommonClientCredentialRequest.d.ts +17 -17
  150. package/dist/request/CommonDeviceCodeRequest.d.ts +21 -21
  151. package/dist/request/CommonEndSessionRequest.d.ts +21 -21
  152. package/dist/request/CommonOnBehalfOfRequest.d.ts +13 -13
  153. package/dist/request/CommonRefreshTokenRequest.d.ts +22 -22
  154. package/dist/request/CommonSilentFlowRequest.d.ts +27 -20
  155. package/dist/request/CommonSilentFlowRequest.d.ts.map +1 -1
  156. package/dist/request/CommonUsernamePasswordRequest.d.ts +17 -17
  157. package/dist/request/NativeRequest.d.ts +19 -19
  158. package/dist/request/NativeSignOutRequest.d.ts +5 -5
  159. package/dist/request/RequestParameterBuilder.d.ts +217 -217
  160. package/dist/request/RequestParameterBuilder.mjs +381 -381
  161. package/dist/request/RequestValidator.d.ts +33 -33
  162. package/dist/request/RequestValidator.mjs +81 -81
  163. package/dist/request/ScopeSet.d.ts +88 -88
  164. package/dist/request/ScopeSet.mjs +197 -197
  165. package/dist/request/StoreInCache.d.ts +8 -8
  166. package/dist/response/AuthenticationResult.d.ts +41 -41
  167. package/dist/response/AuthorizationCodePayload.d.ts +13 -13
  168. package/dist/response/DeviceCodeResponse.d.ts +25 -25
  169. package/dist/response/ExternalTokenResponse.d.ts +15 -15
  170. package/dist/response/IMDSBadResponse.d.ts +4 -4
  171. package/dist/response/ResponseHandler.d.ts +69 -69
  172. package/dist/response/ResponseHandler.d.ts.map +1 -1
  173. package/dist/response/ResponseHandler.mjs +346 -336
  174. package/dist/response/ResponseHandler.mjs.map +1 -1
  175. package/dist/response/ServerAuthorizationCodeResponse.d.ts +25 -25
  176. package/dist/response/ServerAuthorizationTokenResponse.d.ts +47 -46
  177. package/dist/response/ServerAuthorizationTokenResponse.d.ts.map +1 -1
  178. package/dist/telemetry/performance/IPerformanceClient.d.ts +57 -51
  179. package/dist/telemetry/performance/IPerformanceClient.d.ts.map +1 -1
  180. package/dist/telemetry/performance/IPerformanceMeasurement.d.ts +5 -5
  181. package/dist/telemetry/performance/PerformanceClient.d.ts +198 -191
  182. package/dist/telemetry/performance/PerformanceClient.d.ts.map +1 -1
  183. package/dist/telemetry/performance/PerformanceClient.mjs +413 -409
  184. package/dist/telemetry/performance/PerformanceClient.mjs.map +1 -1
  185. package/dist/telemetry/performance/PerformanceEvent.d.ts +464 -464
  186. package/dist/telemetry/performance/PerformanceEvent.mjs +253 -253
  187. package/dist/telemetry/performance/StubPerformanceClient.d.ts +24 -24
  188. package/dist/telemetry/performance/StubPerformanceClient.d.ts.map +1 -1
  189. package/dist/telemetry/performance/StubPerformanceClient.mjs +76 -76
  190. package/dist/telemetry/performance/StubPerformanceClient.mjs.map +1 -1
  191. package/dist/telemetry/server/ServerTelemetryManager.d.ts +66 -66
  192. package/dist/telemetry/server/ServerTelemetryManager.mjs +201 -201
  193. package/dist/telemetry/server/ServerTelemetryRequest.d.ts +8 -8
  194. package/dist/url/IUri.d.ts +12 -12
  195. package/dist/url/UrlString.d.ts +48 -48
  196. package/dist/url/UrlString.mjs +161 -161
  197. package/dist/utils/Constants.d.ts +298 -296
  198. package/dist/utils/Constants.d.ts.map +1 -1
  199. package/dist/utils/Constants.mjs +313 -310
  200. package/dist/utils/Constants.mjs.map +1 -1
  201. package/dist/utils/FunctionWrappers.d.ts +27 -27
  202. package/dist/utils/FunctionWrappers.mjs +84 -84
  203. package/dist/utils/MsalTypes.d.ts +6 -6
  204. package/dist/utils/ProtocolUtils.d.ts +42 -42
  205. package/dist/utils/ProtocolUtils.mjs +69 -69
  206. package/dist/utils/StringUtils.d.ts +40 -40
  207. package/dist/utils/StringUtils.mjs +95 -95
  208. package/dist/utils/TimeUtils.d.ts +27 -27
  209. package/dist/utils/TimeUtils.mjs +45 -45
  210. package/dist/utils/UrlUtils.d.ts +10 -10
  211. package/dist/utils/UrlUtils.mjs +44 -44
  212. package/package.json +1 -1
  213. package/src/authority/Authority.ts +9 -3
  214. package/src/cache/CacheManager.ts +0 -54
  215. package/src/cache/entities/RefreshTokenEntity.ts +3 -1
  216. package/src/cache/entities/ThrottlingEntity.ts +2 -24
  217. package/src/cache/utils/CacheHelpers.ts +26 -1
  218. package/src/client/RefreshTokenClient.ts +40 -7
  219. package/src/client/SilentFlowClient.ts +30 -10
  220. package/src/config/ClientConfiguration.ts +4 -4
  221. package/src/constants/AADServerParamKeys.ts +1 -0
  222. package/src/error/InteractionRequiredAuthError.ts +12 -0
  223. package/src/error/InteractionRequiredAuthErrorCodes.ts +2 -0
  224. package/src/index.ts +1 -0
  225. package/src/packageMetadata.ts +1 -1
  226. package/src/request/CommonSilentFlowRequest.ts +7 -0
  227. package/src/response/ResponseHandler.ts +21 -5
  228. package/src/response/ServerAuthorizationTokenResponse.ts +1 -0
  229. package/src/telemetry/performance/IPerformanceClient.ts +6 -0
  230. package/src/telemetry/performance/PerformanceClient.ts +24 -31
  231. package/src/telemetry/performance/StubPerformanceClient.ts +0 -1
  232. package/src/utils/Constants.ts +4 -0
  233. package/dist/cache/entities/ThrottlingEntity.mjs +0 -30
  234. package/dist/cache/entities/ThrottlingEntity.mjs.map +0 -1
@@ -1,4 +1,4 @@
1
- /*! @azure/msal-common v14.5.0 2023-12-01 */
1
+ /*! @azure/msal-common v14.6.0-alpha.0 2023-12-15 */
2
2
  'use strict';
3
3
  import { createClientConfigurationError } from '../error/ClientConfigurationError.mjs';
4
4
  import { StringUtils } from '../utils/StringUtils.mjs';
@@ -6,166 +6,166 @@ import { AADAuthorityConstants, Constants } from '../utils/Constants.mjs';
6
6
  import { getDeserializedResponse } from '../utils/UrlUtils.mjs';
7
7
  import { urlEmptyError, urlParseError, authorityUriInsecure } from '../error/ClientConfigurationErrorCodes.mjs';
8
8
 
9
- /*
10
- * Copyright (c) Microsoft Corporation. All rights reserved.
11
- * Licensed under the MIT License.
12
- */
13
- /**
14
- * Url object class which can perform various transformations on url strings.
15
- */
16
- class UrlString {
17
- get urlString() {
18
- return this._urlString;
19
- }
20
- constructor(url) {
21
- this._urlString = url;
22
- if (!this._urlString) {
23
- // Throws error if url is empty
24
- throw createClientConfigurationError(urlEmptyError);
25
- }
26
- if (!url.includes("#")) {
27
- this._urlString = UrlString.canonicalizeUri(url);
28
- }
29
- }
30
- /**
31
- * Ensure urls are lower case and end with a / character.
32
- * @param url
33
- */
34
- static canonicalizeUri(url) {
35
- if (url) {
36
- let lowerCaseUrl = url.toLowerCase();
37
- if (StringUtils.endsWith(lowerCaseUrl, "?")) {
38
- lowerCaseUrl = lowerCaseUrl.slice(0, -1);
39
- }
40
- else if (StringUtils.endsWith(lowerCaseUrl, "?/")) {
41
- lowerCaseUrl = lowerCaseUrl.slice(0, -2);
42
- }
43
- if (!StringUtils.endsWith(lowerCaseUrl, "/")) {
44
- lowerCaseUrl += "/";
45
- }
46
- return lowerCaseUrl;
47
- }
48
- return url;
49
- }
50
- /**
51
- * Throws if urlString passed is not a valid authority URI string.
52
- */
53
- validateAsUri() {
54
- // Attempts to parse url for uri components
55
- let components;
56
- try {
57
- components = this.getUrlComponents();
58
- }
59
- catch (e) {
60
- throw createClientConfigurationError(urlParseError);
61
- }
62
- // Throw error if URI or path segments are not parseable.
63
- if (!components.HostNameAndPort || !components.PathSegments) {
64
- throw createClientConfigurationError(urlParseError);
65
- }
66
- // Throw error if uri is insecure.
67
- if (!components.Protocol ||
68
- components.Protocol.toLowerCase() !== "https:") {
69
- throw createClientConfigurationError(authorityUriInsecure);
70
- }
71
- }
72
- /**
73
- * Given a url and a query string return the url with provided query string appended
74
- * @param url
75
- * @param queryString
76
- */
77
- static appendQueryString(url, queryString) {
78
- if (!queryString) {
79
- return url;
80
- }
81
- return url.indexOf("?") < 0
82
- ? `${url}?${queryString}`
83
- : `${url}&${queryString}`;
84
- }
85
- /**
86
- * Returns a url with the hash removed
87
- * @param url
88
- */
89
- static removeHashFromUrl(url) {
90
- return UrlString.canonicalizeUri(url.split("#")[0]);
91
- }
92
- /**
93
- * Given a url like https://a:b/common/d?e=f#g, and a tenantId, returns https://a:b/tenantId/d
94
- * @param href The url
95
- * @param tenantId The tenant id to replace
96
- */
97
- replaceTenantPath(tenantId) {
98
- const urlObject = this.getUrlComponents();
99
- const pathArray = urlObject.PathSegments;
100
- if (tenantId &&
101
- pathArray.length !== 0 &&
102
- (pathArray[0] === AADAuthorityConstants.COMMON ||
103
- pathArray[0] === AADAuthorityConstants.ORGANIZATIONS)) {
104
- pathArray[0] = tenantId;
105
- }
106
- return UrlString.constructAuthorityUriFromObject(urlObject);
107
- }
108
- /**
109
- * Parses out the components from a url string.
110
- * @returns An object with the various components. Please cache this value insted of calling this multiple times on the same url.
111
- */
112
- getUrlComponents() {
113
- // https://gist.github.com/curtisz/11139b2cfcaef4a261e0
114
- const regEx = RegExp("^(([^:/?#]+):)?(//([^/?#]*))?([^?#]*)(\\?([^#]*))?(#(.*))?");
115
- // If url string does not match regEx, we throw an error
116
- const match = this.urlString.match(regEx);
117
- if (!match) {
118
- throw createClientConfigurationError(urlParseError);
119
- }
120
- // Url component object
121
- const urlComponents = {
122
- Protocol: match[1],
123
- HostNameAndPort: match[4],
124
- AbsolutePath: match[5],
125
- QueryString: match[7],
126
- };
127
- let pathSegments = urlComponents.AbsolutePath.split("/");
128
- pathSegments = pathSegments.filter((val) => val && val.length > 0); // remove empty elements
129
- urlComponents.PathSegments = pathSegments;
130
- if (urlComponents.QueryString &&
131
- urlComponents.QueryString.endsWith("/")) {
132
- urlComponents.QueryString = urlComponents.QueryString.substring(0, urlComponents.QueryString.length - 1);
133
- }
134
- return urlComponents;
135
- }
136
- static getDomainFromUrl(url) {
137
- const regEx = RegExp("^([^:/?#]+://)?([^/?#]*)");
138
- const match = url.match(regEx);
139
- if (!match) {
140
- throw createClientConfigurationError(urlParseError);
141
- }
142
- return match[2];
143
- }
144
- static getAbsoluteUrl(relativeUrl, baseUrl) {
145
- if (relativeUrl[0] === Constants.FORWARD_SLASH) {
146
- const url = new UrlString(baseUrl);
147
- const baseComponents = url.getUrlComponents();
148
- return (baseComponents.Protocol +
149
- "//" +
150
- baseComponents.HostNameAndPort +
151
- relativeUrl);
152
- }
153
- return relativeUrl;
154
- }
155
- static constructAuthorityUriFromObject(urlObject) {
156
- return new UrlString(urlObject.Protocol +
157
- "//" +
158
- urlObject.HostNameAndPort +
159
- "/" +
160
- urlObject.PathSegments.join("/"));
161
- }
162
- /**
163
- * Check if the hash of the URL string contains known properties
164
- * @deprecated This API will be removed in a future version
165
- */
166
- static hashContainsKnownProperties(response) {
167
- return !!getDeserializedResponse(response);
168
- }
9
+ /*
10
+ * Copyright (c) Microsoft Corporation. All rights reserved.
11
+ * Licensed under the MIT License.
12
+ */
13
+ /**
14
+ * Url object class which can perform various transformations on url strings.
15
+ */
16
+ class UrlString {
17
+ get urlString() {
18
+ return this._urlString;
19
+ }
20
+ constructor(url) {
21
+ this._urlString = url;
22
+ if (!this._urlString) {
23
+ // Throws error if url is empty
24
+ throw createClientConfigurationError(urlEmptyError);
25
+ }
26
+ if (!url.includes("#")) {
27
+ this._urlString = UrlString.canonicalizeUri(url);
28
+ }
29
+ }
30
+ /**
31
+ * Ensure urls are lower case and end with a / character.
32
+ * @param url
33
+ */
34
+ static canonicalizeUri(url) {
35
+ if (url) {
36
+ let lowerCaseUrl = url.toLowerCase();
37
+ if (StringUtils.endsWith(lowerCaseUrl, "?")) {
38
+ lowerCaseUrl = lowerCaseUrl.slice(0, -1);
39
+ }
40
+ else if (StringUtils.endsWith(lowerCaseUrl, "?/")) {
41
+ lowerCaseUrl = lowerCaseUrl.slice(0, -2);
42
+ }
43
+ if (!StringUtils.endsWith(lowerCaseUrl, "/")) {
44
+ lowerCaseUrl += "/";
45
+ }
46
+ return lowerCaseUrl;
47
+ }
48
+ return url;
49
+ }
50
+ /**
51
+ * Throws if urlString passed is not a valid authority URI string.
52
+ */
53
+ validateAsUri() {
54
+ // Attempts to parse url for uri components
55
+ let components;
56
+ try {
57
+ components = this.getUrlComponents();
58
+ }
59
+ catch (e) {
60
+ throw createClientConfigurationError(urlParseError);
61
+ }
62
+ // Throw error if URI or path segments are not parseable.
63
+ if (!components.HostNameAndPort || !components.PathSegments) {
64
+ throw createClientConfigurationError(urlParseError);
65
+ }
66
+ // Throw error if uri is insecure.
67
+ if (!components.Protocol ||
68
+ components.Protocol.toLowerCase() !== "https:") {
69
+ throw createClientConfigurationError(authorityUriInsecure);
70
+ }
71
+ }
72
+ /**
73
+ * Given a url and a query string return the url with provided query string appended
74
+ * @param url
75
+ * @param queryString
76
+ */
77
+ static appendQueryString(url, queryString) {
78
+ if (!queryString) {
79
+ return url;
80
+ }
81
+ return url.indexOf("?") < 0
82
+ ? `${url}?${queryString}`
83
+ : `${url}&${queryString}`;
84
+ }
85
+ /**
86
+ * Returns a url with the hash removed
87
+ * @param url
88
+ */
89
+ static removeHashFromUrl(url) {
90
+ return UrlString.canonicalizeUri(url.split("#")[0]);
91
+ }
92
+ /**
93
+ * Given a url like https://a:b/common/d?e=f#g, and a tenantId, returns https://a:b/tenantId/d
94
+ * @param href The url
95
+ * @param tenantId The tenant id to replace
96
+ */
97
+ replaceTenantPath(tenantId) {
98
+ const urlObject = this.getUrlComponents();
99
+ const pathArray = urlObject.PathSegments;
100
+ if (tenantId &&
101
+ pathArray.length !== 0 &&
102
+ (pathArray[0] === AADAuthorityConstants.COMMON ||
103
+ pathArray[0] === AADAuthorityConstants.ORGANIZATIONS)) {
104
+ pathArray[0] = tenantId;
105
+ }
106
+ return UrlString.constructAuthorityUriFromObject(urlObject);
107
+ }
108
+ /**
109
+ * Parses out the components from a url string.
110
+ * @returns An object with the various components. Please cache this value insted of calling this multiple times on the same url.
111
+ */
112
+ getUrlComponents() {
113
+ // https://gist.github.com/curtisz/11139b2cfcaef4a261e0
114
+ const regEx = RegExp("^(([^:/?#]+):)?(//([^/?#]*))?([^?#]*)(\\?([^#]*))?(#(.*))?");
115
+ // If url string does not match regEx, we throw an error
116
+ const match = this.urlString.match(regEx);
117
+ if (!match) {
118
+ throw createClientConfigurationError(urlParseError);
119
+ }
120
+ // Url component object
121
+ const urlComponents = {
122
+ Protocol: match[1],
123
+ HostNameAndPort: match[4],
124
+ AbsolutePath: match[5],
125
+ QueryString: match[7],
126
+ };
127
+ let pathSegments = urlComponents.AbsolutePath.split("/");
128
+ pathSegments = pathSegments.filter((val) => val && val.length > 0); // remove empty elements
129
+ urlComponents.PathSegments = pathSegments;
130
+ if (urlComponents.QueryString &&
131
+ urlComponents.QueryString.endsWith("/")) {
132
+ urlComponents.QueryString = urlComponents.QueryString.substring(0, urlComponents.QueryString.length - 1);
133
+ }
134
+ return urlComponents;
135
+ }
136
+ static getDomainFromUrl(url) {
137
+ const regEx = RegExp("^([^:/?#]+://)?([^/?#]*)");
138
+ const match = url.match(regEx);
139
+ if (!match) {
140
+ throw createClientConfigurationError(urlParseError);
141
+ }
142
+ return match[2];
143
+ }
144
+ static getAbsoluteUrl(relativeUrl, baseUrl) {
145
+ if (relativeUrl[0] === Constants.FORWARD_SLASH) {
146
+ const url = new UrlString(baseUrl);
147
+ const baseComponents = url.getUrlComponents();
148
+ return (baseComponents.Protocol +
149
+ "//" +
150
+ baseComponents.HostNameAndPort +
151
+ relativeUrl);
152
+ }
153
+ return relativeUrl;
154
+ }
155
+ static constructAuthorityUriFromObject(urlObject) {
156
+ return new UrlString(urlObject.Protocol +
157
+ "//" +
158
+ urlObject.HostNameAndPort +
159
+ "/" +
160
+ urlObject.PathSegments.join("/"));
161
+ }
162
+ /**
163
+ * Check if the hash of the URL string contains known properties
164
+ * @deprecated This API will be removed in a future version
165
+ */
166
+ static hashContainsKnownProperties(response) {
167
+ return !!getDeserializedResponse(response);
168
+ }
169
169
  }
170
170
 
171
171
  export { UrlString };