feat(clickhouse): implement ClickHouse client service

[koxudaxi]

TL;DR

Added ClickHouse client implementation for analytics data access with support for both Node.js and Cloudflare Workers environments.

What changed?

• Added @clickhouse/client dependency to the project
• Created a new ClickHouseClient service with two implementations:
  • ClickHouseClientNodeLive: Uses the native Node.js client for local development and API handlers
  • ClickHouseClientWorkersLive: Uses fetch API with HTTP interface for Cloudflare Workers
• Added comprehensive test coverage for both implementations
• Extended the Settings interface with ClickHouse configuration options
• Added ClickHouseError class for error handling
• Implemented environment-specific TLS validation for secure connections

How to test?

1. Run the test suite to verify both implementations:

   cd cloud
   bun test clickhouse/client.test.ts

2. For local development with ClickHouse:

   import { ClickHouseClient, ClickHouseClientNodeLive } from "@/clickhouse/client";
   
   const program = Effect.gen(function* () {
     const client = yield* ClickHouseClient;
     const results = yield* client.query("SELECT * FROM test_table LIMIT 10");
     return results;
   });
   
   await Effect.runPromise(program.pipe(Effect.provide(ClickHouseClientNodeLive)));

Why make this change?

This implementation provides a unified interface for analytics data access across different environments. The dual implementation approach solves the platform-specific constraints:

1. Node.js environment (local dev, API handlers) gets full TLS configuration support with the native client
2. Cloudflare Workers environment (Queue Consumer, Cron) gets a compatible implementation using the HTTP API

This enables consistent analytics data access while respecting the runtime constraints of each platform.

[koxudaxi]

• feat(workers): implement outbox processor for ClickHouse sync #1811 : 2 dependent PRs (#1812 , #1813 )
• feat(db): write to outbox on span insertion #1810
• feat(db): add spans_outbox table schema #1809
• feat(clickhouse): implement ClickHouse client service #1808 👈 (View in Graphite)
• feat(docker): add ClickHouse service for local development #1807 : 1 other dependent PR (#1819 )
• feat(clickhouse): add clickhouse migrations and migrate tooling #1849
• v2

This stack of pull requests is managed by Graphite. Learn more about stacking.

[cloudflare-workers-and-pages]

Deploying with    Cloudflare Workers

The latest updates on your project. Learn more about integrating Git with Workers.

Status	Name	Latest Commit	Updated (UTC)
✅ Deployment successful! View logs	v2-docs	54d36f0	Jan 09 2026, 03:37 AM

[willbakst]

Merge activity

• Jan 9, 1:29 AM UTC: A user started a stack merge that includes this pull request via Graphite.
• Jan 9, 1:29 AM UTC: Graphite couldn't merge this pull request because a downstack PR feat(clickhouse): add clickhouse migrations and migrate tooling #1849 failed to merge.
• Jan 9, 1:40 AM UTC: A user started a stack merge that includes this pull request via Graphite.
• Jan 9, 1:41 AM UTC: Graphite couldn't merge this pull request because a downstack PR feat(clickhouse): add clickhouse migrations and migrate tooling #1849 failed to merge.
• Jan 9, 3:30 AM UTC: @willbakst merged this pull request with Graphite.