@iann29/rastro 0.1.0-alpha.5 → 0.1.0-alpha.7

package/dist/client/index.d.ts

@@ -1,11 +1,13 @@
 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 { 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, };
+export { eventPropertiesValidator, eventTypeValidator, funnelStepValidator, goalMatchTypeValidator, ingestContextValidator, ingestResultValidator, trackerEventValidator, vitalMetricValidator, };
 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 { VITAL_METRICS, VITAL_THRESHOLDS } from "../component/vitals.js";
+export type { VitalMetric } from "../component/vitals.js";
+export { FEDERATED_ANALYTICS_CLAIMS, FEDERATED_ANALYTICS_CONNECTOR_MANIFEST, FEDERATED_ANALYTICS_ERROR_CODES, FEDERATED_ANALYTICS_READ_PERMISSION, FEDERATED_ANALYTICS_REQUIRED_CAPABILITIES, FEDERATED_ANALYTICS_REQUIRED_FUNCTIONS, } 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"]>;
@@ -38,6 +40,8 @@ export type FunnelsReportInput = FunctionArgs<ComponentApi["reports"]["funnelsRe
 export type FunnelsReport = Infer<typeof hostFunnelsReportValidator>;
 export type AffiliatesReportInput = FunctionArgs<ComponentApi["reports"]["affiliatesReport"]>;
 export type AffiliatesReport = Infer<typeof hostAffiliatesReportValidator>;
+export type VitalsReportInput = FunctionArgs<ComponentApi["reports"]["vitalsReport"]>;
+export type VitalsReport = Infer<typeof hostVitalsReportValidator>;
 export type UpsertGoalInput = FunctionArgs<ComponentApi["goals"]["upsert"]>;
 export type UpsertGoalOutput = FunctionReturnType<ComponentApi["goals"]["upsert"]>;
 export type Goal = FunctionReturnType<ComponentApi["goals"]["list"]>[number];
@@ -68,7 +72,7 @@ export type DataCoverage = {
     from: number;
     to: number;
     datasets: Array<{
-        dataset: "overviewHour" | "overviewDay" | "events" | "sessions" | "conversions" | "goals" | "funnels" | "affiliates";
+        dataset: "overviewHour" | "overviewDay" | "events" | "sessions" | "conversions" | "goals" | "funnels" | "affiliates" | "vitals";
         coverage: CoverageStatus;
     }>;
 };
@@ -101,7 +105,7 @@ export type RetentionStatus = {
     }>;
     backlog: number;
 };
-export type RetentionKind = "events" | "sessions" | "conversions" | "goalCompletions" | "aggregateHour" | "aggregateDay" | "funnelProgress" | "funnelSteps" | "affiliateStats" | "goalRollups" | "funnelRollups" | "affiliateRollups" | "attributions" | "liveSessions" | "ingestWindows" | "siteIngestWindows";
+export type RetentionKind = "events" | "sessions" | "conversions" | "goalCompletions" | "aggregateHour" | "aggregateDay" | "funnelProgress" | "funnelSteps" | "affiliateStats" | "goalRollups" | "funnelRollups" | "affiliateRollups" | "vitalRollups" | "attributions" | "liveSessions" | "ingestWindows" | "siteIngestWindows";
 export type RunRetentionPolicyInput = {
     siteId: string;
     kind: RetentionKind;
@@ -347,7 +351,7 @@ export declare class Rastro {
             siteId: string;
             target?: string;
             timestamp: number;
-            type: "pageview" | "click" | "custom" | "conversion" | "heartbeat" | "outbound";
+            type: "pageview" | "click" | "custom" | "conversion" | "heartbeat" | "outbound" | "vital";
             visitorId: string;
         }>;
         pageStatus?: "SplitRecommended" | "SplitRequired" | null;
@@ -402,7 +406,7 @@ export declare class Rastro {
         siteId: string;
         target?: string;
         timestamp: number;
-        type: "pageview" | "click" | "custom" | "conversion" | "heartbeat" | "outbound";
+        type: "pageview" | "click" | "custom" | "conversion" | "heartbeat" | "outbound" | "vital";
         visitorId: string;
     }[]>;
     goalsReport(ctx: QueryCtx | MutationCtx | ActionCtx, args: GoalsReportInput): Promise<{
@@ -517,6 +521,57 @@ export declare class Rastro {
         };
         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: "UTC";
+                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;
+    }>;
     upsertGoal(ctx: MutationCtx, args: UpsertGoalInput): Promise<string>;
     listGoals(ctx: QueryCtx | MutationCtx | ActionCtx, siteId: string): Promise<{
         _creationTime: number;
@@ -578,7 +633,7 @@ export declare class Rastro {
                 retainedBefore: number | null;
                 state: "complete" | "partial" | "retained" | "unavailable";
             };
-            dataset: "overviewHour" | "overviewDay" | "events" | "sessions" | "conversions" | "goals" | "funnels" | "affiliates";
+            dataset: "overviewHour" | "overviewDay" | "events" | "sessions" | "conversions" | "goals" | "funnels" | "affiliates" | "vitals";
         }>;
         from: number;
         siteId: string;
@@ -591,7 +646,7 @@ export declare class Rastro {
         jobs: Array<{
             before: number;
             deleted: number;
-            kind: "events" | "sessions" | "conversions" | "goalCompletions" | "aggregateHour" | "aggregateDay" | "funnelProgress" | "funnelSteps" | "affiliateStats" | "goalRollups" | "funnelRollups" | "affiliateRollups" | "attributions" | "liveSessions" | "ingestWindows" | "siteIngestWindows";
+            kind: "events" | "sessions" | "conversions" | "goalCompletions" | "aggregateHour" | "aggregateDay" | "funnelProgress" | "funnelSteps" | "affiliateStats" | "goalRollups" | "funnelRollups" | "affiliateRollups" | "vitalRollups" | "attributions" | "liveSessions" | "ingestWindows" | "siteIngestWindows";
             scheduledAt: number | null;
             status: "pending" | "running" | "complete";
             updatedAt: number;
@@ -611,7 +666,7 @@ export declare class Rastro {
         hasMore: boolean;
     }>;
 }
-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" | "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 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" | "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[];
@@ -1416,6 +1471,235 @@ declare const hostAffiliatesReportValidator: import("convex/values").VObject<{
         }, "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: "UTC";
+            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: "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", "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">;
 export declare function exposeAnalyticsApi(component: ComponentApi, options: {
     authorize: AnalyticsAuthorizer;
 }): {
@@ -1493,7 +1777,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" | "outbound" | "pageview" | "vital";
+            value?: number | undefined;
             visitorId: string;
         }[];
         origin: string;
@@ -1756,7 +2041,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" | "outbound" | "vital";
             visitorId: string;
         }>;
         pageStatus?: "SplitRecommended" | "SplitRequired" | null;
@@ -1829,7 +2114,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" | "outbound" | "vital";
         visitorId: string;
     }[]>>;
     goalsReport: import("convex/server").RegisteredQuery<"public", {
@@ -1956,6 +2241,61 @@ export declare function exposeAnalyticsApi(component: ComponentApi, options: {
         };
         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: "UTC";
+                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;
+    }>>;
     dataCoverage: import("convex/server").RegisteredQuery<"public", {
         from: number;
         siteId: string;
@@ -1969,7 +2309,7 @@ export declare function exposeAnalyticsApi(component: ComponentApi, options: {
                 retainedBefore: number | null;
                 state: "complete" | "partial" | "retained" | "unavailable";
             };
-            dataset: "overviewHour" | "overviewDay" | "events" | "sessions" | "conversions" | "goals" | "funnels" | "affiliates";
+            dataset: "overviewHour" | "overviewDay" | "events" | "sessions" | "conversions" | "goals" | "funnels" | "affiliates" | "vitals";
         }>;
         from: number;
         siteId: string;
@@ -1982,7 +2322,7 @@ export declare function exposeAnalyticsApi(component: ComponentApi, options: {
         jobs: Array<{
             before: number;
             deleted: number;
-            kind: "events" | "sessions" | "conversions" | "goalCompletions" | "aggregateHour" | "aggregateDay" | "funnelProgress" | "funnelSteps" | "affiliateStats" | "goalRollups" | "funnelRollups" | "affiliateRollups" | "attributions" | "liveSessions" | "ingestWindows" | "siteIngestWindows";
+            kind: "events" | "sessions" | "conversions" | "goalCompletions" | "aggregateHour" | "aggregateDay" | "funnelProgress" | "funnelSteps" | "affiliateStats" | "goalRollups" | "funnelRollups" | "affiliateRollups" | "vitalRollups" | "attributions" | "liveSessions" | "ingestWindows" | "siteIngestWindows";
             scheduledAt: number | null;
             status: "pending" | "running" | "complete";
             updatedAt: number;
@@ -2009,7 +2349,7 @@ export declare function exposeAnalyticsApi(component: ComponentApi, options: {
     }, 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";
+        kind: "affiliateRollups" | "affiliateStats" | "aggregateDay" | "aggregateHour" | "attributions" | "conversions" | "events" | "funnelProgress" | "funnelRollups" | "funnelSteps" | "goalCompletions" | "goalRollups" | "ingestWindows" | "liveSessions" | "sessions" | "siteIngestWindows" | "vitalRollups";
         siteId: string;
     }, Promise<{
         before: number;
@@ -2110,7 +2450,7 @@ export declare function exposeAnalyticsApi(component: ComponentApi, options: {
     cleanupAnalytics: import("convex/server").RegisteredMutation<"public", {
         batchSize?: number | undefined;
         before: number;
-        kind: "affiliateRollups" | "affiliateStats" | "aggregateDay" | "aggregateHour" | "attributions" | "conversions" | "events" | "funnelProgress" | "funnelRollups" | "funnelSteps" | "goalCompletions" | "goalRollups" | "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;
@@ -2138,8 +2478,9 @@ export declare function exposeFederatedAnalyticsApi(component: ComponentApi, opt
             funnelsReport: "funnelsReport";
             affiliatesReport: "affiliatesReport";
             dataCoverage: "dataCoverage";
+            vitalsReport: "vitalsReport";
         };
-        capabilities: ("affiliates" | "conversions" | "dataCoverage" | "funnels" | "goals" | "liveVisitors" | "overview" | "sessionJourney" | "sessions" | "siteSummaries" | "visitorJourney")[];
+        capabilities: ("affiliates" | "conversions" | "dataCoverage" | "funnels" | "goals" | "liveVisitors" | "overview" | "sessionJourney" | "sessions" | "siteSummaries" | "visitorJourney" | "vitals")[];
         limits: {
             maxSitesPerRequest: 10;
             maxSitesPerConnection: 10;
@@ -2379,7 +2720,7 @@ export declare function exposeFederatedAnalyticsApi(component: ComponentApi, opt
             siteId: string;
             target?: string;
             timestamp: number;
-            type: "pageview" | "click" | "custom" | "conversion" | "heartbeat" | "outbound";
+            type: "pageview" | "click" | "custom" | "conversion" | "heartbeat" | "outbound" | "vital";
             visitorId: string;
         }>;
         pageStatus?: "SplitRecommended" | "SplitRequired" | null;
@@ -2452,7 +2793,7 @@ export declare function exposeFederatedAnalyticsApi(component: ComponentApi, opt
         siteId: string;
         target?: string;
         timestamp: number;
-        type: "pageview" | "click" | "custom" | "conversion" | "heartbeat" | "outbound";
+        type: "pageview" | "click" | "custom" | "conversion" | "heartbeat" | "outbound" | "vital";
         visitorId: string;
     }[]>>;
     goalsReport: import("convex/server").RegisteredQuery<"public", {
@@ -2579,6 +2920,61 @@ export declare function exposeFederatedAnalyticsApi(component: ComponentApi, opt
         };
         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: "UTC";
+                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;
+    }>>;
     dataCoverage: import("convex/server").RegisteredQuery<"public", {
         from: number;
         siteId: string;
@@ -2592,7 +2988,7 @@ export declare function exposeFederatedAnalyticsApi(component: ComponentApi, opt
                 retainedBefore: number | null;
                 state: "complete" | "partial" | "retained" | "unavailable";
             };
-            dataset: "overviewHour" | "overviewDay" | "events" | "sessions" | "conversions" | "goals" | "funnels" | "affiliates";
+            dataset: "overviewHour" | "overviewDay" | "events" | "sessions" | "conversions" | "goals" | "funnels" | "affiliates" | "vitals";
         }>;
         from: number;
         siteId: string;
@@ -2602,6 +2998,7 @@ export declare function exposeFederatedAnalyticsApi(component: ComponentApi, opt
 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">;