@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,4 +1,4 @@
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 { 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 };