# What changed in @configcat/sdk

> 10 changes in @configcat/sdk 1 from its official release notes, upgrade guides and advisories: 1 breaking, 2 deprecations. Each one cited. Sources checked 2026-10-19. HTML: https://unstale.sh/npm/@configcat/sdk/

To see which of these apply to a repository, run `npx @unstale/cli init` in it.

## @configcat/sdk 1

### Breaking changes

- 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. (1.1.0) — [release notes](https://github.com/configcat/js-unified-sdk/releases/tag/v1.1.0)

### Deprecations

- The Node.js and Bun option is deprecated; use httpAgentFactory instead. (1.1.0) — [release notes](https://github.com/configcat/js-unified-sdk/releases/tag/v1.1.0)
- The Node.js and Bun option is deprecated; use httpsAgentFactory instead. (1.1.0) — [release notes](https://github.com/configcat/js-unified-sdk/releases/tag/v1.1.0)

### Behavior and default changes

- Built-in config fetchers add debug logging, and logging is enabled for these fetchers even when they are created externally. (1.1.0) — [release notes](https://github.com/configcat/js-unified-sdk/releases/tag/v1.1.0)
- Disposing a config fetcher during an in-progress fetch aborts the fetch operation, including pending HTTP requests. (1.1.0) — [release notes](https://github.com/configcat/js-unified-sdk/releases/tag/v1.1.0)
- Failed HTTP requests are retried once after an unexpected status code, timeout, or request error, which can reduce HTTP errors and timeouts. (1.1.0) — [release notes](https://github.com/configcat/js-unified-sdk/releases/tag/v1.1.0)
- For Node.js and Bun, NodeHttpConfigFetcher now creates and manages its own internal agent instances instead of using http.globalAgent and https.globalAgent. (1.1.0) — [release notes](https://github.com/configcat/js-unified-sdk/releases/tag/v1.1.0)

### Fixes and other changes

- The CF-RAY header is also logged when response headers arrive but downloading the response body times out or fails. (1.1.0) — [release notes](https://github.com/configcat/js-unified-sdk/releases/tag/v1.1.0)
- 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. (1.1.0) — [release notes](https://github.com/configcat/js-unified-sdk/releases/tag/v1.1.0)
- URL processing and manipulation now properly handle user-provided base URLs or fetch request URLs containing query strings or URI-encoded characters. (1.1.0) — [release notes](https://github.com/configcat/js-unified-sdk/releases/tag/v1.1.0)