Releases: auth0/auth0-tanstack-start-react
Releases · auth0/auth0-tanstack-start-react
Release list
v1.0.0-beta.2
Release v1.0.0-beta.2 (#40)
v1.0.0-beta.1
- Forwarded proxy headers are no longer trusted by default.
X-Forwarded-HostandX-Forwarded-Protoare now read only when you settrustProxy: trueonauth0Server()(orAUTH0_TRUST_PROXY=true); the default isfalse. If your app uses adomainresolver (Multiple Custom Domains) or anappBaseUrlallow-list and runs behind a reverse proxy or load balancer that terminates TLS, settrustProxy: trueso login keeps working. Apps that pass a single staticappBaseUrlstring are not affected and need no change. #29 resolveAppBaseUrl()now takes the resolved config object as its first argument, not theappBaseUrlvalue. If you call this exported helper directly, changeresolveAppBaseUrl(config.appBaseUrl, request)toresolveAppBaseUrl(auth0.config, request). The old call shape now throws a clear configuration error. #29- Removed
display_namefrom theOrganizationtype. The field was never populated by default, since it is not in the ID token unless an Action adds it, so the type now matches what you actually receive. If you readorganization.display_name, remove that access or add the claim through an Action and read it from the claims. #30 - Removed
appStatefromLoginOptions. The field was never delivered: the login handler always setsappStateto{ returnTo }itself. If you setappStateon a login call, drop it and usereturnToto control where the user lands after login. #31
Fixed
- fix: forward authorizationParams on login redirects; reserve OIDC Req… #31 (@nandan-bhat)
- fix: remove unpopulated
display_namefromOrganization#30 (@nandan-bhat) - fix: derive the callback redirect_uri from appBaseUr #29 (@nandan-bhat)
v1.0.0-beta.0
The first release of @auth0/auth0-tanstack-start-react, the Auth0 Authentication SDK for [TanStack Start (https://tanstack.com/start) (React) server-rendered Regular Web Applications. It is built on [@auth0/auth0-server-js (https://github.com/auth0/auth0-auth-js) and exposes a tree-shakeable, client/server-split API.
Added
- Server-side login, callback, and logout backed by an encrypted JWE session cookie, served automatically by
auth0Middleware(). auth0Server()factory plus server helpers:getSession,getAccessToken,getTokenSet, andcreateFetcher. Tokens stay on the server and never reach the browser.- Router integration:
auth0BeforeLoad()and<Auth0Provider>wire the server-resolved auth state into the router with no client-side loading flash. - Route protection:
requireAuthandrequireOrgroute guards, and the server-function middlewarerequireAuthMiddleware,withApiAuth,withApiScopes,withApiOrg,withApiClaimEquals, andwithApiClaimIncludes. - React hooks and components:
useAuth0,useUser,useOrg,useLogin,useLogout,useMfa, and<SignedIn>,<SignedOut>,<HasOrg>,<AuthReady>,<AuthLoading>. - Enterprise features: multi-factor authentication (step-up), Organizations (switch and invitation flows), account linking, CIBA back channel authentication, custom token exchange, Token Vault, and passkeys (WebAuthn).
- Multiple Custom Domains: pass a resolver to
domainto serve several custom domains that front the same tenant, withappBaseUrlinferred per request. - Configuration:
sessionConfigurationfor the session cookie and its lifetime, asessionStoreto switch from stateless to stateful sessions,secretas a string or an array for zero-downtime key rotation, andexcludedClaimsto keep internal OIDC claims out of the SSR HTML. - Testing utilities under
/testing: a mock router context (createMockAuth0Context), a test provider (Auth0TestProvider), and a mock Auth0 client (createMockAuth0Client). - Example apps under
examples/:basic-oidc(standard OIDC login) andpasskeys(WebAuthn register and login).