@azure/msal-browser 3.0.2 → 3.2.0

package/src/controllers/StandardController.ts

@@ -0,0 +1,2170 @@
+/*
+ * Copyright (c) Microsoft Corporation. All rights reserved.
+ * Licensed under the MIT License.
+ */
+
+import { CryptoOps } from "../crypto/CryptoOps";
+import {
+    InteractionRequiredAuthError,
+    AccountInfo,
+    Constants,
+    INetworkModule,
+    Logger,
+    CommonSilentFlowRequest,
+    ICrypto,
+    DEFAULT_CRYPTO_IMPLEMENTATION,
+    AuthError,
+    PerformanceEvents,
+    PerformanceCallbackFunction,
+    IPerformanceClient,
+    BaseAuthRequest,
+    PromptValue,
+    InProgressPerformanceEvent,
+    RequestThumbprint,
+    ServerError,
+    AccountEntity,
+    ServerResponseType,
+    UrlString,
+    invokeAsync,
+    createClientAuthError,
+    ClientAuthErrorCodes,
+    AccountFilter,
+} from "@azure/msal-common";
+import {
+    BrowserCacheManager,
+    DEFAULT_BROWSER_CACHE_MANAGER,
+} from "../cache/BrowserCacheManager";
+import { BrowserConfiguration, CacheOptions } from "../config/Configuration";
+import {
+    InteractionType,
+    ApiId,
+    BrowserCacheLocation,
+    WrapperSKU,
+    TemporaryCacheKeys,
+    CacheLookupPolicy,
+    DEFAULT_REQUEST,
+    BrowserConstants,
+} from "../utils/BrowserConstants";
+import { BrowserUtils } from "../utils/BrowserUtils";
+import { RedirectRequest } from "../request/RedirectRequest";
+import { PopupRequest } from "../request/PopupRequest";
+import { SsoSilentRequest } from "../request/SsoSilentRequest";
+import { EventCallbackFunction, EventError } from "../event/EventMessage";
+import { EventType } from "../event/EventType";
+import { EndSessionRequest } from "../request/EndSessionRequest";
+import {
+    BrowserConfigurationAuthErrorCodes,
+    createBrowserConfigurationAuthError,
+} from "../error/BrowserConfigurationAuthError";
+import { EndSessionPopupRequest } from "../request/EndSessionPopupRequest";
+import { INavigationClient } from "../navigation/INavigationClient";
+import { EventHandler } from "../event/EventHandler";
+import { PopupClient } from "../interaction_client/PopupClient";
+import { RedirectClient } from "../interaction_client/RedirectClient";
+import { SilentIframeClient } from "../interaction_client/SilentIframeClient";
+import { SilentRefreshClient } from "../interaction_client/SilentRefreshClient";
+import { TokenCache } from "../cache/TokenCache";
+import { ITokenCache } from "../cache/ITokenCache";
+import { NativeInteractionClient } from "../interaction_client/NativeInteractionClient";
+import { NativeMessageHandler } from "../broker/nativeBroker/NativeMessageHandler";
+import { SilentRequest } from "../request/SilentRequest";
+import {
+    NativeAuthError,
+    isFatalNativeAuthError,
+} from "../error/NativeAuthError";
+import { SilentCacheClient } from "../interaction_client/SilentCacheClient";
+import { SilentAuthCodeClient } from "../interaction_client/SilentAuthCodeClient";
+import {
+    createBrowserAuthError,
+    BrowserAuthErrorCodes,
+} from "../error/BrowserAuthError";
+import { AuthorizationCodeRequest } from "../request/AuthorizationCodeRequest";
+import { NativeTokenRequest } from "../broker/nativeBroker/NativeRequest";
+import { StandardOperatingContext } from "../operatingcontext/StandardOperatingContext";
+import { BaseOperatingContext } from "../operatingcontext/BaseOperatingContext";
+import { IController } from "./IController";
+import { AuthenticationResult } from "../response/AuthenticationResult";
+import { ClearCacheRequest } from "../request/ClearCacheRequest";
+import { createNewGuid } from "../crypto/BrowserCrypto";
+
+export class StandardController implements IController {
+    // OperatingContext
+    protected readonly operatingContext: StandardOperatingContext;
+
+    // Crypto interface implementation
+    protected readonly browserCrypto: ICrypto;
+
+    // Storage interface implementation
+    protected readonly browserStorage: BrowserCacheManager;
+
+    // Native Cache in memory storage implementation
+    protected readonly nativeInternalStorage: BrowserCacheManager;
+
+    // Network interface implementation
+    protected readonly networkClient: INetworkModule;
+
+    // Navigation interface implementation
+    protected navigationClient: INavigationClient;
+
+    // Input configuration by developer/user
+    protected readonly config: BrowserConfiguration;
+
+    // Token cache implementation
+    private tokenCache: TokenCache;
+
+    // Logger
+    protected logger: Logger;
+
+    // Flag to indicate if in browser environment
+    protected isBrowserEnvironment: boolean;
+
+    protected readonly eventHandler: EventHandler;
+
+    // Redirect Response Object
+    protected readonly redirectResponse: Map<
+        string,
+        Promise<AuthenticationResult | null>
+    >;
+
+    // Native Extension Provider
+    protected nativeExtensionProvider: NativeMessageHandler | undefined;
+
+    // Hybrid auth code responses
+    private hybridAuthCodeResponses: Map<string, Promise<AuthenticationResult>>;
+
+    // Performance telemetry client
+    protected readonly performanceClient: IPerformanceClient;
+
+    // Flag representing whether or not the initialize API has been called and completed
+    protected initialized: boolean;
+
+    // Active requests
+    private activeSilentTokenRequests: Map<
+        string,
+        Promise<AuthenticationResult>
+    >;
+    private atsAsyncMeasurement?: InProgressPerformanceEvent = undefined;
+
+    private ssoSilentMeasurement?: InProgressPerformanceEvent;
+    private acquireTokenByCodeAsyncMeasurement?: InProgressPerformanceEvent;
+    /**
+     * @constructor
+     * Constructor for the PublicClientApplication used to instantiate the PublicClientApplication object
+     *
+     * Important attributes in the Configuration object for auth are:
+     * - 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
+     * - authority: the authority URL for your application.
+     * - redirect_uri: the uri of your application registered in the portal.
+     *
+     * In Azure AD, authority is a URL indicating the Azure active directory that MSAL uses to obtain tokens.
+     * It is of the form https://login.microsoftonline.com/{Enter_the_Tenant_Info_Here}
+     * 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).
+     * If your application supports Accounts in any organizational directory, replace "Enter_the_Tenant_Info_Here" value with organizations.
+     * If your application supports Accounts in any organizational directory and personal Microsoft accounts, replace "Enter_the_Tenant_Info_Here" value with common.
+     * To restrict support to Personal Microsoft accounts only, replace "Enter_the_Tenant_Info_Here" value with consumers.
+     *
+     * In Azure B2C, authority is of the form https://{instance}/tfp/{tenant}/{policyName}/
+     * Full B2C functionality will be available in this library in future versions.
+     *
+     * @param configuration Object for the MSAL PublicClientApplication instance
+     */
+    constructor(operatingContext: StandardOperatingContext) {
+        this.operatingContext = operatingContext;
+        this.isBrowserEnvironment =
+            this.operatingContext.isBrowserEnvironment();
+        // Set the configuration.
+        this.config = operatingContext.getConfig();
+        this.initialized = false;
+
+        // Initialize logger
+        this.logger = this.operatingContext.getLogger();
+
+        // Initialize the network module class.
+        this.networkClient = this.config.system.networkClient;
+
+        // Initialize the navigation client class.
+        this.navigationClient = this.config.system.navigationClient;
+
+        // Initialize redirectResponse Map
+        this.redirectResponse = new Map();
+
+        // Initial hybrid spa map
+        this.hybridAuthCodeResponses = new Map();
+
+        // Initialize performance client
+        this.performanceClient = this.config.telemetry.client;
+
+        // Initialize the crypto class.
+        this.browserCrypto = this.isBrowserEnvironment
+            ? new CryptoOps(this.logger, this.performanceClient)
+            : DEFAULT_CRYPTO_IMPLEMENTATION;
+
+        this.eventHandler = new EventHandler(this.logger, this.browserCrypto);
+
+        // Initialize the browser storage class.
+        this.browserStorage = this.isBrowserEnvironment
+            ? new BrowserCacheManager(
+                  this.config.auth.clientId,
+                  this.config.cache,
+                  this.browserCrypto,
+                  this.logger
+              )
+            : DEFAULT_BROWSER_CACHE_MANAGER(
+                  this.config.auth.clientId,
+                  this.logger
+              );
+
+        // initialize in memory storage for native flows
+        const nativeCacheOptions: Required<CacheOptions> = {
+            cacheLocation: BrowserCacheLocation.MemoryStorage,
+            temporaryCacheLocation: BrowserCacheLocation.MemoryStorage,
+            storeAuthStateInCookie: false,
+            secureCookies: false,
+            cacheMigrationEnabled: false,
+            claimsBasedCachingEnabled: false,
+        };
+        this.nativeInternalStorage = new BrowserCacheManager(
+            this.config.auth.clientId,
+            nativeCacheOptions,
+            this.browserCrypto,
+            this.logger
+        );
+
+        // Initialize the token cache
+        this.tokenCache = new TokenCache(
+            this.config,
+            this.browserStorage,
+            this.logger,
+            this.browserCrypto
+        );
+
+        this.activeSilentTokenRequests = new Map();
+
+        // Register listener functions
+        this.trackPageVisibility = this.trackPageVisibility.bind(this);
+
+        // Register listener functions
+        this.trackPageVisibilityWithMeasurement =
+            this.trackPageVisibilityWithMeasurement.bind(this);
+    }
+
+    static async createController(
+        operatingContext: BaseOperatingContext
+    ): Promise<IController> {
+        const controller = new StandardController(operatingContext);
+        await controller.initialize();
+        return controller;
+    }
+
+    private trackPageVisibility(): void {
+        if (!this.atsAsyncMeasurement) {
+            return;
+        }
+        this.logger.info("Perf: Visibility change detected");
+        this.atsAsyncMeasurement.increment({
+            visibilityChangeCount: 1,
+        });
+    }
+
+    /**
+     * Initializer function to perform async startup tasks such as connecting to WAM extension
+     */
+    async initialize(): Promise<void> {
+        this.logger.trace("initialize called");
+        if (this.initialized) {
+            this.logger.info(
+                "initialize has already been called, exiting early."
+            );
+            return;
+        }
+
+        const allowNativeBroker = this.config.system.allowNativeBroker;
+        const initMeasurement = this.performanceClient.startMeasurement(
+            PerformanceEvents.InitializeClientApplication
+        );
+        this.eventHandler.emitEvent(EventType.INITIALIZE_START);
+
+        if (allowNativeBroker) {
+            try {
+                this.nativeExtensionProvider =
+                    await NativeMessageHandler.createProvider(
+                        this.logger,
+                        this.config.system.nativeBrokerHandshakeTimeout,
+                        this.performanceClient
+                    );
+            } catch (e) {
+                this.logger.verbose(e as string);
+            }
+        }
+
+        if (!this.config.cache.claimsBasedCachingEnabled) {
+            this.logger.verbose(
+                "Claims-based caching is disabled. Clearing the previous cache with claims"
+            );
+
+            await invokeAsync(
+                this.browserStorage.clearTokensAndKeysWithClaims.bind(
+                    this.browserStorage
+                ),
+                PerformanceEvents.ClearTokensAndKeysWithClaims,
+                this.logger,
+                this.performanceClient
+            )(this.performanceClient);
+        }
+
+        this.initialized = true;
+        this.eventHandler.emitEvent(EventType.INITIALIZE_END);
+
+        initMeasurement.end({ allowNativeBroker, success: true });
+    }
+
+    // #region Redirect Flow
+
+    /**
+     * Event handler function which allows users to fire events after the PublicClientApplication object
+     * has loaded during redirect flows. This should be invoked on all page loads involved in redirect
+     * auth flows.
+     * @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.
+     * @returns Token response or null. If the return value is null, then no auth redirect was detected.
+     */
+    async handleRedirectPromise(
+        hash?: string
+    ): Promise<AuthenticationResult | null> {
+        this.logger.verbose("handleRedirectPromise called");
+        // Block token acquisition before initialize has been called
+        BrowserUtils.blockAPICallsBeforeInitialize(this.initialized);
+
+        let foundServerResponse = hash;
+
+        if (
+            this.config.auth.OIDCOptions?.serverResponseType ===
+            ServerResponseType.QUERY
+        ) {
+            const url = window.location.href;
+            foundServerResponse = UrlString.parseQueryServerResponse(url);
+        }
+
+        const loggedInAccounts = this.getAllAccounts();
+        if (this.isBrowserEnvironment) {
+            /**
+             * Store the promise on the PublicClientApplication instance if this is the first invocation of handleRedirectPromise,
+             * otherwise return the promise from the first invocation. Prevents race conditions when handleRedirectPromise is called
+             * several times concurrently.
+             */
+            const redirectResponseKey =
+                foundServerResponse || Constants.EMPTY_STRING;
+            let response = this.redirectResponse.get(redirectResponseKey);
+            if (typeof response === "undefined") {
+                this.eventHandler.emitEvent(
+                    EventType.HANDLE_REDIRECT_START,
+                    InteractionType.Redirect
+                );
+                this.logger.verbose(
+                    "handleRedirectPromise has been called for the first time, storing the promise"
+                );
+
+                const request: NativeTokenRequest | null =
+                    this.browserStorage.getCachedNativeRequest();
+                let redirectResponse: Promise<AuthenticationResult | null>;
+                if (
+                    request &&
+                    NativeMessageHandler.isNativeAvailable(
+                        this.config,
+                        this.logger,
+                        this.nativeExtensionProvider
+                    ) &&
+                    this.nativeExtensionProvider &&
+                    !foundServerResponse
+                ) {
+                    this.logger.trace(
+                        "handleRedirectPromise - acquiring token from native platform"
+                    );
+                    const nativeClient = new NativeInteractionClient(
+                        this.config,
+                        this.browserStorage,
+                        this.browserCrypto,
+                        this.logger,
+                        this.eventHandler,
+                        this.navigationClient,
+                        ApiId.handleRedirectPromise,
+                        this.performanceClient,
+                        this.nativeExtensionProvider,
+                        request.accountId,
+                        this.nativeInternalStorage,
+                        request.correlationId
+                    );
+                    redirectResponse = nativeClient.handleRedirectPromise();
+                } else {
+                    this.logger.trace(
+                        "handleRedirectPromise - acquiring token from web flow"
+                    );
+                    const correlationId =
+                        this.browserStorage.getTemporaryCache(
+                            TemporaryCacheKeys.CORRELATION_ID,
+                            true
+                        ) || Constants.EMPTY_STRING;
+                    const redirectClient =
+                        this.createRedirectClient(correlationId);
+                    redirectResponse =
+                        redirectClient.handleRedirectPromise(
+                            foundServerResponse
+                        );
+                }
+
+                response = redirectResponse
+                    .then((result: AuthenticationResult | null) => {
+                        if (result) {
+                            // Emit login event if number of accounts change
+
+                            const isLoggingIn =
+                                loggedInAccounts.length <
+                                this.getAllAccounts().length;
+                            if (isLoggingIn) {
+                                this.eventHandler.emitEvent(
+                                    EventType.LOGIN_SUCCESS,
+                                    InteractionType.Redirect,
+                                    result
+                                );
+                                this.logger.verbose(
+                                    "handleRedirectResponse returned result, login success"
+                                );
+                            } else {
+                                this.eventHandler.emitEvent(
+                                    EventType.ACQUIRE_TOKEN_SUCCESS,
+                                    InteractionType.Redirect,
+                                    result
+                                );
+                                this.logger.verbose(
+                                    "handleRedirectResponse returned result, acquire token success"
+                                );
+                            }
+                        }
+                        this.eventHandler.emitEvent(
+                            EventType.HANDLE_REDIRECT_END,
+                            InteractionType.Redirect
+                        );
+
+                        return result;
+                    })
+                    .catch((e) => {
+                        // Emit login event if there is an account
+                        if (loggedInAccounts.length > 0) {
+                            this.eventHandler.emitEvent(
+                                EventType.ACQUIRE_TOKEN_FAILURE,
+                                InteractionType.Redirect,
+                                null,
+                                e as EventError
+                            );
+                        } else {
+                            this.eventHandler.emitEvent(
+                                EventType.LOGIN_FAILURE,
+                                InteractionType.Redirect,
+                                null,
+                                e as EventError
+                            );
+                        }
+                        this.eventHandler.emitEvent(
+                            EventType.HANDLE_REDIRECT_END,
+                            InteractionType.Redirect
+                        );
+
+                        throw e;
+                    });
+                this.redirectResponse.set(redirectResponseKey, response);
+            } else {
+                this.logger.verbose(
+                    "handleRedirectPromise has been called previously, returning the result from the first call"
+                );
+            }
+
+            return response;
+        }
+        this.logger.verbose(
+            "handleRedirectPromise returns null, not browser environment"
+        );
+        return null;
+    }
+
+    /**
+     * 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
+     * the page, so any code that follows this function will not execute.
+     *
+     * 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
+     * browser window. It currently returns a Promise in order to reflect the asynchronous nature of the code running in this function.
+     *
+     * @param request
+     */
+    async acquireTokenRedirect(request: RedirectRequest): Promise<void> {
+        // Preflight request
+        const correlationId = this.getRequestCorrelationId(request);
+        this.logger.verbose("acquireTokenRedirect called", correlationId);
+        this.preflightBrowserEnvironmentCheck(InteractionType.Redirect);
+
+        // If logged in, emit acquire token events
+        const isLoggedIn = this.getAllAccounts().length > 0;
+        if (isLoggedIn) {
+            this.eventHandler.emitEvent(
+                EventType.ACQUIRE_TOKEN_START,
+                InteractionType.Redirect,
+                request
+            );
+        } else {
+            this.eventHandler.emitEvent(
+                EventType.LOGIN_START,
+                InteractionType.Redirect,
+                request
+            );
+        }
+
+        let result: Promise<void>;
+
+        if (this.nativeExtensionProvider && this.canUseNative(request)) {
+            const nativeClient = new NativeInteractionClient(
+                this.config,
+                this.browserStorage,
+                this.browserCrypto,
+                this.logger,
+                this.eventHandler,
+                this.navigationClient,
+                ApiId.acquireTokenRedirect,
+                this.performanceClient,
+                this.nativeExtensionProvider,
+                this.getNativeAccountId(request),
+                this.nativeInternalStorage,
+                request.correlationId
+            );
+            result = nativeClient
+                .acquireTokenRedirect(request)
+                .catch((e: AuthError) => {
+                    if (
+                        e instanceof NativeAuthError &&
+                        isFatalNativeAuthError(e)
+                    ) {
+                        this.nativeExtensionProvider = undefined; // If extension gets uninstalled during session prevent future requests from continuing to attempt
+                        const redirectClient = this.createRedirectClient(
+                            request.correlationId
+                        );
+                        return redirectClient.acquireToken(request);
+                    } else if (e instanceof InteractionRequiredAuthError) {
+                        this.logger.verbose(
+                            "acquireTokenRedirect - Resolving interaction required error thrown by native broker by falling back to web flow"
+                        );
+                        const redirectClient = this.createRedirectClient(
+                            request.correlationId
+                        );
+                        return redirectClient.acquireToken(request);
+                    }
+                    this.getBrowserStorage().setInteractionInProgress(false);
+                    throw e;
+                });
+        } else {
+            const redirectClient = this.createRedirectClient(
+                request.correlationId
+            );
+            result = redirectClient.acquireToken(request);
+        }
+
+        return result.catch((e) => {
+            // If logged in, emit acquire token events
+            if (isLoggedIn) {
+                this.eventHandler.emitEvent(
+                    EventType.ACQUIRE_TOKEN_FAILURE,
+                    InteractionType.Redirect,
+                    null,
+                    e
+                );
+            } else {
+                this.eventHandler.emitEvent(
+                    EventType.LOGIN_FAILURE,
+                    InteractionType.Redirect,
+                    null,
+                    e
+                );
+            }
+            throw e;
+        });
+    }
+
+    // #endregion
+
+    // #region Popup Flow
+
+    /**
+     * Use when you want to obtain an access_token for your API via opening a popup window in the user's browser
+     *
+     * @param request
+     *
+     * @returns A promise that is fulfilled when this function has completed, or rejected if an error was raised.
+     */
+    acquireTokenPopup(request: PopupRequest): Promise<AuthenticationResult> {
+        const correlationId = this.getRequestCorrelationId(request);
+        const atPopupMeasurement = this.performanceClient.startMeasurement(
+            PerformanceEvents.AcquireTokenPopup,
+            correlationId
+        );
+
+        try {
+            this.logger.verbose("acquireTokenPopup called", correlationId);
+            this.preflightBrowserEnvironmentCheck(InteractionType.Popup);
+        } catch (e) {
+            // Since this function is syncronous we need to reject
+            return Promise.reject(e);
+        }
+
+        // If logged in, emit acquire token events
+        const loggedInAccounts = this.getAllAccounts();
+        if (loggedInAccounts.length > 0) {
+            this.eventHandler.emitEvent(
+                EventType.ACQUIRE_TOKEN_START,
+                InteractionType.Popup,
+                request
+            );
+        } else {
+            this.eventHandler.emitEvent(
+                EventType.LOGIN_START,
+                InteractionType.Popup,
+                request
+            );
+        }
+
+        let result: Promise<AuthenticationResult>;
+
+        if (this.canUseNative(request)) {
+            result = this.acquireTokenNative(request, ApiId.acquireTokenPopup)
+                .then((response) => {
+                    this.getBrowserStorage().setInteractionInProgress(false);
+                    atPopupMeasurement.end({
+                        success: true,
+                        isNativeBroker: true,
+                        requestId: response.requestId,
+                    });
+                    return response;
+                })
+                .catch((e: AuthError) => {
+                    if (
+                        e instanceof NativeAuthError &&
+                        isFatalNativeAuthError(e)
+                    ) {
+                        this.nativeExtensionProvider = undefined; // If extension gets uninstalled during session prevent future requests from continuing to attempt
+                        const popupClient = this.createPopupClient(
+                            request.correlationId
+                        );
+                        return popupClient.acquireToken(request);
+                    } else if (e instanceof InteractionRequiredAuthError) {
+                        this.logger.verbose(
+                            "acquireTokenPopup - Resolving interaction required error thrown by native broker by falling back to web flow"
+                        );
+                        const popupClient = this.createPopupClient(
+                            request.correlationId
+                        );
+                        return popupClient.acquireToken(request);
+                    }
+                    this.getBrowserStorage().setInteractionInProgress(false);
+                    throw e;
+                });
+        } else {
+            const popupClient = this.createPopupClient(request.correlationId);
+            result = popupClient.acquireToken(request);
+        }
+
+        return result
+            .then((result) => {
+                /*
+                 *  If logged in, emit acquire token events
+                 */
+                const isLoggingIn =
+                    loggedInAccounts.length < this.getAllAccounts().length;
+                if (isLoggingIn) {
+                    this.eventHandler.emitEvent(
+                        EventType.LOGIN_SUCCESS,
+                        InteractionType.Popup,
+                        result
+                    );
+                } else {
+                    this.eventHandler.emitEvent(
+                        EventType.ACQUIRE_TOKEN_SUCCESS,
+                        InteractionType.Popup,
+                        result
+                    );
+                }
+
+                atPopupMeasurement.add({
+                    accessTokenSize: result.accessToken.length,
+                    idTokenSize: result.idToken.length,
+                });
+                atPopupMeasurement.end({
+                    success: true,
+                    requestId: result.requestId,
+                });
+                return result;
+            })
+            .catch((e: AuthError) => {
+                if (loggedInAccounts.length > 0) {
+                    this.eventHandler.emitEvent(
+                        EventType.ACQUIRE_TOKEN_FAILURE,
+                        InteractionType.Popup,
+                        null,
+                        e
+                    );
+                } else {
+                    this.eventHandler.emitEvent(
+                        EventType.LOGIN_FAILURE,
+                        InteractionType.Popup,
+                        null,
+                        e
+                    );
+                }
+
+                atPopupMeasurement.end({
+                    errorCode: e.errorCode,
+                    subErrorCode: e.subError,
+                    success: false,
+                });
+                // Since this function is syncronous we need to reject
+                return Promise.reject(e);
+            });
+    }
+
+    private trackPageVisibilityWithMeasurement(): void {
+        const measurement =
+            this.ssoSilentMeasurement ||
+            this.acquireTokenByCodeAsyncMeasurement;
+        if (!measurement) {
+            return;
+        }
+
+        this.logger.info(
+            "Perf: Visibility change detected in ",
+            measurement.event.name
+        );
+        measurement.increment({
+            visibilityChangeCount: 1,
+        });
+    }
+    // #endregion
+
+    // #region Silent Flow
+
+    /**
+     * This function uses a hidden iframe to fetch an authorization code from the eSTS. There are cases where this may not work:
+     * - Any browser using a form of Intelligent Tracking Prevention
+     * - If there is not an established session with the service
+     *
+     * In these cases, the request must be done inside a popup or full frame redirect.
+     *
+     * For the cases where interaction is required, you cannot send a request with prompt=none.
+     *
+     * If your refresh token has expired, you can use this function to fetch a new set of tokens silently as long as
+     * you session on the server still exists.
+     * @param request {@link SsoSilentRequest}
+     *
+     * @returns A promise that is fulfilled when this function has completed, or rejected if an error was raised.
+     */
+    async ssoSilent(request: SsoSilentRequest): Promise<AuthenticationResult> {
+        const correlationId = this.getRequestCorrelationId(request);
+        const validRequest = {
+            ...request,
+            // will be PromptValue.NONE or PromptValue.NO_SESSION
+            prompt: request.prompt,
+            correlationId: correlationId,
+        };
+        this.preflightBrowserEnvironmentCheck(InteractionType.Silent);
+        this.ssoSilentMeasurement = this.performanceClient.startMeasurement(
+            PerformanceEvents.SsoSilent,
+            correlationId
+        );
+        this.ssoSilentMeasurement?.increment({
+            visibilityChangeCount: 0,
+        });
+        document.addEventListener(
+            "visibilitychange",
+            this.trackPageVisibilityWithMeasurement
+        );
+        this.logger.verbose("ssoSilent called", correlationId);
+        this.eventHandler.emitEvent(
+            EventType.SSO_SILENT_START,
+            InteractionType.Silent,
+            validRequest
+        );
+
+        let result: Promise<AuthenticationResult>;
+
+        if (this.canUseNative(validRequest)) {
+            result = this.acquireTokenNative(
+                validRequest,
+                ApiId.ssoSilent
+            ).catch((e: AuthError) => {
+                // If native token acquisition fails for availability reasons fallback to standard flow
+                if (e instanceof NativeAuthError && isFatalNativeAuthError(e)) {
+                    this.nativeExtensionProvider = undefined; // If extension gets uninstalled during session prevent future requests from continuing to attempt
+                    const silentIframeClient = this.createSilentIframeClient(
+                        validRequest.correlationId
+                    );
+                    return silentIframeClient.acquireToken(validRequest);
+                }
+                throw e;
+            });
+        } else {
+            const silentIframeClient = this.createSilentIframeClient(
+                validRequest.correlationId
+            );
+            result = silentIframeClient.acquireToken(validRequest);
+        }
+
+        return result
+            .then((response) => {
+                this.eventHandler.emitEvent(
+                    EventType.SSO_SILENT_SUCCESS,
+                    InteractionType.Silent,
+                    response
+                );
+                this.ssoSilentMeasurement?.add({
+                    accessTokenSize: response.accessToken.length,
+                    idTokenSize: response.idToken.length,
+                });
+                this.ssoSilentMeasurement?.end({
+                    success: true,
+                    isNativeBroker: response.fromNativeBroker,
+                    requestId: response.requestId,
+                });
+                return response;
+            })
+            .catch((e: AuthError) => {
+                this.eventHandler.emitEvent(
+                    EventType.SSO_SILENT_FAILURE,
+                    InteractionType.Silent,
+                    null,
+                    e
+                );
+                this.ssoSilentMeasurement?.end({
+                    errorCode: e.errorCode,
+                    subErrorCode: e.subError,
+                    success: false,
+                });
+                throw e;
+            })
+            .finally(() => {
+                document.removeEventListener(
+                    "visibilitychange",
+                    this.trackPageVisibilityWithMeasurement
+                );
+            });
+    }
+
+    /**
+     * This function redeems an authorization code (passed as code) from the eSTS token endpoint.
+     * This authorization code should be acquired server-side using a confidential client to acquire a spa_code.
+     * This API is not indended for normal authorization code acquisition and redemption.
+     *
+     * Redemption of this authorization code will not require PKCE, as it was acquired by a confidential client.
+     *
+     * @param request {@link AuthorizationCodeRequest}
+     * @returns A promise that is fulfilled when this function has completed, or rejected if an error was raised.
+     */
+    async acquireTokenByCode(
+        request: AuthorizationCodeRequest
+    ): Promise<AuthenticationResult> {
+        const correlationId = this.getRequestCorrelationId(request);
+        this.preflightBrowserEnvironmentCheck(InteractionType.Silent);
+        this.logger.trace("acquireTokenByCode called", correlationId);
+        this.eventHandler.emitEvent(
+            EventType.ACQUIRE_TOKEN_BY_CODE_START,
+            InteractionType.Silent,
+            request
+        );
+        const atbcMeasurement = this.performanceClient.startMeasurement(
+            PerformanceEvents.AcquireTokenByCode,
+            request.correlationId
+        );
+
+        try {
+            if (request.code && request.nativeAccountId) {
+                // Throw error in case server returns both spa_code and spa_accountid in exchange for auth code.
+                throw createBrowserAuthError(
+                    BrowserAuthErrorCodes.spaCodeAndNativeAccountIdPresent
+                );
+            } else if (request.code) {
+                const hybridAuthCode = request.code;
+                let response = this.hybridAuthCodeResponses.get(hybridAuthCode);
+                if (!response) {
+                    this.logger.verbose(
+                        "Initiating new acquireTokenByCode request",
+                        correlationId
+                    );
+                    response = this.acquireTokenByCodeAsync({
+                        ...request,
+                        correlationId,
+                    })
+                        .then((result: AuthenticationResult) => {
+                            this.eventHandler.emitEvent(
+                                EventType.ACQUIRE_TOKEN_BY_CODE_SUCCESS,
+                                InteractionType.Silent,
+                                result
+                            );
+                            this.hybridAuthCodeResponses.delete(hybridAuthCode);
+                            atbcMeasurement.add({
+                                accessTokenSize: result.accessToken.length,
+                                idTokenSize: result.idToken.length,
+                            });
+                            atbcMeasurement.end({
+                                success: true,
+                                isNativeBroker: result.fromNativeBroker,
+                                requestId: result.requestId,
+                            });
+                            return result;
+                        })
+                        .catch((error: AuthError) => {
+                            this.hybridAuthCodeResponses.delete(hybridAuthCode);
+                            this.eventHandler.emitEvent(
+                                EventType.ACQUIRE_TOKEN_BY_CODE_FAILURE,
+                                InteractionType.Silent,
+                                null,
+                                error
+                            );
+                            atbcMeasurement.end({
+                                errorCode: error.errorCode,
+                                subErrorCode: error.subError,
+                                success: false,
+                            });
+                            throw error;
+                        });
+                    this.hybridAuthCodeResponses.set(hybridAuthCode, response);
+                } else {
+                    this.logger.verbose(
+                        "Existing acquireTokenByCode request found",
+                        request.correlationId
+                    );
+                    atbcMeasurement.discard();
+                }
+                return response;
+            } else if (request.nativeAccountId) {
+                if (this.canUseNative(request, request.nativeAccountId)) {
+                    return this.acquireTokenNative(
+                        request,
+                        ApiId.acquireTokenByCode,
+                        request.nativeAccountId
+                    ).catch((e: AuthError) => {
+                        // If native token acquisition fails for availability reasons fallback to standard flow
+                        if (
+                            e instanceof NativeAuthError &&
+                            isFatalNativeAuthError(e)
+                        ) {
+                            this.nativeExtensionProvider = undefined; // If extension gets uninstalled during session prevent future requests from continuing to attempt
+                        }
+                        throw e;
+                    });
+                } else {
+                    throw createBrowserAuthError(
+                        BrowserAuthErrorCodes.unableToAcquireTokenFromNativePlatform
+                    );
+                }
+            } else {
+                throw createBrowserAuthError(
+                    BrowserAuthErrorCodes.authCodeOrNativeAccountIdRequired
+                );
+            }
+        } catch (e) {
+            this.eventHandler.emitEvent(
+                EventType.ACQUIRE_TOKEN_BY_CODE_FAILURE,
+                InteractionType.Silent,
+                null,
+                e as EventError
+            );
+            atbcMeasurement.end({
+                errorCode: (e instanceof AuthError && e.errorCode) || undefined,
+                subErrorCode:
+                    (e instanceof AuthError && e.subError) || undefined,
+                success: false,
+            });
+            throw e;
+        }
+    }
+
+    /**
+     * Creates a SilentAuthCodeClient to redeem an authorization code.
+     * @param request
+     * @returns Result of the operation to redeem the authorization code
+     */
+    private async acquireTokenByCodeAsync(
+        request: AuthorizationCodeRequest
+    ): Promise<AuthenticationResult> {
+        this.logger.trace(
+            "acquireTokenByCodeAsync called",
+            request.correlationId
+        );
+        this.acquireTokenByCodeAsyncMeasurement =
+            this.performanceClient.startMeasurement(
+                PerformanceEvents.AcquireTokenByCodeAsync,
+                request.correlationId
+            );
+        this.acquireTokenByCodeAsyncMeasurement?.increment({
+            visibilityChangeCount: 0,
+        });
+        document.addEventListener(
+            "visibilitychange",
+            this.trackPageVisibilityWithMeasurement
+        );
+        const silentAuthCodeClient = this.createSilentAuthCodeClient(
+            request.correlationId
+        );
+        const silentTokenResult = await silentAuthCodeClient
+            .acquireToken(request)
+            .then((response) => {
+                this.acquireTokenByCodeAsyncMeasurement?.end({
+                    success: true,
+                    fromCache: response.fromCache,
+                    isNativeBroker: response.fromNativeBroker,
+                    requestId: response.requestId,
+                });
+                return response;
+            })
+            .catch((tokenRenewalError: AuthError) => {
+                this.acquireTokenByCodeAsyncMeasurement?.end({
+                    errorCode: tokenRenewalError.errorCode,
+                    subErrorCode: tokenRenewalError.subError,
+                    success: false,
+                });
+                throw tokenRenewalError;
+            })
+            .finally(() => {
+                document.removeEventListener(
+                    "visibilitychange",
+                    this.trackPageVisibilityWithMeasurement
+                );
+            });
+        return silentTokenResult;
+    }
+
+    /**
+     * Attempt to acquire an access token from the cache
+     * @param silentCacheClient SilentCacheClient
+     * @param commonRequest CommonSilentFlowRequest
+     * @param silentRequest SilentRequest
+     * @returns A promise that, when resolved, returns the access token
+     */
+    protected async acquireTokenFromCache(
+        silentCacheClient: SilentCacheClient,
+        commonRequest: CommonSilentFlowRequest,
+        silentRequest: SilentRequest
+    ): Promise<AuthenticationResult> {
+        this.performanceClient.addQueueMeasurement(
+            PerformanceEvents.AcquireTokenFromCache,
+            commonRequest.correlationId
+        );
+        switch (silentRequest.cacheLookupPolicy) {
+            case CacheLookupPolicy.Default:
+            case CacheLookupPolicy.AccessToken:
+            case CacheLookupPolicy.AccessTokenAndRefreshToken:
+                return invokeAsync(
+                    silentCacheClient.acquireToken.bind(silentCacheClient),
+                    PerformanceEvents.SilentCacheClientAcquireToken,
+                    this.logger,
+                    this.performanceClient,
+                    commonRequest.correlationId
+                )(commonRequest);
+            default:
+                throw createClientAuthError(
+                    ClientAuthErrorCodes.tokenRefreshRequired
+                );
+        }
+    }
+
+    /**
+     * Attempt to acquire an access token via a refresh token
+     * @param commonRequest CommonSilentFlowRequest
+     * @param silentRequest SilentRequest
+     * @returns A promise that, when resolved, returns the access token
+     */
+    public async acquireTokenByRefreshToken(
+        commonRequest: CommonSilentFlowRequest,
+        silentRequest: SilentRequest
+    ): Promise<AuthenticationResult> {
+        this.performanceClient.addQueueMeasurement(
+            PerformanceEvents.AcquireTokenByRefreshToken,
+            commonRequest.correlationId
+        );
+        switch (silentRequest.cacheLookupPolicy) {
+            case CacheLookupPolicy.Default:
+            case CacheLookupPolicy.AccessTokenAndRefreshToken:
+            case CacheLookupPolicy.RefreshToken:
+            case CacheLookupPolicy.RefreshTokenAndNetwork:
+                const silentRefreshClient = this.createSilentRefreshClient(
+                    commonRequest.correlationId
+                );
+
+                return invokeAsync(
+                    silentRefreshClient.acquireToken.bind(silentRefreshClient),
+                    PerformanceEvents.SilentRefreshClientAcquireToken,
+                    this.logger,
+                    this.performanceClient,
+                    commonRequest.correlationId
+                )(commonRequest);
+            default:
+                throw createClientAuthError(
+                    ClientAuthErrorCodes.tokenRefreshRequired
+                );
+        }
+    }
+
+    /**
+     * Attempt to acquire an access token via an iframe
+     * @param request CommonSilentFlowRequest
+     * @returns A promise that, when resolved, returns the access token
+     */
+    protected async acquireTokenBySilentIframe(
+        request: CommonSilentFlowRequest
+    ): Promise<AuthenticationResult> {
+        this.performanceClient.addQueueMeasurement(
+            PerformanceEvents.AcquireTokenBySilentIframe,
+            request.correlationId
+        );
+
+        const silentIframeClient = this.createSilentIframeClient(
+            request.correlationId
+        );
+
+        return invokeAsync(
+            silentIframeClient.acquireToken.bind(silentIframeClient),
+            PerformanceEvents.SilentIframeClientAcquireToken,
+            this.logger,
+            this.performanceClient,
+            request.correlationId
+        )(request);
+    }
+
+    // #endregion
+
+    // #region Logout
+
+    /**
+     * Deprecated logout function. Use logoutRedirect or logoutPopup instead
+     * @param logoutRequest
+     * @deprecated
+     */
+    async logout(logoutRequest?: EndSessionRequest): Promise<void> {
+        const correlationId = this.getRequestCorrelationId(logoutRequest);
+        this.logger.warning(
+            "logout API is deprecated and will be removed in msal-browser v3.0.0. Use logoutRedirect instead.",
+            correlationId
+        );
+        return this.logoutRedirect({
+            correlationId,
+            ...logoutRequest,
+        });
+    }
+
+    /**
+     * Use to log out the current user, and redirect the user to the postLogoutRedirectUri.
+     * Default behaviour is to redirect the user to `window.location.href`.
+     * @param logoutRequest
+     */
+    async logoutRedirect(logoutRequest?: EndSessionRequest): Promise<void> {
+        const correlationId = this.getRequestCorrelationId(logoutRequest);
+        this.preflightBrowserEnvironmentCheck(InteractionType.Redirect);
+
+        const redirectClient = this.createRedirectClient(correlationId);
+        return redirectClient.logout(logoutRequest);
+    }
+
+    /**
+     * Clears local cache for the current user then opens a popup window prompting the user to sign-out of the server
+     * @param logoutRequest
+     */
+    logoutPopup(logoutRequest?: EndSessionPopupRequest): Promise<void> {
+        try {
+            const correlationId = this.getRequestCorrelationId(logoutRequest);
+            this.preflightBrowserEnvironmentCheck(InteractionType.Popup);
+            const popupClient = this.createPopupClient(correlationId);
+            return popupClient.logout(logoutRequest);
+        } catch (e) {
+            // Since this function is syncronous we need to reject
+            return Promise.reject(e);
+        }
+    }
+
+    /**
+     * Creates a cache interaction client to clear broswer cache.
+     * @param logoutRequest
+     */
+    async clearCache(logoutRequest?: ClearCacheRequest): Promise<void> {
+        const correlationId = this.getRequestCorrelationId(logoutRequest);
+        const cacheClient = this.createSilentCacheClient(correlationId);
+        return cacheClient.logout(logoutRequest);
+    }
+
+    // #endregion
+
+    // #region Account APIs
+
+    /**
+     * Returns all the accounts in the cache that match the optional filter. If no filter is provided, all accounts are returned.
+     * @param accountFilter - (Optional) filter to narrow down the accounts returned
+     * @returns Array of AccountInfo objects in cache
+     */
+    getAllAccounts(accountFilter?: AccountFilter): AccountInfo[] {
+        this.logger.verbose("getAllAccounts called");
+        return this.isBrowserEnvironment
+            ? this.browserStorage.getAllAccounts(accountFilter)
+            : [];
+    }
+
+    /**
+     * Returns the first account found in the cache that matches the account filter passed in.
+     * @param accountFilter
+     * @returns The first account found in the cache matching the provided filter or null if no account could be found.
+     */
+    getAccount(accountFilter: AccountFilter): AccountInfo | null {
+        this.logger.trace("getAccount called");
+        if (Object.keys(accountFilter).length === 0) {
+            this.logger.warning("getAccount: No accountFilter provided");
+            return null;
+        }
+
+        const account: AccountInfo | null =
+            this.browserStorage.getAccountInfoFilteredBy(accountFilter);
+
+        if (account) {
+            this.logger.verbose(
+                "getAccount: Account matching provided filter found, returning"
+            );
+            return account;
+        } else {
+            this.logger.verbose(
+                "getAccount: No matching account found, returning null"
+            );
+            return null;
+        }
+    }
+
+    /**
+     * Returns the signed in account matching username.
+     * (the account object is created at the time of successful login)
+     * or null when no matching account is found.
+     * This API is provided for convenience but getAccountById should be used for best reliability
+     * @param username
+     * @returns The account object stored in MSAL
+     */
+    getAccountByUsername(username: string): AccountInfo | null {
+        this.logger.trace("getAccountByUsername called");
+        if (!username) {
+            this.logger.warning("getAccountByUsername: No username provided");
+            return null;
+        }
+
+        const account = this.browserStorage.getAccountInfoFilteredBy({
+            username,
+        });
+        if (account) {
+            this.logger.verbose(
+                "getAccountByUsername: Account matching username found, returning"
+            );
+            this.logger.verbosePii(
+                `getAccountByUsername: Returning signed-in accounts matching username: ${username}`
+            );
+            return account;
+        } else {
+            this.logger.verbose(
+                "getAccountByUsername: No matching account found, returning null"
+            );
+            return null;
+        }
+    }
+
+    /**
+     * Returns the signed in account matching homeAccountId.
+     * (the account object is created at the time of successful login)
+     * or null when no matching account is found
+     * @param homeAccountId
+     * @returns The account object stored in MSAL
+     */
+    getAccountByHomeId(homeAccountId: string): AccountInfo | null {
+        this.logger.trace("getAccountByHomeId called");
+        if (!homeAccountId) {
+            this.logger.warning(
+                "getAccountByHomeId: No homeAccountId provided"
+            );
+            return null;
+        }
+
+        const account = this.browserStorage.getAccountInfoFilteredBy({
+            homeAccountId,
+        });
+        if (account) {
+            this.logger.verbose(
+                "getAccountByHomeId: Account matching homeAccountId found, returning"
+            );
+            this.logger.verbosePii(
+                `getAccountByHomeId: Returning signed-in accounts matching homeAccountId: ${homeAccountId}`
+            );
+            return account;
+        } else {
+            this.logger.verbose(
+                "getAccountByHomeId: No matching account found, returning null"
+            );
+            return null;
+        }
+    }
+
+    /**
+     * Returns the signed in account matching localAccountId.
+     * (the account object is created at the time of successful login)
+     * or null when no matching account is found
+     * @param localAccountId
+     * @returns The account object stored in MSAL
+     */
+    getAccountByLocalId(localAccountId: string): AccountInfo | null {
+        this.logger.trace("getAccountByLocalId called");
+        if (!localAccountId) {
+            this.logger.warning(
+                "getAccountByLocalId: No localAccountId provided"
+            );
+            return null;
+        }
+
+        const account = this.browserStorage.getAccountInfoFilteredBy({
+            localAccountId,
+        });
+        if (account) {
+            this.logger.verbose(
+                "getAccountByLocalId: Account matching localAccountId found, returning"
+            );
+            this.logger.verbosePii(
+                `getAccountByLocalId: Returning signed-in accounts matching localAccountId: ${localAccountId}`
+            );
+            return account;
+        } else {
+            this.logger.verbose(
+                "getAccountByLocalId: No matching account found, returning null"
+            );
+            return null;
+        }
+    }
+
+    /**
+     * 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.
+     * @param account
+     */
+    setActiveAccount(account: AccountInfo | null): void {
+        this.browserStorage.setActiveAccount(account);
+    }
+
+    /**
+     * Gets the currently active account
+     */
+    getActiveAccount(): AccountInfo | null {
+        return this.browserStorage.getActiveAccount();
+    }
+
+    // #endregion
+
+    /**
+     * Hydrates the cache with the tokens from an AuthenticationResult
+     * @param result
+     * @param request
+     * @returns
+     */
+    async hydrateCache(
+        result: AuthenticationResult,
+        request:
+            | SilentRequest
+            | SsoSilentRequest
+            | RedirectRequest
+            | PopupRequest
+    ): Promise<void> {
+        this.logger.verbose("hydrateCache called");
+
+        // Account gets saved to browser storage regardless of native or not
+        const accountEntity = AccountEntity.createFromAccountInfo(
+            result.account,
+            result.cloudGraphHostName,
+            result.msGraphHost
+        );
+        this.browserStorage.setAccount(accountEntity);
+
+        if (result.fromNativeBroker) {
+            this.logger.verbose(
+                "Response was from native broker, storing in-memory"
+            );
+            // Tokens from native broker are stored in-memory
+            return this.nativeInternalStorage.hydrateCache(result, request);
+        } else {
+            return this.browserStorage.hydrateCache(result, request);
+        }
+    }
+
+    // #region Helpers
+
+    /**
+     * Helper to validate app environment before making an auth request
+     *
+     * @protected
+     * @param {InteractionType} interactionType What kind of interaction is being used
+     * @param {boolean} [isAppEmbedded=false] Whether to set interaction in progress temp cache flag
+     */
+    public preflightBrowserEnvironmentCheck(
+        interactionType: InteractionType,
+        isAppEmbedded: boolean = false
+    ): void {
+        this.logger.verbose("preflightBrowserEnvironmentCheck started");
+        // Block request if not in browser environment
+        BrowserUtils.blockNonBrowserEnvironment(this.isBrowserEnvironment);
+
+        // Block redirects if in an iframe
+        BrowserUtils.blockRedirectInIframe(
+            interactionType,
+            this.config.system.allowRedirectInIframe
+        );
+
+        // Block auth requests inside a hidden iframe
+        BrowserUtils.blockReloadInHiddenIframes();
+
+        // Block redirectUri opened in a popup from calling MSAL APIs
+        BrowserUtils.blockAcquireTokenInPopups();
+
+        // Block token acquisition before initialize has been called
+        BrowserUtils.blockAPICallsBeforeInitialize(this.initialized);
+
+        // Block redirects if memory storage is enabled but storeAuthStateInCookie is not
+        if (
+            interactionType === InteractionType.Redirect &&
+            this.config.cache.cacheLocation ===
+                BrowserCacheLocation.MemoryStorage &&
+            !this.config.cache.storeAuthStateInCookie
+        ) {
+            throw createBrowserConfigurationAuthError(
+                BrowserConfigurationAuthErrorCodes.inMemRedirectUnavailable
+            );
+        }
+
+        if (
+            interactionType === InteractionType.Redirect ||
+            interactionType === InteractionType.Popup
+        ) {
+            this.preflightInteractiveRequest(!isAppEmbedded);
+        }
+    }
+
+    /**
+     * Preflight check for interactive requests
+     *
+     * @protected
+     * @param {boolean} setInteractionInProgress Whether to set interaction in progress temp cache flag
+     */
+    protected preflightInteractiveRequest(
+        setInteractionInProgress: boolean
+    ): void {
+        this.logger.verbose(
+            "preflightInteractiveRequest called, validating app environment"
+        );
+        // block the reload if it occurred inside a hidden iframe
+        BrowserUtils.blockReloadInHiddenIframes();
+
+        // Set interaction in progress temporary cache or throw if alread set.
+        if (setInteractionInProgress) {
+            this.getBrowserStorage().setInteractionInProgress(true);
+        }
+    }
+
+    /**
+     * Acquire a token from native device (e.g. WAM)
+     * @param request
+     */
+    public async acquireTokenNative(
+        request: PopupRequest | SilentRequest | SsoSilentRequest,
+        apiId: ApiId,
+        accountId?: string
+    ): Promise<AuthenticationResult> {
+        this.logger.trace("acquireTokenNative called");
+        if (!this.nativeExtensionProvider) {
+            throw createBrowserAuthError(
+                BrowserAuthErrorCodes.nativeConnectionNotEstablished
+            );
+        }
+
+        const nativeClient = new NativeInteractionClient(
+            this.config,
+            this.browserStorage,
+            this.browserCrypto,
+            this.logger,
+            this.eventHandler,
+            this.navigationClient,
+            apiId,
+            this.performanceClient,
+            this.nativeExtensionProvider,
+            accountId || this.getNativeAccountId(request),
+            this.nativeInternalStorage,
+            request.correlationId
+        );
+
+        return nativeClient.acquireToken(request);
+    }
+
+    /**
+     * Returns boolean indicating if this request can use the native broker
+     * @param request
+     */
+    public canUseNative(
+        request: RedirectRequest | PopupRequest | SsoSilentRequest,
+        accountId?: string
+    ): boolean {
+        this.logger.trace("canUseNative called");
+        if (
+            !NativeMessageHandler.isNativeAvailable(
+                this.config,
+                this.logger,
+                this.nativeExtensionProvider,
+                request.authenticationScheme
+            )
+        ) {
+            this.logger.trace(
+                "canUseNative: isNativeAvailable returned false, returning false"
+            );
+            return false;
+        }
+
+        if (request.prompt) {
+            switch (request.prompt) {
+                case PromptValue.NONE:
+                case PromptValue.CONSENT:
+                case PromptValue.LOGIN:
+                    this.logger.trace(
+                        "canUseNative: prompt is compatible with native flow"
+                    );
+                    break;
+                default:
+                    this.logger.trace(
+                        `canUseNative: prompt = ${request.prompt} is not compatible with native flow, returning false`
+                    );
+                    return false;
+            }
+        }
+
+        if (!accountId && !this.getNativeAccountId(request)) {
+            this.logger.trace(
+                "canUseNative: nativeAccountId is not available, returning false"
+            );
+            return false;
+        }
+
+        return true;
+    }
+
+    /**
+     * Get the native accountId from the account
+     * @param request
+     * @returns
+     */
+    public getNativeAccountId(
+        request: RedirectRequest | PopupRequest | SsoSilentRequest
+    ): string {
+        const account =
+            request.account ||
+            this.browserStorage.getAccountInfoByHints(
+                request.loginHint,
+                request.sid
+            ) ||
+            this.getActiveAccount();
+
+        return (account && account.nativeAccountId) || "";
+    }
+
+    /**
+     * Returns new instance of the Popup Interaction Client
+     * @param correlationId
+     */
+    public createPopupClient(correlationId?: string): PopupClient {
+        return new PopupClient(
+            this.config,
+            this.browserStorage,
+            this.browserCrypto,
+            this.logger,
+            this.eventHandler,
+            this.navigationClient,
+            this.performanceClient,
+            this.nativeInternalStorage,
+            this.nativeExtensionProvider,
+            correlationId
+        );
+    }
+
+    /**
+     * Returns new instance of the Redirect Interaction Client
+     * @param correlationId
+     */
+    protected createRedirectClient(correlationId?: string): RedirectClient {
+        return new RedirectClient(
+            this.config,
+            this.browserStorage,
+            this.browserCrypto,
+            this.logger,
+            this.eventHandler,
+            this.navigationClient,
+            this.performanceClient,
+            this.nativeInternalStorage,
+            this.nativeExtensionProvider,
+            correlationId
+        );
+    }
+
+    /**
+     * Returns new instance of the Silent Iframe Interaction Client
+     * @param correlationId
+     */
+    public createSilentIframeClient(
+        correlationId?: string
+    ): SilentIframeClient {
+        return new SilentIframeClient(
+            this.config,
+            this.browserStorage,
+            this.browserCrypto,
+            this.logger,
+            this.eventHandler,
+            this.navigationClient,
+            ApiId.ssoSilent,
+            this.performanceClient,
+            this.nativeInternalStorage,
+            this.nativeExtensionProvider,
+            correlationId
+        );
+    }
+
+    /**
+     * Returns new instance of the Silent Cache Interaction Client
+     */
+    protected createSilentCacheClient(
+        correlationId?: string
+    ): SilentCacheClient {
+        return new SilentCacheClient(
+            this.config,
+            this.browserStorage,
+            this.browserCrypto,
+            this.logger,
+            this.eventHandler,
+            this.navigationClient,
+            this.performanceClient,
+            this.nativeExtensionProvider,
+            correlationId
+        );
+    }
+
+    /**
+     * Returns new instance of the Silent Refresh Interaction Client
+     */
+    protected createSilentRefreshClient(
+        correlationId?: string
+    ): SilentRefreshClient {
+        return new SilentRefreshClient(
+            this.config,
+            this.browserStorage,
+            this.browserCrypto,
+            this.logger,
+            this.eventHandler,
+            this.navigationClient,
+            this.performanceClient,
+            this.nativeExtensionProvider,
+            correlationId
+        );
+    }
+
+    /**
+     * Returns new instance of the Silent AuthCode Interaction Client
+     */
+    protected createSilentAuthCodeClient(
+        correlationId?: string
+    ): SilentAuthCodeClient {
+        return new SilentAuthCodeClient(
+            this.config,
+            this.browserStorage,
+            this.browserCrypto,
+            this.logger,
+            this.eventHandler,
+            this.navigationClient,
+            ApiId.acquireTokenByCode,
+            this.performanceClient,
+            this.nativeExtensionProvider,
+            correlationId
+        );
+    }
+
+    /**
+     * Adds event callbacks to array
+     * @param callback
+     */
+    addEventCallback(callback: EventCallbackFunction): string | null {
+        return this.eventHandler.addEventCallback(callback);
+    }
+
+    /**
+     * Removes callback with provided id from callback array
+     * @param callbackId
+     */
+    removeEventCallback(callbackId: string): void {
+        this.eventHandler.removeEventCallback(callbackId);
+    }
+
+    /**
+     * Registers a callback to receive performance events.
+     *
+     * @param {PerformanceCallbackFunction} callback
+     * @returns {string}
+     */
+    addPerformanceCallback(callback: PerformanceCallbackFunction): string {
+        return this.performanceClient.addPerformanceCallback(callback);
+    }
+
+    /**
+     * Removes a callback registered with addPerformanceCallback.
+     *
+     * @param {string} callbackId
+     * @returns {boolean}
+     */
+    removePerformanceCallback(callbackId: string): boolean {
+        return this.performanceClient.removePerformanceCallback(callbackId);
+    }
+
+    /**
+     * Adds event listener that emits an event when a user account is added or removed from localstorage in a different browser tab or window
+     */
+    enableAccountStorageEvents(): void {
+        this.eventHandler.enableAccountStorageEvents();
+    }
+
+    /**
+     * Removes event listener that emits an event when a user account is added or removed from localstorage in a different browser tab or window
+     */
+    disableAccountStorageEvents(): void {
+        this.eventHandler.disableAccountStorageEvents();
+    }
+
+    /**
+     * Gets the token cache for the application.
+     */
+    getTokenCache(): ITokenCache {
+        return this.tokenCache;
+    }
+
+    /**
+     * Returns the logger instance
+     */
+    public getLogger(): Logger {
+        return this.logger;
+    }
+
+    /**
+     * Replaces the default logger set in configurations with new Logger with new configurations
+     * @param logger Logger instance
+     */
+    setLogger(logger: Logger): void {
+        this.logger = logger;
+    }
+
+    /**
+     * Called by wrapper libraries (Angular & React) to set SKU and Version passed down to telemetry, logger, etc.
+     * @param sku
+     * @param version
+     */
+    initializeWrapperLibrary(sku: WrapperSKU, version: string): void {
+        // Validate the SKU passed in is one we expect
+        this.browserStorage.setWrapperMetadata(sku, version);
+    }
+
+    /**
+     * Sets navigation client
+     * @param navigationClient
+     */
+    setNavigationClient(navigationClient: INavigationClient): void {
+        this.navigationClient = navigationClient;
+    }
+
+    /**
+     * Returns the configuration object
+     */
+    public getConfiguration(): BrowserConfiguration {
+        return this.config;
+    }
+
+    /**
+     * Returns the performance client
+     */
+    public getPerformanceClient(): IPerformanceClient {
+        return this.performanceClient;
+    }
+
+    /**
+     * Returns the browser storage
+     */
+    public getBrowserStorage(): BrowserCacheManager {
+        return this.browserStorage;
+    }
+
+    /**
+     * Returns the browser env indicator
+     */
+    public isBrowserEnv(): boolean {
+        return this.isBrowserEnvironment;
+    }
+
+    /**
+     * Returns the event handler
+     */
+    getEventHandler(): EventHandler {
+        return this.eventHandler;
+    }
+
+    /**
+     * Generates a correlation id for a request if none is provided.
+     *
+     * @protected
+     * @param {?Partial<BaseAuthRequest>} [request]
+     * @returns {string}
+     */
+    protected getRequestCorrelationId(
+        request?: Partial<BaseAuthRequest>
+    ): string {
+        if (request?.correlationId) {
+            return request.correlationId;
+        }
+
+        if (this.isBrowserEnvironment) {
+            return createNewGuid();
+        }
+
+        /*
+         * Included for fallback for non-browser environments,
+         * and to ensure this method always returns a string.
+         */
+        return Constants.EMPTY_STRING;
+    }
+
+    // #endregion
+
+    /**
+     * Use when initiating the login process by redirecting the user's browser to the authorization endpoint. This function redirects the page, so
+     * any code that follows this function will not execute.
+     *
+     * 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
+     * browser window. It currently returns a Promise in order to reflect the asynchronous nature of the code running in this function.
+     *
+     * @param request
+     */
+    async loginRedirect(request?: RedirectRequest): Promise<void> {
+        const correlationId: string = this.getRequestCorrelationId(request);
+        this.logger.verbose("loginRedirect called", correlationId);
+        return this.acquireTokenRedirect({
+            correlationId,
+            ...(request || DEFAULT_REQUEST),
+        });
+    }
+
+    /**
+     * Use when initiating the login process via opening a popup window in the user's browser
+     *
+     * @param request
+     *
+     * @returns A promise that is fulfilled when this function has completed, or rejected if an error was raised.
+     */
+    loginPopup(request?: PopupRequest): Promise<AuthenticationResult> {
+        const correlationId: string = this.getRequestCorrelationId(request);
+        this.logger.verbose("loginPopup called", correlationId);
+        return this.acquireTokenPopup({
+            correlationId,
+            ...(request || DEFAULT_REQUEST),
+        });
+    }
+
+    /**
+     * Silently acquire an access token for a given set of scopes. Returns currently processing promise if parallel requests are made.
+     *
+     * @param {@link (SilentRequest:type)}
+     * @returns {Promise.<AuthenticationResult>} - a promise that is fulfilled when this function has completed, or rejected if an error was raised. Returns the {@link AuthResponse} object
+     */
+    async acquireTokenSilent(
+        request: SilentRequest
+    ): Promise<AuthenticationResult> {
+        const correlationId = this.getRequestCorrelationId(request);
+        const atsMeasurement = this.performanceClient.startMeasurement(
+            PerformanceEvents.AcquireTokenSilent,
+            correlationId
+        );
+        atsMeasurement.add({
+            cacheLookupPolicy: request.cacheLookupPolicy,
+        });
+
+        this.preflightBrowserEnvironmentCheck(InteractionType.Silent);
+        this.logger.verbose("acquireTokenSilent called", correlationId);
+
+        const account = request.account || this.getActiveAccount();
+        if (!account) {
+            throw createBrowserAuthError(BrowserAuthErrorCodes.noAccountError);
+        }
+
+        const thumbprint: RequestThumbprint = {
+            clientId: this.config.auth.clientId,
+            authority: request.authority || Constants.EMPTY_STRING,
+            scopes: request.scopes,
+            homeAccountIdentifier: account.homeAccountId,
+            claims: request.claims,
+            authenticationScheme: request.authenticationScheme,
+            resourceRequestMethod: request.resourceRequestMethod,
+            resourceRequestUri: request.resourceRequestUri,
+            shrClaims: request.shrClaims,
+            sshKid: request.sshKid,
+        };
+        const silentRequestKey = JSON.stringify(thumbprint);
+
+        const cachedResponse =
+            this.activeSilentTokenRequests.get(silentRequestKey);
+        if (typeof cachedResponse === "undefined") {
+            this.logger.verbose(
+                "acquireTokenSilent called for the first time, storing active request",
+                correlationId
+            );
+
+            const response = invokeAsync(
+                this.acquireTokenSilentAsync.bind(this),
+                PerformanceEvents.AcquireTokenSilentAsync,
+                this.logger,
+                this.performanceClient,
+                correlationId
+            )(
+                {
+                    ...request,
+                    correlationId,
+                },
+                account
+            )
+                .then((result) => {
+                    this.activeSilentTokenRequests.delete(silentRequestKey);
+                    atsMeasurement.add({
+                        accessTokenSize: result.accessToken.length,
+                        idTokenSize: result.idToken.length,
+                    });
+                    atsMeasurement.end({
+                        success: true,
+                        fromCache: result.fromCache,
+                        isNativeBroker: result.fromNativeBroker,
+                        cacheLookupPolicy: request.cacheLookupPolicy,
+                        requestId: result.requestId,
+                    });
+                    return result;
+                })
+                .catch((error: AuthError) => {
+                    this.activeSilentTokenRequests.delete(silentRequestKey);
+                    atsMeasurement.end({
+                        errorCode: error.errorCode,
+                        subErrorCode: error.subError,
+                        success: false,
+                    });
+                    throw error;
+                });
+            this.activeSilentTokenRequests.set(silentRequestKey, response);
+            return response;
+        } else {
+            this.logger.verbose(
+                "acquireTokenSilent has been called previously, returning the result from the first call",
+                correlationId
+            );
+            // Discard measurements for memoized calls, as they are usually only a couple of ms and will artificially deflate metrics
+            atsMeasurement.discard();
+            return cachedResponse;
+        }
+    }
+
+    /**
+     * Silently acquire an access token for a given set of scopes. Will use cached token if available, otherwise will attempt to acquire a new token from the network via refresh token.
+     * @param {@link (SilentRequest:type)}
+     * @param {@link (AccountInfo:type)}
+     * @returns {Promise.<AuthenticationResult>} - a promise that is fulfilled when this function has completed, or rejected if an error was raised. Returns the {@link AuthResponse}
+     */
+    protected async acquireTokenSilentAsync(
+        request: SilentRequest,
+        account: AccountInfo
+    ): Promise<AuthenticationResult> {
+        this.performanceClient.addQueueMeasurement(
+            PerformanceEvents.AcquireTokenSilentAsync,
+            request.correlationId
+        );
+
+        this.eventHandler.emitEvent(
+            EventType.ACQUIRE_TOKEN_START,
+            InteractionType.Silent,
+            request
+        );
+        this.atsAsyncMeasurement = this.performanceClient.startMeasurement(
+            PerformanceEvents.AcquireTokenSilentAsync,
+            request.correlationId
+        );
+        this.atsAsyncMeasurement?.increment({
+            visibilityChangeCount: 0,
+        });
+        document.addEventListener("visibilitychange", this.trackPageVisibility);
+        let result: Promise<AuthenticationResult>;
+        if (
+            NativeMessageHandler.isNativeAvailable(
+                this.config,
+                this.logger,
+                this.nativeExtensionProvider,
+                request.authenticationScheme
+            ) &&
+            account.nativeAccountId
+        ) {
+            this.logger.verbose(
+                "acquireTokenSilent - attempting to acquire token from native platform"
+            );
+            const silentRequest: SilentRequest = {
+                ...request,
+                account,
+            };
+            result = this.acquireTokenNative(
+                silentRequest,
+                ApiId.acquireTokenSilent_silentFlow
+            ).catch(async (e: AuthError) => {
+                // If native token acquisition fails for availability reasons fallback to web flow
+                if (e instanceof NativeAuthError && isFatalNativeAuthError(e)) {
+                    this.logger.verbose(
+                        "acquireTokenSilent - native platform unavailable, falling back to web flow"
+                    );
+                    this.nativeExtensionProvider = undefined; // Prevent future requests from continuing to attempt
+
+                    // Cache will not contain tokens, given that previous WAM requests succeeded. Skip cache and RT renewal and go straight to iframe renewal
+                    const silentIframeClient = this.createSilentIframeClient(
+                        request.correlationId
+                    );
+                    return silentIframeClient.acquireToken(request);
+                }
+                throw e;
+            });
+        } else {
+            this.logger.verbose(
+                "acquireTokenSilent - attempting to acquire token from web flow"
+            );
+
+            const silentCacheClient = this.createSilentCacheClient(
+                request.correlationId
+            );
+
+            const silentRequest = await invokeAsync(
+                silentCacheClient.initializeSilentRequest.bind(
+                    silentCacheClient
+                ),
+                PerformanceEvents.InitializeSilentRequest,
+                this.logger,
+                this.performanceClient,
+                request.correlationId
+            )(request, account);
+
+            const requestWithCLP = {
+                ...request,
+                // set the request's CacheLookupPolicy to Default if it was not optionally passed in
+                cacheLookupPolicy:
+                    request.cacheLookupPolicy || CacheLookupPolicy.Default,
+            };
+
+            result = invokeAsync(
+                this.acquireTokenFromCache.bind(this),
+                PerformanceEvents.AcquireTokenFromCache,
+                this.logger,
+                this.performanceClient,
+                silentRequest.correlationId
+            )(silentCacheClient, silentRequest, requestWithCLP).catch(
+                (cacheError: AuthError) => {
+                    if (
+                        requestWithCLP.cacheLookupPolicy ===
+                        CacheLookupPolicy.AccessToken
+                    ) {
+                        throw cacheError;
+                    }
+
+                    // block the reload if it occurred inside a hidden iframe
+                    BrowserUtils.blockReloadInHiddenIframes();
+                    this.eventHandler.emitEvent(
+                        EventType.ACQUIRE_TOKEN_NETWORK_START,
+                        InteractionType.Silent,
+                        silentRequest
+                    );
+
+                    return invokeAsync(
+                        this.acquireTokenByRefreshToken.bind(this),
+                        PerformanceEvents.AcquireTokenByRefreshToken,
+                        this.logger,
+                        this.performanceClient,
+                        silentRequest.correlationId
+                    )(silentRequest, requestWithCLP).catch(
+                        (refreshTokenError: AuthError) => {
+                            const isServerError =
+                                refreshTokenError instanceof ServerError;
+                            const isInteractionRequiredError =
+                                refreshTokenError instanceof
+                                InteractionRequiredAuthError;
+                            const isInvalidGrantError =
+                                refreshTokenError.errorCode ===
+                                BrowserConstants.INVALID_GRANT_ERROR;
+
+                            if (
+                                (!isServerError ||
+                                    !isInvalidGrantError ||
+                                    isInteractionRequiredError ||
+                                    requestWithCLP.cacheLookupPolicy ===
+                                        CacheLookupPolicy.AccessTokenAndRefreshToken ||
+                                    requestWithCLP.cacheLookupPolicy ===
+                                        CacheLookupPolicy.RefreshToken) &&
+                                requestWithCLP.cacheLookupPolicy !==
+                                    CacheLookupPolicy.Skip
+                            ) {
+                                throw refreshTokenError;
+                            }
+
+                            this.logger.verbose(
+                                "Refresh token expired/invalid or CacheLookupPolicy is set to Skip, attempting acquire token by iframe.",
+                                request.correlationId
+                            );
+                            return invokeAsync(
+                                this.acquireTokenBySilentIframe.bind(this),
+                                PerformanceEvents.AcquireTokenBySilentIframe,
+                                this.logger,
+                                this.performanceClient,
+                                silentRequest.correlationId
+                            )(silentRequest);
+                        }
+                    );
+                }
+            );
+        }
+
+        return result
+            .then((response) => {
+                this.eventHandler.emitEvent(
+                    EventType.ACQUIRE_TOKEN_SUCCESS,
+                    InteractionType.Silent,
+                    response
+                );
+                this.atsAsyncMeasurement?.end({
+                    success: true,
+                    fromCache: response.fromCache,
+                    isNativeBroker: response.fromNativeBroker,
+                    requestId: response.requestId,
+                });
+                return response;
+            })
+            .catch((tokenRenewalError: AuthError) => {
+                this.eventHandler.emitEvent(
+                    EventType.ACQUIRE_TOKEN_FAILURE,
+                    InteractionType.Silent,
+                    null,
+                    tokenRenewalError
+                );
+                this.atsAsyncMeasurement?.end({
+                    errorCode: tokenRenewalError.errorCode,
+                    subErrorCode: tokenRenewalError.subError,
+                    success: false,
+                });
+                throw tokenRenewalError;
+            })
+            .finally(() => {
+                document.removeEventListener(
+                    "visibilitychange",
+                    this.trackPageVisibility
+                );
+            });
+    }
+}