refactor(clickhouse): extract formatDateTime64 to shared utils

[koxudaxi]

TL;DR

Improved ClickHouse integration with better date formatting and search functionality.

What changed?

• Extracted date formatting logic into a dedicated utility module (clickhouse/utils.ts) with tests
• Changed span name search from hasToken to position to properly support underscores in search queries
• Updated the web handler to use the Workers-compatible ClickHouse client for Cloudflare environments
• Fixed timestamp formatting in outbox processor to use the proper ClickHouse DateTime64 format
• Updated ESM module detection in the ClickHouse sync local script

How to test?

1. Verify search functionality works correctly with underscores in span names
2. Test the application in Cloudflare dev environment to ensure ClickHouse client works properly
3. Run the test suite to verify date formatting functions work as expected
4. Check that the outbox processor correctly formats timestamps for ClickHouse

Why make this change?

• The previous search implementation using hasToken treated underscores as separators, breaking searches for span names containing underscores
• Date formatting was inconsistent across the codebase, leading to potential compatibility issues with ClickHouse
• The application needed proper Cloudflare Workers support for the ClickHouse client
• Centralizing date formatting logic improves maintainability and ensures consistent behavior

[koxudaxi]

Warning

This pull request is not mergeable via GitHub because a downstack PR is open. Once all requirements are satisfied, merge this PR as a stack on Graphite.
Learn more

• refactor(clickhouse): extract formatDateTime64 to shared utils #1817 👈 (View in Graphite)
• test(python): add E2E ClickHouse verification script #1818
• feat(api): add search API schema and handlers #1816
• chore(test): hard delete api test users #1850
• feat(clickhouse): implement ClickHouseSearchService #1815
• feat(workers): implement Cron Trigger for outbox re-enqueue #1813 : 1 other dependent PR (#1814 )
• feat(workers): implement outbox processor for ClickHouse sync #1811 : 1 other dependent PR (#1812 )
• feat(db): write to outbox on span insertion #1810
• feat(db): add spans_outbox table schema #1809
• feat(clickhouse): implement ClickHouse client service #1808
• 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	bbb5d6a	Jan 08 2026, 02:47 PM