@iann29/rastro 0.4.0 → 0.5.0

package/dist/client/index.d.ts

@@ -4,7 +4,8 @@ import type { ComponentApi } from "../component/_generated/component.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, vitalMetricValidator, };
-export type { EventProperties, EventType, FunnelStep, IngestContext, TrackerEvent, } from "../component/validators.js";
+export type { Channel, EventProperties, EventType, Evidence, FunnelStep, IngestContext, TrackerEvent, } from "../component/validators.js";
+export { channelForPlatform, platformDimensionValue, platformForSource, splitPlatformDimension, } from "../component/origin.js";
 export { VITAL_METRICS, VITAL_THRESHOLDS } from "../component/vitals.js";
 export { normalizeRoute } from "../component/sanitize.js";
 export { localDayStart, nextLocalDayStart, previousLocalDayStart, } from "../component/localTime.js";
@@ -57,6 +58,10 @@ export type Funnel = FunctionReturnType<ComponentApi["funnels"]["list"]>[number]
 export type UpsertAffiliateInput = FunctionArgs<ComponentApi["affiliates"]["upsert"]>;
 export type UpsertAffiliateOutput = FunctionReturnType<ComponentApi["affiliates"]["upsert"]>;
 export type Affiliate = FunctionReturnType<ComponentApi["affiliates"]["list"]>[number];
+export type CreateTrackedLinkInput = FunctionArgs<ComponentApi["trackedLinks"]["create"]>;
+export type UpdateTrackedLinkInput = FunctionArgs<ComponentApi["trackedLinks"]["update"]>;
+export type ListTrackedLinksInput = FunctionArgs<ComponentApi["trackedLinks"]["list"]>;
+export type TrackedLink = FunctionReturnType<ComponentApi["trackedLinks"]["list"]>[number];
 export type CleanupInput = {
     siteId: string;
     kind: RetentionKind;
@@ -175,13 +180,16 @@ export declare class Rastro {
             breakdowns: {
                 topBrowsers: "pageviews" | "sessions" | "eventVolume";
                 topCampaigns: "pageviews" | "sessions" | "eventVolume";
+                topChannels: "pageviews" | "sessions" | "eventVolume";
                 topCountries: "pageviews" | "sessions" | "eventVolume";
                 topDevices: "pageviews" | "sessions" | "eventVolume";
                 topEvents: "eventVolume";
+                topEvidence: "pageviews" | "sessions" | "eventVolume";
                 topGoals: "goalCompletionVolume";
                 topMediums: "pageviews" | "sessions" | "eventVolume";
                 topOutbound: "eventVolume";
                 topPages: "pageviews" | "sessions" | "eventVolume";
+                topPlatforms: "pageviews" | "sessions" | "eventVolume";
                 topSources: "pageviews" | "sessions" | "eventVolume";
             };
             coverage: {
@@ -239,6 +247,11 @@ export declare class Rastro {
             revenueCents: number;
             value: string;
         }>;
+        topChannels: Array<{
+            count: number;
+            revenueCents: number;
+            value: string;
+        }>;
         topCountries: Array<{
             count: number;
             revenueCents: number;
@@ -254,6 +267,11 @@ export declare class Rastro {
             revenueCents: number;
             value: string;
         }>;
+        topEvidence: Array<{
+            count: number;
+            revenueCents: number;
+            value: string;
+        }>;
         topGoals: Array<{
             count: number;
             revenueCents: number;
@@ -274,6 +292,11 @@ export declare class Rastro {
             revenueCents: number;
             value: string;
         }>;
+        topPlatforms: Array<{
+            count: number;
+            revenueCents: number;
+            value: string;
+        }>;
         topSources: Array<{
             count: number;
             revenueCents: number;
@@ -338,6 +361,7 @@ export declare class Rastro {
         affiliateId?: string;
         affiliateSlug?: string;
         browser: string;
+        channel?: "direct" | "organic_search" | "paid_search" | "organic_social" | "paid_social" | "messaging" | "email" | "affiliate" | "ai" | "display" | "referral" | "offline";
         city?: string;
         conversionCount: number;
         country?: string;
@@ -346,6 +370,7 @@ export declare class Rastro {
         durationMs: number;
         entryPath: string;
         eventCount: number;
+        evidence?: "utm" | "clickId" | "referrer" | "inApp" | "affiliate" | "none" | "legacy";
         exitPath: string;
         lastSeenAt: number;
         latitude?: number;
@@ -353,6 +378,7 @@ export declare class Rastro {
         newVisitor?: boolean;
         os: string;
         pageviewCount: number;
+        platform?: string;
         referrer?: string;
         revenueCents: number;
         sessionId: string;
@@ -383,6 +409,7 @@ export declare class Rastro {
             affiliateId?: string;
             affiliateSlug?: string;
             browser: string;
+            channel?: "direct" | "organic_search" | "paid_search" | "organic_social" | "paid_social" | "messaging" | "email" | "affiliate" | "ai" | "display" | "referral" | "offline";
             city?: string;
             conversionCount: number;
             country?: string;
@@ -391,6 +418,7 @@ export declare class Rastro {
             durationMs: number;
             entryPath: string;
             eventCount: number;
+            evidence?: "utm" | "clickId" | "referrer" | "inApp" | "affiliate" | "none" | "legacy";
             exitPath: string;
             lastSeenAt: number;
             latitude?: number;
@@ -398,6 +426,7 @@ export declare class Rastro {
             newVisitor?: boolean;
             os: string;
             pageviewCount: number;
+            platform?: string;
             referrer?: string;
             revenueCents: number;
             sessionId: string;
@@ -766,6 +795,26 @@ export declare class Rastro {
         updatedAt: number;
     }[]>;
     removeAffiliate(ctx: MutationCtx, siteId: string, affiliateId: string): Promise<null>;
+    createTrackedLink(ctx: MutationCtx, args: CreateTrackedLinkInput): Promise<string>;
+    updateTrackedLink(ctx: MutationCtx, args: UpdateTrackedLinkInput): Promise<null>;
+    deleteTrackedLink(ctx: MutationCtx, siteId: string, linkId: string): Promise<null>;
+    listTrackedLinks(ctx: QueryCtx | MutationCtx | ActionCtx, args: ListTrackedLinksInput): Promise<{
+        _creationTime: number;
+        _id: string;
+        bots: number;
+        botsLast30Days: number;
+        campaign?: string;
+        channel: "organic_social" | "paid_social" | "messaging" | "email" | "affiliate" | "display" | "referral" | "offline";
+        clicks: number;
+        clicksLast30Days: number;
+        createdAt: number;
+        createdBy: string;
+        destination: string;
+        disabledAt?: number;
+        platform: string;
+        siteId: string;
+        slug: string;
+    }[]>;
     cleanup(ctx: MutationCtx, args: CleanupInput): Promise<{
         before: number;
         deleted: number;
@@ -780,7 +829,7 @@ export declare class Rastro {
                 retainedBefore: number | null;
                 state: "complete" | "partial" | "retained" | "unavailable";
             };
-            dataset: "overviewHour" | "overviewDay" | "overviewLocalDay" | "events" | "sessions" | "conversions" | "goals" | "funnels" | "affiliates" | "vitals" | "siteMap";
+            dataset: "overviewHour" | "overviewDay" | "overviewLocalDay" | "events" | "sessions" | "conversions" | "goals" | "funnels" | "affiliates" | "vitals" | "siteMap" | "origin";
         }>;
         from: number;
         siteId: string;
@@ -813,7 +862,7 @@ export declare class Rastro {
         hasMore: boolean;
     }>;
 }
-export type AnalyticsOperation = "site.create" | "site.update" | "site.get" | "site.list" | "ingest" | "conversion.track" | "visitor.link" | "report.overview" | "report.live" | "report.sessions" | "report.sessionJourney" | "report.conversions" | "report.visitorJourney" | "report.goals" | "report.funnels" | "report.affiliates" | "report.vitals" | "report.siteMap" | "goal.upsert" | "goal.list" | "goal.remove" | "funnel.upsert" | "funnel.list" | "funnel.remove" | "affiliate.upsert" | "affiliate.list" | "affiliate.remove" | "retention.cleanup" | "retention.policy" | "retention.status" | "coverage.read";
+export type AnalyticsOperation = "site.create" | "site.update" | "site.get" | "site.list" | "ingest" | "conversion.track" | "visitor.link" | "report.overview" | "report.live" | "report.sessions" | "report.sessionJourney" | "report.conversions" | "report.visitorJourney" | "report.goals" | "report.funnels" | "report.affiliates" | "report.vitals" | "report.siteMap" | "goal.upsert" | "goal.list" | "goal.remove" | "funnel.upsert" | "funnel.list" | "funnel.remove" | "affiliate.upsert" | "affiliate.list" | "affiliate.remove" | "trackedLink.create" | "trackedLink.update" | "trackedLink.delete" | "trackedLink.list" | "retention.cleanup" | "retention.policy" | "retention.status" | "coverage.read";
 export type AnalyticsAuthorizationRequest = {
     operation: AnalyticsOperation;
     siteIds: string[];
@@ -829,13 +878,16 @@ declare const hostOverviewValidator: import("convex/values").VObject<{
         breakdowns: {
             topBrowsers: "eventVolume" | "pageviews" | "sessions";
             topCampaigns: "eventVolume" | "pageviews" | "sessions";
+            topChannels: "eventVolume" | "pageviews" | "sessions";
             topCountries: "eventVolume" | "pageviews" | "sessions";
             topDevices: "eventVolume" | "pageviews" | "sessions";
             topEvents: "eventVolume";
+            topEvidence: "eventVolume" | "pageviews" | "sessions";
             topGoals: "goalCompletionVolume";
             topMediums: "eventVolume" | "pageviews" | "sessions";
             topOutbound: "eventVolume";
             topPages: "eventVolume" | "pageviews" | "sessions";
+            topPlatforms: "eventVolume" | "pageviews" | "sessions";
             topSources: "eventVolume" | "pageviews" | "sessions";
         };
         coverage: {
@@ -893,6 +945,11 @@ declare const hostOverviewValidator: import("convex/values").VObject<{
         revenueCents: number;
         value: string;
     }[];
+    topChannels: {
+        count: number;
+        revenueCents: number;
+        value: string;
+    }[];
     topCountries: {
         count: number;
         revenueCents: number;
@@ -908,6 +965,11 @@ declare const hostOverviewValidator: import("convex/values").VObject<{
         revenueCents: number;
         value: string;
     }[];
+    topEvidence: {
+        count: number;
+        revenueCents: number;
+        value: string;
+    }[];
     topGoals: {
         count: number;
         revenueCents: number;
@@ -928,6 +990,11 @@ declare const hostOverviewValidator: import("convex/values").VObject<{
         revenueCents: number;
         value: string;
     }[];
+    topPlatforms: {
+        count: number;
+        revenueCents: number;
+        value: string;
+    }[];
     topSources: {
         count: number;
         revenueCents: number;
@@ -1152,17 +1219,59 @@ 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">;
+    topPlatforms: 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">;
+    topChannels: 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">;
+    topEvidence: import("convex/values").VArray<{
+        count: number;
+        revenueCents: number;
+        value: string;
+    }[], import("convex/values").VObject<{
+        count: number;
+        revenueCents: number;
+        value: string;
+    }, {
+        value: import("convex/values").VString<string, "required">;
+        count: import("convex/values").VFloat64<number, "required">;
+        revenueCents: import("convex/values").VFloat64<number, "required">;
+    }, "required", "count" | "revenueCents" | "value">, "required">;
     metadata: import("convex/values").VObject<{
         breakdowns: {
             topBrowsers: "eventVolume" | "pageviews" | "sessions";
             topCampaigns: "eventVolume" | "pageviews" | "sessions";
+            topChannels: "eventVolume" | "pageviews" | "sessions";
             topCountries: "eventVolume" | "pageviews" | "sessions";
             topDevices: "eventVolume" | "pageviews" | "sessions";
             topEvents: "eventVolume";
+            topEvidence: "eventVolume" | "pageviews" | "sessions";
             topGoals: "goalCompletionVolume";
             topMediums: "eventVolume" | "pageviews" | "sessions";
             topOutbound: "eventVolume";
             topPages: "eventVolume" | "pageviews" | "sessions";
+            topPlatforms: "eventVolume" | "pageviews" | "sessions";
             topSources: "eventVolume" | "pageviews" | "sessions";
         };
         coverage: {
@@ -1210,13 +1319,16 @@ declare const hostOverviewValidator: import("convex/values").VObject<{
         breakdowns: import("convex/values").VObject<{
             topBrowsers: "eventVolume" | "pageviews" | "sessions";
             topCampaigns: "eventVolume" | "pageviews" | "sessions";
+            topChannels: "eventVolume" | "pageviews" | "sessions";
             topCountries: "eventVolume" | "pageviews" | "sessions";
             topDevices: "eventVolume" | "pageviews" | "sessions";
             topEvents: "eventVolume";
+            topEvidence: "eventVolume" | "pageviews" | "sessions";
             topGoals: "goalCompletionVolume";
             topMediums: "eventVolume" | "pageviews" | "sessions";
             topOutbound: "eventVolume";
             topPages: "eventVolume" | "pageviews" | "sessions";
+            topPlatforms: "eventVolume" | "pageviews" | "sessions";
             topSources: "eventVolume" | "pageviews" | "sessions";
         }, {
             topSources: import("convex/values").VUnion<"eventVolume" | "pageviews" | "sessions", [import("convex/values").VLiteral<"pageviews", "required">, import("convex/values").VLiteral<"sessions", "required">, import("convex/values").VLiteral<"eventVolume", "required">], "required", never>;
@@ -1229,7 +1341,10 @@ declare const hostOverviewValidator: import("convex/values").VObject<{
             topGoals: import("convex/values").VLiteral<"goalCompletionVolume", "required">;
             topMediums: 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>;
             topOutbound: import("convex/values").VLiteral<"eventVolume", "required">;
-        }, "required", "topBrowsers" | "topCampaigns" | "topCountries" | "topDevices" | "topEvents" | "topGoals" | "topMediums" | "topOutbound" | "topPages" | "topSources">;
+            topPlatforms: 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>;
+            topChannels: 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>;
+            topEvidence: 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>;
+        }, "required", "topBrowsers" | "topCampaigns" | "topChannels" | "topCountries" | "topDevices" | "topEvents" | "topEvidence" | "topGoals" | "topMediums" | "topOutbound" | "topPages" | "topPlatforms" | "topSources">;
         dimensionsSince: import("convex/values").VUnion<number | null, [import("convex/values").VFloat64<number, "required">, import("convex/values").VNull<null, "required">], "required", never>;
         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<{
@@ -1267,8 +1382,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.topMediums" | "breakdowns.topOutbound" | "breakdowns.topPages" | "breakdowns.topSources" | "coverage" | "coverage.availableFrom" | "coverage.availableThrough" | "coverage.generation" | "coverage.retainedBefore" | "coverage.state" | "dimensionsSince" | "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.topMediums" | "metadata.breakdowns.topOutbound" | "metadata.breakdowns.topPages" | "metadata.breakdowns.topSources" | "metadata.coverage" | "metadata.coverage.availableFrom" | "metadata.coverage.availableThrough" | "metadata.coverage.generation" | "metadata.coverage.retainedBefore" | "metadata.coverage.state" | "metadata.dimensionsSince" | "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" | "topMediums" | "topOutbound" | "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">;
+    }, "required", "breakdowns" | "breakdowns.topBrowsers" | "breakdowns.topCampaigns" | "breakdowns.topChannels" | "breakdowns.topCountries" | "breakdowns.topDevices" | "breakdowns.topEvents" | "breakdowns.topEvidence" | "breakdowns.topGoals" | "breakdowns.topMediums" | "breakdowns.topOutbound" | "breakdowns.topPages" | "breakdowns.topPlatforms" | "breakdowns.topSources" | "coverage" | "coverage.availableFrom" | "coverage.availableThrough" | "coverage.generation" | "coverage.retainedBefore" | "coverage.state" | "dimensionsSince" | "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.topChannels" | "metadata.breakdowns.topCountries" | "metadata.breakdowns.topDevices" | "metadata.breakdowns.topEvents" | "metadata.breakdowns.topEvidence" | "metadata.breakdowns.topGoals" | "metadata.breakdowns.topMediums" | "metadata.breakdowns.topOutbound" | "metadata.breakdowns.topPages" | "metadata.breakdowns.topPlatforms" | "metadata.breakdowns.topSources" | "metadata.coverage" | "metadata.coverage.availableFrom" | "metadata.coverage.availableThrough" | "metadata.coverage.generation" | "metadata.coverage.retainedBefore" | "metadata.coverage.state" | "metadata.dimensionsSince" | "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" | "topChannels" | "topCountries" | "topDevices" | "topEvents" | "topEvidence" | "topGoals" | "topMediums" | "topOutbound" | "topPages" | "topPlatforms" | "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;
@@ -2186,6 +2301,7 @@ export declare function exposeAnalyticsApi(component: ComponentApi, options: {
             city?: string | undefined;
             country?: string | undefined;
             device?: string | undefined;
+            inApp?: string | undefined;
             latitude?: number | undefined;
             longitude?: number | undefined;
             os?: string | undefined;
@@ -2193,6 +2309,7 @@ export declare function exposeAnalyticsApi(component: ComponentApi, options: {
         } | undefined;
         events: {
             affiliateSlug?: string | undefined;
+            clid?: string[] | undefined;
             currency?: string | undefined;
             eventId: string;
             href?: string | undefined;
@@ -2253,13 +2370,16 @@ export declare function exposeAnalyticsApi(component: ComponentApi, options: {
             breakdowns: {
                 topBrowsers: "pageviews" | "sessions" | "eventVolume";
                 topCampaigns: "pageviews" | "sessions" | "eventVolume";
+                topChannels: "pageviews" | "sessions" | "eventVolume";
                 topCountries: "pageviews" | "sessions" | "eventVolume";
                 topDevices: "pageviews" | "sessions" | "eventVolume";
                 topEvents: "eventVolume";
+                topEvidence: "pageviews" | "sessions" | "eventVolume";
                 topGoals: "goalCompletionVolume";
                 topMediums: "pageviews" | "sessions" | "eventVolume";
                 topOutbound: "eventVolume";
                 topPages: "pageviews" | "sessions" | "eventVolume";
+                topPlatforms: "pageviews" | "sessions" | "eventVolume";
                 topSources: "pageviews" | "sessions" | "eventVolume";
             };
             coverage: {
@@ -2317,6 +2437,11 @@ export declare function exposeAnalyticsApi(component: ComponentApi, options: {
             revenueCents: number;
             value: string;
         }>;
+        topChannels: Array<{
+            count: number;
+            revenueCents: number;
+            value: string;
+        }>;
         topCountries: Array<{
             count: number;
             revenueCents: number;
@@ -2332,6 +2457,11 @@ export declare function exposeAnalyticsApi(component: ComponentApi, options: {
             revenueCents: number;
             value: string;
         }>;
+        topEvidence: Array<{
+            count: number;
+            revenueCents: number;
+            value: string;
+        }>;
         topGoals: Array<{
             count: number;
             revenueCents: number;
@@ -2352,6 +2482,11 @@ export declare function exposeAnalyticsApi(component: ComponentApi, options: {
             revenueCents: number;
             value: string;
         }>;
+        topPlatforms: Array<{
+            count: number;
+            revenueCents: number;
+            value: string;
+        }>;
         topSources: Array<{
             count: number;
             revenueCents: number;
@@ -2420,6 +2555,7 @@ export declare function exposeAnalyticsApi(component: ComponentApi, options: {
         affiliateId?: string;
         affiliateSlug?: string;
         browser: string;
+        channel?: "direct" | "organic_search" | "paid_search" | "organic_social" | "paid_social" | "messaging" | "email" | "affiliate" | "ai" | "display" | "referral" | "offline";
         city?: string;
         conversionCount: number;
         country?: string;
@@ -2428,6 +2564,7 @@ export declare function exposeAnalyticsApi(component: ComponentApi, options: {
         durationMs: number;
         entryPath: string;
         eventCount: number;
+        evidence?: "utm" | "clickId" | "referrer" | "inApp" | "affiliate" | "none" | "legacy";
         exitPath: string;
         lastSeenAt: number;
         latitude?: number;
@@ -2435,6 +2572,7 @@ export declare function exposeAnalyticsApi(component: ComponentApi, options: {
         newVisitor?: boolean;
         os: string;
         pageviewCount: number;
+        platform?: string;
         referrer?: string;
         revenueCents: number;
         sessionId: string;
@@ -2477,6 +2615,7 @@ export declare function exposeAnalyticsApi(component: ComponentApi, options: {
             affiliateId?: string;
             affiliateSlug?: string;
             browser: string;
+            channel?: "direct" | "organic_search" | "paid_search" | "organic_social" | "paid_social" | "messaging" | "email" | "affiliate" | "ai" | "display" | "referral" | "offline";
             city?: string;
             conversionCount: number;
             country?: string;
@@ -2485,6 +2624,7 @@ export declare function exposeAnalyticsApi(component: ComponentApi, options: {
             durationMs: number;
             entryPath: string;
             eventCount: number;
+            evidence?: "utm" | "clickId" | "referrer" | "inApp" | "affiliate" | "none" | "legacy";
             exitPath: string;
             lastSeenAt: number;
             latitude?: number;
@@ -2492,6 +2632,7 @@ export declare function exposeAnalyticsApi(component: ComponentApi, options: {
             newVisitor?: boolean;
             os: string;
             pageviewCount: number;
+            platform?: string;
             referrer?: string;
             revenueCents: number;
             sessionId: string;
@@ -2877,7 +3018,7 @@ export declare function exposeAnalyticsApi(component: ComponentApi, options: {
                 retainedBefore: number | null;
                 state: "complete" | "partial" | "retained" | "unavailable";
             };
-            dataset: "overviewHour" | "overviewDay" | "overviewLocalDay" | "events" | "sessions" | "conversions" | "goals" | "funnels" | "affiliates" | "vitals" | "siteMap";
+            dataset: "overviewHour" | "overviewDay" | "overviewLocalDay" | "events" | "sessions" | "conversions" | "goals" | "funnels" | "affiliates" | "vitals" | "siteMap" | "origin";
         }>;
         from: number;
         siteId: string;
@@ -3015,6 +3156,48 @@ export declare function exposeAnalyticsApi(component: ComponentApi, options: {
         affiliateId: string;
         siteId: string;
     }, Promise<null>>;
+    createTrackedLink: import("convex/server").RegisteredMutation<"public", {
+        campaign?: string | undefined;
+        channel: "affiliate" | "display" | "email" | "messaging" | "offline" | "organic_social" | "paid_social" | "referral";
+        createdBy: string;
+        destination: string;
+        platform: string;
+        siteId: string;
+        slug: string;
+    }, Promise<string>>;
+    updateTrackedLink: import("convex/server").RegisteredMutation<"public", {
+        campaign?: string | null | undefined;
+        channel?: "affiliate" | "display" | "email" | "messaging" | "offline" | "organic_social" | "paid_social" | "referral" | undefined;
+        destination?: string | undefined;
+        disabled?: boolean | undefined;
+        linkId: string;
+        platform?: string | undefined;
+        siteId: string;
+    }, Promise<null>>;
+    deleteTrackedLink: import("convex/server").RegisteredMutation<"public", {
+        linkId: string;
+        siteId: string;
+    }, Promise<null>>;
+    listTrackedLinks: import("convex/server").RegisteredQuery<"public", {
+        now: number;
+        siteId: string;
+    }, Promise<{
+        _creationTime: number;
+        _id: string;
+        bots: number;
+        botsLast30Days: number;
+        campaign?: string;
+        channel: "organic_social" | "paid_social" | "messaging" | "email" | "affiliate" | "display" | "referral" | "offline";
+        clicks: number;
+        clicksLast30Days: number;
+        createdAt: number;
+        createdBy: string;
+        destination: string;
+        disabledAt?: number;
+        platform: string;
+        siteId: string;
+        slug: string;
+    }[]>>;
     cleanupAnalytics: import("convex/server").RegisteredMutation<"public", {
         batchSize?: number | undefined;
         before: number;
@@ -3082,9 +3265,13 @@ export declare function exposeFederatedAnalyticsApi(component: ComponentApi, opt
             revenueSummary: "revenueSummary";
             vitalsReport: "vitalsReport";
             siteMap: "siteMap";
+            listTrackedLinks: "listTrackedLinks";
+            createTrackedLink: "createTrackedLink";
+            updateTrackedLink: "updateTrackedLink";
+            deleteTrackedLink: "deleteTrackedLink";
             transferConnection?: "transferConnection" | undefined;
         };
-        capabilities: ("affiliates" | "configure" | "conversions" | "dataCoverage" | "funnels" | "goals" | "liveVisitors" | "localDays" | "overview" | "revenueSummary" | "sessionDetails" | "sessionJourney" | "sessions" | "siteMap" | "siteSummaries" | "transfer" | "visitorJourney" | "vitals")[];
+        capabilities: ("affiliates" | "configure" | "conversions" | "dataCoverage" | "funnels" | "goals" | "liveVisitors" | "localDays" | "overview" | "revenueSummary" | "sessionDetails" | "sessionJourney" | "sessions" | "siteMap" | "siteSummaries" | "trackedLinks" | "transfer" | "visitorJourney" | "vitals")[];
         limits: {
             maxSitesPerRequest: 10;
             maxSitesPerConnection: 10;
@@ -3109,13 +3296,16 @@ export declare function exposeFederatedAnalyticsApi(component: ComponentApi, opt
             breakdowns: {
                 topBrowsers: "pageviews" | "sessions" | "eventVolume";
                 topCampaigns: "pageviews" | "sessions" | "eventVolume";
+                topChannels: "pageviews" | "sessions" | "eventVolume";
                 topCountries: "pageviews" | "sessions" | "eventVolume";
                 topDevices: "pageviews" | "sessions" | "eventVolume";
                 topEvents: "eventVolume";
+                topEvidence: "pageviews" | "sessions" | "eventVolume";
                 topGoals: "goalCompletionVolume";
                 topMediums: "pageviews" | "sessions" | "eventVolume";
                 topOutbound: "eventVolume";
                 topPages: "pageviews" | "sessions" | "eventVolume";
+                topPlatforms: "pageviews" | "sessions" | "eventVolume";
                 topSources: "pageviews" | "sessions" | "eventVolume";
             };
             coverage: {
@@ -3173,6 +3363,11 @@ export declare function exposeFederatedAnalyticsApi(component: ComponentApi, opt
             revenueCents: number;
             value: string;
         }>;
+        topChannels: Array<{
+            count: number;
+            revenueCents: number;
+            value: string;
+        }>;
         topCountries: Array<{
             count: number;
             revenueCents: number;
@@ -3188,6 +3383,11 @@ export declare function exposeFederatedAnalyticsApi(component: ComponentApi, opt
             revenueCents: number;
             value: string;
         }>;
+        topEvidence: Array<{
+            count: number;
+            revenueCents: number;
+            value: string;
+        }>;
         topGoals: Array<{
             count: number;
             revenueCents: number;
@@ -3208,6 +3408,11 @@ export declare function exposeFederatedAnalyticsApi(component: ComponentApi, opt
             revenueCents: number;
             value: string;
         }>;
+        topPlatforms: Array<{
+            count: number;
+            revenueCents: number;
+            value: string;
+        }>;
         topSources: Array<{
             count: number;
             revenueCents: number;
@@ -3276,6 +3481,7 @@ export declare function exposeFederatedAnalyticsApi(component: ComponentApi, opt
         affiliateId?: string;
         affiliateSlug?: string;
         browser: string;
+        channel?: "direct" | "organic_search" | "paid_search" | "organic_social" | "paid_social" | "messaging" | "email" | "affiliate" | "ai" | "display" | "referral" | "offline";
         city?: string;
         conversionCount: number;
         country?: string;
@@ -3284,6 +3490,7 @@ export declare function exposeFederatedAnalyticsApi(component: ComponentApi, opt
         durationMs: number;
         entryPath: string;
         eventCount: number;
+        evidence?: "utm" | "clickId" | "referrer" | "inApp" | "affiliate" | "none" | "legacy";
         exitPath: string;
         lastSeenAt: number;
         latitude?: number;
@@ -3291,6 +3498,7 @@ export declare function exposeFederatedAnalyticsApi(component: ComponentApi, opt
         newVisitor?: boolean;
         os: string;
         pageviewCount: number;
+        platform?: string;
         referrer?: string;
         revenueCents: number;
         sessionId: string;
@@ -3333,6 +3541,7 @@ export declare function exposeFederatedAnalyticsApi(component: ComponentApi, opt
             affiliateId?: string;
             affiliateSlug?: string;
             browser: string;
+            channel?: "direct" | "organic_search" | "paid_search" | "organic_social" | "paid_social" | "messaging" | "email" | "affiliate" | "ai" | "display" | "referral" | "offline";
             city?: string;
             conversionCount: number;
             country?: string;
@@ -3341,6 +3550,7 @@ export declare function exposeFederatedAnalyticsApi(component: ComponentApi, opt
             durationMs: number;
             entryPath: string;
             eventCount: number;
+            evidence?: "utm" | "clickId" | "referrer" | "inApp" | "affiliate" | "none" | "legacy";
             exitPath: string;
             lastSeenAt: number;
             latitude?: number;
@@ -3348,6 +3558,7 @@ export declare function exposeFederatedAnalyticsApi(component: ComponentApi, opt
             newVisitor?: boolean;
             os: string;
             pageviewCount: number;
+            platform?: string;
             referrer?: string;
             revenueCents: number;
             sessionId: string;
@@ -3733,7 +3944,7 @@ export declare function exposeFederatedAnalyticsApi(component: ComponentApi, opt
                 retainedBefore: number | null;
                 state: "complete" | "partial" | "retained" | "unavailable";
             };
-            dataset: "overviewHour" | "overviewDay" | "overviewLocalDay" | "events" | "sessions" | "conversions" | "goals" | "funnels" | "affiliates" | "vitals" | "siteMap";
+            dataset: "overviewHour" | "overviewDay" | "overviewLocalDay" | "events" | "sessions" | "conversions" | "goals" | "funnels" | "affiliates" | "vitals" | "siteMap" | "origin";
         }>;
         from: number;
         siteId: string;
@@ -3846,6 +4057,48 @@ export declare function exposeFederatedAnalyticsApi(component: ComponentApi, opt
         affiliateId: string;
         siteId: string;
     }, Promise<null>>;
+    listTrackedLinks: import("convex/server").RegisteredQuery<"public", {
+        now: number;
+        siteId: string;
+    }, Promise<{
+        _creationTime: number;
+        _id: string;
+        bots: number;
+        botsLast30Days: number;
+        campaign?: string;
+        channel: "organic_social" | "paid_social" | "messaging" | "email" | "affiliate" | "display" | "referral" | "offline";
+        clicks: number;
+        clicksLast30Days: number;
+        createdAt: number;
+        createdBy: string;
+        destination: string;
+        disabledAt?: number;
+        platform: string;
+        siteId: string;
+        slug: string;
+    }[]>>;
+    createTrackedLink: import("convex/server").RegisteredMutation<"public", {
+        campaign?: string | undefined;
+        channel: "affiliate" | "display" | "email" | "messaging" | "offline" | "organic_social" | "paid_social" | "referral";
+        createdBy: string;
+        destination: string;
+        platform: string;
+        siteId: string;
+        slug: string;
+    }, Promise<string>>;
+    updateTrackedLink: import("convex/server").RegisteredMutation<"public", {
+        campaign?: string | null | undefined;
+        channel?: "affiliate" | "display" | "email" | "messaging" | "offline" | "organic_social" | "paid_social" | "referral" | undefined;
+        destination?: string | undefined;
+        disabled?: boolean | undefined;
+        linkId: string;
+        platform?: string | undefined;
+        siteId: string;
+    }, Promise<null>>;
+    deleteTrackedLink: import("convex/server").RegisteredMutation<"public", {
+        linkId: string;
+        siteId: string;
+    }, Promise<null>>;
     retentionStatus: import("convex/server").RegisteredQuery<"public", {
         siteId: string;
     }, Promise<{