@iann29/rastro 0.4.0 → 0.5.0

package/dist/component/platforms.js

@@ -0,0 +1,328 @@
+/**
+ * The closed table origin.ts classifies against. Bump the version whenever a
+ * row changes, and add a corpus case (origin.test.ts) for the change.
+ */
+export const PLATFORM_TABLE_VERSION = 1;
+// Ordered for `inAppPlatform`: the first row whose marker matches wins, so
+// Messenger (its iOS agent carries `FBAN/`) precedes Facebook and Threads
+// precedes Instagram. Sources per row: "spec" is the approved proposal's
+// table; the rest is each platform's own domains, link shims, and Play Store
+// package ids, and in-app agents as the apps send them.
+export const PLATFORMS = [
+    // Social.
+    {
+        // Threads: spec (threads.net → threads.com); agent is the app's codename.
+        id: "threads",
+        channel: "organic_social",
+        domains: ["threads.net", "threads.com"],
+        packages: ["com.instagram.barcelona"],
+        agent: /Barcelona/,
+    },
+    {
+        // spec.
+        id: "instagram",
+        channel: "organic_social",
+        domains: ["instagram.com"],
+        packages: ["com.instagram.android"],
+        agent: /Instagram/,
+        aliases: ["ig", "insta"],
+    },
+    {
+        // spec; + com.facebook.mlite (Messenger Lite), "msg" is Meta's
+        // {{site_source_name}} value for Messenger placements.
+        id: "messenger",
+        channel: "messaging",
+        domains: ["messenger.com", "m.me"],
+        packages: ["com.facebook.orca", "com.facebook.mlite"],
+        agent: /Orca-Android|MessengerLite|MessengerForiOS/,
+        aliases: ["msg"],
+    },
+    {
+        // spec; + fb.watch (video short links).
+        id: "facebook",
+        channel: "organic_social",
+        domains: ["facebook.com", "fb.com", "fb.me", "fb.watch"],
+        packages: ["com.facebook.katana", "com.facebook.lite"],
+        agent: /FBAN\/|FBAV\/|FB_IAB/,
+        aliases: ["fb", "face"],
+    },
+    {
+        // spec: only an `fbclid` with nothing that tells Facebook from Instagram.
+        id: "meta",
+        channel: "organic_social",
+    },
+    {
+        // spec; + TikTok Lite (com.zhiliaoapp.musically.go).
+        id: "tiktok",
+        channel: "organic_social",
+        domains: ["tiktok.com"],
+        packages: [
+            "com.zhiliaoapp.musically",
+            "com.ss.android.ugc.trill",
+            "com.zhiliaoapp.musically.go",
+        ],
+        agent: /BytedanceWebview|musical_ly|TikTok/,
+        aliases: ["tt"],
+    },
+    {
+        // spec.
+        id: "kwai",
+        channel: "organic_social",
+        domains: ["kwai.com", "kwai-video.com", "kw.ai"],
+        packages: ["com.kwai.video"],
+        agent: /Kwai/,
+    },
+    {
+        // spec.
+        id: "youtube",
+        channel: "organic_social",
+        domains: ["youtube.com", "youtu.be"],
+        packages: ["com.google.android.youtube"],
+        aliases: ["yt"],
+    },
+    {
+        // spec; + TwitterAndroid (the Android app's agent).
+        id: "x",
+        channel: "organic_social",
+        domains: ["x.com", "twitter.com", "t.co"],
+        packages: ["com.twitter.android"],
+        agent: /Twitter for |TwitterAndroid/,
+        aliases: ["twitter"],
+    },
+    {
+        // spec.
+        id: "linkedin",
+        channel: "organic_social",
+        domains: ["linkedin.com", "lnkd.in"],
+        packages: ["com.linkedin.android"],
+        agent: /LinkedInApp/,
+        aliases: ["li"],
+    },
+    {
+        id: "pinterest",
+        channel: "organic_social",
+        domains: ["pinterest.com", "pin.it"],
+        packages: ["com.pinterest"],
+        agent: /Pinterest\//,
+        aliases: ["pin"],
+    },
+    {
+        id: "reddit",
+        channel: "organic_social",
+        domains: ["reddit.com", "redd.it"],
+        packages: ["com.reddit.frontpage"],
+    },
+    {
+        id: "snapchat",
+        channel: "organic_social",
+        domains: ["snapchat.com"],
+        packages: ["com.snapchat.android"],
+        agent: /Snapchat/,
+        aliases: ["snap"],
+    },
+    // Messaging.
+    {
+        // spec; + wl.co (WhatsApp's link shim, l.wl.co).
+        id: "whatsapp",
+        channel: "messaging",
+        domains: ["whatsapp.com", "wa.me", "wl.co"],
+        packages: ["com.whatsapp", "com.whatsapp.w4b"],
+        aliases: ["wa", "zap", "whats"],
+    },
+    {
+        // spec; + Telegram X (org.thunderdog.challegram).
+        id: "telegram",
+        channel: "messaging",
+        domains: ["t.me", "telegram.me", "telegram.org"],
+        packages: ["org.telegram.messenger", "org.thunderdog.challegram"],
+        aliases: ["tg"],
+    },
+    {
+        id: "discord",
+        channel: "messaging",
+        domains: ["discord.com", "discordapp.com", "discord.gg"],
+        packages: ["com.discord"],
+    },
+    {
+        // The Android package is `com.Slack`; referrer hosts arrive lowercase.
+        id: "slack",
+        channel: "messaging",
+        domains: ["slack.com"],
+        packages: ["com.slack"],
+    },
+    {
+        id: "line",
+        channel: "messaging",
+        domains: ["line.me"],
+        packages: ["jp.naver.line.android"],
+        agent: / Line\//,
+    },
+    // Search. Google's country domains match one pattern, not a suffix, so
+    // mail, docs, drive and every other google.com role host stay out of it.
+    {
+        // spec: google.<tld>, googleadservices.com, the Google app and GSA/.
+        id: "google",
+        channel: "organic_search",
+        hostPattern: /^(?:www\.)?google\.[a-z.]{2,7}$/,
+        domains: ["news.google.com"],
+        paidDomains: ["googleadservices.com"],
+        packages: ["com.google.android.googlequicksearchbox"],
+        agent: /GSA\//,
+        paidAliases: ["gads", "adwords", "google-ads", "google_ads", "googleads"],
+    },
+    {
+        id: "bing",
+        channel: "organic_search",
+        domains: ["bing.com"],
+        packages: ["com.microsoft.bing"],
+    },
+    {
+        id: "duckduckgo",
+        channel: "organic_search",
+        domains: ["duckduckgo.com"],
+        packages: ["com.duckduckgo.mobile.android"],
+        aliases: ["ddg"],
+    },
+    {
+        // Search hosts only: yahoo.com itself is a portal, mail is yahoo_mail.
+        id: "yahoo",
+        channel: "organic_search",
+        domains: ["search.yahoo.com", "search.yahoo.co.jp"],
+    },
+    {
+        id: "ecosia",
+        channel: "organic_search",
+        domains: ["ecosia.org"],
+        packages: ["com.ecosia.android"],
+    },
+    {
+        id: "yandex",
+        channel: "organic_search",
+        domains: ["yandex.ru", "yandex.com", "ya.ru"],
+    },
+    {
+        id: "baidu",
+        channel: "organic_search",
+        domains: ["baidu.com"],
+    },
+    // E-mail.
+    {
+        // spec.
+        id: "gmail",
+        channel: "email",
+        domains: ["mail.google.com"],
+        packages: ["com.google.android.gm"],
+    },
+    {
+        id: "outlook",
+        channel: "email",
+        domains: [
+            "outlook.com",
+            "outlook.live.com",
+            "outlook.office.com",
+            "outlook.office365.com",
+        ],
+        packages: ["com.microsoft.office.outlook"],
+        aliases: ["hotmail"],
+    },
+    {
+        id: "yahoo_mail",
+        channel: "email",
+        domains: ["mail.yahoo.com"],
+        packages: ["com.yahoo.mobile.client.android.mail"],
+        aliases: ["yahoomail"],
+    },
+    // AI assistants.
+    {
+        // spec. ChatGPT tags the links it cites with utm_source=chatgpt.com,
+        // which the host fallback in origin.ts resolves.
+        id: "chatgpt",
+        channel: "ai",
+        domains: ["chatgpt.com", "chat.openai.com"],
+        packages: ["com.openai.chatgpt"],
+        aliases: ["openai"],
+    },
+    {
+        id: "perplexity",
+        channel: "ai",
+        domains: ["perplexity.ai"],
+        packages: ["ai.perplexity.app.android"],
+    },
+    {
+        // spec: gemini.google.com; bard is the product's former name.
+        id: "gemini",
+        channel: "ai",
+        domains: ["gemini.google.com", "bard.google.com"],
+        packages: ["com.google.android.apps.bard"],
+        aliases: ["bard"],
+    },
+    {
+        id: "copilot",
+        channel: "ai",
+        domains: ["copilot.microsoft.com"],
+        packages: ["com.microsoft.copilot"],
+    },
+    {
+        id: "claude",
+        channel: "ai",
+        domains: ["claude.ai"],
+        packages: ["com.anthropic.claude"],
+        aliases: ["anthropic"],
+    },
+    // Display ad servers and a known referral: github.io pages belong to their
+    // authors, so only github.com itself is GitHub.
+    {
+        id: "doubleclick",
+        channel: "display",
+        domains: ["doubleclick.net"],
+    },
+    {
+        id: "taboola",
+        channel: "display",
+        domains: ["taboola.com"],
+    },
+    {
+        id: "outbrain",
+        channel: "display",
+        domains: ["outbrain.com"],
+    },
+    {
+        id: "github",
+        channel: "referral",
+        domains: ["github.com"],
+        packages: ["com.github.android"],
+    },
+    // A QR code is a tracked link printed off the web: the scan carries no
+    // referrer and no app, so the link's own declaration is the only evidence.
+    {
+        id: "qr",
+        channel: "offline",
+        aliases: ["qrcode", "qr_code", "qr-code"],
+    },
+];
+/**
+ * Click-ID keys the tracker may report by name, in priority order: the ad
+ * networks' own ids first, then the organic share ids, `fbclid` last because
+ * Meta adds it to organic clicks too. `unknown` platforms take the referrer's.
+ */
+export const CLICK_IDS = [
+    ["gclid", "google", "paid_search"],
+    ["gbraid", "google", "paid_search"],
+    ["wbraid", "google", "paid_search"],
+    ["msclkid", "bing", "paid_search"],
+    ["ttclid", "tiktok", "paid_social"],
+    ["twclid", "x", "paid_social"],
+    ["li_fat_id", "linkedin", "paid_social"],
+    ["ScCid", "snapchat", "paid_social"],
+    ["rdt_cid", "reddit", "paid_social"],
+    ["dclid", "doubleclick", "display"],
+    ["epik", "pinterest", "organic_social"],
+    ["srsltid", "google", "organic_search"],
+    ["mc_cid", "unknown", "email"],
+    ["mc_eid", "unknown", "email"],
+    ["_hsenc", "unknown", "email"],
+    ["igsh", "instagram", "organic_social"],
+    ["igshid", "instagram", "organic_social"],
+    ["fbclid", "meta", "organic_social"],
+];
+//# sourceMappingURL=platforms.js.map

package/dist/component/platforms.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"platforms.js","sourceRoot":"","sources":["../../src/component/platforms.ts"],"names":[],"mappings":"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"}

package/dist/component/reports.d.ts

@@ -1,4 +1,4 @@
-import type { Id } from "./_generated/dataModel.js";
+import type { Doc, Id } from "./_generated/dataModel.js";
 export declare const overview: import("convex/server").RegisteredQuery<"public", {
     from: number;
     interval?: "day" | "hour" | undefined;
@@ -75,6 +75,21 @@ export declare const overview: import("convex/server").RegisteredQuery<"public",
         count: number;
         revenueCents: number;
     }[];
+    topPlatforms: {
+        value: string;
+        count: number;
+        revenueCents: number;
+    }[];
+    topChannels: {
+        value: string;
+        count: number;
+        revenueCents: number;
+    }[];
+    topEvidence: {
+        value: string;
+        count: number;
+        revenueCents: number;
+    }[];
     metadata: {
         visitors: {
             basis: "bucketOccurrences" | "estimatedUnique";
@@ -94,6 +109,9 @@ export declare const overview: import("convex/server").RegisteredQuery<"public",
             topGoals: "goalCompletionVolume";
             topMediums: "eventVolume" | "sessions";
             topOutbound: "eventVolume";
+            topPlatforms: "eventVolume" | "sessions";
+            topChannels: "eventVolume" | "sessions";
+            topEvidence: "eventVolume" | "sessions";
         };
         dimensionsSince: number | null;
         engagement: "counted" | "unavailable";
@@ -227,45 +245,12 @@ export declare const siteMap: import("convex/server").RegisteredQuery<"public",
         };
     };
 }>>;
+type SessionRow = Omit<Doc<"sessions">, "geoLookupAttemptedAt" | "lastPageviewAt">;
 /** Metadata for a selected session, independent of list pagination. */
 export declare const getSession: import("convex/server").RegisteredQuery<"public", {
     sessionId: string;
     siteId: import("convex/values").GenericId<"sites">;
-}, Promise<{
-    _creationTime: number;
-    _id: import("convex/values").GenericId<"sessions">;
-    affiliateAttributedAt?: number | undefined;
-    affiliateExpiresAt?: number | undefined;
-    affiliateId?: import("convex/values").GenericId<"affiliates"> | undefined;
-    affiliateSlug?: string | undefined;
-    browser: string;
-    city?: string | undefined;
-    conversionCount: number;
-    country?: string | undefined;
-    currency?: string | undefined;
-    device: string;
-    durationMs: number;
-    entryPath: string;
-    eventCount: number;
-    exitPath: string;
-    lastSeenAt: number;
-    latitude?: number | undefined;
-    longitude?: number | undefined;
-    newVisitor?: boolean | undefined;
-    os: string;
-    pageviewCount: number;
-    referrer?: string | undefined;
-    revenueCents: number;
-    sessionId: string;
-    siteId: import("convex/values").GenericId<"sites">;
-    source: string;
-    startedAt: number;
-    utmCampaign?: string | undefined;
-    utmMedium?: string | undefined;
-    utmSource?: string | undefined;
-    visitorId: string;
-    visitorKey?: string | undefined;
-} | null>>;
+}, Promise<SessionRow | null>>;
 /** Exact commissions alongside overview's period revenue/conversion totals. */
 export declare const revenueSummary: import("convex/server").RegisteredQuery<"public", {
     from: number;
@@ -287,41 +272,7 @@ export declare const listSessions: import("convex/server").RegisteredQuery<"publ
     siteId: import("convex/values").GenericId<"sites">;
     to: number;
 }, Promise<{
-    page: {
-        _creationTime: number;
-        _id: import("convex/values").GenericId<"sessions">;
-        affiliateAttributedAt?: number | undefined;
-        affiliateExpiresAt?: number | undefined;
-        affiliateId?: import("convex/values").GenericId<"affiliates"> | undefined;
-        affiliateSlug?: string | undefined;
-        browser: string;
-        city?: string | undefined;
-        conversionCount: number;
-        country?: string | undefined;
-        currency?: string | undefined;
-        device: string;
-        durationMs: number;
-        entryPath: string;
-        eventCount: number;
-        exitPath: string;
-        lastSeenAt: number;
-        latitude?: number | undefined;
-        longitude?: number | undefined;
-        newVisitor?: boolean | undefined;
-        os: string;
-        pageviewCount: number;
-        referrer?: string | undefined;
-        revenueCents: number;
-        sessionId: string;
-        siteId: import("convex/values").GenericId<"sites">;
-        source: string;
-        startedAt: number;
-        utmCampaign?: string | undefined;
-        utmMedium?: string | undefined;
-        utmSource?: string | undefined;
-        visitorId: string;
-        visitorKey?: string | undefined;
-    }[];
+    page: SessionRow[];
     isDone: boolean;
     continueCursor: string;
 }>>;
@@ -353,9 +304,11 @@ export declare const sessionJourney: import("convex/server").RegisteredQuery<"pu
         os: string;
         device: string;
         affiliateSlug?: string | undefined;
+        clid?: string[] | undefined;
         currency?: string | undefined;
         eventId: string;
         href?: string | undefined;
+        inApp?: string | undefined;
         name?: string | undefined;
         path: string;
         properties?: Record<string, string | number | boolean | null> | undefined;
@@ -426,9 +379,11 @@ export declare const visitorJourney: import("convex/server").RegisteredQuery<"pu
     os: string;
     device: string;
     affiliateSlug?: string | undefined;
+    clid?: string[] | undefined;
     currency?: string | undefined;
     eventId: string;
     href?: string | undefined;
+    inApp?: string | undefined;
     name?: string | undefined;
     path: string;
     properties?: Record<string, string | number | boolean | null> | undefined;
@@ -629,7 +584,7 @@ export declare const dataCoverage: import("convex/server").RegisteredQuery<"publ
     from: number;
     to: number;
     datasets: {
-        dataset: "affiliates" | "conversions" | "events" | "funnels" | "goals" | "overviewDay" | "overviewHour" | "overviewLocalDay" | "sessions" | "siteMap" | "vitals";
+        dataset: "affiliates" | "conversions" | "events" | "funnels" | "goals" | "origin" | "overviewDay" | "overviewHour" | "overviewLocalDay" | "sessions" | "siteMap" | "vitals";
         coverage: {
             state: "complete" | "partial" | "retained" | "unavailable";
             generation: 1 | null;

package/dist/component/reports.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"reports.d.ts","sourceRoot":"","sources":["../../src/component/reports.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAO,EAAE,EAAE,MAAM,2BAA2B,CAAC;AA+LzD,eAAO,MAAM,QAAQ;;;;;;;;;;;;;gBAusEX,MAAM;mBACH,MAAM;gBACT,MAAM;sBACA,MAAM;wBACJ,MAAM;kBACZ,MAAM;kBACN,MAAM;qBACH,MAAM;sBACL,MAAM;oBACR,MAAM;2BACC,MAAM;qBACZ,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;YAn3DX,UAAU;YACV,YAAY;YACZ,QAAQ;YACR,YAAY;YACZ,UAAU;YACV,WAAW;YACX,SAAS,EAAE,aAAa;YACxB,QAAQ,EAAE,sBAAsB;YAChC,UAAU;YACV,WAAW,EAAE,aAAa;;;;;;;;;;;;;;sBAs9DtB,WAAW;;;;YAz8Df,aAAa,EAAE,aAAa;YAC5B,aAAa,EAAE,aAAa;YAC5B,aAAa,EAAE,aAAa;YAC5B,YAAY,EAAE,WAAW;;;GAKjC,CAAC;AAEH,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAsEvB,CAAC;AAsBH;;;;;;;;;GASG;AACH,eAAO,MAAM,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;cA0KN,MAAM;YAAM,MAAM;eAAS,MAAM;;;QA+CvC,MAAM;QACN,WAAW;;;eAzKN,aAAa;;;wBAGN,CAAC;;;;;;;;sBAqyDP,WAAW;;;;YA/xDP,KAAK,EAAE,iBAAiB;YAAW,KAAK;;;;;;;;GAyKxD,CAAC;AA0CH,uEAAuE;AACvE,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;UAkBrB,CAAC;AAEH,+EAA+E;AAC/E,eAAO,MAAM,cAAc;;;;;;GAwEzB,CAAC;AAEH,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwEvB,CAAC;AAEH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BzB,CAAC;AAEH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiE1B,CAAC;AAEH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAgDzB,CAAC;AASH,eAAO,MAAM,WAAW;;;;;;;;qBAiBH,MAAM;oBAAc,MAAM;;;;;;;;;;;;QA0DvC,KAAK;QACL,QAAQ;;;;;;;QAWR,KAAK;;;sBA+qCC,WAAW;;;;GA3qCvB,CAAC;AAiBH,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;QAoFhB,KAAK;QAGL,QAAQ;;;;;;;QACR,KAAK;;;sBAkkCD,WAAW;;;;;;;;;;;;;;;;KA5jCvB,CAAC;AAYH,eAAO,MAAM,gBAAgB;;;;;;;;qBAqDR,MAAM;sBACL,MAAM;yBACH,MAAM;;;;;;;;;;;;;;QAkGvB,KAAK;QACL,QAAQ;;;;;;;QAaR,KAAK;;;sBAy4BC,WAAW;;;QAx4BjB,cAAc;YACZ,KAAK;YAGL,KAAK;;;GAKb,CAAC;AAWH,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QA4HjB,KAAK,EAAE,aAAa;QACpB,QAAQ;;;;;;;QAOR,KAAK;;;sBAgvBC,WAAW;;;;GA5uBvB,CAAC;AAgBH,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;GAkDvB,CAAC;AAkjBH,KAAK,YAAY,GAAG;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC"}
+{"version":3,"file":"reports.d.ts","sourceRoot":"","sources":["../../src/component/reports.ts"],"names":[],"mappings":"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"}

package/dist/component/reports.js

@@ -7,6 +7,8 @@ import { fail } from "./errors.js";
 import { isLocalDayAligned, localDayStart, localDayStarts, localDayTimezone, sharedLocalTimezone, } from "./localTime.js";
 import { compareJourneyEvents, hydrateEventContexts, loadSessionJourneyEvents, loadVisitorJourneyEvents, } from "./eventStore.js";
 import { isPlainRecord } from "./guards.js";
+import { classifyOrigin } from "./origin.js";
+import { externalReferrer } from "./sanitize.js";
 import { affiliateFieldsValidator, eventFieldsValidator, funnelFieldsValidator, goalFieldsValidator, sessionFieldsValidator, vitalMetricValidator, } from "./validators.js";
 import { resolveVisitorIdentities } from "./visitors.js";
 import { mergeVitalHistograms, VITAL_ALL, VITAL_METRICS, vitalHistogramPercentile, vitalRatingCounts, } from "./vitals.js";
@@ -145,6 +147,11 @@ export const overview = query({
         topMediums: v.array(topItemValidator),
         // Destination hosts of outbound clicks, ranked by clicks.
         topOutbound: v.array(topItemValidator),
+        // The session's origin (origin.ts), ranked like sources: platform ids,
+        // channel ids, and the evidence that decided them.
+        topPlatforms: v.array(topItemValidator),
+        topChannels: v.array(topItemValidator),
+        topEvidence: v.array(topItemValidator),
         metadata: v.object({
             visitors: v.object({
                 basis: v.union(v.literal("estimatedUnique"), v.literal("bucketOccurrences")),
@@ -164,6 +171,9 @@ export const overview = query({
                 topGoals: v.literal("goalCompletionVolume"),
                 topMediums: breakdownBasisValidator,
                 topOutbound: v.literal("eventVolume"),
+                topPlatforms: breakdownBasisValidator,
+                topChannels: breakdownBasisValidator,
+                topEvidence: breakdownBasisValidator,
             }),
             // Since when every site in the request records the medium and outbound
             // slots; null while one of them has not stamped it. A range that starts
@@ -390,6 +400,9 @@ export const overview = query({
             topGoals: top("goal", "eventVolume"),
             topMediums: top("medium", sessionBasis),
             topOutbound: top("outbound", "eventVolume"),
+            topPlatforms: top("platform", sessionBasis),
+            topChannels: top("channel", sessionBasis),
+            topEvidence: top("evidence", sessionBasis),
             metadata: {
                 visitors: {
                     basis: visitorBasis,
@@ -409,6 +422,9 @@ export const overview = query({
                     topGoals: "goalCompletionVolume",
                     topMediums: sessionBasis,
                     topOutbound: "eventVolume",
+                    topPlatforms: sessionBasis,
+                    topChannels: sessionBasis,
+                    topEvidence: sessionBasis,
                 },
                 dimensionsSince: controls.every((control) => control?.dimensionsSince !== undefined)
                     ? Math.max(...controls.map((control) => control.dimensionsSince))
@@ -720,6 +736,22 @@ async function readRouteRollups(ctx, siteId, from, to, budget) {
     }
     return { rows, completeFrom: cutAt + DAY_MS };
 }
+/**
+ * A session recorded before origins existed, classified on read from what it
+ * kept (utm fields, referrer, affiliate) and marked `legacy`: it carries no
+ * click IDs or in-app signal, and it never enters the aggregates.
+ */
+function withOrigin(session, domains) {
+    if (session.platform !== undefined)
+        return session;
+    const origin = classifyOrigin({
+        utmSource: session.utmSource,
+        utmMedium: session.utmMedium,
+        referrer: externalReferrer(session.referrer, domains),
+        affiliate: session.affiliateSlug !== undefined,
+    });
+    return { ...session, ...origin, evidence: "legacy" };
+}
 /** Metadata for a selected session, independent of list pagination. */
 export const getSession = query({
     args: { siteId: v.id("sites"), sessionId: v.string() },
@@ -732,7 +764,8 @@ export const getSession = query({
         if (!session)
             return null;
         const { geoLookupAttemptedAt: _geo, lastPageviewAt: _pageview, ...result } = session;
-        return result;
+        const site = await ctx.db.get("sites", args.siteId);
+        return withOrigin(result, site?.domains ?? []);
     },
 });
 /** Exact commissions alongside overview's period revenue/conversion totals. */
@@ -844,7 +877,8 @@ export const listSessions = query({
                 .order("desc")
                 .take(take)));
         }
-        const publicRows = rows.map(({ geoLookupAttemptedAt: _attemptedAt, lastPageviewAt: _lastPageviewAt, ...row }) => row);
+        const site = await ctx.db.get("sites", args.siteId);
+        const publicRows = rows.map(({ geoLookupAttemptedAt: _attemptedAt, lastPageviewAt: _lastPageviewAt, ...row }) => withOrigin(row, site?.domains ?? []));
         return keysetPaginationResult(publicRows, pagination, (row) => ({
             timestamp: row.lastSeenAt,
             creationTime: row._creationTime,
@@ -1381,7 +1415,7 @@ export const vitalsReport = query({
         };
     },
 });
-const coverageDatasetValidator = v.union(v.literal("overviewHour"), v.literal("overviewDay"), v.literal("overviewLocalDay"), v.literal("events"), v.literal("sessions"), v.literal("conversions"), v.literal("goals"), v.literal("funnels"), v.literal("affiliates"), v.literal("vitals"), v.literal("siteMap"));
+const coverageDatasetValidator = v.union(v.literal("overviewHour"), v.literal("overviewDay"), v.literal("overviewLocalDay"), v.literal("events"), v.literal("sessions"), v.literal("conversions"), v.literal("goals"), v.literal("funnels"), v.literal("affiliates"), v.literal("vitals"), v.literal("siteMap"), v.literal("origin"));
 export const dataCoverage = query({
     args: {
         siteId: v.id("sites"),
@@ -1411,6 +1445,7 @@ export const dataCoverage = query({
             "affiliates",
             "vitals",
             "siteMap",
+            "origin",
         ];
         return {
             siteId: args.siteId,
@@ -1601,7 +1636,12 @@ async function assertSourceAvailable(ctx, siteIds, sources, from) {
 }
 async function datasetCoverageForRange(ctx, siteId, dataset, from, to) {
     if (dataset === "siteMap") {
-        return siteMapDatasetCoverage(ctx, siteId, from, to);
+        return stampedDatasetCoverage(ctx, siteId, from, to, "siteMapSince", siteMapCoverageDataset);
+    }
+    // Origins exist in sessions and aggregate slots from the site's stamp, and
+    // the overview reads them from the daily aggregates retention trims.
+    if (dataset === "origin") {
+        return stampedDatasetCoverage(ctx, siteId, from, to, "originSince", "overviewDay");
     }
     // Vitals have no legacy fallback source; the rollup either covers the range
     // or the coverage states say how much of it exists.
@@ -1635,17 +1675,18 @@ async function datasetCoverageForRange(ctx, siteId, dataset, from, to) {
     return options.sort((left, right) => coverageRank(right.state) - coverageRank(left.state))[0];
 }
 /**
- * The site map's coverage without reading its rows: it starts at the site's
- * `siteMapSince` and ends where retention cut it. The report itself may still
- * narrow the window when the range exceeds its row budget.
+ * A stamped dataset's coverage without reading its rows: it starts at the
+ * site's stamp (`siteMapSince`, `originSince`) and ends where retention cut
+ * it. The site map report may still narrow the window when the range exceeds
+ * its row budget.
  */
-async function siteMapDatasetCoverage(ctx, siteId, from, to) {
+async function stampedDatasetCoverage(ctx, siteId, from, to, stamp, retainedDataset) {
     const control = await ctx.db
         .query("analyticsCoverage")
         .withIndex("by_siteId", (range) => range.eq("siteId", siteId))
         .unique();
-    const since = control?.siteMapSince ?? null;
-    const retainedBefore = control?.retained.find((item) => item.dataset === siteMapCoverageDataset)
+    const since = control?.[stamp] ?? null;
+    const retainedBefore = control?.retained.find((item) => item.dataset === retainedDataset)
         ?.before ?? null;
     const unavailable = since === null ||
         to < since ||