@azure/msal-browser 3.20.0 → 3.22.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 (187) hide show
  1. package/dist/app/IPublicClientApplication.d.ts +53 -53
  2. package/dist/app/IPublicClientApplication.mjs +105 -105
  3. package/dist/app/PublicClientApplication.d.ts +293 -293
  4. package/dist/app/PublicClientApplication.mjs +364 -364
  5. package/dist/app/PublicClientNext.d.ts +276 -276
  6. package/dist/app/PublicClientNext.mjs +354 -354
  7. package/dist/broker/nativeBroker/NativeMessageHandler.d.ts +62 -62
  8. package/dist/broker/nativeBroker/NativeMessageHandler.mjs +254 -254
  9. package/dist/broker/nativeBroker/NativeRequest.d.ts +45 -45
  10. package/dist/broker/nativeBroker/NativeResponse.d.ts +48 -48
  11. package/dist/broker/nativeBroker/NativeStatusCodes.d.ts +7 -7
  12. package/dist/broker/nativeBroker/NativeStatusCodes.mjs +11 -11
  13. package/dist/cache/AccountManager.d.ts +48 -48
  14. package/dist/cache/AccountManager.mjs +126 -126
  15. package/dist/cache/AsyncMemoryStorage.d.ts +50 -50
  16. package/dist/cache/AsyncMemoryStorage.mjs +131 -131
  17. package/dist/cache/BrowserCacheManager.d.ts +385 -385
  18. package/dist/cache/BrowserCacheManager.mjs +1294 -1294
  19. package/dist/cache/BrowserStorage.d.ts +11 -11
  20. package/dist/cache/BrowserStorage.mjs +32 -32
  21. package/dist/cache/DatabaseStorage.d.ts +56 -56
  22. package/dist/cache/DatabaseStorage.mjs +200 -200
  23. package/dist/cache/IAsyncStorage.d.ts +27 -27
  24. package/dist/cache/ITokenCache.d.ts +11 -11
  25. package/dist/cache/IWindowStorage.d.ts +27 -27
  26. package/dist/cache/MemoryStorage.d.ts +11 -11
  27. package/dist/cache/MemoryStorage.mjs +31 -31
  28. package/dist/cache/TokenCache.d.ts +77 -77
  29. package/dist/cache/TokenCache.mjs +195 -195
  30. package/dist/config/Configuration.d.ts +213 -208
  31. package/dist/config/Configuration.d.ts.map +1 -1
  32. package/dist/config/Configuration.mjs +128 -128
  33. package/dist/config/Configuration.mjs.map +1 -1
  34. package/dist/controllers/ControllerFactory.d.ts +5 -5
  35. package/dist/controllers/ControllerFactory.mjs +25 -25
  36. package/dist/controllers/IController.d.ts +60 -60
  37. package/dist/controllers/NestedAppAuthController.d.ts +202 -202
  38. package/dist/controllers/NestedAppAuthController.mjs +473 -473
  39. package/dist/controllers/StandardController.d.ts +405 -405
  40. package/dist/controllers/StandardController.d.ts.map +1 -1
  41. package/dist/controllers/StandardController.mjs +1334 -1316
  42. package/dist/controllers/StandardController.mjs.map +1 -1
  43. package/dist/controllers/UnknownOperatingContextController.d.ts +86 -86
  44. package/dist/controllers/UnknownOperatingContextController.mjs +256 -256
  45. package/dist/crypto/BrowserCrypto.d.ts +52 -52
  46. package/dist/crypto/BrowserCrypto.mjs +151 -151
  47. package/dist/crypto/CryptoOps.d.ts +74 -74
  48. package/dist/crypto/CryptoOps.mjs +176 -176
  49. package/dist/crypto/PkceGenerator.d.ts +8 -8
  50. package/dist/crypto/PkceGenerator.mjs +54 -54
  51. package/dist/crypto/SignedHttpRequest.d.ts +30 -30
  52. package/dist/crypto/SignedHttpRequest.mjs +39 -39
  53. package/dist/encode/Base64Decode.d.ts +9 -9
  54. package/dist/encode/Base64Decode.mjs +36 -36
  55. package/dist/encode/Base64Encode.d.ts +19 -19
  56. package/dist/encode/Base64Encode.mjs +43 -43
  57. package/dist/error/BrowserAuthError.d.ts +255 -255
  58. package/dist/error/BrowserAuthError.mjs +263 -263
  59. package/dist/error/BrowserAuthErrorCodes.d.ts +46 -46
  60. package/dist/error/BrowserAuthErrorCodes.mjs +50 -50
  61. package/dist/error/BrowserConfigurationAuthError.d.ts +33 -33
  62. package/dist/error/BrowserConfigurationAuthError.mjs +40 -40
  63. package/dist/error/BrowserConfigurationAuthError.mjs.map +1 -1
  64. package/dist/error/BrowserConfigurationAuthErrorCodes.d.ts +3 -3
  65. package/dist/error/BrowserConfigurationAuthErrorCodes.mjs +7 -7
  66. package/dist/error/NativeAuthError.d.ts +29 -29
  67. package/dist/error/NativeAuthError.mjs +60 -60
  68. package/dist/error/NativeAuthErrorCodes.d.ts +2 -2
  69. package/dist/error/NativeAuthErrorCodes.mjs +6 -6
  70. package/dist/error/NestedAppAuthError.d.ts +14 -14
  71. package/dist/error/NestedAppAuthError.mjs +23 -23
  72. package/dist/event/EventHandler.d.ts +41 -41
  73. package/dist/event/EventHandler.mjs +125 -125
  74. package/dist/event/EventMessage.d.ts +25 -25
  75. package/dist/event/EventMessage.mjs +68 -68
  76. package/dist/event/EventType.d.ts +29 -29
  77. package/dist/event/EventType.mjs +32 -32
  78. package/dist/index.d.ts +40 -40
  79. package/dist/index.mjs +1 -1
  80. package/dist/interaction_client/BaseInteractionClient.d.ts +50 -50
  81. package/dist/interaction_client/BaseInteractionClient.mjs +106 -106
  82. package/dist/interaction_client/HybridSpaAuthorizationCodeClient.d.ts +4 -4
  83. package/dist/interaction_client/HybridSpaAuthorizationCodeClient.mjs +10 -10
  84. package/dist/interaction_client/NativeInteractionClient.d.ts +151 -151
  85. package/dist/interaction_client/NativeInteractionClient.mjs +621 -621
  86. package/dist/interaction_client/PopupClient.d.ts +105 -105
  87. package/dist/interaction_client/PopupClient.d.ts.map +1 -1
  88. package/dist/interaction_client/PopupClient.mjs +433 -433
  89. package/dist/interaction_client/PopupClient.mjs.map +1 -1
  90. package/dist/interaction_client/RedirectClient.d.ts +50 -50
  91. package/dist/interaction_client/RedirectClient.d.ts.map +1 -1
  92. package/dist/interaction_client/RedirectClient.mjs +315 -314
  93. package/dist/interaction_client/RedirectClient.mjs.map +1 -1
  94. package/dist/interaction_client/SilentAuthCodeClient.d.ts +23 -23
  95. package/dist/interaction_client/SilentAuthCodeClient.mjs +57 -57
  96. package/dist/interaction_client/SilentCacheClient.d.ts +16 -16
  97. package/dist/interaction_client/SilentCacheClient.mjs +42 -42
  98. package/dist/interaction_client/SilentIframeClient.d.ts +32 -32
  99. package/dist/interaction_client/SilentIframeClient.d.ts.map +1 -1
  100. package/dist/interaction_client/SilentIframeClient.mjs +110 -100
  101. package/dist/interaction_client/SilentIframeClient.mjs.map +1 -1
  102. package/dist/interaction_client/SilentRefreshClient.d.ts +20 -20
  103. package/dist/interaction_client/SilentRefreshClient.mjs +47 -47
  104. package/dist/interaction_client/StandardInteractionClient.d.ts +48 -48
  105. package/dist/interaction_client/StandardInteractionClient.mjs +199 -199
  106. package/dist/interaction_handler/InteractionHandler.d.ts +33 -33
  107. package/dist/interaction_handler/InteractionHandler.mjs +93 -93
  108. package/dist/interaction_handler/RedirectHandler.d.ts +32 -32
  109. package/dist/interaction_handler/RedirectHandler.mjs +134 -134
  110. package/dist/interaction_handler/SilentHandler.d.ts +13 -13
  111. package/dist/interaction_handler/SilentHandler.mjs +134 -134
  112. package/dist/naa/AccountInfo.d.ts +11 -11
  113. package/dist/naa/AuthBridge.d.ts +8 -8
  114. package/dist/naa/AuthResult.d.ts +6 -6
  115. package/dist/naa/BridgeAccountContext.d.ts +12 -12
  116. package/dist/naa/BridgeCapabilities.d.ts +3 -3
  117. package/dist/naa/BridgeError.d.ts +9 -9
  118. package/dist/naa/BridgeError.mjs +7 -7
  119. package/dist/naa/BridgeProxy.d.ts +67 -67
  120. package/dist/naa/BridgeProxy.mjs +148 -148
  121. package/dist/naa/BridgeRequest.d.ts +7 -7
  122. package/dist/naa/BridgeRequestEnvelope.d.ts +12 -12
  123. package/dist/naa/BridgeResponseEnvelope.d.ts +13 -13
  124. package/dist/naa/BridgeStatusCode.d.ts +11 -11
  125. package/dist/naa/BridgeStatusCode.mjs +14 -14
  126. package/dist/naa/IBridgeProxy.d.ts +10 -10
  127. package/dist/naa/InitContext.d.ts +8 -8
  128. package/dist/naa/TokenRequest.d.ts +18 -18
  129. package/dist/naa/TokenResponse.d.ts +13 -13
  130. package/dist/naa/mapping/NestedAppAuthAdapter.d.ts +35 -35
  131. package/dist/naa/mapping/NestedAppAuthAdapter.mjs +179 -179
  132. package/dist/navigation/INavigationClient.d.ts +16 -16
  133. package/dist/navigation/NavigationClient.d.ts +22 -22
  134. package/dist/navigation/NavigationClient.mjs +40 -40
  135. package/dist/navigation/NavigationOptions.d.ts +12 -12
  136. package/dist/network/FetchClient.d.ts +26 -26
  137. package/dist/network/FetchClient.mjs +99 -99
  138. package/dist/operatingcontext/BaseOperatingContext.d.ts +41 -41
  139. package/dist/operatingcontext/BaseOperatingContext.mjs +94 -94
  140. package/dist/operatingcontext/NestedAppOperatingContext.d.ts +34 -34
  141. package/dist/operatingcontext/NestedAppOperatingContext.mjs +71 -71
  142. package/dist/operatingcontext/StandardOperatingContext.d.ts +25 -25
  143. package/dist/operatingcontext/StandardOperatingContext.mjs +43 -43
  144. package/dist/operatingcontext/UnknownOperatingContext.d.ts +25 -25
  145. package/dist/operatingcontext/UnknownOperatingContext.mjs +42 -42
  146. package/dist/packageMetadata.d.ts +2 -2
  147. package/dist/packageMetadata.mjs +4 -4
  148. package/dist/request/AuthorizationCodeRequest.d.ts +8 -8
  149. package/dist/request/AuthorizationUrlRequest.d.ts +8 -8
  150. package/dist/request/ClearCacheRequest.d.ts +10 -10
  151. package/dist/request/EndSessionPopupRequest.d.ts +18 -18
  152. package/dist/request/EndSessionRequest.d.ts +15 -15
  153. package/dist/request/InitializeApplicationRequest.d.ts +8 -8
  154. package/dist/request/PopupRequest.d.ts +34 -34
  155. package/dist/request/PopupWindowAttributes.d.ts +15 -15
  156. package/dist/request/RedirectRequest.d.ts +40 -35
  157. package/dist/request/RedirectRequest.d.ts.map +1 -1
  158. package/dist/request/RequestHelpers.d.ts +13 -13
  159. package/dist/request/RequestHelpers.mjs +53 -53
  160. package/dist/request/SilentRequest.d.ts +33 -33
  161. package/dist/request/SsoSilentRequest.d.ts +29 -29
  162. package/dist/response/AuthenticationResult.d.ts +4 -4
  163. package/dist/response/ResponseHandler.d.ts +7 -7
  164. package/dist/response/ResponseHandler.mjs +36 -36
  165. package/dist/telemetry/BrowserPerformanceClient.d.ts +34 -34
  166. package/dist/telemetry/BrowserPerformanceClient.mjs +162 -162
  167. package/dist/telemetry/BrowserPerformanceMeasurement.d.ts +21 -21
  168. package/dist/telemetry/BrowserPerformanceMeasurement.mjs +92 -92
  169. package/dist/utils/BrowserConstants.d.ts +180 -180
  170. package/dist/utils/BrowserConstants.mjs +212 -212
  171. package/dist/utils/BrowserProtocolUtils.d.ts +11 -11
  172. package/dist/utils/BrowserProtocolUtils.mjs +21 -21
  173. package/dist/utils/BrowserUtils.d.ts +75 -75
  174. package/dist/utils/BrowserUtils.mjs +157 -157
  175. package/lib/msal-browser.cjs +18884 -18855
  176. package/lib/msal-browser.cjs.map +1 -1
  177. package/lib/msal-browser.js +18884 -18855
  178. package/lib/msal-browser.js.map +1 -1
  179. package/lib/msal-browser.min.js +59 -59
  180. package/package.json +2 -2
  181. package/src/config/Configuration.ts +9 -1
  182. package/src/controllers/StandardController.ts +30 -12
  183. package/src/interaction_client/PopupClient.ts +1 -0
  184. package/src/interaction_client/RedirectClient.ts +4 -1
  185. package/src/interaction_client/SilentIframeClient.ts +40 -3
  186. package/src/packageMetadata.ts +1 -1
  187. package/src/request/RedirectRequest.ts +5 -0
@@ -1,362 +1,362 @@
1
- /*! @azure/msal-browser v3.20.0 2024-07-23 */
1
+ /*! @azure/msal-browser v3.22.0 2024-08-28 */
2
2
  'use strict';
3
3
  import { createController } from '../controllers/ControllerFactory.mjs';
4
4
  import { UnknownOperatingContextController } from '../controllers/UnknownOperatingContextController.mjs';
5
5
  import { UnknownOperatingContext } from '../operatingcontext/UnknownOperatingContext.mjs';
6
6
 
7
- /*
8
- * Copyright (c) Microsoft Corporation. All rights reserved.
9
- * Licensed under the MIT License.
10
- */
11
- /**
12
- * PublicClientNext is an early look at the planned implementation of PublicClientApplication in the next major version of MSAL.js.
13
- * It contains support for multiple API implementations based on the runtime environment that it is running in.
14
- *
15
- * The goals of these changes are to provide a clean separation of behavior between different operating contexts (Nested App Auth, Platform Brokers, Plain old Browser, etc.)
16
- * while still providing a consistent API surface for developers.
17
- *
18
- * Please use PublicClientApplication for any prod/real-world scenarios.
19
- * Note: PublicClientNext is experimental and subject to breaking changes without following semver
20
- *
21
- */
22
- class PublicClientNext {
23
- static async createPublicClientApplication(configuration) {
24
- const controller = await createController(configuration);
25
- let pca;
26
- if (controller !== null) {
27
- pca = new PublicClientNext(configuration, controller);
28
- }
29
- else {
30
- pca = new PublicClientNext(configuration);
31
- }
32
- return pca;
33
- }
34
- /**
35
- * @constructor
36
- * Constructor for the PublicClientNext used to instantiate the PublicClientNext object
37
- *
38
- * Important attributes in the Configuration object for auth are:
39
- * - clientID: the application ID of your application. You can obtain one by registering your application with our Application registration portal : https://portal.azure.com/#blade/Microsoft_AAD_IAM/ActiveDirectoryMenuBlade/RegisteredAppsPreview
40
- * - authority: the authority URL for your application.
41
- * - redirect_uri: the uri of your application registered in the portal.
42
- *
43
- * In Azure AD, authority is a URL indicating the Azure active directory that MSAL uses to obtain tokens.
44
- * It is of the form https://login.microsoftonline.com/{Enter_the_Tenant_Info_Here}
45
- * If your application supports Accounts in one organizational directory, replace "Enter_the_Tenant_Info_Here" value with the Tenant Id or Tenant name (for example, contoso.microsoft.com).
46
- * If your application supports Accounts in any organizational directory, replace "Enter_the_Tenant_Info_Here" value with organizations.
47
- * If your application supports Accounts in any organizational directory and personal Microsoft accounts, replace "Enter_the_Tenant_Info_Here" value with common.
48
- * To restrict support to Personal Microsoft accounts only, replace "Enter_the_Tenant_Info_Here" value with consumers.
49
- *
50
- * In Azure B2C, authority is of the form https://{instance}/tfp/{tenant}/{policyName}/
51
- * Full B2C functionality will be available in this library in future versions.
52
- *
53
- * @param configuration Object for the MSAL PublicClientApplication instance
54
- * @param IController Optional parameter to explictly set the controller. (Will be removed when we remove public constructor)
55
- */
56
- constructor(configuration, controller) {
57
- this.configuration = configuration;
58
- if (controller) {
59
- this.controller = controller;
60
- }
61
- else {
62
- const operatingContext = new UnknownOperatingContext(configuration);
63
- this.controller = new UnknownOperatingContextController(operatingContext);
64
- }
65
- }
66
- /**
67
- * Initializer function to perform async startup tasks such as connecting to WAM extension
68
- */
69
- async initialize() {
70
- if (this.controller instanceof UnknownOperatingContextController) {
71
- const result = await createController(this.configuration);
72
- if (result !== null) {
73
- this.controller = result;
74
- }
75
- return this.controller.initialize();
76
- }
77
- return Promise.resolve();
78
- }
79
- /**
80
- * Use when you want to obtain an access_token for your API via opening a popup window in the user's browser
81
- *
82
- * @param request
83
- *
84
- * @returns A promise that is fulfilled when this function has completed, or rejected if an error was raised.
85
- */
86
- async acquireTokenPopup(request) {
87
- return this.controller.acquireTokenPopup(request);
88
- }
89
- /**
90
- * Use when you want to obtain an access_token for your API by redirecting the user's browser window to the authorization endpoint. This function redirects
91
- * the page, so any code that follows this function will not execute.
92
- *
93
- * IMPORTANT: It is NOT recommended to have code that is dependent on the resolution of the Promise. This function will navigate away from the current
94
- * browser window. It currently returns a Promise in order to reflect the asynchronous nature of the code running in this function.
95
- *
96
- * @param request
97
- */
98
- acquireTokenRedirect(request) {
99
- return this.controller.acquireTokenRedirect(request);
100
- }
101
- /**
102
- * Silently acquire an access token for a given set of scopes. Returns currently processing promise if parallel requests are made.
103
- *
104
- * @param {@link (SilentRequest:type)}
105
- * @returns {Promise.<AuthenticationResult>} - a promise that is fulfilled when this function has completed, or rejected if an error was raised. Returns the {@link AuthenticationResult} object
106
- */
107
- acquireTokenSilent(silentRequest) {
108
- return this.controller.acquireTokenSilent(silentRequest);
109
- }
110
- /**
111
- * This function redeems an authorization code (passed as code) from the eSTS token endpoint.
112
- * This authorization code should be acquired server-side using a confidential client to acquire a spa_code.
113
- * This API is not indended for normal authorization code acquisition and redemption.
114
- *
115
- * Redemption of this authorization code will not require PKCE, as it was acquired by a confidential client.
116
- *
117
- * @param request {@link AuthorizationCodeRequest}
118
- * @returns A promise that is fulfilled when this function has completed, or rejected if an error was raised.
119
- */
120
- acquireTokenByCode(request) {
121
- return this.controller.acquireTokenByCode(request);
122
- }
123
- /**
124
- * Adds event callbacks to array
125
- * @param callback
126
- */
127
- addEventCallback(callback) {
128
- return this.controller.addEventCallback(callback);
129
- }
130
- /**
131
- * Removes callback with provided id from callback array
132
- * @param callbackId
133
- */
134
- removeEventCallback(callbackId) {
135
- return this.controller.removeEventCallback(callbackId);
136
- }
137
- /**
138
- * Registers a callback to receive performance events.
139
- *
140
- * @param {PerformanceCallbackFunction} callback
141
- * @returns {string}
142
- */
143
- addPerformanceCallback(callback) {
144
- return this.controller.addPerformanceCallback(callback);
145
- }
146
- /**
147
- * Removes a callback registered with addPerformanceCallback.
148
- *
149
- * @param {string} callbackId
150
- * @returns {boolean}
151
- */
152
- removePerformanceCallback(callbackId) {
153
- return this.controller.removePerformanceCallback(callbackId);
154
- }
155
- /**
156
- * Adds event listener that emits an event when a user account is added or removed from localstorage in a different browser tab or window
157
- */
158
- enableAccountStorageEvents() {
159
- this.controller.enableAccountStorageEvents();
160
- }
161
- /**
162
- * Removes event listener that emits an event when a user account is added or removed from localstorage in a different browser tab or window
163
- */
164
- disableAccountStorageEvents() {
165
- this.controller.disableAccountStorageEvents();
166
- }
167
- /**
168
- * Returns the first account found in the cache that matches the account filter passed in.
169
- * @param accountFilter
170
- * @returns The first account found in the cache matching the provided filter or null if no account could be found.
171
- */
172
- getAccount(accountFilter) {
173
- return this.controller.getAccount(accountFilter);
174
- }
175
- /**
176
- * Returns the signed in account matching homeAccountId.
177
- * (the account object is created at the time of successful login)
178
- * or null when no matching account is found
179
- * @param homeAccountId
180
- * @returns The account object stored in MSAL
181
- * @deprecated - Use getAccount instead
182
- */
183
- getAccountByHomeId(homeAccountId) {
184
- return this.controller.getAccountByHomeId(homeAccountId);
185
- }
186
- /**
187
- * Returns the signed in account matching localAccountId.
188
- * (the account object is created at the time of successful login)
189
- * or null when no matching account is found
190
- * @param localAccountId
191
- * @returns The account object stored in MSAL
192
- * @deprecated - Use getAccount instead
193
- */
194
- getAccountByLocalId(localId) {
195
- return this.controller.getAccountByLocalId(localId);
196
- }
197
- /**
198
- * Returns the signed in account matching username.
199
- * (the account object is created at the time of successful login)
200
- * or null when no matching account is found.
201
- * This API is provided for convenience but getAccountById should be used for best reliability
202
- * @param userName
203
- * @returns The account object stored in MSAL
204
- * @deprecated - Use getAccount instead
205
- */
206
- getAccountByUsername(userName) {
207
- return this.controller.getAccountByUsername(userName);
208
- }
209
- /**
210
- * Returns all the accounts in the cache that match the optional filter. If no filter is provided, all accounts are returned.
211
- * @param accountFilter - (Optional) filter to narrow down the accounts returned
212
- * @returns Array of AccountInfo objects in cache
213
- */
214
- getAllAccounts(accountFilter) {
215
- return this.controller.getAllAccounts(accountFilter);
216
- }
217
- /**
218
- * Event handler function which allows users to fire events after the PublicClientApplication object
219
- * has loaded during redirect flows. This should be invoked on all page loads involved in redirect
220
- * auth flows.
221
- * @param hash Hash to process. Defaults to the current value of window.location.hash. Only needs to be provided explicitly if the response to be handled is not contained in the current value.
222
- * @returns Token response or null. If the return value is null, then no auth redirect was detected.
223
- */
224
- handleRedirectPromise(hash) {
225
- return this.controller.handleRedirectPromise(hash);
226
- }
227
- /**
228
- * Use when initiating the login process via opening a popup window in the user's browser
229
- *
230
- * @param request
231
- *
232
- * @returns A promise that is fulfilled when this function has completed, or rejected if an error was raised.
233
- */
234
- loginPopup(request) {
235
- return this.controller.loginPopup(request);
236
- }
237
- /**
238
- * Use when initiating the login process by redirecting the user's browser to the authorization endpoint. This function redirects the page, so
239
- * any code that follows this function will not execute.
240
- *
241
- * IMPORTANT: It is NOT recommended to have code that is dependent on the resolution of the Promise. This function will navigate away from the current
242
- * browser window. It currently returns a Promise in order to reflect the asynchronous nature of the code running in this function.
243
- *
244
- * @param request
245
- */
246
- loginRedirect(request) {
247
- return this.controller.loginRedirect(request);
248
- }
249
- /**
250
- * Deprecated logout function. Use logoutRedirect or logoutPopup instead
251
- * @param logoutRequest
252
- * @deprecated
253
- */
254
- logout(logoutRequest) {
255
- return this.controller.logout(logoutRequest);
256
- }
257
- /**
258
- * Use to log out the current user, and redirect the user to the postLogoutRedirectUri.
259
- * Default behaviour is to redirect the user to `window.location.href`.
260
- * @param logoutRequest
261
- */
262
- logoutRedirect(logoutRequest) {
263
- return this.controller.logoutRedirect(logoutRequest);
264
- }
265
- /**
266
- * Clears local cache for the current user then opens a popup window prompting the user to sign-out of the server
267
- * @param logoutRequest
268
- */
269
- logoutPopup(logoutRequest) {
270
- return this.controller.logoutPopup(logoutRequest);
271
- }
272
- /**
273
- * This function uses a hidden iframe to fetch an authorization code from the eSTS. There are cases where this may not work:
274
- * - Any browser using a form of Intelligent Tracking Prevention
275
- * - If there is not an established session with the service
276
- *
277
- * In these cases, the request must be done inside a popup or full frame redirect.
278
- *
279
- * For the cases where interaction is required, you cannot send a request with prompt=none.
280
- *
281
- * If your refresh token has expired, you can use this function to fetch a new set of tokens silently as long as
282
- * you session on the server still exists.
283
- * @param request {@link SsoSilentRequest}
284
- *
285
- * @returns A promise that is fulfilled when this function has completed, or rejected if an error was raised.
286
- */
287
- ssoSilent(request) {
288
- return this.controller.ssoSilent(request);
289
- }
290
- /**
291
- * Gets the token cache for the application.
292
- */
293
- getTokenCache() {
294
- return this.controller.getTokenCache();
295
- }
296
- /**
297
- * Returns the logger instance
298
- */
299
- getLogger() {
300
- return this.controller.getLogger();
301
- }
302
- /**
303
- * Replaces the default logger set in configurations with new Logger with new configurations
304
- * @param logger Logger instance
305
- */
306
- setLogger(logger) {
307
- this.controller.setLogger(logger);
308
- }
309
- /**
310
- * Sets the account to use as the active account. If no account is passed to the acquireToken APIs, then MSAL will use this active account.
311
- * @param account
312
- */
313
- setActiveAccount(account) {
314
- this.controller.setActiveAccount(account);
315
- }
316
- /**
317
- * Gets the currently active account
318
- */
319
- getActiveAccount() {
320
- return this.controller.getActiveAccount();
321
- }
322
- /**
323
- * Called by wrapper libraries (Angular & React) to set SKU and Version passed down to telemetry, logger, etc.
324
- * @param sku
325
- * @param version
326
- */
327
- initializeWrapperLibrary(sku, version) {
328
- return this.controller.initializeWrapperLibrary(sku, version);
329
- }
330
- /**
331
- * Sets navigation client
332
- * @param navigationClient
333
- */
334
- setNavigationClient(navigationClient) {
335
- this.controller.setNavigationClient(navigationClient);
336
- }
337
- /**
338
- * Returns the configuration object
339
- * @internal
340
- */
341
- getConfiguration() {
342
- return this.controller.getConfiguration();
343
- }
344
- /**
345
- * Hydrates cache with the tokens and account in the AuthenticationResult object
346
- * @param result
347
- * @param request - The request object that was used to obtain the AuthenticationResult
348
- * @returns
349
- */
350
- async hydrateCache(result, request) {
351
- return this.controller.hydrateCache(result, request);
352
- }
353
- /**
354
- * Clears tokens and account from the browser cache.
355
- * @param logoutRequest
356
- */
357
- clearCache(logoutRequest) {
358
- return this.controller.clearCache(logoutRequest);
359
- }
7
+ /*
8
+ * Copyright (c) Microsoft Corporation. All rights reserved.
9
+ * Licensed under the MIT License.
10
+ */
11
+ /**
12
+ * PublicClientNext is an early look at the planned implementation of PublicClientApplication in the next major version of MSAL.js.
13
+ * It contains support for multiple API implementations based on the runtime environment that it is running in.
14
+ *
15
+ * The goals of these changes are to provide a clean separation of behavior between different operating contexts (Nested App Auth, Platform Brokers, Plain old Browser, etc.)
16
+ * while still providing a consistent API surface for developers.
17
+ *
18
+ * Please use PublicClientApplication for any prod/real-world scenarios.
19
+ * Note: PublicClientNext is experimental and subject to breaking changes without following semver
20
+ *
21
+ */
22
+ class PublicClientNext {
23
+ static async createPublicClientApplication(configuration) {
24
+ const controller = await createController(configuration);
25
+ let pca;
26
+ if (controller !== null) {
27
+ pca = new PublicClientNext(configuration, controller);
28
+ }
29
+ else {
30
+ pca = new PublicClientNext(configuration);
31
+ }
32
+ return pca;
33
+ }
34
+ /**
35
+ * @constructor
36
+ * Constructor for the PublicClientNext used to instantiate the PublicClientNext object
37
+ *
38
+ * Important attributes in the Configuration object for auth are:
39
+ * - clientID: the application ID of your application. You can obtain one by registering your application with our Application registration portal : https://portal.azure.com/#blade/Microsoft_AAD_IAM/ActiveDirectoryMenuBlade/RegisteredAppsPreview
40
+ * - authority: the authority URL for your application.
41
+ * - redirect_uri: the uri of your application registered in the portal.
42
+ *
43
+ * In Azure AD, authority is a URL indicating the Azure active directory that MSAL uses to obtain tokens.
44
+ * It is of the form https://login.microsoftonline.com/{Enter_the_Tenant_Info_Here}
45
+ * If your application supports Accounts in one organizational directory, replace "Enter_the_Tenant_Info_Here" value with the Tenant Id or Tenant name (for example, contoso.microsoft.com).
46
+ * If your application supports Accounts in any organizational directory, replace "Enter_the_Tenant_Info_Here" value with organizations.
47
+ * If your application supports Accounts in any organizational directory and personal Microsoft accounts, replace "Enter_the_Tenant_Info_Here" value with common.
48
+ * To restrict support to Personal Microsoft accounts only, replace "Enter_the_Tenant_Info_Here" value with consumers.
49
+ *
50
+ * In Azure B2C, authority is of the form https://{instance}/tfp/{tenant}/{policyName}/
51
+ * Full B2C functionality will be available in this library in future versions.
52
+ *
53
+ * @param configuration Object for the MSAL PublicClientApplication instance
54
+ * @param IController Optional parameter to explictly set the controller. (Will be removed when we remove public constructor)
55
+ */
56
+ constructor(configuration, controller) {
57
+ this.configuration = configuration;
58
+ if (controller) {
59
+ this.controller = controller;
60
+ }
61
+ else {
62
+ const operatingContext = new UnknownOperatingContext(configuration);
63
+ this.controller = new UnknownOperatingContextController(operatingContext);
64
+ }
65
+ }
66
+ /**
67
+ * Initializer function to perform async startup tasks such as connecting to WAM extension
68
+ */
69
+ async initialize() {
70
+ if (this.controller instanceof UnknownOperatingContextController) {
71
+ const result = await createController(this.configuration);
72
+ if (result !== null) {
73
+ this.controller = result;
74
+ }
75
+ return this.controller.initialize();
76
+ }
77
+ return Promise.resolve();
78
+ }
79
+ /**
80
+ * Use when you want to obtain an access_token for your API via opening a popup window in the user's browser
81
+ *
82
+ * @param request
83
+ *
84
+ * @returns A promise that is fulfilled when this function has completed, or rejected if an error was raised.
85
+ */
86
+ async acquireTokenPopup(request) {
87
+ return this.controller.acquireTokenPopup(request);
88
+ }
89
+ /**
90
+ * Use when you want to obtain an access_token for your API by redirecting the user's browser window to the authorization endpoint. This function redirects
91
+ * the page, so any code that follows this function will not execute.
92
+ *
93
+ * IMPORTANT: It is NOT recommended to have code that is dependent on the resolution of the Promise. This function will navigate away from the current
94
+ * browser window. It currently returns a Promise in order to reflect the asynchronous nature of the code running in this function.
95
+ *
96
+ * @param request
97
+ */
98
+ acquireTokenRedirect(request) {
99
+ return this.controller.acquireTokenRedirect(request);
100
+ }
101
+ /**
102
+ * Silently acquire an access token for a given set of scopes. Returns currently processing promise if parallel requests are made.
103
+ *
104
+ * @param {@link (SilentRequest:type)}
105
+ * @returns {Promise.<AuthenticationResult>} - a promise that is fulfilled when this function has completed, or rejected if an error was raised. Returns the {@link AuthenticationResult} object
106
+ */
107
+ acquireTokenSilent(silentRequest) {
108
+ return this.controller.acquireTokenSilent(silentRequest);
109
+ }
110
+ /**
111
+ * This function redeems an authorization code (passed as code) from the eSTS token endpoint.
112
+ * This authorization code should be acquired server-side using a confidential client to acquire a spa_code.
113
+ * This API is not indended for normal authorization code acquisition and redemption.
114
+ *
115
+ * Redemption of this authorization code will not require PKCE, as it was acquired by a confidential client.
116
+ *
117
+ * @param request {@link AuthorizationCodeRequest}
118
+ * @returns A promise that is fulfilled when this function has completed, or rejected if an error was raised.
119
+ */
120
+ acquireTokenByCode(request) {
121
+ return this.controller.acquireTokenByCode(request);
122
+ }
123
+ /**
124
+ * Adds event callbacks to array
125
+ * @param callback
126
+ */
127
+ addEventCallback(callback) {
128
+ return this.controller.addEventCallback(callback);
129
+ }
130
+ /**
131
+ * Removes callback with provided id from callback array
132
+ * @param callbackId
133
+ */
134
+ removeEventCallback(callbackId) {
135
+ return this.controller.removeEventCallback(callbackId);
136
+ }
137
+ /**
138
+ * Registers a callback to receive performance events.
139
+ *
140
+ * @param {PerformanceCallbackFunction} callback
141
+ * @returns {string}
142
+ */
143
+ addPerformanceCallback(callback) {
144
+ return this.controller.addPerformanceCallback(callback);
145
+ }
146
+ /**
147
+ * Removes a callback registered with addPerformanceCallback.
148
+ *
149
+ * @param {string} callbackId
150
+ * @returns {boolean}
151
+ */
152
+ removePerformanceCallback(callbackId) {
153
+ return this.controller.removePerformanceCallback(callbackId);
154
+ }
155
+ /**
156
+ * Adds event listener that emits an event when a user account is added or removed from localstorage in a different browser tab or window
157
+ */
158
+ enableAccountStorageEvents() {
159
+ this.controller.enableAccountStorageEvents();
160
+ }
161
+ /**
162
+ * Removes event listener that emits an event when a user account is added or removed from localstorage in a different browser tab or window
163
+ */
164
+ disableAccountStorageEvents() {
165
+ this.controller.disableAccountStorageEvents();
166
+ }
167
+ /**
168
+ * Returns the first account found in the cache that matches the account filter passed in.
169
+ * @param accountFilter
170
+ * @returns The first account found in the cache matching the provided filter or null if no account could be found.
171
+ */
172
+ getAccount(accountFilter) {
173
+ return this.controller.getAccount(accountFilter);
174
+ }
175
+ /**
176
+ * Returns the signed in account matching homeAccountId.
177
+ * (the account object is created at the time of successful login)
178
+ * or null when no matching account is found
179
+ * @param homeAccountId
180
+ * @returns The account object stored in MSAL
181
+ * @deprecated - Use getAccount instead
182
+ */
183
+ getAccountByHomeId(homeAccountId) {
184
+ return this.controller.getAccountByHomeId(homeAccountId);
185
+ }
186
+ /**
187
+ * Returns the signed in account matching localAccountId.
188
+ * (the account object is created at the time of successful login)
189
+ * or null when no matching account is found
190
+ * @param localAccountId
191
+ * @returns The account object stored in MSAL
192
+ * @deprecated - Use getAccount instead
193
+ */
194
+ getAccountByLocalId(localId) {
195
+ return this.controller.getAccountByLocalId(localId);
196
+ }
197
+ /**
198
+ * Returns the signed in account matching username.
199
+ * (the account object is created at the time of successful login)
200
+ * or null when no matching account is found.
201
+ * This API is provided for convenience but getAccountById should be used for best reliability
202
+ * @param userName
203
+ * @returns The account object stored in MSAL
204
+ * @deprecated - Use getAccount instead
205
+ */
206
+ getAccountByUsername(userName) {
207
+ return this.controller.getAccountByUsername(userName);
208
+ }
209
+ /**
210
+ * Returns all the accounts in the cache that match the optional filter. If no filter is provided, all accounts are returned.
211
+ * @param accountFilter - (Optional) filter to narrow down the accounts returned
212
+ * @returns Array of AccountInfo objects in cache
213
+ */
214
+ getAllAccounts(accountFilter) {
215
+ return this.controller.getAllAccounts(accountFilter);
216
+ }
217
+ /**
218
+ * Event handler function which allows users to fire events after the PublicClientApplication object
219
+ * has loaded during redirect flows. This should be invoked on all page loads involved in redirect
220
+ * auth flows.
221
+ * @param hash Hash to process. Defaults to the current value of window.location.hash. Only needs to be provided explicitly if the response to be handled is not contained in the current value.
222
+ * @returns Token response or null. If the return value is null, then no auth redirect was detected.
223
+ */
224
+ handleRedirectPromise(hash) {
225
+ return this.controller.handleRedirectPromise(hash);
226
+ }
227
+ /**
228
+ * Use when initiating the login process via opening a popup window in the user's browser
229
+ *
230
+ * @param request
231
+ *
232
+ * @returns A promise that is fulfilled when this function has completed, or rejected if an error was raised.
233
+ */
234
+ loginPopup(request) {
235
+ return this.controller.loginPopup(request);
236
+ }
237
+ /**
238
+ * Use when initiating the login process by redirecting the user's browser to the authorization endpoint. This function redirects the page, so
239
+ * any code that follows this function will not execute.
240
+ *
241
+ * IMPORTANT: It is NOT recommended to have code that is dependent on the resolution of the Promise. This function will navigate away from the current
242
+ * browser window. It currently returns a Promise in order to reflect the asynchronous nature of the code running in this function.
243
+ *
244
+ * @param request
245
+ */
246
+ loginRedirect(request) {
247
+ return this.controller.loginRedirect(request);
248
+ }
249
+ /**
250
+ * Deprecated logout function. Use logoutRedirect or logoutPopup instead
251
+ * @param logoutRequest
252
+ * @deprecated
253
+ */
254
+ logout(logoutRequest) {
255
+ return this.controller.logout(logoutRequest);
256
+ }
257
+ /**
258
+ * Use to log out the current user, and redirect the user to the postLogoutRedirectUri.
259
+ * Default behaviour is to redirect the user to `window.location.href`.
260
+ * @param logoutRequest
261
+ */
262
+ logoutRedirect(logoutRequest) {
263
+ return this.controller.logoutRedirect(logoutRequest);
264
+ }
265
+ /**
266
+ * Clears local cache for the current user then opens a popup window prompting the user to sign-out of the server
267
+ * @param logoutRequest
268
+ */
269
+ logoutPopup(logoutRequest) {
270
+ return this.controller.logoutPopup(logoutRequest);
271
+ }
272
+ /**
273
+ * This function uses a hidden iframe to fetch an authorization code from the eSTS. There are cases where this may not work:
274
+ * - Any browser using a form of Intelligent Tracking Prevention
275
+ * - If there is not an established session with the service
276
+ *
277
+ * In these cases, the request must be done inside a popup or full frame redirect.
278
+ *
279
+ * For the cases where interaction is required, you cannot send a request with prompt=none.
280
+ *
281
+ * If your refresh token has expired, you can use this function to fetch a new set of tokens silently as long as
282
+ * you session on the server still exists.
283
+ * @param request {@link SsoSilentRequest}
284
+ *
285
+ * @returns A promise that is fulfilled when this function has completed, or rejected if an error was raised.
286
+ */
287
+ ssoSilent(request) {
288
+ return this.controller.ssoSilent(request);
289
+ }
290
+ /**
291
+ * Gets the token cache for the application.
292
+ */
293
+ getTokenCache() {
294
+ return this.controller.getTokenCache();
295
+ }
296
+ /**
297
+ * Returns the logger instance
298
+ */
299
+ getLogger() {
300
+ return this.controller.getLogger();
301
+ }
302
+ /**
303
+ * Replaces the default logger set in configurations with new Logger with new configurations
304
+ * @param logger Logger instance
305
+ */
306
+ setLogger(logger) {
307
+ this.controller.setLogger(logger);
308
+ }
309
+ /**
310
+ * Sets the account to use as the active account. If no account is passed to the acquireToken APIs, then MSAL will use this active account.
311
+ * @param account
312
+ */
313
+ setActiveAccount(account) {
314
+ this.controller.setActiveAccount(account);
315
+ }
316
+ /**
317
+ * Gets the currently active account
318
+ */
319
+ getActiveAccount() {
320
+ return this.controller.getActiveAccount();
321
+ }
322
+ /**
323
+ * Called by wrapper libraries (Angular & React) to set SKU and Version passed down to telemetry, logger, etc.
324
+ * @param sku
325
+ * @param version
326
+ */
327
+ initializeWrapperLibrary(sku, version) {
328
+ return this.controller.initializeWrapperLibrary(sku, version);
329
+ }
330
+ /**
331
+ * Sets navigation client
332
+ * @param navigationClient
333
+ */
334
+ setNavigationClient(navigationClient) {
335
+ this.controller.setNavigationClient(navigationClient);
336
+ }
337
+ /**
338
+ * Returns the configuration object
339
+ * @internal
340
+ */
341
+ getConfiguration() {
342
+ return this.controller.getConfiguration();
343
+ }
344
+ /**
345
+ * Hydrates cache with the tokens and account in the AuthenticationResult object
346
+ * @param result
347
+ * @param request - The request object that was used to obtain the AuthenticationResult
348
+ * @returns
349
+ */
350
+ async hydrateCache(result, request) {
351
+ return this.controller.hydrateCache(result, request);
352
+ }
353
+ /**
354
+ * Clears tokens and account from the browser cache.
355
+ * @param logoutRequest
356
+ */
357
+ clearCache(logoutRequest) {
358
+ return this.controller.clearCache(logoutRequest);
359
+ }
360
360
  }
361
361
 
362
362
  export { PublicClientNext };