hydrousdb 2.0.0 → 2.0.3

package/dist/analytics/index.d.mts

@@ -1,185 +0,0 @@
-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-DTukpdAU.mjs';
-export { d as AnalyticsQueryType } from '../http-DTukpdAU.mjs';
-
-type AnalyticsResult<T> = Omit<AnalyticsResponse, 'data'> & {
-    data: T;
-    queryType: string;
-    bucketKey: string | null;
-    projectId: string;
-};
-/** Options accepted by every analytics method */
-interface BucketOptions {
-    /**
-     * The bucket to run the analytics query against.
-     * Required on all analytics calls.
-     *
-     * @example
-     * const { data } = await db.analytics.count({ bucketKey: 'orders' });
-     */
-    bucketKey: string;
-}
-declare class AnalyticsClient {
-    private readonly http;
-    constructor(http: HttpClient);
-    /** Builds the path for a given bucket: /api/analytics/:bucketKey/:securityKey */
-    private 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, options: BucketOptions & RequestOptions): Promise<AnalyticsResult<T>>;
-    /**
-     * Total record count, optionally scoped to a date range.
-     *
-     * @example
-     * const { data } = await db.analytics.count({ bucketKey: 'orders' });
-     * console.log(data.count);
-     *
-     * const { data } = await db.analytics.count({
-     *   bucketKey: 'orders',
-     *   dateRange: { startDate: '2025-01-01', endDate: '2025-12-31' },
-     * });
-     */
-    count(options: {
-        dateRange?: DateRange;
-    } & BucketOptions & RequestOptions): Promise<AnalyticsResult<CountResult>>;
-    /**
-     * Value distribution (histogram) for a field.
-     *
-     * @example
-     * const { data } = await db.analytics.distribution('status', { bucketKey: 'orders' });
-     * // [{ value: 'active', count: 80 }, { value: 'archived', count: 20 }]
-     */
-    distribution(field: string, options: {
-        limit?: number;
-        order?: 'asc' | 'desc';
-        dateRange?: DateRange;
-    } & BucketOptions & RequestOptions): Promise<AnalyticsResult<DistributionItem[]>>;
-    /**
-     * Sum a numeric field, with optional group-by.
-     *
-     * @example
-     * const { data } = await db.analytics.sum('revenue', { bucketKey: 'orders', groupBy: 'region' });
-     */
-    sum(field: string, options: {
-        groupBy?: string;
-        limit?: number;
-        dateRange?: DateRange;
-    } & BucketOptions & RequestOptions): Promise<AnalyticsResult<SumResult>>;
-    /**
-     * Record count grouped over time.
-     *
-     * @example
-     * const { data } = await db.analytics.timeSeries({ bucketKey: 'orders', granularity: 'day' });
-     * // [{ date: '2025-01-01', count: 42 }, ...]
-     */
-    timeSeries(options: {
-        granularity?: 'hour' | 'day' | 'week' | 'month';
-        dateRange?: DateRange;
-    } & BucketOptions & RequestOptions): Promise<AnalyticsResult<TimeSeriesPoint[]>>;
-    /**
-     * Aggregate a numeric field over time.
-     *
-     * @example
-     * const { data } = await db.analytics.fieldTimeSeries('revenue', {
-     *   bucketKey: 'orders',
-     *   granularity: 'month',
-     *   aggregation: 'sum',
-     * });
-     */
-    fieldTimeSeries(field: string, options: {
-        aggregation?: 'sum' | 'avg' | 'min' | 'max' | 'count';
-        granularity?: 'hour' | 'day' | 'week' | 'month';
-        dateRange?: DateRange;
-    } & BucketOptions & RequestOptions): Promise<AnalyticsResult<FieldTimeSeriesPoint[]>>;
-    /**
-     * Top N most frequent values for a field.
-     *
-     * @example
-     * const { data } = await db.analytics.topN('country', 5, { bucketKey: 'users' });
-     * // [{ label: 'US', value: 'US', count: 500 }, ...]
-     */
-    topN(field: string, n: number | undefined, options: {
-        labelField?: string;
-        order?: 'asc' | 'desc';
-        dateRange?: DateRange;
-    } & BucketOptions & RequestOptions): Promise<AnalyticsResult<TopNItem[]>>;
-    /**
-     * Statistical summary for a numeric field: min, max, avg, stddev, p50, p90, p99.
-     *
-     * @example
-     * const { data } = await db.analytics.stats('score', { bucketKey: 'users' });
-     * console.log(data.avg, data.p99);
-     */
-    stats(field: string, options: {
-        dateRange?: DateRange;
-    } & BucketOptions & RequestOptions): Promise<AnalyticsResult<FieldStatsResult>>;
-    /**
-     * Filtered, paginated raw records with optional field projection.
-     * Supports filter ops: == != > < >= <= CONTAINS
-     *
-     * @example
-     * const { data } = await db.analytics.records({
-     *   bucketKey: 'users',
-     *   filters: [{ field: 'role', op: '==', value: 'admin' }],
-     *   selectFields: ['email', 'createdAt'],
-     *   limit: 25,
-     * });
-     */
-    records(options: {
-        filters?: Filter[];
-        selectFields?: string[];
-        limit?: number;
-        offset?: number;
-        orderBy?: string;
-        order?: 'asc' | 'desc';
-        dateRange?: DateRange;
-    } & BucketOptions & RequestOptions): Promise<AnalyticsResult<FilteredRecordsResult>>;
-    /**
-     * Multiple aggregations in a single call — ideal for dashboard stat cards.
-     *
-     * @example
-     * const { data } = await db.analytics.multiMetric(
-     *   [
-     *     { name: 'totalRevenue', field: 'amount', aggregation: 'sum' },
-     *     { name: 'avgScore',     field: 'score',  aggregation: 'avg' },
-     *   ],
-     *   { bucketKey: 'orders' }
-     * );
-     * console.log(data.totalRevenue, data.avgScore);
-     */
-    multiMetric(metrics: MultiMetricItem[], options: {
-        dateRange?: DateRange;
-    } & BucketOptions & RequestOptions): Promise<AnalyticsResult<Record<string, number>>>;
-    /**
-     * Storage statistics for a bucket — total records, bytes, avg/min/max size.
-     *
-     * @example
-     * const { data } = await db.analytics.storageStats({ bucketKey: 'orders' });
-     * console.log(data.totalRecords, data.totalBytes);
-     */
-    storageStats(options: {
-        dateRange?: DateRange;
-    } & BucketOptions & RequestOptions): Promise<AnalyticsResult<StorageStatsResult>>;
-    /**
-     * Compare a metric across multiple buckets in one query.
-     * Note: `bucketKey` here is used only for auth — the actual buckets
-     * compared are specified via `bucketKeys`.
-     *
-     * @example
-     * const { data } = await db.analytics.crossBucket({
-     *   bucketKey:   'sales-2025',   // auth bucket
-     *   bucketKeys:  ['sales-2024', 'sales-2025'],
-     *   field:       'amount',
-     *   aggregation: 'sum',
-     * });
-     */
-    crossBucket(options: {
-        bucketKeys: string[];
-        field: string;
-        aggregation?: 'sum' | 'avg' | 'min' | 'max' | 'count';
-        dateRange?: DateRange;
-    } & BucketOptions & RequestOptions): Promise<AnalyticsResult<unknown>>;
-}
-
-export { AnalyticsClient, AnalyticsQuery, AnalyticsResponse, type BucketOptions, CountResult, DateRange, DistributionItem, FieldStatsResult, FieldTimeSeriesPoint, Filter, FilteredRecordsResult, MultiMetricItem, StorageStatsResult, SumResult, TimeSeriesPoint, TopNItem };

package/dist/analytics/index.d.ts

@@ -1,185 +0,0 @@
-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-DTukpdAU.js';
-export { d as AnalyticsQueryType } from '../http-DTukpdAU.js';
-
-type AnalyticsResult<T> = Omit<AnalyticsResponse, 'data'> & {
-    data: T;
-    queryType: string;
-    bucketKey: string | null;
-    projectId: string;
-};
-/** Options accepted by every analytics method */
-interface BucketOptions {
-    /**
-     * The bucket to run the analytics query against.
-     * Required on all analytics calls.
-     *
-     * @example
-     * const { data } = await db.analytics.count({ bucketKey: 'orders' });
-     */
-    bucketKey: string;
-}
-declare class AnalyticsClient {
-    private readonly http;
-    constructor(http: HttpClient);
-    /** Builds the path for a given bucket: /api/analytics/:bucketKey/:securityKey */
-    private 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, options: BucketOptions & RequestOptions): Promise<AnalyticsResult<T>>;
-    /**
-     * Total record count, optionally scoped to a date range.
-     *
-     * @example
-     * const { data } = await db.analytics.count({ bucketKey: 'orders' });
-     * console.log(data.count);
-     *
-     * const { data } = await db.analytics.count({
-     *   bucketKey: 'orders',
-     *   dateRange: { startDate: '2025-01-01', endDate: '2025-12-31' },
-     * });
-     */
-    count(options: {
-        dateRange?: DateRange;
-    } & BucketOptions & RequestOptions): Promise<AnalyticsResult<CountResult>>;
-    /**
-     * Value distribution (histogram) for a field.
-     *
-     * @example
-     * const { data } = await db.analytics.distribution('status', { bucketKey: 'orders' });
-     * // [{ value: 'active', count: 80 }, { value: 'archived', count: 20 }]
-     */
-    distribution(field: string, options: {
-        limit?: number;
-        order?: 'asc' | 'desc';
-        dateRange?: DateRange;
-    } & BucketOptions & RequestOptions): Promise<AnalyticsResult<DistributionItem[]>>;
-    /**
-     * Sum a numeric field, with optional group-by.
-     *
-     * @example
-     * const { data } = await db.analytics.sum('revenue', { bucketKey: 'orders', groupBy: 'region' });
-     */
-    sum(field: string, options: {
-        groupBy?: string;
-        limit?: number;
-        dateRange?: DateRange;
-    } & BucketOptions & RequestOptions): Promise<AnalyticsResult<SumResult>>;
-    /**
-     * Record count grouped over time.
-     *
-     * @example
-     * const { data } = await db.analytics.timeSeries({ bucketKey: 'orders', granularity: 'day' });
-     * // [{ date: '2025-01-01', count: 42 }, ...]
-     */
-    timeSeries(options: {
-        granularity?: 'hour' | 'day' | 'week' | 'month';
-        dateRange?: DateRange;
-    } & BucketOptions & RequestOptions): Promise<AnalyticsResult<TimeSeriesPoint[]>>;
-    /**
-     * Aggregate a numeric field over time.
-     *
-     * @example
-     * const { data } = await db.analytics.fieldTimeSeries('revenue', {
-     *   bucketKey: 'orders',
-     *   granularity: 'month',
-     *   aggregation: 'sum',
-     * });
-     */
-    fieldTimeSeries(field: string, options: {
-        aggregation?: 'sum' | 'avg' | 'min' | 'max' | 'count';
-        granularity?: 'hour' | 'day' | 'week' | 'month';
-        dateRange?: DateRange;
-    } & BucketOptions & RequestOptions): Promise<AnalyticsResult<FieldTimeSeriesPoint[]>>;
-    /**
-     * Top N most frequent values for a field.
-     *
-     * @example
-     * const { data } = await db.analytics.topN('country', 5, { bucketKey: 'users' });
-     * // [{ label: 'US', value: 'US', count: 500 }, ...]
-     */
-    topN(field: string, n: number | undefined, options: {
-        labelField?: string;
-        order?: 'asc' | 'desc';
-        dateRange?: DateRange;
-    } & BucketOptions & RequestOptions): Promise<AnalyticsResult<TopNItem[]>>;
-    /**
-     * Statistical summary for a numeric field: min, max, avg, stddev, p50, p90, p99.
-     *
-     * @example
-     * const { data } = await db.analytics.stats('score', { bucketKey: 'users' });
-     * console.log(data.avg, data.p99);
-     */
-    stats(field: string, options: {
-        dateRange?: DateRange;
-    } & BucketOptions & RequestOptions): Promise<AnalyticsResult<FieldStatsResult>>;
-    /**
-     * Filtered, paginated raw records with optional field projection.
-     * Supports filter ops: == != > < >= <= CONTAINS
-     *
-     * @example
-     * const { data } = await db.analytics.records({
-     *   bucketKey: 'users',
-     *   filters: [{ field: 'role', op: '==', value: 'admin' }],
-     *   selectFields: ['email', 'createdAt'],
-     *   limit: 25,
-     * });
-     */
-    records(options: {
-        filters?: Filter[];
-        selectFields?: string[];
-        limit?: number;
-        offset?: number;
-        orderBy?: string;
-        order?: 'asc' | 'desc';
-        dateRange?: DateRange;
-    } & BucketOptions & RequestOptions): Promise<AnalyticsResult<FilteredRecordsResult>>;
-    /**
-     * Multiple aggregations in a single call — ideal for dashboard stat cards.
-     *
-     * @example
-     * const { data } = await db.analytics.multiMetric(
-     *   [
-     *     { name: 'totalRevenue', field: 'amount', aggregation: 'sum' },
-     *     { name: 'avgScore',     field: 'score',  aggregation: 'avg' },
-     *   ],
-     *   { bucketKey: 'orders' }
-     * );
-     * console.log(data.totalRevenue, data.avgScore);
-     */
-    multiMetric(metrics: MultiMetricItem[], options: {
-        dateRange?: DateRange;
-    } & BucketOptions & RequestOptions): Promise<AnalyticsResult<Record<string, number>>>;
-    /**
-     * Storage statistics for a bucket — total records, bytes, avg/min/max size.
-     *
-     * @example
-     * const { data } = await db.analytics.storageStats({ bucketKey: 'orders' });
-     * console.log(data.totalRecords, data.totalBytes);
-     */
-    storageStats(options: {
-        dateRange?: DateRange;
-    } & BucketOptions & RequestOptions): Promise<AnalyticsResult<StorageStatsResult>>;
-    /**
-     * Compare a metric across multiple buckets in one query.
-     * Note: `bucketKey` here is used only for auth — the actual buckets
-     * compared are specified via `bucketKeys`.
-     *
-     * @example
-     * const { data } = await db.analytics.crossBucket({
-     *   bucketKey:   'sales-2025',   // auth bucket
-     *   bucketKeys:  ['sales-2024', 'sales-2025'],
-     *   field:       'amount',
-     *   aggregation: 'sum',
-     * });
-     */
-    crossBucket(options: {
-        bucketKeys: string[];
-        field: string;
-        aggregation?: 'sum' | 'avg' | 'min' | 'max' | 'count';
-        dateRange?: DateRange;
-    } & BucketOptions & RequestOptions): Promise<AnalyticsResult<unknown>>;
-}
-
-export { AnalyticsClient, AnalyticsQuery, AnalyticsResponse, type BucketOptions, CountResult, DateRange, DistributionItem, FieldStatsResult, FieldTimeSeriesPoint, Filter, FilteredRecordsResult, MultiMetricItem, StorageStatsResult, SumResult, TimeSeriesPoint, TopNItem };

package/dist/analytics/index.js

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

package/dist/analytics/index.js.map

@@ -1 +0,0 @@
-{"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'> & {\n  data: T;\n  queryType: string;\n  bucketKey: string | null;\n  projectId: string;\n};\n\n/** Options accepted by every analytics method */\nexport interface BucketOptions {\n  /**\n   * The bucket to run the analytics query against.\n   * Required on all analytics calls.\n   *\n   * @example\n   * const { data } = await db.analytics.count({ bucketKey: 'orders' });\n   */\n  bucketKey: string;\n}\n\nexport class AnalyticsClient {\n  constructor(private readonly http: HttpClient) {}\n\n  /** Builds the path for a given bucket: /api/analytics/:bucketKey/:securityKey */\n  private path(bucketKey: string): string {\n    return `/api/analytics/${bucketKey}/${this.http.securityKey}`;\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>(\n    payload: AnalyticsQuery,\n    options: BucketOptions & RequestOptions\n  ): Promise<AnalyticsResult<T>> {\n    const { bucketKey, ...rest } = options;\n    return this.http.post<AnalyticsResult<T>>(this.path(bucketKey), payload, rest);\n  }\n\n  // ── count ──────────────────────────────────────────────────────────────────\n\n  /**\n   * Total record count, optionally scoped to a date range.\n   *\n   * @example\n   * const { data } = await db.analytics.count({ bucketKey: 'orders' });\n   * console.log(data.count);\n   *\n   * const { data } = await db.analytics.count({\n   *   bucketKey: 'orders',\n   *   dateRange: { startDate: '2025-01-01', endDate: '2025-12-31' },\n   * });\n   */\n  async count(\n    options: { dateRange?: DateRange } & BucketOptions & RequestOptions\n  ): Promise<AnalyticsResult<CountResult>> {\n    const { dateRange, ...rest } = options;\n    return this.query<CountResult>({ queryType: 'count', dateRange }, rest);\n  }\n\n  // ── distribution ───────────────────────────────────────────────────────────\n\n  /**\n   * Value distribution (histogram) for a field.\n   *\n   * @example\n   * const { data } = await db.analytics.distribution('status', { bucketKey: 'orders' });\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 } & BucketOptions & RequestOptions\n  ): Promise<AnalyticsResult<DistributionItem[]>> {\n    const { limit, order, dateRange, ...rest } = options;\n    return this.query<DistributionItem[]>({ queryType: 'distribution', field, limit, order, dateRange }, rest);\n  }\n\n  // ── sum ────────────────────────────────────────────────────────────────────\n\n  /**\n   * Sum a numeric field, with optional group-by.\n   *\n   * @example\n   * const { data } = await db.analytics.sum('revenue', { bucketKey: 'orders', groupBy: 'region' });\n   */\n  async sum(\n    field: string,\n    options: { groupBy?: string; limit?: number; dateRange?: DateRange } & BucketOptions & RequestOptions\n  ): Promise<AnalyticsResult<SumResult>> {\n    const { groupBy, limit, dateRange, ...rest } = options;\n    return this.query<SumResult>({ queryType: 'sum', field, groupBy, limit, dateRange }, rest);\n  }\n\n  // ── timeSeries ─────────────────────────────────────────────────────────────\n\n  /**\n   * Record count grouped over time.\n   *\n   * @example\n   * const { data } = await db.analytics.timeSeries({ bucketKey: 'orders', granularity: 'day' });\n   * // [{ date: '2025-01-01', count: 42 }, ...]\n   */\n  async timeSeries(\n    options: { granularity?: 'hour' | 'day' | 'week' | 'month'; dateRange?: DateRange } & BucketOptions & RequestOptions\n  ): Promise<AnalyticsResult<TimeSeriesPoint[]>> {\n    const { granularity, dateRange, ...rest } = options;\n    return this.query<TimeSeriesPoint[]>({ queryType: 'timeSeries', granularity, dateRange }, rest);\n  }\n\n  // ── fieldTimeSeries ────────────────────────────────────────────────────────\n\n  /**\n   * Aggregate a numeric field over time.\n   *\n   * @example\n   * const { data } = await db.analytics.fieldTimeSeries('revenue', {\n   *   bucketKey: 'orders',\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    } & BucketOptions & RequestOptions\n  ): Promise<AnalyticsResult<FieldTimeSeriesPoint[]>> {\n    const { aggregation, granularity, dateRange, ...rest } = options;\n    return this.query<FieldTimeSeriesPoint[]>({ queryType: 'fieldTimeSeries', field, aggregation, granularity, dateRange }, rest);\n  }\n\n  // ── topN ───────────────────────────────────────────────────────────────────\n\n  /**\n   * Top N most frequent values for a field.\n   *\n   * @example\n   * const { data } = await db.analytics.topN('country', 5, { bucketKey: 'users' });\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 } & BucketOptions & RequestOptions\n  ): Promise<AnalyticsResult<TopNItem[]>> {\n    const { labelField, order, dateRange, ...rest } = options;\n    return this.query<TopNItem[]>({ queryType: 'topN', field, n, labelField, order, dateRange }, rest);\n  }\n\n  // ── stats ──────────────────────────────────────────────────────────────────\n\n  /**\n   * Statistical summary for a numeric field: min, max, avg, stddev, p50, p90, p99.\n   *\n   * @example\n   * const { data } = await db.analytics.stats('score', { bucketKey: 'users' });\n   * console.log(data.avg, data.p99);\n   */\n  async stats(\n    field: string,\n    options: { dateRange?: DateRange } & BucketOptions & RequestOptions\n  ): Promise<AnalyticsResult<FieldStatsResult>> {\n    const { dateRange, ...rest } = options;\n    return this.query<FieldStatsResult>({ queryType: 'stats', field, dateRange }, rest);\n  }\n\n  // ── records ────────────────────────────────────────────────────────────────\n\n  /**\n   * Filtered, paginated raw records with optional field projection.\n   * Supports filter ops: == != > < >= <= CONTAINS\n   *\n   * @example\n   * const { data } = await db.analytics.records({\n   *   bucketKey: 'users',\n   *   filters: [{ field: 'role', op: '==', value: 'admin' }],\n   *   selectFields: ['email', 'createdAt'],\n   *   limit: 25,\n   * });\n   */\n  async records(\n    options: {\n      filters?: Filter[];\n      selectFields?: string[];\n      limit?: number;\n      offset?: number;\n      orderBy?: string;\n      order?: 'asc' | 'desc';\n      dateRange?: DateRange;\n    } & BucketOptions & RequestOptions\n  ): Promise<AnalyticsResult<FilteredRecordsResult>> {\n    const { filters, selectFields, limit, offset, orderBy, order, dateRange, ...rest } = options;\n    return this.query<FilteredRecordsResult>(\n      { queryType: 'records', filters, selectFields, limit, offset, orderBy, order, dateRange },\n      rest\n    );\n  }\n\n  // ── multiMetric ────────────────────────────────────────────────────────────\n\n  /**\n   * Multiple aggregations in a single call — ideal for dashboard stat cards.\n   *\n   * @example\n   * const { data } = await db.analytics.multiMetric(\n   *   [\n   *     { name: 'totalRevenue', field: 'amount', aggregation: 'sum' },\n   *     { name: 'avgScore',     field: 'score',  aggregation: 'avg' },\n   *   ],\n   *   { bucketKey: 'orders' }\n   * );\n   * console.log(data.totalRevenue, data.avgScore);\n   */\n  async multiMetric(\n    metrics: MultiMetricItem[],\n    options: { dateRange?: DateRange } & BucketOptions & RequestOptions\n  ): Promise<AnalyticsResult<Record<string, number>>> {\n    const { dateRange, ...rest } = options;\n    return this.query<Record<string, number>>({ queryType: 'multiMetric', metrics, dateRange }, rest);\n  }\n\n  // ── storageStats ───────────────────────────────────────────────────────────\n\n  /**\n   * Storage statistics for a bucket — total records, bytes, avg/min/max size.\n   *\n   * @example\n   * const { data } = await db.analytics.storageStats({ bucketKey: 'orders' });\n   * console.log(data.totalRecords, data.totalBytes);\n   */\n  async storageStats(\n    options: { dateRange?: DateRange } & BucketOptions & RequestOptions\n  ): Promise<AnalyticsResult<StorageStatsResult>> {\n    const { dateRange, ...rest } = options;\n    return this.query<StorageStatsResult>({ queryType: 'storageStats', dateRange }, rest);\n  }\n\n  // ── crossBucket ────────────────────────────────────────────────────────────\n\n  /**\n   * Compare a metric across multiple buckets in one query.\n   * Note: `bucketKey` here is used only for auth — the actual buckets\n   * compared are specified via `bucketKeys`.\n   *\n   * @example\n   * const { data } = await db.analytics.crossBucket({\n   *   bucketKey:   'sales-2025',   // auth bucket\n   *   bucketKeys:  ['sales-2024', 'sales-2025'],\n   *   field:       'amount',\n   *   aggregation: 'sum',\n   * });\n   */\n  async crossBucket(\n    options: {\n      bucketKeys: string[];\n      field: string;\n      aggregation?: 'sum' | 'avg' | 'min' | 'max' | 'count';\n      dateRange?: DateRange;\n    } & BucketOptions & RequestOptions\n  ): Promise<AnalyticsResult<unknown>> {\n    const { bucketKeys, field, aggregation, dateRange, ...rest } = options;\n    return this.query<unknown>({ queryType: 'crossBucket', bucketKeys, field, aggregation, dateRange }, rest);\n  }\n}\n"]}