10.0.0 (2025-12-10)
⚠ BREAKING CHANGES
-
onError callback behavior change:
onErroris now properly called whencacheFlagsis enabled and the API is unreachable with no existing cache (#365)- Previous behavior:
init()would resolve successfully even when the API failed, silently swallowing the error - New behavior:
init()now rejects and triggersonError, matching the behavior whencacheFlags: false - Migration: Ensure your code handles errors from
init()or providedefaultFlagsas a fallback
- Previous behavior:
-
SDK User-Agent header: The SDK now sends a
Flagsmith-SDK-User-Agentheader with requests (#344)- Self-hosted users: Requires Flagsmith v2.196.0 or higher
- Alternative: If you cannot upgrade, add this environment variable to your Flagsmith server:
FLAGSMITH_CORS_EXTRA_ALLOW_HEADERS: Flagsmith-SDK-User-Agent