@reopt-ai/data-contract 0.6.3 → 0.7.0

package/dist/query.d.cts

@@ -1,26 +1,12 @@
-import { z } from 'zod';
-export { zDate, zInstant } from './index.cjs';
-import './version-DJ2Grb_N.cjs';
-
-/**
- * `POST /api/v1/query/*` — the read contract.
- *
- * Server credentials, project-scoped: the authenticated client's projectId must
- * equal the `projectId` in the body, or the request is refused. Reads are POSTs
- * because the inputs nest (funnel steps, channel filters) and would not survive
- * a query string; consumers cache on their own side, so HTTP cache semantics
- * buy nothing here.
- *
- * Response shapes mirror the existing dashboard computations exactly — this
- * plane re-exposes them, it does not add new math.
- */
-
+import { zDate, zInstant } from "./index.cjs";
+import { z } from "zod";
+//#region src/query.d.ts
 /** Bucket width for a time series. */
 declare const zGranularity: z.ZodEnum<{
-    month: "month";
-    day: "day";
-    hour: "hour";
-    week: "week";
+  hour: "hour";
+  day: "day";
+  week: "week";
+  month: "month";
 }>;
 type Granularity = z.infer<typeof zGranularity>;
 /**
@@ -42,11 +28,11 @@ declare function isValidTimeZone(value: string): boolean;
  * `channelFilterSchema` field-for-field.
  */
 declare const zChannelFilter: z.ZodOptional<z.ZodObject<{
-    referrerTypes: z.ZodOptional<z.ZodArray<z.ZodString>>;
-    channelTypes: z.ZodOptional<z.ZodArray<z.ZodString>>;
-    utmSources: z.ZodOptional<z.ZodArray<z.ZodString>>;
-    utmMediums: z.ZodOptional<z.ZodArray<z.ZodString>>;
-    utmCampaigns: z.ZodOptional<z.ZodArray<z.ZodString>>;
+  referrerTypes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+  channelTypes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+  utmSources: z.ZodOptional<z.ZodArray<z.ZodString>>;
+  utmMediums: z.ZodOptional<z.ZodArray<z.ZodString>>;
+  utmCampaigns: z.ZodOptional<z.ZodArray<z.ZodString>>;
 }, z.core.$strip>>;
 type ChannelFilter = z.infer<typeof zChannelFilter>;
 /**
@@ -56,53 +42,53 @@ type ChannelFilter = z.infer<typeof zChannelFilter>;
  * response is an "aggregating" badge, not a refresh.
  */
 declare const zQuerySource: z.ZodEnum<{
-    raw: "raw";
-    rollup: "rollup";
-    mixed: "mixed";
+  rollup: "rollup";
+  raw: "raw";
+  mixed: "mixed";
 }>;
 type QuerySource = z.infer<typeof zQuerySource>;
 declare const zQueryMeta: z.ZodObject<{
+  projectId: z.ZodString;
+  computedAt: z.ZodString;
+  cacheAgeSeconds: z.ZodNumber;
+  ingestLagSeconds: z.ZodNullable<z.ZodNumber>;
+  ingestLagStatus: z.ZodEnum<{
+    unknown: "unknown";
+    known: "known";
+  }>;
+  ingestDeadLetterCount: z.ZodNullable<z.ZodNumber>;
+  cached: z.ZodBoolean;
+  timezone: z.ZodString;
+  source: z.ZodEnum<{
+    rollup: "rollup";
+    raw: "raw";
+    mixed: "mixed";
+  }>;
+  requestId: z.ZodString;
+}, z.core.$strip>;
+type QueryMeta = z.infer<typeof zQueryMeta>;
+/** Every query response is `{ data, meta }`. */
+declare function zQueryEnvelope<T extends z.ZodTypeAny>(data: T): z.ZodObject<{
+  data: T;
+  meta: z.ZodObject<{
     projectId: z.ZodString;
     computedAt: z.ZodString;
     cacheAgeSeconds: z.ZodNumber;
     ingestLagSeconds: z.ZodNullable<z.ZodNumber>;
     ingestLagStatus: z.ZodEnum<{
-        unknown: "unknown";
-        known: "known";
+      unknown: "unknown";
+      known: "known";
     }>;
     ingestDeadLetterCount: z.ZodNullable<z.ZodNumber>;
     cached: z.ZodBoolean;
     timezone: z.ZodString;
     source: z.ZodEnum<{
-        raw: "raw";
-        rollup: "rollup";
-        mixed: "mixed";
+      rollup: "rollup";
+      raw: "raw";
+      mixed: "mixed";
     }>;
     requestId: z.ZodString;
-}, z.core.$strip>;
-type QueryMeta = z.infer<typeof zQueryMeta>;
-/** Every query response is `{ data, meta }`. */
-declare function zQueryEnvelope<T extends z.ZodTypeAny>(data: T): z.ZodObject<{
-    data: T;
-    meta: z.ZodObject<{
-        projectId: z.ZodString;
-        computedAt: z.ZodString;
-        cacheAgeSeconds: z.ZodNumber;
-        ingestLagSeconds: z.ZodNullable<z.ZodNumber>;
-        ingestLagStatus: z.ZodEnum<{
-            unknown: "unknown";
-            known: "known";
-        }>;
-        ingestDeadLetterCount: z.ZodNullable<z.ZodNumber>;
-        cached: z.ZodBoolean;
-        timezone: z.ZodString;
-        source: z.ZodEnum<{
-            raw: "raw";
-            rollup: "rollup";
-            mixed: "mixed";
-        }>;
-        requestId: z.ZodString;
-    }, z.core.$strip>;
+  }, z.core.$strip>;
 }, z.core.$strip>;
 /**
  * v1 breaks down by `properties` JSON keys only. Built-in columns
@@ -110,42 +96,42 @@ declare function zQueryEnvelope<T extends z.ZodTypeAny>(data: T): z.ZodObject<{
  * no *time series* variant, and this plane does not add new computations.
  */
 declare const zTimeseriesBreakdown: z.ZodObject<{
-    kind: z.ZodLiteral<"property">;
-    key: z.ZodString;
-    topN: z.ZodDefault<z.ZodNumber>;
+  kind: z.ZodLiteral<"property">;
+  key: z.ZodString;
+  topN: z.ZodDefault<z.ZodNumber>;
 }, z.core.$strip>;
 type TimeseriesBreakdown = z.infer<typeof zTimeseriesBreakdown>;
 /** Exact-match filter for a top-level event `properties` key. Multiple filters are ANDed. */
 declare const zEventPropertyFilter: z.ZodObject<{
-    key: z.ZodString;
-    operator: z.ZodDefault<z.ZodLiteral<"eq">>;
-    value: z.ZodString;
+  key: z.ZodString;
+  operator: z.ZodDefault<z.ZodLiteral<"eq">>;
+  value: z.ZodString;
 }, z.core.$strip>;
 type EventPropertyFilter = z.infer<typeof zEventPropertyFilter>;
 declare const zEventsTimeseriesInput: z.ZodObject<{
-    projectId: z.ZodString;
-    startDate: z.ZodString;
-    endDate: z.ZodString;
-    granularity: z.ZodDefault<z.ZodEnum<{
-        month: "month";
-        day: "day";
-        hour: "hour";
-        week: "week";
-    }>>;
-    eventName: z.ZodOptional<z.ZodString>;
-    propertyFilters: z.ZodOptional<z.ZodArray<z.ZodObject<{
-        key: z.ZodString;
-        operator: z.ZodDefault<z.ZodLiteral<"eq">>;
-        value: z.ZodString;
-    }, z.core.$strip>>>;
-    breakdown: z.ZodOptional<z.ZodObject<{
-        kind: z.ZodLiteral<"property">;
-        key: z.ZodString;
-        topN: z.ZodDefault<z.ZodNumber>;
-    }, z.core.$strip>>;
-    segmentId: z.ZodOptional<z.ZodString>;
-    timezone: z.ZodOptional<z.ZodString>;
-    includeInternal: z.ZodDefault<z.ZodBoolean>;
+  projectId: z.ZodString;
+  startDate: z.ZodString;
+  endDate: z.ZodString;
+  granularity: z.ZodDefault<z.ZodEnum<{
+    hour: "hour";
+    day: "day";
+    week: "week";
+    month: "month";
+  }>>;
+  eventName: z.ZodOptional<z.ZodString>;
+  propertyFilters: z.ZodOptional<z.ZodArray<z.ZodObject<{
+    key: z.ZodString;
+    operator: z.ZodDefault<z.ZodLiteral<"eq">>;
+    value: z.ZodString;
+  }, z.core.$strip>>>;
+  breakdown: z.ZodOptional<z.ZodObject<{
+    kind: z.ZodLiteral<"property">;
+    key: z.ZodString;
+    topN: z.ZodDefault<z.ZodNumber>;
+  }, z.core.$strip>>;
+  segmentId: z.ZodOptional<z.ZodString>;
+  timezone: z.ZodOptional<z.ZodString>;
+  includeInternal: z.ZodDefault<z.ZodBoolean>;
 }, z.core.$strip>;
 type EventsTimeseriesInput = z.input<typeof zEventsTimeseriesInput>;
 /**
@@ -163,261 +149,261 @@ type EventsTimeseriesInput = z.input<typeof zEventsTimeseriesInput>;
  */
 declare const zBucketStart: z.ZodString;
 declare const zTimeseriesPoint: z.ZodObject<{
-    date: z.ZodString;
-    count: z.ZodNumber;
+  date: z.ZodString;
+  count: z.ZodNumber;
 }, z.core.$strip>;
 type TimeseriesPoint = z.infer<typeof zTimeseriesPoint>;
 declare const zEventsTimeseriesData: z.ZodObject<{
+  granularity: z.ZodEnum<{
+    hour: "hour";
+    day: "day";
+    week: "week";
+    month: "month";
+  }>;
+  timezone: z.ZodString;
+  series: z.ZodArray<z.ZodObject<{
+    date: z.ZodString;
+    count: z.ZodNumber;
+  }, z.core.$strip>>;
+  breakdown: z.ZodOptional<z.ZodArray<z.ZodObject<{
+    value: z.ZodString;
+    points: z.ZodArray<z.ZodObject<{
+      date: z.ZodString;
+      count: z.ZodNumber;
+    }, z.core.$strip>>;
+  }, z.core.$strip>>>;
+}, z.core.$strip>;
+type EventsTimeseriesData = z.infer<typeof zEventsTimeseriesData>;
+declare const zEventsTimeseriesResponse: z.ZodObject<{
+  data: z.ZodObject<{
     granularity: z.ZodEnum<{
-        month: "month";
-        day: "day";
-        hour: "hour";
-        week: "week";
+      hour: "hour";
+      day: "day";
+      week: "week";
+      month: "month";
     }>;
     timezone: z.ZodString;
     series: z.ZodArray<z.ZodObject<{
-        date: z.ZodString;
-        count: z.ZodNumber;
+      date: z.ZodString;
+      count: z.ZodNumber;
     }, z.core.$strip>>;
     breakdown: z.ZodOptional<z.ZodArray<z.ZodObject<{
-        value: z.ZodString;
-        points: z.ZodArray<z.ZodObject<{
-            date: z.ZodString;
-            count: z.ZodNumber;
-        }, z.core.$strip>>;
+      value: z.ZodString;
+      points: z.ZodArray<z.ZodObject<{
+        date: z.ZodString;
+        count: z.ZodNumber;
+      }, z.core.$strip>>;
     }, z.core.$strip>>>;
-}, z.core.$strip>;
-type EventsTimeseriesData = z.infer<typeof zEventsTimeseriesData>;
-declare const zEventsTimeseriesResponse: z.ZodObject<{
-    data: z.ZodObject<{
-        granularity: z.ZodEnum<{
-            month: "month";
-            day: "day";
-            hour: "hour";
-            week: "week";
-        }>;
-        timezone: z.ZodString;
-        series: z.ZodArray<z.ZodObject<{
-            date: z.ZodString;
-            count: z.ZodNumber;
-        }, z.core.$strip>>;
-        breakdown: z.ZodOptional<z.ZodArray<z.ZodObject<{
-            value: z.ZodString;
-            points: z.ZodArray<z.ZodObject<{
-                date: z.ZodString;
-                count: z.ZodNumber;
-            }, z.core.$strip>>;
-        }, z.core.$strip>>>;
-    }, z.core.$strip>;
-    meta: z.ZodObject<{
-        projectId: z.ZodString;
-        computedAt: z.ZodString;
-        cacheAgeSeconds: z.ZodNumber;
-        ingestLagSeconds: z.ZodNullable<z.ZodNumber>;
-        ingestLagStatus: z.ZodEnum<{
-            unknown: "unknown";
-            known: "known";
-        }>;
-        ingestDeadLetterCount: z.ZodNullable<z.ZodNumber>;
-        cached: z.ZodBoolean;
-        timezone: z.ZodString;
-        source: z.ZodEnum<{
-            raw: "raw";
-            rollup: "rollup";
-            mixed: "mixed";
-        }>;
-        requestId: z.ZodString;
-    }, z.core.$strip>;
+  }, z.core.$strip>;
+  meta: z.ZodObject<{
+    projectId: z.ZodString;
+    computedAt: z.ZodString;
+    cacheAgeSeconds: z.ZodNumber;
+    ingestLagSeconds: z.ZodNullable<z.ZodNumber>;
+    ingestLagStatus: z.ZodEnum<{
+      unknown: "unknown";
+      known: "known";
+    }>;
+    ingestDeadLetterCount: z.ZodNullable<z.ZodNumber>;
+    cached: z.ZodBoolean;
+    timezone: z.ZodString;
+    source: z.ZodEnum<{
+      rollup: "rollup";
+      raw: "raw";
+      mixed: "mixed";
+    }>;
+    requestId: z.ZodString;
+  }, z.core.$strip>;
 }, z.core.$strip>;
 type EventsTimeseriesResponse = z.infer<typeof zEventsTimeseriesResponse>;
 declare const zFunnelInput: z.ZodObject<{
-    projectId: z.ZodString;
-    steps: z.ZodArray<z.ZodString>;
-    startDate: z.ZodString;
-    endDate: z.ZodString;
-    windowSeconds: z.ZodDefault<z.ZodNumber>;
-    segmentId: z.ZodOptional<z.ZodString>;
-    channelFilter: z.ZodOptional<z.ZodObject<{
-        referrerTypes: z.ZodOptional<z.ZodArray<z.ZodString>>;
-        channelTypes: z.ZodOptional<z.ZodArray<z.ZodString>>;
-        utmSources: z.ZodOptional<z.ZodArray<z.ZodString>>;
-        utmMediums: z.ZodOptional<z.ZodArray<z.ZodString>>;
-        utmCampaigns: z.ZodOptional<z.ZodArray<z.ZodString>>;
-    }, z.core.$strip>>;
-    timezone: z.ZodOptional<z.ZodString>;
-    includeInternal: z.ZodDefault<z.ZodBoolean>;
+  projectId: z.ZodString;
+  steps: z.ZodArray<z.ZodString>;
+  startDate: z.ZodString;
+  endDate: z.ZodString;
+  windowSeconds: z.ZodDefault<z.ZodNumber>;
+  segmentId: z.ZodOptional<z.ZodString>;
+  channelFilter: z.ZodOptional<z.ZodObject<{
+    referrerTypes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    channelTypes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    utmSources: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    utmMediums: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    utmCampaigns: z.ZodOptional<z.ZodArray<z.ZodString>>;
+  }, z.core.$strip>>;
+  timezone: z.ZodOptional<z.ZodString>;
+  includeInternal: z.ZodDefault<z.ZodBoolean>;
 }, z.core.$strip>;
 type FunnelInput = z.input<typeof zFunnelInput>;
 declare const zFunnelStep: z.ZodObject<{
+  step: z.ZodNumber;
+  name: z.ZodString;
+  users: z.ZodNumber;
+  conversionRate: z.ZodNumber;
+  dropoffRate: z.ZodNumber;
+  dropoffUsers: z.ZodNumber;
+}, z.core.$strip>;
+declare const zFunnelData: z.ZodObject<{
+  steps: z.ZodArray<z.ZodObject<{
     step: z.ZodNumber;
     name: z.ZodString;
     users: z.ZodNumber;
     conversionRate: z.ZodNumber;
     dropoffRate: z.ZodNumber;
     dropoffUsers: z.ZodNumber;
+  }, z.core.$strip>>;
+  totalUsers: z.ZodNumber;
+  overallConversionRate: z.ZodNumber;
 }, z.core.$strip>;
-declare const zFunnelData: z.ZodObject<{
+type FunnelData = z.infer<typeof zFunnelData>;
+declare const zFunnelResponse: z.ZodObject<{
+  data: z.ZodObject<{
     steps: z.ZodArray<z.ZodObject<{
-        step: z.ZodNumber;
-        name: z.ZodString;
-        users: z.ZodNumber;
-        conversionRate: z.ZodNumber;
-        dropoffRate: z.ZodNumber;
-        dropoffUsers: z.ZodNumber;
+      step: z.ZodNumber;
+      name: z.ZodString;
+      users: z.ZodNumber;
+      conversionRate: z.ZodNumber;
+      dropoffRate: z.ZodNumber;
+      dropoffUsers: z.ZodNumber;
     }, z.core.$strip>>;
     totalUsers: z.ZodNumber;
     overallConversionRate: z.ZodNumber;
-}, z.core.$strip>;
-type FunnelData = z.infer<typeof zFunnelData>;
-declare const zFunnelResponse: z.ZodObject<{
-    data: z.ZodObject<{
-        steps: z.ZodArray<z.ZodObject<{
-            step: z.ZodNumber;
-            name: z.ZodString;
-            users: z.ZodNumber;
-            conversionRate: z.ZodNumber;
-            dropoffRate: z.ZodNumber;
-            dropoffUsers: z.ZodNumber;
-        }, z.core.$strip>>;
-        totalUsers: z.ZodNumber;
-        overallConversionRate: z.ZodNumber;
-    }, z.core.$strip>;
-    meta: z.ZodObject<{
-        projectId: z.ZodString;
-        computedAt: z.ZodString;
-        cacheAgeSeconds: z.ZodNumber;
-        ingestLagSeconds: z.ZodNullable<z.ZodNumber>;
-        ingestLagStatus: z.ZodEnum<{
-            unknown: "unknown";
-            known: "known";
-        }>;
-        ingestDeadLetterCount: z.ZodNullable<z.ZodNumber>;
-        cached: z.ZodBoolean;
-        timezone: z.ZodString;
-        source: z.ZodEnum<{
-            raw: "raw";
-            rollup: "rollup";
-            mixed: "mixed";
-        }>;
-        requestId: z.ZodString;
-    }, z.core.$strip>;
+  }, z.core.$strip>;
+  meta: z.ZodObject<{
+    projectId: z.ZodString;
+    computedAt: z.ZodString;
+    cacheAgeSeconds: z.ZodNumber;
+    ingestLagSeconds: z.ZodNullable<z.ZodNumber>;
+    ingestLagStatus: z.ZodEnum<{
+      unknown: "unknown";
+      known: "known";
+    }>;
+    ingestDeadLetterCount: z.ZodNullable<z.ZodNumber>;
+    cached: z.ZodBoolean;
+    timezone: z.ZodString;
+    source: z.ZodEnum<{
+      rollup: "rollup";
+      raw: "raw";
+      mixed: "mixed";
+    }>;
+    requestId: z.ZodString;
+  }, z.core.$strip>;
 }, z.core.$strip>;
 type FunnelResponse = z.infer<typeof zFunnelResponse>;
 declare const zRetentionInterval: z.ZodEnum<{
-    month: "month";
-    day: "day";
-    week: "week";
+  day: "day";
+  week: "week";
+  month: "month";
 }>;
 declare const zRetentionInput: z.ZodObject<{
-    projectId: z.ZodString;
-    startDate: z.ZodString;
-    endDate: z.ZodString;
-    interval: z.ZodDefault<z.ZodEnum<{
-        month: "month";
-        day: "day";
-        week: "week";
-    }>>;
-    periods: z.ZodDefault<z.ZodNumber>;
-    startEvent: z.ZodOptional<z.ZodString>;
-    returnEvent: z.ZodOptional<z.ZodString>;
-    retentionType: z.ZodDefault<z.ZodEnum<{
-        bounded: "bounded";
-        unbounded: "unbounded";
-    }>>;
-    cohortMode: z.ZodDefault<z.ZodEnum<{
-        "first-ever": "first-ever";
-        "first-in-window": "first-in-window";
-    }>>;
-    segmentId: z.ZodOptional<z.ZodString>;
-    channelFilter: z.ZodOptional<z.ZodObject<{
-        referrerTypes: z.ZodOptional<z.ZodArray<z.ZodString>>;
-        channelTypes: z.ZodOptional<z.ZodArray<z.ZodString>>;
-        utmSources: z.ZodOptional<z.ZodArray<z.ZodString>>;
-        utmMediums: z.ZodOptional<z.ZodArray<z.ZodString>>;
-        utmCampaigns: z.ZodOptional<z.ZodArray<z.ZodString>>;
-    }, z.core.$strip>>;
-    timezone: z.ZodOptional<z.ZodString>;
-    includeInternal: z.ZodDefault<z.ZodBoolean>;
+  projectId: z.ZodString;
+  startDate: z.ZodString;
+  endDate: z.ZodString;
+  interval: z.ZodDefault<z.ZodEnum<{
+    day: "day";
+    week: "week";
+    month: "month";
+  }>>;
+  periods: z.ZodDefault<z.ZodNumber>;
+  startEvent: z.ZodOptional<z.ZodString>;
+  returnEvent: z.ZodOptional<z.ZodString>;
+  retentionType: z.ZodDefault<z.ZodEnum<{
+    bounded: "bounded";
+    unbounded: "unbounded";
+  }>>;
+  cohortMode: z.ZodDefault<z.ZodEnum<{
+    "first-ever": "first-ever";
+    "first-in-window": "first-in-window";
+  }>>;
+  segmentId: z.ZodOptional<z.ZodString>;
+  channelFilter: z.ZodOptional<z.ZodObject<{
+    referrerTypes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    channelTypes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    utmSources: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    utmMediums: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    utmCampaigns: z.ZodOptional<z.ZodArray<z.ZodString>>;
+  }, z.core.$strip>>;
+  timezone: z.ZodOptional<z.ZodString>;
+  includeInternal: z.ZodDefault<z.ZodBoolean>;
 }, z.core.$strip>;
 type RetentionInput = z.input<typeof zRetentionInput>;
 declare const zRetentionCell: z.ZodObject<{
+  period: z.ZodNumber;
+  users: z.ZodNumber;
+  rate: z.ZodNumber;
+}, z.core.$strip>;
+declare const zRetentionData: z.ZodObject<{
+  matrix: z.ZodArray<z.ZodObject<{
+    cohortDate: z.ZodString;
+    cohortSize: z.ZodNumber;
+    retention: z.ZodArray<z.ZodObject<{
+      period: z.ZodNumber;
+      users: z.ZodNumber;
+      rate: z.ZodNumber;
+    }, z.core.$strip>>;
+  }, z.core.$strip>>;
+  averageRetention: z.ZodArray<z.ZodObject<{
     period: z.ZodNumber;
-    users: z.ZodNumber;
     rate: z.ZodNumber;
+  }, z.core.$strip>>;
+  interval: z.ZodEnum<{
+    day: "day";
+    week: "week";
+    month: "month";
+  }>;
+  periods: z.ZodNumber;
+  retentionType: z.ZodEnum<{
+    bounded: "bounded";
+    unbounded: "unbounded";
+  }>;
+  timezone: z.ZodString;
 }, z.core.$strip>;
-declare const zRetentionData: z.ZodObject<{
+type RetentionData = z.infer<typeof zRetentionData>;
+declare const zRetentionResponse: z.ZodObject<{
+  data: z.ZodObject<{
     matrix: z.ZodArray<z.ZodObject<{
-        cohortDate: z.ZodString;
-        cohortSize: z.ZodNumber;
-        retention: z.ZodArray<z.ZodObject<{
-            period: z.ZodNumber;
-            users: z.ZodNumber;
-            rate: z.ZodNumber;
-        }, z.core.$strip>>;
-    }, z.core.$strip>>;
-    averageRetention: z.ZodArray<z.ZodObject<{
+      cohortDate: z.ZodString;
+      cohortSize: z.ZodNumber;
+      retention: z.ZodArray<z.ZodObject<{
         period: z.ZodNumber;
+        users: z.ZodNumber;
         rate: z.ZodNumber;
+      }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    averageRetention: z.ZodArray<z.ZodObject<{
+      period: z.ZodNumber;
+      rate: z.ZodNumber;
     }, z.core.$strip>>;
     interval: z.ZodEnum<{
-        month: "month";
-        day: "day";
-        week: "week";
+      day: "day";
+      week: "week";
+      month: "month";
     }>;
     periods: z.ZodNumber;
     retentionType: z.ZodEnum<{
-        bounded: "bounded";
-        unbounded: "unbounded";
+      bounded: "bounded";
+      unbounded: "unbounded";
     }>;
     timezone: z.ZodString;
-}, z.core.$strip>;
-type RetentionData = z.infer<typeof zRetentionData>;
-declare const zRetentionResponse: z.ZodObject<{
-    data: z.ZodObject<{
-        matrix: z.ZodArray<z.ZodObject<{
-            cohortDate: z.ZodString;
-            cohortSize: z.ZodNumber;
-            retention: z.ZodArray<z.ZodObject<{
-                period: z.ZodNumber;
-                users: z.ZodNumber;
-                rate: z.ZodNumber;
-            }, z.core.$strip>>;
-        }, z.core.$strip>>;
-        averageRetention: z.ZodArray<z.ZodObject<{
-            period: z.ZodNumber;
-            rate: z.ZodNumber;
-        }, z.core.$strip>>;
-        interval: z.ZodEnum<{
-            month: "month";
-            day: "day";
-            week: "week";
-        }>;
-        periods: z.ZodNumber;
-        retentionType: z.ZodEnum<{
-            bounded: "bounded";
-            unbounded: "unbounded";
-        }>;
-        timezone: z.ZodString;
-    }, z.core.$strip>;
-    meta: z.ZodObject<{
-        projectId: z.ZodString;
-        computedAt: z.ZodString;
-        cacheAgeSeconds: z.ZodNumber;
-        ingestLagSeconds: z.ZodNullable<z.ZodNumber>;
-        ingestLagStatus: z.ZodEnum<{
-            unknown: "unknown";
-            known: "known";
-        }>;
-        ingestDeadLetterCount: z.ZodNullable<z.ZodNumber>;
-        cached: z.ZodBoolean;
-        timezone: z.ZodString;
-        source: z.ZodEnum<{
-            raw: "raw";
-            rollup: "rollup";
-            mixed: "mixed";
-        }>;
-        requestId: z.ZodString;
-    }, z.core.$strip>;
+  }, z.core.$strip>;
+  meta: z.ZodObject<{
+    projectId: z.ZodString;
+    computedAt: z.ZodString;
+    cacheAgeSeconds: z.ZodNumber;
+    ingestLagSeconds: z.ZodNullable<z.ZodNumber>;
+    ingestLagStatus: z.ZodEnum<{
+      unknown: "unknown";
+      known: "known";
+    }>;
+    ingestDeadLetterCount: z.ZodNullable<z.ZodNumber>;
+    cached: z.ZodBoolean;
+    timezone: z.ZodString;
+    source: z.ZodEnum<{
+      rollup: "rollup";
+      raw: "raw";
+      mixed: "mixed";
+    }>;
+    requestId: z.ZodString;
+  }, z.core.$strip>;
 }, z.core.$strip>;
 type RetentionResponse = z.infer<typeof zRetentionResponse>;
 /**
@@ -427,125 +413,147 @@ type RetentionResponse = z.infer<typeof zRetentionResponse>;
  * "visitor" is the vocabulary the dashboards already use.
  */
 declare const zTrafficOverviewInput: z.ZodObject<{
-    projectId: z.ZodString;
-    startDate: z.ZodString;
-    endDate: z.ZodString;
-    granularity: z.ZodDefault<z.ZodEnum<{
-        month: "month";
-        day: "day";
-        hour: "hour";
-        week: "week";
-    }>>;
-    timezone: z.ZodOptional<z.ZodString>;
+  projectId: z.ZodString;
+  startDate: z.ZodString;
+  endDate: z.ZodString;
+  granularity: z.ZodDefault<z.ZodEnum<{
+    hour: "hour";
+    day: "day";
+    week: "week";
+    month: "month";
+  }>>;
+  timezone: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 type TrafficOverviewInput = z.input<typeof zTrafficOverviewInput>;
 declare const zTrafficTotals: z.ZodObject<{
+  sessions: z.ZodNumber;
+  pageviews: z.ZodNumber;
+  newVisitors: z.ZodNumber;
+  returningVisitors: z.ZodNumber;
+  bounceRate: z.ZodNumber;
+}, z.core.$strip>;
+type TrafficTotals = z.infer<typeof zTrafficTotals>;
+declare const zTrafficSeriesPoint: z.ZodObject<{
+  sessions: z.ZodNumber;
+  pageviews: z.ZodNumber;
+  newVisitors: z.ZodNumber;
+  returningVisitors: z.ZodNumber;
+  bounceRate: z.ZodNumber;
+  date: z.ZodString;
+}, z.core.$strip>;
+declare const zTrafficOverviewData: z.ZodObject<{
+  granularity: z.ZodEnum<{
+    hour: "hour";
+    day: "day";
+    week: "week";
+    month: "month";
+  }>;
+  timezone: z.ZodString;
+  totals: z.ZodObject<{
     sessions: z.ZodNumber;
     pageviews: z.ZodNumber;
     newVisitors: z.ZodNumber;
     returningVisitors: z.ZodNumber;
     bounceRate: z.ZodNumber;
-}, z.core.$strip>;
-type TrafficTotals = z.infer<typeof zTrafficTotals>;
-declare const zTrafficSeriesPoint: z.ZodObject<{
+  }, z.core.$strip>;
+  series: z.ZodArray<z.ZodObject<{
     sessions: z.ZodNumber;
     pageviews: z.ZodNumber;
     newVisitors: z.ZodNumber;
     returningVisitors: z.ZodNumber;
     bounceRate: z.ZodNumber;
     date: z.ZodString;
+  }, z.core.$strip>>;
 }, z.core.$strip>;
-declare const zTrafficOverviewData: z.ZodObject<{
+type TrafficOverviewData = z.infer<typeof zTrafficOverviewData>;
+declare const zTrafficOverviewResponse: z.ZodObject<{
+  data: z.ZodObject<{
     granularity: z.ZodEnum<{
-        month: "month";
-        day: "day";
-        hour: "hour";
-        week: "week";
+      hour: "hour";
+      day: "day";
+      week: "week";
+      month: "month";
     }>;
     timezone: z.ZodString;
     totals: z.ZodObject<{
-        sessions: z.ZodNumber;
-        pageviews: z.ZodNumber;
-        newVisitors: z.ZodNumber;
-        returningVisitors: z.ZodNumber;
-        bounceRate: z.ZodNumber;
+      sessions: z.ZodNumber;
+      pageviews: z.ZodNumber;
+      newVisitors: z.ZodNumber;
+      returningVisitors: z.ZodNumber;
+      bounceRate: z.ZodNumber;
     }, z.core.$strip>;
     series: z.ZodArray<z.ZodObject<{
-        sessions: z.ZodNumber;
-        pageviews: z.ZodNumber;
-        newVisitors: z.ZodNumber;
-        returningVisitors: z.ZodNumber;
-        bounceRate: z.ZodNumber;
-        date: z.ZodString;
+      sessions: z.ZodNumber;
+      pageviews: z.ZodNumber;
+      newVisitors: z.ZodNumber;
+      returningVisitors: z.ZodNumber;
+      bounceRate: z.ZodNumber;
+      date: z.ZodString;
     }, z.core.$strip>>;
-}, z.core.$strip>;
-type TrafficOverviewData = z.infer<typeof zTrafficOverviewData>;
-declare const zTrafficOverviewResponse: z.ZodObject<{
-    data: z.ZodObject<{
-        granularity: z.ZodEnum<{
-            month: "month";
-            day: "day";
-            hour: "hour";
-            week: "week";
-        }>;
-        timezone: z.ZodString;
-        totals: z.ZodObject<{
-            sessions: z.ZodNumber;
-            pageviews: z.ZodNumber;
-            newVisitors: z.ZodNumber;
-            returningVisitors: z.ZodNumber;
-            bounceRate: z.ZodNumber;
-        }, z.core.$strip>;
-        series: z.ZodArray<z.ZodObject<{
-            sessions: z.ZodNumber;
-            pageviews: z.ZodNumber;
-            newVisitors: z.ZodNumber;
-            returningVisitors: z.ZodNumber;
-            bounceRate: z.ZodNumber;
-            date: z.ZodString;
-        }, z.core.$strip>>;
-    }, z.core.$strip>;
-    meta: z.ZodObject<{
-        projectId: z.ZodString;
-        computedAt: z.ZodString;
-        cacheAgeSeconds: z.ZodNumber;
-        ingestLagSeconds: z.ZodNullable<z.ZodNumber>;
-        ingestLagStatus: z.ZodEnum<{
-            unknown: "unknown";
-            known: "known";
-        }>;
-        ingestDeadLetterCount: z.ZodNullable<z.ZodNumber>;
-        cached: z.ZodBoolean;
-        timezone: z.ZodString;
-        source: z.ZodEnum<{
-            raw: "raw";
-            rollup: "rollup";
-            mixed: "mixed";
-        }>;
-        requestId: z.ZodString;
-    }, z.core.$strip>;
+  }, z.core.$strip>;
+  meta: z.ZodObject<{
+    projectId: z.ZodString;
+    computedAt: z.ZodString;
+    cacheAgeSeconds: z.ZodNumber;
+    ingestLagSeconds: z.ZodNullable<z.ZodNumber>;
+    ingestLagStatus: z.ZodEnum<{
+      unknown: "unknown";
+      known: "known";
+    }>;
+    ingestDeadLetterCount: z.ZodNullable<z.ZodNumber>;
+    cached: z.ZodBoolean;
+    timezone: z.ZodString;
+    source: z.ZodEnum<{
+      rollup: "rollup";
+      raw: "raw";
+      mixed: "mixed";
+    }>;
+    requestId: z.ZodString;
+  }, z.core.$strip>;
 }, z.core.$strip>;
 type TrafficOverviewResponse = z.infer<typeof zTrafficOverviewResponse>;
 declare const zTrafficDimension: z.ZodEnum<{
-    referrer: "referrer";
-    channel: "channel";
-    utm: "utm";
+  referrer: "referrer";
+  channel: "channel";
+  utm: "utm";
 }>;
 type TrafficDimension = z.infer<typeof zTrafficDimension>;
 declare const zTrafficSourcesInput: z.ZodObject<{
-    projectId: z.ZodString;
-    startDate: z.ZodString;
-    endDate: z.ZodString;
-    dimension: z.ZodEnum<{
-        referrer: "referrer";
-        channel: "channel";
-        utm: "utm";
-    }>;
-    limit: z.ZodDefault<z.ZodNumber>;
-    timezone: z.ZodOptional<z.ZodString>;
+  projectId: z.ZodString;
+  startDate: z.ZodString;
+  endDate: z.ZodString;
+  dimension: z.ZodEnum<{
+    referrer: "referrer";
+    channel: "channel";
+    utm: "utm";
+  }>;
+  limit: z.ZodDefault<z.ZodNumber>;
+  timezone: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 type TrafficSourcesInput = z.input<typeof zTrafficSourcesInput>;
 declare const zTrafficSourceRow: z.ZodObject<{
+  sessions: z.ZodNumber;
+  pageviews: z.ZodNumber;
+  newVisitors: z.ZodNumber;
+  returningVisitors: z.ZodNumber;
+  bounceRate: z.ZodNumber;
+  key: z.ZodString;
+  channelType: z.ZodOptional<z.ZodString>;
+  referrerName: z.ZodOptional<z.ZodString>;
+  referrerType: z.ZodOptional<z.ZodString>;
+  utmSource: z.ZodOptional<z.ZodString>;
+  utmMedium: z.ZodOptional<z.ZodString>;
+  utmCampaign: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+type TrafficSourceRow = z.infer<typeof zTrafficSourceRow>;
+declare const zTrafficSourcesData: z.ZodObject<{
+  dimension: z.ZodEnum<{
+    referrer: "referrer";
+    channel: "channel";
+    utm: "utm";
+  }>;
+  timezone: z.ZodString;
+  rows: z.ZodArray<z.ZodObject<{
     sessions: z.ZodNumber;
     pageviews: z.ZodNumber;
     newVisitors: z.ZodNumber;
@@ -558,77 +566,69 @@ declare const zTrafficSourceRow: z.ZodObject<{
     utmSource: z.ZodOptional<z.ZodString>;
     utmMedium: z.ZodOptional<z.ZodString>;
     utmCampaign: z.ZodOptional<z.ZodString>;
+  }, z.core.$strip>>;
 }, z.core.$strip>;
-type TrafficSourceRow = z.infer<typeof zTrafficSourceRow>;
-declare const zTrafficSourcesData: z.ZodObject<{
+type TrafficSourcesData = z.infer<typeof zTrafficSourcesData>;
+declare const zTrafficSourcesResponse: z.ZodObject<{
+  data: z.ZodObject<{
     dimension: z.ZodEnum<{
-        referrer: "referrer";
-        channel: "channel";
-        utm: "utm";
+      referrer: "referrer";
+      channel: "channel";
+      utm: "utm";
     }>;
     timezone: z.ZodString;
     rows: z.ZodArray<z.ZodObject<{
-        sessions: z.ZodNumber;
-        pageviews: z.ZodNumber;
-        newVisitors: z.ZodNumber;
-        returningVisitors: z.ZodNumber;
-        bounceRate: z.ZodNumber;
-        key: z.ZodString;
-        channelType: z.ZodOptional<z.ZodString>;
-        referrerName: z.ZodOptional<z.ZodString>;
-        referrerType: z.ZodOptional<z.ZodString>;
-        utmSource: z.ZodOptional<z.ZodString>;
-        utmMedium: z.ZodOptional<z.ZodString>;
-        utmCampaign: z.ZodOptional<z.ZodString>;
+      sessions: z.ZodNumber;
+      pageviews: z.ZodNumber;
+      newVisitors: z.ZodNumber;
+      returningVisitors: z.ZodNumber;
+      bounceRate: z.ZodNumber;
+      key: z.ZodString;
+      channelType: z.ZodOptional<z.ZodString>;
+      referrerName: z.ZodOptional<z.ZodString>;
+      referrerType: z.ZodOptional<z.ZodString>;
+      utmSource: z.ZodOptional<z.ZodString>;
+      utmMedium: z.ZodOptional<z.ZodString>;
+      utmCampaign: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>;
-}, z.core.$strip>;
-type TrafficSourcesData = z.infer<typeof zTrafficSourcesData>;
-declare const zTrafficSourcesResponse: z.ZodObject<{
-    data: z.ZodObject<{
-        dimension: z.ZodEnum<{
-            referrer: "referrer";
-            channel: "channel";
-            utm: "utm";
-        }>;
-        timezone: z.ZodString;
-        rows: z.ZodArray<z.ZodObject<{
-            sessions: z.ZodNumber;
-            pageviews: z.ZodNumber;
-            newVisitors: z.ZodNumber;
-            returningVisitors: z.ZodNumber;
-            bounceRate: z.ZodNumber;
-            key: z.ZodString;
-            channelType: z.ZodOptional<z.ZodString>;
-            referrerName: z.ZodOptional<z.ZodString>;
-            referrerType: z.ZodOptional<z.ZodString>;
-            utmSource: z.ZodOptional<z.ZodString>;
-            utmMedium: z.ZodOptional<z.ZodString>;
-            utmCampaign: z.ZodOptional<z.ZodString>;
-        }, z.core.$strip>>;
-    }, z.core.$strip>;
-    meta: z.ZodObject<{
-        projectId: z.ZodString;
-        computedAt: z.ZodString;
-        cacheAgeSeconds: z.ZodNumber;
-        ingestLagSeconds: z.ZodNullable<z.ZodNumber>;
-        ingestLagStatus: z.ZodEnum<{
-            unknown: "unknown";
-            known: "known";
-        }>;
-        ingestDeadLetterCount: z.ZodNullable<z.ZodNumber>;
-        cached: z.ZodBoolean;
-        timezone: z.ZodString;
-        source: z.ZodEnum<{
-            raw: "raw";
-            rollup: "rollup";
-            mixed: "mixed";
-        }>;
-        requestId: z.ZodString;
-    }, z.core.$strip>;
+  }, z.core.$strip>;
+  meta: z.ZodObject<{
+    projectId: z.ZodString;
+    computedAt: z.ZodString;
+    cacheAgeSeconds: z.ZodNumber;
+    ingestLagSeconds: z.ZodNullable<z.ZodNumber>;
+    ingestLagStatus: z.ZodEnum<{
+      unknown: "unknown";
+      known: "known";
+    }>;
+    ingestDeadLetterCount: z.ZodNullable<z.ZodNumber>;
+    cached: z.ZodBoolean;
+    timezone: z.ZodString;
+    source: z.ZodEnum<{
+      rollup: "rollup";
+      raw: "raw";
+      mixed: "mixed";
+    }>;
+    requestId: z.ZodString;
+  }, z.core.$strip>;
 }, z.core.$strip>;
 type TrafficSourcesResponse = z.infer<typeof zTrafficSourcesResponse>;
 declare const QUERY_ERROR_CODES: readonly ["unauthorized", "project_scope_mismatch", "query_scope_missing", "validation_failed", "unsupported_combination", "project_purging", "rate_limited", "query_timeout", "internal_error"];
 declare const zQueryErrorCode: z.ZodEnum<{
+  validation_failed: "validation_failed";
+  unauthorized: "unauthorized";
+  rate_limited: "rate_limited";
+  project_purging: "project_purging";
+  internal_error: "internal_error";
+  project_scope_mismatch: "project_scope_mismatch";
+  query_scope_missing: "query_scope_missing";
+  unsupported_combination: "unsupported_combination";
+  query_timeout: "query_timeout";
+}>;
+type QueryErrorCode = z.infer<typeof zQueryErrorCode>;
+declare const zQueryError: z.ZodObject<{
+  status: z.ZodNumber;
+  code: z.ZodEnum<{
     validation_failed: "validation_failed";
     unauthorized: "unauthorized";
     rate_limited: "rate_limited";
@@ -638,34 +638,21 @@ declare const zQueryErrorCode: z.ZodEnum<{
     query_scope_missing: "query_scope_missing";
     unsupported_combination: "unsupported_combination";
     query_timeout: "query_timeout";
-}>;
-type QueryErrorCode = z.infer<typeof zQueryErrorCode>;
-declare const zQueryError: z.ZodObject<{
-    status: z.ZodNumber;
-    code: z.ZodEnum<{
-        validation_failed: "validation_failed";
-        unauthorized: "unauthorized";
-        rate_limited: "rate_limited";
-        project_purging: "project_purging";
-        internal_error: "internal_error";
-        project_scope_mismatch: "project_scope_mismatch";
-        query_scope_missing: "query_scope_missing";
-        unsupported_combination: "unsupported_combination";
-        query_timeout: "query_timeout";
-    }>;
-    error: z.ZodString;
-    message: z.ZodOptional<z.ZodString>;
-    errors: z.ZodOptional<z.ZodUnknown>;
-    requestId: z.ZodOptional<z.ZodString>;
+  }>;
+  error: z.ZodString;
+  message: z.ZodOptional<z.ZodString>;
+  errors: z.ZodOptional<z.ZodUnknown>;
+  requestId: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 type QueryError = z.infer<typeof zQueryError>;
 /** Paths, so the client and the route handlers cannot drift apart. */
 declare const QUERY_API_PATHS: {
-    readonly eventsTimeseries: "/api/v1/query/events/timeseries";
-    readonly funnel: "/api/v1/query/funnel";
-    readonly retention: "/api/v1/query/retention";
-    readonly trafficOverview: "/api/v1/query/traffic/overview";
-    readonly trafficSources: "/api/v1/query/traffic/sources";
+  readonly eventsTimeseries: "/api/v1/query/events/timeseries";
+  readonly funnel: "/api/v1/query/funnel";
+  readonly retention: "/api/v1/query/retention";
+  readonly trafficOverview: "/api/v1/query/traffic/overview";
+  readonly trafficSources: "/api/v1/query/traffic/sources";
 };
-
-export { type ChannelFilter, type EventPropertyFilter, type EventsTimeseriesData, type EventsTimeseriesInput, type EventsTimeseriesResponse, type FunnelData, type FunnelInput, type FunnelResponse, type Granularity, QUERY_API_PATHS, QUERY_ERROR_CODES, type QueryError, type QueryErrorCode, type QueryMeta, type QuerySource, type RetentionData, type RetentionInput, type RetentionResponse, type TimeseriesBreakdown, type TimeseriesPoint, type TrafficDimension, type TrafficOverviewData, type TrafficOverviewInput, type TrafficOverviewResponse, type TrafficSourceRow, type TrafficSourcesData, type TrafficSourcesInput, type TrafficSourcesResponse, type TrafficTotals, isValidTimeZone, zBucketStart, zChannelFilter, zEventPropertyFilter, zEventsTimeseriesData, zEventsTimeseriesInput, zEventsTimeseriesResponse, zFunnelData, zFunnelInput, zFunnelResponse, zFunnelStep, zGranularity, zQueryEnvelope, zQueryError, zQueryErrorCode, zQueryMeta, zQuerySource, zRetentionCell, zRetentionData, zRetentionInput, zRetentionInterval, zRetentionResponse, zTimeseriesBreakdown, zTimeseriesPoint, zTimezone, zTrafficDimension, zTrafficOverviewData, zTrafficOverviewInput, zTrafficOverviewResponse, zTrafficSeriesPoint, zTrafficSourceRow, zTrafficSourcesData, zTrafficSourcesInput, zTrafficSourcesResponse, zTrafficTotals };
+//#endregion
+export { ChannelFilter, EventPropertyFilter, EventsTimeseriesData, EventsTimeseriesInput, EventsTimeseriesResponse, FunnelData, FunnelInput, FunnelResponse, Granularity, QUERY_API_PATHS, QUERY_ERROR_CODES, QueryError, QueryErrorCode, QueryMeta, QuerySource, RetentionData, RetentionInput, RetentionResponse, TimeseriesBreakdown, TimeseriesPoint, TrafficDimension, TrafficOverviewData, TrafficOverviewInput, TrafficOverviewResponse, TrafficSourceRow, TrafficSourcesData, TrafficSourcesInput, TrafficSourcesResponse, TrafficTotals, isValidTimeZone, zBucketStart, zChannelFilter, zDate, zEventPropertyFilter, zEventsTimeseriesData, zEventsTimeseriesInput, zEventsTimeseriesResponse, zFunnelData, zFunnelInput, zFunnelResponse, zFunnelStep, zGranularity, zInstant, zQueryEnvelope, zQueryError, zQueryErrorCode, zQueryMeta, zQuerySource, zRetentionCell, zRetentionData, zRetentionInput, zRetentionInterval, zRetentionResponse, zTimeseriesBreakdown, zTimeseriesPoint, zTimezone, zTrafficDimension, zTrafficOverviewData, zTrafficOverviewInput, zTrafficOverviewResponse, zTrafficSeriesPoint, zTrafficSourceRow, zTrafficSourcesData, zTrafficSourcesInput, zTrafficSourcesResponse, zTrafficTotals };
+//# sourceMappingURL=query.d.cts.map