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

.gitignore

@@ -1,2 +1,3 @@
 /vendor/
-/.idea/
+/.idea/
+/.phpunit.cache/

CHANGELOG.md

@@ -2,6 +2,32 @@
 
 All notable changes to `utopia-php/audit` are documented in this file.
 
+## Unreleased
+
+### ClickHouse adapter — migrated to the utopia-php/query 0.3 builder
+
+#### Changed
+
+- `utopia-php/query` bumped from `0.1.*` to `0.3.*` (locked at 0.3.3).
+- `setup()` builds its DDL through `Utopia\Query\Schema\ClickHouse` instead of
+  hand-assembled SQL. Column types, `LowCardinality(...)` / `Nullable(...)`
+  wrapping, bloom-filter indexes, engine, `ORDER BY`, `PARTITION BY` and
+  `SETTINGS` are all emitted by the schema builder. The retention `MODIFY TTL`
+  / `REMOVE TTL` statements are unchanged.
+- `find()`, `count()`, `getById()`, `createBatch()` and `cleanup()` build their
+  SQL through `Utopia\Query\Builder\ClickHouse`. Positional bindings are
+  rewritten to typed `{paramN:Type}` ClickHouse placeholders from a column →
+  type map derived from `getAttributes()`.
+- `createBatch()` uses `Builder\ClickHouse::bulkInsert(Format::JSONEachRow, …)`
+  to emit the `INSERT … FORMAT JSONEachRow` envelope and serialize the body.
+- `Query::getMethod()` now returns the `Utopia\Query\Method` enum (upstream
+  0.3 change). `Utopia\Audit\Query` continues to expose the legacy `TYPE_*`
+  string constants, which map to the same string values.
+
+Filter semantics are unchanged: `contains` / `notContains` remain substring
+matches (now compiled to ClickHouse `position(col, ?) > 0` / `= 0` rather than
+`LIKE '%needle%'`, which also removes the need for wildcard escaping).
+
 ## 2.9.0
 
 ### ClickHouse adapter — user-agent columns

composer.json

@@ -29,7 +29,7 @@
         "php": ">=8.5",
         "utopia-php/database": "^6.0.0",
         "utopia-php/fetch": "^1.1",
-        "utopia-php/query": "0.1.*",
+        "utopia-php/query": "0.3.*",
         "utopia-php/validators": "0.3.*"
     },
     "config": {