Add Utopia Query support replacing raw filter arrays

Replace all raw $filters array parameters with Utopia\Database\Query objects
across the public API (queryEvents, sumEvents, countEvents, queryGauges,
getGauge) and high-level helpers (getMetrics, getMetricsTotals, getBreakdown).

The adapter now parses Query objects for filtering (equal, notEqual, greaterThan,
lessThan, etc.), pagination (limit, offset), ordering (orderAsc, orderDesc),
and virtual attributes (period, date) via a new parseQueries() helper. The
ClickHouse adapter translates these into parameterized SQL via buildQueryFilters().

Added utopia-php/database as a dependency for the Query class. All 105 tests
pass including new tests for Query-based filtering, pagination, and date ranges.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: lohanidamodar

composer.json

@@ -17,7 +17,8 @@
     "minimum-stability": "stable",
     "require": {
         "php": ">=8.3",
-        "utopia-php/fetch": "0.5.*"
+        "utopia-php/fetch": "0.5.*",
+        "utopia-php/database": "^5.3"
     },
     "require-dev": {
         "phpunit/phpunit": "^9.5",