@iann29/rastro 0.4.0 → 0.6.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";
@@ -122,7 +140,7 @@ export declare const liveVisitors: import("convex/server").RegisteredQuery<"publ
     limit?: number | undefined;
     now: number;
     siteIds: import("convex/values").GenericId<"sites">[];
-}, Promise<{
+}, Promise<({
     _id: import("convex/values").GenericId<"liveSessions">;
     _creationTime: number;
     siteId: import("convex/values").GenericId<"sites">;
@@ -154,7 +172,9 @@ export declare const liveVisitors: import("convex/server").RegisteredQuery<"publ
         step: number;
         steps: number;
     } | undefined;
-}[]>>;
+} & {
+    profile?: import("./validators.js").VisitorProfile;
+})[]>>;
 /**
  * Every route the sites served in the range and the transitions between
  * them, read from the daily route rollups newest day first. Exits and
@@ -227,45 +247,14 @@ 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 & {
+    profile?: import("./validators.js").VisitorProfile;
+}) | null>>;
 /** Exact commissions alongside overview's period revenue/conversion totals. */
 export declare const revenueSummary: import("convex/server").RegisteredQuery<"public", {
     from: number;
@@ -287,41 +276,9 @@ 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 & {
+        profile?: import("./validators.js").VisitorProfile;
+    })[];
     isDone: boolean;
     continueCursor: string;
 }>>;
@@ -353,9 +310,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 +385,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 +590,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":"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"}
+{"version":3,"file":"reports.d.ts","sourceRoot":"","sources":["../../src/component/reports.ts"],"names":[],"mappings":"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"}