Skip to content

feat(clerk-js): Proactive session token refresh #7317

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
jacekradko wants to merge 42 commits into
base: main
Choose a base branch
from
+786 −145
Open

feat(clerk-js): Proactive session token refresh #7317

Show file tree
Hide file tree
Changes from 37 commits
Commits
Show all changes
42 commits
Select commit Hold shift + click to select a range
b5f683d
feat(clerk-js): Stale-while-revalidate session token
jacekradko Nov 26, 2025
caa97e2
wip
jacekradko Nov 27, 2025
3914ffa
Merge branch 'vincent-and-the-doctor' into feat/stale-while-revalidat…
jacekradko Dec 1, 2025
8c4092f
add hard cutoff for background refresh
jacekradko Dec 1, 2025
ed58e71
Merge branch 'vincent-and-the-doctor' into feat/stale-while-revalidat…
jacekradko Dec 2, 2025
460964c
capture tokenResolver reference before potential cache changes
jacekradko Dec 2, 2025
b3f14aa
preserver SWR semantics on concurrent getToken calls
jacekradko Dec 2, 2025
ea7b6ee
Merge branch 'vincent-and-the-doctor' into feat/stale-while-revalidat…
jacekradko Dec 2, 2025
d6dd49c
Use poller exlusively for refreshing tokens
jacekradko Dec 2, 2025
1c722cf
Merge branch 'vincent-and-the-doctor' into feat/stale-while-revalidat…
jacekradko Dec 3, 2025
b1104ce
Merge branch 'main' into feat/stale-while-revalidate-token
jacekradko Dec 8, 2025
7a92b1a
Merge branch 'main' into feat/stale-while-revalidate-token
jacekradko Dec 10, 2025
e73b5ff
Merge branch 'main' into feat/stale-while-revalidate-token
jacekradko Dec 17, 2025
441532f
Merge branch 'main' into feat/stale-while-revalidate-token
jacekradko Dec 17, 2025
9444dde
Merge main into feat/stale-while-revalidate-token
jacekradko Jan 9, 2026
c86f32e
chore: add changeset for stale-while-revalidate token
jacekradko Jan 9, 2026
a906a1f
Merge branch 'main' into feat/stale-while-revalidate-token
jacekradko Jan 9, 2026
f8460b2
Merge remote-tracking branch 'origin/main' into feat/stale-while-reva…
jacekradko Jan 12, 2026
bce3cae
feat(clerk-js): Add automatic background token refresh on SWR
jacekradko Jan 12, 2026
1da9c8f
docs(upgrade): Add Core 3 documentation for token SWR behavior
jacekradko Jan 12, 2026
11551e1
test(clerk-js): Add tests for refreshIfStale and leewayInSeconds options
jacekradko Jan 12, 2026
be63362
chore(clerk-js): Increase bundle size limit for SWR background refresh
jacekradko Jan 12, 2026
6730e62
Merge branch 'main' into feat/stale-while-revalidate-token
jacekradko Jan 13, 2026
d2cac65
feat(clerk-js): Rename leewayInSeconds to backgroundRefreshThreshold
jacekradko Jan 13, 2026
e3a9a5a
Merge branch 'main' into feat/stale-while-revalidate-token
jacekradko Jan 14, 2026
46b68ed
Merge branch 'main' into feat/stale-while-revalidate-token
jacekradko Jan 15, 2026
d5075a7
fix(clerk-js): use JWT iat for token cache timing to fix SWR threshol…
jacekradko Jan 15, 2026
ca53830
chore(clerk-js): add SWR debug logging for threshold investigation
jacekradko Jan 15, 2026
e8b375f
chore(clerk-js): enhance SWR debug logging for duplicate refresh inve…
jacekradko Jan 15, 2026
c58d1f4
chore(clerk-js): remove SWR investigation debug logging
jacekradko Jan 15, 2026
96a5b68
Merge branch 'main' into feat/stale-while-revalidate-token
jacekradko Jan 27, 2026
cb291e7
feat(clerk-js): Replace SWR with event-driven token refresh
jacekradko Jan 27, 2026
e426411
fix: remove unused variable in Session tests
jacekradko Jan 27, 2026
8c5c6e5
chore: update changeset for proactive token refresh
jacekradko Jan 27, 2026
9ce6dd3
feat(clerk-js): Make leewayInSeconds configurable for proactive refresh
jacekradko Jan 27, 2026
5d43ab3
chore: format
jacekradko Jan 27, 2026
5ed81e8
Merge branch 'main' into feat/stale-while-revalidate-token
jacekradko Jan 27, 2026
7ff27b3
Merge branch 'main' into feat/stale-while-revalidate-token
jacekradko Jan 28, 2026
d3fa022
refactor(clerk-js): Remove leewayInSeconds from public API
jacekradko Jan 28, 2026
7430053
feat(upgrade): Add codemod to remove leewayInSeconds from getToken calls
jacekradko Jan 28, 2026
5fcdef3
Merge branch 'main' into feat/stale-while-revalidate-token
jacekradko Jan 29, 2026
6c3a5bf
format
jacekradko Jan 29, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 5 additions & 0 deletions .changeset/fresh-tigers-hunt.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
---
'@clerk/clerk-js': minor
---

Add proactive session token refresh. Tokens are now automatically refreshed in the background before they expire. The `leewayInSeconds` option controls how far in advance refresh is triggered (default: 15 seconds, minimum: 5 seconds).
Loading
Loading