docs: clarify raw client API differences and state sync behaviour

yogeshchoudhary147 · yogeshchoudhary147 · commit f9537998e0a1 · 2026-03-19T09:19:35.000+05:30
diff --git a/EXAMPLES.md b/EXAMPLES.md
@@ -137,7 +137,9 @@ export default function App() {
 }
 ```
 
-> **Note:** `getTokenSilently()` requires an active session. Ensure `Auth0Provider` has mounted and completed initialization before calling it outside React.
+> **Note:**
+> - The raw `Auth0Client` method is `getTokenSilently()`, not `getAccessTokenSilently()`. They share the same token cache but the hook version also updates React state.
+> - Calling methods on the raw client does not update React state. For token fetching this is fine since the cache is shared. Avoid calling `client.logout()` directly — use the `logout` method from `useAuth0` instead so React state stays in sync.
 
 Use the same client instance in a TanStack Start client function middleware:
 

Original file line number	Diff line number	Diff line change
`@@ -137,7 +137,9 @@ export default function App() {`
`137`	`137`	`}`
`138`	`138`	```
`139`	`139`
`140`		-> Note: `getTokenSilently()` requires an active session. Ensure `Auth0Provider` has mounted and completed initialization before calling it outside React.
	`140`	`+> Note:`
	`141`	+> - The raw `Auth0Client` method is `getTokenSilently()`, not `getAccessTokenSilently()`. They share the same token cache but the hook version also updates React state.
	`142`	+> - Calling methods on the raw client does not update React state. For token fetching this is fine since the cache is shared. Avoid calling `client.logout()` directly — use the `logout` method from `useAuth0` instead so React state stays in sync.
`141`	`143`
`142`	`144`	`Use the same client instance in a TanStack Start client function middleware:`
`143`	`145`