@azure/msal-browser 5.3.0 → 5.4.1

package/lib/msal-browser.js

@@ -1,4 +1,4 @@
-/*! @azure/msal-browser v5.3.0 2026-02-24 */
+/*! @azure/msal-browser v5.4.1 2026-04-01 */
 'use strict';
 (function (global, factory) {
     typeof exports === 'object' && typeof module !== 'undefined' ? factory(exports) :
@@ -6,7 +6,7 @@
     (global = typeof globalThis !== 'undefined' ? globalThis : global || self, factory(global.msal = {}));
 })(this, (function (exports) { 'use strict';
 
-    /*! @azure/msal-common v16.1.0 2026-02-24 */
+    /*! @azure/msal-common v16.2.1 2026-04-01 */
     /*
      * Copyright (c) Microsoft Corporation. All rights reserved.
      * Licensed under the MIT License.
@@ -238,7 +238,7 @@
     // Token renewal offset default in seconds
     const DEFAULT_TOKEN_RENEWAL_OFFSET_SEC = 300;
 
-    /*! @azure/msal-common v16.1.0 2026-02-24 */
+    /*! @azure/msal-common v16.2.1 2026-04-01 */
     /*
      * Copyright (c) Microsoft Corporation. All rights reserved.
      * Licensed under the MIT License.
@@ -288,7 +288,7 @@
     const EAR_JWK = "ear_jwk";
     const EAR_JWE_CRYPTO = "ear_jwe_crypto";
 
-    /*! @azure/msal-common v16.1.0 2026-02-24 */
+    /*! @azure/msal-common v16.2.1 2026-04-01 */
     /*
      * Copyright (c) Microsoft Corporation. All rights reserved.
      * Licensed under the MIT License.
@@ -319,7 +319,7 @@
         return new AuthError(code, additionalMessage || getDefaultErrorMessage$1(code));
     }
 
-    /*! @azure/msal-common v16.1.0 2026-02-24 */
+    /*! @azure/msal-common v16.2.1 2026-04-01 */
 
     /*
      * Copyright (c) Microsoft Corporation. All rights reserved.
@@ -339,7 +339,7 @@
         return new ClientConfigurationError(errorCode);
     }
 
-    /*! @azure/msal-common v16.1.0 2026-02-24 */
+    /*! @azure/msal-common v16.2.1 2026-04-01 */
     /*
      * Copyright (c) Microsoft Corporation. All rights reserved.
      * Licensed under the MIT License.
@@ -419,7 +419,7 @@
         }
     }
 
-    /*! @azure/msal-common v16.1.0 2026-02-24 */
+    /*! @azure/msal-common v16.2.1 2026-04-01 */
 
     /*
      * Copyright (c) Microsoft Corporation. All rights reserved.
@@ -442,7 +442,7 @@
         return new ClientAuthError(errorCode, additionalMessage);
     }
 
-    /*! @azure/msal-common v16.1.0 2026-02-24 */
+    /*! @azure/msal-common v16.2.1 2026-04-01 */
     /*
      * Copyright (c) Microsoft Corporation. All rights reserved.
      * Licensed under the MIT License.
@@ -496,7 +496,7 @@
         urlParseError: urlParseError
     });
 
-    /*! @azure/msal-common v16.1.0 2026-02-24 */
+    /*! @azure/msal-common v16.2.1 2026-04-01 */
     /*
      * Copyright (c) Microsoft Corporation. All rights reserved.
      * Licensed under the MIT License.
@@ -580,7 +580,7 @@
         userCanceled: userCanceled
     });
 
-    /*! @azure/msal-common v16.1.0 2026-02-24 */
+    /*! @azure/msal-common v16.2.1 2026-04-01 */
 
     /*
      * Copyright (c) Microsoft Corporation. All rights reserved.
@@ -775,7 +775,7 @@
         }
     }
 
-    /*! @azure/msal-common v16.1.0 2026-02-24 */
+    /*! @azure/msal-common v16.2.1 2026-04-01 */
 
     /*
      * Copyright (c) Microsoft Corporation. All rights reserved.
@@ -1142,7 +1142,7 @@
         parameters.set(EAR_JWE_CRYPTO, jweCryptoB64Encoded);
     }
 
-    /*! @azure/msal-common v16.1.0 2026-02-24 */
+    /*! @azure/msal-common v16.2.1 2026-04-01 */
 
     /*
      * Copyright (c) Microsoft Corporation. All rights reserved.
@@ -1251,7 +1251,7 @@
         }
     }
 
-    /*! @azure/msal-common v16.1.0 2026-02-24 */
+    /*! @azure/msal-common v16.2.1 2026-04-01 */
 
     /*
      * Copyright (c) Microsoft Corporation. All rights reserved.
@@ -1290,7 +1290,7 @@
         },
     };
 
-    /*! @azure/msal-common v16.1.0 2026-02-24 */
+    /*! @azure/msal-common v16.2.1 2026-04-01 */
     /*
      * Copyright (c) Microsoft Corporation. All rights reserved.
      * Licensed under the MIT License.
@@ -1565,12 +1565,12 @@
         }
     }
 
-    /*! @azure/msal-common v16.1.0 2026-02-24 */
+    /*! @azure/msal-common v16.2.1 2026-04-01 */
     /* eslint-disable header/header */
     const name$1 = "@azure/msal-common";
-    const version$1 = "16.1.0";
+    const version$1 = "16.2.1";
 
-    /*! @azure/msal-common v16.1.0 2026-02-24 */
+    /*! @azure/msal-common v16.2.1 2026-04-01 */
     /*
      * Copyright (c) Microsoft Corporation. All rights reserved.
      * Licensed under the MIT License.
@@ -1590,7 +1590,7 @@
         AzureUsGovernment: "https://login.microsoftonline.us",
     };
 
-    /*! @azure/msal-common v16.1.0 2026-02-24 */
+    /*! @azure/msal-common v16.2.1 2026-04-01 */
     /*
      * Copyright (c) Microsoft Corporation. All rights reserved.
      * Licensed under the MIT License.
@@ -1672,7 +1672,7 @@
         return updatedAccountInfo;
     }
 
-    /*! @azure/msal-common v16.1.0 2026-02-24 */
+    /*! @azure/msal-common v16.2.1 2026-04-01 */
 
     /*
      * Copyright (c) Microsoft Corporation. All rights reserved.
@@ -1752,7 +1752,7 @@
         }
     }
 
-    /*! @azure/msal-common v16.1.0 2026-02-24 */
+    /*! @azure/msal-common v16.2.1 2026-04-01 */
 
     /*
      * Copyright (c) Microsoft Corporation. All rights reserved.
@@ -1909,7 +1909,7 @@
         }
     }
 
-    /*! @azure/msal-common v16.1.0 2026-02-24 */
+    /*! @azure/msal-common v16.2.1 2026-04-01 */
 
     /*
      * Copyright (c) Microsoft Corporation. All rights reserved.
@@ -2066,7 +2066,7 @@
         return null;
     }
 
-    /*! @azure/msal-common v16.1.0 2026-02-24 */
+    /*! @azure/msal-common v16.2.1 2026-04-01 */
     /*
      * Copyright (c) Microsoft Corporation. All rights reserved.
      * Licensed under the MIT License.
@@ -2074,7 +2074,7 @@
     const cacheQuotaExceeded = "cache_quota_exceeded";
     const cacheErrorUnknown = "cache_error_unknown";
 
-    /*! @azure/msal-common v16.1.0 2026-02-24 */
+    /*! @azure/msal-common v16.2.1 2026-04-01 */
 
     /*
      * Copyright (c) Microsoft Corporation. All rights reserved.
@@ -2112,7 +2112,7 @@
         }
     }
 
-    /*! @azure/msal-common v16.1.0 2026-02-24 */
+    /*! @azure/msal-common v16.2.1 2026-04-01 */
 
     /*
      * Copyright (c) Microsoft Corporation. All rights reserved.
@@ -2150,7 +2150,7 @@
         };
     }
 
-    /*! @azure/msal-common v16.1.0 2026-02-24 */
+    /*! @azure/msal-common v16.2.1 2026-04-01 */
     /*
      * Copyright (c) Microsoft Corporation. All rights reserved.
      * Licensed under the MIT License.
@@ -2165,7 +2165,7 @@
         Ciam: 3,
     };
 
-    /*! @azure/msal-common v16.1.0 2026-02-24 */
+    /*! @azure/msal-common v16.2.1 2026-04-01 */
     /*
      * Copyright (c) Microsoft Corporation. All rights reserved.
      * Licensed under the MIT License.
@@ -2187,7 +2187,7 @@
         return null;
     }
 
-    /*! @azure/msal-common v16.1.0 2026-02-24 */
+    /*! @azure/msal-common v16.2.1 2026-04-01 */
     /*
      * Copyright (c) Microsoft Corporation. All rights reserved.
      * Licensed under the MIT License.
@@ -2211,7 +2211,7 @@
         EAR: "EAR",
     };
 
-    /*! @azure/msal-common v16.1.0 2026-02-24 */
+    /*! @azure/msal-common v16.2.1 2026-04-01 */
     /**
      * Returns the AccountInfo interface for this account.
      */
@@ -2386,7 +2386,7 @@
             entity.hasOwnProperty("authorityType"));
     }
 
-    /*! @azure/msal-common v16.1.0 2026-02-24 */
+    /*! @azure/msal-common v16.2.1 2026-04-01 */
 
     /*
      * Copyright (c) Microsoft Corporation. All rights reserved.
@@ -3483,7 +3483,7 @@
         }
     }
 
-    /*! @azure/msal-common v16.1.0 2026-02-24 */
+    /*! @azure/msal-common v16.2.1 2026-04-01 */
     /*
      * Copyright (c) Microsoft Corporation. All rights reserved.
      * Licensed under the MIT License.
@@ -3498,6 +3498,12 @@
         InProgress: 1,
         Completed: 2,
     };
+    /**
+     * Prefix used to mark telemetry field names as dynamic.
+     * Fields with this prefix in addFields/incrementFields calls will be routed
+     * to the PerformanceEvent.ext sub-object.
+     */
+    const EXT_FIELD_PREFIX = "ext.";
     const IntFields = new Set([
         "accessTokenSize",
         "durationMs",
@@ -3522,9 +3528,10 @@
         "currRefreshCount",
         "expiredCacheRemovedCount",
         "upgradedCacheCount",
+        "cacheMatchedAccounts",
     ]);
 
-    /*! @azure/msal-common v16.1.0 2026-02-24 */
+    /*! @azure/msal-common v16.2.1 2026-04-01 */
 
     /*
      * Copyright (c) Microsoft Corporation. All rights reserved.
@@ -3579,7 +3586,7 @@
         }
     }
 
-    /*! @azure/msal-common v16.1.0 2026-02-24 */
+    /*! @azure/msal-common v16.2.1 2026-04-01 */
 
     /*
      * Copyright (c) Microsoft Corporation. All rights reserved.
@@ -3673,291 +3680,358 @@
         return (config.authOptions.authority.options.protocolMode === ProtocolMode.OIDC);
     }
 
-    /*! @azure/msal-common v16.1.0 2026-02-24 */
-
+    /*! @azure/msal-common v16.2.1 2026-04-01 */
     /*
      * Copyright (c) Microsoft Corporation. All rights reserved.
      * Licensed under the MIT License.
      */
     /**
-     * Error thrown when there is an error with the server code, for example, unavailability.
-     */
-    class ServerError extends AuthError {
-        constructor(errorCode, errorMessage, subError, errorNo, status) {
-            super(errorCode, errorMessage, subError);
-            this.name = "ServerError";
-            this.errorNo = errorNo;
-            this.status = status;
-            Object.setPrototypeOf(this, ServerError.prototype);
+     * This class instance helps track the memory changes facilitating
+     * decisions to read from and write to the persistent cache
+     */ class TokenCacheContext {
+        constructor(tokenCache, hasChanged) {
+            this.cache = tokenCache;
+            this.hasChanged = hasChanged;
+        }
+        /**
+         * boolean which indicates the changes in cache
+         */
+        get cacheHasChanged() {
+            return this.hasChanged;
+        }
+        /**
+         * function to retrieve the token cache
+         */
+        get tokenCache() {
+            return this.cache;
         }
     }
 
-    /*! @azure/msal-common v16.1.0 2026-02-24 */
+    /*! @azure/msal-common v16.2.1 2026-04-01 */
     /*
      * Copyright (c) Microsoft Corporation. All rights reserved.
      * Licensed under the MIT License.
      */
     /**
-     * MSAL-defined interaction required error code indicating no tokens are found in cache.
-     * @public
-     */
-    const noTokensFound = "no_tokens_found";
-    /**
-     * MSAL-defined error code indicating a native account is unavailable on the platform.
-     * @public
-     */
-    const nativeAccountUnavailable = "native_account_unavailable";
-    /**
-     * MSAL-defined error code indicating the refresh token has expired and user interaction is needed.
-     * @public
+     * Utility functions for managing date and time operations.
      */
-    const refreshTokenExpired = "refresh_token_expired";
     /**
-     * MSAL-defined error code indicating UI/UX is not allowed (e.g., blocked by policy), requiring alternate interaction.
-     * @public
+     * return the current time in Unix time (seconds).
      */
-    const uxNotAllowed = "ux_not_allowed";
+    function nowSeconds() {
+        // Date.getTime() returns in milliseconds.
+        return Math.round(new Date().getTime() / 1000.0);
+    }
     /**
-     * Server-originated error code indicating interaction is required to complete the request.
-     * @public
+     * Converts JS Date object to seconds
+     * @param date Date
      */
-    const interactionRequired = "interaction_required";
+    function toSecondsFromDate(date) {
+        // Convert date to seconds
+        return date.getTime() / 1000;
+    }
     /**
-     * Server-originated error code indicating user consent is required.
-     * @public
+     * Convert seconds to JS Date object. Seconds can be in a number or string format or undefined (will still return a date).
+     * @param seconds
      */
-    const consentRequired = "consent_required";
+    function toDateFromSeconds(seconds) {
+        if (seconds) {
+            return new Date(Number(seconds) * 1000);
+        }
+        return new Date();
+    }
     /**
-     * Server-originated error code indicating user login is required.
-     * @public
+     * check if a token is expired based on given UTC time in seconds.
+     * @param expiresOn
      */
-    const loginRequired = "login_required";
+    function isTokenExpired(expiresOn, offset) {
+        // check for access token expiry
+        const expirationSec = Number(expiresOn) || 0;
+        const offsetCurrentTimeSec = nowSeconds() + offset;
+        // If current time + offset is greater than token expiration time, then token is expired.
+        return offsetCurrentTimeSec > expirationSec;
+    }
     /**
-     * Server-originated error code indicating the token is invalid or corrupted.
-     * @public
+     * Checks if a cache entry is expired based on the last updated time and cache retention days.
+     * @param lastUpdatedAt
+     * @param cacheRetentionDays
+     * @returns
      */
-    const badToken = "bad_token";
+    function isCacheExpired(lastUpdatedAt, cacheRetentionDays) {
+        const cacheExpirationTimestamp = Number(lastUpdatedAt) + cacheRetentionDays * 24 * 60 * 60 * 1000;
+        return Date.now() > cacheExpirationTimestamp;
+    }
     /**
-     * Server-originated error code indicating the user is in an interrupted state and interaction is required.
-     * @public
+     * If the current time is earlier than the time that a token was cached at, we must discard the token
+     * i.e. The system clock was turned back after acquiring the cached token
+     * @param cachedAt
+     * @param offset
      */
-    const interruptedUser = "interrupted_user";
-
-    var InteractionRequiredAuthErrorCodes = /*#__PURE__*/Object.freeze({
-        __proto__: null,
-        badToken: badToken,
-        consentRequired: consentRequired,
-        interactionRequired: interactionRequired,
-        interruptedUser: interruptedUser,
-        loginRequired: loginRequired,
-        nativeAccountUnavailable: nativeAccountUnavailable,
-        noTokensFound: noTokensFound,
-        refreshTokenExpired: refreshTokenExpired,
-        uxNotAllowed: uxNotAllowed
-    });
+    function wasClockTurnedBack(cachedAt) {
+        const cachedAtSec = Number(cachedAt);
+        return cachedAtSec > nowSeconds();
+    }
 
-    /*! @azure/msal-common v16.1.0 2026-02-24 */
+    /*! @azure/msal-common v16.2.1 2026-04-01 */
 
     /*
      * Copyright (c) Microsoft Corporation. All rights reserved.
      * Licensed under the MIT License.
      */
     /**
-     * InteractionRequiredServerErrorMessage contains string constants used by error codes and messages returned by the server indicating interaction is required
+     * Create IdTokenEntity
+     * @param homeAccountId
+     * @param authenticationResult
+     * @param clientId
+     * @param authority
      */
-    const InteractionRequiredServerErrorMessage = [
-        interactionRequired,
-        consentRequired,
-        loginRequired,
-        badToken,
-        uxNotAllowed,
-        interruptedUser,
-    ];
-    const InteractionRequiredAuthSubErrorMessage = [
-        "message_only",
-        "additional_action",
-        "basic_action",
-        "user_password_expired",
-        "consent_required",
-        "bad_token",
-        "ux_not_allowed",
-        "interrupted_user",
-    ];
+    function createIdTokenEntity(homeAccountId, environment, idToken, clientId, tenantId) {
+        const idTokenEntity = {
+            credentialType: CredentialType.ID_TOKEN,
+            homeAccountId: homeAccountId,
+            environment: environment,
+            clientId: clientId,
+            secret: idToken,
+            realm: tenantId,
+            lastUpdatedAt: Date.now().toString(), // Set the last updated time to now
+        };
+        return idTokenEntity;
+    }
     /**
-     * Error thrown when user interaction is required.
+     * Create AccessTokenEntity
+     * @param homeAccountId
+     * @param environment
+     * @param accessToken
+     * @param clientId
+     * @param tenantId
+     * @param scopes
+     * @param expiresOn
+     * @param extExpiresOn
      */
-    class InteractionRequiredAuthError extends AuthError {
-        constructor(errorCode, errorMessage, subError, timestamp, traceId, correlationId, claims, errorNo) {
-            super(errorCode, errorMessage, subError);
-            Object.setPrototypeOf(this, InteractionRequiredAuthError.prototype);
-            this.timestamp = timestamp || "";
-            this.traceId = traceId || "";
-            this.correlationId = correlationId || "";
-            this.claims = claims || "";
-            this.name = "InteractionRequiredAuthError";
-            this.errorNo = errorNo;
+    function createAccessTokenEntity(homeAccountId, environment, accessToken, clientId, tenantId, scopes, expiresOn, extExpiresOn, base64Decode, refreshOn, tokenType, userAssertionHash, keyId) {
+        const atEntity = {
+            homeAccountId: homeAccountId,
+            credentialType: CredentialType.ACCESS_TOKEN,
+            secret: accessToken,
+            cachedAt: nowSeconds().toString(),
+            expiresOn: expiresOn.toString(),
+            extendedExpiresOn: extExpiresOn.toString(),
+            environment: environment,
+            clientId: clientId,
+            realm: tenantId,
+            target: scopes,
+            tokenType: tokenType || AuthenticationScheme$1.BEARER,
+            lastUpdatedAt: Date.now().toString(), // Set the last updated time to now
+        };
+        if (userAssertionHash) {
+            atEntity.userAssertionHash = userAssertionHash;
+        }
+        if (refreshOn) {
+            atEntity.refreshOn = refreshOn.toString();
+        }
+        /*
+         * Create Access Token With Auth Scheme instead of regular access token
+         * Cast to lower to handle "bearer" from ADFS
+         */
+        if (atEntity.tokenType?.toLowerCase() !==
+            AuthenticationScheme$1.BEARER.toLowerCase()) {
+            atEntity.credentialType =
+                CredentialType.ACCESS_TOKEN_WITH_AUTH_SCHEME;
+            switch (atEntity.tokenType) {
+                case AuthenticationScheme$1.POP:
+                    // Make sure keyId is present and add it to credential
+                    const tokenClaims = extractTokenClaims(accessToken, base64Decode);
+                    if (!tokenClaims?.cnf?.kid) {
+                        throw createClientAuthError(tokenClaimsCnfRequiredForSignedJwt);
+                    }
+                    atEntity.keyId = tokenClaims.cnf.kid;
+                    break;
+                case AuthenticationScheme$1.SSH:
+                    atEntity.keyId = keyId;
+            }
         }
+        return atEntity;
     }
     /**
-     * Helper function used to determine if an error thrown by the server requires interaction to resolve
-     * @param errorCode
-     * @param errorString
-     * @param subError
+     * Create RefreshTokenEntity
+     * @param homeAccountId
+     * @param authenticationResult
+     * @param clientId
+     * @param authority
      */
-    function isInteractionRequiredError(errorCode, errorString, subError) {
-        const isInteractionRequiredErrorCode = !!errorCode &&
-            InteractionRequiredServerErrorMessage.indexOf(errorCode) > -1;
-        const isInteractionRequiredSubError = !!subError &&
-            InteractionRequiredAuthSubErrorMessage.indexOf(subError) > -1;
-        const isInteractionRequiredErrorDesc = !!errorString &&
-            InteractionRequiredServerErrorMessage.some((irErrorCode) => {
-                return errorString.indexOf(irErrorCode) > -1;
-            });
-        return (isInteractionRequiredErrorCode ||
-            isInteractionRequiredErrorDesc ||
-            isInteractionRequiredSubError);
+    function createRefreshTokenEntity(homeAccountId, environment, refreshToken, clientId, familyId, userAssertionHash, expiresOn) {
+        const rtEntity = {
+            credentialType: CredentialType.REFRESH_TOKEN,
+            homeAccountId: homeAccountId,
+            environment: environment,
+            clientId: clientId,
+            secret: refreshToken,
+            lastUpdatedAt: Date.now().toString(),
+        };
+        if (userAssertionHash) {
+            rtEntity.userAssertionHash = userAssertionHash;
+        }
+        if (familyId) {
+            rtEntity.familyId = familyId;
+        }
+        if (expiresOn) {
+            rtEntity.expiresOn = expiresOn.toString();
+        }
+        return rtEntity;
+    }
+    function isCredentialEntity(entity) {
+        return (entity.hasOwnProperty("homeAccountId") &&
+            entity.hasOwnProperty("environment") &&
+            entity.hasOwnProperty("credentialType") &&
+            entity.hasOwnProperty("clientId") &&
+            entity.hasOwnProperty("secret"));
     }
     /**
-     * Creates an InteractionRequiredAuthError
-     */
-    function createInteractionRequiredAuthError(errorCode, errorMessage) {
-        return new InteractionRequiredAuthError(errorCode, errorMessage);
-    }
-
-    /*! @azure/msal-common v16.1.0 2026-02-24 */
-
-    /*
-     * Copyright (c) Microsoft Corporation. All rights reserved.
-     * Licensed under the MIT License.
+     * Validates an entity: checks for all expected params
+     * @param entity
      */
+    function isAccessTokenEntity(entity) {
+        if (!entity) {
+            return false;
+        }
+        return (isCredentialEntity(entity) &&
+            entity.hasOwnProperty("realm") &&
+            entity.hasOwnProperty("target") &&
+            (entity["credentialType"] === CredentialType.ACCESS_TOKEN ||
+                entity["credentialType"] ===
+                    CredentialType.ACCESS_TOKEN_WITH_AUTH_SCHEME));
+    }
     /**
-     * Appends user state with random guid, or returns random guid.
-     * @param cryptoObj
-     * @param userState
-     * @param meta
+     * Validates an entity: checks for all expected params
+     * @param entity
      */
-    function setRequestState(cryptoObj, userState, meta) {
-        const libraryState = generateLibraryState(cryptoObj, meta);
-        return userState
-            ? `${libraryState}${RESOURCE_DELIM}${userState}`
-            : libraryState;
+    function isIdTokenEntity(entity) {
+        if (!entity) {
+            return false;
+        }
+        return (isCredentialEntity(entity) &&
+            entity.hasOwnProperty("realm") &&
+            entity["credentialType"] === CredentialType.ID_TOKEN);
     }
     /**
-     * Generates the state value used by the common library.
-     * @param cryptoObj
-     * @param meta
+     * Validates an entity: checks for all expected params
+     * @param entity
      */
-    function generateLibraryState(cryptoObj, meta) {
-        if (!cryptoObj) {
-            throw createClientAuthError(noCryptoObject);
-        }
-        // Create a state object containing a unique id and the timestamp of the request creation
-        const stateObj = {
-            id: cryptoObj.createNewGuid(),
-        };
-        if (meta) {
-            stateObj.meta = meta;
+    function isRefreshTokenEntity(entity) {
+        if (!entity) {
+            return false;
         }
-        const stateString = JSON.stringify(stateObj);
-        return cryptoObj.base64Encode(stateString);
+        return (isCredentialEntity(entity) &&
+            entity["credentialType"] === CredentialType.REFRESH_TOKEN);
     }
     /**
-     * Parses the state into the RequestStateObject, which contains the LibraryState info and the state passed by the user.
-     * @param base64Decode
-     * @param state
+     * validates if a given cache entry is "Telemetry", parses <key,value>
+     * @param key
+     * @param entity
      */
-    function parseRequestState(base64Decode, state) {
-        if (!base64Decode) {
-            throw createClientAuthError(noCryptoObject);
-        }
-        if (!state) {
-            throw createClientAuthError(invalidState);
-        }
-        try {
-            // Split the state between library state and user passed state and decode them separately
-            const splitState = state.split(RESOURCE_DELIM);
-            const libraryState = splitState[0];
-            const userState = splitState.length > 1
-                ? splitState.slice(1).join(RESOURCE_DELIM)
-                : "";
-            const libraryStateString = base64Decode(libraryState);
-            const libraryStateObj = JSON.parse(libraryStateString);
-            return {
-                userRequestState: userState || "",
-                libraryState: libraryStateObj,
-            };
-        }
-        catch (e) {
-            throw createClientAuthError(invalidState);
+    function isServerTelemetryEntity(key, entity) {
+        const validateKey = key.indexOf(SERVER_TELEM_CACHE_KEY) === 0;
+        let validateEntity = true;
+        if (entity) {
+            validateEntity =
+                entity.hasOwnProperty("failedRequests") &&
+                    entity.hasOwnProperty("errors") &&
+                    entity.hasOwnProperty("cacheHits");
         }
-    }
-
-    /*! @azure/msal-common v16.1.0 2026-02-24 */
-    /*
-     * Copyright (c) Microsoft Corporation. All rights reserved.
-     * Licensed under the MIT License.
-     */
+        return validateKey && validateEntity;
+    }
     /**
-     * Utility functions for managing date and time operations.
+     * validates if a given cache entry is "Throttling", parses <key,value>
+     * @param key
+     * @param entity
      */
+    function isThrottlingEntity(key, entity) {
+        let validateKey = false;
+        if (key) {
+            validateKey = key.indexOf(THROTTLING_PREFIX) === 0;
+        }
+        let validateEntity = true;
+        if (entity) {
+            validateEntity = entity.hasOwnProperty("throttleTime");
+        }
+        return validateKey && validateEntity;
+    }
     /**
-     * return the current time in Unix time (seconds).
+     * Generate AppMetadata Cache Key as per the schema: appmetadata-<environment>-<client_id>
      */
-    function nowSeconds() {
-        // Date.getTime() returns in milliseconds.
-        return Math.round(new Date().getTime() / 1000.0);
+    function generateAppMetadataKey({ environment, clientId, }) {
+        const appMetaDataKeyArray = [
+            APP_METADATA,
+            environment,
+            clientId,
+        ];
+        return appMetaDataKeyArray
+            .join(CACHE_KEY_SEPARATOR$1)
+            .toLowerCase();
     }
-    /**
-     * Converts JS Date object to seconds
-     * @param date Date
+    /*
+     * Validates an entity: checks for all expected params
+     * @param entity
      */
-    function toSecondsFromDate(date) {
-        // Convert date to seconds
-        return date.getTime() / 1000;
+    function isAppMetadataEntity(key, entity) {
+        if (!entity) {
+            return false;
+        }
+        return (key.indexOf(APP_METADATA) === 0 &&
+            entity.hasOwnProperty("clientId") &&
+            entity.hasOwnProperty("environment"));
     }
     /**
-     * Convert seconds to JS Date object. Seconds can be in a number or string format or undefined (will still return a date).
-     * @param seconds
+     * Validates an entity: checks for all expected params
+     * @param entity
      */
-    function toDateFromSeconds(seconds) {
-        if (seconds) {
-            return new Date(Number(seconds) * 1000);
+    function isAuthorityMetadataEntity(key, entity) {
+        if (!entity) {
+            return false;
         }
-        return new Date();
+        return (key.indexOf(AUTHORITY_METADATA_CACHE_KEY) === 0 &&
+            entity.hasOwnProperty("aliases") &&
+            entity.hasOwnProperty("preferred_cache") &&
+            entity.hasOwnProperty("preferred_network") &&
+            entity.hasOwnProperty("canonical_authority") &&
+            entity.hasOwnProperty("authorization_endpoint") &&
+            entity.hasOwnProperty("token_endpoint") &&
+            entity.hasOwnProperty("issuer") &&
+            entity.hasOwnProperty("aliasesFromNetwork") &&
+            entity.hasOwnProperty("endpointsFromNetwork") &&
+            entity.hasOwnProperty("expiresAt") &&
+            entity.hasOwnProperty("jwks_uri"));
     }
     /**
-     * check if a token is expired based on given UTC time in seconds.
-     * @param expiresOn
+     * Reset the exiresAt value
      */
-    function isTokenExpired(expiresOn, offset) {
-        // check for access token expiry
-        const expirationSec = Number(expiresOn) || 0;
-        const offsetCurrentTimeSec = nowSeconds() + offset;
-        // If current time + offset is greater than token expiration time, then token is expired.
-        return offsetCurrentTimeSec > expirationSec;
+    function generateAuthorityMetadataExpiresAt() {
+        return (nowSeconds() +
+            AUTHORITY_METADATA_REFRESH_TIME_SECONDS);
     }
-    /**
-     * Checks if a cache entry is expired based on the last updated time and cache retention days.
-     * @param lastUpdatedAt
-     * @param cacheRetentionDays
-     * @returns
-     */
-    function isCacheExpired(lastUpdatedAt, cacheRetentionDays) {
-        const cacheExpirationTimestamp = Number(lastUpdatedAt) + cacheRetentionDays * 24 * 60 * 60 * 1000;
-        return Date.now() > cacheExpirationTimestamp;
+    function updateAuthorityEndpointMetadata(authorityMetadata, updatedValues, fromNetwork) {
+        authorityMetadata.authorization_endpoint =
+            updatedValues.authorization_endpoint;
+        authorityMetadata.token_endpoint = updatedValues.token_endpoint;
+        authorityMetadata.end_session_endpoint = updatedValues.end_session_endpoint;
+        authorityMetadata.issuer = updatedValues.issuer;
+        authorityMetadata.endpointsFromNetwork = fromNetwork;
+        authorityMetadata.jwks_uri = updatedValues.jwks_uri;
+    }
+    function updateCloudDiscoveryMetadata(authorityMetadata, updatedValues, fromNetwork) {
+        authorityMetadata.aliases = updatedValues.aliases;
+        authorityMetadata.preferred_cache = updatedValues.preferred_cache;
+        authorityMetadata.preferred_network = updatedValues.preferred_network;
+        authorityMetadata.aliasesFromNetwork = fromNetwork;
     }
     /**
-     * If the current time is earlier than the time that a token was cached at, we must discard the token
-     * i.e. The system clock was turned back after acquiring the cached token
-     * @param cachedAt
-     * @param offset
+     * Returns whether or not the data needs to be refreshed
      */
-    function wasClockTurnedBack(cachedAt) {
-        const cachedAtSec = Number(cachedAt);
-        return cachedAtSec > nowSeconds();
+    function isAuthorityMetadataExpired(metadata) {
+        return metadata.expiresAt <= nowSeconds();
     }
 
-    /*! @azure/msal-common v16.1.0 2026-02-24 */
+    /*! @azure/msal-common v16.2.1 2026-04-01 */
     /*
      * Copyright (c) Microsoft Corporation. All rights reserved.
      * Licensed under the MIT License.
@@ -4028,7 +4102,7 @@
     const CacheManagerGetRefreshToken = "cacheManagerGetRefreshToken";
     const SetUserData = "setUserData";
 
-    /*! @azure/msal-common v16.1.0 2026-02-24 */
+    /*! @azure/msal-common v16.2.1 2026-04-01 */
     /*
      * Copyright (c) Microsoft Corporation. All rights reserved.
      * Licensed under the MIT License.
@@ -4051,8 +4125,7 @@
             const inProgressEvent = telemetryClient.startMeasurement(eventName, correlationId);
             if (correlationId) {
                 // Track number of times this API is called in a single request
-                const eventCount = eventName + "CallCount";
-                telemetryClient.incrementFields({ [eventCount]: 1 }, correlationId);
+                telemetryClient.incrementFields({ [`ext.${eventName}CallCount`]: 1 }, correlationId);
             }
             try {
                 const result = callback(...args);
@@ -4096,8 +4169,7 @@
             const inProgressEvent = telemetryClient.startMeasurement(eventName, correlationId);
             if (correlationId) {
                 // Track number of times this API is called in a single request
-                const eventCount = eventName + "CallCount";
-                telemetryClient.incrementFields({ [eventCount]: 1 }, correlationId);
+                telemetryClient.incrementFields({ [`ext.${eventName}CallCount`]: 1 }, correlationId);
             }
             return callback(...args)
                 .then((response) => {
@@ -4123,7 +4195,7 @@
         };
     };
 
-    /*! @azure/msal-common v16.1.0 2026-02-24 */
+    /*! @azure/msal-common v16.2.1 2026-04-01 */
 
     /*
      * Copyright (c) Microsoft Corporation. All rights reserved.
@@ -4203,293 +4275,226 @@
         }
     }
 
-    /*! @azure/msal-common v16.1.0 2026-02-24 */
+    /*! @azure/msal-common v16.2.1 2026-04-01 */
     /*
      * Copyright (c) Microsoft Corporation. All rights reserved.
      * Licensed under the MIT License.
      */
     /**
-     * This class instance helps track the memory changes facilitating
-     * decisions to read from and write to the persistent cache
-     */ class TokenCacheContext {
-        constructor(tokenCache, hasChanged) {
-            this.cache = tokenCache;
-            this.hasChanged = hasChanged;
-        }
-        /**
-         * boolean which indicates the changes in cache
-         */
-        get cacheHasChanged() {
-            return this.hasChanged;
-        }
-        /**
-         * function to retrieve the token cache
-         */
-        get tokenCache() {
-            return this.cache;
-        }
-    }
-
-    /*! @azure/msal-common v16.1.0 2026-02-24 */
-
-    /*
-     * Copyright (c) Microsoft Corporation. All rights reserved.
-     * Licensed under the MIT License.
+     * MSAL-defined interaction required error code indicating no tokens are found in cache.
+     * @public
      */
+    const noTokensFound = "no_tokens_found";
     /**
-     * Create IdTokenEntity
-     * @param homeAccountId
-     * @param authenticationResult
-     * @param clientId
-     * @param authority
+     * MSAL-defined error code indicating a native account is unavailable on the platform.
+     * @public
      */
-    function createIdTokenEntity(homeAccountId, environment, idToken, clientId, tenantId) {
-        const idTokenEntity = {
-            credentialType: CredentialType.ID_TOKEN,
-            homeAccountId: homeAccountId,
-            environment: environment,
-            clientId: clientId,
-            secret: idToken,
-            realm: tenantId,
-            lastUpdatedAt: Date.now().toString(), // Set the last updated time to now
-        };
-        return idTokenEntity;
-    }
+    const nativeAccountUnavailable = "native_account_unavailable";
     /**
-     * Create AccessTokenEntity
-     * @param homeAccountId
-     * @param environment
-     * @param accessToken
-     * @param clientId
-     * @param tenantId
-     * @param scopes
-     * @param expiresOn
-     * @param extExpiresOn
+     * MSAL-defined error code indicating the refresh token has expired and user interaction is needed.
+     * @public
      */
-    function createAccessTokenEntity(homeAccountId, environment, accessToken, clientId, tenantId, scopes, expiresOn, extExpiresOn, base64Decode, refreshOn, tokenType, userAssertionHash, keyId) {
-        const atEntity = {
-            homeAccountId: homeAccountId,
-            credentialType: CredentialType.ACCESS_TOKEN,
-            secret: accessToken,
-            cachedAt: nowSeconds().toString(),
-            expiresOn: expiresOn.toString(),
-            extendedExpiresOn: extExpiresOn.toString(),
-            environment: environment,
-            clientId: clientId,
-            realm: tenantId,
-            target: scopes,
-            tokenType: tokenType || AuthenticationScheme$1.BEARER,
-            lastUpdatedAt: Date.now().toString(), // Set the last updated time to now
-        };
-        if (userAssertionHash) {
-            atEntity.userAssertionHash = userAssertionHash;
-        }
-        if (refreshOn) {
-            atEntity.refreshOn = refreshOn.toString();
-        }
-        /*
-         * Create Access Token With Auth Scheme instead of regular access token
-         * Cast to lower to handle "bearer" from ADFS
-         */
-        if (atEntity.tokenType?.toLowerCase() !==
-            AuthenticationScheme$1.BEARER.toLowerCase()) {
-            atEntity.credentialType =
-                CredentialType.ACCESS_TOKEN_WITH_AUTH_SCHEME;
-            switch (atEntity.tokenType) {
-                case AuthenticationScheme$1.POP:
-                    // Make sure keyId is present and add it to credential
-                    const tokenClaims = extractTokenClaims(accessToken, base64Decode);
-                    if (!tokenClaims?.cnf?.kid) {
-                        throw createClientAuthError(tokenClaimsCnfRequiredForSignedJwt);
-                    }
-                    atEntity.keyId = tokenClaims.cnf.kid;
-                    break;
-                case AuthenticationScheme$1.SSH:
-                    atEntity.keyId = keyId;
-            }
-        }
-        return atEntity;
-    }
+    const refreshTokenExpired = "refresh_token_expired";
     /**
-     * Create RefreshTokenEntity
-     * @param homeAccountId
-     * @param authenticationResult
-     * @param clientId
-     * @param authority
+     * MSAL-defined error code indicating UI/UX is not allowed (e.g., blocked by policy), requiring alternate interaction.
+     * @public
      */
-    function createRefreshTokenEntity(homeAccountId, environment, refreshToken, clientId, familyId, userAssertionHash, expiresOn) {
-        const rtEntity = {
-            credentialType: CredentialType.REFRESH_TOKEN,
-            homeAccountId: homeAccountId,
-            environment: environment,
-            clientId: clientId,
-            secret: refreshToken,
-            lastUpdatedAt: Date.now().toString(),
-        };
-        if (userAssertionHash) {
-            rtEntity.userAssertionHash = userAssertionHash;
-        }
-        if (familyId) {
-            rtEntity.familyId = familyId;
-        }
-        if (expiresOn) {
-            rtEntity.expiresOn = expiresOn.toString();
-        }
-        return rtEntity;
-    }
-    function isCredentialEntity(entity) {
-        return (entity.hasOwnProperty("homeAccountId") &&
-            entity.hasOwnProperty("environment") &&
-            entity.hasOwnProperty("credentialType") &&
-            entity.hasOwnProperty("clientId") &&
-            entity.hasOwnProperty("secret"));
-    }
+    const uxNotAllowed = "ux_not_allowed";
     /**
-     * Validates an entity: checks for all expected params
-     * @param entity
+     * Server-originated error code indicating interaction is required to complete the request.
+     * @public
      */
-    function isAccessTokenEntity(entity) {
-        if (!entity) {
-            return false;
-        }
-        return (isCredentialEntity(entity) &&
-            entity.hasOwnProperty("realm") &&
-            entity.hasOwnProperty("target") &&
-            (entity["credentialType"] === CredentialType.ACCESS_TOKEN ||
-                entity["credentialType"] ===
-                    CredentialType.ACCESS_TOKEN_WITH_AUTH_SCHEME));
-    }
+    const interactionRequired = "interaction_required";
     /**
-     * Validates an entity: checks for all expected params
-     * @param entity
+     * Server-originated error code indicating user consent is required.
+     * @public
+     */
+    const consentRequired = "consent_required";
+    /**
+     * Server-originated error code indicating user login is required.
+     * @public
+     */
+    const loginRequired = "login_required";
+    /**
+     * Server-originated error code indicating the token is invalid or corrupted.
+     * @public
+     */
+    const badToken = "bad_token";
+    /**
+     * Server-originated error code indicating the user is in an interrupted state and interaction is required.
+     * @public
+     */
+    const interruptedUser = "interrupted_user";
+
+    var InteractionRequiredAuthErrorCodes = /*#__PURE__*/Object.freeze({
+        __proto__: null,
+        badToken: badToken,
+        consentRequired: consentRequired,
+        interactionRequired: interactionRequired,
+        interruptedUser: interruptedUser,
+        loginRequired: loginRequired,
+        nativeAccountUnavailable: nativeAccountUnavailable,
+        noTokensFound: noTokensFound,
+        refreshTokenExpired: refreshTokenExpired,
+        uxNotAllowed: uxNotAllowed
+    });
+
+    /*! @azure/msal-common v16.2.1 2026-04-01 */
+
+    /*
+     * Copyright (c) Microsoft Corporation. All rights reserved.
+     * Licensed under the MIT License.
      */
-    function isIdTokenEntity(entity) {
-        if (!entity) {
-            return false;
-        }
-        return (isCredentialEntity(entity) &&
-            entity.hasOwnProperty("realm") &&
-            entity["credentialType"] === CredentialType.ID_TOKEN);
-    }
     /**
-     * Validates an entity: checks for all expected params
-     * @param entity
+     * InteractionRequiredServerErrorMessage contains string constants used by error codes and messages returned by the server indicating interaction is required
      */
-    function isRefreshTokenEntity(entity) {
-        if (!entity) {
-            return false;
-        }
-        return (isCredentialEntity(entity) &&
-            entity["credentialType"] === CredentialType.REFRESH_TOKEN);
-    }
+    const InteractionRequiredServerErrorMessage = [
+        interactionRequired,
+        consentRequired,
+        loginRequired,
+        badToken,
+        uxNotAllowed,
+        interruptedUser,
+    ];
+    const InteractionRequiredAuthSubErrorMessage = [
+        "message_only",
+        "additional_action",
+        "basic_action",
+        "user_password_expired",
+        "consent_required",
+        "bad_token",
+        "ux_not_allowed",
+        "interrupted_user",
+    ];
     /**
-     * validates if a given cache entry is "Telemetry", parses <key,value>
-     * @param key
-     * @param entity
+     * Error thrown when user interaction is required.
      */
-    function isServerTelemetryEntity(key, entity) {
-        const validateKey = key.indexOf(SERVER_TELEM_CACHE_KEY) === 0;
-        let validateEntity = true;
-        if (entity) {
-            validateEntity =
-                entity.hasOwnProperty("failedRequests") &&
-                    entity.hasOwnProperty("errors") &&
-                    entity.hasOwnProperty("cacheHits");
+    class InteractionRequiredAuthError extends AuthError {
+        constructor(errorCode, errorMessage, subError, timestamp, traceId, correlationId, claims, errorNo) {
+            super(errorCode, errorMessage, subError);
+            Object.setPrototypeOf(this, InteractionRequiredAuthError.prototype);
+            this.timestamp = timestamp || "";
+            this.traceId = traceId || "";
+            this.correlationId = correlationId || "";
+            this.claims = claims || "";
+            this.name = "InteractionRequiredAuthError";
+            this.errorNo = errorNo;
         }
-        return validateKey && validateEntity;
     }
     /**
-     * validates if a given cache entry is "Throttling", parses <key,value>
-     * @param key
-     * @param entity
+     * Helper function used to determine if an error thrown by the server requires interaction to resolve
+     * @param errorCode
+     * @param errorString
+     * @param subError
      */
-    function isThrottlingEntity(key, entity) {
-        let validateKey = false;
-        if (key) {
-            validateKey = key.indexOf(THROTTLING_PREFIX) === 0;
-        }
-        let validateEntity = true;
-        if (entity) {
-            validateEntity = entity.hasOwnProperty("throttleTime");
-        }
-        return validateKey && validateEntity;
+    function isInteractionRequiredError(errorCode, errorString, subError) {
+        const isInteractionRequiredErrorCode = !!errorCode &&
+            InteractionRequiredServerErrorMessage.indexOf(errorCode) > -1;
+        const isInteractionRequiredSubError = !!subError &&
+            InteractionRequiredAuthSubErrorMessage.indexOf(subError) > -1;
+        const isInteractionRequiredErrorDesc = !!errorString &&
+            InteractionRequiredServerErrorMessage.some((irErrorCode) => {
+                return errorString.indexOf(irErrorCode) > -1;
+            });
+        return (isInteractionRequiredErrorCode ||
+            isInteractionRequiredErrorDesc ||
+            isInteractionRequiredSubError);
     }
     /**
-     * Generate AppMetadata Cache Key as per the schema: appmetadata-<environment>-<client_id>
+     * Creates an InteractionRequiredAuthError
      */
-    function generateAppMetadataKey({ environment, clientId, }) {
-        const appMetaDataKeyArray = [
-            APP_METADATA,
-            environment,
-            clientId,
-        ];
-        return appMetaDataKeyArray
-            .join(CACHE_KEY_SEPARATOR$1)
-            .toLowerCase();
-    }
+    function createInteractionRequiredAuthError(errorCode, errorMessage) {
+        return new InteractionRequiredAuthError(errorCode, errorMessage);
+    }
+
+    /*! @azure/msal-common v16.2.1 2026-04-01 */
+
     /*
-     * Validates an entity: checks for all expected params
-     * @param entity
+     * Copyright (c) Microsoft Corporation. All rights reserved.
+     * Licensed under the MIT License.
      */
-    function isAppMetadataEntity(key, entity) {
-        if (!entity) {
-            return false;
-        }
-        return (key.indexOf(APP_METADATA) === 0 &&
-            entity.hasOwnProperty("clientId") &&
-            entity.hasOwnProperty("environment"));
-    }
     /**
-     * Validates an entity: checks for all expected params
-     * @param entity
+     * Error thrown when there is an error with the server code, for example, unavailability.
      */
-    function isAuthorityMetadataEntity(key, entity) {
-        if (!entity) {
-            return false;
+    class ServerError extends AuthError {
+        constructor(errorCode, errorMessage, subError, errorNo, status) {
+            super(errorCode, errorMessage, subError);
+            this.name = "ServerError";
+            this.errorNo = errorNo;
+            this.status = status;
+            Object.setPrototypeOf(this, ServerError.prototype);
         }
-        return (key.indexOf(AUTHORITY_METADATA_CACHE_KEY) === 0 &&
-            entity.hasOwnProperty("aliases") &&
-            entity.hasOwnProperty("preferred_cache") &&
-            entity.hasOwnProperty("preferred_network") &&
-            entity.hasOwnProperty("canonical_authority") &&
-            entity.hasOwnProperty("authorization_endpoint") &&
-            entity.hasOwnProperty("token_endpoint") &&
-            entity.hasOwnProperty("issuer") &&
-            entity.hasOwnProperty("aliasesFromNetwork") &&
-            entity.hasOwnProperty("endpointsFromNetwork") &&
-            entity.hasOwnProperty("expiresAt") &&
-            entity.hasOwnProperty("jwks_uri"));
-    }
+    }
+
+    /*! @azure/msal-common v16.2.1 2026-04-01 */
+
+    /*
+     * Copyright (c) Microsoft Corporation. All rights reserved.
+     * Licensed under the MIT License.
+     */
     /**
-     * Reset the exiresAt value
+     * Appends user state with random guid, or returns random guid.
+     * @param cryptoObj
+     * @param userState
+     * @param meta
      */
-    function generateAuthorityMetadataExpiresAt() {
-        return (nowSeconds() +
-            AUTHORITY_METADATA_REFRESH_TIME_SECONDS);
-    }
-    function updateAuthorityEndpointMetadata(authorityMetadata, updatedValues, fromNetwork) {
-        authorityMetadata.authorization_endpoint =
-            updatedValues.authorization_endpoint;
-        authorityMetadata.token_endpoint = updatedValues.token_endpoint;
-        authorityMetadata.end_session_endpoint = updatedValues.end_session_endpoint;
-        authorityMetadata.issuer = updatedValues.issuer;
-        authorityMetadata.endpointsFromNetwork = fromNetwork;
-        authorityMetadata.jwks_uri = updatedValues.jwks_uri;
+    function setRequestState(cryptoObj, userState, meta) {
+        const libraryState = generateLibraryState(cryptoObj, meta);
+        return userState
+            ? `${libraryState}${RESOURCE_DELIM}${userState}`
+            : libraryState;
     }
-    function updateCloudDiscoveryMetadata(authorityMetadata, updatedValues, fromNetwork) {
-        authorityMetadata.aliases = updatedValues.aliases;
-        authorityMetadata.preferred_cache = updatedValues.preferred_cache;
-        authorityMetadata.preferred_network = updatedValues.preferred_network;
-        authorityMetadata.aliasesFromNetwork = fromNetwork;
+    /**
+     * Generates the state value used by the common library.
+     * @param cryptoObj
+     * @param meta
+     */
+    function generateLibraryState(cryptoObj, meta) {
+        if (!cryptoObj) {
+            throw createClientAuthError(noCryptoObject);
+        }
+        // Create a state object containing a unique id and the timestamp of the request creation
+        const stateObj = {
+            id: cryptoObj.createNewGuid(),
+        };
+        if (meta) {
+            stateObj.meta = meta;
+        }
+        const stateString = JSON.stringify(stateObj);
+        return cryptoObj.base64Encode(stateString);
     }
     /**
-     * Returns whether or not the data needs to be refreshed
+     * Parses the state into the RequestStateObject, which contains the LibraryState info and the state passed by the user.
+     * @param base64Decode
+     * @param state
      */
-    function isAuthorityMetadataExpired(metadata) {
-        return metadata.expiresAt <= nowSeconds();
+    function parseRequestState(base64Decode, state) {
+        if (!base64Decode) {
+            throw createClientAuthError(noCryptoObject);
+        }
+        if (!state) {
+            throw createClientAuthError(invalidState);
+        }
+        try {
+            // Split the state between library state and user passed state and decode them separately
+            const splitState = state.split(RESOURCE_DELIM);
+            const libraryState = splitState[0];
+            const userState = splitState.length > 1
+                ? splitState.slice(1).join(RESOURCE_DELIM)
+                : "";
+            const libraryStateString = base64Decode(libraryState);
+            const libraryStateObj = JSON.parse(libraryStateString);
+            return {
+                userRequestState: userState || "",
+                libraryState: libraryStateObj,
+            };
+        }
+        catch (e) {
+            throw createClientAuthError(invalidState);
+        }
     }
 
-    /*! @azure/msal-common v16.1.0 2026-02-24 */
+    /*! @azure/msal-common v16.2.1 2026-04-01 */
 
     /*
      * Copyright (c) Microsoft Corporation. All rights reserved.
@@ -4645,7 +4650,7 @@
             if (serverTokenResponse.id_token && !!idTokenClaims) {
                 cachedIdToken = createIdTokenEntity(this.homeAccountIdentifier, env, serverTokenResponse.id_token, this.clientId, claimsTenantId || "");
                 cachedAccount = buildAccountToCache(this.cacheStorage, authority, this.homeAccountIdentifier, this.cryptoObj.base64Decode, request.correlationId, idTokenClaims, serverTokenResponse.client_info, env, claimsTenantId, authCodePayload, undefined, // nativeAccountId
-                this.logger);
+                this.logger, this.performanceClient);
             }
             // AccessToken
             let cachedAccessToken = null;
@@ -4791,17 +4796,24 @@
             };
         }
     }
-    function buildAccountToCache(cacheStorage, authority, homeAccountId, base64Decode, correlationId, idTokenClaims, clientInfo, environment, claimsTenantId, authCodePayload, nativeAccountId, logger) {
+    function buildAccountToCache(cacheStorage, authority, homeAccountId, base64Decode, correlationId, idTokenClaims, clientInfo, environment, claimsTenantId, authCodePayload, nativeAccountId, logger, performanceClient) {
         logger?.verbose("09jz0t", correlationId);
-        // Check if base account is already cached
-        const accountKeys = cacheStorage.getAccountKeys();
-        const baseAccountKey = accountKeys.find((accountKey) => {
-            return accountKey.startsWith(homeAccountId);
-        });
-        let cachedAccount = null;
-        if (baseAccountKey) {
-            cachedAccount = cacheStorage.getAccount(baseAccountKey, correlationId);
+        /*
+         * Check if base account is already cached. Filter by homeAccountId (identifies
+         * the user's home identity) and environment (identifies the cloud) — the two
+         * tenant-agnostic properties that uniquely locate a base AccountEntity.
+         */
+        const accountEnvironment = environment || authority.getPreferredCache();
+        const matchedAccounts = cacheStorage.getAccountsFilteredBy({ homeAccountId, environment: accountEnvironment }, correlationId);
+        performanceClient?.addFields({ cacheMatchedAccounts: matchedAccounts.length }, correlationId);
+        if (matchedAccounts.length > 1) {
+            /*
+             * Base accounts are expected to be unique for a given homeAccountId in normal cache usage.
+             * If multiple matches exist, ignore the cache hit rather than arbitrarily choosing one.
+             */
+            logger?.warning("0x7ad1", correlationId);
         }
+        const cachedAccount = matchedAccounts.length === 1 ? matchedAccounts[0] : null;
         const baseAccount = cachedAccount ||
             createAccountEntity({
                 homeAccountId,
@@ -4825,7 +4837,7 @@
         return baseAccount;
     }
 
-    /*! @azure/msal-common v16.1.0 2026-02-24 */
+    /*! @azure/msal-common v16.2.1 2026-04-01 */
     /*
      * Copyright (c) Microsoft Corporation. All rights reserved.
      * Licensed under the MIT License.
@@ -4835,7 +4847,7 @@
         UPN: "UPN",
     };
 
-    /*! @azure/msal-common v16.1.0 2026-02-24 */
+    /*! @azure/msal-common v16.2.1 2026-04-01 */
     /*
      * Copyright (c) Microsoft Corporation. All rights reserved.
      * Licensed under the MIT License.
@@ -4853,7 +4865,7 @@
         }
     }
 
-    /*! @azure/msal-common v16.1.0 2026-02-24 */
+    /*! @azure/msal-common v16.2.1 2026-04-01 */
     /*
      * Copyright (c) Microsoft Corporation. All rights reserved.
      * Licensed under the MIT License.
@@ -4874,7 +4886,7 @@
         };
     }
 
-    /*! @azure/msal-common v16.1.0 2026-02-24 */
+    /*! @azure/msal-common v16.2.1 2026-04-01 */
 
     /*
      * Copyright (c) Microsoft Corporation. All rights reserved.
@@ -4960,7 +4972,7 @@
         }
     }
 
-    /*! @azure/msal-common v16.1.0 2026-02-24 */
+    /*! @azure/msal-common v16.2.1 2026-04-01 */
 
     /*
      * Copyright (c) Microsoft Corporation. All rights reserved.
@@ -4991,7 +5003,7 @@
         return new NetworkError(error, httpStatus, responseHeaders);
     }
 
-    /*! @azure/msal-common v16.1.0 2026-02-24 */
+    /*! @azure/msal-common v16.2.1 2026-04-01 */
 
     /*
      * Copyright (c) Microsoft Corporation. All rights reserved.
@@ -5105,7 +5117,7 @@
         return response;
     }
 
-    /*! @azure/msal-common v16.1.0 2026-02-24 */
+    /*! @azure/msal-common v16.2.1 2026-04-01 */
     /*
      * Copyright (c) Microsoft Corporation. All rights reserved.
      * Licensed under the MIT License.
@@ -5117,7 +5129,7 @@
             response.hasOwnProperty("jwks_uri"));
     }
 
-    /*! @azure/msal-common v16.1.0 2026-02-24 */
+    /*! @azure/msal-common v16.2.1 2026-04-01 */
     /*
      * Copyright (c) Microsoft Corporation. All rights reserved.
      * Licensed under the MIT License.
@@ -5127,7 +5139,7 @@
             response.hasOwnProperty("metadata"));
     }
 
-    /*! @azure/msal-common v16.1.0 2026-02-24 */
+    /*! @azure/msal-common v16.2.1 2026-04-01 */
     /*
      * Copyright (c) Microsoft Corporation. All rights reserved.
      * Licensed under the MIT License.
@@ -5137,7 +5149,7 @@
             response.hasOwnProperty("error_description"));
     }
 
-    /*! @azure/msal-common v16.1.0 2026-02-24 */
+    /*! @azure/msal-common v16.2.1 2026-04-01 */
 
     /*
      * Copyright (c) Microsoft Corporation. All rights reserved.
@@ -5242,7 +5254,7 @@
         },
     };
 
-    /*! @azure/msal-common v16.1.0 2026-02-24 */
+    /*! @azure/msal-common v16.2.1 2026-04-01 */
 
     /*
      * Copyright (c) Microsoft Corporation. All rights reserved.
@@ -6062,7 +6074,7 @@
         };
     }
 
-    /*! @azure/msal-common v16.1.0 2026-02-24 */
+    /*! @azure/msal-common v16.2.1 2026-04-01 */
 
     /*
      * Copyright (c) Microsoft Corporation. All rights reserved.
@@ -6096,7 +6108,7 @@
         }
     }
 
-    /*! @azure/msal-common v16.1.0 2026-02-24 */
+    /*! @azure/msal-common v16.2.1 2026-04-01 */
 
     /*
      * Copyright (c) Microsoft Corporation. All rights reserved.
@@ -6356,7 +6368,7 @@
         }
     }
 
-    /*! @azure/msal-common v16.1.0 2026-02-24 */
+    /*! @azure/msal-common v16.2.1 2026-04-01 */
 
     /*
      * Copyright (c) Microsoft Corporation. All rights reserved.
@@ -6581,7 +6593,7 @@
         }
     }
 
-    /*! @azure/msal-common v16.1.0 2026-02-24 */
+    /*! @azure/msal-common v16.2.1 2026-04-01 */
 
     /*
      * Copyright (c) Microsoft Corporation. All rights reserved.
@@ -6690,7 +6702,7 @@
         }
     }
 
-    /*! @azure/msal-common v16.1.0 2026-02-24 */
+    /*! @azure/msal-common v16.2.1 2026-04-01 */
 
     /*
      * Copyright (c) Microsoft Corporation. All rights reserved.
@@ -6705,7 +6717,7 @@
         },
     };
 
-    /*! @azure/msal-common v16.1.0 2026-02-24 */
+    /*! @azure/msal-common v16.2.1 2026-04-01 */
 
     /*
      * Copyright (c) Microsoft Corporation. All rights reserved.
@@ -6929,7 +6941,7 @@
         return account.loginHint || account.idTokenClaims?.login_hint || null;
     }
 
-    /*! @azure/msal-common v16.1.0 2026-02-24 */
+    /*! @azure/msal-common v16.2.1 2026-04-01 */
 
     /*
      * Copyright (c) Microsoft Corporation. All rights reserved.
@@ -6987,7 +6999,7 @@
         }
     }
 
-    /*! @azure/msal-common v16.1.0 2026-02-24 */
+    /*! @azure/msal-common v16.2.1 2026-04-01 */
     /*
      * Copyright (c) Microsoft Corporation. All rights reserved.
      * Licensed under the MIT License.
@@ -7004,7 +7016,7 @@
         unexpectedError: unexpectedError
     });
 
-    /*! @azure/msal-common v16.1.0 2026-02-24 */
+    /*! @azure/msal-common v16.2.1 2026-04-01 */
 
     /*
      * Copyright (c) Microsoft Corporation. All rights reserved.
@@ -7265,7 +7277,7 @@
         }
     }
 
-    /*! @azure/msal-common v16.1.0 2026-02-24 */
+    /*! @azure/msal-common v16.2.1 2026-04-01 */
 
     /*
      * Copyright (c) Microsoft Corporation. All rights reserved.
@@ -7286,7 +7298,7 @@
         return new JoseHeaderError(code);
     }
 
-    /*! @azure/msal-common v16.1.0 2026-02-24 */
+    /*! @azure/msal-common v16.2.1 2026-04-01 */
     /*
      * Copyright (c) Microsoft Corporation. All rights reserved.
      * Licensed under the MIT License.
@@ -7294,7 +7306,7 @@
     const missingKidError = "missing_kid_error";
     const missingAlgError = "missing_alg_error";
 
-    /*! @azure/msal-common v16.1.0 2026-02-24 */
+    /*! @azure/msal-common v16.2.1 2026-04-01 */
 
     /*
      * Copyright (c) Microsoft Corporation. All rights reserved.
@@ -7334,7 +7346,7 @@
         }
     }
 
-    /*! @azure/msal-common v16.1.0 2026-02-24 */
+    /*! @azure/msal-common v16.2.1 2026-04-01 */
 
     /*
      * Copyright (c) Microsoft Corporation. All rights reserved.
@@ -7633,9 +7645,13 @@
             if (error) {
                 addError(error, this.logger, rootEvent);
             }
-            // Add sub-measurement attribute to root event.
+            // Add sub-measurement attribute to root event's ext field.
             if (!isRoot) {
-                rootEvent[event.name + "DurationMs"] = Math.floor(event.durationMs);
+                rootEvent.ext = {
+                    ...rootEvent.ext,
+                    ...event.ext,
+                };
+                rootEvent.ext[event.name + "DurationMs"] = Math.floor(event.durationMs);
                 return { ...rootEvent };
             }
             if (isRoot &&
@@ -7681,10 +7697,32 @@
         addFields(fields, correlationId) {
             const event = this.eventsByCorrelationId.get(correlationId);
             if (event) {
-                this.eventsByCorrelationId.set(correlationId, {
+                const staticFields = {};
+                const dynamicFields = {};
+                for (const key in fields) {
+                    if (key.startsWith(EXT_FIELD_PREFIX)) {
+                        const dynamicKey = key.slice(EXT_FIELD_PREFIX.length);
+                        const value = fields[key];
+                        if (typeof value === "string" ||
+                            typeof value === "number") {
+                            dynamicFields[dynamicKey] = value;
+                        }
+                    }
+                    else {
+                        staticFields[key] = fields[key];
+                    }
+                }
+                const updatedEvent = {
                     ...event,
-                    ...fields,
-                });
+                    ...staticFields,
+                };
+                if (Object.keys(dynamicFields).length) {
+                    updatedEvent.ext = {
+                        ...updatedEvent.ext,
+                        ...dynamicFields,
+                    };
+                }
+                this.eventsByCorrelationId.set(correlationId, updatedEvent);
             }
             else {
                 this.logger.trace("0thl6s", correlationId);
@@ -7699,13 +7737,32 @@
             const event = this.eventsByCorrelationId.get(correlationId);
             if (event) {
                 for (const counter in fields) {
-                    if (!event.hasOwnProperty(counter)) {
-                        event[counter] = 0;
+                    if (counter.startsWith(EXT_FIELD_PREFIX)) {
+                        event.ext = event.ext || {};
+                        // Route to ext sub-object
+                        const dynamicKey = counter.slice(EXT_FIELD_PREFIX.length);
+                        const currentValue = event.ext[dynamicKey];
+                        if (currentValue === undefined) {
+                            event.ext[dynamicKey] = 0;
+                        }
+                        else if (isNaN(Number(currentValue))) {
+                            return;
+                        }
+                        event.ext[dynamicKey] =
+                            (Number(event.ext[dynamicKey]) || 0) +
+                                (fields[counter] ?? 0);
                     }
-                    else if (isNaN(Number(event[counter]))) {
-                        return;
+                    else {
+                        /* eslint-disable custom-msal/no-dynamic-telemetry-fields -- internal dispatching of static fields by name */
+                        if (!event.hasOwnProperty(counter)) {
+                            event[counter] = 0;
+                        }
+                        else if (isNaN(Number(event[counter]))) {
+                            return;
+                        }
+                        event[counter] += fields[counter];
+                        /* eslint-enable custom-msal/no-dynamic-telemetry-fields */
                     }
-                    event[counter] += fields[counter];
                 }
             }
             else {
@@ -7798,9 +7855,11 @@
          */
         truncateIntegralFields(event) {
             this.intFields.forEach((key) => {
+                /* eslint-disable custom-msal/no-dynamic-telemetry-fields -- internal truncation of known integer fields */
                 if (key in event && typeof event[key] === "number") {
                     event[key] = Math.floor(event[key]);
                 }
+                /* eslint-enable custom-msal/no-dynamic-telemetry-fields */
             });
         }
         /**
@@ -10160,7 +10219,7 @@
 
     /* eslint-disable header/header */
     const name = "@azure/msal-browser";
-    const version = "5.3.0";
+    const version = "5.4.1";
 
     /*
      * Copyright (c) Microsoft Corporation. All rights reserved.
@@ -12620,9 +12679,9 @@
             }
             // Get the preferred_cache domain for the given authority
             const authority = await getDiscoveredAuthority(this.config, this.correlationId, this.performanceClient, this.browserStorage, this.logger, request.authority);
-            const baseAccount = buildAccountToCache(this.browserStorage, authority, homeAccountIdentifier, base64Decode, this.correlationId, idTokenClaims, response.client_info, undefined, // environment
+            const baseAccount = buildAccountToCache(this.browserStorage, authority, homeAccountIdentifier, base64Decode, this.correlationId, idTokenClaims, response.client_info, authority.getPreferredCache(), // environment
             idTokenClaims.tid, undefined, // auth code payload
-            response.account.id);
+            response.account.id, this.logger, this.performanceClient);
             // Ensure expires_in is in number format
             response.expires_in = Number(response.expires_in);
             // generate authenticationResult
@@ -18031,7 +18090,7 @@
             const storage = new BrowserCacheManager(browserConfig.auth.clientId, browserConfig.cache, cryptoOps, logger, browserConfig.telemetry.client, new EventHandler(logger), buildStaticAuthorityOptions(browserConfig.auth));
             const authorityString = request.authority || browserConfig.auth.authority;
             const authority = await createDiscoveredInstance(Authority.generateAuthority(authorityString, request.azureCloudOptions), browserConfig.system.networkClient, storage, authorityOptions, logger, correlationId, performanceClient);
-            const cacheRecordAccount = await invokeAsync(loadAccount, LoadAccount, logger, performanceClient, correlationId)(request, options.clientInfo || response.client_info || "", correlationId, storage, logger, cryptoOps, authority, idTokenClaims);
+            const cacheRecordAccount = await invokeAsync(loadAccount, LoadAccount, logger, performanceClient, correlationId)(request, options.clientInfo || response.client_info || "", correlationId, storage, logger, cryptoOps, authority, idTokenClaims, performanceClient);
             const idToken = await invokeAsync(loadIdToken, LoadIdToken, logger, performanceClient, correlationId)(response, cacheRecordAccount.homeAccountId, cacheRecordAccount.environment, cacheRecordAccount.realm, kmsi, correlationId, storage, logger, config.auth.clientId);
             const accessToken = await invokeAsync(loadAccessToken, LoadAccessToken, logger, performanceClient, correlationId)(request, response, cacheRecordAccount.homeAccountId, cacheRecordAccount.environment, cacheRecordAccount.realm, kmsi, options, correlationId, storage, logger, config.auth.clientId);
             const refreshToken = await invokeAsync(loadRefreshToken, LoadRefreshToken, logger, performanceClient, correlationId)(response, cacheRecordAccount.homeAccountId, cacheRecordAccount.environment, kmsi, correlationId, storage, logger, config.auth.clientId, performanceClient);
@@ -18057,7 +18116,7 @@
      * @param requestHomeAccountId
      * @returns `AccountEntity`
      */
-    async function loadAccount(request, clientInfo, correlationId, storage, logger, cryptoObj, authority, idTokenClaims) {
+    async function loadAccount(request, clientInfo, correlationId, storage, logger, cryptoObj, authority, idTokenClaims, performanceClient) {
         logger.verbose("0ke46k", correlationId);
         if (request.account) {
             const accountEntity = createAccountEntityFromAccountInfo(request.account);
@@ -18072,7 +18131,7 @@
         const claimsTenantId = idTokenClaims?.tid;
         const cachedAccount = buildAccountToCache(storage, authority, homeAccountId, base64Decode, correlationId, idTokenClaims, clientInfo, authority.getPreferredCache(), claimsTenantId, undefined, // authCodePayload
         undefined, // nativeAccountId
-        logger);
+        logger, performanceClient);
         await storage.setAccount(cachedAccount, correlationId, isKmsi(idTokenClaims || {}), ApiId.loadExternalTokens);
         return cachedAccount;
     }