From 34f3a71d0f94d0595a2b403e951c9cb0d201d1cd Mon Sep 17 00:00:00 2001
From: Yogesh Chaudhary
Date: Fri, 2 Oct 2026 18:07:40 +0530
Subject: [PATCH] Release v2.28.2
---
.version | 2 +-
CHANGELOG.md | 6 +++
docs/classes/AnonymousSessionError.html | 12 ++---
docs/classes/OAuthError.html | 10 ++--
docs/classes/PasskeyChallengeError.html | 14 ++---
docs/classes/PasskeyGetTokenError.html | 14 ++---
docs/classes/PasskeyRegisterError.html | 14 ++---
docs/functions/Auth0Provider.html | 2 +-
docs/functions/useAuth0.html | 2 +-
docs/functions/useAuth0Suspense.html | 2 +-
docs/functions/useEnterpriseConnect.html | 2 +-
docs/functions/withAuth0.html | 2 +-
.../functions/withAuthenticationRequired.html | 2 +-
docs/interfaces/AnonymousSession.html | 19 +------
docs/interfaces/AnonymousSessionClaims.html | 16 +++---
docs/interfaces/Auth0ContextInterface.html | 52 +++++++++----------
.../CreateAnonymousSessionOptions.html | 8 +--
docs/interfaces/IsFederatedDomainOptions.html | 6 +--
docs/interfaces/LogoutOptions.html | 2 +-
docs/interfaces/RedirectLoginOptions.html | 2 +-
docs/interfaces/UseEnterpriseConnect.html | 6 +--
docs/interfaces/WithAuth0Props.html | 4 +-
.../WithAuthenticationRequiredOptions.html | 12 ++---
docs/types/AnonymousSessionErrorCode.html | 2 +-
docs/types/AppState.html | 8 +--
docs/types/Auth0ProviderOptions.html | 2 +-
.../types/Auth0ProviderWithClientOptions.html | 2 +-
.../types/Auth0ProviderWithConfigOptions.html | 2 +-
docs/types/Auth0SuspenseContextInterface.html | 2 +-
docs/types/ConnectedAccount.html | 2 +-
docs/variables/Auth0Context.html | 2 +-
package-lock.json | 4 +-
package.json | 2 +-
33 files changed, 115 insertions(+), 124 deletions(-)
diff --git a/.version b/.version
index ee331cf3..90775eb1 100644
--- a/.version
+++ b/.version
@@ -1 +1 @@
-v2.28.1
\ No newline at end of file
+v2.28.2
\ No newline at end of file
diff --git a/CHANGELOG.md b/CHANGELOG.md
index fb29db81..47ec885a 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,11 @@
# Change Log
+## [v2.28.2](https://github.com/auth0/auth0-react/tree/v2.28.2) (2026-10-02)
+[Full Changelog](https://github.com/auth0/auth0-react/compare/v2.28.1...v2.28.2)
+
+**Fixed**
+- fix(anonymous): bump auth0-spa-js to v2.28.2 to properly handle session expiry errors [\#1271](https://github.com/auth0/auth0-react/pull/1271) ([yogeshchoudhary147](https://github.com/yogeshchoudhary147))
+
## [v2.28.1](https://github.com/auth0/auth0-react/tree/v2.28.1) (2026-10-02)
[Full Changelog](https://github.com/auth0/auth0-react/compare/v2.28.0...v2.28.1)
diff --git a/docs/classes/AnonymousSessionError.html b/docs/classes/AnonymousSessionError.html
index ab8ec5e7..068e819e 100644
--- a/docs/classes/AnonymousSessionError.html
+++ b/docs/classes/AnonymousSessionError.html
@@ -13,8 +13,8 @@ Class AnonymousSessionError
Hierarchy
@@ -23,7 +23,7 @@ Hierarchy
-Defined in node_modules/@auth0/auth0-auth-js/dist/index.d.ts:3296
+Defined in node_modules/@auth0/auth0-auth-js/dist/index.d.ts:3280
@@ -65,7 +65,7 @@ Parameters
+Defined in node_modules/@auth0/auth0-auth-js/dist/index.d.ts:3290
Properties
@@ -75,7 +75,7 @@ Optional
+Defined in node_modules/@auth0/auth0-auth-js/dist/index.d.ts:3289
code
code : string
@@ -83,7 +83,7 @@
-Defined in node_modules/@auth0/auth0-auth-js/dist/index.d.ts:3301
+Defined in node_modules/@auth0/auth0-auth-js/dist/index.d.ts:3285
-
Properties
+Defined in src/errors.tsx:8
Optionalerror_ description
error_description ?: string
+Defined in src/errors.tsx:8
message
message : string
diff --git a/docs/classes/PasskeyChallengeError.html b/docs/classes/PasskeyChallengeError.html
index 153f9a12..24e13c63 100644
--- a/docs/classes/PasskeyChallengeError.html
+++ b/docs/classes/PasskeyChallengeError.html
@@ -20,7 +20,7 @@ Hierarchy
-Defined in node_modules/@auth0/auth0-auth-js/dist/index.d.ts:3075
+Defined in node_modules/@auth0/auth0-auth-js/dist/index.d.ts:3059
@@ -64,7 +64,7 @@ Parameters
+Defined in node_modules/@auth0/auth0-auth-js/dist/index.d.ts:3060
Properties
@@ -75,19 +75,19 @@ Optional
+Defined in node_modules/@auth0/auth0-auth-js/dist/index.d.ts:3047
Optionalcause
cause ?: PasskeyApiErrorResponse
+Defined in node_modules/@auth0/auth0-auth-js/dist/index.d.ts:3034
+Defined in node_modules/@auth0/auth0-auth-js/dist/index.d.ts:3035
headers ?: Headers
@@ -95,7 +95,7 @@
+Defined in node_modules/@auth0/auth0-auth-js/dist/index.d.ts:3043
message
message : string
@@ -121,7 +121,7 @@ Optional
+Defined in node_modules/@auth0/auth0-auth-js/dist/index.d.ts:3039
Staticstack Trace Limit
stackTraceLimit : number
diff --git a/docs/classes/PasskeyGetTokenError.html b/docs/classes/PasskeyGetTokenError.html
index ed0ee45a..95e320b9 100644
--- a/docs/classes/PasskeyGetTokenError.html
+++ b/docs/classes/PasskeyGetTokenError.html
@@ -22,7 +22,7 @@ Hierarchy
-Defined in node_modules/@auth0/auth0-auth-js/dist/index.d.ts:3084
+Defined in node_modules/@auth0/auth0-auth-js/dist/index.d.ts:3068
@@ -66,7 +66,7 @@ Parameters
+Defined in node_modules/@auth0/auth0-auth-js/dist/index.d.ts:3070
Properties
@@ -77,19 +77,19 @@ Optional
+Defined in node_modules/@auth0/auth0-auth-js/dist/index.d.ts:3047
Optionalcause
cause ?: PasskeyGetTokenApiErrorResponse
+Defined in node_modules/@auth0/auth0-auth-js/dist/index.d.ts:3069
+Defined in node_modules/@auth0/auth0-auth-js/dist/index.d.ts:3035
headers ?: Headers
@@ -97,7 +97,7 @@
+Defined in node_modules/@auth0/auth0-auth-js/dist/index.d.ts:3043
message
message : string
@@ -123,7 +123,7 @@ Optional
+Defined in node_modules/@auth0/auth0-auth-js/dist/index.d.ts:3039
Staticstack Trace Limit
stackTraceLimit : number
diff --git a/docs/classes/PasskeyRegisterError.html b/docs/classes/PasskeyRegisterError.html
index 1e23ef6d..affea2eb 100644
--- a/docs/classes/PasskeyRegisterError.html
+++ b/docs/classes/PasskeyRegisterError.html
@@ -20,7 +20,7 @@ Hierarchy
-Defined in node_modules/@auth0/auth0-auth-js/dist/index.d.ts:3069
+Defined in node_modules/@auth0/auth0-auth-js/dist/index.d.ts:3053
@@ -64,7 +64,7 @@ Parameters
+Defined in node_modules/@auth0/auth0-auth-js/dist/index.d.ts:3054
Properties
@@ -75,19 +75,19 @@ Optional
+Defined in node_modules/@auth0/auth0-auth-js/dist/index.d.ts:3047
Optionalcause
cause ?: PasskeyApiErrorResponse
+Defined in node_modules/@auth0/auth0-auth-js/dist/index.d.ts:3034
+Defined in node_modules/@auth0/auth0-auth-js/dist/index.d.ts:3035
headers ?: Headers
@@ -95,7 +95,7 @@
+Defined in node_modules/@auth0/auth0-auth-js/dist/index.d.ts:3043
message
message : string
@@ -121,7 +121,7 @@ Optional
+Defined in node_modules/@auth0/auth0-auth-js/dist/index.d.ts:3039
Staticstack Trace Limit
stackTraceLimit : number
diff --git a/docs/functions/Auth0Provider.html b/docs/functions/Auth0Provider.html
index 6539c0fd..a25baf25 100644
--- a/docs/functions/Auth0Provider.html
+++ b/docs/functions/Auth0Provider.html
@@ -34,7 +34,7 @@ Parameters
opts : Auth0ProviderOptions < TUser >
Returns Element
+Defined in src/auth0-provider.tsx:203
+Defined in src/use-auth0.tsx:29
+Defined in src/use-auth0-suspense.tsx:43
+Defined in src/use-enterprise-connect.tsx:46
+Defined in src/with-auth0.tsx:29
+Defined in src/with-authentication-required.tsx:103
@@ -57,20 +56,6 @@ Optional
Defined in node_modules/@auth0/auth0-auth-js/dist/index.d.ts:1949
-Optionalsession Replaced
-sessionReplaced ?: boolean
-
-
-Defined in node_modules/@auth0/auth0-auth-js/dist/index.d.ts:1962
-
session Token
sessionToken : string
+
interface AnonymousSessionClaims { aud : string | string [] ; exp : number ; iat : number ; iss : string ; metadata ?: Record < string , string > ; sid : string ; sub : string ; }
-Defined in node_modules/@auth0/auth0-auth-js/dist/index.d.ts:1973
+Defined in node_modules/@auth0/auth0-auth-js/dist/index.d.ts:1960
+Defined in node_modules/@auth0/auth0-auth-js/dist/index.d.ts:1966
exp
exp : number
-Defined in node_modules/@auth0/auth0-auth-js/dist/index.d.ts:1983
+Defined in node_modules/@auth0/auth0-auth-js/dist/index.d.ts:1970
iat
iat : number
-Defined in node_modules/@auth0/auth0-auth-js/dist/index.d.ts:1981
+Defined in node_modules/@auth0/auth0-auth-js/dist/index.d.ts:1968
iss
iss : string
-Defined in node_modules/@auth0/auth0-auth-js/dist/index.d.ts:1975
+Defined in node_modules/@auth0/auth0-auth-js/dist/index.d.ts:1962
metadata ?: Record < string , string >
-Defined in node_modules/@auth0/auth0-auth-js/dist/index.d.ts:1987
+Defined in node_modules/@auth0/auth0-auth-js/dist/index.d.ts:1974
sid
sid : string
-Defined in node_modules/@auth0/auth0-auth-js/dist/index.d.ts:1985
+Defined in node_modules/@auth0/auth0-auth-js/dist/index.d.ts:1972
sub
sub : string
-Defined in node_modules/@auth0/auth0-auth-js/dist/index.d.ts:1977
+Defined in node_modules/@auth0/auth0-auth-js/dist/index.d.ts:1964
Returns Promise < string >
+Defined in src/auth0-context.tsx:340
get Configuration
@@ -153,7 +153,7 @@
+Defined in src/auth0-context.tsx:361
get Dpop Nonce
getDpopNonce : ( id ?: string ) => Promise < string | undefined >
@@ -193,7 +193,7 @@
+Defined in src/auth0-context.tsx:320
set Dpop Nonce
setDpopNonce : ( nonce : string , id ?: string ) => Promise < void >
@@ -232,7 +232,7 @@
+Defined in src/auth0-context.tsx:332
Other
+Defined in src/auth0-context.tsx:482
connect Account With Redirect
@@ -265,7 +265,7 @@ connect A
with the details of the connected account.
+Defined in src/auth0-context.tsx:252
custom Token Exchange
@@ -296,13 +296,13 @@ Parameters
A promise that resolves to the token endpoint response.
+Defined in src/auth0-context.tsx:165
error
error : Error | undefined
+Defined in src/auth-state.tsx:7
exchange Token
@@ -337,7 +337,7 @@
+Defined in src/auth0-context.tsx:198
+Defined in src/auth0-context.tsx:76
get Id Token Claims
getIdTokenClaims : () => Promise < IdToken | undefined >
@@ -361,7 +361,7 @@ get Id TokenReturns all claims from the id_token if available.
+Defined in src/auth0-context.tsx:88
handle Redirect Callback
@@ -385,19 +385,19 @@ Parameters
+Defined in src/auth0-context.tsx:305
is Authenticated
isAuthenticated : boolean
+Defined in src/auth-state.tsx:8
is Loading
isLoading : boolean
+Defined in src/auth-state.tsx:9
login With Custom Token Exchange
@@ -440,7 +440,7 @@
+Defined in src/auth0-context.tsx:138
+Defined in src/auth0-context.tsx:229
login With Redirect
@@ -468,7 +468,7 @@ login With Re
parameters will be auto-generated.
+Defined in src/auth0-context.tsx:211
logout
@@ -481,7 +481,7 @@
+Defined in src/auth0-context.tsx:266
+Defined in src/auth0-context.tsx:415
my Account
@@ -532,7 +532,7 @@
+Defined in src/auth0-context.tsx:467
passkey
@@ -548,7 +548,7 @@
+Defined in src/auth0-context.tsx:431
revoke Refresh Token
@@ -585,13 +585,13 @@ Parameters
Returns Promise < void >
+Defined in src/auth0-context.tsx:295
+Defined in src/auth-state.tsx:10
Tokens
+Defined in src/auth0-context.tsx:62
-Defined in node_modules/@auth0/auth0-auth-js/dist/index.d.ts:1999
+Defined in node_modules/@auth0/auth0-auth-js/dist/index.d.ts:1986
metadata ?: Record < string , string >
@@ -46,14 +46,14 @@
+Defined in node_modules/@auth0/auth0-auth-js/dist/index.d.ts:1995
Optionalscope
scope ?: string
-Defined in node_modules/@auth0/auth0-auth-js/dist/index.d.ts:2003
+Defined in node_modules/@auth0/auth0-auth-js/dist/index.d.ts:1990
-Defined in node_modules/@auth0/auth0-auth-js/dist/index.d.ts:3310
+Defined in node_modules/@auth0/auth0-auth-js/dist/index.d.ts:3294
Optionaltelemetry
telemetry ?: TelemetryConfig
-Defined in node_modules/@auth0/auth0-auth-js/dist/index.d.ts:3311
+Defined in node_modules/@auth0/auth0-auth-js/dist/index.d.ts:3295
+Defined in src/use-enterprise-connect.tsx:21
login With SSO
@@ -47,7 +47,7 @@ login With SSOauthorizationParams supplied by the caller are preserved.
+Defined in src/use-enterprise-connect.tsx:30
+Defined in src/with-auth0.tsx:8
+Defined in src/with-authentication-required.tsx:92
Optionallogin Options
@@ -51,7 +51,7 @@
+Defined in src/with-authentication-required.tsx:86
Optionalon Before Authentication
onBeforeAuthentication ?: () => Promise < void >
@@ -61,7 +61,7 @@ Op
Allows executing logic before the user is redirected to the login page.
+Defined in src/with-authentication-required.tsx:71
Optionalon Redirecting
onRedirecting ?: () => Element
@@ -71,7 +71,7 @@ OptionalRender a message to show that the user is being redirected to the login.
+Defined in src/with-authentication-required.tsx:61
Optionalreturn To
returnTo ?: string | (() => string )
@@ -85,7 +85,7 @@ Optional<
Add a path for the onRedirectCallback handler to return the user to after login.
+Defined in src/with-authentication-required.tsx:51
+Defined in node_modules/@auth0/auth0-auth-js/dist/index.d.ts:3272
Error thrown when an anonymous session operation fails.
The
+andcodefield identifies the specific failure reason. Codessession_expired-andinvalid_session_tokenare handled silently by AnonymousSessionClient.getAccessToken -and will never reach the caller from that method. All other codes are surfaced directly.invalid_session_tokenare propagated by AnonymousSessionClient.getAccessToken +so the calling SDK can recover using its own stored state.