@iann29/rastro 0.4.0 → 0.6.0

package/dist/client/index.d.ts

@@ -1,10 +1,14 @@
 import type { FunctionArgs, FunctionReturnType, GenericActionCtx, GenericDataModel, GenericMutationCtx, GenericQueryCtx } from "convex/server";
 import { type Infer } from "convex/values";
+import { type IdentityHttpAuthorizer } from "./identity.js";
+export { visitorIdForUser } from "./identity.js";
+export type { IdentityHttpAuthorizer } from "./identity.js";
 import type { ComponentApi } from "../component/_generated/component.js";
-import { eventPropertiesValidator, eventTypeValidator, funnelStepValidator, goalMatchTypeValidator, ingestContextValidator, ingestResultValidator, trackerEventValidator, vitalMetricValidator } from "../component/validators.js";
+import { eventPropertiesValidator, eventTypeValidator, funnelStepValidator, goalMatchTypeValidator, ingestContextValidator, ingestResultValidator, trackerEventValidator, vitalMetricValidator, visitorProfileValidator } 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 { eventPropertiesValidator, eventTypeValidator, funnelStepValidator, goalMatchTypeValidator, ingestContextValidator, ingestResultValidator, trackerEventValidator, vitalMetricValidator, visitorProfileValidator, };
+export type { Channel, EventProperties, EventType, Evidence, FunnelStep, IngestContext, TrackerEvent, VisitorProfile, PersonAttributes, PersonFilter, } 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";
@@ -14,6 +18,8 @@ export type { VitalMetric } from "../component/vitals.js";
 export { effectiveFederatedPermissions, federatedPermissionSatisfies, isPublicFederatedAccess, FEDERATED_ANALYTICS_CLAIMS, FEDERATED_ANALYTICS_CONFIGURE_FUNCTIONS, FEDERATED_ANALYTICS_CONFIGURE_PERMISSION, FEDERATED_ANALYTICS_CONNECTOR_MANIFEST, FEDERATED_ANALYTICS_ERROR_CODES, FEDERATED_ANALYTICS_PERMISSIONS, FEDERATED_ANALYTICS_PUBLIC_FUNCTIONS, FEDERATED_ANALYTICS_PUBLIC_PERMISSION, 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 ListPeopleInput = FunctionArgs<ComponentApi["people"]["list"]>;
+export type Person = FunctionReturnType<ComponentApi["people"]["list"]>["page"][number];
 export type CreateSiteOutput = FunctionReturnType<ComponentApi["sites"]["create"]>;
 export type UpdateSiteInput = FunctionArgs<ComponentApi["sites"]["update"]>;
 export type UpdateSiteOutput = FunctionReturnType<ComponentApi["sites"]["update"]>;
@@ -26,6 +32,8 @@ export type TrackConversionInput = Omit<FunctionArgs<ComponentApi["ingest"]["tra
 export type TrackConversionOutput = FunctionReturnType<ComponentApi["ingest"]["trackConversion"]>;
 export type LinkVisitorInput = FunctionArgs<ComponentApi["visitors"]["link"]>;
 export type LinkVisitorOutput = FunctionReturnType<ComponentApi["visitors"]["link"]>;
+export type IdentifyVisitorInput = FunctionArgs<ComponentApi["visitors"]["identify"]>;
+export type GetVisitorProfileInput = FunctionArgs<ComponentApi["visitors"]["getProfile"]>;
 export type OverviewInput = FunctionArgs<ComponentApi["reports"]["overview"]>;
 export type Overview = Infer<typeof hostOverviewValidator>;
 export type LiveVisitorsInput = FunctionArgs<ComponentApi["reports"]["liveVisitors"]>;
@@ -57,6 +65,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;
@@ -167,6 +179,61 @@ export declare class Rastro {
         aliasCount: number;
         linked: boolean;
     }>;
+    /** The caller resolves the user with its own auth; no provider is required. */
+    identifyVisitor(ctx: MutationCtx | ActionCtx, args: IdentifyVisitorInput): Promise<{
+        attributes?: Record<string, string | number | boolean>;
+        email?: string;
+        identifiedAt: number;
+        name?: string;
+        updatedAt: number;
+        visitorId: string;
+    }>;
+    /** End-user entrypoint: the browser supplies only its pre-login visitor ID. */
+    identifyVisitorMutation<DataModel extends GenericDataModel>(options: {
+        resolveUser: (ctx: GenericMutationCtx<DataModel>) => Promise<Omit<IdentifyVisitorInput, "previousVisitorId"> | null>;
+    }): import("convex/server").RegisteredMutation<"public", {
+        previousVisitorId?: string | undefined;
+    }, Promise<{
+        attributes?: Record<string, string | number | boolean>;
+        email?: string;
+        identifiedAt: number;
+        name?: string;
+        updatedAt: number;
+        visitorId: string;
+    }>>;
+    /** Mount on the host's router with its own server credential/site authorization. */
+    identifyVisitorHttpAction(options: {
+        authorize: IdentityHttpAuthorizer;
+    }): import("convex/server").PublicHttpAction;
+    getVisitorProfile(ctx: QueryCtx | MutationCtx | ActionCtx, args: GetVisitorProfileInput): Promise<{
+        attributes?: Record<string, string | number | boolean>;
+        email?: string;
+        identifiedAt: number;
+        name?: string;
+        updatedAt: number;
+        visitorId: string;
+    } | null>;
+    listPeople(ctx: QueryCtx | MutationCtx | ActionCtx, args: ListPeopleInput): Promise<{
+        continueCursor: string;
+        isDone: boolean;
+        page: Array<{
+            _creationTime: number;
+            _id: string;
+            attributes?: Record<string, string | number | boolean>;
+            email?: string;
+            identifiedAt: number;
+            name?: string;
+            siteId: string;
+            updatedAt: number;
+            visitorId: string;
+        }>;
+    }>;
+    backfillVisitorProfiles(ctx: MutationCtx | ActionCtx, args: {
+        siteId: string;
+    }): Promise<{
+        isDone: boolean;
+        updated: number;
+    }>;
     overview(ctx: QueryCtx | MutationCtx | ActionCtx, args: OverviewInput): Promise<{
         currency: string;
         from: number;
@@ -175,13 +242,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 +309,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 +329,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 +354,11 @@ export declare class Rastro {
             revenueCents: number;
             value: string;
         }>;
+        topPlatforms: Array<{
+            count: number;
+            revenueCents: number;
+            value: string;
+        }>;
         topSources: Array<{
             count: number;
             revenueCents: number;
@@ -319,6 +404,14 @@ export declare class Rastro {
         pageviewCount: number;
         path: string;
         previousPath?: string;
+        profile?: {
+            attributes?: Record<string, string | number | boolean>;
+            email?: string;
+            identifiedAt: number;
+            name?: string;
+            updatedAt: number;
+            visitorId: string;
+        };
         returning?: boolean;
         sessionId: string;
         siteId: string;
@@ -338,6 +431,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 +440,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 +448,15 @@ export declare class Rastro {
         newVisitor?: boolean;
         os: string;
         pageviewCount: number;
+        platform?: string;
+        profile?: {
+            attributes?: Record<string, string | number | boolean>;
+            email?: string;
+            identifiedAt: number;
+            name?: string;
+            updatedAt: number;
+            visitorId: string;
+        };
         referrer?: string;
         revenueCents: number;
         sessionId: string;
@@ -383,6 +487,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 +496,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 +504,15 @@ export declare class Rastro {
             newVisitor?: boolean;
             os: string;
             pageviewCount: number;
+            platform?: string;
+            profile?: {
+                attributes?: Record<string, string | number | boolean>;
+                email?: string;
+                identifiedAt: number;
+                name?: string;
+                updatedAt: number;
+                visitorId: string;
+            };
             referrer?: string;
             revenueCents: number;
             sessionId: string;
@@ -766,6 +881,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 +915,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 +948,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" | "visitor.identify" | "visitor.profile" | "visitor.list" | "visitor.index" | "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 +964,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 +1031,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 +1051,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 +1076,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 +1305,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 +1405,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 +1427,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 +1468,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 +2387,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 +2395,7 @@ export declare function exposeAnalyticsApi(component: ComponentApi, options: {
         } | undefined;
         events: {
             affiliateSlug?: string | undefined;
+            clid?: string[] | undefined;
             currency?: string | undefined;
             eventId: string;
             href?: string | undefined;
@@ -2240,6 +2443,67 @@ export declare function exposeAnalyticsApi(component: ComponentApi, options: {
         aliasCount: number;
         linked: boolean;
     }>>;
+    identifyVisitor: import("convex/server").RegisteredMutation<"public", {
+        attributes?: Record<string, string | number | boolean | null> | undefined;
+        email?: string | null | undefined;
+        name?: string | null | undefined;
+        previousVisitorId?: string | undefined;
+        siteId: string;
+        visitorId: string;
+    }, Promise<{
+        attributes?: Record<string, string | number | boolean>;
+        email?: string;
+        identifiedAt: number;
+        name?: string;
+        updatedAt: number;
+        visitorId: string;
+    }>>;
+    getVisitorProfile: import("convex/server").RegisteredQuery<"public", {
+        siteId: string;
+        visitorId: string;
+    }, Promise<{
+        attributes?: Record<string, string | number | boolean>;
+        email?: string;
+        identifiedAt: number;
+        name?: string;
+        updatedAt: number;
+        visitorId: string;
+    } | null>>;
+    listPeople: import("convex/server").RegisteredQuery<"public", {
+        filter?: {
+            field: "email" | "name" | "visitorId";
+            prefix: string;
+        } | {
+            field: "attribute";
+            key: string;
+            value: string | number | boolean;
+        } | undefined;
+        paginationOpts: {
+            cursor: string | null;
+            numItems: number;
+        };
+        siteId: string;
+    }, Promise<{
+        continueCursor: string;
+        isDone: boolean;
+        page: Array<{
+            _creationTime: number;
+            _id: string;
+            attributes?: Record<string, string | number | boolean>;
+            email?: string;
+            identifiedAt: number;
+            name?: string;
+            siteId: string;
+            updatedAt: number;
+            visitorId: string;
+        }>;
+    }>>;
+    backfillVisitorProfiles: import("convex/server").RegisteredMutation<"public", {
+        siteId: string;
+    }, Promise<{
+        isDone: boolean;
+        updated: number;
+    }>>;
     overview: import("convex/server").RegisteredQuery<"public", {
         from: number;
         interval?: "day" | "hour" | undefined;
@@ -2253,13 +2517,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 +2584,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 +2604,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 +2629,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;
@@ -2401,6 +2683,14 @@ export declare function exposeAnalyticsApi(component: ComponentApi, options: {
         pageviewCount: number;
         path: string;
         previousPath?: string;
+        profile?: {
+            attributes?: Record<string, string | number | boolean>;
+            email?: string;
+            identifiedAt: number;
+            name?: string;
+            updatedAt: number;
+            visitorId: string;
+        };
         returning?: boolean;
         sessionId: string;
         siteId: string;
@@ -2420,6 +2710,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 +2719,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 +2727,15 @@ export declare function exposeAnalyticsApi(component: ComponentApi, options: {
         newVisitor?: boolean;
         os: string;
         pageviewCount: number;
+        platform?: string;
+        profile?: {
+            attributes?: Record<string, string | number | boolean>;
+            email?: string;
+            identifiedAt: number;
+            name?: string;
+            updatedAt: number;
+            visitorId: string;
+        };
         referrer?: string;
         revenueCents: number;
         sessionId: string;
@@ -2477,6 +2778,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 +2787,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 +2795,15 @@ export declare function exposeAnalyticsApi(component: ComponentApi, options: {
             newVisitor?: boolean;
             os: string;
             pageviewCount: number;
+            platform?: string;
+            profile?: {
+                attributes?: Record<string, string | number | boolean>;
+                email?: string;
+                identifiedAt: number;
+                name?: string;
+                updatedAt: number;
+                visitorId: string;
+            };
             referrer?: string;
             revenueCents: number;
             sessionId: string;
@@ -2877,7 +3189,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 +3327,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;
@@ -3079,12 +3433,18 @@ export declare function exposeFederatedAnalyticsApi(component: ComponentApi, opt
             setRetentionPolicy: "setRetentionPolicy";
             disableRetentionPolicy: "disableRetentionPolicy";
             getSession: "getSession";
+            getVisitorProfile: "getVisitorProfile";
+            listPeople: "listPeople";
             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" | "people" | "revenueSummary" | "sessionDetails" | "sessionJourney" | "sessions" | "siteMap" | "siteSummaries" | "trackedLinks" | "transfer" | "visitorJourney" | "visitorProfiles" | "vitals")[];
         limits: {
             maxSitesPerRequest: 10;
             maxSitesPerConnection: 10;
@@ -3109,13 +3469,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 +3536,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 +3556,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 +3581,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;
@@ -3257,6 +3635,14 @@ export declare function exposeFederatedAnalyticsApi(component: ComponentApi, opt
         pageviewCount: number;
         path: string;
         previousPath?: string;
+        profile?: {
+            attributes?: Record<string, string | number | boolean>;
+            email?: string;
+            identifiedAt: number;
+            name?: string;
+            updatedAt: number;
+            visitorId: string;
+        };
         returning?: boolean;
         sessionId: string;
         siteId: string;
@@ -3276,6 +3662,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 +3671,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 +3679,15 @@ export declare function exposeFederatedAnalyticsApi(component: ComponentApi, opt
         newVisitor?: boolean;
         os: string;
         pageviewCount: number;
+        platform?: string;
+        profile?: {
+            attributes?: Record<string, string | number | boolean>;
+            email?: string;
+            identifiedAt: number;
+            name?: string;
+            updatedAt: number;
+            visitorId: string;
+        };
         referrer?: string;
         revenueCents: number;
         sessionId: string;
@@ -3333,6 +3730,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 +3739,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 +3747,15 @@ export declare function exposeFederatedAnalyticsApi(component: ComponentApi, opt
             newVisitor?: boolean;
             os: string;
             pageviewCount: number;
+            platform?: string;
+            profile?: {
+                attributes?: Record<string, string | number | boolean>;
+                email?: string;
+                identifiedAt: number;
+                name?: string;
+                updatedAt: number;
+                visitorId: string;
+            };
             referrer?: string;
             revenueCents: number;
             sessionId: string;
@@ -3479,6 +3887,46 @@ export declare function exposeFederatedAnalyticsApi(component: ComponentApi, opt
         type: "pageview" | "click" | "custom" | "conversion" | "heartbeat" | "leave" | "outbound" | "vital";
         visitorId: string;
     }[]>>;
+    getVisitorProfile: import("convex/server").RegisteredQuery<"public", {
+        siteId: string;
+        visitorId: string;
+    }, Promise<{
+        attributes?: Record<string, string | number | boolean>;
+        email?: string;
+        identifiedAt: number;
+        name?: string;
+        updatedAt: number;
+        visitorId: string;
+    } | null>>;
+    listPeople: import("convex/server").RegisteredQuery<"public", {
+        filter?: {
+            field: "email" | "name" | "visitorId";
+            prefix: string;
+        } | {
+            field: "attribute";
+            key: string;
+            value: string | number | boolean;
+        } | undefined;
+        paginationOpts: {
+            cursor: string | null;
+            numItems: number;
+        };
+        siteId: string;
+    }, Promise<{
+        continueCursor: string;
+        isDone: boolean;
+        page: Array<{
+            _creationTime: number;
+            _id: string;
+            attributes?: Record<string, string | number | boolean>;
+            email?: string;
+            identifiedAt: number;
+            name?: string;
+            siteId: string;
+            updatedAt: number;
+            visitorId: string;
+        }>;
+    }>>;
     goalsReport: import("convex/server").RegisteredQuery<"public", {
         from: number;
         siteId: string;
@@ -3733,7 +4181,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 +4294,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<{