# What changed in @clickhouse/client

> 15 changes in @clickhouse/client 1 from its official release notes, upgrade guides and advisories: 6 new APIs and options. Each one cited. Sources checked 2026-10-18. HTML: https://unstale.sh/npm/@clickhouse/client/

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

## @clickhouse/client 1

### New APIs and options

- This type is now exported from the package root and can be imported from @clickhouse/client. (1.24.0) — [release notes](https://github.com/ClickHouse/clickhouse-js/releases/tag/client-1.24.0)
- This client option defaults to false; when enabled, raw SQL is attached to spans and included in error-level logs for failed requests. Bound query_params values and credentials are never logged or traced. (1.24.0) — [release notes](https://github.com/ClickHouse/clickhouse-js/releases/tag/client-1.24.0)
- This type is now exported from the package root and can be imported from @clickhouse/client. (1.24.0) — [release notes](https://github.com/ClickHouse/clickhouse-js/releases/tag/client-1.24.0)
- This type is now exported from the package root and can be imported from @clickhouse/client. (1.24.0) — [release notes](https://github.com/ClickHouse/clickhouse-js/releases/tag/client-1.24.0)
- This type is now exported from the package root and can be imported from @clickhouse/client. (1.24.0) — [release notes](https://github.com/ClickHouse/clickhouse-js/releases/tag/client-1.24.0)
- A per-request query parameter field lets callers add application-level context to operation spans; caller attributes cannot override the client's db.*, server.*, or clickhouse.* attributes. (1.24.0) — [release notes](https://github.com/ClickHouse/clickhouse-js/releases/tag/client-1.24.0)

### Behavior and default changes

- The X-ClickHouse-Summary counters are now attached to the clickhouse.query span, making request-level metrics visible on the outer client span. (1.24.0) — [release notes](https://github.com/ClickHouse/clickhouse-js/releases/tag/client-1.24.0)
- Every key in the summary header is recorded as a span attribute, including memory_usage and future server-side additions. (1.24.0) — [release notes](https://github.com/ClickHouse/clickhouse-js/releases/tag/client-1.24.0)
- This span attribute is now recorded for non-streaming result consumption, including json() on single-document JSON formats. (1.24.0) — [release notes](https://github.com/ClickHouse/clickhouse-js/releases/tag/client-1.24.0)

### Fixes and other changes

- On Node.js, prevents an orphaned idle-socket timer from destroying a socket during a request that took it over after another queued request was aborted. (1.24.1) — [release notes](https://github.com/ClickHouse/clickhouse-js/releases/tag/client-1.24.1)
- Date values nested in arrays, tuples, and maps are now emitted as quoted UTC date strings; nested Array(DateTime) and Array(DateTime64) bindings use day precision, while scalar binding is unchanged. (1.24.0) — [release notes](https://github.com/ClickHouse/clickhouse-js/releases/tag/client-1.24.0)
- This type is now exported from the package root and can be imported from @clickhouse/client. (1.24.0) — [release notes](https://github.com/ClickHouse/clickhouse-js/releases/tag/client-1.24.0)
- This type is now exported from the package root and can be imported from @clickhouse/client. (1.24.0) — [release notes](https://github.com/ClickHouse/clickhouse-js/releases/tag/client-1.24.0)
- Re-exported from @clickhouse/client after being missed when the client-common public API was bundled into the client packages. (1.23.1) — [release notes](https://github.com/ClickHouse/clickhouse-js/releases/tag/client-1.23.1)
- Re-exported from @clickhouse/client after being missed when the client-common public API was bundled into the client packages. (1.23.1) — [release notes](https://github.com/ClickHouse/clickhouse-js/releases/tag/client-1.23.1)