hydrousdb 1.1.0

package/dist/analytics/index.d.mts

@@ -0,0 +1,178 @@
+import { a9 as HttpClient, c as AnalyticsQuery, V as RequestOptions, e as AnalyticsResponse, D as DateRange, C as CountResult, p as DistributionItem, a1 as SumResult, a2 as TimeSeriesPoint, r as FieldTimeSeriesPoint, a3 as TopNItem, F as FieldStatsResult, s as Filter, u as FilteredRecordsResult, M as MultiMetricItem, a0 as StorageStatsResult } from '../http-CIXLF5GV.mjs';
+export { d as AnalyticsQueryType } from '../http-CIXLF5GV.mjs';
+
+type AnalyticsResult<T> = Omit<AnalyticsResponse, 'data'> & {
+    data: T;
+    queryType: string;
+    bucketKey: string | null;
+    projectId: string;
+};
+declare class AnalyticsClient {
+    private readonly http;
+    constructor(http: HttpClient);
+    private get path();
+    /**
+     * Run any analytics query with full control over the payload.
+     * Prefer the typed convenience methods below for everyday use.
+     */
+    query<T = unknown>(payload: AnalyticsQuery, opts?: RequestOptions): Promise<AnalyticsResult<T>>;
+    /**
+     * Total record count, optionally scoped to a date range.
+     * Server `queryType`: **"count"**
+     *
+     * @example
+     * const { data } = await db.analytics.count();
+     * console.log(data.count); // 1234
+     *
+     * // With date range
+     * const { data } = await db.analytics.count({
+     *   dateRange: { startDate: '2025-01-01', endDate: '2025-12-31' }
+     * });
+     */
+    count(options?: {
+        dateRange?: DateRange;
+    } & RequestOptions): Promise<AnalyticsResult<CountResult>>;
+    /**
+     * Value distribution (histogram) for a field.
+     * Server `queryType`: **"distribution"**
+     *
+     * @example
+     * const { data } = await db.analytics.distribution('status');
+     * // [{ value: 'active', count: 80 }, { value: 'archived', count: 20 }]
+     */
+    distribution(field: string, options?: {
+        limit?: number;
+        order?: 'asc' | 'desc';
+        dateRange?: DateRange;
+    } & RequestOptions): Promise<AnalyticsResult<DistributionItem[]>>;
+    /**
+     * Sum a numeric field, with optional group-by.
+     * Server `queryType`: **"sum"**
+     *
+     * @example
+     * const { data } = await db.analytics.sum('revenue', { groupBy: 'region' });
+     */
+    sum(field: string, options?: {
+        groupBy?: string;
+        limit?: number;
+        dateRange?: DateRange;
+    } & RequestOptions): Promise<AnalyticsResult<SumResult>>;
+    /**
+     * Record count grouped over time.
+     * Server `queryType`: **"timeSeries"**
+     *
+     * @example
+     * const { data } = await db.analytics.timeSeries({ granularity: 'day' });
+     * // [{ date: '2025-01-01', count: 42 }, ...]
+     */
+    timeSeries(options?: {
+        granularity?: 'hour' | 'day' | 'week' | 'month';
+        dateRange?: DateRange;
+    } & RequestOptions): Promise<AnalyticsResult<TimeSeriesPoint[]>>;
+    /**
+     * Aggregate a numeric field over time.
+     * Server `queryType`: **"fieldTimeSeries"**
+     *
+     * @example
+     * const { data } = await db.analytics.fieldTimeSeries('revenue', {
+     *   granularity: 'month',
+     *   aggregation: 'sum',
+     * });
+     */
+    fieldTimeSeries(field: string, options?: {
+        aggregation?: 'sum' | 'avg' | 'min' | 'max' | 'count';
+        granularity?: 'hour' | 'day' | 'week' | 'month';
+        dateRange?: DateRange;
+    } & RequestOptions): Promise<AnalyticsResult<FieldTimeSeriesPoint[]>>;
+    /**
+     * Top N most frequent values for a field.
+     * Server `queryType`: **"topN"**
+     *
+     * @example
+     * const { data } = await db.analytics.topN('country', 5);
+     * // [{ label: 'US', value: 'US', count: 500 }, ...]
+     */
+    topN(field: string, n?: number, options?: {
+        labelField?: string;
+        order?: 'asc' | 'desc';
+        dateRange?: DateRange;
+    } & RequestOptions): Promise<AnalyticsResult<TopNItem[]>>;
+    /**
+     * Statistical summary for a numeric field: min, max, avg, stddev, p50, p90, p99.
+     * Server `queryType`: **"stats"**
+     *
+     * @example
+     * const { data } = await db.analytics.stats('score');
+     * console.log(data.avg, data.p99);
+     */
+    stats(field: string, options?: {
+        dateRange?: DateRange;
+    } & RequestOptions): Promise<AnalyticsResult<FieldStatsResult>>;
+    /**
+     * Filtered, paginated raw records with optional field projection.
+     * Supports filter ops: == != > < >= <= CONTAINS
+     * Server `queryType`: **"records"**
+     *
+     * @example
+     * const { data } = await db.analytics.records({
+     *   filters: [{ field: 'role', op: '==', value: 'admin' }],
+     *   selectFields: ['email', 'createdAt'],
+     *   limit: 25,
+     * });
+     * console.log(data.data, data.hasMore);
+     */
+    records(options?: {
+        filters?: Filter[];
+        selectFields?: string[];
+        limit?: number;
+        offset?: number;
+        orderBy?: string;
+        order?: 'asc' | 'desc';
+        dateRange?: DateRange;
+    } & RequestOptions): Promise<AnalyticsResult<FilteredRecordsResult>>;
+    /**
+     * Multiple aggregations in a single BigQuery call — ideal for dashboard stat cards.
+     * Server `queryType`: **"multiMetric"**
+     *
+     * @example
+     * const { data } = await db.analytics.multiMetric([
+     *   { name: 'totalRevenue', field: 'amount',  aggregation: 'sum' },
+     *   { name: 'avgScore',     field: 'score',   aggregation: 'avg' },
+     *   { name: 'userCount',    field: 'userId',  aggregation: 'count' },
+     * ]);
+     * console.log(data.totalRevenue, data.avgScore, data.userCount);
+     */
+    multiMetric(metrics: MultiMetricItem[], options?: {
+        dateRange?: DateRange;
+    } & RequestOptions): Promise<AnalyticsResult<Record<string, number>>>;
+    /**
+     * Storage statistics for the bucket — total records, bytes, avg/min/max size.
+     * Server `queryType`: **"storageStats"**
+     *
+     * @example
+     * const { data } = await db.analytics.storageStats();
+     * console.log(data.totalRecords, data.totalBytes);
+     */
+    storageStats(options?: {
+        dateRange?: DateRange;
+    } & RequestOptions): Promise<AnalyticsResult<StorageStatsResult>>;
+    /**
+     * Compare a metric across multiple buckets in one query.
+     * Server `queryType`: **"crossBucket"**
+     *
+     * @example
+     * const { data } = await db.analytics.crossBucket({
+     *   bucketKeys:  ['sales', 'refunds', 'trials'],
+     *   field:       'amount',
+     *   aggregation: 'sum',
+     * });
+     */
+    crossBucket(options: {
+        bucketKeys: string[];
+        field: string;
+        aggregation?: 'sum' | 'avg' | 'min' | 'max' | 'count';
+        dateRange?: DateRange;
+    } & RequestOptions): Promise<AnalyticsResult<unknown>>;
+}
+
+export { AnalyticsClient, AnalyticsQuery, AnalyticsResponse, CountResult, DateRange, DistributionItem, FieldStatsResult, FieldTimeSeriesPoint, Filter, FilteredRecordsResult, MultiMetricItem, StorageStatsResult, SumResult, TimeSeriesPoint, TopNItem };

package/dist/analytics/index.d.ts

@@ -0,0 +1,178 @@
+import { a9 as HttpClient, c as AnalyticsQuery, V as RequestOptions, e as AnalyticsResponse, D as DateRange, C as CountResult, p as DistributionItem, a1 as SumResult, a2 as TimeSeriesPoint, r as FieldTimeSeriesPoint, a3 as TopNItem, F as FieldStatsResult, s as Filter, u as FilteredRecordsResult, M as MultiMetricItem, a0 as StorageStatsResult } from '../http-CIXLF5GV.js';
+export { d as AnalyticsQueryType } from '../http-CIXLF5GV.js';
+
+type AnalyticsResult<T> = Omit<AnalyticsResponse, 'data'> & {
+    data: T;
+    queryType: string;
+    bucketKey: string | null;
+    projectId: string;
+};
+declare class AnalyticsClient {
+    private readonly http;
+    constructor(http: HttpClient);
+    private get path();
+    /**
+     * Run any analytics query with full control over the payload.
+     * Prefer the typed convenience methods below for everyday use.
+     */
+    query<T = unknown>(payload: AnalyticsQuery, opts?: RequestOptions): Promise<AnalyticsResult<T>>;
+    /**
+     * Total record count, optionally scoped to a date range.
+     * Server `queryType`: **"count"**
+     *
+     * @example
+     * const { data } = await db.analytics.count();
+     * console.log(data.count); // 1234
+     *
+     * // With date range
+     * const { data } = await db.analytics.count({
+     *   dateRange: { startDate: '2025-01-01', endDate: '2025-12-31' }
+     * });
+     */
+    count(options?: {
+        dateRange?: DateRange;
+    } & RequestOptions): Promise<AnalyticsResult<CountResult>>;
+    /**
+     * Value distribution (histogram) for a field.
+     * Server `queryType`: **"distribution"**
+     *
+     * @example
+     * const { data } = await db.analytics.distribution('status');
+     * // [{ value: 'active', count: 80 }, { value: 'archived', count: 20 }]
+     */
+    distribution(field: string, options?: {
+        limit?: number;
+        order?: 'asc' | 'desc';
+        dateRange?: DateRange;
+    } & RequestOptions): Promise<AnalyticsResult<DistributionItem[]>>;
+    /**
+     * Sum a numeric field, with optional group-by.
+     * Server `queryType`: **"sum"**
+     *
+     * @example
+     * const { data } = await db.analytics.sum('revenue', { groupBy: 'region' });
+     */
+    sum(field: string, options?: {
+        groupBy?: string;
+        limit?: number;
+        dateRange?: DateRange;
+    } & RequestOptions): Promise<AnalyticsResult<SumResult>>;
+    /**
+     * Record count grouped over time.
+     * Server `queryType`: **"timeSeries"**
+     *
+     * @example
+     * const { data } = await db.analytics.timeSeries({ granularity: 'day' });
+     * // [{ date: '2025-01-01', count: 42 }, ...]
+     */
+    timeSeries(options?: {
+        granularity?: 'hour' | 'day' | 'week' | 'month';
+        dateRange?: DateRange;
+    } & RequestOptions): Promise<AnalyticsResult<TimeSeriesPoint[]>>;
+    /**
+     * Aggregate a numeric field over time.
+     * Server `queryType`: **"fieldTimeSeries"**
+     *
+     * @example
+     * const { data } = await db.analytics.fieldTimeSeries('revenue', {
+     *   granularity: 'month',
+     *   aggregation: 'sum',
+     * });
+     */
+    fieldTimeSeries(field: string, options?: {
+        aggregation?: 'sum' | 'avg' | 'min' | 'max' | 'count';
+        granularity?: 'hour' | 'day' | 'week' | 'month';
+        dateRange?: DateRange;
+    } & RequestOptions): Promise<AnalyticsResult<FieldTimeSeriesPoint[]>>;
+    /**
+     * Top N most frequent values for a field.
+     * Server `queryType`: **"topN"**
+     *
+     * @example
+     * const { data } = await db.analytics.topN('country', 5);
+     * // [{ label: 'US', value: 'US', count: 500 }, ...]
+     */
+    topN(field: string, n?: number, options?: {
+        labelField?: string;
+        order?: 'asc' | 'desc';
+        dateRange?: DateRange;
+    } & RequestOptions): Promise<AnalyticsResult<TopNItem[]>>;
+    /**
+     * Statistical summary for a numeric field: min, max, avg, stddev, p50, p90, p99.
+     * Server `queryType`: **"stats"**
+     *
+     * @example
+     * const { data } = await db.analytics.stats('score');
+     * console.log(data.avg, data.p99);
+     */
+    stats(field: string, options?: {
+        dateRange?: DateRange;
+    } & RequestOptions): Promise<AnalyticsResult<FieldStatsResult>>;
+    /**
+     * Filtered, paginated raw records with optional field projection.
+     * Supports filter ops: == != > < >= <= CONTAINS
+     * Server `queryType`: **"records"**
+     *
+     * @example
+     * const { data } = await db.analytics.records({
+     *   filters: [{ field: 'role', op: '==', value: 'admin' }],
+     *   selectFields: ['email', 'createdAt'],
+     *   limit: 25,
+     * });
+     * console.log(data.data, data.hasMore);
+     */
+    records(options?: {
+        filters?: Filter[];
+        selectFields?: string[];
+        limit?: number;
+        offset?: number;
+        orderBy?: string;
+        order?: 'asc' | 'desc';
+        dateRange?: DateRange;
+    } & RequestOptions): Promise<AnalyticsResult<FilteredRecordsResult>>;
+    /**
+     * Multiple aggregations in a single BigQuery call — ideal for dashboard stat cards.
+     * Server `queryType`: **"multiMetric"**
+     *
+     * @example
+     * const { data } = await db.analytics.multiMetric([
+     *   { name: 'totalRevenue', field: 'amount',  aggregation: 'sum' },
+     *   { name: 'avgScore',     field: 'score',   aggregation: 'avg' },
+     *   { name: 'userCount',    field: 'userId',  aggregation: 'count' },
+     * ]);
+     * console.log(data.totalRevenue, data.avgScore, data.userCount);
+     */
+    multiMetric(metrics: MultiMetricItem[], options?: {
+        dateRange?: DateRange;
+    } & RequestOptions): Promise<AnalyticsResult<Record<string, number>>>;
+    /**
+     * Storage statistics for the bucket — total records, bytes, avg/min/max size.
+     * Server `queryType`: **"storageStats"**
+     *
+     * @example
+     * const { data } = await db.analytics.storageStats();
+     * console.log(data.totalRecords, data.totalBytes);
+     */
+    storageStats(options?: {
+        dateRange?: DateRange;
+    } & RequestOptions): Promise<AnalyticsResult<StorageStatsResult>>;
+    /**
+     * Compare a metric across multiple buckets in one query.
+     * Server `queryType`: **"crossBucket"**
+     *
+     * @example
+     * const { data } = await db.analytics.crossBucket({
+     *   bucketKeys:  ['sales', 'refunds', 'trials'],
+     *   field:       'amount',
+     *   aggregation: 'sum',
+     * });
+     */
+    crossBucket(options: {
+        bucketKeys: string[];
+        field: string;
+        aggregation?: 'sum' | 'avg' | 'min' | 'max' | 'count';
+        dateRange?: DateRange;
+    } & RequestOptions): Promise<AnalyticsResult<unknown>>;
+}
+
+export { AnalyticsClient, AnalyticsQuery, AnalyticsResponse, CountResult, DateRange, DistributionItem, FieldStatsResult, FieldTimeSeriesPoint, Filter, FilteredRecordsResult, MultiMetricItem, StorageStatsResult, SumResult, TimeSeriesPoint, TopNItem };

package/dist/analytics/index.js

@@ -0,0 +1,221 @@
+'use strict';
+
+// src/analytics/client.ts
+var AnalyticsClient = class {
+  constructor(http) {
+    this.http = http;
+  }
+  get path() {
+    return `/api/analytics/${this.http.bucketKey}/${this.http.bucketKey}`;
+  }
+  // ── Raw query ─────────────────────────────────────────────────────────────
+  /**
+   * Run any analytics query with full control over the payload.
+   * Prefer the typed convenience methods below for everyday use.
+   */
+  async query(payload, opts) {
+    return this.http.post(this.path, payload, opts);
+  }
+  // ── count ──────────────────────────────────────────────────────────────────
+  /**
+   * Total record count, optionally scoped to a date range.
+   * Server `queryType`: **"count"**
+   *
+   * @example
+   * const { data } = await db.analytics.count();
+   * console.log(data.count); // 1234
+   *
+   * // With date range
+   * const { data } = await db.analytics.count({
+   *   dateRange: { startDate: '2025-01-01', endDate: '2025-12-31' }
+   * });
+   */
+  async count(options) {
+    return this.query({ queryType: "count", dateRange: options?.dateRange }, options);
+  }
+  // ── distribution ───────────────────────────────────────────────────────────
+  /**
+   * Value distribution (histogram) for a field.
+   * Server `queryType`: **"distribution"**
+   *
+   * @example
+   * const { data } = await db.analytics.distribution('status');
+   * // [{ value: 'active', count: 80 }, { value: 'archived', count: 20 }]
+   */
+  async distribution(field, options) {
+    return this.query({
+      queryType: "distribution",
+      field,
+      limit: options?.limit,
+      order: options?.order,
+      dateRange: options?.dateRange
+    }, options);
+  }
+  // ── sum ────────────────────────────────────────────────────────────────────
+  /**
+   * Sum a numeric field, with optional group-by.
+   * Server `queryType`: **"sum"**
+   *
+   * @example
+   * const { data } = await db.analytics.sum('revenue', { groupBy: 'region' });
+   */
+  async sum(field, options) {
+    return this.query({
+      queryType: "sum",
+      field,
+      groupBy: options?.groupBy,
+      limit: options?.limit,
+      dateRange: options?.dateRange
+    }, options);
+  }
+  // ── timeSeries ─────────────────────────────────────────────────────────────
+  /**
+   * Record count grouped over time.
+   * Server `queryType`: **"timeSeries"**
+   *
+   * @example
+   * const { data } = await db.analytics.timeSeries({ granularity: 'day' });
+   * // [{ date: '2025-01-01', count: 42 }, ...]
+   */
+  async timeSeries(options) {
+    return this.query({
+      queryType: "timeSeries",
+      granularity: options?.granularity,
+      dateRange: options?.dateRange
+    }, options);
+  }
+  // ── fieldTimeSeries ────────────────────────────────────────────────────────
+  /**
+   * Aggregate a numeric field over time.
+   * Server `queryType`: **"fieldTimeSeries"**
+   *
+   * @example
+   * const { data } = await db.analytics.fieldTimeSeries('revenue', {
+   *   granularity: 'month',
+   *   aggregation: 'sum',
+   * });
+   */
+  async fieldTimeSeries(field, options) {
+    return this.query({
+      queryType: "fieldTimeSeries",
+      field,
+      aggregation: options?.aggregation,
+      granularity: options?.granularity,
+      dateRange: options?.dateRange
+    }, options);
+  }
+  // ── topN ───────────────────────────────────────────────────────────────────
+  /**
+   * Top N most frequent values for a field.
+   * Server `queryType`: **"topN"**
+   *
+   * @example
+   * const { data } = await db.analytics.topN('country', 5);
+   * // [{ label: 'US', value: 'US', count: 500 }, ...]
+   */
+  async topN(field, n = 10, options) {
+    return this.query({
+      queryType: "topN",
+      field,
+      n,
+      labelField: options?.labelField,
+      order: options?.order,
+      dateRange: options?.dateRange
+    }, options);
+  }
+  // ── stats ──────────────────────────────────────────────────────────────────
+  /**
+   * Statistical summary for a numeric field: min, max, avg, stddev, p50, p90, p99.
+   * Server `queryType`: **"stats"**
+   *
+   * @example
+   * const { data } = await db.analytics.stats('score');
+   * console.log(data.avg, data.p99);
+   */
+  async stats(field, options) {
+    return this.query({ queryType: "stats", field, dateRange: options?.dateRange }, options);
+  }
+  // ── records ────────────────────────────────────────────────────────────────
+  /**
+   * Filtered, paginated raw records with optional field projection.
+   * Supports filter ops: == != > < >= <= CONTAINS
+   * Server `queryType`: **"records"**
+   *
+   * @example
+   * const { data } = await db.analytics.records({
+   *   filters: [{ field: 'role', op: '==', value: 'admin' }],
+   *   selectFields: ['email', 'createdAt'],
+   *   limit: 25,
+   * });
+   * console.log(data.data, data.hasMore);
+   */
+  async records(options) {
+    return this.query({
+      queryType: "records",
+      filters: options?.filters,
+      selectFields: options?.selectFields,
+      limit: options?.limit,
+      offset: options?.offset,
+      orderBy: options?.orderBy,
+      order: options?.order,
+      dateRange: options?.dateRange
+    }, options);
+  }
+  // ── multiMetric ────────────────────────────────────────────────────────────
+  /**
+   * Multiple aggregations in a single BigQuery call — ideal for dashboard stat cards.
+   * Server `queryType`: **"multiMetric"**
+   *
+   * @example
+   * const { data } = await db.analytics.multiMetric([
+   *   { name: 'totalRevenue', field: 'amount',  aggregation: 'sum' },
+   *   { name: 'avgScore',     field: 'score',   aggregation: 'avg' },
+   *   { name: 'userCount',    field: 'userId',  aggregation: 'count' },
+   * ]);
+   * console.log(data.totalRevenue, data.avgScore, data.userCount);
+   */
+  async multiMetric(metrics, options) {
+    return this.query({
+      queryType: "multiMetric",
+      metrics,
+      dateRange: options?.dateRange
+    }, options);
+  }
+  // ── storageStats ───────────────────────────────────────────────────────────
+  /**
+   * Storage statistics for the bucket — total records, bytes, avg/min/max size.
+   * Server `queryType`: **"storageStats"**
+   *
+   * @example
+   * const { data } = await db.analytics.storageStats();
+   * console.log(data.totalRecords, data.totalBytes);
+   */
+  async storageStats(options) {
+    return this.query({ queryType: "storageStats", dateRange: options?.dateRange }, options);
+  }
+  // ── crossBucket ────────────────────────────────────────────────────────────
+  /**
+   * Compare a metric across multiple buckets in one query.
+   * Server `queryType`: **"crossBucket"**
+   *
+   * @example
+   * const { data } = await db.analytics.crossBucket({
+   *   bucketKeys:  ['sales', 'refunds', 'trials'],
+   *   field:       'amount',
+   *   aggregation: 'sum',
+   * });
+   */
+  async crossBucket(options) {
+    return this.query({
+      queryType: "crossBucket",
+      bucketKeys: options.bucketKeys,
+      field: options.field,
+      aggregation: options.aggregation,
+      dateRange: options.dateRange
+    }, options);
+  }
+};
+
+exports.AnalyticsClient = AnalyticsClient;
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/analytics/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/analytics/client.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["import type { HttpClient } from '../utils/http.js';\nimport type {\n  AnalyticsQuery,\n  AnalyticsResponse,\n  DateRange,\n  Filter,\n  MultiMetricItem,\n  RequestOptions,\n  CountResult,\n  DistributionItem,\n  SumResult,\n  TimeSeriesPoint,\n  FieldTimeSeriesPoint,\n  TopNItem,\n  FieldStatsResult,\n  FilteredRecordsResult,\n  StorageStatsResult,\n} from '../types/index.js';\n\n// Typed wrapper so callers get proper return types\ntype AnalyticsResult<T> = Omit<AnalyticsResponse, 'data'> & { data: T; queryType: string; bucketKey: string | null; projectId: string };\n\nexport class AnalyticsClient {\n  constructor(private readonly http: HttpClient) {}\n\n  private get path() {\n    // POST /api/analytics/:bucketKey/:key — bucketKey and apiKey both in URL\n    return `/api/analytics/${this.http.bucketKey}/${this.http.bucketKey}`;\n  }\n\n  // ── Raw query ─────────────────────────────────────────────────────────────\n\n  /**\n   * Run any analytics query with full control over the payload.\n   * Prefer the typed convenience methods below for everyday use.\n   */\n  async query<T = unknown>(payload: AnalyticsQuery, opts?: RequestOptions): Promise<AnalyticsResult<T>> {\n    return this.http.post<AnalyticsResult<T>>(this.path, payload, opts);\n  }\n\n  // ── count ──────────────────────────────────────────────────────────────────\n\n  /**\n   * Total record count, optionally scoped to a date range.\n   * Server `queryType`: **\"count\"**\n   *\n   * @example\n   * const { data } = await db.analytics.count();\n   * console.log(data.count); // 1234\n   *\n   * // With date range\n   * const { data } = await db.analytics.count({\n   *   dateRange: { startDate: '2025-01-01', endDate: '2025-12-31' }\n   * });\n   */\n  async count(options?: { dateRange?: DateRange } & RequestOptions): Promise<AnalyticsResult<CountResult>> {\n    return this.query<CountResult>({ queryType: 'count', dateRange: options?.dateRange }, options);\n  }\n\n  // ── distribution ───────────────────────────────────────────────────────────\n\n  /**\n   * Value distribution (histogram) for a field.\n   * Server `queryType`: **\"distribution\"**\n   *\n   * @example\n   * const { data } = await db.analytics.distribution('status');\n   * // [{ value: 'active', count: 80 }, { value: 'archived', count: 20 }]\n   */\n  async distribution(\n    field: string,\n    options?: { limit?: number; order?: 'asc' | 'desc'; dateRange?: DateRange } & RequestOptions\n  ): Promise<AnalyticsResult<DistributionItem[]>> {\n    return this.query<DistributionItem[]>({\n      queryType: 'distribution',\n      field,\n      limit:     options?.limit,\n      order:     options?.order,\n      dateRange: options?.dateRange,\n    }, options);\n  }\n\n  // ── sum ────────────────────────────────────────────────────────────────────\n\n  /**\n   * Sum a numeric field, with optional group-by.\n   * Server `queryType`: **\"sum\"**\n   *\n   * @example\n   * const { data } = await db.analytics.sum('revenue', { groupBy: 'region' });\n   */\n  async sum(\n    field: string,\n    options?: { groupBy?: string; limit?: number; dateRange?: DateRange } & RequestOptions\n  ): Promise<AnalyticsResult<SumResult>> {\n    return this.query<SumResult>({\n      queryType: 'sum',\n      field,\n      groupBy:   options?.groupBy,\n      limit:     options?.limit,\n      dateRange: options?.dateRange,\n    }, options);\n  }\n\n  // ── timeSeries ─────────────────────────────────────────────────────────────\n\n  /**\n   * Record count grouped over time.\n   * Server `queryType`: **\"timeSeries\"**\n   *\n   * @example\n   * const { data } = await db.analytics.timeSeries({ granularity: 'day' });\n   * // [{ date: '2025-01-01', count: 42 }, ...]\n   */\n  async timeSeries(options?: {\n    granularity?: 'hour' | 'day' | 'week' | 'month';\n    dateRange?: DateRange;\n  } & RequestOptions): Promise<AnalyticsResult<TimeSeriesPoint[]>> {\n    return this.query<TimeSeriesPoint[]>({\n      queryType:   'timeSeries',\n      granularity: options?.granularity,\n      dateRange:   options?.dateRange,\n    }, options);\n  }\n\n  // ── fieldTimeSeries ────────────────────────────────────────────────────────\n\n  /**\n   * Aggregate a numeric field over time.\n   * Server `queryType`: **\"fieldTimeSeries\"**\n   *\n   * @example\n   * const { data } = await db.analytics.fieldTimeSeries('revenue', {\n   *   granularity: 'month',\n   *   aggregation: 'sum',\n   * });\n   */\n  async fieldTimeSeries(\n    field: string,\n    options?: {\n      aggregation?: 'sum' | 'avg' | 'min' | 'max' | 'count';\n      granularity?: 'hour' | 'day' | 'week' | 'month';\n      dateRange?: DateRange;\n    } & RequestOptions\n  ): Promise<AnalyticsResult<FieldTimeSeriesPoint[]>> {\n    return this.query<FieldTimeSeriesPoint[]>({\n      queryType:   'fieldTimeSeries',\n      field,\n      aggregation: options?.aggregation,\n      granularity: options?.granularity,\n      dateRange:   options?.dateRange,\n    }, options);\n  }\n\n  // ── topN ───────────────────────────────────────────────────────────────────\n\n  /**\n   * Top N most frequent values for a field.\n   * Server `queryType`: **\"topN\"**\n   *\n   * @example\n   * const { data } = await db.analytics.topN('country', 5);\n   * // [{ label: 'US', value: 'US', count: 500 }, ...]\n   */\n  async topN(\n    field: string,\n    n = 10,\n    options?: { labelField?: string; order?: 'asc' | 'desc'; dateRange?: DateRange } & RequestOptions\n  ): Promise<AnalyticsResult<TopNItem[]>> {\n    return this.query<TopNItem[]>({\n      queryType:  'topN',\n      field,\n      n,\n      labelField: options?.labelField,\n      order:      options?.order,\n      dateRange:  options?.dateRange,\n    }, options);\n  }\n\n  // ── stats ──────────────────────────────────────────────────────────────────\n\n  /**\n   * Statistical summary for a numeric field: min, max, avg, stddev, p50, p90, p99.\n   * Server `queryType`: **\"stats\"**\n   *\n   * @example\n   * const { data } = await db.analytics.stats('score');\n   * console.log(data.avg, data.p99);\n   */\n  async stats(\n    field: string,\n    options?: { dateRange?: DateRange } & RequestOptions\n  ): Promise<AnalyticsResult<FieldStatsResult>> {\n    return this.query<FieldStatsResult>({ queryType: 'stats', field, dateRange: options?.dateRange }, options);\n  }\n\n  // ── records ────────────────────────────────────────────────────────────────\n\n  /**\n   * Filtered, paginated raw records with optional field projection.\n   * Supports filter ops: == != > < >= <= CONTAINS\n   * Server `queryType`: **\"records\"**\n   *\n   * @example\n   * const { data } = await db.analytics.records({\n   *   filters: [{ field: 'role', op: '==', value: 'admin' }],\n   *   selectFields: ['email', 'createdAt'],\n   *   limit: 25,\n   * });\n   * console.log(data.data, data.hasMore);\n   */\n  async records(options?: {\n    filters?: Filter[];\n    selectFields?: string[];\n    limit?: number;\n    offset?: number;\n    orderBy?: string;\n    order?: 'asc' | 'desc';\n    dateRange?: DateRange;\n  } & RequestOptions): Promise<AnalyticsResult<FilteredRecordsResult>> {\n    return this.query<FilteredRecordsResult>({\n      queryType:    'records',\n      filters:      options?.filters,\n      selectFields: options?.selectFields,\n      limit:        options?.limit,\n      offset:       options?.offset,\n      orderBy:      options?.orderBy,\n      order:        options?.order,\n      dateRange:    options?.dateRange,\n    }, options);\n  }\n\n  // ── multiMetric ────────────────────────────────────────────────────────────\n\n  /**\n   * Multiple aggregations in a single BigQuery call — ideal for dashboard stat cards.\n   * Server `queryType`: **\"multiMetric\"**\n   *\n   * @example\n   * const { data } = await db.analytics.multiMetric([\n   *   { name: 'totalRevenue', field: 'amount',  aggregation: 'sum' },\n   *   { name: 'avgScore',     field: 'score',   aggregation: 'avg' },\n   *   { name: 'userCount',    field: 'userId',  aggregation: 'count' },\n   * ]);\n   * console.log(data.totalRevenue, data.avgScore, data.userCount);\n   */\n  async multiMetric(\n    metrics: MultiMetricItem[],\n    options?: { dateRange?: DateRange } & RequestOptions\n  ): Promise<AnalyticsResult<Record<string, number>>> {\n    return this.query<Record<string, number>>({\n      queryType: 'multiMetric',\n      metrics,\n      dateRange: options?.dateRange,\n    }, options);\n  }\n\n  // ── storageStats ───────────────────────────────────────────────────────────\n\n  /**\n   * Storage statistics for the bucket — total records, bytes, avg/min/max size.\n   * Server `queryType`: **\"storageStats\"**\n   *\n   * @example\n   * const { data } = await db.analytics.storageStats();\n   * console.log(data.totalRecords, data.totalBytes);\n   */\n  async storageStats(\n    options?: { dateRange?: DateRange } & RequestOptions\n  ): Promise<AnalyticsResult<StorageStatsResult>> {\n    return this.query<StorageStatsResult>({ queryType: 'storageStats', dateRange: options?.dateRange }, options);\n  }\n\n  // ── crossBucket ────────────────────────────────────────────────────────────\n\n  /**\n   * Compare a metric across multiple buckets in one query.\n   * Server `queryType`: **\"crossBucket\"**\n   *\n   * @example\n   * const { data } = await db.analytics.crossBucket({\n   *   bucketKeys:  ['sales', 'refunds', 'trials'],\n   *   field:       'amount',\n   *   aggregation: 'sum',\n   * });\n   */\n  async crossBucket(options: {\n    bucketKeys: string[];\n    field: string;\n    aggregation?: 'sum' | 'avg' | 'min' | 'max' | 'count';\n    dateRange?: DateRange;\n  } & RequestOptions): Promise<AnalyticsResult<unknown>> {\n    return this.query<unknown>({\n      queryType:   'crossBucket',\n      bucketKeys:  options.bucketKeys,\n      field:       options.field,\n      aggregation: options.aggregation,\n      dateRange:   options.dateRange,\n    }, options);\n  }\n}\n"]}