feat: migrate ClickHouse adapter to utopia-php/query 0.3.x builder

CHANGELOG.md

@@ -1,9 +1,24 @@
 # Changelog
 
-## Unreleased — resourceType rename + queued time + ip dim + gauge fill
+## Unreleased — resourceType rename + queued time + ip dim + gauge fill + query 0.3.x builder
 
 ### Breaking
 
+- Bumped `utopia-php/query` from `0.1.*` to `0.3.*`.
+  `Query::getMethod()` now returns the `Utopia\Query\Method` enum
+  instead of a string, and the `Query::TYPE_*` /
+  `UsageQuery::TYPE_GROUP_BY_INTERVAL` / `UsageQuery::TYPE_GROUP_BY`
+  string constants are gone. Compare against `Method::GroupByTimeBucket`
+  and `Method::GroupBy` instead; the `UsageQuery::groupByInterval()`
+  and `UsageQuery::groupBy()` factories are unchanged (`groupBy()` also
+  accepts an array of columns now, matching the base class).
+- The ClickHouse adapter compiles its SQL through the utopia-php/query
+  ClickHouse builder and schema layer (typed named bindings, schema-level
+  CREATE TABLE / materialized view). Emitted DDL and query semantics are
+  unchanged; projections, dim-column backfills and the daily
+  materialized-view body stay raw SQL because the schema layer cannot
+  express them yet.
+
 - Renamed the `resource` dimension to `resourceType` across the
   events, gauges, and events-daily tables. All Metric column
   constants, schema definitions, indexes, projections

composer.json

@@ -22,7 +22,7 @@
         "psr/http-client": "^1.0",
         "utopia-php/client": "^0.1|^0.2",
         "utopia-php/database": "^6.0.0",
-        "utopia-php/query": "0.1.*"
+        "utopia-php/query": "0.3.*"
     },
     "require-dev": {
         "phpunit/phpunit": "^9.5",