@iann29/rastro 0.1.0-alpha.1 → 0.1.0-alpha.11

package/dist/client/index.d.ts

@@ -1,8 +1,16 @@
 import type { FunctionArgs, FunctionReturnType, GenericActionCtx, GenericDataModel, GenericMutationCtx, GenericQueryCtx } from "convex/server";
+import { type Infer } from "convex/values";
 import type { ComponentApi } from "../component/_generated/component.js";
-import { eventPropertiesValidator, eventTypeValidator, funnelStepValidator, goalMatchTypeValidator, ingestContextValidator, ingestResultValidator, trackerEventValidator } from "../component/validators.js";
-export { eventPropertiesValidator, eventTypeValidator, funnelStepValidator, goalMatchTypeValidator, ingestContextValidator, ingestResultValidator, trackerEventValidator, };
+import { eventPropertiesValidator, eventTypeValidator, funnelStepValidator, goalMatchTypeValidator, ingestContextValidator, ingestResultValidator, trackerEventValidator, vitalMetricValidator } from "../component/validators.js";
+import { type FederatedAnalyticsAuthorizerOptions, type FederatedAnalyticsConnectionStatus, type FederatedSiteSummary } from "./federation.js";
+export { eventPropertiesValidator, eventTypeValidator, funnelStepValidator, goalMatchTypeValidator, ingestContextValidator, ingestResultValidator, trackerEventValidator, vitalMetricValidator, };
 export type { EventProperties, EventType, FunnelStep, IngestContext, TrackerEvent, } from "../component/validators.js";
+export { VITAL_METRICS, VITAL_THRESHOLDS } from "../component/vitals.js";
+export { normalizeRoute } from "../component/sanitize.js";
+export { localDayStart, nextLocalDayStart, previousLocalDayStart, } from "../component/localTime.js";
+export type { VitalMetric } from "../component/vitals.js";
+export { effectiveFederatedPermissions, FEDERATED_ANALYTICS_CLAIMS, FEDERATED_ANALYTICS_CONFIGURE_FUNCTIONS, FEDERATED_ANALYTICS_CONFIGURE_PERMISSION, FEDERATED_ANALYTICS_CONNECTOR_MANIFEST, FEDERATED_ANALYTICS_ERROR_CODES, FEDERATED_ANALYTICS_PERMISSIONS, FEDERATED_ANALYTICS_READ_PERMISSION, FEDERATED_ANALYTICS_REQUIRED_CAPABILITIES, FEDERATED_ANALYTICS_REQUIRED_FUNCTIONS, federatedAnalyticsPermissionValidator, } from "./federation.js";
+export type { FederatedAnalyticsCapability, FederatedAnalyticsAuthorizerOptions, FederatedAnalyticsConnection, FederatedAnalyticsConnectionStatus, FederatedAnalyticsErrorCode, FederatedAnalyticsIdentity, FederatedAnalyticsManifest, FederatedAnalyticsPermission, FederatedSiteSummary, ResolveFederatedAnalyticsConnection, } from "./federation.js";
 export type CreateSiteInput = FunctionArgs<ComponentApi["sites"]["create"]>;
 export type CreateSiteOutput = FunctionReturnType<ComponentApi["sites"]["create"]>;
 export type UpdateSiteInput = FunctionArgs<ComponentApi["sites"]["update"]>;
@@ -14,8 +22,10 @@ export type IngestInput = FunctionArgs<ComponentApi["ingest"]["ingestBatch"]>;
 export type IngestResult = FunctionReturnType<ComponentApi["ingest"]["ingestBatch"]>;
 export type TrackConversionInput = Omit<FunctionArgs<ComponentApi["ingest"]["trackConversion"]>, "affiliateSlug">;
 export type TrackConversionOutput = FunctionReturnType<ComponentApi["ingest"]["trackConversion"]>;
+export type LinkVisitorInput = FunctionArgs<ComponentApi["visitors"]["link"]>;
+export type LinkVisitorOutput = FunctionReturnType<ComponentApi["visitors"]["link"]>;
 export type OverviewInput = FunctionArgs<ComponentApi["reports"]["overview"]>;
-export type Overview = FunctionReturnType<ComponentApi["reports"]["overview"]>;
+export type Overview = Infer<typeof hostOverviewValidator>;
 export type LiveVisitorsInput = FunctionArgs<ComponentApi["reports"]["liveVisitors"]>;
 export type LiveVisitor = FunctionReturnType<ComponentApi["reports"]["liveVisitors"]>[number];
 export type ListSessionsInput = FunctionArgs<ComponentApi["reports"]["listSessions"]>;
@@ -27,11 +37,15 @@ export type ConversionsPage = FunctionReturnType<ComponentApi["reports"]["listCo
 export type VisitorJourneyInput = FunctionArgs<ComponentApi["reports"]["visitorJourney"]>;
 export type VisitorJourney = FunctionReturnType<ComponentApi["reports"]["visitorJourney"]>;
 export type GoalsReportInput = FunctionArgs<ComponentApi["reports"]["goalsReport"]>;
-export type GoalsReport = FunctionReturnType<ComponentApi["reports"]["goalsReport"]>;
+export type GoalsReport = Infer<typeof hostGoalsReportValidator>;
 export type FunnelsReportInput = FunctionArgs<ComponentApi["reports"]["funnelsReport"]>;
-export type FunnelsReport = FunctionReturnType<ComponentApi["reports"]["funnelsReport"]>;
+export type FunnelsReport = Infer<typeof hostFunnelsReportValidator>;
 export type AffiliatesReportInput = FunctionArgs<ComponentApi["reports"]["affiliatesReport"]>;
-export type AffiliatesReport = FunctionReturnType<ComponentApi["reports"]["affiliatesReport"]>;
+export type AffiliatesReport = Infer<typeof hostAffiliatesReportValidator>;
+export type VitalsReportInput = FunctionArgs<ComponentApi["reports"]["vitalsReport"]>;
+export type VitalsReport = Infer<typeof hostVitalsReportValidator>;
+export type SiteMapInput = FunctionArgs<ComponentApi["reports"]["siteMap"]>;
+export type SiteMap = Infer<typeof hostSiteMapValidator>;
 export type UpsertGoalInput = FunctionArgs<ComponentApi["goals"]["upsert"]>;
 export type UpsertGoalOutput = FunctionReturnType<ComponentApi["goals"]["upsert"]>;
 export type Goal = FunctionReturnType<ComponentApi["goals"]["list"]>[number];
@@ -41,8 +55,66 @@ export type Funnel = FunctionReturnType<ComponentApi["funnels"]["list"]>[number]
 export type UpsertAffiliateInput = FunctionArgs<ComponentApi["affiliates"]["upsert"]>;
 export type UpsertAffiliateOutput = FunctionReturnType<ComponentApi["affiliates"]["upsert"]>;
 export type Affiliate = FunctionReturnType<ComponentApi["affiliates"]["list"]>[number];
-export type CleanupInput = FunctionArgs<ComponentApi["retention"]["cleanup"]>;
-export type CleanupOutput = FunctionReturnType<ComponentApi["retention"]["cleanup"]>;
+export type CleanupInput = {
+    siteId: string;
+    kind: RetentionKind;
+    before: number;
+    batchSize?: number;
+};
+export type CleanupOutput = {
+    deleted: number;
+    hasMore: boolean;
+    before: number;
+};
+export type DataCoverageInput = {
+    siteId: string;
+    from: number;
+    to: number;
+};
+export type DataCoverage = {
+    siteId: string;
+    from: number;
+    to: number;
+    datasets: Array<{
+        dataset: "overviewHour" | "overviewDay" | "overviewLocalDay" | "events" | "sessions" | "conversions" | "goals" | "funnels" | "affiliates" | "vitals" | "siteMap";
+        coverage: CoverageStatus;
+    }>;
+};
+export type CoverageStatus = {
+    state: "complete" | "partial" | "retained" | "unavailable";
+    generation: number | null;
+    availableFrom: number | null;
+    availableThrough: number | null;
+    retainedBefore: number | null;
+};
+export type RetentionPolicyInput = {
+    siteId: string;
+    eventsDays: number;
+    sessionsDays: number;
+    conversionsDays: number;
+    aggregatesDays: number;
+    reportsDays: number;
+};
+export type RetentionStatus = {
+    policy: (Omit<RetentionPolicyInput, "siteId"> & {
+        updatedAt: number;
+    }) | null;
+    jobs: Array<{
+        kind: string;
+        before: number;
+        status: "pending" | "running" | "complete";
+        deleted: number;
+        scheduledAt: number | null;
+        updatedAt: number;
+    }>;
+    backlog: number;
+};
+export type RetentionKind = "events" | "sessions" | "conversions" | "goalCompletions" | "aggregateHour" | "aggregateDay" | "funnelProgress" | "funnelSteps" | "affiliateStats" | "goalRollups" | "funnelRollups" | "affiliateRollups" | "vitalRollups" | "siteMapRollups" | "attributions" | "liveSessions" | "ingestWindows" | "siteIngestWindows";
+export type RunRetentionPolicyInput = {
+    siteId: string;
+    kind: RetentionKind;
+    batchSize?: number;
+};
 export declare class Rastro {
     private readonly component;
     constructor(component: ComponentApi);
@@ -61,6 +133,11 @@ export declare class Rastro {
         timezone?: string;
         updatedAt: number;
     } | null>;
+    /** The calendar days a site's daily overview answers in; see `sites.localDays`. */
+    localDays(ctx: QueryCtx | MutationCtx | ActionCtx, siteId: string): Promise<{
+        since: number;
+        timezone: string;
+    } | null>;
     listSites(ctx: QueryCtx | MutationCtx | ActionCtx, args: ListSitesInput): Promise<{
         _creationTime: number;
         _id: string;
@@ -84,15 +161,61 @@ export declare class Rastro {
         duplicates: number;
         rejected: number;
     }>;
+    linkVisitor(ctx: MutationCtx, args: LinkVisitorInput): Promise<{
+        aliasCount: number;
+        linked: boolean;
+    }>;
     overview(ctx: QueryCtx | MutationCtx | ActionCtx, args: OverviewInput): Promise<{
         currency: string;
         from: number;
         interval: "hour" | "day";
+        metadata: {
+            breakdowns: {
+                topBrowsers: "pageviews" | "sessions" | "eventVolume";
+                topCampaigns: "pageviews" | "sessions" | "eventVolume";
+                topCountries: "pageviews" | "sessions" | "eventVolume";
+                topDevices: "pageviews" | "sessions" | "eventVolume";
+                topEvents: "eventVolume";
+                topGoals: "goalCompletionVolume";
+                topPages: "pageviews" | "sessions" | "eventVolume";
+                topSources: "pageviews" | "sessions" | "eventVolume";
+            };
+            coverage: {
+                availableFrom: number | null;
+                availableThrough: number | null;
+                generation: number | null;
+                retainedBefore: number | null;
+                state: "complete" | "partial" | "retained" | "unavailable";
+            };
+            engagement: "counted" | "unavailable";
+            features: {
+                botDetection: "userAgent";
+                errorInsights: "unsupported";
+                outboundLinks: "eventVolume";
+                sessionReplay: "unsupported";
+            };
+            range: {
+                boundary: "inclusive";
+                from: number;
+                timezone: string;
+                to: number;
+            };
+            visitors: {
+                basis: "estimatedUnique" | "bucketOccurrences";
+                exact: boolean;
+                legacyIncomplete: boolean;
+                precision: number | null;
+                sketchVersion: number | null;
+            };
+        };
         timeSeries: Array<{
             clicks: number;
+            continuedSessions: number;
             conversions: number;
             customEvents: number;
+            durationMs: number;
             events: number;
+            newVisitors: number;
             outboundClicks: number;
             pageviews: number;
             revenueCents: number;
@@ -106,6 +229,11 @@ export declare class Rastro {
             revenueCents: number;
             value: string;
         }>;
+        topCampaigns: Array<{
+            count: number;
+            revenueCents: number;
+            value: string;
+        }>;
         topCountries: Array<{
             count: number;
             revenueCents: number;
@@ -138,9 +266,12 @@ export declare class Rastro {
         }>;
         totals: {
             clicks: number;
+            continuedSessions: number;
             conversions: number;
             customEvents: number;
+            durationMs: number;
             events: number;
+            newVisitors: number;
             outboundClicks: number;
             pageviews: number;
             revenueCents: number;
@@ -160,9 +291,11 @@ export declare class Rastro {
         lastSeenAt: number;
         latitude?: number;
         longitude?: number;
+        movedAt?: number;
         os: string;
         pageviewCount: number;
         path: string;
+        previousPath?: string;
         sessionId: string;
         siteId: string;
         source: string;
@@ -204,6 +337,7 @@ export declare class Rastro {
             utmMedium?: string;
             utmSource?: string;
             visitorId: string;
+            visitorKey?: string;
         }>;
         pageStatus?: "SplitRecommended" | "SplitRequired" | null;
         splitCursor?: string | null;
@@ -235,7 +369,7 @@ export declare class Rastro {
             siteId: string;
             target?: string;
             timestamp: number;
-            type: "pageview" | "click" | "custom" | "conversion" | "heartbeat" | "outbound";
+            type: "pageview" | "click" | "custom" | "conversion" | "heartbeat" | "leave" | "outbound" | "vital";
             visitorId: string;
         }>;
         pageStatus?: "SplitRecommended" | "SplitRequired" | null;
@@ -290,7 +424,7 @@ export declare class Rastro {
         siteId: string;
         target?: string;
         timestamp: number;
-        type: "pageview" | "click" | "custom" | "conversion" | "heartbeat" | "outbound";
+        type: "pageview" | "click" | "custom" | "conversion" | "heartbeat" | "leave" | "outbound" | "vital";
         visitorId: string;
     }[]>;
     goalsReport(ctx: QueryCtx | MutationCtx | ActionCtx, args: GoalsReportInput): Promise<{
@@ -308,6 +442,22 @@ export declare class Rastro {
             updatedAt: number;
             valueCents: number;
         }>;
+        metadata: {
+            basis: "dailyRollup" | "boundedLegacy";
+            coverage: {
+                availableFrom: number | null;
+                availableThrough: number | null;
+                generation: number | null;
+                retainedBefore: number | null;
+                state: "complete" | "partial" | "retained" | "unavailable";
+            };
+            range: {
+                boundary: "inclusive";
+                from: number;
+                timezone: string;
+                to: number;
+            };
+        };
         truncated: boolean;
     }>;
     funnelsReport(ctx: QueryCtx | MutationCtx | ActionCtx, args: FunnelsReportInput): Promise<{
@@ -317,6 +467,22 @@ export declare class Rastro {
         conversionWindowMs: number;
         createdAt: number;
         key: string;
+        metadata: {
+            basis: "dailyRollup" | "boundedLegacy";
+            coverage: {
+                availableFrom: number | null;
+                availableThrough: number | null;
+                generation: number | null;
+                retainedBefore: number | null;
+                state: "complete" | "partial" | "retained" | "unavailable";
+            };
+            range: {
+                boundary: "inclusive";
+                from: number;
+                timezone: string;
+                to: number;
+            };
+        };
         name: string;
         siteId: string;
         steps: Array<{
@@ -351,8 +517,137 @@ export declare class Rastro {
             updatedAt: number;
             visits: number;
         }>;
+        metadata: {
+            basis: "dailyRollup" | "boundedLegacy";
+            coverage: {
+                availableFrom: number | null;
+                availableThrough: number | null;
+                generation: number | null;
+                retainedBefore: number | null;
+                state: "complete" | "partial" | "retained" | "unavailable";
+            };
+            range: {
+                boundary: "inclusive";
+                from: number;
+                timezone: string;
+                to: number;
+            };
+            uniqueVisitors: {
+                basis: "estimatedUnique" | "exactLegacy";
+                exact: boolean;
+            };
+        };
+        truncated: boolean;
+    }>;
+    vitalsReport(ctx: QueryCtx | MutationCtx | ActionCtx, args: VitalsReportInput): Promise<{
+        metadata: {
+            basis: "dailyRollup" | "boundedLegacy";
+            coverage: {
+                availableFrom: number | null;
+                availableThrough: number | null;
+                generation: number | null;
+                retainedBefore: number | null;
+                state: "complete" | "partial" | "retained" | "unavailable";
+            };
+            range: {
+                boundary: "inclusive";
+                from: number;
+                timezone: string;
+                to: number;
+            };
+        };
+        metrics: Array<{
+            average: number;
+            count: number;
+            devices: Array<{
+                average: number;
+                count: number;
+                device: string;
+                good: number;
+                needsImprovement: number;
+                p75: number;
+                poor: number;
+            }>;
+            good: number;
+            metric: "LCP" | "CLS" | "INP" | "FCP" | "TTFB";
+            needsImprovement: number;
+            p75: number;
+            pages: Array<{
+                average: number;
+                count: number;
+                good: number;
+                needsImprovement: number;
+                p75: number;
+                page: string;
+                poor: number;
+            }>;
+            poor: number;
+            timeSeries: Array<{
+                count: number;
+                p75: number;
+                timestamp: number;
+            }>;
+        }>;
         truncated: boolean;
     }>;
+    siteMap(ctx: QueryCtx | MutationCtx | ActionCtx, args: SiteMapInput): Promise<{
+        from: number;
+        metadata: {
+            basis: "dailyRollup" | "boundedLegacy";
+            coverage: {
+                availableFrom: number | null;
+                availableThrough: number | null;
+                generation: number | null;
+                retainedBefore: number | null;
+                state: "complete" | "partial" | "retained" | "unavailable";
+            };
+            limits: {
+                routesPerDay: number;
+                rows: number;
+                transitionSlots: number;
+            };
+            range: {
+                boundary: "inclusive";
+                from: number;
+                timezone: string;
+                to: number;
+            };
+            visitors: {
+                basis: "estimatedUnique";
+                exact: boolean;
+            };
+        };
+        routes: Array<{
+            bounces: number;
+            daily: Array<{
+                bucketStart: number;
+                pageviews: number;
+            }>;
+            dwellMs: number;
+            dwellSamples: number;
+            entries: number;
+            exits: number;
+            pageviews: number;
+            route: string;
+            transitionsIn: number;
+            transitionsOut: number;
+            visitors: number;
+        }>;
+        to: number;
+        transitions: Array<{
+            count: number;
+            from: string;
+            to: string;
+        }>;
+        truncated: {
+            routes: boolean;
+            transitions: boolean;
+        };
+        window: {
+            from: number;
+            to: number;
+        } | null;
+    }>;
     upsertGoal(ctx: MutationCtx, args: UpsertGoalInput): Promise<string>;
     listGoals(ctx: QueryCtx | MutationCtx | ActionCtx, siteId: string): Promise<{
         _creationTime: number;
@@ -401,11 +696,53 @@ export declare class Rastro {
     }[]>;
     removeAffiliate(ctx: MutationCtx, siteId: string, affiliateId: string): Promise<null>;
     cleanup(ctx: MutationCtx, args: CleanupInput): Promise<{
+        before: number;
+        deleted: number;
+        hasMore: boolean;
+    }>;
+    dataCoverage(ctx: QueryCtx | MutationCtx | ActionCtx, args: DataCoverageInput): Promise<{
+        datasets: Array<{
+            coverage: {
+                availableFrom: number | null;
+                availableThrough: number | null;
+                generation: number | null;
+                retainedBefore: number | null;
+                state: "complete" | "partial" | "retained" | "unavailable";
+            };
+            dataset: "overviewHour" | "overviewDay" | "overviewLocalDay" | "events" | "sessions" | "conversions" | "goals" | "funnels" | "affiliates" | "vitals" | "siteMap";
+        }>;
+        from: number;
+        siteId: string;
+        to: number;
+    }>;
+    setRetentionPolicy(ctx: MutationCtx, args: RetentionPolicyInput): Promise<null>;
+    disableRetentionPolicy(ctx: MutationCtx, siteId: string): Promise<null>;
+    retentionStatus(ctx: QueryCtx | MutationCtx | ActionCtx, siteId: string): Promise<{
+        backlog: number;
+        jobs: Array<{
+            before: number;
+            deleted: number;
+            kind: "events" | "sessions" | "conversions" | "goalCompletions" | "aggregateHour" | "aggregateDay" | "funnelProgress" | "funnelSteps" | "affiliateStats" | "goalRollups" | "funnelRollups" | "affiliateRollups" | "vitalRollups" | "siteMapRollups" | "attributions" | "liveSessions" | "ingestWindows" | "siteIngestWindows";
+            scheduledAt: number | null;
+            status: "pending" | "running" | "complete";
+            updatedAt: number;
+        }>;
+        policy: {
+            aggregatesDays: number;
+            conversionsDays: number;
+            eventsDays: number;
+            reportsDays: number;
+            sessionsDays: number;
+            updatedAt: number;
+        } | null;
+    }>;
+    runRetentionPolicy(ctx: MutationCtx, args: RunRetentionPolicyInput): Promise<{
+        before: number;
         deleted: number;
         hasMore: boolean;
     }>;
 }
-export type AnalyticsOperation = "site.create" | "site.update" | "site.get" | "site.list" | "ingest" | "conversion.track" | "report.overview" | "report.live" | "report.sessions" | "report.sessionJourney" | "report.conversions" | "report.visitorJourney" | "report.goals" | "report.funnels" | "report.affiliates" | "goal.upsert" | "goal.list" | "goal.remove" | "funnel.upsert" | "funnel.list" | "funnel.remove" | "affiliate.upsert" | "affiliate.list" | "affiliate.remove" | "retention.cleanup";
+export type AnalyticsOperation = "site.create" | "site.update" | "site.get" | "site.list" | "ingest" | "conversion.track" | "visitor.link" | "report.overview" | "report.live" | "report.sessions" | "report.sessionJourney" | "report.conversions" | "report.visitorJourney" | "report.goals" | "report.funnels" | "report.affiliates" | "report.vitals" | "report.siteMap" | "goal.upsert" | "goal.list" | "goal.remove" | "funnel.upsert" | "funnel.list" | "funnel.remove" | "affiliate.upsert" | "affiliate.list" | "affiliate.remove" | "retention.cleanup" | "retention.policy" | "retention.status" | "coverage.read";
 export type AnalyticsAuthorizationRequest = {
     operation: AnalyticsOperation;
     siteIds: string[];
@@ -413,6 +750,1266 @@ export type AnalyticsAuthorizationRequest = {
 };
 export type AnalyticsAuthorizationContext = Pick<GenericQueryCtx<GenericDataModel>, "auth" | "db" | "runQuery">;
 export type AnalyticsAuthorizer = (ctx: AnalyticsAuthorizationContext, request: AnalyticsAuthorizationRequest) => void | Promise<void>;
+declare const hostOverviewValidator: import("convex/values").VObject<{
+    currency: string;
+    from: number;
+    interval: "day" | "hour";
+    metadata: {
+        breakdowns: {
+            topBrowsers: "eventVolume" | "pageviews" | "sessions";
+            topCampaigns: "eventVolume" | "pageviews" | "sessions";
+            topCountries: "eventVolume" | "pageviews" | "sessions";
+            topDevices: "eventVolume" | "pageviews" | "sessions";
+            topEvents: "eventVolume";
+            topGoals: "goalCompletionVolume";
+            topPages: "eventVolume" | "pageviews" | "sessions";
+            topSources: "eventVolume" | "pageviews" | "sessions";
+        };
+        coverage: {
+            availableFrom: number | null;
+            availableThrough: number | null;
+            generation: number | null;
+            retainedBefore: number | null;
+            state: "complete" | "partial" | "retained" | "unavailable";
+        };
+        engagement: "counted" | "unavailable";
+        features: {
+            botDetection: "userAgent";
+            errorInsights: "unsupported";
+            outboundLinks: "eventVolume";
+            sessionReplay: "unsupported";
+        };
+        range: {
+            boundary: "inclusive";
+            from: number;
+            timezone: string;
+            to: number;
+        };
+        visitors: {
+            basis: "bucketOccurrences" | "estimatedUnique";
+            exact: boolean;
+            legacyIncomplete: boolean;
+            precision: number | null;
+            sketchVersion: number | null;
+        };
+    };
+    timeSeries: {
+        clicks: number;
+        continuedSessions: number;
+        conversions: number;
+        customEvents: number;
+        durationMs: number;
+        events: number;
+        newVisitors: number;
+        outboundClicks: number;
+        pageviews: number;
+        revenueCents: number;
+        sessions: number;
+        timestamp: number;
+        visitors: number;
+    }[];
+    to: number;
+    topBrowsers: {
+        count: number;
+        revenueCents: number;
+        value: string;
+    }[];
+    topCampaigns: {
+        count: number;
+        revenueCents: number;
+        value: string;
+    }[];
+    topCountries: {
+        count: number;
+        revenueCents: number;
+        value: string;
+    }[];
+    topDevices: {
+        count: number;
+        revenueCents: number;
+        value: string;
+    }[];
+    topEvents: {
+        count: number;
+        revenueCents: number;
+        value: string;
+    }[];
+    topGoals: {
+        count: number;
+        revenueCents: number;
+        value: string;
+    }[];
+    topPages: {
+        count: number;
+        revenueCents: number;
+        value: string;
+    }[];
+    topSources: {
+        count: number;
+        revenueCents: number;
+        value: string;
+    }[];
+    totals: {
+        clicks: number;
+        continuedSessions: number;
+        conversions: number;
+        customEvents: number;
+        durationMs: number;
+        events: number;
+        newVisitors: number;
+        outboundClicks: number;
+        pageviews: number;
+        revenueCents: number;
+        sessions: number;
+        visitors: number;
+    };
+}, {
+    from: import("convex/values").VFloat64<number, "required">;
+    to: import("convex/values").VFloat64<number, "required">;
+    interval: import("convex/values").VUnion<"day" | "hour", [import("convex/values").VLiteral<"hour", "required">, import("convex/values").VLiteral<"day", "required">], "required", never>;
+    currency: import("convex/values").VString<string, "required">;
+    totals: import("convex/values").VObject<{
+        clicks: number;
+        continuedSessions: number;
+        conversions: number;
+        customEvents: number;
+        durationMs: number;
+        events: number;
+        newVisitors: number;
+        outboundClicks: number;
+        pageviews: number;
+        revenueCents: number;
+        sessions: number;
+        visitors: number;
+    }, {
+        events: import("convex/values").VFloat64<number, "required">;
+        pageviews: import("convex/values").VFloat64<number, "required">;
+        clicks: import("convex/values").VFloat64<number, "required">;
+        customEvents: import("convex/values").VFloat64<number, "required">;
+        outboundClicks: import("convex/values").VFloat64<number, "required">;
+        sessions: import("convex/values").VFloat64<number, "required">;
+        visitors: import("convex/values").VFloat64<number, "required">;
+        conversions: import("convex/values").VFloat64<number, "required">;
+        revenueCents: import("convex/values").VFloat64<number, "required">;
+        durationMs: import("convex/values").VFloat64<number, "required">;
+        continuedSessions: import("convex/values").VFloat64<number, "required">;
+        newVisitors: import("convex/values").VFloat64<number, "required">;
+    }, "required", "clicks" | "continuedSessions" | "conversions" | "customEvents" | "durationMs" | "events" | "newVisitors" | "outboundClicks" | "pageviews" | "revenueCents" | "sessions" | "visitors">;
+    timeSeries: import("convex/values").VArray<{
+        clicks: number;
+        continuedSessions: number;
+        conversions: number;
+        customEvents: number;
+        durationMs: number;
+        events: number;
+        newVisitors: number;
+        outboundClicks: number;
+        pageviews: number;
+        revenueCents: number;
+        sessions: number;
+        timestamp: number;
+        visitors: number;
+    }[], import("convex/values").VObject<{
+        clicks: number;
+        continuedSessions: number;
+        conversions: number;
+        customEvents: number;
+        durationMs: number;
+        events: number;
+        newVisitors: number;
+        outboundClicks: number;
+        pageviews: number;
+        revenueCents: number;
+        sessions: number;
+        timestamp: number;
+        visitors: number;
+    }, {
+        events: import("convex/values").VFloat64<number, "required">;
+        pageviews: import("convex/values").VFloat64<number, "required">;
+        clicks: import("convex/values").VFloat64<number, "required">;
+        customEvents: import("convex/values").VFloat64<number, "required">;
+        outboundClicks: import("convex/values").VFloat64<number, "required">;
+        sessions: import("convex/values").VFloat64<number, "required">;
+        visitors: import("convex/values").VFloat64<number, "required">;
+        conversions: import("convex/values").VFloat64<number, "required">;
+        revenueCents: import("convex/values").VFloat64<number, "required">;
+        durationMs: import("convex/values").VFloat64<number, "required">;
+        continuedSessions: import("convex/values").VFloat64<number, "required">;
+        newVisitors: import("convex/values").VFloat64<number, "required">;
+        timestamp: import("convex/values").VFloat64<number, "required">;
+    }, "required", "clicks" | "continuedSessions" | "conversions" | "customEvents" | "durationMs" | "events" | "newVisitors" | "outboundClicks" | "pageviews" | "revenueCents" | "sessions" | "timestamp" | "visitors">, "required">;
+    topSources: import("convex/values").VArray<{
+        count: number;
+        revenueCents: number;
+        value: string;
+    }[], import("convex/values").VObject<{
+        count: number;
+        revenueCents: number;
+        value: string;
+    }, {
+        value: import("convex/values").VString<string, "required">;
+        count: import("convex/values").VFloat64<number, "required">;
+        revenueCents: import("convex/values").VFloat64<number, "required">;
+    }, "required", "count" | "revenueCents" | "value">, "required">;
+    topCampaigns: import("convex/values").VArray<{
+        count: number;
+        revenueCents: number;
+        value: string;
+    }[], import("convex/values").VObject<{
+        count: number;
+        revenueCents: number;
+        value: string;
+    }, {
+        value: import("convex/values").VString<string, "required">;
+        count: import("convex/values").VFloat64<number, "required">;
+        revenueCents: import("convex/values").VFloat64<number, "required">;
+    }, "required", "count" | "revenueCents" | "value">, "required">;
+    topPages: import("convex/values").VArray<{
+        count: number;
+        revenueCents: number;
+        value: string;
+    }[], import("convex/values").VObject<{
+        count: number;
+        revenueCents: number;
+        value: string;
+    }, {
+        value: import("convex/values").VString<string, "required">;
+        count: import("convex/values").VFloat64<number, "required">;
+        revenueCents: import("convex/values").VFloat64<number, "required">;
+    }, "required", "count" | "revenueCents" | "value">, "required">;
+    topCountries: import("convex/values").VArray<{
+        count: number;
+        revenueCents: number;
+        value: string;
+    }[], import("convex/values").VObject<{
+        count: number;
+        revenueCents: number;
+        value: string;
+    }, {
+        value: import("convex/values").VString<string, "required">;
+        count: import("convex/values").VFloat64<number, "required">;
+        revenueCents: import("convex/values").VFloat64<number, "required">;
+    }, "required", "count" | "revenueCents" | "value">, "required">;
+    topDevices: import("convex/values").VArray<{
+        count: number;
+        revenueCents: number;
+        value: string;
+    }[], import("convex/values").VObject<{
+        count: number;
+        revenueCents: number;
+        value: string;
+    }, {
+        value: import("convex/values").VString<string, "required">;
+        count: import("convex/values").VFloat64<number, "required">;
+        revenueCents: import("convex/values").VFloat64<number, "required">;
+    }, "required", "count" | "revenueCents" | "value">, "required">;
+    topBrowsers: import("convex/values").VArray<{
+        count: number;
+        revenueCents: number;
+        value: string;
+    }[], import("convex/values").VObject<{
+        count: number;
+        revenueCents: number;
+        value: string;
+    }, {
+        value: import("convex/values").VString<string, "required">;
+        count: import("convex/values").VFloat64<number, "required">;
+        revenueCents: import("convex/values").VFloat64<number, "required">;
+    }, "required", "count" | "revenueCents" | "value">, "required">;
+    topEvents: import("convex/values").VArray<{
+        count: number;
+        revenueCents: number;
+        value: string;
+    }[], import("convex/values").VObject<{
+        count: number;
+        revenueCents: number;
+        value: string;
+    }, {
+        value: import("convex/values").VString<string, "required">;
+        count: import("convex/values").VFloat64<number, "required">;
+        revenueCents: import("convex/values").VFloat64<number, "required">;
+    }, "required", "count" | "revenueCents" | "value">, "required">;
+    topGoals: import("convex/values").VArray<{
+        count: number;
+        revenueCents: number;
+        value: string;
+    }[], import("convex/values").VObject<{
+        count: number;
+        revenueCents: number;
+        value: string;
+    }, {
+        value: import("convex/values").VString<string, "required">;
+        count: import("convex/values").VFloat64<number, "required">;
+        revenueCents: import("convex/values").VFloat64<number, "required">;
+    }, "required", "count" | "revenueCents" | "value">, "required">;
+    metadata: import("convex/values").VObject<{
+        breakdowns: {
+            topBrowsers: "eventVolume" | "pageviews" | "sessions";
+            topCampaigns: "eventVolume" | "pageviews" | "sessions";
+            topCountries: "eventVolume" | "pageviews" | "sessions";
+            topDevices: "eventVolume" | "pageviews" | "sessions";
+            topEvents: "eventVolume";
+            topGoals: "goalCompletionVolume";
+            topPages: "eventVolume" | "pageviews" | "sessions";
+            topSources: "eventVolume" | "pageviews" | "sessions";
+        };
+        coverage: {
+            availableFrom: number | null;
+            availableThrough: number | null;
+            generation: number | null;
+            retainedBefore: number | null;
+            state: "complete" | "partial" | "retained" | "unavailable";
+        };
+        engagement: "counted" | "unavailable";
+        features: {
+            botDetection: "userAgent";
+            errorInsights: "unsupported";
+            outboundLinks: "eventVolume";
+            sessionReplay: "unsupported";
+        };
+        range: {
+            boundary: "inclusive";
+            from: number;
+            timezone: string;
+            to: number;
+        };
+        visitors: {
+            basis: "bucketOccurrences" | "estimatedUnique";
+            exact: boolean;
+            legacyIncomplete: boolean;
+            precision: number | null;
+            sketchVersion: number | null;
+        };
+    }, {
+        visitors: import("convex/values").VObject<{
+            basis: "bucketOccurrences" | "estimatedUnique";
+            exact: boolean;
+            legacyIncomplete: boolean;
+            precision: number | null;
+            sketchVersion: number | null;
+        }, {
+            basis: import("convex/values").VUnion<"bucketOccurrences" | "estimatedUnique", [import("convex/values").VLiteral<"estimatedUnique", "required">, import("convex/values").VLiteral<"bucketOccurrences", "required">], "required", never>;
+            exact: import("convex/values").VBoolean<boolean, "required">;
+            legacyIncomplete: import("convex/values").VBoolean<boolean, "required">;
+            sketchVersion: import("convex/values").VUnion<number | null, [import("convex/values").VFloat64<number, "required">, import("convex/values").VNull<null, "required">], "required", never>;
+            precision: import("convex/values").VUnion<number | null, [import("convex/values").VFloat64<number, "required">, import("convex/values").VNull<null, "required">], "required", never>;
+        }, "required", "basis" | "exact" | "legacyIncomplete" | "precision" | "sketchVersion">;
+        breakdowns: import("convex/values").VObject<{
+            topBrowsers: "eventVolume" | "pageviews" | "sessions";
+            topCampaigns: "eventVolume" | "pageviews" | "sessions";
+            topCountries: "eventVolume" | "pageviews" | "sessions";
+            topDevices: "eventVolume" | "pageviews" | "sessions";
+            topEvents: "eventVolume";
+            topGoals: "goalCompletionVolume";
+            topPages: "eventVolume" | "pageviews" | "sessions";
+            topSources: "eventVolume" | "pageviews" | "sessions";
+        }, {
+            topSources: import("convex/values").VUnion<"eventVolume" | "pageviews" | "sessions", [import("convex/values").VLiteral<"pageviews", "required">, import("convex/values").VLiteral<"sessions", "required">, import("convex/values").VLiteral<"eventVolume", "required">], "required", never>;
+            topCampaigns: import("convex/values").VUnion<"eventVolume" | "pageviews" | "sessions", [import("convex/values").VLiteral<"pageviews", "required">, import("convex/values").VLiteral<"sessions", "required">, import("convex/values").VLiteral<"eventVolume", "required">], "required", never>;
+            topPages: import("convex/values").VUnion<"eventVolume" | "pageviews" | "sessions", [import("convex/values").VLiteral<"pageviews", "required">, import("convex/values").VLiteral<"sessions", "required">, import("convex/values").VLiteral<"eventVolume", "required">], "required", never>;
+            topCountries: import("convex/values").VUnion<"eventVolume" | "pageviews" | "sessions", [import("convex/values").VLiteral<"pageviews", "required">, import("convex/values").VLiteral<"sessions", "required">, import("convex/values").VLiteral<"eventVolume", "required">], "required", never>;
+            topDevices: import("convex/values").VUnion<"eventVolume" | "pageviews" | "sessions", [import("convex/values").VLiteral<"pageviews", "required">, import("convex/values").VLiteral<"sessions", "required">, import("convex/values").VLiteral<"eventVolume", "required">], "required", never>;
+            topBrowsers: import("convex/values").VUnion<"eventVolume" | "pageviews" | "sessions", [import("convex/values").VLiteral<"pageviews", "required">, import("convex/values").VLiteral<"sessions", "required">, import("convex/values").VLiteral<"eventVolume", "required">], "required", never>;
+            topEvents: import("convex/values").VLiteral<"eventVolume", "required">;
+            topGoals: import("convex/values").VLiteral<"goalCompletionVolume", "required">;
+        }, "required", "topBrowsers" | "topCampaigns" | "topCountries" | "topDevices" | "topEvents" | "topGoals" | "topPages" | "topSources">;
+        engagement: import("convex/values").VUnion<"counted" | "unavailable", [import("convex/values").VLiteral<"counted", "required">, import("convex/values").VLiteral<"unavailable", "required">], "required", never>;
+        coverage: import("convex/values").VObject<{
+            availableFrom: number | null;
+            availableThrough: number | null;
+            generation: number | null;
+            retainedBefore: number | null;
+            state: "complete" | "partial" | "retained" | "unavailable";
+        }, {
+            state: import("convex/values").VUnion<"complete" | "partial" | "retained" | "unavailable", [import("convex/values").VLiteral<"complete", "required">, import("convex/values").VLiteral<"partial", "required">, import("convex/values").VLiteral<"retained", "required">, import("convex/values").VLiteral<"unavailable", "required">], "required", never>;
+            generation: import("convex/values").VUnion<number | null, [import("convex/values").VFloat64<number, "required">, import("convex/values").VNull<null, "required">], "required", never>;
+            availableFrom: import("convex/values").VUnion<number | null, [import("convex/values").VFloat64<number, "required">, import("convex/values").VNull<null, "required">], "required", never>;
+            availableThrough: import("convex/values").VUnion<number | null, [import("convex/values").VFloat64<number, "required">, import("convex/values").VNull<null, "required">], "required", never>;
+            retainedBefore: import("convex/values").VUnion<number | null, [import("convex/values").VFloat64<number, "required">, import("convex/values").VNull<null, "required">], "required", never>;
+        }, "required", "availableFrom" | "availableThrough" | "generation" | "retainedBefore" | "state">;
+        range: import("convex/values").VObject<{
+            boundary: "inclusive";
+            from: number;
+            timezone: string;
+            to: number;
+        }, {
+            from: import("convex/values").VFloat64<number, "required">;
+            to: import("convex/values").VFloat64<number, "required">;
+            boundary: import("convex/values").VLiteral<"inclusive", "required">;
+            timezone: import("convex/values").VString<string, "required">;
+        }, "required", "boundary" | "from" | "timezone" | "to">;
+        features: import("convex/values").VObject<{
+            botDetection: "userAgent";
+            errorInsights: "unsupported";
+            outboundLinks: "eventVolume";
+            sessionReplay: "unsupported";
+        }, {
+            sessionReplay: import("convex/values").VLiteral<"unsupported", "required">;
+            errorInsights: import("convex/values").VLiteral<"unsupported", "required">;
+            outboundLinks: import("convex/values").VLiteral<"eventVolume", "required">;
+            botDetection: import("convex/values").VLiteral<"userAgent", "required">;
+        }, "required", "botDetection" | "errorInsights" | "outboundLinks" | "sessionReplay">;
+    }, "required", "breakdowns" | "breakdowns.topBrowsers" | "breakdowns.topCampaigns" | "breakdowns.topCountries" | "breakdowns.topDevices" | "breakdowns.topEvents" | "breakdowns.topGoals" | "breakdowns.topPages" | "breakdowns.topSources" | "coverage" | "coverage.availableFrom" | "coverage.availableThrough" | "coverage.generation" | "coverage.retainedBefore" | "coverage.state" | "engagement" | "features" | "features.botDetection" | "features.errorInsights" | "features.outboundLinks" | "features.sessionReplay" | "range" | "range.boundary" | "range.from" | "range.timezone" | "range.to" | "visitors" | "visitors.basis" | "visitors.exact" | "visitors.legacyIncomplete" | "visitors.precision" | "visitors.sketchVersion">;
+}, "required", "currency" | "from" | "interval" | "metadata" | "metadata.breakdowns" | "metadata.breakdowns.topBrowsers" | "metadata.breakdowns.topCampaigns" | "metadata.breakdowns.topCountries" | "metadata.breakdowns.topDevices" | "metadata.breakdowns.topEvents" | "metadata.breakdowns.topGoals" | "metadata.breakdowns.topPages" | "metadata.breakdowns.topSources" | "metadata.coverage" | "metadata.coverage.availableFrom" | "metadata.coverage.availableThrough" | "metadata.coverage.generation" | "metadata.coverage.retainedBefore" | "metadata.coverage.state" | "metadata.engagement" | "metadata.features" | "metadata.features.botDetection" | "metadata.features.errorInsights" | "metadata.features.outboundLinks" | "metadata.features.sessionReplay" | "metadata.range" | "metadata.range.boundary" | "metadata.range.from" | "metadata.range.timezone" | "metadata.range.to" | "metadata.visitors" | "metadata.visitors.basis" | "metadata.visitors.exact" | "metadata.visitors.legacyIncomplete" | "metadata.visitors.precision" | "metadata.visitors.sketchVersion" | "timeSeries" | "to" | "topBrowsers" | "topCampaigns" | "topCountries" | "topDevices" | "topEvents" | "topGoals" | "topPages" | "topSources" | "totals" | "totals.clicks" | "totals.continuedSessions" | "totals.conversions" | "totals.customEvents" | "totals.durationMs" | "totals.events" | "totals.newVisitors" | "totals.outboundClicks" | "totals.pageviews" | "totals.revenueCents" | "totals.sessions" | "totals.visitors">;
+declare const hostGoalsReportValidator: import("convex/values").VObject<{
+    goals: {
+        _creationTime: number;
+        _id: string;
+        active: boolean;
+        completions: number;
+        createdAt: number;
+        key: string;
+        matchType: "custom" | "pageview";
+        matchValue: string;
+        name: string;
+        siteId: string;
+        updatedAt: number;
+        valueCents: number;
+    }[];
+    metadata: {
+        basis: "boundedLegacy" | "dailyRollup";
+        coverage: {
+            availableFrom: number | null;
+            availableThrough: number | null;
+            generation: number | null;
+            retainedBefore: number | null;
+            state: "complete" | "partial" | "retained" | "unavailable";
+        };
+        range: {
+            boundary: "inclusive";
+            from: number;
+            timezone: string;
+            to: number;
+        };
+    };
+    truncated: boolean;
+}, {
+    goals: import("convex/values").VArray<{
+        _creationTime: number;
+        _id: string;
+        active: boolean;
+        completions: number;
+        createdAt: number;
+        key: string;
+        matchType: "custom" | "pageview";
+        matchValue: string;
+        name: string;
+        siteId: string;
+        updatedAt: number;
+        valueCents: number;
+    }[], import("convex/values").VObject<{
+        _creationTime: number;
+        _id: string;
+        active: boolean;
+        completions: number;
+        createdAt: number;
+        key: string;
+        matchType: "custom" | "pageview";
+        matchValue: string;
+        name: string;
+        siteId: string;
+        updatedAt: number;
+        valueCents: number;
+    }, {
+        _id: import("convex/values").VString<string, "required">;
+        _creationTime: import("convex/values").VFloat64<number, "required">;
+        siteId: import("convex/values").VString<string, "required">;
+        key: import("convex/values").VString<string, "required">;
+        name: import("convex/values").VString<string, "required">;
+        matchType: import("convex/values").VUnion<"custom" | "pageview", [import("convex/values").VLiteral<"pageview", "required">, import("convex/values").VLiteral<"custom", "required">], "required", never>;
+        matchValue: import("convex/values").VString<string, "required">;
+        valueCents: never;
+        active: import("convex/values").VBoolean<boolean, "required">;
+        createdAt: import("convex/values").VFloat64<number, "required">;
+        updatedAt: import("convex/values").VFloat64<number, "required">;
+        completions: import("convex/values").VFloat64<number, "required">;
+    }, "required", "_creationTime" | "_id" | "active" | "completions" | "createdAt" | "key" | "matchType" | "matchValue" | "name" | "siteId" | "updatedAt" | "valueCents">, "required">;
+    truncated: import("convex/values").VBoolean<boolean, "required">;
+    metadata: import("convex/values").VObject<{
+        basis: "boundedLegacy" | "dailyRollup";
+        coverage: {
+            availableFrom: number | null;
+            availableThrough: number | null;
+            generation: number | null;
+            retainedBefore: number | null;
+            state: "complete" | "partial" | "retained" | "unavailable";
+        };
+        range: {
+            boundary: "inclusive";
+            from: number;
+            timezone: string;
+            to: number;
+        };
+    }, {
+        basis: import("convex/values").VUnion<"boundedLegacy" | "dailyRollup", [import("convex/values").VLiteral<"dailyRollup", "required">, import("convex/values").VLiteral<"boundedLegacy", "required">], "required", never>;
+        coverage: import("convex/values").VObject<{
+            availableFrom: number | null;
+            availableThrough: number | null;
+            generation: number | null;
+            retainedBefore: number | null;
+            state: "complete" | "partial" | "retained" | "unavailable";
+        }, {
+            state: import("convex/values").VUnion<"complete" | "partial" | "retained" | "unavailable", [import("convex/values").VLiteral<"complete", "required">, import("convex/values").VLiteral<"partial", "required">, import("convex/values").VLiteral<"retained", "required">, import("convex/values").VLiteral<"unavailable", "required">], "required", never>;
+            generation: import("convex/values").VUnion<number | null, [import("convex/values").VFloat64<number, "required">, import("convex/values").VNull<null, "required">], "required", never>;
+            availableFrom: import("convex/values").VUnion<number | null, [import("convex/values").VFloat64<number, "required">, import("convex/values").VNull<null, "required">], "required", never>;
+            availableThrough: import("convex/values").VUnion<number | null, [import("convex/values").VFloat64<number, "required">, import("convex/values").VNull<null, "required">], "required", never>;
+            retainedBefore: import("convex/values").VUnion<number | null, [import("convex/values").VFloat64<number, "required">, import("convex/values").VNull<null, "required">], "required", never>;
+        }, "required", "availableFrom" | "availableThrough" | "generation" | "retainedBefore" | "state">;
+        range: import("convex/values").VObject<{
+            boundary: "inclusive";
+            from: number;
+            timezone: string;
+            to: number;
+        }, {
+            from: import("convex/values").VFloat64<number, "required">;
+            to: import("convex/values").VFloat64<number, "required">;
+            boundary: import("convex/values").VLiteral<"inclusive", "required">;
+            timezone: import("convex/values").VString<string, "required">;
+        }, "required", "boundary" | "from" | "timezone" | "to">;
+    }, "required", "basis" | "coverage" | "coverage.availableFrom" | "coverage.availableThrough" | "coverage.generation" | "coverage.retainedBefore" | "coverage.state" | "range" | "range.boundary" | "range.from" | "range.timezone" | "range.to">;
+}, "required", "goals" | "metadata" | "metadata.basis" | "metadata.coverage" | "metadata.coverage.availableFrom" | "metadata.coverage.availableThrough" | "metadata.coverage.generation" | "metadata.coverage.retainedBefore" | "metadata.coverage.state" | "metadata.range" | "metadata.range.boundary" | "metadata.range.from" | "metadata.range.timezone" | "metadata.range.to" | "truncated">;
+declare const hostFunnelsReportValidator: import("convex/values").VArray<{
+    _creationTime: number;
+    _id: string;
+    active: boolean;
+    conversionWindowMs: number;
+    createdAt: number;
+    key: string;
+    metadata: {
+        basis: "boundedLegacy" | "dailyRollup";
+        coverage: {
+            availableFrom: number | null;
+            availableThrough: number | null;
+            generation: number | null;
+            retainedBefore: number | null;
+            state: "complete" | "partial" | "retained" | "unavailable";
+        };
+        range: {
+            boundary: "inclusive";
+            from: number;
+            timezone: string;
+            to: number;
+        };
+    };
+    name: string;
+    siteId: string;
+    steps: {
+        name: string;
+        type: "custom" | "pageview";
+        value: string;
+    }[];
+    stepsReport: {
+        completions: number;
+        entrants: number;
+        name: string;
+        step: number;
+    }[];
+    truncated: boolean;
+    updatedAt: number;
+}[], import("convex/values").VObject<{
+    _creationTime: number;
+    _id: string;
+    active: boolean;
+    conversionWindowMs: number;
+    createdAt: number;
+    key: string;
+    metadata: {
+        basis: "boundedLegacy" | "dailyRollup";
+        coverage: {
+            availableFrom: number | null;
+            availableThrough: number | null;
+            generation: number | null;
+            retainedBefore: number | null;
+            state: "complete" | "partial" | "retained" | "unavailable";
+        };
+        range: {
+            boundary: "inclusive";
+            from: number;
+            timezone: string;
+            to: number;
+        };
+    };
+    name: string;
+    siteId: string;
+    steps: {
+        name: string;
+        type: "custom" | "pageview";
+        value: string;
+    }[];
+    stepsReport: {
+        completions: number;
+        entrants: number;
+        name: string;
+        step: number;
+    }[];
+    truncated: boolean;
+    updatedAt: number;
+}, {
+    _id: import("convex/values").VString<string, "required">;
+    _creationTime: import("convex/values").VFloat64<number, "required">;
+    siteId: import("convex/values").VString<string, "required">;
+    key: import("convex/values").VString<string, "required">;
+    name: import("convex/values").VString<string, "required">;
+    steps: import("convex/values").VArray<{
+        name: string;
+        type: "custom" | "pageview";
+        value: string;
+    }[], import("convex/values").VObject<{
+        name: string;
+        type: "custom" | "pageview";
+        value: string;
+    }, {
+        type: import("convex/values").VUnion<"custom" | "pageview", [import("convex/values").VLiteral<"pageview", "required">, import("convex/values").VLiteral<"custom", "required">], "required", never>;
+        value: import("convex/values").VString<string, "required">;
+        name: import("convex/values").VString<string, "required">;
+    }, "required", "name" | "type" | "value">, "required">;
+    conversionWindowMs: import("convex/values").VFloat64<number, "required">;
+    active: import("convex/values").VBoolean<boolean, "required">;
+    createdAt: import("convex/values").VFloat64<number, "required">;
+    updatedAt: import("convex/values").VFloat64<number, "required">;
+    stepsReport: import("convex/values").VArray<{
+        completions: number;
+        entrants: number;
+        name: string;
+        step: number;
+    }[], import("convex/values").VObject<{
+        completions: number;
+        entrants: number;
+        name: string;
+        step: number;
+    }, {
+        step: import("convex/values").VFloat64<number, "required">;
+        name: import("convex/values").VString<string, "required">;
+        entrants: import("convex/values").VFloat64<number, "required">;
+        completions: import("convex/values").VFloat64<number, "required">;
+    }, "required", "completions" | "entrants" | "name" | "step">, "required">;
+    truncated: import("convex/values").VBoolean<boolean, "required">;
+    metadata: import("convex/values").VObject<{
+        basis: "boundedLegacy" | "dailyRollup";
+        coverage: {
+            availableFrom: number | null;
+            availableThrough: number | null;
+            generation: number | null;
+            retainedBefore: number | null;
+            state: "complete" | "partial" | "retained" | "unavailable";
+        };
+        range: {
+            boundary: "inclusive";
+            from: number;
+            timezone: string;
+            to: number;
+        };
+    }, {
+        basis: import("convex/values").VUnion<"boundedLegacy" | "dailyRollup", [import("convex/values").VLiteral<"dailyRollup", "required">, import("convex/values").VLiteral<"boundedLegacy", "required">], "required", never>;
+        coverage: import("convex/values").VObject<{
+            availableFrom: number | null;
+            availableThrough: number | null;
+            generation: number | null;
+            retainedBefore: number | null;
+            state: "complete" | "partial" | "retained" | "unavailable";
+        }, {
+            state: import("convex/values").VUnion<"complete" | "partial" | "retained" | "unavailable", [import("convex/values").VLiteral<"complete", "required">, import("convex/values").VLiteral<"partial", "required">, import("convex/values").VLiteral<"retained", "required">, import("convex/values").VLiteral<"unavailable", "required">], "required", never>;
+            generation: import("convex/values").VUnion<number | null, [import("convex/values").VFloat64<number, "required">, import("convex/values").VNull<null, "required">], "required", never>;
+            availableFrom: import("convex/values").VUnion<number | null, [import("convex/values").VFloat64<number, "required">, import("convex/values").VNull<null, "required">], "required", never>;
+            availableThrough: import("convex/values").VUnion<number | null, [import("convex/values").VFloat64<number, "required">, import("convex/values").VNull<null, "required">], "required", never>;
+            retainedBefore: import("convex/values").VUnion<number | null, [import("convex/values").VFloat64<number, "required">, import("convex/values").VNull<null, "required">], "required", never>;
+        }, "required", "availableFrom" | "availableThrough" | "generation" | "retainedBefore" | "state">;
+        range: import("convex/values").VObject<{
+            boundary: "inclusive";
+            from: number;
+            timezone: string;
+            to: number;
+        }, {
+            from: import("convex/values").VFloat64<number, "required">;
+            to: import("convex/values").VFloat64<number, "required">;
+            boundary: import("convex/values").VLiteral<"inclusive", "required">;
+            timezone: import("convex/values").VString<string, "required">;
+        }, "required", "boundary" | "from" | "timezone" | "to">;
+    }, "required", "basis" | "coverage" | "coverage.availableFrom" | "coverage.availableThrough" | "coverage.generation" | "coverage.retainedBefore" | "coverage.state" | "range" | "range.boundary" | "range.from" | "range.timezone" | "range.to">;
+}, "required", "_creationTime" | "_id" | "active" | "conversionWindowMs" | "createdAt" | "key" | "metadata" | "metadata.basis" | "metadata.coverage" | "metadata.coverage.availableFrom" | "metadata.coverage.availableThrough" | "metadata.coverage.generation" | "metadata.coverage.retainedBefore" | "metadata.coverage.state" | "metadata.range" | "metadata.range.boundary" | "metadata.range.from" | "metadata.range.timezone" | "metadata.range.to" | "name" | "siteId" | "steps" | "stepsReport" | "truncated" | "updatedAt">, "required">;
+declare const hostAffiliatesReportValidator: import("convex/values").VObject<{
+    affiliates: {
+        _creationTime: number;
+        _id: string;
+        active: boolean;
+        attributionWindowDays: number;
+        commissionBps: number;
+        commissionCents: number;
+        conversions: number;
+        createdAt: number;
+        name: string;
+        revenueCents: number;
+        siteId: string;
+        slug: string;
+        uniqueVisitors: number;
+        updatedAt: number;
+        visits: number;
+    }[];
+    metadata: {
+        basis: "boundedLegacy" | "dailyRollup";
+        coverage: {
+            availableFrom: number | null;
+            availableThrough: number | null;
+            generation: number | null;
+            retainedBefore: number | null;
+            state: "complete" | "partial" | "retained" | "unavailable";
+        };
+        range: {
+            boundary: "inclusive";
+            from: number;
+            timezone: string;
+            to: number;
+        };
+        uniqueVisitors: {
+            basis: "estimatedUnique" | "exactLegacy";
+            exact: boolean;
+        };
+    };
+    truncated: boolean;
+}, {
+    affiliates: import("convex/values").VArray<{
+        _creationTime: number;
+        _id: string;
+        active: boolean;
+        attributionWindowDays: number;
+        commissionBps: number;
+        commissionCents: number;
+        conversions: number;
+        createdAt: number;
+        name: string;
+        revenueCents: number;
+        siteId: string;
+        slug: string;
+        uniqueVisitors: number;
+        updatedAt: number;
+        visits: number;
+    }[], import("convex/values").VObject<{
+        _creationTime: number;
+        _id: string;
+        active: boolean;
+        attributionWindowDays: number;
+        commissionBps: number;
+        commissionCents: number;
+        conversions: number;
+        createdAt: number;
+        name: string;
+        revenueCents: number;
+        siteId: string;
+        slug: string;
+        uniqueVisitors: number;
+        updatedAt: number;
+        visits: number;
+    }, {
+        _id: import("convex/values").VString<string, "required">;
+        _creationTime: import("convex/values").VFloat64<number, "required">;
+        siteId: import("convex/values").VString<string, "required">;
+        slug: import("convex/values").VString<string, "required">;
+        name: import("convex/values").VString<string, "required">;
+        commissionBps: import("convex/values").VFloat64<number, "required">;
+        attributionWindowDays: import("convex/values").VFloat64<number, "required">;
+        active: import("convex/values").VBoolean<boolean, "required">;
+        createdAt: import("convex/values").VFloat64<number, "required">;
+        updatedAt: import("convex/values").VFloat64<number, "required">;
+        visits: import("convex/values").VFloat64<number, "required">;
+        uniqueVisitors: import("convex/values").VFloat64<number, "required">;
+        conversions: import("convex/values").VFloat64<number, "required">;
+        revenueCents: import("convex/values").VFloat64<number, "required">;
+        commissionCents: import("convex/values").VFloat64<number, "required">;
+    }, "required", "_creationTime" | "_id" | "active" | "attributionWindowDays" | "commissionBps" | "commissionCents" | "conversions" | "createdAt" | "name" | "revenueCents" | "siteId" | "slug" | "uniqueVisitors" | "updatedAt" | "visits">, "required">;
+    truncated: import("convex/values").VBoolean<boolean, "required">;
+    metadata: import("convex/values").VObject<{
+        basis: "boundedLegacy" | "dailyRollup";
+        coverage: {
+            availableFrom: number | null;
+            availableThrough: number | null;
+            generation: number | null;
+            retainedBefore: number | null;
+            state: "complete" | "partial" | "retained" | "unavailable";
+        };
+        range: {
+            boundary: "inclusive";
+            from: number;
+            timezone: string;
+            to: number;
+        };
+        uniqueVisitors: {
+            basis: "estimatedUnique" | "exactLegacy";
+            exact: boolean;
+        };
+    }, {
+        basis: import("convex/values").VUnion<"boundedLegacy" | "dailyRollup", [import("convex/values").VLiteral<"dailyRollup", "required">, import("convex/values").VLiteral<"boundedLegacy", "required">], "required", never>;
+        coverage: import("convex/values").VObject<{
+            availableFrom: number | null;
+            availableThrough: number | null;
+            generation: number | null;
+            retainedBefore: number | null;
+            state: "complete" | "partial" | "retained" | "unavailable";
+        }, {
+            state: import("convex/values").VUnion<"complete" | "partial" | "retained" | "unavailable", [import("convex/values").VLiteral<"complete", "required">, import("convex/values").VLiteral<"partial", "required">, import("convex/values").VLiteral<"retained", "required">, import("convex/values").VLiteral<"unavailable", "required">], "required", never>;
+            generation: import("convex/values").VUnion<number | null, [import("convex/values").VFloat64<number, "required">, import("convex/values").VNull<null, "required">], "required", never>;
+            availableFrom: import("convex/values").VUnion<number | null, [import("convex/values").VFloat64<number, "required">, import("convex/values").VNull<null, "required">], "required", never>;
+            availableThrough: import("convex/values").VUnion<number | null, [import("convex/values").VFloat64<number, "required">, import("convex/values").VNull<null, "required">], "required", never>;
+            retainedBefore: import("convex/values").VUnion<number | null, [import("convex/values").VFloat64<number, "required">, import("convex/values").VNull<null, "required">], "required", never>;
+        }, "required", "availableFrom" | "availableThrough" | "generation" | "retainedBefore" | "state">;
+        range: import("convex/values").VObject<{
+            boundary: "inclusive";
+            from: number;
+            timezone: string;
+            to: number;
+        }, {
+            from: import("convex/values").VFloat64<number, "required">;
+            to: import("convex/values").VFloat64<number, "required">;
+            boundary: import("convex/values").VLiteral<"inclusive", "required">;
+            timezone: import("convex/values").VString<string, "required">;
+        }, "required", "boundary" | "from" | "timezone" | "to">;
+        uniqueVisitors: import("convex/values").VObject<{
+            basis: "estimatedUnique" | "exactLegacy";
+            exact: boolean;
+        }, {
+            basis: import("convex/values").VUnion<"estimatedUnique" | "exactLegacy", [import("convex/values").VLiteral<"estimatedUnique", "required">, import("convex/values").VLiteral<"exactLegacy", "required">], "required", never>;
+            exact: import("convex/values").VBoolean<boolean, "required">;
+        }, "required", "basis" | "exact">;
+    }, "required", "basis" | "coverage" | "coverage.availableFrom" | "coverage.availableThrough" | "coverage.generation" | "coverage.retainedBefore" | "coverage.state" | "range" | "range.boundary" | "range.from" | "range.timezone" | "range.to" | "uniqueVisitors" | "uniqueVisitors.basis" | "uniqueVisitors.exact">;
+}, "required", "affiliates" | "metadata" | "metadata.basis" | "metadata.coverage" | "metadata.coverage.availableFrom" | "metadata.coverage.availableThrough" | "metadata.coverage.generation" | "metadata.coverage.retainedBefore" | "metadata.coverage.state" | "metadata.range" | "metadata.range.boundary" | "metadata.range.from" | "metadata.range.timezone" | "metadata.range.to" | "metadata.uniqueVisitors" | "metadata.uniqueVisitors.basis" | "metadata.uniqueVisitors.exact" | "truncated">;
+declare const hostVitalsReportValidator: import("convex/values").VObject<{
+    metadata: {
+        basis: "boundedLegacy" | "dailyRollup";
+        coverage: {
+            availableFrom: number | null;
+            availableThrough: number | null;
+            generation: number | null;
+            retainedBefore: number | null;
+            state: "complete" | "partial" | "retained" | "unavailable";
+        };
+        range: {
+            boundary: "inclusive";
+            from: number;
+            timezone: string;
+            to: number;
+        };
+    };
+    metrics: {
+        average: number;
+        count: number;
+        devices: {
+            average: number;
+            count: number;
+            device: string;
+            good: number;
+            needsImprovement: number;
+            p75: number;
+            poor: number;
+        }[];
+        good: number;
+        metric: "CLS" | "FCP" | "INP" | "LCP" | "TTFB";
+        needsImprovement: number;
+        p75: number;
+        pages: {
+            average: number;
+            count: number;
+            good: number;
+            needsImprovement: number;
+            p75: number;
+            page: string;
+            poor: number;
+        }[];
+        poor: number;
+        timeSeries: {
+            count: number;
+            p75: number;
+            timestamp: number;
+        }[];
+    }[];
+    truncated: boolean;
+}, {
+    metrics: import("convex/values").VArray<{
+        average: number;
+        count: number;
+        devices: {
+            average: number;
+            count: number;
+            device: string;
+            good: number;
+            needsImprovement: number;
+            p75: number;
+            poor: number;
+        }[];
+        good: number;
+        metric: "CLS" | "FCP" | "INP" | "LCP" | "TTFB";
+        needsImprovement: number;
+        p75: number;
+        pages: {
+            average: number;
+            count: number;
+            good: number;
+            needsImprovement: number;
+            p75: number;
+            page: string;
+            poor: number;
+        }[];
+        poor: number;
+        timeSeries: {
+            count: number;
+            p75: number;
+            timestamp: number;
+        }[];
+    }[], import("convex/values").VObject<{
+        average: number;
+        count: number;
+        devices: {
+            average: number;
+            count: number;
+            device: string;
+            good: number;
+            needsImprovement: number;
+            p75: number;
+            poor: number;
+        }[];
+        good: number;
+        metric: "CLS" | "FCP" | "INP" | "LCP" | "TTFB";
+        needsImprovement: number;
+        p75: number;
+        pages: {
+            average: number;
+            count: number;
+            good: number;
+            needsImprovement: number;
+            p75: number;
+            page: string;
+            poor: number;
+        }[];
+        poor: number;
+        timeSeries: {
+            count: number;
+            p75: number;
+            timestamp: number;
+        }[];
+    }, {
+        count: import("convex/values").VFloat64<number, "required">;
+        p75: import("convex/values").VFloat64<number, "required">;
+        average: import("convex/values").VFloat64<number, "required">;
+        good: import("convex/values").VFloat64<number, "required">;
+        needsImprovement: import("convex/values").VFloat64<number, "required">;
+        poor: import("convex/values").VFloat64<number, "required">;
+        metric: import("convex/values").VUnion<"CLS" | "FCP" | "INP" | "LCP" | "TTFB", [import("convex/values").VLiteral<"LCP", "required">, import("convex/values").VLiteral<"CLS", "required">, import("convex/values").VLiteral<"INP", "required">, import("convex/values").VLiteral<"FCP", "required">, import("convex/values").VLiteral<"TTFB", "required">], "required", never>;
+        devices: import("convex/values").VArray<{
+            average: number;
+            count: number;
+            device: string;
+            good: number;
+            needsImprovement: number;
+            p75: number;
+            poor: number;
+        }[], import("convex/values").VObject<{
+            average: number;
+            count: number;
+            device: string;
+            good: number;
+            needsImprovement: number;
+            p75: number;
+            poor: number;
+        }, {
+            count: import("convex/values").VFloat64<number, "required">;
+            p75: import("convex/values").VFloat64<number, "required">;
+            average: import("convex/values").VFloat64<number, "required">;
+            good: import("convex/values").VFloat64<number, "required">;
+            needsImprovement: import("convex/values").VFloat64<number, "required">;
+            poor: import("convex/values").VFloat64<number, "required">;
+            device: import("convex/values").VString<string, "required">;
+        }, "required", "average" | "count" | "device" | "good" | "needsImprovement" | "p75" | "poor">, "required">;
+        pages: import("convex/values").VArray<{
+            average: number;
+            count: number;
+            good: number;
+            needsImprovement: number;
+            p75: number;
+            page: string;
+            poor: number;
+        }[], import("convex/values").VObject<{
+            average: number;
+            count: number;
+            good: number;
+            needsImprovement: number;
+            p75: number;
+            page: string;
+            poor: number;
+        }, {
+            count: import("convex/values").VFloat64<number, "required">;
+            p75: import("convex/values").VFloat64<number, "required">;
+            average: import("convex/values").VFloat64<number, "required">;
+            good: import("convex/values").VFloat64<number, "required">;
+            needsImprovement: import("convex/values").VFloat64<number, "required">;
+            poor: import("convex/values").VFloat64<number, "required">;
+            page: import("convex/values").VString<string, "required">;
+        }, "required", "average" | "count" | "good" | "needsImprovement" | "p75" | "page" | "poor">, "required">;
+        timeSeries: import("convex/values").VArray<{
+            count: number;
+            p75: number;
+            timestamp: number;
+        }[], import("convex/values").VObject<{
+            count: number;
+            p75: number;
+            timestamp: number;
+        }, {
+            timestamp: import("convex/values").VFloat64<number, "required">;
+            count: import("convex/values").VFloat64<number, "required">;
+            p75: import("convex/values").VFloat64<number, "required">;
+        }, "required", "count" | "p75" | "timestamp">, "required">;
+    }, "required", "average" | "count" | "devices" | "good" | "metric" | "needsImprovement" | "p75" | "pages" | "poor" | "timeSeries">, "required">;
+    truncated: import("convex/values").VBoolean<boolean, "required">;
+    metadata: import("convex/values").VObject<{
+        basis: "boundedLegacy" | "dailyRollup";
+        coverage: {
+            availableFrom: number | null;
+            availableThrough: number | null;
+            generation: number | null;
+            retainedBefore: number | null;
+            state: "complete" | "partial" | "retained" | "unavailable";
+        };
+        range: {
+            boundary: "inclusive";
+            from: number;
+            timezone: string;
+            to: number;
+        };
+    }, {
+        basis: import("convex/values").VUnion<"boundedLegacy" | "dailyRollup", [import("convex/values").VLiteral<"dailyRollup", "required">, import("convex/values").VLiteral<"boundedLegacy", "required">], "required", never>;
+        coverage: import("convex/values").VObject<{
+            availableFrom: number | null;
+            availableThrough: number | null;
+            generation: number | null;
+            retainedBefore: number | null;
+            state: "complete" | "partial" | "retained" | "unavailable";
+        }, {
+            state: import("convex/values").VUnion<"complete" | "partial" | "retained" | "unavailable", [import("convex/values").VLiteral<"complete", "required">, import("convex/values").VLiteral<"partial", "required">, import("convex/values").VLiteral<"retained", "required">, import("convex/values").VLiteral<"unavailable", "required">], "required", never>;
+            generation: import("convex/values").VUnion<number | null, [import("convex/values").VFloat64<number, "required">, import("convex/values").VNull<null, "required">], "required", never>;
+            availableFrom: import("convex/values").VUnion<number | null, [import("convex/values").VFloat64<number, "required">, import("convex/values").VNull<null, "required">], "required", never>;
+            availableThrough: import("convex/values").VUnion<number | null, [import("convex/values").VFloat64<number, "required">, import("convex/values").VNull<null, "required">], "required", never>;
+            retainedBefore: import("convex/values").VUnion<number | null, [import("convex/values").VFloat64<number, "required">, import("convex/values").VNull<null, "required">], "required", never>;
+        }, "required", "availableFrom" | "availableThrough" | "generation" | "retainedBefore" | "state">;
+        range: import("convex/values").VObject<{
+            boundary: "inclusive";
+            from: number;
+            timezone: string;
+            to: number;
+        }, {
+            from: import("convex/values").VFloat64<number, "required">;
+            to: import("convex/values").VFloat64<number, "required">;
+            boundary: import("convex/values").VLiteral<"inclusive", "required">;
+            timezone: import("convex/values").VString<string, "required">;
+        }, "required", "boundary" | "from" | "timezone" | "to">;
+    }, "required", "basis" | "coverage" | "coverage.availableFrom" | "coverage.availableThrough" | "coverage.generation" | "coverage.retainedBefore" | "coverage.state" | "range" | "range.boundary" | "range.from" | "range.timezone" | "range.to">;
+}, "required", "metadata" | "metadata.basis" | "metadata.coverage" | "metadata.coverage.availableFrom" | "metadata.coverage.availableThrough" | "metadata.coverage.generation" | "metadata.coverage.retainedBefore" | "metadata.coverage.state" | "metadata.range" | "metadata.range.boundary" | "metadata.range.from" | "metadata.range.timezone" | "metadata.range.to" | "metrics" | "truncated">;
+declare const hostSiteMapValidator: import("convex/values").VObject<{
+    from: number;
+    metadata: {
+        basis: "boundedLegacy" | "dailyRollup";
+        coverage: {
+            availableFrom: number | null;
+            availableThrough: number | null;
+            generation: number | null;
+            retainedBefore: number | null;
+            state: "complete" | "partial" | "retained" | "unavailable";
+        };
+        limits: {
+            routesPerDay: number;
+            rows: number;
+            transitionSlots: number;
+        };
+        range: {
+            boundary: "inclusive";
+            from: number;
+            timezone: string;
+            to: number;
+        };
+        visitors: {
+            basis: "estimatedUnique";
+            exact: boolean;
+        };
+    };
+    routes: {
+        bounces: number;
+        daily: {
+            bucketStart: number;
+            pageviews: number;
+        }[];
+        dwellMs: number;
+        dwellSamples: number;
+        entries: number;
+        exits: number;
+        pageviews: number;
+        route: string;
+        transitionsIn: number;
+        transitionsOut: number;
+        visitors: number;
+    }[];
+    to: number;
+    transitions: {
+        count: number;
+        from: string;
+        to: string;
+    }[];
+    truncated: {
+        routes: boolean;
+        transitions: boolean;
+    };
+    window: {
+        from: number;
+        to: number;
+    } | null;
+}, {
+    from: import("convex/values").VFloat64<number, "required">;
+    to: import("convex/values").VFloat64<number, "required">;
+    window: import("convex/values").VUnion<{
+        from: number;
+        to: number;
+    } | null, [import("convex/values").VObject<{
+        from: number;
+        to: number;
+    }, {
+        from: import("convex/values").VFloat64<number, "required">;
+        to: import("convex/values").VFloat64<number, "required">;
+    }, "required", "from" | "to">, import("convex/values").VNull<null, "required">], "required", "from" | "to">;
+    routes: import("convex/values").VArray<{
+        bounces: number;
+        daily: {
+            bucketStart: number;
+            pageviews: number;
+        }[];
+        dwellMs: number;
+        dwellSamples: number;
+        entries: number;
+        exits: number;
+        pageviews: number;
+        route: string;
+        transitionsIn: number;
+        transitionsOut: number;
+        visitors: number;
+    }[], import("convex/values").VObject<{
+        bounces: number;
+        daily: {
+            bucketStart: number;
+            pageviews: number;
+        }[];
+        dwellMs: number;
+        dwellSamples: number;
+        entries: number;
+        exits: number;
+        pageviews: number;
+        route: string;
+        transitionsIn: number;
+        transitionsOut: number;
+        visitors: number;
+    }, {
+        route: import("convex/values").VString<string, "required">;
+        pageviews: import("convex/values").VFloat64<number, "required">;
+        visitors: import("convex/values").VFloat64<number, "required">;
+        entries: import("convex/values").VFloat64<number, "required">;
+        exits: import("convex/values").VFloat64<number, "required">;
+        bounces: import("convex/values").VFloat64<number, "required">;
+        transitionsIn: import("convex/values").VFloat64<number, "required">;
+        transitionsOut: import("convex/values").VFloat64<number, "required">;
+        dwellMs: import("convex/values").VFloat64<number, "required">;
+        dwellSamples: import("convex/values").VFloat64<number, "required">;
+        daily: import("convex/values").VArray<{
+            bucketStart: number;
+            pageviews: number;
+        }[], import("convex/values").VObject<{
+            bucketStart: number;
+            pageviews: number;
+        }, {
+            bucketStart: import("convex/values").VFloat64<number, "required">;
+            pageviews: import("convex/values").VFloat64<number, "required">;
+        }, "required", "bucketStart" | "pageviews">, "required">;
+    }, "required", "bounces" | "daily" | "dwellMs" | "dwellSamples" | "entries" | "exits" | "pageviews" | "route" | "transitionsIn" | "transitionsOut" | "visitors">, "required">;
+    transitions: import("convex/values").VArray<{
+        count: number;
+        from: string;
+        to: string;
+    }[], import("convex/values").VObject<{
+        count: number;
+        from: string;
+        to: string;
+    }, {
+        from: import("convex/values").VString<string, "required">;
+        to: import("convex/values").VString<string, "required">;
+        count: import("convex/values").VFloat64<number, "required">;
+    }, "required", "count" | "from" | "to">, "required">;
+    truncated: import("convex/values").VObject<{
+        routes: boolean;
+        transitions: boolean;
+    }, {
+        routes: import("convex/values").VBoolean<boolean, "required">;
+        transitions: import("convex/values").VBoolean<boolean, "required">;
+    }, "required", "routes" | "transitions">;
+    metadata: import("convex/values").VObject<{
+        basis: "boundedLegacy" | "dailyRollup";
+        coverage: {
+            availableFrom: number | null;
+            availableThrough: number | null;
+            generation: number | null;
+            retainedBefore: number | null;
+            state: "complete" | "partial" | "retained" | "unavailable";
+        };
+        limits: {
+            routesPerDay: number;
+            rows: number;
+            transitionSlots: number;
+        };
+        range: {
+            boundary: "inclusive";
+            from: number;
+            timezone: string;
+            to: number;
+        };
+        visitors: {
+            basis: "estimatedUnique";
+            exact: boolean;
+        };
+    }, {
+        basis: import("convex/values").VUnion<"boundedLegacy" | "dailyRollup", [import("convex/values").VLiteral<"dailyRollup", "required">, import("convex/values").VLiteral<"boundedLegacy", "required">], "required", never>;
+        coverage: import("convex/values").VObject<{
+            availableFrom: number | null;
+            availableThrough: number | null;
+            generation: number | null;
+            retainedBefore: number | null;
+            state: "complete" | "partial" | "retained" | "unavailable";
+        }, {
+            state: import("convex/values").VUnion<"complete" | "partial" | "retained" | "unavailable", [import("convex/values").VLiteral<"complete", "required">, import("convex/values").VLiteral<"partial", "required">, import("convex/values").VLiteral<"retained", "required">, import("convex/values").VLiteral<"unavailable", "required">], "required", never>;
+            generation: import("convex/values").VUnion<number | null, [import("convex/values").VFloat64<number, "required">, import("convex/values").VNull<null, "required">], "required", never>;
+            availableFrom: import("convex/values").VUnion<number | null, [import("convex/values").VFloat64<number, "required">, import("convex/values").VNull<null, "required">], "required", never>;
+            availableThrough: import("convex/values").VUnion<number | null, [import("convex/values").VFloat64<number, "required">, import("convex/values").VNull<null, "required">], "required", never>;
+            retainedBefore: import("convex/values").VUnion<number | null, [import("convex/values").VFloat64<number, "required">, import("convex/values").VNull<null, "required">], "required", never>;
+        }, "required", "availableFrom" | "availableThrough" | "generation" | "retainedBefore" | "state">;
+        range: import("convex/values").VObject<{
+            boundary: "inclusive";
+            from: number;
+            timezone: string;
+            to: number;
+        }, {
+            from: import("convex/values").VFloat64<number, "required">;
+            to: import("convex/values").VFloat64<number, "required">;
+            boundary: import("convex/values").VLiteral<"inclusive", "required">;
+            timezone: import("convex/values").VString<string, "required">;
+        }, "required", "boundary" | "from" | "timezone" | "to">;
+        visitors: import("convex/values").VObject<{
+            basis: "estimatedUnique";
+            exact: boolean;
+        }, {
+            basis: import("convex/values").VLiteral<"estimatedUnique", "required">;
+            exact: import("convex/values").VBoolean<boolean, "required">;
+        }, "required", "basis" | "exact">;
+        limits: import("convex/values").VObject<{
+            routesPerDay: number;
+            rows: number;
+            transitionSlots: number;
+        }, {
+            routesPerDay: import("convex/values").VFloat64<number, "required">;
+            transitionSlots: import("convex/values").VFloat64<number, "required">;
+            rows: import("convex/values").VFloat64<number, "required">;
+        }, "required", "routesPerDay" | "rows" | "transitionSlots">;
+    }, "required", "basis" | "coverage" | "coverage.availableFrom" | "coverage.availableThrough" | "coverage.generation" | "coverage.retainedBefore" | "coverage.state" | "limits" | "limits.routesPerDay" | "limits.rows" | "limits.transitionSlots" | "range" | "range.boundary" | "range.from" | "range.timezone" | "range.to" | "visitors" | "visitors.basis" | "visitors.exact">;
+}, "required", "from" | "metadata" | "metadata.basis" | "metadata.coverage" | "metadata.coverage.availableFrom" | "metadata.coverage.availableThrough" | "metadata.coverage.generation" | "metadata.coverage.retainedBefore" | "metadata.coverage.state" | "metadata.limits" | "metadata.limits.routesPerDay" | "metadata.limits.rows" | "metadata.limits.transitionSlots" | "metadata.range" | "metadata.range.boundary" | "metadata.range.from" | "metadata.range.timezone" | "metadata.range.to" | "metadata.visitors" | "metadata.visitors.basis" | "metadata.visitors.exact" | "routes" | "to" | "transitions" | "truncated" | "truncated.routes" | "truncated.transitions" | "window" | "window.from" | "window.to">;
 export declare function exposeAnalyticsApi(component: ComponentApi, options: {
     authorize: AnalyticsAuthorizer;
 }): {
@@ -474,6 +2071,7 @@ export declare function exposeAnalyticsApi(component: ComponentApi, options: {
             latitude?: number | undefined;
             longitude?: number | undefined;
             os?: string | undefined;
+            visitorKey?: string | undefined;
         } | undefined;
         events: {
             affiliateSlug?: string | undefined;
@@ -489,7 +2087,8 @@ export declare function exposeAnalyticsApi(component: ComponentApi, options: {
             sessionId: string;
             target?: string | undefined;
             timestamp: number;
-            type: "click" | "conversion" | "custom" | "heartbeat" | "outbound" | "pageview";
+            type: "click" | "conversion" | "custom" | "heartbeat" | "leave" | "outbound" | "pageview" | "vital";
+            value?: number | undefined;
             visitorId: string;
         }[];
         origin: string;
@@ -515,6 +2114,14 @@ export declare function exposeAnalyticsApi(component: ComponentApi, options: {
         duplicates: number;
         rejected: number;
     }>>;
+    linkVisitor: import("convex/server").RegisteredMutation<"public", {
+        previousVisitorId: string;
+        siteId: string;
+        visitorId: string;
+    }, Promise<{
+        aliasCount: number;
+        linked: boolean;
+    }>>;
     overview: import("convex/server").RegisteredQuery<"public", {
         from: number;
         interval?: "day" | "hour" | undefined;
@@ -524,11 +2131,53 @@ export declare function exposeAnalyticsApi(component: ComponentApi, options: {
         currency: string;
         from: number;
         interval: "hour" | "day";
+        metadata: {
+            breakdowns: {
+                topBrowsers: "pageviews" | "sessions" | "eventVolume";
+                topCampaigns: "pageviews" | "sessions" | "eventVolume";
+                topCountries: "pageviews" | "sessions" | "eventVolume";
+                topDevices: "pageviews" | "sessions" | "eventVolume";
+                topEvents: "eventVolume";
+                topGoals: "goalCompletionVolume";
+                topPages: "pageviews" | "sessions" | "eventVolume";
+                topSources: "pageviews" | "sessions" | "eventVolume";
+            };
+            coverage: {
+                availableFrom: number | null;
+                availableThrough: number | null;
+                generation: number | null;
+                retainedBefore: number | null;
+                state: "complete" | "partial" | "retained" | "unavailable";
+            };
+            engagement: "counted" | "unavailable";
+            features: {
+                botDetection: "userAgent";
+                errorInsights: "unsupported";
+                outboundLinks: "eventVolume";
+                sessionReplay: "unsupported";
+            };
+            range: {
+                boundary: "inclusive";
+                from: number;
+                timezone: string;
+                to: number;
+            };
+            visitors: {
+                basis: "estimatedUnique" | "bucketOccurrences";
+                exact: boolean;
+                legacyIncomplete: boolean;
+                precision: number | null;
+                sketchVersion: number | null;
+            };
+        };
         timeSeries: Array<{
             clicks: number;
+            continuedSessions: number;
             conversions: number;
             customEvents: number;
+            durationMs: number;
             events: number;
+            newVisitors: number;
             outboundClicks: number;
             pageviews: number;
             revenueCents: number;
@@ -542,6 +2191,11 @@ export declare function exposeAnalyticsApi(component: ComponentApi, options: {
             revenueCents: number;
             value: string;
         }>;
+        topCampaigns: Array<{
+            count: number;
+            revenueCents: number;
+            value: string;
+        }>;
         topCountries: Array<{
             count: number;
             revenueCents: number;
@@ -574,9 +2228,12 @@ export declare function exposeAnalyticsApi(component: ComponentApi, options: {
         }>;
         totals: {
             clicks: number;
+            continuedSessions: number;
             conversions: number;
             customEvents: number;
+            durationMs: number;
             events: number;
+            newVisitors: number;
             outboundClicks: number;
             pageviews: number;
             revenueCents: number;
@@ -600,9 +2257,11 @@ export declare function exposeAnalyticsApi(component: ComponentApi, options: {
         lastSeenAt: number;
         latitude?: number;
         longitude?: number;
+        movedAt?: number;
         os: string;
         pageviewCount: number;
         path: string;
+        previousPath?: string;
         sessionId: string;
         siteId: string;
         source: string;
@@ -656,6 +2315,7 @@ export declare function exposeAnalyticsApi(component: ComponentApi, options: {
             utmMedium?: string;
             utmSource?: string;
             visitorId: string;
+            visitorKey?: string;
         }>;
         pageStatus?: "SplitRecommended" | "SplitRequired" | null;
         splitCursor?: string | null;
@@ -700,7 +2360,7 @@ export declare function exposeAnalyticsApi(component: ComponentApi, options: {
             siteId: string;
             target?: string;
             timestamp: number;
-            type: "pageview" | "click" | "custom" | "conversion" | "heartbeat" | "outbound";
+            type: "pageview" | "click" | "custom" | "conversion" | "heartbeat" | "leave" | "outbound" | "vital";
             visitorId: string;
         }>;
         pageStatus?: "SplitRecommended" | "SplitRequired" | null;
@@ -773,7 +2433,7 @@ export declare function exposeAnalyticsApi(component: ComponentApi, options: {
         siteId: string;
         target?: string;
         timestamp: number;
-        type: "pageview" | "click" | "custom" | "conversion" | "heartbeat" | "outbound";
+        type: "pageview" | "click" | "custom" | "conversion" | "heartbeat" | "leave" | "outbound" | "vital";
         visitorId: string;
     }[]>>;
     goalsReport: import("convex/server").RegisteredQuery<"public", {
@@ -795,6 +2455,22 @@ export declare function exposeAnalyticsApi(component: ComponentApi, options: {
             updatedAt: number;
             valueCents: number;
         }>;
+        metadata: {
+            basis: "dailyRollup" | "boundedLegacy";
+            coverage: {
+                availableFrom: number | null;
+                availableThrough: number | null;
+                generation: number | null;
+                retainedBefore: number | null;
+                state: "complete" | "partial" | "retained" | "unavailable";
+            };
+            range: {
+                boundary: "inclusive";
+                from: number;
+                timezone: string;
+                to: number;
+            };
+        };
         truncated: boolean;
     }>>;
     funnelsReport: import("convex/server").RegisteredQuery<"public", {
@@ -808,6 +2484,22 @@ export declare function exposeAnalyticsApi(component: ComponentApi, options: {
         conversionWindowMs: number;
         createdAt: number;
         key: string;
+        metadata: {
+            basis: "dailyRollup" | "boundedLegacy";
+            coverage: {
+                availableFrom: number | null;
+                availableThrough: number | null;
+                generation: number | null;
+                retainedBefore: number | null;
+                state: "complete" | "partial" | "retained" | "unavailable";
+            };
+            range: {
+                boundary: "inclusive";
+                from: number;
+                timezone: string;
+                to: number;
+            };
+        };
         name: string;
         siteId: string;
         steps: Array<{
@@ -846,8 +2538,205 @@ export declare function exposeAnalyticsApi(component: ComponentApi, options: {
             updatedAt: number;
             visits: number;
         }>;
+        metadata: {
+            basis: "dailyRollup" | "boundedLegacy";
+            coverage: {
+                availableFrom: number | null;
+                availableThrough: number | null;
+                generation: number | null;
+                retainedBefore: number | null;
+                state: "complete" | "partial" | "retained" | "unavailable";
+            };
+            range: {
+                boundary: "inclusive";
+                from: number;
+                timezone: string;
+                to: number;
+            };
+            uniqueVisitors: {
+                basis: "estimatedUnique" | "exactLegacy";
+                exact: boolean;
+            };
+        };
+        truncated: boolean;
+    }>>;
+    vitalsReport: import("convex/server").RegisteredQuery<"public", {
+        from: number;
+        siteId: string;
+        to: number;
+    }, Promise<{
+        metadata: {
+            basis: "dailyRollup" | "boundedLegacy";
+            coverage: {
+                availableFrom: number | null;
+                availableThrough: number | null;
+                generation: number | null;
+                retainedBefore: number | null;
+                state: "complete" | "partial" | "retained" | "unavailable";
+            };
+            range: {
+                boundary: "inclusive";
+                from: number;
+                timezone: string;
+                to: number;
+            };
+        };
+        metrics: Array<{
+            average: number;
+            count: number;
+            devices: Array<{
+                average: number;
+                count: number;
+                device: string;
+                good: number;
+                needsImprovement: number;
+                p75: number;
+                poor: number;
+            }>;
+            good: number;
+            metric: "LCP" | "CLS" | "INP" | "FCP" | "TTFB";
+            needsImprovement: number;
+            p75: number;
+            pages: Array<{
+                average: number;
+                count: number;
+                good: number;
+                needsImprovement: number;
+                p75: number;
+                page: string;
+                poor: number;
+            }>;
+            poor: number;
+            timeSeries: Array<{
+                count: number;
+                p75: number;
+                timestamp: number;
+            }>;
+        }>;
         truncated: boolean;
     }>>;
+    siteMap: import("convex/server").RegisteredQuery<"public", {
+        from: number;
+        siteIds: string[];
+        to: number;
+    }, Promise<{
+        from: number;
+        metadata: {
+            basis: "dailyRollup" | "boundedLegacy";
+            coverage: {
+                availableFrom: number | null;
+                availableThrough: number | null;
+                generation: number | null;
+                retainedBefore: number | null;
+                state: "complete" | "partial" | "retained" | "unavailable";
+            };
+            limits: {
+                routesPerDay: number;
+                rows: number;
+                transitionSlots: number;
+            };
+            range: {
+                boundary: "inclusive";
+                from: number;
+                timezone: string;
+                to: number;
+            };
+            visitors: {
+                basis: "estimatedUnique";
+                exact: boolean;
+            };
+        };
+        routes: Array<{
+            bounces: number;
+            daily: Array<{
+                bucketStart: number;
+                pageviews: number;
+            }>;
+            dwellMs: number;
+            dwellSamples: number;
+            entries: number;
+            exits: number;
+            pageviews: number;
+            route: string;
+            transitionsIn: number;
+            transitionsOut: number;
+            visitors: number;
+        }>;
+        to: number;
+        transitions: Array<{
+            count: number;
+            from: string;
+            to: string;
+        }>;
+        truncated: {
+            routes: boolean;
+            transitions: boolean;
+        };
+        window: {
+            from: number;
+            to: number;
+        } | null;
+    }>>;
+    dataCoverage: import("convex/server").RegisteredQuery<"public", {
+        from: number;
+        siteId: string;
+        to: number;
+    }, Promise<{
+        datasets: Array<{
+            coverage: {
+                availableFrom: number | null;
+                availableThrough: number | null;
+                generation: number | null;
+                retainedBefore: number | null;
+                state: "complete" | "partial" | "retained" | "unavailable";
+            };
+            dataset: "overviewHour" | "overviewDay" | "overviewLocalDay" | "events" | "sessions" | "conversions" | "goals" | "funnels" | "affiliates" | "vitals" | "siteMap";
+        }>;
+        from: number;
+        siteId: string;
+        to: number;
+    }>>;
+    retentionStatus: import("convex/server").RegisteredQuery<"public", {
+        siteId: string;
+    }, Promise<{
+        backlog: number;
+        jobs: Array<{
+            before: number;
+            deleted: number;
+            kind: "events" | "sessions" | "conversions" | "goalCompletions" | "aggregateHour" | "aggregateDay" | "funnelProgress" | "funnelSteps" | "affiliateStats" | "goalRollups" | "funnelRollups" | "affiliateRollups" | "vitalRollups" | "siteMapRollups" | "attributions" | "liveSessions" | "ingestWindows" | "siteIngestWindows";
+            scheduledAt: number | null;
+            status: "pending" | "running" | "complete";
+            updatedAt: number;
+        }>;
+        policy: {
+            aggregatesDays: number;
+            conversionsDays: number;
+            eventsDays: number;
+            reportsDays: number;
+            sessionsDays: number;
+            updatedAt: number;
+        } | null;
+    }>>;
+    setRetentionPolicy: import("convex/server").RegisteredMutation<"public", {
+        aggregatesDays: number;
+        conversionsDays: number;
+        eventsDays: number;
+        reportsDays: number;
+        sessionsDays: number;
+        siteId: string;
+    }, Promise<null>>;
+    disableRetentionPolicy: import("convex/server").RegisteredMutation<"public", {
+        siteId: string;
+    }, Promise<null>>;
+    runRetentionPolicy: import("convex/server").RegisteredMutation<"public", {
+        batchSize?: number | undefined;
+        kind: "affiliateRollups" | "affiliateStats" | "aggregateDay" | "aggregateHour" | "attributions" | "conversions" | "events" | "funnelProgress" | "funnelRollups" | "funnelSteps" | "goalCompletions" | "goalRollups" | "ingestWindows" | "liveSessions" | "sessions" | "siteIngestWindows" | "siteMapRollups" | "vitalRollups";
+        siteId: string;
+    }, Promise<{
+        before: number;
+        deleted: number;
+        hasMore: boolean;
+    }>>;
     upsertGoal: import("convex/server").RegisteredMutation<"public", {
         active?: boolean | undefined;
         goalId?: string | undefined;
@@ -942,16 +2831,785 @@ export declare function exposeAnalyticsApi(component: ComponentApi, options: {
     cleanupAnalytics: import("convex/server").RegisteredMutation<"public", {
         batchSize?: number | undefined;
         before: number;
-        kind: "affiliateStats" | "aggregateDay" | "aggregateHour" | "attributions" | "conversions" | "events" | "funnelProgress" | "funnelSteps" | "goalCompletions" | "ingestWindows" | "liveSessions" | "sessions" | "siteIngestWindows";
+        kind: "affiliateRollups" | "affiliateStats" | "aggregateDay" | "aggregateHour" | "attributions" | "conversions" | "events" | "funnelProgress" | "funnelRollups" | "funnelSteps" | "goalCompletions" | "goalRollups" | "ingestWindows" | "liveSessions" | "sessions" | "siteIngestWindows" | "vitalRollups";
         siteId: string;
     }, Promise<{
+        before: number;
         deleted: number;
         hasMore: boolean;
     }>>;
 };
+/**
+ * Exposes the reactive read surface a federated Rastro dashboard subscribes to,
+ * plus the configuration functions behind the `configure` capability, which
+ * run only when the token and the host's grant both carry the configure
+ * permission.
+ */
+export declare function exposeFederatedAnalyticsApi(component: ComponentApi, options: FederatedAnalyticsAuthorizerOptions): {
+    manifest: import("convex/server").RegisteredQuery<"public", {}, {
+        protocol: "amage-rastro-analytics";
+        protocolVersion: 1;
+        moduleName: "rastroFederation";
+        functions: {
+            manifest: "manifest";
+            connectionStatus: "connectionStatus";
+            listSites: "listSites";
+            overview: "overview";
+            liveVisitors: "liveVisitors";
+            listSessions: "listSessions";
+            sessionJourney: "sessionJourney";
+            listConversions: "listConversions";
+            visitorJourney: "visitorJourney";
+            goalsReport: "goalsReport";
+            funnelsReport: "funnelsReport";
+            affiliatesReport: "affiliatesReport";
+            dataCoverage: "dataCoverage";
+            siteSettings: "siteSettings";
+            updateSite: "updateSite";
+            listGoals: "listGoals";
+            upsertGoal: "upsertGoal";
+            removeGoal: "removeGoal";
+            listFunnels: "listFunnels";
+            upsertFunnel: "upsertFunnel";
+            removeFunnel: "removeFunnel";
+            listAffiliates: "listAffiliates";
+            upsertAffiliate: "upsertAffiliate";
+            removeAffiliate: "removeAffiliate";
+            retentionStatus: "retentionStatus";
+            setRetentionPolicy: "setRetentionPolicy";
+            disableRetentionPolicy: "disableRetentionPolicy";
+            vitalsReport: "vitalsReport";
+            siteMap: "siteMap";
+        };
+        capabilities: ("affiliates" | "configure" | "conversions" | "dataCoverage" | "funnels" | "goals" | "liveVisitors" | "localDays" | "overview" | "sessionJourney" | "sessions" | "siteMap" | "siteSummaries" | "visitorJourney" | "vitals")[];
+        limits: {
+            maxSitesPerRequest: 10;
+            maxSitesPerConnection: 10;
+            maxReportRangeDays: 366;
+            maxLiveVisitors: 500;
+            maxJourneyEvents: 500;
+        };
+    }>;
+    connectionStatus: import("convex/server").RegisteredQuery<"public", {}, Promise<FederatedAnalyticsConnectionStatus>>;
+    listSites: import("convex/server").RegisteredQuery<"public", {}, Promise<FederatedSiteSummary[]>>;
+    overview: import("convex/server").RegisteredQuery<"public", {
+        from: number;
+        interval?: "day" | "hour" | undefined;
+        siteIds: string[];
+        to: number;
+    }, Promise<{
+        currency: string;
+        from: number;
+        interval: "hour" | "day";
+        metadata: {
+            breakdowns: {
+                topBrowsers: "pageviews" | "sessions" | "eventVolume";
+                topCampaigns: "pageviews" | "sessions" | "eventVolume";
+                topCountries: "pageviews" | "sessions" | "eventVolume";
+                topDevices: "pageviews" | "sessions" | "eventVolume";
+                topEvents: "eventVolume";
+                topGoals: "goalCompletionVolume";
+                topPages: "pageviews" | "sessions" | "eventVolume";
+                topSources: "pageviews" | "sessions" | "eventVolume";
+            };
+            coverage: {
+                availableFrom: number | null;
+                availableThrough: number | null;
+                generation: number | null;
+                retainedBefore: number | null;
+                state: "complete" | "partial" | "retained" | "unavailable";
+            };
+            engagement: "counted" | "unavailable";
+            features: {
+                botDetection: "userAgent";
+                errorInsights: "unsupported";
+                outboundLinks: "eventVolume";
+                sessionReplay: "unsupported";
+            };
+            range: {
+                boundary: "inclusive";
+                from: number;
+                timezone: string;
+                to: number;
+            };
+            visitors: {
+                basis: "estimatedUnique" | "bucketOccurrences";
+                exact: boolean;
+                legacyIncomplete: boolean;
+                precision: number | null;
+                sketchVersion: number | null;
+            };
+        };
+        timeSeries: Array<{
+            clicks: number;
+            continuedSessions: number;
+            conversions: number;
+            customEvents: number;
+            durationMs: number;
+            events: number;
+            newVisitors: number;
+            outboundClicks: number;
+            pageviews: number;
+            revenueCents: number;
+            sessions: number;
+            timestamp: number;
+            visitors: number;
+        }>;
+        to: number;
+        topBrowsers: Array<{
+            count: number;
+            revenueCents: number;
+            value: string;
+        }>;
+        topCampaigns: Array<{
+            count: number;
+            revenueCents: number;
+            value: string;
+        }>;
+        topCountries: Array<{
+            count: number;
+            revenueCents: number;
+            value: string;
+        }>;
+        topDevices: Array<{
+            count: number;
+            revenueCents: number;
+            value: string;
+        }>;
+        topEvents: Array<{
+            count: number;
+            revenueCents: number;
+            value: string;
+        }>;
+        topGoals: Array<{
+            count: number;
+            revenueCents: number;
+            value: string;
+        }>;
+        topPages: Array<{
+            count: number;
+            revenueCents: number;
+            value: string;
+        }>;
+        topSources: Array<{
+            count: number;
+            revenueCents: number;
+            value: string;
+        }>;
+        totals: {
+            clicks: number;
+            continuedSessions: number;
+            conversions: number;
+            customEvents: number;
+            durationMs: number;
+            events: number;
+            newVisitors: number;
+            outboundClicks: number;
+            pageviews: number;
+            revenueCents: number;
+            sessions: number;
+            visitors: number;
+        };
+    }>>;
+    liveVisitors: import("convex/server").RegisteredQuery<"public", {
+        limit?: number | undefined;
+        now: number;
+        siteIds: string[];
+    }, Promise<{
+        _creationTime: number;
+        _id: string;
+        browser: string;
+        city?: string;
+        country?: string;
+        device: string;
+        eventCount: number;
+        expiresAt: number;
+        lastSeenAt: number;
+        latitude?: number;
+        longitude?: number;
+        movedAt?: number;
+        os: string;
+        pageviewCount: number;
+        path: string;
+        previousPath?: string;
+        sessionId: string;
+        siteId: string;
+        source: string;
+        startedAt: number;
+        visitorId: string;
+    }[]>>;
+    listSessions: import("convex/server").RegisteredQuery<"public", {
+        from: number;
+        paginationOpts: {
+            id?: number;
+            endCursor?: string | null;
+            maximumRowsRead?: number;
+            maximumBytesRead?: number;
+            numItems: number;
+            cursor: string | null;
+        };
+        siteId: string;
+        to: number;
+    }, Promise<{
+        continueCursor: string;
+        isDone: boolean;
+        page: Array<{
+            _creationTime: number;
+            _id: string;
+            affiliateAttributedAt?: number;
+            affiliateExpiresAt?: number;
+            affiliateId?: string;
+            affiliateSlug?: string;
+            browser: string;
+            city?: string;
+            conversionCount: number;
+            country?: string;
+            currency?: string;
+            device: string;
+            durationMs: number;
+            entryPath: string;
+            eventCount: number;
+            exitPath: string;
+            lastSeenAt: number;
+            latitude?: number;
+            longitude?: number;
+            os: string;
+            pageviewCount: number;
+            referrer?: string;
+            revenueCents: number;
+            sessionId: string;
+            siteId: string;
+            source: string;
+            startedAt: number;
+            utmCampaign?: string;
+            utmMedium?: string;
+            utmSource?: string;
+            visitorId: string;
+            visitorKey?: string;
+        }>;
+        pageStatus?: "SplitRecommended" | "SplitRequired" | null;
+        splitCursor?: string | null;
+    }>>;
+    sessionJourney: import("convex/server").RegisteredQuery<"public", {
+        from: number;
+        paginationOpts: {
+            id?: number;
+            endCursor?: string | null;
+            maximumRowsRead?: number;
+            maximumBytesRead?: number;
+            numItems: number;
+            cursor: string | null;
+        };
+        sessionId: string;
+        siteId: string;
+        to: number;
+    }, Promise<{
+        continueCursor: string;
+        isDone: boolean;
+        page: Array<{
+            _creationTime: number;
+            _id: string;
+            affiliateSlug?: string;
+            browser: string;
+            city?: string;
+            country?: string;
+            currency?: string;
+            device: string;
+            eventId: string;
+            href?: string;
+            latitude?: number;
+            longitude?: number;
+            name?: string;
+            os: string;
+            path: string;
+            properties?: Record<string, string | number | boolean | null>;
+            referrer?: string;
+            revenueCents?: number;
+            sequence: number;
+            sessionId: string;
+            siteId: string;
+            target?: string;
+            timestamp: number;
+            type: "pageview" | "click" | "custom" | "conversion" | "heartbeat" | "leave" | "outbound" | "vital";
+            visitorId: string;
+        }>;
+        pageStatus?: "SplitRecommended" | "SplitRequired" | null;
+        splitCursor?: string | null;
+    }>>;
+    listConversions: import("convex/server").RegisteredQuery<"public", {
+        from: number;
+        paginationOpts: {
+            id?: number;
+            endCursor?: string | null;
+            maximumRowsRead?: number;
+            maximumBytesRead?: number;
+            numItems: number;
+            cursor: string | null;
+        };
+        siteId: string;
+        to: number;
+    }, Promise<{
+        continueCursor: string;
+        isDone: boolean;
+        page: Array<{
+            _creationTime: number;
+            _id: string;
+            affiliateAttributedAt?: number;
+            affiliateExpiresAt?: number;
+            affiliateId?: string;
+            affiliateSlug?: string;
+            commissionCents: number;
+            currency: string;
+            eventId: string;
+            goalKey?: string;
+            path: string;
+            revenueCents: number;
+            sessionId: string;
+            siteId: string;
+            source: "tracker" | "trusted";
+            timestamp: number;
+            visitorId: string;
+        }>;
+        pageStatus?: "SplitRecommended" | "SplitRequired" | null;
+        splitCursor?: string | null;
+    }>>;
+    visitorJourney: import("convex/server").RegisteredQuery<"public", {
+        from: number;
+        limit?: number | undefined;
+        siteIds: string[];
+        to: number;
+        visitorId: string;
+    }, Promise<{
+        _creationTime: number;
+        _id: string;
+        affiliateSlug?: string;
+        browser: string;
+        city?: string;
+        country?: string;
+        currency?: string;
+        device: string;
+        eventId: string;
+        href?: string;
+        latitude?: number;
+        longitude?: number;
+        name?: string;
+        os: string;
+        path: string;
+        properties?: Record<string, string | number | boolean | null>;
+        referrer?: string;
+        revenueCents?: number;
+        sequence: number;
+        sessionId: string;
+        siteId: string;
+        target?: string;
+        timestamp: number;
+        type: "pageview" | "click" | "custom" | "conversion" | "heartbeat" | "leave" | "outbound" | "vital";
+        visitorId: string;
+    }[]>>;
+    goalsReport: import("convex/server").RegisteredQuery<"public", {
+        from: number;
+        siteId: string;
+        to: number;
+    }, Promise<{
+        goals: Array<{
+            _creationTime: number;
+            _id: string;
+            active: boolean;
+            completions: number;
+            createdAt: number;
+            key: string;
+            matchType: "pageview" | "custom";
+            matchValue: string;
+            name: string;
+            siteId: string;
+            updatedAt: number;
+            valueCents: number;
+        }>;
+        metadata: {
+            basis: "dailyRollup" | "boundedLegacy";
+            coverage: {
+                availableFrom: number | null;
+                availableThrough: number | null;
+                generation: number | null;
+                retainedBefore: number | null;
+                state: "complete" | "partial" | "retained" | "unavailable";
+            };
+            range: {
+                boundary: "inclusive";
+                from: number;
+                timezone: string;
+                to: number;
+            };
+        };
+        truncated: boolean;
+    }>>;
+    funnelsReport: import("convex/server").RegisteredQuery<"public", {
+        from: number;
+        siteId: string;
+        to: number;
+    }, Promise<{
+        _creationTime: number;
+        _id: string;
+        active: boolean;
+        conversionWindowMs: number;
+        createdAt: number;
+        key: string;
+        metadata: {
+            basis: "dailyRollup" | "boundedLegacy";
+            coverage: {
+                availableFrom: number | null;
+                availableThrough: number | null;
+                generation: number | null;
+                retainedBefore: number | null;
+                state: "complete" | "partial" | "retained" | "unavailable";
+            };
+            range: {
+                boundary: "inclusive";
+                from: number;
+                timezone: string;
+                to: number;
+            };
+        };
+        name: string;
+        siteId: string;
+        steps: Array<{
+            name: string;
+            type: "pageview" | "custom";
+            value: string;
+        }>;
+        stepsReport: Array<{
+            completions: number;
+            entrants: number;
+            name: string;
+            step: number;
+        }>;
+        truncated: boolean;
+        updatedAt: number;
+    }[]>>;
+    affiliatesReport: import("convex/server").RegisteredQuery<"public", {
+        from: number;
+        siteId: string;
+        to: number;
+    }, Promise<{
+        affiliates: Array<{
+            _creationTime: number;
+            _id: string;
+            active: boolean;
+            attributionWindowDays: number;
+            commissionBps: number;
+            commissionCents: number;
+            conversions: number;
+            createdAt: number;
+            name: string;
+            revenueCents: number;
+            siteId: string;
+            slug: string;
+            uniqueVisitors: number;
+            updatedAt: number;
+            visits: number;
+        }>;
+        metadata: {
+            basis: "dailyRollup" | "boundedLegacy";
+            coverage: {
+                availableFrom: number | null;
+                availableThrough: number | null;
+                generation: number | null;
+                retainedBefore: number | null;
+                state: "complete" | "partial" | "retained" | "unavailable";
+            };
+            range: {
+                boundary: "inclusive";
+                from: number;
+                timezone: string;
+                to: number;
+            };
+            uniqueVisitors: {
+                basis: "estimatedUnique" | "exactLegacy";
+                exact: boolean;
+            };
+        };
+        truncated: boolean;
+    }>>;
+    vitalsReport: import("convex/server").RegisteredQuery<"public", {
+        from: number;
+        siteId: string;
+        to: number;
+    }, Promise<{
+        metadata: {
+            basis: "dailyRollup" | "boundedLegacy";
+            coverage: {
+                availableFrom: number | null;
+                availableThrough: number | null;
+                generation: number | null;
+                retainedBefore: number | null;
+                state: "complete" | "partial" | "retained" | "unavailable";
+            };
+            range: {
+                boundary: "inclusive";
+                from: number;
+                timezone: string;
+                to: number;
+            };
+        };
+        metrics: Array<{
+            average: number;
+            count: number;
+            devices: Array<{
+                average: number;
+                count: number;
+                device: string;
+                good: number;
+                needsImprovement: number;
+                p75: number;
+                poor: number;
+            }>;
+            good: number;
+            metric: "LCP" | "CLS" | "INP" | "FCP" | "TTFB";
+            needsImprovement: number;
+            p75: number;
+            pages: Array<{
+                average: number;
+                count: number;
+                good: number;
+                needsImprovement: number;
+                p75: number;
+                page: string;
+                poor: number;
+            }>;
+            poor: number;
+            timeSeries: Array<{
+                count: number;
+                p75: number;
+                timestamp: number;
+            }>;
+        }>;
+        truncated: boolean;
+    }>>;
+    siteMap: import("convex/server").RegisteredQuery<"public", {
+        from: number;
+        siteIds: string[];
+        to: number;
+    }, Promise<{
+        from: number;
+        metadata: {
+            basis: "dailyRollup" | "boundedLegacy";
+            coverage: {
+                availableFrom: number | null;
+                availableThrough: number | null;
+                generation: number | null;
+                retainedBefore: number | null;
+                state: "complete" | "partial" | "retained" | "unavailable";
+            };
+            limits: {
+                routesPerDay: number;
+                rows: number;
+                transitionSlots: number;
+            };
+            range: {
+                boundary: "inclusive";
+                from: number;
+                timezone: string;
+                to: number;
+            };
+            visitors: {
+                basis: "estimatedUnique";
+                exact: boolean;
+            };
+        };
+        routes: Array<{
+            bounces: number;
+            daily: Array<{
+                bucketStart: number;
+                pageviews: number;
+            }>;
+            dwellMs: number;
+            dwellSamples: number;
+            entries: number;
+            exits: number;
+            pageviews: number;
+            route: string;
+            transitionsIn: number;
+            transitionsOut: number;
+            visitors: number;
+        }>;
+        to: number;
+        transitions: Array<{
+            count: number;
+            from: string;
+            to: string;
+        }>;
+        truncated: {
+            routes: boolean;
+            transitions: boolean;
+        };
+        window: {
+            from: number;
+            to: number;
+        } | null;
+    }>>;
+    dataCoverage: import("convex/server").RegisteredQuery<"public", {
+        from: number;
+        siteId: string;
+        to: number;
+    }, Promise<{
+        datasets: Array<{
+            coverage: {
+                availableFrom: number | null;
+                availableThrough: number | null;
+                generation: number | null;
+                retainedBefore: number | null;
+                state: "complete" | "partial" | "retained" | "unavailable";
+            };
+            dataset: "overviewHour" | "overviewDay" | "overviewLocalDay" | "events" | "sessions" | "conversions" | "goals" | "funnels" | "affiliates" | "vitals" | "siteMap";
+        }>;
+        from: number;
+        siteId: string;
+        to: number;
+    }>>;
+    siteSettings: import("convex/server").RegisteredQuery<"public", {
+        siteId: string;
+    }, Promise<{
+        siteId: string;
+        name: string;
+        domains: string[];
+        timezone: string | null;
+        currency: string;
+        cookieless: boolean;
+    }>>;
+    updateSite: import("convex/server").RegisteredMutation<"public", {
+        domains?: string[] | undefined;
+        name?: string | undefined;
+        siteId: string;
+        timezone?: string | null | undefined;
+    }, Promise<null>>;
+    listGoals: import("convex/server").RegisteredQuery<"public", {
+        siteId: string;
+    }, Promise<{
+        _creationTime: number;
+        _id: string;
+        active: boolean;
+        createdAt: number;
+        key: string;
+        matchType: "pageview" | "custom";
+        matchValue: string;
+        name: string;
+        siteId: string;
+        updatedAt: number;
+        valueCents?: number;
+    }[]>>;
+    upsertGoal: import("convex/server").RegisteredMutation<"public", {
+        active?: boolean | undefined;
+        goalId?: string | undefined;
+        key: string;
+        matchType: "custom" | "pageview";
+        matchValue: string;
+        name: string;
+        siteId: string;
+        valueCents?: number | undefined;
+    }, Promise<string>>;
+    removeGoal: import("convex/server").RegisteredMutation<"public", {
+        goalId: string;
+        siteId: string;
+    }, Promise<null>>;
+    listFunnels: import("convex/server").RegisteredQuery<"public", {
+        siteId: string;
+    }, Promise<{
+        _creationTime: number;
+        _id: string;
+        active: boolean;
+        conversionWindowMs: number;
+        createdAt: number;
+        key: string;
+        name: string;
+        siteId: string;
+        steps: Array<{
+            name: string;
+            type: "pageview" | "custom";
+            value: string;
+        }>;
+        updatedAt: number;
+    }[]>>;
+    upsertFunnel: import("convex/server").RegisteredMutation<"public", {
+        active?: boolean | undefined;
+        conversionWindowMs: number;
+        funnelId?: string | undefined;
+        key: string;
+        name: string;
+        siteId: string;
+        steps: {
+            name: string;
+            type: "custom" | "pageview";
+            value: string;
+        }[];
+    }, Promise<string>>;
+    removeFunnel: import("convex/server").RegisteredMutation<"public", {
+        funnelId: string;
+        siteId: string;
+    }, Promise<null>>;
+    listAffiliates: import("convex/server").RegisteredQuery<"public", {
+        siteId: string;
+    }, Promise<{
+        _creationTime: number;
+        _id: string;
+        active: boolean;
+        attributionWindowDays: number;
+        commissionBps: number;
+        createdAt: number;
+        name: string;
+        siteId: string;
+        slug: string;
+        updatedAt: number;
+    }[]>>;
+    upsertAffiliate: import("convex/server").RegisteredMutation<"public", {
+        active?: boolean | undefined;
+        affiliateId?: string | undefined;
+        attributionWindowDays: number;
+        commissionBps: number;
+        name: string;
+        siteId: string;
+        slug: string;
+    }, Promise<string>>;
+    removeAffiliate: import("convex/server").RegisteredMutation<"public", {
+        affiliateId: string;
+        siteId: string;
+    }, Promise<null>>;
+    retentionStatus: import("convex/server").RegisteredQuery<"public", {
+        siteId: string;
+    }, Promise<{
+        backlog: number;
+        jobs: Array<{
+            before: number;
+            deleted: number;
+            kind: "events" | "sessions" | "conversions" | "goalCompletions" | "aggregateHour" | "aggregateDay" | "funnelProgress" | "funnelSteps" | "affiliateStats" | "goalRollups" | "funnelRollups" | "affiliateRollups" | "vitalRollups" | "siteMapRollups" | "attributions" | "liveSessions" | "ingestWindows" | "siteIngestWindows";
+            scheduledAt: number | null;
+            status: "pending" | "running" | "complete";
+            updatedAt: number;
+        }>;
+        policy: {
+            aggregatesDays: number;
+            conversionsDays: number;
+            eventsDays: number;
+            reportsDays: number;
+            sessionsDays: number;
+            updatedAt: number;
+        } | null;
+    }>>;
+    setRetentionPolicy: import("convex/server").RegisteredMutation<"public", {
+        aggregatesDays: number;
+        conversionsDays: number;
+        eventsDays: number;
+        reportsDays: number;
+        sessionsDays: number;
+        siteId: string;
+    }, Promise<null>>;
+    disableRetentionPolicy: import("convex/server").RegisteredMutation<"public", {
+        siteId: string;
+    }, Promise<null>>;
+};
 export declare function componentHttpPaths(prefix?: string): {
     readonly events: `${string}/events`;
     readonly tracker: `${string}/tracker.js`;
+    readonly vitals: `${string}/vitals.js`;
     readonly health: `${string}/health`;
 };
 type QueryCtx = Pick<GenericQueryCtx<GenericDataModel>, "runQuery">;