@iann29/rastro 0.1.0-alpha.0

package/dist/client/index.d.ts

@@ -0,0 +1,960 @@
+import type { FunctionArgs, FunctionReturnType, GenericActionCtx, GenericDataModel, GenericMutationCtx, GenericQueryCtx } from "convex/server";
+import type { ComponentApi } from "../component/_generated/component.js";
+import { eventPropertiesValidator, eventTypeValidator, funnelStepValidator, goalMatchTypeValidator, ingestContextValidator, ingestResultValidator, trackerEventValidator } from "../component/validators.js";
+export { eventPropertiesValidator, eventTypeValidator, funnelStepValidator, goalMatchTypeValidator, ingestContextValidator, ingestResultValidator, trackerEventValidator, };
+export type { EventProperties, EventType, FunnelStep, IngestContext, TrackerEvent, } from "../component/validators.js";
+export type CreateSiteInput = FunctionArgs<ComponentApi["sites"]["create"]>;
+export type CreateSiteOutput = FunctionReturnType<ComponentApi["sites"]["create"]>;
+export type UpdateSiteInput = FunctionArgs<ComponentApi["sites"]["update"]>;
+export type UpdateSiteOutput = FunctionReturnType<ComponentApi["sites"]["update"]>;
+export type Site = NonNullable<FunctionReturnType<ComponentApi["sites"]["get"]>>;
+export type ListSitesInput = FunctionArgs<ComponentApi["sites"]["listByOwner"]>;
+export type ListSitesOutput = FunctionReturnType<ComponentApi["sites"]["listByOwner"]>;
+export type IngestInput = FunctionArgs<ComponentApi["ingest"]["ingestBatch"]>;
+export type IngestResult = FunctionReturnType<ComponentApi["ingest"]["ingestBatch"]>;
+export type TrackConversionInput = Omit<FunctionArgs<ComponentApi["ingest"]["trackConversion"]>, "affiliateSlug">;
+export type TrackConversionOutput = FunctionReturnType<ComponentApi["ingest"]["trackConversion"]>;
+export type OverviewInput = FunctionArgs<ComponentApi["reports"]["overview"]>;
+export type Overview = FunctionReturnType<ComponentApi["reports"]["overview"]>;
+export type LiveVisitorsInput = FunctionArgs<ComponentApi["reports"]["liveVisitors"]>;
+export type LiveVisitor = FunctionReturnType<ComponentApi["reports"]["liveVisitors"]>[number];
+export type ListSessionsInput = FunctionArgs<ComponentApi["reports"]["listSessions"]>;
+export type SessionsPage = FunctionReturnType<ComponentApi["reports"]["listSessions"]>;
+export type SessionJourneyInput = FunctionArgs<ComponentApi["reports"]["sessionJourney"]>;
+export type EventsPage = FunctionReturnType<ComponentApi["reports"]["sessionJourney"]>;
+export type ListConversionsInput = FunctionArgs<ComponentApi["reports"]["listConversions"]>;
+export type ConversionsPage = FunctionReturnType<ComponentApi["reports"]["listConversions"]>;
+export type VisitorJourneyInput = FunctionArgs<ComponentApi["reports"]["visitorJourney"]>;
+export type VisitorJourney = FunctionReturnType<ComponentApi["reports"]["visitorJourney"]>;
+export type GoalsReportInput = FunctionArgs<ComponentApi["reports"]["goalsReport"]>;
+export type GoalsReport = FunctionReturnType<ComponentApi["reports"]["goalsReport"]>;
+export type FunnelsReportInput = FunctionArgs<ComponentApi["reports"]["funnelsReport"]>;
+export type FunnelsReport = FunctionReturnType<ComponentApi["reports"]["funnelsReport"]>;
+export type AffiliatesReportInput = FunctionArgs<ComponentApi["reports"]["affiliatesReport"]>;
+export type AffiliatesReport = FunctionReturnType<ComponentApi["reports"]["affiliatesReport"]>;
+export type UpsertGoalInput = FunctionArgs<ComponentApi["goals"]["upsert"]>;
+export type UpsertGoalOutput = FunctionReturnType<ComponentApi["goals"]["upsert"]>;
+export type Goal = FunctionReturnType<ComponentApi["goals"]["list"]>[number];
+export type UpsertFunnelInput = FunctionArgs<ComponentApi["funnels"]["upsert"]>;
+export type UpsertFunnelOutput = FunctionReturnType<ComponentApi["funnels"]["upsert"]>;
+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 CleanupInput = FunctionArgs<ComponentApi["retention"]["cleanup"]>;
+export type CleanupOutput = FunctionReturnType<ComponentApi["retention"]["cleanup"]>;
+export declare class Rastro {
+    private readonly component;
+    constructor(component: ComponentApi);
+    createSite(ctx: MutationCtx, args: CreateSiteInput): Promise<string>;
+    updateSite(ctx: MutationCtx, args: UpdateSiteInput): Promise<null>;
+    getSite(ctx: QueryCtx | MutationCtx | ActionCtx, siteId: string): Promise<{
+        _creationTime: number;
+        _id: string;
+        cookieless: boolean;
+        createdAt: number;
+        currency?: string;
+        domains: Array<string>;
+        name: string;
+        networkId?: string;
+        ownerId: string;
+        timezone?: string;
+        updatedAt: number;
+    } | null>;
+    listSites(ctx: QueryCtx | MutationCtx | ActionCtx, args: ListSitesInput): Promise<{
+        _creationTime: number;
+        _id: string;
+        cookieless: boolean;
+        createdAt: number;
+        currency?: string;
+        domains: Array<string>;
+        name: string;
+        networkId?: string;
+        ownerId: string;
+        timezone?: string;
+        updatedAt: number;
+    }[]>;
+    ingest(ctx: MutationCtx, args: IngestInput): Promise<{
+        accepted: number;
+        duplicates: number;
+        rejected: number;
+    }>;
+    trackConversion(ctx: MutationCtx, args: TrackConversionInput): Promise<{
+        accepted: number;
+        duplicates: number;
+        rejected: number;
+    }>;
+    overview(ctx: QueryCtx | MutationCtx | ActionCtx, args: OverviewInput): Promise<{
+        currency: string;
+        from: number;
+        interval: "hour" | "day";
+        timeSeries: Array<{
+            clicks: number;
+            conversions: number;
+            customEvents: number;
+            events: number;
+            outboundClicks: number;
+            pageviews: number;
+            revenueCents: number;
+            sessions: number;
+            timestamp: number;
+            visitors: number;
+        }>;
+        to: number;
+        topBrowsers: Array<{
+            count: number;
+            revenueCents: number;
+            value: string;
+        }>;
+        topCountries: Array<{
+            count: number;
+            revenueCents: number;
+            value: string;
+        }>;
+        topDevices: Array<{
+            count: number;
+            revenueCents: number;
+            value: string;
+        }>;
+        topEvents: Array<{
+            count: number;
+            revenueCents: number;
+            value: string;
+        }>;
+        topGoals: Array<{
+            count: number;
+            revenueCents: number;
+            value: string;
+        }>;
+        topPages: Array<{
+            count: number;
+            revenueCents: number;
+            value: string;
+        }>;
+        topSources: Array<{
+            count: number;
+            revenueCents: number;
+            value: string;
+        }>;
+        totals: {
+            clicks: number;
+            conversions: number;
+            customEvents: number;
+            events: number;
+            outboundClicks: number;
+            pageviews: number;
+            revenueCents: number;
+            sessions: number;
+            visitors: number;
+        };
+    }>;
+    liveVisitors(ctx: QueryCtx | MutationCtx | ActionCtx, args: LiveVisitorsInput): Promise<{
+        _creationTime: number;
+        _id: string;
+        browser: string;
+        city?: string;
+        country?: string;
+        device: string;
+        eventCount: number;
+        expiresAt: number;
+        lastSeenAt: number;
+        latitude?: number;
+        longitude?: number;
+        os: string;
+        pageviewCount: number;
+        path: string;
+        sessionId: string;
+        siteId: string;
+        source: string;
+        startedAt: number;
+        visitorId: string;
+    }[]>;
+    listSessions(ctx: QueryCtx | MutationCtx | ActionCtx, args: ListSessionsInput): Promise<{
+        continueCursor: string;
+        isDone: boolean;
+        page: Array<{
+            _creationTime: number;
+            _id: string;
+            affiliateAttributedAt?: number;
+            affiliateExpiresAt?: number;
+            affiliateId?: string;
+            affiliateSlug?: string;
+            browser: string;
+            city?: string;
+            conversionCount: number;
+            country?: string;
+            currency?: string;
+            device: string;
+            durationMs: number;
+            entryPath: string;
+            eventCount: number;
+            exitPath: string;
+            lastSeenAt: number;
+            latitude?: number;
+            longitude?: number;
+            os: string;
+            pageviewCount: number;
+            referrer?: string;
+            revenueCents: number;
+            sessionId: string;
+            siteId: string;
+            source: string;
+            startedAt: number;
+            utmCampaign?: string;
+            utmMedium?: string;
+            utmSource?: string;
+            visitorId: string;
+        }>;
+        pageStatus?: "SplitRecommended" | "SplitRequired" | null;
+        splitCursor?: string | null;
+    }>;
+    sessionJourney(ctx: QueryCtx | MutationCtx | ActionCtx, args: SessionJourneyInput): Promise<{
+        continueCursor: string;
+        isDone: boolean;
+        page: Array<{
+            _creationTime: number;
+            _id: string;
+            affiliateSlug?: string;
+            browser: string;
+            city?: string;
+            country?: string;
+            currency?: string;
+            device: string;
+            eventId: string;
+            href?: string;
+            latitude?: number;
+            longitude?: number;
+            name?: string;
+            os: string;
+            path: string;
+            properties?: Record<string, string | number | boolean | null>;
+            referrer?: string;
+            revenueCents?: number;
+            sequence: number;
+            sessionId: string;
+            siteId: string;
+            target?: string;
+            timestamp: number;
+            type: "pageview" | "click" | "custom" | "conversion" | "heartbeat" | "outbound";
+            visitorId: string;
+        }>;
+        pageStatus?: "SplitRecommended" | "SplitRequired" | null;
+        splitCursor?: string | null;
+    }>;
+    listConversions(ctx: QueryCtx | MutationCtx | ActionCtx, args: ListConversionsInput): Promise<{
+        continueCursor: string;
+        isDone: boolean;
+        page: Array<{
+            _creationTime: number;
+            _id: string;
+            affiliateAttributedAt?: number;
+            affiliateExpiresAt?: number;
+            affiliateId?: string;
+            affiliateSlug?: string;
+            commissionCents: number;
+            currency: string;
+            eventId: string;
+            goalKey?: string;
+            path: string;
+            revenueCents: number;
+            sessionId: string;
+            siteId: string;
+            source: "tracker" | "trusted";
+            timestamp: number;
+            visitorId: string;
+        }>;
+        pageStatus?: "SplitRecommended" | "SplitRequired" | null;
+        splitCursor?: string | null;
+    }>;
+    visitorJourney(ctx: QueryCtx | MutationCtx | ActionCtx, args: VisitorJourneyInput): Promise<{
+        _creationTime: number;
+        _id: string;
+        affiliateSlug?: string;
+        browser: string;
+        city?: string;
+        country?: string;
+        currency?: string;
+        device: string;
+        eventId: string;
+        href?: string;
+        latitude?: number;
+        longitude?: number;
+        name?: string;
+        os: string;
+        path: string;
+        properties?: Record<string, string | number | boolean | null>;
+        referrer?: string;
+        revenueCents?: number;
+        sequence: number;
+        sessionId: string;
+        siteId: string;
+        target?: string;
+        timestamp: number;
+        type: "pageview" | "click" | "custom" | "conversion" | "heartbeat" | "outbound";
+        visitorId: string;
+    }[]>;
+    goalsReport(ctx: QueryCtx | MutationCtx | ActionCtx, args: GoalsReportInput): Promise<{
+        goals: Array<{
+            _creationTime: number;
+            _id: string;
+            active: boolean;
+            completions: number;
+            createdAt: number;
+            key: string;
+            matchType: "pageview" | "custom";
+            matchValue: string;
+            name: string;
+            siteId: string;
+            updatedAt: number;
+            valueCents: number;
+        }>;
+        truncated: boolean;
+    }>;
+    funnelsReport(ctx: QueryCtx | MutationCtx | ActionCtx, args: FunnelsReportInput): Promise<{
+        _creationTime: number;
+        _id: string;
+        active: boolean;
+        conversionWindowMs: number;
+        createdAt: number;
+        key: string;
+        name: string;
+        siteId: string;
+        steps: Array<{
+            name: string;
+            type: "pageview" | "custom";
+            value: string;
+        }>;
+        stepsReport: Array<{
+            completions: number;
+            entrants: number;
+            name: string;
+            step: number;
+        }>;
+        truncated: boolean;
+        updatedAt: number;
+    }[]>;
+    affiliatesReport(ctx: QueryCtx | MutationCtx | ActionCtx, args: AffiliatesReportInput): Promise<{
+        affiliates: Array<{
+            _creationTime: number;
+            _id: string;
+            active: boolean;
+            attributionWindowDays: number;
+            commissionBps: number;
+            commissionCents: number;
+            conversions: number;
+            createdAt: number;
+            name: string;
+            revenueCents: number;
+            siteId: string;
+            slug: string;
+            uniqueVisitors: number;
+            updatedAt: number;
+            visits: number;
+        }>;
+        truncated: boolean;
+    }>;
+    upsertGoal(ctx: MutationCtx, args: UpsertGoalInput): Promise<string>;
+    listGoals(ctx: QueryCtx | MutationCtx | ActionCtx, siteId: string): Promise<{
+        _creationTime: number;
+        _id: string;
+        active: boolean;
+        createdAt: number;
+        key: string;
+        matchType: "pageview" | "custom";
+        matchValue: string;
+        name: string;
+        siteId: string;
+        updatedAt: number;
+        valueCents?: number;
+    }[]>;
+    removeGoal(ctx: MutationCtx, siteId: string, goalId: string): Promise<null>;
+    upsertFunnel(ctx: MutationCtx, args: UpsertFunnelInput): Promise<string>;
+    listFunnels(ctx: QueryCtx | MutationCtx | ActionCtx, siteId: string): Promise<{
+        _creationTime: number;
+        _id: string;
+        active: boolean;
+        conversionWindowMs: number;
+        createdAt: number;
+        key: string;
+        name: string;
+        siteId: string;
+        steps: Array<{
+            name: string;
+            type: "pageview" | "custom";
+            value: string;
+        }>;
+        updatedAt: number;
+    }[]>;
+    removeFunnel(ctx: MutationCtx, siteId: string, funnelId: string): Promise<null>;
+    upsertAffiliate(ctx: MutationCtx, args: UpsertAffiliateInput): Promise<string>;
+    listAffiliates(ctx: QueryCtx | MutationCtx | ActionCtx, siteId: string): Promise<{
+        _creationTime: number;
+        _id: string;
+        active: boolean;
+        attributionWindowDays: number;
+        commissionBps: number;
+        createdAt: number;
+        name: string;
+        siteId: string;
+        slug: string;
+        updatedAt: number;
+    }[]>;
+    removeAffiliate(ctx: MutationCtx, siteId: string, affiliateId: string): Promise<null>;
+    cleanup(ctx: MutationCtx, args: CleanupInput): Promise<{
+        deleted: number;
+        hasMore: boolean;
+    }>;
+}
+export type AnalyticsOperation = "site.create" | "site.update" | "site.get" | "site.list" | "ingest" | "conversion.track" | "report.overview" | "report.live" | "report.sessions" | "report.sessionJourney" | "report.conversions" | "report.visitorJourney" | "report.goals" | "report.funnels" | "report.affiliates" | "goal.upsert" | "goal.list" | "goal.remove" | "funnel.upsert" | "funnel.list" | "funnel.remove" | "affiliate.upsert" | "affiliate.list" | "affiliate.remove" | "retention.cleanup";
+export type AnalyticsAuthorizationRequest = {
+    operation: AnalyticsOperation;
+    siteIds: string[];
+    ownerId?: string;
+};
+export type AnalyticsAuthorizationContext = Pick<GenericQueryCtx<GenericDataModel>, "auth" | "db" | "runQuery">;
+export type AnalyticsAuthorizer = (ctx: AnalyticsAuthorizationContext, request: AnalyticsAuthorizationRequest) => void | Promise<void>;
+export declare function exposeAnalyticsApi(component: ComponentApi, options: {
+    authorize: AnalyticsAuthorizer;
+}): {
+    createSite: import("convex/server").RegisteredMutation<"public", {
+        cookieless?: boolean | undefined;
+        currency?: string | undefined;
+        domains: string[];
+        name: string;
+        networkId?: string | undefined;
+        ownerId: string;
+        timezone?: string | undefined;
+    }, Promise<string>>;
+    updateSite: import("convex/server").RegisteredMutation<"public", {
+        cookieless?: boolean | undefined;
+        currency?: string | undefined;
+        domains?: string[] | undefined;
+        name?: string | undefined;
+        networkId?: string | null | undefined;
+        siteId: string;
+        timezone?: string | null | undefined;
+    }, Promise<null>>;
+    getSite: import("convex/server").RegisteredQuery<"public", {
+        siteId: string;
+    }, Promise<{
+        _creationTime: number;
+        _id: string;
+        cookieless: boolean;
+        createdAt: number;
+        currency?: string;
+        domains: Array<string>;
+        name: string;
+        networkId?: string;
+        ownerId: string;
+        timezone?: string;
+        updatedAt: number;
+    } | null>>;
+    listSites: import("convex/server").RegisteredQuery<"public", {
+        limit?: number | undefined;
+        ownerId: string;
+    }, Promise<{
+        _creationTime: number;
+        _id: string;
+        cookieless: boolean;
+        createdAt: number;
+        currency?: string;
+        domains: Array<string>;
+        name: string;
+        networkId?: string;
+        ownerId: string;
+        timezone?: string;
+        updatedAt: number;
+    }[]>>;
+    ingest: import("convex/server").RegisteredMutation<"public", {
+        context?: {
+            browser?: string | undefined;
+            city?: string | undefined;
+            country?: string | undefined;
+            device?: string | undefined;
+            latitude?: number | undefined;
+            longitude?: number | undefined;
+            os?: string | undefined;
+        } | undefined;
+        events: {
+            affiliateSlug?: string | undefined;
+            currency?: string | undefined;
+            eventId: string;
+            href?: string | undefined;
+            name?: string | undefined;
+            path: string;
+            properties?: Record<string, string | number | boolean | null> | undefined;
+            referrer?: string | undefined;
+            revenueCents?: number | undefined;
+            sequence: number;
+            sessionId: string;
+            target?: string | undefined;
+            timestamp: number;
+            type: "click" | "conversion" | "custom" | "heartbeat" | "outbound" | "pageview";
+            visitorId: string;
+        }[];
+        origin: string;
+        siteId: string;
+    }, Promise<{
+        accepted: number;
+        duplicates: number;
+        rejected: number;
+    }>>;
+    trackConversion: import("convex/server").RegisteredMutation<"public", {
+        currency: string;
+        eventId: string;
+        goalKey?: string | undefined;
+        path?: string | undefined;
+        properties?: Record<string, string | number | boolean | null> | undefined;
+        revenueCents: number;
+        sessionId: string;
+        siteId: string;
+        timestamp: number;
+        visitorId: string;
+    }, Promise<{
+        accepted: number;
+        duplicates: number;
+        rejected: number;
+    }>>;
+    overview: import("convex/server").RegisteredQuery<"public", {
+        from: number;
+        interval?: "day" | "hour" | undefined;
+        siteIds: string[];
+        to: number;
+    }, Promise<{
+        currency: string;
+        from: number;
+        interval: "hour" | "day";
+        timeSeries: Array<{
+            clicks: number;
+            conversions: number;
+            customEvents: number;
+            events: number;
+            outboundClicks: number;
+            pageviews: number;
+            revenueCents: number;
+            sessions: number;
+            timestamp: number;
+            visitors: number;
+        }>;
+        to: number;
+        topBrowsers: Array<{
+            count: number;
+            revenueCents: number;
+            value: string;
+        }>;
+        topCountries: Array<{
+            count: number;
+            revenueCents: number;
+            value: string;
+        }>;
+        topDevices: Array<{
+            count: number;
+            revenueCents: number;
+            value: string;
+        }>;
+        topEvents: Array<{
+            count: number;
+            revenueCents: number;
+            value: string;
+        }>;
+        topGoals: Array<{
+            count: number;
+            revenueCents: number;
+            value: string;
+        }>;
+        topPages: Array<{
+            count: number;
+            revenueCents: number;
+            value: string;
+        }>;
+        topSources: Array<{
+            count: number;
+            revenueCents: number;
+            value: string;
+        }>;
+        totals: {
+            clicks: number;
+            conversions: number;
+            customEvents: number;
+            events: number;
+            outboundClicks: number;
+            pageviews: number;
+            revenueCents: number;
+            sessions: number;
+            visitors: number;
+        };
+    }>>;
+    liveVisitors: import("convex/server").RegisteredQuery<"public", {
+        limit?: number | undefined;
+        now: number;
+        siteIds: string[];
+    }, Promise<{
+        _creationTime: number;
+        _id: string;
+        browser: string;
+        city?: string;
+        country?: string;
+        device: string;
+        eventCount: number;
+        expiresAt: number;
+        lastSeenAt: number;
+        latitude?: number;
+        longitude?: number;
+        os: string;
+        pageviewCount: number;
+        path: string;
+        sessionId: string;
+        siteId: string;
+        source: string;
+        startedAt: number;
+        visitorId: string;
+    }[]>>;
+    listSessions: import("convex/server").RegisteredQuery<"public", {
+        from: number;
+        paginationOpts: {
+            id?: number;
+            endCursor?: string | null;
+            maximumRowsRead?: number;
+            maximumBytesRead?: number;
+            numItems: number;
+            cursor: string | null;
+        };
+        siteId: string;
+        to: number;
+    }, Promise<{
+        continueCursor: string;
+        isDone: boolean;
+        page: Array<{
+            _creationTime: number;
+            _id: string;
+            affiliateAttributedAt?: number;
+            affiliateExpiresAt?: number;
+            affiliateId?: string;
+            affiliateSlug?: string;
+            browser: string;
+            city?: string;
+            conversionCount: number;
+            country?: string;
+            currency?: string;
+            device: string;
+            durationMs: number;
+            entryPath: string;
+            eventCount: number;
+            exitPath: string;
+            lastSeenAt: number;
+            latitude?: number;
+            longitude?: number;
+            os: string;
+            pageviewCount: number;
+            referrer?: string;
+            revenueCents: number;
+            sessionId: string;
+            siteId: string;
+            source: string;
+            startedAt: number;
+            utmCampaign?: string;
+            utmMedium?: string;
+            utmSource?: string;
+            visitorId: string;
+        }>;
+        pageStatus?: "SplitRecommended" | "SplitRequired" | null;
+        splitCursor?: string | null;
+    }>>;
+    sessionJourney: import("convex/server").RegisteredQuery<"public", {
+        from: number;
+        paginationOpts: {
+            id?: number;
+            endCursor?: string | null;
+            maximumRowsRead?: number;
+            maximumBytesRead?: number;
+            numItems: number;
+            cursor: string | null;
+        };
+        sessionId: string;
+        siteId: string;
+        to: number;
+    }, Promise<{
+        continueCursor: string;
+        isDone: boolean;
+        page: Array<{
+            _creationTime: number;
+            _id: string;
+            affiliateSlug?: string;
+            browser: string;
+            city?: string;
+            country?: string;
+            currency?: string;
+            device: string;
+            eventId: string;
+            href?: string;
+            latitude?: number;
+            longitude?: number;
+            name?: string;
+            os: string;
+            path: string;
+            properties?: Record<string, string | number | boolean | null>;
+            referrer?: string;
+            revenueCents?: number;
+            sequence: number;
+            sessionId: string;
+            siteId: string;
+            target?: string;
+            timestamp: number;
+            type: "pageview" | "click" | "custom" | "conversion" | "heartbeat" | "outbound";
+            visitorId: string;
+        }>;
+        pageStatus?: "SplitRecommended" | "SplitRequired" | null;
+        splitCursor?: string | null;
+    }>>;
+    listConversions: import("convex/server").RegisteredQuery<"public", {
+        from: number;
+        paginationOpts: {
+            id?: number;
+            endCursor?: string | null;
+            maximumRowsRead?: number;
+            maximumBytesRead?: number;
+            numItems: number;
+            cursor: string | null;
+        };
+        siteId: string;
+        to: number;
+    }, Promise<{
+        continueCursor: string;
+        isDone: boolean;
+        page: Array<{
+            _creationTime: number;
+            _id: string;
+            affiliateAttributedAt?: number;
+            affiliateExpiresAt?: number;
+            affiliateId?: string;
+            affiliateSlug?: string;
+            commissionCents: number;
+            currency: string;
+            eventId: string;
+            goalKey?: string;
+            path: string;
+            revenueCents: number;
+            sessionId: string;
+            siteId: string;
+            source: "tracker" | "trusted";
+            timestamp: number;
+            visitorId: string;
+        }>;
+        pageStatus?: "SplitRecommended" | "SplitRequired" | null;
+        splitCursor?: string | null;
+    }>>;
+    visitorJourney: import("convex/server").RegisteredQuery<"public", {
+        from: number;
+        limit?: number | undefined;
+        siteIds: string[];
+        to: number;
+        visitorId: string;
+    }, Promise<{
+        _creationTime: number;
+        _id: string;
+        affiliateSlug?: string;
+        browser: string;
+        city?: string;
+        country?: string;
+        currency?: string;
+        device: string;
+        eventId: string;
+        href?: string;
+        latitude?: number;
+        longitude?: number;
+        name?: string;
+        os: string;
+        path: string;
+        properties?: Record<string, string | number | boolean | null>;
+        referrer?: string;
+        revenueCents?: number;
+        sequence: number;
+        sessionId: string;
+        siteId: string;
+        target?: string;
+        timestamp: number;
+        type: "pageview" | "click" | "custom" | "conversion" | "heartbeat" | "outbound";
+        visitorId: string;
+    }[]>>;
+    goalsReport: import("convex/server").RegisteredQuery<"public", {
+        from: number;
+        siteId: string;
+        to: number;
+    }, Promise<{
+        goals: Array<{
+            _creationTime: number;
+            _id: string;
+            active: boolean;
+            completions: number;
+            createdAt: number;
+            key: string;
+            matchType: "pageview" | "custom";
+            matchValue: string;
+            name: string;
+            siteId: string;
+            updatedAt: number;
+            valueCents: number;
+        }>;
+        truncated: boolean;
+    }>>;
+    funnelsReport: import("convex/server").RegisteredQuery<"public", {
+        from: number;
+        siteId: string;
+        to: number;
+    }, Promise<{
+        _creationTime: number;
+        _id: string;
+        active: boolean;
+        conversionWindowMs: number;
+        createdAt: number;
+        key: string;
+        name: string;
+        siteId: string;
+        steps: Array<{
+            name: string;
+            type: "pageview" | "custom";
+            value: string;
+        }>;
+        stepsReport: Array<{
+            completions: number;
+            entrants: number;
+            name: string;
+            step: number;
+        }>;
+        truncated: boolean;
+        updatedAt: number;
+    }[]>>;
+    affiliatesReport: import("convex/server").RegisteredQuery<"public", {
+        from: number;
+        siteId: string;
+        to: number;
+    }, Promise<{
+        affiliates: Array<{
+            _creationTime: number;
+            _id: string;
+            active: boolean;
+            attributionWindowDays: number;
+            commissionBps: number;
+            commissionCents: number;
+            conversions: number;
+            createdAt: number;
+            name: string;
+            revenueCents: number;
+            siteId: string;
+            slug: string;
+            uniqueVisitors: number;
+            updatedAt: number;
+            visits: number;
+        }>;
+        truncated: boolean;
+    }>>;
+    upsertGoal: import("convex/server").RegisteredMutation<"public", {
+        active?: boolean | undefined;
+        goalId?: string | undefined;
+        key: string;
+        matchType: "custom" | "pageview";
+        matchValue: string;
+        name: string;
+        siteId: string;
+        valueCents?: number | undefined;
+    }, Promise<string>>;
+    listGoals: import("convex/server").RegisteredQuery<"public", {
+        siteId: string;
+    }, Promise<{
+        _creationTime: number;
+        _id: string;
+        active: boolean;
+        createdAt: number;
+        key: string;
+        matchType: "pageview" | "custom";
+        matchValue: string;
+        name: string;
+        siteId: string;
+        updatedAt: number;
+        valueCents?: number;
+    }[]>>;
+    removeGoal: import("convex/server").RegisteredMutation<"public", {
+        goalId: string;
+        siteId: string;
+    }, Promise<null>>;
+    upsertFunnel: import("convex/server").RegisteredMutation<"public", {
+        active?: boolean | undefined;
+        conversionWindowMs: number;
+        funnelId?: string | undefined;
+        key: string;
+        name: string;
+        siteId: string;
+        steps: {
+            name: string;
+            type: "custom" | "pageview";
+            value: string;
+        }[];
+    }, Promise<string>>;
+    listFunnels: import("convex/server").RegisteredQuery<"public", {
+        siteId: string;
+    }, Promise<{
+        _creationTime: number;
+        _id: string;
+        active: boolean;
+        conversionWindowMs: number;
+        createdAt: number;
+        key: string;
+        name: string;
+        siteId: string;
+        steps: Array<{
+            name: string;
+            type: "pageview" | "custom";
+            value: string;
+        }>;
+        updatedAt: number;
+    }[]>>;
+    removeFunnel: import("convex/server").RegisteredMutation<"public", {
+        funnelId: string;
+        siteId: string;
+    }, Promise<null>>;
+    upsertAffiliate: import("convex/server").RegisteredMutation<"public", {
+        active?: boolean | undefined;
+        affiliateId?: string | undefined;
+        attributionWindowDays: number;
+        commissionBps: number;
+        name: string;
+        siteId: string;
+        slug: string;
+    }, Promise<string>>;
+    listAffiliates: import("convex/server").RegisteredQuery<"public", {
+        siteId: string;
+    }, Promise<{
+        _creationTime: number;
+        _id: string;
+        active: boolean;
+        attributionWindowDays: number;
+        commissionBps: number;
+        createdAt: number;
+        name: string;
+        siteId: string;
+        slug: string;
+        updatedAt: number;
+    }[]>>;
+    removeAffiliate: import("convex/server").RegisteredMutation<"public", {
+        affiliateId: string;
+        siteId: string;
+    }, Promise<null>>;
+    cleanupAnalytics: import("convex/server").RegisteredMutation<"public", {
+        batchSize?: number | undefined;
+        before: number;
+        kind: "affiliateStats" | "aggregateDay" | "aggregateHour" | "attributions" | "conversions" | "events" | "funnelProgress" | "funnelSteps" | "goalCompletions" | "ingestWindows" | "liveSessions" | "sessions" | "siteIngestWindows";
+        siteId: string;
+    }, Promise<{
+        deleted: number;
+        hasMore: boolean;
+    }>>;
+};
+export declare function componentHttpPaths(prefix?: string): {
+    readonly events: `${string}/events`;
+    readonly tracker: `${string}/tracker.js`;
+    readonly health: `${string}/health`;
+};
+type QueryCtx = Pick<GenericQueryCtx<GenericDataModel>, "runQuery">;
+type MutationCtx = Pick<GenericMutationCtx<GenericDataModel>, "runQuery" | "runMutation">;
+type ActionCtx = Pick<GenericActionCtx<GenericDataModel>, "runQuery" | "runMutation" | "runAction">;
+//# sourceMappingURL=index.d.ts.map