refactor: fix namespace/sharedTables at construction, thread tenant explicitly

Namespace and shared-tables mode are deployment-fixed, yet were mutable
setters on the adapter — and each setter flushed the buffer. Tenant was
likewise adapter state, so writing one project's metrics required a
setTenant()+flush() per message (one ClickHouse round-trip each).

- ClickHouse adapter takes namespace + sharedTables as constructor args;
  setNamespace/setSharedTables/setTenant setters and their getters removed,
  along with all adapter tenant state.
- collect() gains an optional per-row $tenant, stored on the buffer entry
  and folded into the dedup key, so one buffer holds many tenants and
  flushes without per-tenant round-trips.
- Read/purge methods take an explicit ?string $tenant, applied as a normal
  query filter (parseQueries already supports the 'tenant' attribute) — no
  hidden adapter state. Base Adapter + Database adapter signatures updated
  to match; Database honours it via its existing setTenant.

PHPStan max clean. Test migration to the new signatures follows in the
next commit.

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

Author: loks0n

src/Usage/Adapter.php

@@ -47,9 +47,10 @@ abstract public function addBatch(array $metrics, string $type, int $batchSize =
      * @param  array<\Utopia\Query\Query>  $queries  Additional query filters
      * @param  bool  $zeroFill  Whether to fill gaps with zero values
      * @param  string|null  $type  Metric type: 'event', 'gauge', or null (query both)
+     * @param  string|null  $tenant  Tenant to scope the query to (shared-tables mode)
      * @return array<string, array{total: float, data: array<array{value: float, date: string}>}>
      */
-    abstract public function getTimeSeries(array $metrics, string $interval, string $startDate, string $endDate, array $queries = [], bool $zeroFill = true, ?string $type = null): array;
+    abstract public function getTimeSeries(array $metrics, string $interval, string $startDate, string $endDate, array $queries = [], bool $zeroFill = true, ?string $type = null, ?string $tenant = null): array;
 
     /**
      * Get total value for a single metric.
@@ -60,9 +61,8 @@ abstract public function getTimeSeries(array $metrics, string $interval, string
      * @param  string  $metric  Metric name
      * @param  array<\Utopia\Query\Query>  $queries  Additional query filters
      * @param  string|null  $type  Metric type: 'event', 'gauge', or null (query both)
-     * @return int
      */
-    abstract public function getTotal(string $metric, array $queries = [], ?string $type = null): int;
+    abstract public function getTotal(string $metric, array $queries = [], ?string $type = null, ?string $tenant = null): int;
 
     /**
      * Get totals for multiple metrics in a single query.
@@ -74,25 +74,25 @@ abstract public function getTotal(string $metric, array $queries = [], ?string $
      * @param  string|null  $type  Metric type: 'event', 'gauge', or null (query both)
      * @return array<string, int>
      */
-    abstract public function getTotalBatch(array $metrics, array $queries = [], ?string $type = null): array;
+    abstract public function getTotalBatch(array $metrics, array $queries = [], ?string $type = null, ?string $tenant = null): array;
 
     /**
      * Purge usage metrics matching the given queries.
      * When no queries are provided, all metrics are deleted.
      *
-     * @param array<\Utopia\Query\Query> $queries
-     * @param string|null $type Metric type: 'event', 'gauge', or null (purge both)
+     * @param  array<\Utopia\Query\Query>  $queries
+     * @param  string|null  $type  Metric type: 'event', 'gauge', or null (purge both)
      */
-    abstract public function purge(array $queries = [], ?string $type = null): bool;
+    abstract public function purge(array $queries = [], ?string $type = null, ?string $tenant = null): bool;
 
     /**
      * Find metrics using Query objects.
      *
-     * @param array<\Utopia\Query\Query> $queries
-     * @param string|null $type Metric type: 'event', 'gauge', or null (query both)
+     * @param  array<\Utopia\Query\Query>  $queries
+     * @param  string|null  $type  Metric type: 'event', 'gauge', or null (query both)
      * @return array<Metric>
      */
-    abstract public function find(array $queries = [], ?string $type = null): array;
+    abstract public function find(array $queries = [], ?string $type = null, ?string $tenant = null): array;
 
     /**
      * Count metrics using Query objects.
@@ -102,25 +102,23 @@ abstract public function find(array $queries = [], ?string $type = null): array;
      * This keeps large counts cheap for endpoints that only need a capped
      * total. When $max is null the count is unbounded.
      *
-     * @param array<\Utopia\Query\Query> $queries
-     * @param string|null $type Metric type: 'event', 'gauge', or null (count both)
-     * @param int|null $max Optional upper bound for the count (inclusive)
-     * @return int
+     * @param  array<\Utopia\Query\Query>  $queries
+     * @param  string|null  $type  Metric type: 'event', 'gauge', or null (count both)
+     * @param  int|null  $max  Optional upper bound for the count (inclusive)
      */
-    abstract public function count(array $queries = [], ?string $type = null, ?int $max = null): int;
+    abstract public function count(array $queries = [], ?string $type = null, ?int $max = null, ?string $tenant = null): int;
 
     /**
      * Sum metric values using Query objects.
      *
      * Events-only by default because summing gauges is semantically meaningless
      * (adding point-in-time snapshots doesn't produce a useful total).
      *
-     * @param array<\Utopia\Query\Query> $queries
-     * @param string $attribute Attribute to sum (default: 'value')
-     * @param string $type Metric type: 'event' or 'gauge'
-     * @return int
+     * @param  array<\Utopia\Query\Query>  $queries
+     * @param  string  $attribute  Attribute to sum (default: 'value')
+     * @param  string  $type  Metric type: 'event' or 'gauge'
      */
-    abstract public function sum(array $queries = [], string $attribute = 'value', string $type = Usage::TYPE_EVENT): int;
+    abstract public function sum(array $queries = [], string $attribute = 'value', string $type = Usage::TYPE_EVENT, ?string $tenant = null): int;
 
     /**
      * Find event metrics from the pre-aggregated daily table.
@@ -130,34 +128,33 @@ abstract public function sum(array $queries = [], string $attribute = 'value', s
      * Note: Daily MV only stores event metrics. This method always queries
      * the daily events table — gauges are never pre-aggregated.
      *
-     * @param array<\Utopia\Query\Query> $queries  Filters (metric, time range, resource, etc.)
+     * @param  array<\Utopia\Query\Query>  $queries  Filters (metric, time range, resource, etc.)
      * @return array<Metric>
      */
-    abstract public function findDaily(array $queries = []): array;
+    abstract public function findDaily(array $queries = [], ?string $tenant = null): array;
 
     /**
      * Sum event metric values from the pre-aggregated daily table.
      *
      * Note: Daily MV only stores event metrics. This method always queries
      * the daily events table — gauges are never pre-aggregated.
      *
-     * @param array<\Utopia\Query\Query> $queries
-     * @param string $attribute Attribute to sum (default: 'value')
-     * @return int
+     * @param  array<\Utopia\Query\Query>  $queries
+     * @param  string  $attribute  Attribute to sum (default: 'value')
      */
-    abstract public function sumDaily(array $queries = [], string $attribute = 'value'): int;
+    abstract public function sumDaily(array $queries = [], string $attribute = 'value', ?string $tenant = null): int;
 
     /**
      * Sum multiple event metrics from the pre-aggregated daily table in one query.
      *
      * Note: Daily MV only stores event metrics. This method always queries
      * the daily events table — gauges are never pre-aggregated.
      *
-     * @param array<string> $metrics List of metric names
-     * @param array<\Utopia\Query\Query> $queries Additional filters (e.g. date range)
+     * @param  array<string>  $metrics  List of metric names
+     * @param  array<\Utopia\Query\Query>  $queries  Additional filters (e.g. date range)
      * @return array<string, int> Metric name => sum value
      */
-    abstract public function sumDailyBatch(array $metrics, array $queries = []): array;
+    abstract public function sumDailyBatch(array $metrics, array $queries = [], ?string $tenant = null): array;
 
     /**
      * Enable parity sampling for routed reads. At rate=0 the sampler is