From 3ccd81c42d5bb86899747c00c8eaac494fc42a87 Mon Sep 17 00:00:00 2001 From: Aigiz Saitgalin Date: Fri, 14 Aug 2026 10:05:43 +0500 Subject: [PATCH 1/2] fix(types): re-export public API types dropped in 1.23.0 Ten types that the clients use in their own public signatures are missing from the root of @clickhouse/client and @clickhouse/client-web since the common sources were bundled into the client packages. All of them were exported from @clickhouse/client-common, which is now deprecated, so there is no supported place left to import them from. Type-only re-exports: the emitted JavaScript is unchanged. --- packages/client-node/src/index.ts | 10 ++++++++++ packages/client-web/src/index.ts | 10 ++++++++++ 2 files changed, 20 insertions(+) diff --git a/packages/client-node/src/index.ts b/packages/client-node/src/index.ts index 9d393827..67e70a26 100644 --- a/packages/client-node/src/index.ts +++ b/packages/client-node/src/index.ts @@ -12,6 +12,7 @@ export { type BaseClickHouseClientConfigOptions, type BaseQueryParams, type QueryParams, + type QueryParamsWithFormat, type ExecParams, type InsertParams, type InsertValues, @@ -37,8 +38,17 @@ export { type InputJSON, type InputJSONObjectEachRow, type BaseResultSet, + type ResultJSONType, + type RowJSONType, + type ResultStream, type PingResult, + type PingParams, + type PingParamsWithEndpoint, + type PingParamsWithSelectQuery, type ResponseHeaders, + type ClickHouseSummary, + type WithClickHouseSummary, + type WithResponseHeaders, type SimpleColumnType, type ParsedColumnSimple, type ParsedColumnEnum, diff --git a/packages/client-web/src/index.ts b/packages/client-web/src/index.ts index d0030758..a92e4ee9 100644 --- a/packages/client-web/src/index.ts +++ b/packages/client-web/src/index.ts @@ -11,6 +11,7 @@ export { type BaseClickHouseClientConfigOptions, type BaseQueryParams, type QueryParams, + type QueryParamsWithFormat, type ExecParams, type InsertParams, type InsertValues, @@ -36,8 +37,17 @@ export { type InputJSON, type InputJSONObjectEachRow, type BaseResultSet, + type ResultJSONType, + type RowJSONType, + type ResultStream, type PingResult, + type PingParams, + type PingParamsWithEndpoint, + type PingParamsWithSelectQuery, type ResponseHeaders, + type ClickHouseSummary, + type WithClickHouseSummary, + type WithResponseHeaders, type SimpleColumnType, type ParsedColumnSimple, type ParsedColumnEnum, From 9fe0c3092854c973d0ced2d0cb01309e61c0ca22 Mon Sep 17 00:00:00 2001 From: Aigiz Saitgalin Date: Tue, 18 Aug 2026 07:35:10 +0500 Subject: [PATCH 2/2] docs(changelog): add entries for the restored public type exports Addresses the Copilot review comments on #998: the re-exports change the public API surface of both clients, so both CHANGELOGs get a matching entry under the unreleased 1.24.0 "Bug fixes" section. --- packages/client-node/CHANGELOG.md | 4 ++++ packages/client-web/CHANGELOG.md | 4 ++++ 2 files changed, 8 insertions(+) diff --git a/packages/client-node/CHANGELOG.md b/packages/client-node/CHANGELOG.md index 435f9b73..5239cbd8 100644 --- a/packages/client-node/CHANGELOG.md +++ b/packages/client-node/CHANGELOG.md @@ -16,7 +16,11 @@ - Fixed `Array(Date)` / `Array(Date32)` query-parameter binding (and other temporal element types nested in arrays, tuples, and maps). A JS `Date` inside a container was serialized as a bare Unix timestamp (e.g. `[1683244800]`), which the server's `Array(Date)` element parser rejects (`CANNOT_PARSE_INPUT_ASSERTION_FAILED`). Container-nested `Date` values are now emitted as a quoted UTC date string (e.g. `['2023-05-05']`), the one encoding every temporal element type accepts. Note: a `Date` used inside `Array(DateTime)` / `Array(DateTime64)` is now bound at day precision (the time-of-day is dropped), since date-only is the only form `Array(Date)` accepts; scalar `Date` / `DateTime` binding is unchanged. ([#947]) +- Re-export ten types from `@clickhouse/client`. All of them are used in the client's own public signatures and were part of the (now deprecated) `@clickhouse/client-common` public API, but were missed when its surface was bundled into and re-exported from the client packages in 1.23.0 ([#845]): `QueryParamsWithFormat` (the `query()` parameter), `PingParams` / `PingParamsWithEndpoint` / `PingParamsWithSelectQuery` (the `ping()` parameter and both members of the union), `ResultJSONType` and `RowJSONType` (returned by `ResultSet.json()` and `Row.json()`), `ResultStream` (returned by `ResultSet.stream()`), and `ClickHouseSummary` / `WithClickHouseSummary` / `WithResponseHeaders` (parts of `InsertResult`, `CommandResult`, and `ExecResult`). ([#997], [#998]) + [#947]: https://github.com/ClickHouse/clickhouse-js/pull/947 +[#997]: https://github.com/ClickHouse/clickhouse-js/issues/997 +[#998]: https://github.com/ClickHouse/clickhouse-js/pull/998 # 1.23.1 diff --git a/packages/client-web/CHANGELOG.md b/packages/client-web/CHANGELOG.md index 12fb839c..2c41987e 100644 --- a/packages/client-web/CHANGELOG.md +++ b/packages/client-web/CHANGELOG.md @@ -16,7 +16,11 @@ - Fixed `Array(Date)` / `Array(Date32)` query-parameter binding (and other temporal element types nested in arrays, tuples, and maps). A JS `Date` inside a container was serialized as a bare Unix timestamp (e.g. `[1683244800]`), which the server's `Array(Date)` element parser rejects (`CANNOT_PARSE_INPUT_ASSERTION_FAILED`). Container-nested `Date` values are now emitted as a quoted UTC date string (e.g. `['2023-05-05']`), the one encoding every temporal element type accepts. Note: a `Date` used inside `Array(DateTime)` / `Array(DateTime64)` is now bound at day precision (the time-of-day is dropped), since date-only is the only form `Array(Date)` accepts; scalar `Date` / `DateTime` binding is unchanged. ([#947]) +- Re-export ten types from `@clickhouse/client-web`. All of them are used in the client's own public signatures and were part of the (now deprecated) `@clickhouse/client-common` public API, but were missed when its surface was bundled into and re-exported from the client packages in 1.23.0 ([#845]): `QueryParamsWithFormat` (the `query()` parameter), `PingParams` / `PingParamsWithEndpoint` / `PingParamsWithSelectQuery` (the `ping()` parameter and both members of the union), `ResultJSONType` and `RowJSONType` (returned by `ResultSet.json()` and `Row.json()`), `ResultStream` (returned by `ResultSet.stream()`), and `ClickHouseSummary` / `WithClickHouseSummary` / `WithResponseHeaders` (parts of `InsertResult`, `CommandResult`, and `ExecResult`). ([#997], [#998]) + [#947]: https://github.com/ClickHouse/clickhouse-js/pull/947 +[#997]: https://github.com/ClickHouse/clickhouse-js/issues/997 +[#998]: https://github.com/ClickHouse/clickhouse-js/pull/998 # 1.23.1