@iann29/rastro 0.1.0-alpha.2 → 0.1.0-alpha.4

package/dist/client/index.d.ts

@@ -1,8 +1,12 @@
 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";
+import { type FederatedAnalyticsAuthorizerOptions, type FederatedAnalyticsConnectionStatus, type FederatedSiteSummary } from "./federation.js";
 export { eventPropertiesValidator, eventTypeValidator, funnelStepValidator, goalMatchTypeValidator, ingestContextValidator, ingestResultValidator, trackerEventValidator, };
 export type { EventProperties, EventType, FunnelStep, IngestContext, TrackerEvent, } from "../component/validators.js";
+export { FEDERATED_ANALYTICS_CLAIMS, FEDERATED_ANALYTICS_CONNECTOR_MANIFEST, FEDERATED_ANALYTICS_ERROR_CODES, FEDERATED_ANALYTICS_READ_PERMISSION, } from "./federation.js";
+export type { FederatedAnalyticsCapability, FederatedAnalyticsAuthorizerOptions, FederatedAnalyticsConnection, FederatedAnalyticsConnectionStatus, FederatedAnalyticsErrorCode, FederatedAnalyticsIdentity, FederatedAnalyticsManifest, 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"]>;
@@ -15,7 +19,7 @@ export type IngestResult = FunctionReturnType<ComponentApi["ingest"]["ingestBatc
 export type TrackConversionInput = Omit<FunctionArgs<ComponentApi["ingest"]["trackConversion"]>, "affiliateSlug">;
 export type TrackConversionOutput = FunctionReturnType<ComponentApi["ingest"]["trackConversion"]>;
 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 +31,11 @@ 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 UpsertGoalInput = FunctionArgs<ComponentApi["goals"]["upsert"]>;
 export type UpsertGoalOutput = FunctionReturnType<ComponentApi["goals"]["upsert"]>;
 export type Goal = FunctionReturnType<ComponentApi["goals"]["list"]>[number];
@@ -41,8 +45,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" | "events" | "sessions" | "conversions" | "goals" | "funnels" | "affiliates";
+        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" | "attributions" | "liveSessions" | "ingestWindows" | "siteIngestWindows";
+export type RunRetentionPolicyInput = {
+    siteId: string;
+    kind: RetentionKind;
+    batchSize?: number;
+};
 export declare class Rastro {
     private readonly component;
     constructor(component: ComponentApi);
@@ -88,6 +150,43 @@ export declare class Rastro {
         currency: string;
         from: number;
         interval: "hour" | "day";
+        metadata: {
+            breakdowns: {
+                topBrowsers: "eventVolume";
+                topCountries: "eventVolume";
+                topDevices: "eventVolume";
+                topEvents: "eventVolume";
+                topGoals: "goalCompletionVolume";
+                topPages: "eventVolume";
+                topSources: "eventVolume";
+            };
+            coverage: {
+                availableFrom: number | null;
+                availableThrough: number | null;
+                generation: number | null;
+                retainedBefore: number | null;
+                state: "complete" | "partial" | "retained" | "unavailable";
+            };
+            features: {
+                botDetection: "unsupported";
+                errorInsights: "unsupported";
+                outboundLinks: "eventVolume";
+                sessionReplay: "unsupported";
+            };
+            range: {
+                boundary: "inclusive";
+                from: number;
+                timezone: "UTC";
+                to: number;
+            };
+            visitors: {
+                basis: "estimatedUnique" | "bucketOccurrences";
+                exact: boolean;
+                legacyIncomplete: boolean;
+                precision: number | null;
+                sketchVersion: number | null;
+            };
+        };
         timeSeries: Array<{
             clicks: number;
             conversions: number;
@@ -308,6 +407,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: "UTC";
+                to: number;
+            };
+        };
         truncated: boolean;
     }>;
     funnelsReport(ctx: QueryCtx | MutationCtx | ActionCtx, args: FunnelsReportInput): Promise<{
@@ -317,6 +432,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: "UTC";
+                to: number;
+            };
+        };
         name: string;
         siteId: string;
         steps: Array<{
@@ -351,6 +482,26 @@ 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: "UTC";
+                to: number;
+            };
+            uniqueVisitors: {
+                basis: "estimatedUnique" | "exactLegacy";
+                exact: boolean;
+            };
+        };
         truncated: boolean;
     }>;
     upsertGoal(ctx: MutationCtx, args: UpsertGoalInput): Promise<string>;
@@ -401,11 +552,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" | "events" | "sessions" | "conversions" | "goals" | "funnels" | "affiliates";
+        }>;
+        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" | "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" | "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" | "retention.policy" | "retention.status" | "coverage.read";
 export type AnalyticsAuthorizationRequest = {
     operation: AnalyticsOperation;
     siteIds: string[];
@@ -413,6 +606,781 @@ 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";
+            topCountries: "eventVolume";
+            topDevices: "eventVolume";
+            topEvents: "eventVolume";
+            topGoals: "goalCompletionVolume";
+            topPages: "eventVolume";
+            topSources: "eventVolume";
+        };
+        coverage: {
+            availableFrom: number | null;
+            availableThrough: number | null;
+            generation: number | null;
+            retainedBefore: number | null;
+            state: "complete" | "partial" | "retained" | "unavailable";
+        };
+        features: {
+            botDetection: "unsupported";
+            errorInsights: "unsupported";
+            outboundLinks: "eventVolume";
+            sessionReplay: "unsupported";
+        };
+        range: {
+            boundary: "inclusive";
+            from: number;
+            timezone: "UTC";
+            to: number;
+        };
+        visitors: {
+            basis: "bucketOccurrences" | "estimatedUnique";
+            exact: boolean;
+            legacyIncomplete: boolean;
+            precision: number | null;
+            sketchVersion: number | null;
+        };
+    };
+    timeSeries: {
+        clicks: number;
+        conversions: number;
+        customEvents: number;
+        events: number;
+        outboundClicks: number;
+        pageviews: number;
+        revenueCents: number;
+        sessions: number;
+        timestamp: number;
+        visitors: number;
+    }[];
+    to: number;
+    topBrowsers: {
+        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;
+        conversions: number;
+        customEvents: number;
+        events: 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;
+        conversions: number;
+        customEvents: number;
+        events: 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">;
+    }, "required", "clicks" | "conversions" | "customEvents" | "events" | "outboundClicks" | "pageviews" | "revenueCents" | "sessions" | "visitors">;
+    timeSeries: import("convex/values").VArray<{
+        clicks: number;
+        conversions: number;
+        customEvents: number;
+        events: number;
+        outboundClicks: number;
+        pageviews: number;
+        revenueCents: number;
+        sessions: number;
+        timestamp: number;
+        visitors: number;
+    }[], import("convex/values").VObject<{
+        clicks: number;
+        conversions: number;
+        customEvents: number;
+        events: 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">;
+        timestamp: import("convex/values").VFloat64<number, "required">;
+    }, "required", "clicks" | "conversions" | "customEvents" | "events" | "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">;
+    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";
+            topCountries: "eventVolume";
+            topDevices: "eventVolume";
+            topEvents: "eventVolume";
+            topGoals: "goalCompletionVolume";
+            topPages: "eventVolume";
+            topSources: "eventVolume";
+        };
+        coverage: {
+            availableFrom: number | null;
+            availableThrough: number | null;
+            generation: number | null;
+            retainedBefore: number | null;
+            state: "complete" | "partial" | "retained" | "unavailable";
+        };
+        features: {
+            botDetection: "unsupported";
+            errorInsights: "unsupported";
+            outboundLinks: "eventVolume";
+            sessionReplay: "unsupported";
+        };
+        range: {
+            boundary: "inclusive";
+            from: number;
+            timezone: "UTC";
+            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";
+            topCountries: "eventVolume";
+            topDevices: "eventVolume";
+            topEvents: "eventVolume";
+            topGoals: "goalCompletionVolume";
+            topPages: "eventVolume";
+            topSources: "eventVolume";
+        }, {
+            topSources: import("convex/values").VLiteral<"eventVolume", "required">;
+            topPages: import("convex/values").VLiteral<"eventVolume", "required">;
+            topCountries: import("convex/values").VLiteral<"eventVolume", "required">;
+            topDevices: import("convex/values").VLiteral<"eventVolume", "required">;
+            topBrowsers: import("convex/values").VLiteral<"eventVolume", "required">;
+            topEvents: import("convex/values").VLiteral<"eventVolume", "required">;
+            topGoals: import("convex/values").VLiteral<"goalCompletionVolume", "required">;
+        }, "required", "topBrowsers" | "topCountries" | "topDevices" | "topEvents" | "topGoals" | "topPages" | "topSources">;
+        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: "UTC";
+            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").VLiteral<"UTC", "required">;
+        }, "required", "boundary" | "from" | "timezone" | "to">;
+        features: import("convex/values").VObject<{
+            botDetection: "unsupported";
+            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<"unsupported", "required">;
+        }, "required", "botDetection" | "errorInsights" | "outboundLinks" | "sessionReplay">;
+    }, "required", "breakdowns" | "breakdowns.topBrowsers" | "breakdowns.topCountries" | "breakdowns.topDevices" | "breakdowns.topEvents" | "breakdowns.topGoals" | "breakdowns.topPages" | "breakdowns.topSources" | "coverage" | "coverage.availableFrom" | "coverage.availableThrough" | "coverage.generation" | "coverage.retainedBefore" | "coverage.state" | "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.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.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" | "topCountries" | "topDevices" | "topEvents" | "topGoals" | "topPages" | "topSources" | "totals" | "totals.clicks" | "totals.conversions" | "totals.customEvents" | "totals.events" | "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: "UTC";
+            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: "UTC";
+            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: "UTC";
+            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").VLiteral<"UTC", "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: "UTC";
+            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: "UTC";
+            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: "UTC";
+            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: "UTC";
+            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").VLiteral<"UTC", "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: "UTC";
+            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: "UTC";
+            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: "UTC";
+            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").VLiteral<"UTC", "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">;
 export declare function exposeAnalyticsApi(component: ComponentApi, options: {
     authorize: AnalyticsAuthorizer;
 }): {
@@ -524,6 +1492,43 @@ export declare function exposeAnalyticsApi(component: ComponentApi, options: {
         currency: string;
         from: number;
         interval: "hour" | "day";
+        metadata: {
+            breakdowns: {
+                topBrowsers: "eventVolume";
+                topCountries: "eventVolume";
+                topDevices: "eventVolume";
+                topEvents: "eventVolume";
+                topGoals: "goalCompletionVolume";
+                topPages: "eventVolume";
+                topSources: "eventVolume";
+            };
+            coverage: {
+                availableFrom: number | null;
+                availableThrough: number | null;
+                generation: number | null;
+                retainedBefore: number | null;
+                state: "complete" | "partial" | "retained" | "unavailable";
+            };
+            features: {
+                botDetection: "unsupported";
+                errorInsights: "unsupported";
+                outboundLinks: "eventVolume";
+                sessionReplay: "unsupported";
+            };
+            range: {
+                boundary: "inclusive";
+                from: number;
+                timezone: "UTC";
+                to: number;
+            };
+            visitors: {
+                basis: "estimatedUnique" | "bucketOccurrences";
+                exact: boolean;
+                legacyIncomplete: boolean;
+                precision: number | null;
+                sketchVersion: number | null;
+            };
+        };
         timeSeries: Array<{
             clicks: number;
             conversions: number;
@@ -795,6 +1800,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: "UTC";
+                to: number;
+            };
+        };
         truncated: boolean;
     }>>;
     funnelsReport: import("convex/server").RegisteredQuery<"public", {
@@ -808,6 +1829,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: "UTC";
+                to: number;
+            };
+        };
         name: string;
         siteId: string;
         steps: Array<{
@@ -846,8 +1883,88 @@ 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: "UTC";
+                to: number;
+            };
+            uniqueVisitors: {
+                basis: "estimatedUnique" | "exactLegacy";
+                exact: boolean;
+            };
+        };
         truncated: boolean;
     }>>;
+    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" | "events" | "sessions" | "conversions" | "goals" | "funnels" | "affiliates";
+        }>;
+        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" | "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";
+        siteId: string;
+    }, Promise<{
+        before: number;
+        deleted: number;
+        hasMore: boolean;
+    }>>;
     upsertGoal: import("convex/server").RegisteredMutation<"public", {
         active?: boolean | undefined;
         goalId?: string | undefined;
@@ -942,13 +2059,488 @@ 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";
         siteId: string;
     }, Promise<{
+        before: number;
         deleted: number;
         hasMore: boolean;
     }>>;
 };
+/** Exposes only the reactive read surface used by a federated Rastro dashboard. */
+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";
+        };
+        capabilities: ("affiliates" | "conversions" | "dataCoverage" | "funnels" | "goals" | "liveVisitors" | "overview" | "sessionJourney" | "sessions" | "siteSummaries" | "visitorJourney")[];
+        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: "eventVolume";
+                topCountries: "eventVolume";
+                topDevices: "eventVolume";
+                topEvents: "eventVolume";
+                topGoals: "goalCompletionVolume";
+                topPages: "eventVolume";
+                topSources: "eventVolume";
+            };
+            coverage: {
+                availableFrom: number | null;
+                availableThrough: number | null;
+                generation: number | null;
+                retainedBefore: number | null;
+                state: "complete" | "partial" | "retained" | "unavailable";
+            };
+            features: {
+                botDetection: "unsupported";
+                errorInsights: "unsupported";
+                outboundLinks: "eventVolume";
+                sessionReplay: "unsupported";
+            };
+            range: {
+                boundary: "inclusive";
+                from: number;
+                timezone: "UTC";
+                to: number;
+            };
+            visitors: {
+                basis: "estimatedUnique" | "bucketOccurrences";
+                exact: boolean;
+                legacyIncomplete: boolean;
+                precision: number | null;
+                sketchVersion: number | null;
+            };
+        };
+        timeSeries: Array<{
+            clicks: number;
+            conversions: number;
+            customEvents: number;
+            events: number;
+            outboundClicks: number;
+            pageviews: number;
+            revenueCents: number;
+            sessions: number;
+            timestamp: number;
+            visitors: number;
+        }>;
+        to: number;
+        topBrowsers: 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;
+            conversions: number;
+            customEvents: number;
+            events: 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;
+        os: string;
+        pageviewCount: number;
+        path: 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;
+        }>;
+        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" | "outbound";
+            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" | "outbound";
+        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: "UTC";
+                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: "UTC";
+                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: "UTC";
+                to: number;
+            };
+            uniqueVisitors: {
+                basis: "estimatedUnique" | "exactLegacy";
+                exact: boolean;
+            };
+        };
+        truncated: boolean;
+    }>>;
+    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" | "events" | "sessions" | "conversions" | "goals" | "funnels" | "affiliates";
+        }>;
+        from: number;
+        siteId: string;
+        to: number;
+    }>>;
+};
 export declare function componentHttpPaths(prefix?: string): {
     readonly events: `${string}/events`;
     readonly tracker: `${string}/tracker.js`;