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

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"]>;
@@ -18,6 +20,8 @@ export type IngestInput = FunctionArgs<ComponentApi["ingest"]["ingestBatch"]>;
 export type IngestResult = FunctionReturnType<ComponentApi["ingest"]["ingestBatch"]>;
 export type TrackConversionInput = Omit<FunctionArgs<ComponentApi["ingest"]["trackConversion"]>, "affiliateSlug">;
 export type TrackConversionOutput = FunctionReturnType<ComponentApi["ingest"]["trackConversion"]>;
+export type LinkVisitorInput = FunctionArgs<ComponentApi["visitors"]["link"]>;
+export type LinkVisitorOutput = FunctionReturnType<ComponentApi["visitors"]["link"]>;
 export type OverviewInput = FunctionArgs<ComponentApi["reports"]["overview"]>;
 export type Overview = Infer<typeof hostOverviewValidator>;
 export type LiveVisitorsInput = FunctionArgs<ComponentApi["reports"]["liveVisitors"]>;
@@ -36,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];
@@ -66,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;
     }>;
 };
@@ -99,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;
@@ -146,6 +152,10 @@ export declare class Rastro {
         duplicates: number;
         rejected: number;
     }>;
+    linkVisitor(ctx: MutationCtx, args: LinkVisitorInput): Promise<{
+        aliasCount: number;
+        linked: boolean;
+    }>;
     overview(ctx: QueryCtx | MutationCtx | ActionCtx, args: OverviewInput): Promise<{
         currency: string;
         from: number;
@@ -153,6 +163,7 @@ export declare class Rastro {
         metadata: {
             breakdowns: {
                 topBrowsers: "eventVolume";
+                topCampaigns: "eventVolume";
                 topCountries: "eventVolume";
                 topDevices: "eventVolume";
                 topEvents: "eventVolume";
@@ -168,7 +179,7 @@ export declare class Rastro {
                 state: "complete" | "partial" | "retained" | "unavailable";
             };
             features: {
-                botDetection: "unsupported";
+                botDetection: "userAgent";
                 errorInsights: "unsupported";
                 outboundLinks: "eventVolume";
                 sessionReplay: "unsupported";
@@ -205,6 +216,11 @@ export declare class Rastro {
             revenueCents: number;
             value: string;
         }>;
+        topCampaigns: Array<{
+            count: number;
+            revenueCents: number;
+            value: string;
+        }>;
         topCountries: Array<{
             count: number;
             revenueCents: number;
@@ -303,6 +319,7 @@ export declare class Rastro {
             utmMedium?: string;
             utmSource?: string;
             visitorId: string;
+            visitorKey?: string;
         }>;
         pageStatus?: "SplitRecommended" | "SplitRequired" | null;
         splitCursor?: string | null;
@@ -334,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;
@@ -389,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<{
@@ -504,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;
@@ -565,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;
@@ -578,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;
@@ -598,7 +666,7 @@ export declare class Rastro {
         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" | "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[];
@@ -613,6 +681,7 @@ declare const hostOverviewValidator: import("convex/values").VObject<{
     metadata: {
         breakdowns: {
             topBrowsers: "eventVolume";
+            topCampaigns: "eventVolume";
             topCountries: "eventVolume";
             topDevices: "eventVolume";
             topEvents: "eventVolume";
@@ -628,7 +697,7 @@ declare const hostOverviewValidator: import("convex/values").VObject<{
             state: "complete" | "partial" | "retained" | "unavailable";
         };
         features: {
-            botDetection: "unsupported";
+            botDetection: "userAgent";
             errorInsights: "unsupported";
             outboundLinks: "eventVolume";
             sessionReplay: "unsupported";
@@ -665,6 +734,11 @@ declare const hostOverviewValidator: import("convex/values").VObject<{
         revenueCents: number;
         value: string;
     }[];
+    topCampaigns: {
+        count: number;
+        revenueCents: number;
+        value: string;
+    }[];
     topCountries: {
         count: number;
         revenueCents: number;
@@ -779,6 +853,19 @@ declare const hostOverviewValidator: import("convex/values").VObject<{
         count: import("convex/values").VFloat64<number, "required">;
         revenueCents: import("convex/values").VFloat64<number, "required">;
     }, "required", "count" | "revenueCents" | "value">, "required">;
+    topCampaigns: import("convex/values").VArray<{
+        count: number;
+        revenueCents: number;
+        value: string;
+    }[], import("convex/values").VObject<{
+        count: number;
+        revenueCents: number;
+        value: string;
+    }, {
+        value: import("convex/values").VString<string, "required">;
+        count: import("convex/values").VFloat64<number, "required">;
+        revenueCents: import("convex/values").VFloat64<number, "required">;
+    }, "required", "count" | "revenueCents" | "value">, "required">;
     topPages: import("convex/values").VArray<{
         count: number;
         revenueCents: number;
@@ -860,6 +947,7 @@ declare const hostOverviewValidator: import("convex/values").VObject<{
     metadata: import("convex/values").VObject<{
         breakdowns: {
             topBrowsers: "eventVolume";
+            topCampaigns: "eventVolume";
             topCountries: "eventVolume";
             topDevices: "eventVolume";
             topEvents: "eventVolume";
@@ -875,7 +963,7 @@ declare const hostOverviewValidator: import("convex/values").VObject<{
             state: "complete" | "partial" | "retained" | "unavailable";
         };
         features: {
-            botDetection: "unsupported";
+            botDetection: "userAgent";
             errorInsights: "unsupported";
             outboundLinks: "eventVolume";
             sessionReplay: "unsupported";
@@ -909,6 +997,7 @@ declare const hostOverviewValidator: import("convex/values").VObject<{
         }, "required", "basis" | "exact" | "legacyIncomplete" | "precision" | "sketchVersion">;
         breakdowns: import("convex/values").VObject<{
             topBrowsers: "eventVolume";
+            topCampaigns: "eventVolume";
             topCountries: "eventVolume";
             topDevices: "eventVolume";
             topEvents: "eventVolume";
@@ -917,13 +1006,14 @@ declare const hostOverviewValidator: import("convex/values").VObject<{
             topSources: "eventVolume";
         }, {
             topSources: import("convex/values").VLiteral<"eventVolume", "required">;
+            topCampaigns: 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">;
+        }, "required", "topBrowsers" | "topCampaigns" | "topCountries" | "topDevices" | "topEvents" | "topGoals" | "topPages" | "topSources">;
         coverage: import("convex/values").VObject<{
             availableFrom: number | null;
             availableThrough: number | null;
@@ -949,7 +1039,7 @@ declare const hostOverviewValidator: import("convex/values").VObject<{
             timezone: import("convex/values").VLiteral<"UTC", "required">;
         }, "required", "boundary" | "from" | "timezone" | "to">;
         features: import("convex/values").VObject<{
-            botDetection: "unsupported";
+            botDetection: "userAgent";
             errorInsights: "unsupported";
             outboundLinks: "eventVolume";
             sessionReplay: "unsupported";
@@ -957,10 +1047,10 @@ declare const hostOverviewValidator: import("convex/values").VObject<{
             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">;
+            botDetection: import("convex/values").VLiteral<"userAgent", "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">;
+    }, "required", "breakdowns" | "breakdowns.topBrowsers" | "breakdowns.topCampaigns" | "breakdowns.topCountries" | "breakdowns.topDevices" | "breakdowns.topEvents" | "breakdowns.topGoals" | "breakdowns.topPages" | "breakdowns.topSources" | "coverage" | "coverage.availableFrom" | "coverage.availableThrough" | "coverage.generation" | "coverage.retainedBefore" | "coverage.state" | "features" | "features.botDetection" | "features.errorInsights" | "features.outboundLinks" | "features.sessionReplay" | "range" | "range.boundary" | "range.from" | "range.timezone" | "range.to" | "visitors" | "visitors.basis" | "visitors.exact" | "visitors.legacyIncomplete" | "visitors.precision" | "visitors.sketchVersion">;
+}, "required", "currency" | "from" | "interval" | "metadata" | "metadata.breakdowns" | "metadata.breakdowns.topBrowsers" | "metadata.breakdowns.topCampaigns" | "metadata.breakdowns.topCountries" | "metadata.breakdowns.topDevices" | "metadata.breakdowns.topEvents" | "metadata.breakdowns.topGoals" | "metadata.breakdowns.topPages" | "metadata.breakdowns.topSources" | "metadata.coverage" | "metadata.coverage.availableFrom" | "metadata.coverage.availableThrough" | "metadata.coverage.generation" | "metadata.coverage.retainedBefore" | "metadata.coverage.state" | "metadata.features" | "metadata.features.botDetection" | "metadata.features.errorInsights" | "metadata.features.outboundLinks" | "metadata.features.sessionReplay" | "metadata.range" | "metadata.range.boundary" | "metadata.range.from" | "metadata.range.timezone" | "metadata.range.to" | "metadata.visitors" | "metadata.visitors.basis" | "metadata.visitors.exact" | "metadata.visitors.legacyIncomplete" | "metadata.visitors.precision" | "metadata.visitors.sketchVersion" | "timeSeries" | "to" | "topBrowsers" | "topCampaigns" | "topCountries" | "topDevices" | "topEvents" | "topGoals" | "topPages" | "topSources" | "totals" | "totals.clicks" | "totals.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;
@@ -1381,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;
 }): {
@@ -1442,6 +1761,7 @@ export declare function exposeAnalyticsApi(component: ComponentApi, options: {
             latitude?: number | undefined;
             longitude?: number | undefined;
             os?: string | undefined;
+            visitorKey?: string | undefined;
         } | undefined;
         events: {
             affiliateSlug?: string | undefined;
@@ -1457,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;
@@ -1483,6 +1804,14 @@ export declare function exposeAnalyticsApi(component: ComponentApi, options: {
         duplicates: number;
         rejected: number;
     }>>;
+    linkVisitor: import("convex/server").RegisteredMutation<"public", {
+        previousVisitorId: string;
+        siteId: string;
+        visitorId: string;
+    }, Promise<{
+        aliasCount: number;
+        linked: boolean;
+    }>>;
     overview: import("convex/server").RegisteredQuery<"public", {
         from: number;
         interval?: "day" | "hour" | undefined;
@@ -1495,6 +1824,7 @@ export declare function exposeAnalyticsApi(component: ComponentApi, options: {
         metadata: {
             breakdowns: {
                 topBrowsers: "eventVolume";
+                topCampaigns: "eventVolume";
                 topCountries: "eventVolume";
                 topDevices: "eventVolume";
                 topEvents: "eventVolume";
@@ -1510,7 +1840,7 @@ export declare function exposeAnalyticsApi(component: ComponentApi, options: {
                 state: "complete" | "partial" | "retained" | "unavailable";
             };
             features: {
-                botDetection: "unsupported";
+                botDetection: "userAgent";
                 errorInsights: "unsupported";
                 outboundLinks: "eventVolume";
                 sessionReplay: "unsupported";
@@ -1547,6 +1877,11 @@ export declare function exposeAnalyticsApi(component: ComponentApi, options: {
             revenueCents: number;
             value: string;
         }>;
+        topCampaigns: Array<{
+            count: number;
+            revenueCents: number;
+            value: string;
+        }>;
         topCountries: Array<{
             count: number;
             revenueCents: number;
@@ -1661,6 +1996,7 @@ export declare function exposeAnalyticsApi(component: ComponentApi, options: {
             utmMedium?: string;
             utmSource?: string;
             visitorId: string;
+            visitorKey?: string;
         }>;
         pageStatus?: "SplitRecommended" | "SplitRequired" | null;
         splitCursor?: string | null;
@@ -1705,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;
@@ -1778,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", {
@@ -1905,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;
@@ -1918,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;
@@ -1931,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;
@@ -1958,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;
@@ -2059,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;
@@ -2087,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;
@@ -2111,6 +2503,7 @@ export declare function exposeFederatedAnalyticsApi(component: ComponentApi, opt
         metadata: {
             breakdowns: {
                 topBrowsers: "eventVolume";
+                topCampaigns: "eventVolume";
                 topCountries: "eventVolume";
                 topDevices: "eventVolume";
                 topEvents: "eventVolume";
@@ -2126,7 +2519,7 @@ export declare function exposeFederatedAnalyticsApi(component: ComponentApi, opt
                 state: "complete" | "partial" | "retained" | "unavailable";
             };
             features: {
-                botDetection: "unsupported";
+                botDetection: "userAgent";
                 errorInsights: "unsupported";
                 outboundLinks: "eventVolume";
                 sessionReplay: "unsupported";
@@ -2163,6 +2556,11 @@ export declare function exposeFederatedAnalyticsApi(component: ComponentApi, opt
             revenueCents: number;
             value: string;
         }>;
+        topCampaigns: Array<{
+            count: number;
+            revenueCents: number;
+            value: string;
+        }>;
         topCountries: Array<{
             count: number;
             revenueCents: number;
@@ -2277,6 +2675,7 @@ export declare function exposeFederatedAnalyticsApi(component: ComponentApi, opt
             utmMedium?: string;
             utmSource?: string;
             visitorId: string;
+            visitorKey?: string;
         }>;
         pageStatus?: "SplitRecommended" | "SplitRequired" | null;
         splitCursor?: string | null;
@@ -2321,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;
@@ -2394,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", {
@@ -2521,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;
@@ -2534,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;
@@ -2544,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">;