1.23.1 beta1

[peter-leonov-ch]

Summary

A short description of the changes with a link to an open issue.

Checklist

Delete items not relevant to your PR:

• Unit and integration tests covering the common scenarios were added
• A human-readable changelog entry was added to every affected package's CHANGELOG.md (e.g. packages/client-node/CHANGELOG.md; a shared/common change updates both client packages — client-node and client-web; the root CHANGELOG.md is frozen)
• For significant changes, documentation in https://github.com/ClickHouse/clickhouse-docs was updated with further explanations or tutorials

[CLAassistant]

Thank you for your submission! We really appreciate it. Like many open source projects, we ask that you all sign our Contributor License Agreement before we can accept your contribution.
1 out of 2 committers have signed the CLA.

✅ peter-leonov-ch
❌ Copilot
_{You have signed the CLA already but the status is still pending? Let us recheck it.}

[github-advanced-security]

You are seeing this message because GitHub Code Scanning has recently been set up for this repository, or this pull request contains the workflow file for the Code Scanning tool.

What Enabling Code Scanning Means:

• The 'Security' tab will display more code scanning analysis results (e.g., for the default branch).
• Depending on your configuration and choice of analysis tool, future pull requests will be annotated with code scanning analysis results.
• You will be able to see the analysis results for the pull request's branch on this overview once the scans have completed and the checks have passed.

For more information about GitHub Code Scanning, check out the documentation.

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.

📢 Thoughts on this report? Let us know!

[Copilot]

Pull request overview

Prepares the 1.23.1 release line by restoring a couple of missed public re-exports from the deprecated @clickhouse/client-common surface, and by restructuring the Vitest setup so common specs run via the Node/Web client packages (with updated CI/scripts/docs).

Changes:

• Re-export EXCEPTION_TAG_HEADER_NAME and extractErrorAtTheEndOfChunk from both @clickhouse/client and @clickhouse/client-web.
• Move/standardize Vitest configuration and setup into packages/client-node and packages/client-web, and update root scripts + GitHub workflows accordingly.
• Add/adjust package-level READMEs and packaging (prepack) behavior; update Codecov flag expectations; add an on-demand RowBinary benchmark workflow.

Reviewed changes

Copilot reviewed 24 out of 29 changed files in this pull request and generated no comments.

Show a summary per file

File	Description
packages/client-web/vitest.setup.ts	Adds web Vitest setup glue (global client factory + env bridging for shared specs).
packages/client-web/vitest.otel.js	Adds a browser OTEL SDK initializer (currently not enabled in config).
packages/client-web/vitest.config.ts	Embeds web Vitest config; includes common tests; updates OTEL paths; defaults to headless.
packages/client-web/src/index.ts	Re-exports the missed common symbols from the web client entrypoint.
packages/client-web/README.md	Adds a package README for @clickhouse/client-web.
packages/client-web/package.json	Adds package-local test scripts and adjusts prepack.
packages/client-web/eslint.config.mjs	Updates ESLint ignores for the new Vitest files.
packages/client-web/CHANGELOG.md	Adds 1.23.1 changelog entry describing the re-export fix.
packages/client-node/vitest.setup.ts	Adds node Vitest setup glue (global client factory).
packages/client-node/vitest.otel.js	Adds node OTEL SDK initializer for Vitest.
packages/client-node/vitest.config.ts	Embeds node Vitest config; runs common tests under node modes; pins cwd to repo root.
packages/client-node/src/index.ts	Re-exports the missed common symbols from the node client entrypoint.
packages/client-node/README.md	Adds a package README for @clickhouse/client (node).
packages/client-node/package.json	Adds package-local test scripts and adjusts prepack.
packages/client-node/eslint.config.mjs	Updates ESLint ignores for the new Vitest files.
packages/client-node/CHANGELOG.md	Adds 1.23.1 changelog entry describing the re-export fix.
packages/client-common/README.md	Adds a deprecation README for @clickhouse/client-common.
packages/client-common/package.json	Adjusts prepack to stop copying root README.
package.json	Repoints root test scripts to package-local scripts.
CONTRIBUTING.md	Updates contributor docs for the new Vitest config locations and commands.
codecov.yml	Updates expected upload counts/flags after removing separate “common unit” jobs.
.gitignore	Stops ignoring packages/*/README.md now that package READMEs are committed.
.github/workflows/tests-web.yml	Updates watched paths and removes the separate web common-unit job.
.github/workflows/tests-oss-dependents.yml	Updates watched paths for new Vitest config locations.
.github/workflows/tests-node.yml	Updates watched paths and removes the separate node common-unit job.
.github/workflows/tests-dist.yml	Updates watched paths for new Vitest config locations.
.github/workflows/tests-bun.yml	Updates watched paths and removes the separate bun common-unit job.
.github/workflows/examples.yml	Updates watched paths for new Vitest config locations.
.github/workflows/bench-skill-rowbinary.yml	Adds an on-demand benchmark workflow for the RowBinary skill.

Comments suppressed due to low confidence (2)

packages/client-web/vitest.config.ts:173

• Using a string base like `file://${root}/` to construct URLs is not portable (e.g. Windows paths contain : and backslashes, which produce invalid file:// URLs). Since import.meta.url is already a file URL, build these paths relative to new URL('../..', import.meta.url) instead.
  packages/client-web/vitest.config.ts:129
• Browser OTEL is intentionally disabled here (browserSdkPath is commented out), but test.env above still forwards OTEL_EXPORTER_OTLP_HEADERS into the browser runner via import.meta.env. Since this value typically contains an auth header/API key, consider not injecting it into browser-side test code unless browser OTEL is actually enabled.