mirror of
https://github.com/openfrontio/OpenFrontIO.git
synced 2026-07-28 09:40:32 +00:00
6848fabce5
**Add approved & assigned issue number here:**
Resolves #(issue number)
## Description:
Users intermittently saw **"Turnstile error: 600010"** immediately on a
fresh page load. The cause was the background token prefetch in
`initialize()`: on a cold visit Cloudflare occasionally returns a
transient `600xxx` challenge failure, and `getTurnstileToken()` reacted
to the very first error by tearing down the widget, rejecting, and
firing a blocking `alert()` — which also defeated Turnstile's own retry
and interrupted a user who hadn't even asked to play. On recent loads
Turnstile has cached session state and solves instantly, so the error
only showed on first load. (The JWT refresh flow is unrelated.)
Changes (`src/client/Main.ts`, plus one `en.json` string):
1. **Auto-retry instead of hard-fail** — added `retry: "auto"` +
`retry-interval` to the widget render, and the `error-callback` now
returns `true` (signalling "handled, retry") instead of removing the
widget and rejecting on the first blip. An overall 30s timeout
(`TURNSTILE_OVERALL_TIMEOUT_MS`) is the backstop so a token request can
never hang.
2. **Silent prefetch** — the background prefetch now swallows errors and
resolves `null`, so a cold-load blip no longer interrupts a user who
hasn't asked to play.
3. **Surface errors only at join time** — when a token genuinely can't
be obtained at the moment the user joins, they get an alert routed
through `translateText("turnstile.verification_failed")`, with the
string added to `en.json`.
4. **Type fix** — `turnstileTokenPromise` is now typed to reflect that
it can resolve to `null`.
### User impact
- The spurious first-load Turnstile alert is gone; transient Cloudflare
failures recover silently via retry.
- A clear, translated error message is shown only when verification
genuinely fails at join time.
## Please complete the following:
- [x] I have added screenshots for all UI updates <!-- no visual UI
changes; only an alert message that already exists -->
- [x] I process any text displayed to the user through translateText()
and I've added it to the en.json file
- [x] I have added relevant tests to the test directory <!-- client
Turnstile path depends on the live window.turnstile widget and has no
unit harness; verified via tsc, ESLint, Prettier, and the existing
server-side turnstile tests -->
## Please put your Discord username so you can be contacted if a bug or
regression is found:
jish
---
🤖 Generated with [Claude Code](https://claude.com/claude-code)
---------
Co-authored-by: Claude <noreply@anthropic.com>