@iann29/rastro 0.1.0-alpha.10 → 0.1.0-alpha.12

package/dist/client/index.d.ts

@@ -7,9 +7,10 @@ export { eventPropertiesValidator, eventTypeValidator, funnelStepValidator, goal
 export type { EventProperties, EventType, FunnelStep, IngestContext, TrackerEvent, } from "../component/validators.js";
 export { VITAL_METRICS, VITAL_THRESHOLDS } from "../component/vitals.js";
 export { normalizeRoute } from "../component/sanitize.js";
+export { localDayStart, nextLocalDayStart, previousLocalDayStart, } from "../component/localTime.js";
 export type { VitalMetric } from "../component/vitals.js";
-export { 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 { effectiveFederatedPermissions, FEDERATED_ANALYTICS_CLAIMS, FEDERATED_ANALYTICS_CONFIGURE_FUNCTIONS, FEDERATED_ANALYTICS_CONFIGURE_PERMISSION, FEDERATED_ANALYTICS_CONNECTOR_MANIFEST, FEDERATED_ANALYTICS_ERROR_CODES, FEDERATED_ANALYTICS_PERMISSIONS, FEDERATED_ANALYTICS_READ_PERMISSION, FEDERATED_ANALYTICS_REQUIRED_CAPABILITIES, FEDERATED_ANALYTICS_REQUIRED_FUNCTIONS, federatedAnalyticsPermissionValidator, } from "./federation.js";
+export type { FederatedAnalyticsCapability, FederatedAnalyticsAuthorizerOptions, FederatedAnalyticsConnection, FederatedAnalyticsConnectionStatus, FederatedAnalyticsErrorCode, FederatedAnalyticsIdentity, FederatedAnalyticsManifest, FederatedAnalyticsPermission, FederatedSiteSummary, ResolveFederatedAnalyticsConnection, } from "./federation.js";
 export type CreateSiteInput = FunctionArgs<ComponentApi["sites"]["create"]>;
 export type CreateSiteOutput = FunctionReturnType<ComponentApi["sites"]["create"]>;
 export type UpdateSiteInput = FunctionArgs<ComponentApi["sites"]["update"]>;
@@ -75,7 +76,7 @@ export type DataCoverage = {
     from: number;
     to: number;
     datasets: Array<{
-        dataset: "overviewHour" | "overviewDay" | "events" | "sessions" | "conversions" | "goals" | "funnels" | "affiliates" | "vitals" | "siteMap";
+        dataset: "overviewHour" | "overviewDay" | "overviewLocalDay" | "events" | "sessions" | "conversions" | "goals" | "funnels" | "affiliates" | "vitals" | "siteMap";
         coverage: CoverageStatus;
     }>;
 };
@@ -132,6 +133,11 @@ export declare class Rastro {
         timezone?: string;
         updatedAt: number;
     } | null>;
+    /** The calendar days a site's daily overview answers in; see `sites.localDays`. */
+    localDays(ctx: QueryCtx | MutationCtx | ActionCtx, siteId: string): Promise<{
+        since: number;
+        timezone: string;
+    } | null>;
     listSites(ctx: QueryCtx | MutationCtx | ActionCtx, args: ListSitesInput): Promise<{
         _creationTime: number;
         _id: string;
@@ -165,14 +171,14 @@ export declare class Rastro {
         interval: "hour" | "day";
         metadata: {
             breakdowns: {
-                topBrowsers: "eventVolume";
-                topCampaigns: "eventVolume";
-                topCountries: "eventVolume";
-                topDevices: "eventVolume";
+                topBrowsers: "pageviews" | "sessions" | "eventVolume";
+                topCampaigns: "pageviews" | "sessions" | "eventVolume";
+                topCountries: "pageviews" | "sessions" | "eventVolume";
+                topDevices: "pageviews" | "sessions" | "eventVolume";
                 topEvents: "eventVolume";
                 topGoals: "goalCompletionVolume";
-                topPages: "eventVolume";
-                topSources: "eventVolume";
+                topPages: "pageviews" | "sessions" | "eventVolume";
+                topSources: "pageviews" | "sessions" | "eventVolume";
             };
             coverage: {
                 availableFrom: number | null;
@@ -181,6 +187,7 @@ export declare class Rastro {
                 retainedBefore: number | null;
                 state: "complete" | "partial" | "retained" | "unavailable";
             };
+            engagement: "counted" | "unavailable";
             features: {
                 botDetection: "userAgent";
                 errorInsights: "unsupported";
@@ -190,7 +197,7 @@ export declare class Rastro {
             range: {
                 boundary: "inclusive";
                 from: number;
-                timezone: "UTC";
+                timezone: string;
                 to: number;
             };
             visitors: {
@@ -203,9 +210,12 @@ export declare class Rastro {
         };
         timeSeries: Array<{
             clicks: number;
+            continuedSessions: number;
             conversions: number;
             customEvents: number;
+            durationMs: number;
             events: number;
+            newVisitors: number;
             outboundClicks: number;
             pageviews: number;
             revenueCents: number;
@@ -256,9 +266,12 @@ export declare class Rastro {
         }>;
         totals: {
             clicks: number;
+            continuedSessions: number;
             conversions: number;
             customEvents: number;
+            durationMs: number;
             events: number;
+            newVisitors: number;
             outboundClicks: number;
             pageviews: number;
             revenueCents: number;
@@ -441,7 +454,7 @@ export declare class Rastro {
             range: {
                 boundary: "inclusive";
                 from: number;
-                timezone: "UTC";
+                timezone: string;
                 to: number;
             };
         };
@@ -466,7 +479,7 @@ export declare class Rastro {
             range: {
                 boundary: "inclusive";
                 from: number;
-                timezone: "UTC";
+                timezone: string;
                 to: number;
             };
         };
@@ -516,7 +529,7 @@ export declare class Rastro {
             range: {
                 boundary: "inclusive";
                 from: number;
-                timezone: "UTC";
+                timezone: string;
                 to: number;
             };
             uniqueVisitors: {
@@ -539,7 +552,7 @@ export declare class Rastro {
             range: {
                 boundary: "inclusive";
                 from: number;
-                timezone: "UTC";
+                timezone: string;
                 to: number;
             };
         };
@@ -596,7 +609,7 @@ export declare class Rastro {
             range: {
                 boundary: "inclusive";
                 from: number;
-                timezone: "UTC";
+                timezone: string;
                 to: number;
             };
             visitors: {
@@ -696,7 +709,7 @@ export declare class Rastro {
                 retainedBefore: number | null;
                 state: "complete" | "partial" | "retained" | "unavailable";
             };
-            dataset: "overviewHour" | "overviewDay" | "events" | "sessions" | "conversions" | "goals" | "funnels" | "affiliates" | "vitals" | "siteMap";
+            dataset: "overviewHour" | "overviewDay" | "overviewLocalDay" | "events" | "sessions" | "conversions" | "goals" | "funnels" | "affiliates" | "vitals" | "siteMap";
         }>;
         from: number;
         siteId: string;
@@ -743,14 +756,14 @@ declare const hostOverviewValidator: import("convex/values").VObject<{
     interval: "day" | "hour";
     metadata: {
         breakdowns: {
-            topBrowsers: "eventVolume";
-            topCampaigns: "eventVolume";
-            topCountries: "eventVolume";
-            topDevices: "eventVolume";
+            topBrowsers: "eventVolume" | "pageviews" | "sessions";
+            topCampaigns: "eventVolume" | "pageviews" | "sessions";
+            topCountries: "eventVolume" | "pageviews" | "sessions";
+            topDevices: "eventVolume" | "pageviews" | "sessions";
             topEvents: "eventVolume";
             topGoals: "goalCompletionVolume";
-            topPages: "eventVolume";
-            topSources: "eventVolume";
+            topPages: "eventVolume" | "pageviews" | "sessions";
+            topSources: "eventVolume" | "pageviews" | "sessions";
         };
         coverage: {
             availableFrom: number | null;
@@ -759,6 +772,7 @@ declare const hostOverviewValidator: import("convex/values").VObject<{
             retainedBefore: number | null;
             state: "complete" | "partial" | "retained" | "unavailable";
         };
+        engagement: "counted" | "unavailable";
         features: {
             botDetection: "userAgent";
             errorInsights: "unsupported";
@@ -768,7 +782,7 @@ declare const hostOverviewValidator: import("convex/values").VObject<{
         range: {
             boundary: "inclusive";
             from: number;
-            timezone: "UTC";
+            timezone: string;
             to: number;
         };
         visitors: {
@@ -781,9 +795,12 @@ declare const hostOverviewValidator: import("convex/values").VObject<{
     };
     timeSeries: {
         clicks: number;
+        continuedSessions: number;
         conversions: number;
         customEvents: number;
+        durationMs: number;
         events: number;
+        newVisitors: number;
         outboundClicks: number;
         pageviews: number;
         revenueCents: number;
@@ -834,9 +851,12 @@ declare const hostOverviewValidator: import("convex/values").VObject<{
     }[];
     totals: {
         clicks: number;
+        continuedSessions: number;
         conversions: number;
         customEvents: number;
+        durationMs: number;
         events: number;
+        newVisitors: number;
         outboundClicks: number;
         pageviews: number;
         revenueCents: number;
@@ -850,9 +870,12 @@ declare const hostOverviewValidator: import("convex/values").VObject<{
     currency: import("convex/values").VString<string, "required">;
     totals: import("convex/values").VObject<{
         clicks: number;
+        continuedSessions: number;
         conversions: number;
         customEvents: number;
+        durationMs: number;
         events: number;
+        newVisitors: number;
         outboundClicks: number;
         pageviews: number;
         revenueCents: number;
@@ -868,12 +891,18 @@ declare const hostOverviewValidator: import("convex/values").VObject<{
         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">;
+        durationMs: import("convex/values").VFloat64<number, "required">;
+        continuedSessions: import("convex/values").VFloat64<number, "required">;
+        newVisitors: import("convex/values").VFloat64<number, "required">;
+    }, "required", "clicks" | "continuedSessions" | "conversions" | "customEvents" | "durationMs" | "events" | "newVisitors" | "outboundClicks" | "pageviews" | "revenueCents" | "sessions" | "visitors">;
     timeSeries: import("convex/values").VArray<{
         clicks: number;
+        continuedSessions: number;
         conversions: number;
         customEvents: number;
+        durationMs: number;
         events: number;
+        newVisitors: number;
         outboundClicks: number;
         pageviews: number;
         revenueCents: number;
@@ -882,9 +911,12 @@ declare const hostOverviewValidator: import("convex/values").VObject<{
         visitors: number;
     }[], import("convex/values").VObject<{
         clicks: number;
+        continuedSessions: number;
         conversions: number;
         customEvents: number;
+        durationMs: number;
         events: number;
+        newVisitors: number;
         outboundClicks: number;
         pageviews: number;
         revenueCents: number;
@@ -901,8 +933,11 @@ declare const hostOverviewValidator: import("convex/values").VObject<{
         visitors: import("convex/values").VFloat64<number, "required">;
         conversions: import("convex/values").VFloat64<number, "required">;
         revenueCents: import("convex/values").VFloat64<number, "required">;
+        durationMs: import("convex/values").VFloat64<number, "required">;
+        continuedSessions: import("convex/values").VFloat64<number, "required">;
+        newVisitors: import("convex/values").VFloat64<number, "required">;
         timestamp: import("convex/values").VFloat64<number, "required">;
-    }, "required", "clicks" | "conversions" | "customEvents" | "events" | "outboundClicks" | "pageviews" | "revenueCents" | "sessions" | "timestamp" | "visitors">, "required">;
+    }, "required", "clicks" | "continuedSessions" | "conversions" | "customEvents" | "durationMs" | "events" | "newVisitors" | "outboundClicks" | "pageviews" | "revenueCents" | "sessions" | "timestamp" | "visitors">, "required">;
     topSources: import("convex/values").VArray<{
         count: number;
         revenueCents: number;
@@ -1009,14 +1044,14 @@ declare const hostOverviewValidator: import("convex/values").VObject<{
     }, "required", "count" | "revenueCents" | "value">, "required">;
     metadata: import("convex/values").VObject<{
         breakdowns: {
-            topBrowsers: "eventVolume";
-            topCampaigns: "eventVolume";
-            topCountries: "eventVolume";
-            topDevices: "eventVolume";
+            topBrowsers: "eventVolume" | "pageviews" | "sessions";
+            topCampaigns: "eventVolume" | "pageviews" | "sessions";
+            topCountries: "eventVolume" | "pageviews" | "sessions";
+            topDevices: "eventVolume" | "pageviews" | "sessions";
             topEvents: "eventVolume";
             topGoals: "goalCompletionVolume";
-            topPages: "eventVolume";
-            topSources: "eventVolume";
+            topPages: "eventVolume" | "pageviews" | "sessions";
+            topSources: "eventVolume" | "pageviews" | "sessions";
         };
         coverage: {
             availableFrom: number | null;
@@ -1025,6 +1060,7 @@ declare const hostOverviewValidator: import("convex/values").VObject<{
             retainedBefore: number | null;
             state: "complete" | "partial" | "retained" | "unavailable";
         };
+        engagement: "counted" | "unavailable";
         features: {
             botDetection: "userAgent";
             errorInsights: "unsupported";
@@ -1034,7 +1070,7 @@ declare const hostOverviewValidator: import("convex/values").VObject<{
         range: {
             boundary: "inclusive";
             from: number;
-            timezone: "UTC";
+            timezone: string;
             to: number;
         };
         visitors: {
@@ -1059,24 +1095,25 @@ declare const hostOverviewValidator: import("convex/values").VObject<{
             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";
-            topCampaigns: "eventVolume";
-            topCountries: "eventVolume";
-            topDevices: "eventVolume";
+            topBrowsers: "eventVolume" | "pageviews" | "sessions";
+            topCampaigns: "eventVolume" | "pageviews" | "sessions";
+            topCountries: "eventVolume" | "pageviews" | "sessions";
+            topDevices: "eventVolume" | "pageviews" | "sessions";
             topEvents: "eventVolume";
             topGoals: "goalCompletionVolume";
-            topPages: "eventVolume";
-            topSources: "eventVolume";
+            topPages: "eventVolume" | "pageviews" | "sessions";
+            topSources: "eventVolume" | "pageviews" | "sessions";
         }, {
-            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">;
+            topSources: import("convex/values").VUnion<"eventVolume" | "pageviews" | "sessions", [import("convex/values").VLiteral<"pageviews", "required">, import("convex/values").VLiteral<"sessions", "required">, import("convex/values").VLiteral<"eventVolume", "required">], "required", never>;
+            topCampaigns: import("convex/values").VUnion<"eventVolume" | "pageviews" | "sessions", [import("convex/values").VLiteral<"pageviews", "required">, import("convex/values").VLiteral<"sessions", "required">, import("convex/values").VLiteral<"eventVolume", "required">], "required", never>;
+            topPages: import("convex/values").VUnion<"eventVolume" | "pageviews" | "sessions", [import("convex/values").VLiteral<"pageviews", "required">, import("convex/values").VLiteral<"sessions", "required">, import("convex/values").VLiteral<"eventVolume", "required">], "required", never>;
+            topCountries: import("convex/values").VUnion<"eventVolume" | "pageviews" | "sessions", [import("convex/values").VLiteral<"pageviews", "required">, import("convex/values").VLiteral<"sessions", "required">, import("convex/values").VLiteral<"eventVolume", "required">], "required", never>;
+            topDevices: import("convex/values").VUnion<"eventVolume" | "pageviews" | "sessions", [import("convex/values").VLiteral<"pageviews", "required">, import("convex/values").VLiteral<"sessions", "required">, import("convex/values").VLiteral<"eventVolume", "required">], "required", never>;
+            topBrowsers: import("convex/values").VUnion<"eventVolume" | "pageviews" | "sessions", [import("convex/values").VLiteral<"pageviews", "required">, import("convex/values").VLiteral<"sessions", "required">, import("convex/values").VLiteral<"eventVolume", "required">], "required", never>;
             topEvents: import("convex/values").VLiteral<"eventVolume", "required">;
             topGoals: import("convex/values").VLiteral<"goalCompletionVolume", "required">;
         }, "required", "topBrowsers" | "topCampaigns" | "topCountries" | "topDevices" | "topEvents" | "topGoals" | "topPages" | "topSources">;
+        engagement: import("convex/values").VUnion<"counted" | "unavailable", [import("convex/values").VLiteral<"counted", "required">, import("convex/values").VLiteral<"unavailable", "required">], "required", never>;
         coverage: import("convex/values").VObject<{
             availableFrom: number | null;
             availableThrough: number | null;
@@ -1093,13 +1130,13 @@ declare const hostOverviewValidator: import("convex/values").VObject<{
         range: import("convex/values").VObject<{
             boundary: "inclusive";
             from: number;
-            timezone: "UTC";
+            timezone: string;
             to: number;
         }, {
             from: import("convex/values").VFloat64<number, "required">;
             to: import("convex/values").VFloat64<number, "required">;
             boundary: import("convex/values").VLiteral<"inclusive", "required">;
-            timezone: import("convex/values").VLiteral<"UTC", "required">;
+            timezone: import("convex/values").VString<string, "required">;
         }, "required", "boundary" | "from" | "timezone" | "to">;
         features: import("convex/values").VObject<{
             botDetection: "userAgent";
@@ -1112,8 +1149,8 @@ declare const hostOverviewValidator: import("convex/values").VObject<{
             outboundLinks: import("convex/values").VLiteral<"eventVolume", "required">;
             botDetection: import("convex/values").VLiteral<"userAgent", "required">;
         }, "required", "botDetection" | "errorInsights" | "outboundLinks" | "sessionReplay">;
-    }, "required", "breakdowns" | "breakdowns.topBrowsers" | "breakdowns.topCampaigns" | "breakdowns.topCountries" | "breakdowns.topDevices" | "breakdowns.topEvents" | "breakdowns.topGoals" | "breakdowns.topPages" | "breakdowns.topSources" | "coverage" | "coverage.availableFrom" | "coverage.availableThrough" | "coverage.generation" | "coverage.retainedBefore" | "coverage.state" | "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">;
+    }, "required", "breakdowns" | "breakdowns.topBrowsers" | "breakdowns.topCampaigns" | "breakdowns.topCountries" | "breakdowns.topDevices" | "breakdowns.topEvents" | "breakdowns.topGoals" | "breakdowns.topPages" | "breakdowns.topSources" | "coverage" | "coverage.availableFrom" | "coverage.availableThrough" | "coverage.generation" | "coverage.retainedBefore" | "coverage.state" | "engagement" | "features" | "features.botDetection" | "features.errorInsights" | "features.outboundLinks" | "features.sessionReplay" | "range" | "range.boundary" | "range.from" | "range.timezone" | "range.to" | "visitors" | "visitors.basis" | "visitors.exact" | "visitors.legacyIncomplete" | "visitors.precision" | "visitors.sketchVersion">;
+}, "required", "currency" | "from" | "interval" | "metadata" | "metadata.breakdowns" | "metadata.breakdowns.topBrowsers" | "metadata.breakdowns.topCampaigns" | "metadata.breakdowns.topCountries" | "metadata.breakdowns.topDevices" | "metadata.breakdowns.topEvents" | "metadata.breakdowns.topGoals" | "metadata.breakdowns.topPages" | "metadata.breakdowns.topSources" | "metadata.coverage" | "metadata.coverage.availableFrom" | "metadata.coverage.availableThrough" | "metadata.coverage.generation" | "metadata.coverage.retainedBefore" | "metadata.coverage.state" | "metadata.engagement" | "metadata.features" | "metadata.features.botDetection" | "metadata.features.errorInsights" | "metadata.features.outboundLinks" | "metadata.features.sessionReplay" | "metadata.range" | "metadata.range.boundary" | "metadata.range.from" | "metadata.range.timezone" | "metadata.range.to" | "metadata.visitors" | "metadata.visitors.basis" | "metadata.visitors.exact" | "metadata.visitors.legacyIncomplete" | "metadata.visitors.precision" | "metadata.visitors.sketchVersion" | "timeSeries" | "to" | "topBrowsers" | "topCampaigns" | "topCountries" | "topDevices" | "topEvents" | "topGoals" | "topPages" | "topSources" | "totals" | "totals.clicks" | "totals.continuedSessions" | "totals.conversions" | "totals.customEvents" | "totals.durationMs" | "totals.events" | "totals.newVisitors" | "totals.outboundClicks" | "totals.pageviews" | "totals.revenueCents" | "totals.sessions" | "totals.visitors">;
 declare const hostGoalsReportValidator: import("convex/values").VObject<{
     goals: {
         _creationTime: number;
@@ -1141,7 +1178,7 @@ declare const hostGoalsReportValidator: import("convex/values").VObject<{
         range: {
             boundary: "inclusive";
             from: number;
-            timezone: "UTC";
+            timezone: string;
             to: number;
         };
     };
@@ -1200,7 +1237,7 @@ declare const hostGoalsReportValidator: import("convex/values").VObject<{
         range: {
             boundary: "inclusive";
             from: number;
-            timezone: "UTC";
+            timezone: string;
             to: number;
         };
     }, {
@@ -1221,13 +1258,13 @@ declare const hostGoalsReportValidator: import("convex/values").VObject<{
         range: import("convex/values").VObject<{
             boundary: "inclusive";
             from: number;
-            timezone: "UTC";
+            timezone: string;
             to: number;
         }, {
             from: import("convex/values").VFloat64<number, "required">;
             to: import("convex/values").VFloat64<number, "required">;
             boundary: import("convex/values").VLiteral<"inclusive", "required">;
-            timezone: import("convex/values").VLiteral<"UTC", "required">;
+            timezone: import("convex/values").VString<string, "required">;
         }, "required", "boundary" | "from" | "timezone" | "to">;
     }, "required", "basis" | "coverage" | "coverage.availableFrom" | "coverage.availableThrough" | "coverage.generation" | "coverage.retainedBefore" | "coverage.state" | "range" | "range.boundary" | "range.from" | "range.timezone" | "range.to">;
 }, "required", "goals" | "metadata" | "metadata.basis" | "metadata.coverage" | "metadata.coverage.availableFrom" | "metadata.coverage.availableThrough" | "metadata.coverage.generation" | "metadata.coverage.retainedBefore" | "metadata.coverage.state" | "metadata.range" | "metadata.range.boundary" | "metadata.range.from" | "metadata.range.timezone" | "metadata.range.to" | "truncated">;
@@ -1250,7 +1287,7 @@ declare const hostFunnelsReportValidator: import("convex/values").VArray<{
         range: {
             boundary: "inclusive";
             from: number;
-            timezone: "UTC";
+            timezone: string;
             to: number;
         };
     };
@@ -1288,7 +1325,7 @@ declare const hostFunnelsReportValidator: import("convex/values").VArray<{
         range: {
             boundary: "inclusive";
             from: number;
-            timezone: "UTC";
+            timezone: string;
             to: number;
         };
     };
@@ -1359,7 +1396,7 @@ declare const hostFunnelsReportValidator: import("convex/values").VArray<{
         range: {
             boundary: "inclusive";
             from: number;
-            timezone: "UTC";
+            timezone: string;
             to: number;
         };
     }, {
@@ -1380,13 +1417,13 @@ declare const hostFunnelsReportValidator: import("convex/values").VArray<{
         range: import("convex/values").VObject<{
             boundary: "inclusive";
             from: number;
-            timezone: "UTC";
+            timezone: string;
             to: number;
         }, {
             from: import("convex/values").VFloat64<number, "required">;
             to: import("convex/values").VFloat64<number, "required">;
             boundary: import("convex/values").VLiteral<"inclusive", "required">;
-            timezone: import("convex/values").VLiteral<"UTC", "required">;
+            timezone: import("convex/values").VString<string, "required">;
         }, "required", "boundary" | "from" | "timezone" | "to">;
     }, "required", "basis" | "coverage" | "coverage.availableFrom" | "coverage.availableThrough" | "coverage.generation" | "coverage.retainedBefore" | "coverage.state" | "range" | "range.boundary" | "range.from" | "range.timezone" | "range.to">;
 }, "required", "_creationTime" | "_id" | "active" | "conversionWindowMs" | "createdAt" | "key" | "metadata" | "metadata.basis" | "metadata.coverage" | "metadata.coverage.availableFrom" | "metadata.coverage.availableThrough" | "metadata.coverage.generation" | "metadata.coverage.retainedBefore" | "metadata.coverage.state" | "metadata.range" | "metadata.range.boundary" | "metadata.range.from" | "metadata.range.timezone" | "metadata.range.to" | "name" | "siteId" | "steps" | "stepsReport" | "truncated" | "updatedAt">, "required">;
@@ -1420,7 +1457,7 @@ declare const hostAffiliatesReportValidator: import("convex/values").VObject<{
         range: {
             boundary: "inclusive";
             from: number;
-            timezone: "UTC";
+            timezone: string;
             to: number;
         };
         uniqueVisitors: {
@@ -1492,7 +1529,7 @@ declare const hostAffiliatesReportValidator: import("convex/values").VObject<{
         range: {
             boundary: "inclusive";
             from: number;
-            timezone: "UTC";
+            timezone: string;
             to: number;
         };
         uniqueVisitors: {
@@ -1517,13 +1554,13 @@ declare const hostAffiliatesReportValidator: import("convex/values").VObject<{
         range: import("convex/values").VObject<{
             boundary: "inclusive";
             from: number;
-            timezone: "UTC";
+            timezone: string;
             to: number;
         }, {
             from: import("convex/values").VFloat64<number, "required">;
             to: import("convex/values").VFloat64<number, "required">;
             boundary: import("convex/values").VLiteral<"inclusive", "required">;
-            timezone: import("convex/values").VLiteral<"UTC", "required">;
+            timezone: import("convex/values").VString<string, "required">;
         }, "required", "boundary" | "from" | "timezone" | "to">;
         uniqueVisitors: import("convex/values").VObject<{
             basis: "estimatedUnique" | "exactLegacy";
@@ -1547,7 +1584,7 @@ declare const hostVitalsReportValidator: import("convex/values").VObject<{
         range: {
             boundary: "inclusive";
             from: number;
-            timezone: "UTC";
+            timezone: string;
             to: number;
         };
     };
@@ -1732,7 +1769,7 @@ declare const hostVitalsReportValidator: import("convex/values").VObject<{
         range: {
             boundary: "inclusive";
             from: number;
-            timezone: "UTC";
+            timezone: string;
             to: number;
         };
     }, {
@@ -1753,13 +1790,13 @@ declare const hostVitalsReportValidator: import("convex/values").VObject<{
         range: import("convex/values").VObject<{
             boundary: "inclusive";
             from: number;
-            timezone: "UTC";
+            timezone: string;
             to: number;
         }, {
             from: import("convex/values").VFloat64<number, "required">;
             to: import("convex/values").VFloat64<number, "required">;
             boundary: import("convex/values").VLiteral<"inclusive", "required">;
-            timezone: import("convex/values").VLiteral<"UTC", "required">;
+            timezone: import("convex/values").VString<string, "required">;
         }, "required", "boundary" | "from" | "timezone" | "to">;
     }, "required", "basis" | "coverage" | "coverage.availableFrom" | "coverage.availableThrough" | "coverage.generation" | "coverage.retainedBefore" | "coverage.state" | "range" | "range.boundary" | "range.from" | "range.timezone" | "range.to">;
 }, "required", "metadata" | "metadata.basis" | "metadata.coverage" | "metadata.coverage.availableFrom" | "metadata.coverage.availableThrough" | "metadata.coverage.generation" | "metadata.coverage.retainedBefore" | "metadata.coverage.state" | "metadata.range" | "metadata.range.boundary" | "metadata.range.from" | "metadata.range.timezone" | "metadata.range.to" | "metrics" | "truncated">;
@@ -1782,7 +1819,7 @@ declare const hostSiteMapValidator: import("convex/values").VObject<{
         range: {
             boundary: "inclusive";
             from: number;
-            timezone: "UTC";
+            timezone: string;
             to: number;
         };
         visitors: {
@@ -1922,7 +1959,7 @@ declare const hostSiteMapValidator: import("convex/values").VObject<{
         range: {
             boundary: "inclusive";
             from: number;
-            timezone: "UTC";
+            timezone: string;
             to: number;
         };
         visitors: {
@@ -1947,13 +1984,13 @@ declare const hostSiteMapValidator: import("convex/values").VObject<{
         range: import("convex/values").VObject<{
             boundary: "inclusive";
             from: number;
-            timezone: "UTC";
+            timezone: string;
             to: number;
         }, {
             from: import("convex/values").VFloat64<number, "required">;
             to: import("convex/values").VFloat64<number, "required">;
             boundary: import("convex/values").VLiteral<"inclusive", "required">;
-            timezone: import("convex/values").VLiteral<"UTC", "required">;
+            timezone: import("convex/values").VString<string, "required">;
         }, "required", "boundary" | "from" | "timezone" | "to">;
         visitors: import("convex/values").VObject<{
             basis: "estimatedUnique";
@@ -2096,14 +2133,14 @@ export declare function exposeAnalyticsApi(component: ComponentApi, options: {
         interval: "hour" | "day";
         metadata: {
             breakdowns: {
-                topBrowsers: "eventVolume";
-                topCampaigns: "eventVolume";
-                topCountries: "eventVolume";
-                topDevices: "eventVolume";
+                topBrowsers: "pageviews" | "sessions" | "eventVolume";
+                topCampaigns: "pageviews" | "sessions" | "eventVolume";
+                topCountries: "pageviews" | "sessions" | "eventVolume";
+                topDevices: "pageviews" | "sessions" | "eventVolume";
                 topEvents: "eventVolume";
                 topGoals: "goalCompletionVolume";
-                topPages: "eventVolume";
-                topSources: "eventVolume";
+                topPages: "pageviews" | "sessions" | "eventVolume";
+                topSources: "pageviews" | "sessions" | "eventVolume";
             };
             coverage: {
                 availableFrom: number | null;
@@ -2112,6 +2149,7 @@ export declare function exposeAnalyticsApi(component: ComponentApi, options: {
                 retainedBefore: number | null;
                 state: "complete" | "partial" | "retained" | "unavailable";
             };
+            engagement: "counted" | "unavailable";
             features: {
                 botDetection: "userAgent";
                 errorInsights: "unsupported";
@@ -2121,7 +2159,7 @@ export declare function exposeAnalyticsApi(component: ComponentApi, options: {
             range: {
                 boundary: "inclusive";
                 from: number;
-                timezone: "UTC";
+                timezone: string;
                 to: number;
             };
             visitors: {
@@ -2134,9 +2172,12 @@ export declare function exposeAnalyticsApi(component: ComponentApi, options: {
         };
         timeSeries: Array<{
             clicks: number;
+            continuedSessions: number;
             conversions: number;
             customEvents: number;
+            durationMs: number;
             events: number;
+            newVisitors: number;
             outboundClicks: number;
             pageviews: number;
             revenueCents: number;
@@ -2187,9 +2228,12 @@ export declare function exposeAnalyticsApi(component: ComponentApi, options: {
         }>;
         totals: {
             clicks: number;
+            continuedSessions: number;
             conversions: number;
             customEvents: number;
+            durationMs: number;
             events: number;
+            newVisitors: number;
             outboundClicks: number;
             pageviews: number;
             revenueCents: number;
@@ -2423,7 +2467,7 @@ export declare function exposeAnalyticsApi(component: ComponentApi, options: {
             range: {
                 boundary: "inclusive";
                 from: number;
-                timezone: "UTC";
+                timezone: string;
                 to: number;
             };
         };
@@ -2452,7 +2496,7 @@ export declare function exposeAnalyticsApi(component: ComponentApi, options: {
             range: {
                 boundary: "inclusive";
                 from: number;
-                timezone: "UTC";
+                timezone: string;
                 to: number;
             };
         };
@@ -2506,7 +2550,7 @@ export declare function exposeAnalyticsApi(component: ComponentApi, options: {
             range: {
                 boundary: "inclusive";
                 from: number;
-                timezone: "UTC";
+                timezone: string;
                 to: number;
             };
             uniqueVisitors: {
@@ -2533,7 +2577,7 @@ export declare function exposeAnalyticsApi(component: ComponentApi, options: {
             range: {
                 boundary: "inclusive";
                 from: number;
-                timezone: "UTC";
+                timezone: string;
                 to: number;
             };
         };
@@ -2594,7 +2638,7 @@ export declare function exposeAnalyticsApi(component: ComponentApi, options: {
             range: {
                 boundary: "inclusive";
                 from: number;
-                timezone: "UTC";
+                timezone: string;
                 to: number;
             };
             visitors: {
@@ -2646,7 +2690,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" | "vitals" | "siteMap";
+            dataset: "overviewHour" | "overviewDay" | "overviewLocalDay" | "events" | "sessions" | "conversions" | "goals" | "funnels" | "affiliates" | "vitals" | "siteMap";
         }>;
         from: number;
         siteId: string;
@@ -2795,7 +2839,12 @@ export declare function exposeAnalyticsApi(component: ComponentApi, options: {
         hasMore: boolean;
     }>>;
 };
-/** Exposes only the reactive read surface used by a federated Rastro dashboard. */
+/**
+ * Exposes the reactive read surface a federated Rastro dashboard subscribes to,
+ * plus the configuration functions behind the `configure` capability, which
+ * run only when the token and the host's grant both carry the configure
+ * permission.
+ */
 export declare function exposeFederatedAnalyticsApi(component: ComponentApi, options: FederatedAnalyticsAuthorizerOptions): {
     manifest: import("convex/server").RegisteredQuery<"public", {}, {
         protocol: "amage-rastro-analytics";
@@ -2815,10 +2864,24 @@ export declare function exposeFederatedAnalyticsApi(component: ComponentApi, opt
             funnelsReport: "funnelsReport";
             affiliatesReport: "affiliatesReport";
             dataCoverage: "dataCoverage";
+            siteSettings: "siteSettings";
+            updateSite: "updateSite";
+            listGoals: "listGoals";
+            upsertGoal: "upsertGoal";
+            removeGoal: "removeGoal";
+            listFunnels: "listFunnels";
+            upsertFunnel: "upsertFunnel";
+            removeFunnel: "removeFunnel";
+            listAffiliates: "listAffiliates";
+            upsertAffiliate: "upsertAffiliate";
+            removeAffiliate: "removeAffiliate";
+            retentionStatus: "retentionStatus";
+            setRetentionPolicy: "setRetentionPolicy";
+            disableRetentionPolicy: "disableRetentionPolicy";
             vitalsReport: "vitalsReport";
             siteMap: "siteMap";
         };
-        capabilities: ("affiliates" | "conversions" | "dataCoverage" | "funnels" | "goals" | "liveVisitors" | "overview" | "sessionJourney" | "sessions" | "siteMap" | "siteSummaries" | "visitorJourney" | "vitals")[];
+        capabilities: ("affiliates" | "configure" | "conversions" | "dataCoverage" | "funnels" | "goals" | "liveVisitors" | "localDays" | "overview" | "sessionJourney" | "sessions" | "siteMap" | "siteSummaries" | "visitorJourney" | "vitals")[];
         limits: {
             maxSitesPerRequest: 10;
             maxSitesPerConnection: 10;
@@ -2840,14 +2903,14 @@ export declare function exposeFederatedAnalyticsApi(component: ComponentApi, opt
         interval: "hour" | "day";
         metadata: {
             breakdowns: {
-                topBrowsers: "eventVolume";
-                topCampaigns: "eventVolume";
-                topCountries: "eventVolume";
-                topDevices: "eventVolume";
+                topBrowsers: "pageviews" | "sessions" | "eventVolume";
+                topCampaigns: "pageviews" | "sessions" | "eventVolume";
+                topCountries: "pageviews" | "sessions" | "eventVolume";
+                topDevices: "pageviews" | "sessions" | "eventVolume";
                 topEvents: "eventVolume";
                 topGoals: "goalCompletionVolume";
-                topPages: "eventVolume";
-                topSources: "eventVolume";
+                topPages: "pageviews" | "sessions" | "eventVolume";
+                topSources: "pageviews" | "sessions" | "eventVolume";
             };
             coverage: {
                 availableFrom: number | null;
@@ -2856,6 +2919,7 @@ export declare function exposeFederatedAnalyticsApi(component: ComponentApi, opt
                 retainedBefore: number | null;
                 state: "complete" | "partial" | "retained" | "unavailable";
             };
+            engagement: "counted" | "unavailable";
             features: {
                 botDetection: "userAgent";
                 errorInsights: "unsupported";
@@ -2865,7 +2929,7 @@ export declare function exposeFederatedAnalyticsApi(component: ComponentApi, opt
             range: {
                 boundary: "inclusive";
                 from: number;
-                timezone: "UTC";
+                timezone: string;
                 to: number;
             };
             visitors: {
@@ -2878,9 +2942,12 @@ export declare function exposeFederatedAnalyticsApi(component: ComponentApi, opt
         };
         timeSeries: Array<{
             clicks: number;
+            continuedSessions: number;
             conversions: number;
             customEvents: number;
+            durationMs: number;
             events: number;
+            newVisitors: number;
             outboundClicks: number;
             pageviews: number;
             revenueCents: number;
@@ -2931,9 +2998,12 @@ export declare function exposeFederatedAnalyticsApi(component: ComponentApi, opt
         }>;
         totals: {
             clicks: number;
+            continuedSessions: number;
             conversions: number;
             customEvents: number;
+            durationMs: number;
             events: number;
+            newVisitors: number;
             outboundClicks: number;
             pageviews: number;
             revenueCents: number;
@@ -3167,7 +3237,7 @@ export declare function exposeFederatedAnalyticsApi(component: ComponentApi, opt
             range: {
                 boundary: "inclusive";
                 from: number;
-                timezone: "UTC";
+                timezone: string;
                 to: number;
             };
         };
@@ -3196,7 +3266,7 @@ export declare function exposeFederatedAnalyticsApi(component: ComponentApi, opt
             range: {
                 boundary: "inclusive";
                 from: number;
-                timezone: "UTC";
+                timezone: string;
                 to: number;
             };
         };
@@ -3250,7 +3320,7 @@ export declare function exposeFederatedAnalyticsApi(component: ComponentApi, opt
             range: {
                 boundary: "inclusive";
                 from: number;
-                timezone: "UTC";
+                timezone: string;
                 to: number;
             };
             uniqueVisitors: {
@@ -3277,7 +3347,7 @@ export declare function exposeFederatedAnalyticsApi(component: ComponentApi, opt
             range: {
                 boundary: "inclusive";
                 from: number;
-                timezone: "UTC";
+                timezone: string;
                 to: number;
             };
         };
@@ -3338,7 +3408,7 @@ export declare function exposeFederatedAnalyticsApi(component: ComponentApi, opt
             range: {
                 boundary: "inclusive";
                 from: number;
-                timezone: "UTC";
+                timezone: string;
                 to: number;
             };
             visitors: {
@@ -3390,12 +3460,151 @@ export declare function exposeFederatedAnalyticsApi(component: ComponentApi, opt
                 retainedBefore: number | null;
                 state: "complete" | "partial" | "retained" | "unavailable";
             };
-            dataset: "overviewHour" | "overviewDay" | "events" | "sessions" | "conversions" | "goals" | "funnels" | "affiliates" | "vitals" | "siteMap";
+            dataset: "overviewHour" | "overviewDay" | "overviewLocalDay" | "events" | "sessions" | "conversions" | "goals" | "funnels" | "affiliates" | "vitals" | "siteMap";
         }>;
         from: number;
         siteId: string;
         to: number;
     }>>;
+    siteSettings: import("convex/server").RegisteredQuery<"public", {
+        siteId: string;
+    }, Promise<{
+        siteId: string;
+        name: string;
+        domains: string[];
+        timezone: string | null;
+        currency: string;
+        cookieless: boolean;
+    }>>;
+    updateSite: import("convex/server").RegisteredMutation<"public", {
+        domains?: string[] | undefined;
+        name?: string | undefined;
+        siteId: string;
+        timezone?: string | null | undefined;
+    }, Promise<null>>;
+    listGoals: import("convex/server").RegisteredQuery<"public", {
+        siteId: string;
+    }, Promise<{
+        _creationTime: number;
+        _id: string;
+        active: boolean;
+        createdAt: number;
+        key: string;
+        matchType: "pageview" | "custom";
+        matchValue: string;
+        name: string;
+        siteId: string;
+        updatedAt: number;
+        valueCents?: number;
+    }[]>>;
+    upsertGoal: import("convex/server").RegisteredMutation<"public", {
+        active?: boolean | undefined;
+        goalId?: string | undefined;
+        key: string;
+        matchType: "custom" | "pageview";
+        matchValue: string;
+        name: string;
+        siteId: string;
+        valueCents?: number | undefined;
+    }, Promise<string>>;
+    removeGoal: import("convex/server").RegisteredMutation<"public", {
+        goalId: string;
+        siteId: string;
+    }, Promise<null>>;
+    listFunnels: import("convex/server").RegisteredQuery<"public", {
+        siteId: string;
+    }, Promise<{
+        _creationTime: number;
+        _id: string;
+        active: boolean;
+        conversionWindowMs: number;
+        createdAt: number;
+        key: string;
+        name: string;
+        siteId: string;
+        steps: Array<{
+            name: string;
+            type: "pageview" | "custom";
+            value: string;
+        }>;
+        updatedAt: number;
+    }[]>>;
+    upsertFunnel: import("convex/server").RegisteredMutation<"public", {
+        active?: boolean | undefined;
+        conversionWindowMs: number;
+        funnelId?: string | undefined;
+        key: string;
+        name: string;
+        siteId: string;
+        steps: {
+            name: string;
+            type: "custom" | "pageview";
+            value: string;
+        }[];
+    }, Promise<string>>;
+    removeFunnel: import("convex/server").RegisteredMutation<"public", {
+        funnelId: string;
+        siteId: string;
+    }, Promise<null>>;
+    listAffiliates: import("convex/server").RegisteredQuery<"public", {
+        siteId: string;
+    }, Promise<{
+        _creationTime: number;
+        _id: string;
+        active: boolean;
+        attributionWindowDays: number;
+        commissionBps: number;
+        createdAt: number;
+        name: string;
+        siteId: string;
+        slug: string;
+        updatedAt: number;
+    }[]>>;
+    upsertAffiliate: import("convex/server").RegisteredMutation<"public", {
+        active?: boolean | undefined;
+        affiliateId?: string | undefined;
+        attributionWindowDays: number;
+        commissionBps: number;
+        name: string;
+        siteId: string;
+        slug: string;
+    }, Promise<string>>;
+    removeAffiliate: import("convex/server").RegisteredMutation<"public", {
+        affiliateId: string;
+        siteId: string;
+    }, Promise<null>>;
+    retentionStatus: import("convex/server").RegisteredQuery<"public", {
+        siteId: string;
+    }, Promise<{
+        backlog: number;
+        jobs: Array<{
+            before: number;
+            deleted: number;
+            kind: "events" | "sessions" | "conversions" | "goalCompletions" | "aggregateHour" | "aggregateDay" | "funnelProgress" | "funnelSteps" | "affiliateStats" | "goalRollups" | "funnelRollups" | "affiliateRollups" | "vitalRollups" | "siteMapRollups" | "attributions" | "liveSessions" | "ingestWindows" | "siteIngestWindows";
+            scheduledAt: number | null;
+            status: "pending" | "running" | "complete";
+            updatedAt: number;
+        }>;
+        policy: {
+            aggregatesDays: number;
+            conversionsDays: number;
+            eventsDays: number;
+            reportsDays: number;
+            sessionsDays: number;
+            updatedAt: number;
+        } | null;
+    }>>;
+    setRetentionPolicy: import("convex/server").RegisteredMutation<"public", {
+        aggregatesDays: number;
+        conversionsDays: number;
+        eventsDays: number;
+        reportsDays: number;
+        sessionsDays: number;
+        siteId: string;
+    }, Promise<null>>;
+    disableRetentionPolicy: import("convex/server").RegisteredMutation<"public", {
+        siteId: string;
+    }, Promise<null>>;
 };
 export declare function componentHttpPaths(prefix?: string): {
     readonly events: `${string}/events`;