npm / @configcat/sdk
@configcat/sdk
What changed in @configcat/sdk 1, from its official release notes, upgrade guides and advisories. Sources checked 2026-10-19.
1 breaking2 deprecations4 behavior and defaults3 fixes and other
See which of these apply to your code, ranked, in your agent:
npx @unstale/cli init@configcat/sdk 110 changes
Breaking changes 1
FetchRequest.url no longer includes query string parameters and contains only the path to the config JSON file; the SDK identifier string can be read from the User-Agent header.
Deprecations 2
The Node.js and Bun option is deprecated; use httpAgentFactory instead.
The Node.js and Bun option is deprecated; use httpsAgentFactory instead.
Behavior and default changes 4
Built-in config fetchers add debug logging, and logging is enabled for these fetchers even when they are created externally.
Disposing a config fetcher during an in-progress fetch aborts the fetch operation, including pending HTTP requests.
Failed HTTP requests are retried once after an unexpected status code, timeout, or request error, which can reduce HTTP errors and timeouts.
For Node.js and Bun, NodeHttpConfigFetcher now creates and manages its own internal agent instances instead of using http.globalAgent and https.globalAgent.
Fixes and other changes 3
The CF-RAY header is also logged when response headers arrive but downloading the response body times out or fails.
Fixes a bug that could crash some runtimes, including Node.js or Deno, when an error was left unhandled during cache sync or config refresh.
URL processing and manipulation now properly handle user-provided base URLs or fetch request URLs containing query strings or URI-encoded characters.