@azure/msal-common 14.13.1 → 14.14.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 (193) hide show
  1. package/dist/account/AccountInfo.d.ts +66 -66
  2. package/dist/account/AccountInfo.mjs +77 -77
  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 +19 -19
  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 -254
  13. package/dist/authority/Authority.mjs +836 -836
  14. package/dist/authority/AuthorityFactory.d.ts +18 -18
  15. package/dist/authority/AuthorityFactory.mjs +28 -28
  16. package/dist/authority/AuthorityMetadata.d.ts +43 -43
  17. package/dist/authority/AuthorityMetadata.mjs +137 -137
  18. package/dist/authority/AuthorityOptions.d.ts +27 -27
  19. package/dist/authority/AuthorityOptions.mjs +18 -18
  20. package/dist/authority/AuthorityType.d.ts +10 -10
  21. package/dist/authority/AuthorityType.mjs +13 -13
  22. package/dist/authority/AzureRegion.d.ts +1 -1
  23. package/dist/authority/AzureRegionConfiguration.d.ts +5 -5
  24. package/dist/authority/CloudDiscoveryMetadata.d.ts +5 -5
  25. package/dist/authority/CloudInstanceDiscoveryErrorResponse.d.ts +13 -13
  26. package/dist/authority/CloudInstanceDiscoveryErrorResponse.mjs +8 -8
  27. package/dist/authority/CloudInstanceDiscoveryResponse.d.ts +9 -9
  28. package/dist/authority/CloudInstanceDiscoveryResponse.mjs +8 -8
  29. package/dist/authority/ImdsOptions.d.ts +5 -5
  30. package/dist/authority/OIDCOptions.d.ts +8 -8
  31. package/dist/authority/OpenIdConfigResponse.d.ts +11 -11
  32. package/dist/authority/OpenIdConfigResponse.mjs +10 -10
  33. package/dist/authority/ProtocolMode.d.ts +8 -8
  34. package/dist/authority/ProtocolMode.mjs +11 -11
  35. package/dist/authority/RegionDiscovery.d.ts +32 -32
  36. package/dist/authority/RegionDiscovery.mjs +106 -106
  37. package/dist/authority/RegionDiscoveryMetadata.d.ts +6 -6
  38. package/dist/broker/nativeBroker/INativeBrokerPlugin.d.ts +15 -15
  39. package/dist/cache/CacheManager.d.ts +497 -497
  40. package/dist/cache/CacheManager.mjs +1249 -1249
  41. package/dist/cache/entities/AccessTokenEntity.d.ts +25 -25
  42. package/dist/cache/entities/AccountEntity.d.ts +106 -106
  43. package/dist/cache/entities/AccountEntity.mjs +240 -240
  44. package/dist/cache/entities/AppMetadataEntity.d.ts +11 -11
  45. package/dist/cache/entities/AuthorityMetadataEntity.d.ts +15 -15
  46. package/dist/cache/entities/CacheRecord.d.ts +13 -13
  47. package/dist/cache/entities/CredentialEntity.d.ts +30 -30
  48. package/dist/cache/entities/IdTokenEntity.d.ts +8 -8
  49. package/dist/cache/entities/RefreshTokenEntity.d.ts +7 -7
  50. package/dist/cache/entities/ServerTelemetryEntity.d.ts +6 -5
  51. package/dist/cache/entities/ServerTelemetryEntity.d.ts.map +1 -1
  52. package/dist/cache/entities/ThrottlingEntity.d.ts +7 -7
  53. package/dist/cache/interface/ICacheManager.d.ts +166 -166
  54. package/dist/cache/interface/ICachePlugin.d.ts +5 -5
  55. package/dist/cache/interface/ISerializableTokenCache.d.ts +4 -4
  56. package/dist/cache/persistence/TokenCacheContext.d.ts +23 -23
  57. package/dist/cache/persistence/TokenCacheContext.mjs +25 -25
  58. package/dist/cache/utils/CacheHelpers.d.ts +94 -94
  59. package/dist/cache/utils/CacheHelpers.mjs +324 -324
  60. package/dist/cache/utils/CacheTypes.d.ts +69 -69
  61. package/dist/client/AuthorizationCodeClient.d.ts +74 -74
  62. package/dist/client/AuthorizationCodeClient.mjs +420 -420
  63. package/dist/client/BaseClient.d.ts +51 -51
  64. package/dist/client/BaseClient.mjs +100 -100
  65. package/dist/client/RefreshTokenClient.d.ts +35 -35
  66. package/dist/client/RefreshTokenClient.mjs +211 -211
  67. package/dist/client/SilentFlowClient.d.ts +27 -27
  68. package/dist/client/SilentFlowClient.mjs +133 -133
  69. package/dist/config/AppTokenProvider.d.ts +38 -38
  70. package/dist/config/ClientConfiguration.d.ts +150 -150
  71. package/dist/config/ClientConfiguration.mjs +95 -95
  72. package/dist/constants/AADServerParamKeys.d.ts +53 -52
  73. package/dist/constants/AADServerParamKeys.d.ts.map +1 -1
  74. package/dist/constants/AADServerParamKeys.mjs +59 -58
  75. package/dist/constants/AADServerParamKeys.mjs.map +1 -1
  76. package/dist/crypto/ICrypto.d.ts +68 -68
  77. package/dist/crypto/ICrypto.mjs +36 -36
  78. package/dist/crypto/IGuidGenerator.d.ts +4 -4
  79. package/dist/crypto/JoseHeader.d.ts +22 -22
  80. package/dist/crypto/JoseHeader.mjs +37 -37
  81. package/dist/crypto/PopTokenGenerator.d.ts +59 -59
  82. package/dist/crypto/PopTokenGenerator.mjs +81 -81
  83. package/dist/crypto/SignedHttpRequest.d.ts +15 -15
  84. package/dist/error/AuthError.d.ts +44 -44
  85. package/dist/error/AuthError.mjs +46 -46
  86. package/dist/error/AuthErrorCodes.d.ts +5 -5
  87. package/dist/error/AuthErrorCodes.mjs +9 -9
  88. package/dist/error/CacheError.d.ts +20 -20
  89. package/dist/error/CacheError.mjs +24 -24
  90. package/dist/error/CacheErrorCodes.d.ts +2 -2
  91. package/dist/error/CacheErrorCodes.mjs +6 -6
  92. package/dist/error/ClientAuthError.d.ts +237 -237
  93. package/dist/error/ClientAuthError.mjs +249 -249
  94. package/dist/error/ClientAuthErrorCodes.d.ts +44 -44
  95. package/dist/error/ClientAuthErrorCodes.mjs +48 -48
  96. package/dist/error/ClientConfigurationError.d.ts +128 -128
  97. package/dist/error/ClientConfigurationError.mjs +135 -135
  98. package/dist/error/ClientConfigurationErrorCodes.d.ts +22 -22
  99. package/dist/error/ClientConfigurationErrorCodes.mjs +26 -26
  100. package/dist/error/InteractionRequiredAuthError.d.ts +65 -65
  101. package/dist/error/InteractionRequiredAuthError.mjs +85 -85
  102. package/dist/error/InteractionRequiredAuthErrorCodes.d.ts +7 -7
  103. package/dist/error/InteractionRequiredAuthErrorCodes.mjs +13 -13
  104. package/dist/error/JoseHeaderError.d.ts +15 -15
  105. package/dist/error/JoseHeaderError.mjs +22 -22
  106. package/dist/error/JoseHeaderErrorCodes.d.ts +2 -2
  107. package/dist/error/JoseHeaderErrorCodes.mjs +6 -6
  108. package/dist/error/ServerError.d.ts +15 -15
  109. package/dist/error/ServerError.mjs +16 -16
  110. package/dist/index.cjs +8664 -8599
  111. package/dist/index.cjs.map +1 -1
  112. package/dist/index.d.ts +107 -107
  113. package/dist/index.mjs +1 -1
  114. package/dist/logger/Logger.d.ts +95 -95
  115. package/dist/logger/Logger.mjs +188 -188
  116. package/dist/network/INetworkModule.d.ts +29 -29
  117. package/dist/network/INetworkModule.mjs +12 -12
  118. package/dist/network/NetworkManager.d.ts +33 -33
  119. package/dist/network/NetworkManager.mjs +34 -34
  120. package/dist/network/RequestThumbprint.d.ts +18 -18
  121. package/dist/network/ThrottlingUtils.d.ts +42 -42
  122. package/dist/network/ThrottlingUtils.mjs +95 -95
  123. package/dist/packageMetadata.d.ts +2 -2
  124. package/dist/packageMetadata.mjs +4 -4
  125. package/dist/request/AuthenticationHeaderParser.d.ts +19 -19
  126. package/dist/request/AuthenticationHeaderParser.mjs +55 -55
  127. package/dist/request/BaseAuthRequest.d.ts +47 -47
  128. package/dist/request/CommonAuthorizationCodeRequest.d.ts +27 -27
  129. package/dist/request/CommonAuthorizationUrlRequest.d.ts +50 -50
  130. package/dist/request/CommonClientCredentialRequest.d.ts +17 -17
  131. package/dist/request/CommonDeviceCodeRequest.d.ts +21 -21
  132. package/dist/request/CommonEndSessionRequest.d.ts +21 -21
  133. package/dist/request/CommonOnBehalfOfRequest.d.ts +13 -13
  134. package/dist/request/CommonRefreshTokenRequest.d.ts +22 -22
  135. package/dist/request/CommonSilentFlowRequest.d.ts +27 -27
  136. package/dist/request/CommonUsernamePasswordRequest.d.ts +17 -17
  137. package/dist/request/NativeRequest.d.ts +19 -19
  138. package/dist/request/NativeSignOutRequest.d.ts +5 -5
  139. package/dist/request/RequestParameterBuilder.d.ts +217 -217
  140. package/dist/request/RequestParameterBuilder.mjs +382 -382
  141. package/dist/request/RequestValidator.d.ts +27 -27
  142. package/dist/request/RequestValidator.mjs +64 -64
  143. package/dist/request/ScopeSet.d.ts +88 -88
  144. package/dist/request/ScopeSet.mjs +197 -197
  145. package/dist/request/StoreInCache.d.ts +8 -8
  146. package/dist/response/AuthenticationResult.d.ts +41 -41
  147. package/dist/response/AuthorizationCodePayload.d.ts +13 -13
  148. package/dist/response/DeviceCodeResponse.d.ts +25 -25
  149. package/dist/response/ExternalTokenResponse.d.ts +15 -15
  150. package/dist/response/IMDSBadResponse.d.ts +4 -4
  151. package/dist/response/ResponseHandler.d.ts +69 -69
  152. package/dist/response/ResponseHandler.mjs +374 -374
  153. package/dist/response/ServerAuthorizationCodeResponse.d.ts +26 -26
  154. package/dist/response/ServerAuthorizationTokenResponse.d.ts +47 -47
  155. package/dist/telemetry/performance/IPerformanceClient.d.ts +57 -57
  156. package/dist/telemetry/performance/IPerformanceMeasurement.d.ts +5 -5
  157. package/dist/telemetry/performance/PerformanceClient.d.ts +242 -242
  158. package/dist/telemetry/performance/PerformanceClient.mjs +587 -587
  159. package/dist/telemetry/performance/PerformanceEvent.d.ts +515 -505
  160. package/dist/telemetry/performance/PerformanceEvent.d.ts.map +1 -1
  161. package/dist/telemetry/performance/PerformanceEvent.mjs +484 -480
  162. package/dist/telemetry/performance/PerformanceEvent.mjs.map +1 -1
  163. package/dist/telemetry/performance/StubPerformanceClient.d.ts +24 -24
  164. package/dist/telemetry/performance/StubPerformanceClient.mjs +76 -76
  165. package/dist/telemetry/server/ServerTelemetryManager.d.ts +78 -66
  166. package/dist/telemetry/server/ServerTelemetryManager.d.ts.map +1 -1
  167. package/dist/telemetry/server/ServerTelemetryManager.mjs +260 -201
  168. package/dist/telemetry/server/ServerTelemetryManager.mjs.map +1 -1
  169. package/dist/telemetry/server/ServerTelemetryRequest.d.ts +8 -8
  170. package/dist/url/IUri.d.ts +12 -12
  171. package/dist/url/UrlString.d.ts +48 -48
  172. package/dist/url/UrlString.mjs +161 -161
  173. package/dist/utils/ClientAssertionUtils.d.ts +2 -2
  174. package/dist/utils/ClientAssertionUtils.mjs +16 -16
  175. package/dist/utils/Constants.d.ts +309 -309
  176. package/dist/utils/Constants.mjs +322 -322
  177. package/dist/utils/FunctionWrappers.d.ts +27 -27
  178. package/dist/utils/FunctionWrappers.mjs +94 -94
  179. package/dist/utils/MsalTypes.d.ts +6 -6
  180. package/dist/utils/ProtocolUtils.d.ts +42 -42
  181. package/dist/utils/ProtocolUtils.mjs +69 -69
  182. package/dist/utils/StringUtils.d.ts +40 -40
  183. package/dist/utils/StringUtils.mjs +95 -95
  184. package/dist/utils/TimeUtils.d.ts +25 -25
  185. package/dist/utils/TimeUtils.mjs +43 -43
  186. package/dist/utils/UrlUtils.d.ts +10 -10
  187. package/dist/utils/UrlUtils.mjs +44 -44
  188. package/package.json +1 -1
  189. package/src/cache/entities/ServerTelemetryEntity.ts +1 -0
  190. package/src/constants/AADServerParamKeys.ts +1 -0
  191. package/src/packageMetadata.ts +1 -1
  192. package/src/telemetry/performance/PerformanceEvent.ts +12 -0
  193. package/src/telemetry/server/ServerTelemetryManager.ts +95 -1
@@ -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
@@ -1,4 +1,4 @@
1
- /*! @azure/msal-common v14.13.1 2024-07-16 */
1
+ /*! @azure/msal-common v14.14.1 2024-08-13 */
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 };
@@ -1,3 +1,3 @@
1
- import { ClientAssertionCallback } from "../account/ClientCredentials";
2
- export declare function getClientAssertion(clientAssertion: string | ClientAssertionCallback, clientId: string, tokenEndpoint?: string): Promise<string>;
1
+ import { ClientAssertionCallback } from "../account/ClientCredentials";
2
+ export declare function getClientAssertion(clientAssertion: string | ClientAssertionCallback, clientId: string, tokenEndpoint?: string): Promise<string>;
3
3
  //# sourceMappingURL=ClientAssertionUtils.d.ts.map
@@ -1,20 +1,20 @@
1
- /*! @azure/msal-common v14.13.1 2024-07-16 */
1
+ /*! @azure/msal-common v14.14.1 2024-08-13 */
2
2
  'use strict';
3
- /*
4
- * Copyright (c) Microsoft Corporation. All rights reserved.
5
- * Licensed under the MIT License.
6
- */
7
- async function getClientAssertion(clientAssertion, clientId, tokenEndpoint) {
8
- if (typeof clientAssertion === "string") {
9
- return clientAssertion;
10
- }
11
- else {
12
- const config = {
13
- clientId: clientId,
14
- tokenEndpoint: tokenEndpoint,
15
- };
16
- return clientAssertion(config);
17
- }
3
+ /*
4
+ * Copyright (c) Microsoft Corporation. All rights reserved.
5
+ * Licensed under the MIT License.
6
+ */
7
+ async function getClientAssertion(clientAssertion, clientId, tokenEndpoint) {
8
+ if (typeof clientAssertion === "string") {
9
+ return clientAssertion;
10
+ }
11
+ else {
12
+ const config = {
13
+ clientId: clientId,
14
+ tokenEndpoint: tokenEndpoint,
15
+ };
16
+ return clientAssertion(config);
17
+ }
18
18
  }
19
19
 
20
20
  export { getClientAssertion };